From 5ba4f9edcaa2933af288799a0baf93208d367765 Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Fri, 24 Oct 2025 15:16:55 -0400
Subject: [PATCH 001/110] add new methods

---
 server/python/src/models/models.py  |  14 +-
 server/python/src/routers/movies.py | 431 +++++++++++++++++++++++++++-
 2 files changed, 441 insertions(+), 4 deletions(-)

diff --git a/server/python/src/models/models.py b/server/python/src/models/models.py
index 9e66a82..e027116 100644
--- a/server/python/src/models/models.py
+++ b/server/python/src/models/models.py
@@ -92,9 +92,18 @@ class CreateMovieRequest(BaseModel):
     rated: Optional[str]  = None
     runtime: Optional[int]  = None
     poster: Optional[str]  = None    
+    
+class Comment(BaseModel):
+    id: Optional[str] = Field(alias="_id")
+    name: str
+    email: str
+    movie_id: str
+    text: str
+    date: datetime
 
-
-
+    model_config = {
+        "populate_by_name": True
+    }
 class SuccessResponse(BaseModel, Generic[T]):
     success: bool = True
     message: Optional[str]
@@ -113,4 +122,3 @@ class ErrorResponse(BaseModel):
     message: str
     error: ErrorDetails
     timestamp: str
-    
\ No newline at end of file
diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index efdf6dd..fab2e73 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -1,10 +1,12 @@
-from fastapi import APIRouter, Query
+from fastapi import APIRouter, Query, Body, HTTPException
 from src.database.mongo_client import db, get_collection
 from src.models.models import CreateMovieRequest, Movie, SuccessResponse
 from typing import List
 from datetime import datetime
 from src.utils.errorHandler import create_success_response, create_error_response
 import re
+from bson import ObjectId
+from bson.errors import InvalidId
 
 '''
 This file contains all the business logic for movie operations.
@@ -22,7 +24,26 @@
 # Place get_movie_by_id endpoint here
 #------------------------------------
 
+"""
+    GET /api/movies/{id}
+    Retrieve a single movie by its ID.
+    Path Parameters:
+        id (str): The ObjectId of the movie to retrieve.
+    Returns:
+        SuccessResponse[Movie]: A response object containing the movie data.
+"""
+
+@router.get("/{id}", response_model=SuccessResponse[Movie])
+async def get_movie_by_id(id: str):
+    # Validate ObjectId format
+    object_id = ObjectId(id)
+
+    # Use findOne() to get a single document by _id
+    movie = await db.movies.find_one({"_id": object_id})
 
+    movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
+    
+    return create_success_response(movie, "Movie retrieved successfully")
 
 """
     GET /api/movies/
@@ -101,6 +122,33 @@ async def get_all_movies(
 # Place create_movie endpoint here
 #------------------------------------
 
+"""
+    POST /api/movies/
+    Create a new movie.
+    Request Body:
+        title (str): The title of the movie.
+        genre (str): The genre of the movie.
+        year (int): The year the movie was released.
+        min_rating (float): The minimum IMDB rating.
+        max_rating (float): The maximum IMDB rating.
+    Returns:
+        SuccessResponse[Movie]: A response object containing the created movie data.
+"""
+
+@router.post("/", response_model=SuccessResponse[CreateMovieRequest], status_code=201)
+async def create_movie(movie: CreateMovieRequest):
+    # Pydantic will automatically validate the structure
+    movie_data = movie.model_dump(by_alias=True, exclude_none=True)
+    
+    result = await db.movies.insert_one(movie_data)
+
+    # Retrieve the created document to return complete data
+    created_movie = await db.movies.find_one({"_id": result.inserted_id})
+
+    created_movie["_id"] = str(created_movie["_id"]) # Convert ObjectId to string
+    
+    return create_success_response(created_movie, f"Movie '{movie_data['title']}' created successfully")
+
 #------------------------------------
 # Place create_movies_batch endpoint here
 #------------------------------------
@@ -159,6 +207,31 @@ async def create_movies_batch(movies: List[CreateMovieRequest]):
 # Place delete_movie endpoint here
 #------------------------------------
 
+
+"""
+    DELETE /api/movies/{id}
+    Delete a single movie by its ID.
+    Path Parameters:
+        id (str): The ObjectId of the movie to delete.
+    Returns:
+        SuccessResponse[dict]: A response object containing deletion details.
+"""
+
+@router.delete("/{id}", response_model=SuccessResponse[dict])
+async def delete_movie_by_id(id: str):
+    object_id = ObjectId(id)
+
+    # Use deleteOne() to remove a single document
+    result = await db.movies.delete_one({"_id": object_id})
+
+    if result.deleted_count == 0:
+        raise HTTPException(status_code=404, detail="Movie not found")
+    
+    return create_success_response(
+        {"deletedCount": result.deleted_count}, 
+        "Movie deleted successfully"
+    )
+
 #------------------------------------
 # Place delete_movies_by_batch endpoint here
 #------------------------------------
@@ -167,6 +240,362 @@ async def create_movies_batch(movies: List[CreateMovieRequest]):
 # Place find_and_delete_movie endpoint here
 #------------------------------------
 
+"""
+    DELETE /api/movies/{id}/find-and-delete
+    Finds and deletes a movie in a single atomic operation.
+    Demonstrates the findOneAndDelete() operation.
+    Path Parameters:
+        id (str): The ObjectId of the movie to find and delete.
+    Returns:
+        SuccessResponse[Movie]: A response object containing the deleted movie data.
+"""
+
+@router.delete("/{id}/find-and-delete", response_model=SuccessResponse[Movie])
+async def find_and_delete_movie(id: str):
+    object_id = ObjectId(id)
+
+    # Use find_one_and_delete() to find and delete in a single atomic operation
+    # This is useful when you need to return the deleted document
+    # or ensure the document exists before deletion
+    deleted_movie = await db.movies.find_one_and_delete({"_id": object_id})
+
+    if deleted_movie is None:
+        raise HTTPException(status_code=404, detail="Movie not found")
+
+    deleted_movie["_id"] = str(deleted_movie["_id"]) # Convert ObjectId to string
+    
+    return create_success_response(deleted_movie, "Movie found and deleted successfully")
+
+async def execute_aggregation(pipeline: list) -> list:
+    """Helper function to execute aggregation pipeline and return results"""
+    print(f"Executing pipeline: {pipeline}")  # Debug logging
+    print(f"Database name: {db.name if hasattr(db, 'name') else 'unknown'}")
+    print(f"Collection name: movies")
+    
+    # For motor (async MongoDB driver), we need to await the aggregate call
+    cursor = await db.movies.aggregate(pipeline)
+    results = await cursor.to_list(length=None)  # Convert cursor to list
+    
+    print(f"Aggregation returned {len(results)} results")  # Debug logging
+    if len(results) <= 3:  # Log first few results for debugging
+        for i, doc in enumerate(results):
+            print(f"Result {i+1}: {doc}")
+    
+    return results
+
+
+"""
+    GET /api/movies/aggregate/by-genre
+    Aggregate movies by genre with statistics using MongoDB aggregation pipeline.
+    Demonstrates grouping values from multiple documents and performing operations on grouped data.
+    Returns:
+        SuccessResponse[List[dict]]: A response object containing aggregated genre statistics.
+"""
+
+@router.get("/aggregate/by-genre", response_model=SuccessResponse[List[dict]])
+async def aggregate_movies_by_genre():
+    # Define an aggregation pipeline with match, unwind, group, and sort stages
+    pipeline = [
+        # Clean data: ensure year is an integer
+        {
+            "$match": {
+                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
+            }
+        },
+        {"$unwind": "$genres"},
+        {
+            "$group": {
+                "_id": "$genres",
+                "count": {"$sum": 1},
+                "avgRating": {"$avg": "$imdb.rating"},
+                "minYear": {"$min": "$year"},
+                "maxYear": {"$max": "$year"},
+                "totalVotes": {"$sum": "$imdb.votes"}
+            }
+        },
+        {"$sort": {"count": -1}},
+        {
+            "$project": {
+                "genre": "$_id",
+                "movieCount": "$count",
+                "averageRating": {"$round": ["$avgRating", 2]},
+                "yearRange": {
+                    "min": "$minYear",
+                    "max": "$maxYear"
+                },
+                "totalVotes": "$totalVotes",
+                "_id": 0
+            }
+        }
+    ]
+
+    # Execute the aggregation
+    results = await execute_aggregation(pipeline)
+    
+    return create_success_response(
+        results, 
+        f"Aggregated statistics for {len(results)} genres"
+    )
+
+
+"""
+    GET /api/movies/aggregate/recent-commented
+    Aggregate movies with their most recent comments using MongoDB $lookup aggregation.
+    Joins movies with comments collection to show recent comment activity.
+    Query Parameters:
+        limit (int, optional): Number of results to return (default: 10, max: 50).
+        movie_id (str, optional): Filter by specific movie ObjectId.
+    Returns:
+        SuccessResponse[List[dict]]: A response object containing movies with their most recent comments.
+"""
+
+@router.get("/aggregate/recent-commented", response_model=SuccessResponse[List[dict]])
+async def aggregate_movies_recent_commented(
+    limit: int = Query(default=10, ge=1, le=50),
+    movie_id: str = Query(default=None)
+):
+    # Define aggregation pipeline to join movies with their most recent comments
+    pipeline = [
+        {
+            "$match": {
+                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
+            }
+        }
+    ]
+    
+    # Add movie_id filter if provided
+    if movie_id:
+        try:
+            object_id = ObjectId(movie_id)
+            pipeline[0]["$match"]["_id"] = object_id
+        except Exception:
+            raise HTTPException(status_code=400, detail="Invalid movie_id format")
+    
+    # Add lookup and additional pipeline stages
+    pipeline.extend([
+        {
+            "$lookup": {
+                "from": "comments",
+                "localField": "_id",
+                "foreignField": "movie_id",
+                "as": "comments"
+            }
+        },
+        {
+            "$match": {
+                "comments": {"$ne": []}
+            }
+        },
+        {
+            "$addFields": {
+                "recentComments": {
+                    "$slice": [
+                        {
+                            "$sortArray": {
+                                "input": "$comments",
+                                "sortBy": {"date": -1}
+                            }
+                        },
+                        limit
+                    ]
+                },
+                "mostRecentCommentDate": {
+                    "$max": "$comments.date"
+                }
+            }
+        },
+        {
+            "$sort": {"mostRecentCommentDate": -1}
+        },
+        {
+            "$limit": 50 if movie_id else 20
+        },
+        {
+            "$project": {
+                "title": 1,
+                "year": 1,
+                "genres": 1,
+                "imdbRating": "$imdb.rating",
+                "recentComments": {
+                    "$map": {
+                        "input": "$recentComments",
+                        "as": "comment",
+                        "in": {
+                            "userName": "$$comment.name",
+                            "userEmail": "$$comment.email",
+                            "text": "$$comment.text",
+                            "date": "$$comment.date"
+                        }
+                    }
+                },
+                "totalComments": {"$size": "$comments"},
+                "_id": 1
+            }
+        }
+    ])
+
+    # Execute the aggregation
+    results = await execute_aggregation(pipeline)
+    
+    # Convert ObjectId to string for response
+    for result in results:
+        if "_id" in result:
+            result["_id"] = str(result["_id"])
+    
+    # Calculate total comments from all movies
+    total_comments = sum(result.get("totalComments", 0) for result in results)
+    
+    return create_success_response(
+        results, 
+        f"Found {total_comments} comments from movie{'s' if len(results) != 1 else ''}"
+    )
+
+
+"""
+    GET /api/movies/aggregate/by-year
+    Aggregate movies by year with average rating and movie count.
+    Reports yearly statistics including average rating and total movies per year.
+    Returns:
+        SuccessResponse[List[dict]]: A response object containing yearly movie statistics.
+"""
+
+@router.get("/aggregate/by-year", response_model=SuccessResponse[List[dict]])
+async def aggregate_movies_by_year():
+    # Define aggregation pipeline to group movies by year
+    pipeline = [
+        # Clean data: ensure year is an integer and within reasonable range
+        {
+            "$match": {
+                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
+            }
+        },
+        # Group by year and calculate statistics
+        {
+            "$group": {
+                "_id": "$year",
+                "movieCount": {"$sum": 1},
+                "averageRating": {
+                    "$avg": {
+                        "$cond": [
+                            {"$and": [
+                                {"$ne": ["$imdb.rating", None]},
+                                {"$ne": ["$imdb.rating", ""]},
+                                {"$eq": [{"$type": "$imdb.rating"}, "double"]}
+                            ]},
+                            "$imdb.rating",
+                            "$$REMOVE"
+                        ]
+                    }
+                },
+                "highestRating": {
+                    "$max": {
+                        "$cond": [
+                            {"$and": [
+                                {"$ne": ["$imdb.rating", None]},
+                                {"$ne": ["$imdb.rating", ""]},
+                                {"$eq": [{"$type": "$imdb.rating"}, "double"]}
+                            ]},
+                            "$imdb.rating",
+                            "$$REMOVE"
+                        ]
+                    }
+                },
+                "lowestRating": {
+                    "$min": {
+                        "$cond": [
+                            {"$and": [
+                                {"$ne": ["$imdb.rating", None]},
+                                {"$ne": ["$imdb.rating", ""]},
+                                {"$eq": [{"$type": "$imdb.rating"}, "double"]}
+                            ]},
+                            "$imdb.rating",
+                            "$$REMOVE"
+                        ]
+                    }
+                },
+                "totalVotes": {"$sum": "$imdb.votes"}
+            }
+        },
+        {
+            "$project": {
+                "year": "$_id",
+                "movieCount": 1,
+                "averageRating": {"$round": ["$averageRating", 2]},
+                "highestRating": 1,
+                "lowestRating": 1,
+                "totalVotes": 1,
+                "_id": 0
+            }
+        },
+        {"$sort": {"year": -1}}
+    ]
+
+    # Execute the aggregation
+    results = await execute_aggregation(pipeline)
+    
+    return create_success_response(
+        results, 
+        f"Aggregated statistics for {len(results)} years"
+    )
+
+
+"""
+    GET /api/movies/aggregate/directors
+    Aggregate directors with the most movies and their statistics.
+    Reports directors sorted by number of movies directed.
+    Query Parameters:
+        limit (int, optional): Number of results to return (default: 20, max: 100).
+        min_movies (int, optional): Minimum number of movies to include director (default: 1).
+    Returns:
+        SuccessResponse[List[dict]]: A response object containing director statistics.
+"""
+
+@router.get("/aggregate/directors", response_model=SuccessResponse[List[dict]])
+async def aggregate_directors_most_movies(
+    limit: int = Query(default=20, ge=1, le=100)
+):
+    # Define aggregation pipeline to find directors with most movies
+    pipeline = [
+        {
+            "$match": {
+                "directors": {"$exists": True, "$ne": None, "$ne": []},
+                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
+            }
+        },
+        {
+            "$unwind": "$directors"
+        },
+        {
+            "$match": {
+                "directors": {"$ne": None, "$ne": ""}
+            }
+        },
+        {
+            "$group": {
+                "_id": "$directors",
+                "movieCount": {"$sum": 1},
+                "averageRating": {"$avg": "$imdb.rating"}
+            }
+        },
+        {"$sort": {"movieCount": -1}},
+        {"$limit": limit},
+        {
+            "$project": {
+                "director": "$_id",
+                "movieCount": 1,
+                "averageRating": {"$round": ["$averageRating", 2]},
+                "_id": 0
+            }
+        }
+    ]
+
+    # Execute the aggregation
+    results = await execute_aggregation(pipeline)
+    
+    return create_success_response(
+        results, 
+        f"Found {len(results)} directors with most movies"
+    )
 
 # ---- Old testing endpoint, will be removed later ----
 '''

From 1731299c18f763342cf259d1aea1d5bb26667c11 Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Fri, 24 Oct 2025 15:20:57 -0400
Subject: [PATCH 002/110] remove comment line

---
 server/python/src/routers/movies.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index fab2e73..7c60599 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -545,7 +545,6 @@ async def aggregate_movies_by_year():
     Reports directors sorted by number of movies directed.
     Query Parameters:
         limit (int, optional): Number of results to return (default: 20, max: 100).
-        min_movies (int, optional): Minimum number of movies to include director (default: 1).
     Returns:
         SuccessResponse[List[dict]]: A response object containing director statistics.
 """

From 303fecc160007e75004cdd53df931cfc9619b724 Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Fri, 24 Oct 2025 15:32:57 -0400
Subject: [PATCH 003/110] add comment for vector search

---
 server/python/src/routers/movies.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 7c60599..237ef9d 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -609,4 +609,7 @@ async def test_error():
                 code="TEST_ERROR",
                 details=str(e)
             )
-'''
\ No newline at end of file
+'''
+
+# ---- Place Vector Search Here ----
+

From e6942b2b8296fb5c28542cceb47084418841acd5 Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Mon, 27 Oct 2025 15:40:37 -0400
Subject: [PATCH 004/110] feedback

---
 server/python/src/routers/movies.py | 95 +++++++++++++++++++++--------
 1 file changed, 69 insertions(+), 26 deletions(-)

diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 237ef9d..b4e5128 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -36,10 +36,19 @@
 @router.get("/{id}", response_model=SuccessResponse[Movie])
 async def get_movie_by_id(id: str):
     # Validate ObjectId format
-    object_id = ObjectId(id)
+    try:
+        object_id = ObjectId(id)
+    except InvalidId:
+        raise HTTPException(status_code=400, detail="Invalid movie ID format")
+
+    movies_collection = get_collection("movies")
+    try:
+        movie = await movies_collection.find_one({"_id": object_id})
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"Database error occurred: {str(e)}")
 
-    # Use findOne() to get a single document by _id
-    movie = await db.movies.find_one({"_id": object_id})
+    if movie is None:
+        raise HTTPException(status_code=400, detail="Movie not found")
 
     movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
     
@@ -105,7 +114,10 @@ async def get_all_movies(
     cursor = movies_collection.find(filter_dict).sort(sort).skip(skip).limit(limit)    
     movies = []
     async for movie in cursor:
+        if movie is None:
+            raise HTTPException(status_code=400, detail="Movie not found")
         movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
+
         # Ensure that the year field contains int value.
         if "year" in movie and not isinstance(movie["year"], int):
             cleaned_year = re.sub(r"\D", "", str(movie["year"]))
@@ -126,24 +138,35 @@ async def get_all_movies(
     POST /api/movies/
     Create a new movie.
     Request Body:
-        title (str): The title of the movie.
-        genre (str): The genre of the movie.
-        year (int): The year the movie was released.
-        min_rating (float): The minimum IMDB rating.
-        max_rating (float): The maximum IMDB rating.
+        movie (CreateMovieRequest): A movie object containing the movie data.
+            See CreateMovieRequest model for available fields.
     Returns:
         SuccessResponse[Movie]: A response object containing the created movie data.
 """
 
-@router.post("/", response_model=SuccessResponse[CreateMovieRequest], status_code=201)
+@router.post("/", response_model=SuccessResponse[Movie], status_code=201)
 async def create_movie(movie: CreateMovieRequest):
     # Pydantic will automatically validate the structure
     movie_data = movie.model_dump(by_alias=True, exclude_none=True)
     
-    result = await db.movies.insert_one(movie_data)
-
-    # Retrieve the created document to return complete data
-    created_movie = await db.movies.find_one({"_id": result.inserted_id})
+    movies_collection = get_collection("movies")
+    try:
+        result = await movies_collection.insert_one(movie_data)
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"Database error occurred: {str(e)}")
+    
+    # Verify that the document was created before querying it
+    if not result.acknowledged:
+        raise HTTPException(status_code=500, detail="Failed to create movie")
+    
+    try:
+        # Retrieve the created document to return complete data
+        created_movie = await movies_collection.find_one({"_id": result.inserted_id})
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"Database error occurred: {str(e)}")
+    
+    if created_movie is None:
+        raise HTTPException(status_code=500, detail="Movie was created but could not be retrieved")
 
     created_movie["_id"] = str(created_movie["_id"]) # Convert ObjectId to string
     
@@ -219,13 +242,24 @@ async def create_movies_batch(movies: List[CreateMovieRequest]):
 
 @router.delete("/{id}", response_model=SuccessResponse[dict])
 async def delete_movie_by_id(id: str):
-    object_id = ObjectId(id)
+    try:
+        object_id = ObjectId(id)
+    except InvalidId:
+        raise HTTPException(status_code=400, detail="Invalid movie ID format")
 
-    # Use deleteOne() to remove a single document
-    result = await db.movies.delete_one({"_id": object_id})
+    movies_collection = get_collection("movies")
+    try:
+        # Use deleteOne() to remove a single document
+        result = await movies_collection.delete_one({"_id": object_id})
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"Database error occurred: {str(e)}")
 
     if result.deleted_count == 0:
-        raise HTTPException(status_code=404, detail="Movie not found")
+        return create_error_response(
+            message="Movie not found",
+            code="MOVIE_NOT_FOUND", 
+            details=f"No movie found with ID: {id}"
+        )
     
     return create_success_response(
         {"deletedCount": result.deleted_count}, 
@@ -252,16 +286,26 @@ async def delete_movie_by_id(id: str):
 
 @router.delete("/{id}/find-and-delete", response_model=SuccessResponse[Movie])
 async def find_and_delete_movie(id: str):
-    object_id = ObjectId(id)
+    try:
+        object_id = ObjectId(id)
+    except InvalidId:
+        raise HTTPException(status_code=400, detail="Invalid movie ID format")
 
+    movies_collection = get_collection("movies")
     # Use find_one_and_delete() to find and delete in a single atomic operation
     # This is useful when you need to return the deleted document
     # or ensure the document exists before deletion
-    deleted_movie = await db.movies.find_one_and_delete({"_id": object_id})
+    try:
+        deleted_movie = await movies_collection.find_one_and_delete({"_id": object_id})
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"Database error occurred: {str(e)}")
 
     if deleted_movie is None:
-        raise HTTPException(status_code=404, detail="Movie not found")
-
+        return create_error_response(
+            message="Movie not found",
+            code="MOVIE_NOT_FOUND", 
+            details=f"No movie found with ID: {id}"
+        )
     deleted_movie["_id"] = str(deleted_movie["_id"]) # Convert ObjectId to string
     
     return create_success_response(deleted_movie, "Movie found and deleted successfully")
@@ -269,12 +313,11 @@ async def find_and_delete_movie(id: str):
 async def execute_aggregation(pipeline: list) -> list:
     """Helper function to execute aggregation pipeline and return results"""
     print(f"Executing pipeline: {pipeline}")  # Debug logging
-    print(f"Database name: {db.name if hasattr(db, 'name') else 'unknown'}")
-    print(f"Collection name: movies")
     
-    # For motor (async MongoDB driver), we need to await the aggregate call
-    cursor = await db.movies.aggregate(pipeline)
-    results = await cursor.to_list(length=None)  # Convert cursor to list
+    movies_collection = get_collection("movies")
+    # For the async Pymongo driver, we need to await the aggregate call
+    cursor = await movies_collection.aggregate(pipeline)
+    results = await cursor.to_list(length=None)  # Convert cursor to list to collect all data at once rather than processing data per document
     
     print(f"Aggregation returned {len(results)} results")  # Debug logging
     if len(results) <= 3:  # Log first few results for debugging

From aa1db244e7b5ee72024db786c00c12d25cf65dc1 Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Mon, 27 Oct 2025 16:33:25 -0400
Subject: [PATCH 005/110] pr feedback

---
 server/python/src/routers/movies.py | 222 ++++++++++++++++------------
 1 file changed, 126 insertions(+), 96 deletions(-)

diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index b4e5128..6c4895f 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -39,16 +39,28 @@ async def get_movie_by_id(id: str):
     try:
         object_id = ObjectId(id)
     except InvalidId:
-        raise HTTPException(status_code=400, detail="Invalid movie ID format")
+        return create_error_response(
+            message="Invalid movie ID format",
+            code="INTERNAL_SERVER_ERROR",
+            details=f"The provided ID '{id}' is not a valid ObjectId"
+        )
 
     movies_collection = get_collection("movies")
     try:
         movie = await movies_collection.find_one({"_id": object_id})
     except Exception as e:
-        raise HTTPException(status_code=500, detail=f"Database error occurred: {str(e)}")
+        return create_error_response(
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
 
     if movie is None:
-        raise HTTPException(status_code=400, detail="Movie not found")
+        return create_error_response(
+            message="Movie not found",
+            code="INTERNAL_SERVER_ERROR",
+            details=f"No movie found with ID: {id}"
+        )
 
     movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
     
@@ -111,21 +123,28 @@ async def get_all_movies(
     sort = [(sort_by, sort_order)]
 
     # Query the database with the constructed filter, sort, skip, and limit.
-    cursor = movies_collection.find(filter_dict).sort(sort).skip(skip).limit(limit)    
-    movies = []
-    async for movie in cursor:
-        if movie is None:
-            raise HTTPException(status_code=400, detail="Movie not found")
-        movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
-
-        # Ensure that the year field contains int value.
-        if "year" in movie and not isinstance(movie["year"], int):
-            cleaned_year = re.sub(r"\D", "", str(movie["year"]))
-            try:
-                movie["year"] = int(cleaned_year) if cleaned_year else None
-            except ValueError:
-                movie["year"] = None
-        movies.append(movie)            
+    try:
+        cursor = movies_collection.find(filter_dict).sort(sort).skip(skip).limit(limit)    
+        movies = []
+        async for movie in cursor:
+            if movie is None:
+                continue  # Skip null movies instead of raising exception
+            movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
+
+            # Ensure that the year field contains int value.
+            if "year" in movie and not isinstance(movie["year"], int):
+                cleaned_year = re.sub(r"\D", "", str(movie["year"]))
+                try:
+                    movie["year"] = int(cleaned_year) if cleaned_year else None
+                except ValueError:
+                    movie["year"] = None
+            movies.append(movie)
+    except Exception as e:
+        return create_error_response(
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
 
     # Return the results wrapped in a SuccessResponse    
     return create_success_response(movies, f"Found {len(movies)} movies.")
@@ -153,20 +172,36 @@ async def create_movie(movie: CreateMovieRequest):
     try:
         result = await movies_collection.insert_one(movie_data)
     except Exception as e:
-        raise HTTPException(status_code=500, detail=f"Database error occurred: {str(e)}")
+        return create_error_response(
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
     
     # Verify that the document was created before querying it
     if not result.acknowledged:
-        raise HTTPException(status_code=500, detail="Failed to create movie")
+        return create_error_response(
+            message="Failed to create movie",
+            code="INTERNAL_SERVER_ERROR",
+            details="The database did not acknowledge the insert operation"
+        )
     
     try:
         # Retrieve the created document to return complete data
         created_movie = await movies_collection.find_one({"_id": result.inserted_id})
     except Exception as e:
-        raise HTTPException(status_code=500, detail=f"Database error occurred: {str(e)}")
+        return create_error_response(
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
     
     if created_movie is None:
-        raise HTTPException(status_code=500, detail="Movie was created but could not be retrieved")
+        return create_error_response(
+            message="Movie creation verification failed",
+            code="INTERNAL_SERVER_ERROR",
+            details="Movie was created but could not be retrieved for verification"
+        )
 
     created_movie["_id"] = str(created_movie["_id"]) # Convert ObjectId to string
     
@@ -208,7 +243,16 @@ async def create_movies_batch(movies: List[CreateMovieRequest]):
     movies_dicts = []
     for movie in movies:
         movies_dicts.append(movie.model_dump(exclude_unset=True, exclude_none=True))
-    result = await movies_collection.insert_many(movies_dicts)
+    
+    try:
+        result = await movies_collection.insert_many(movies_dicts)
+    except Exception as e:
+        return create_error_response(
+            message="Database error occurred during batch creation",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
+    
     return create_success_response({
         "insertedCount": len(result.inserted_ids),
         "insertedIds": [str(_id) for _id in result.inserted_ids]
@@ -245,19 +289,27 @@ async def delete_movie_by_id(id: str):
     try:
         object_id = ObjectId(id)
     except InvalidId:
-        raise HTTPException(status_code=400, detail="Invalid movie ID format")
+        return create_error_response(
+            message="Invalid movie ID format",
+            code="INTERNAL_SERVER_ERROR",
+            details=f"The provided ID '{id}' is not a valid ObjectId"
+        )
 
     movies_collection = get_collection("movies")
     try:
         # Use deleteOne() to remove a single document
         result = await movies_collection.delete_one({"_id": object_id})
     except Exception as e:
-        raise HTTPException(status_code=500, detail=f"Database error occurred: {str(e)}")
+        return create_error_response(
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
 
     if result.deleted_count == 0:
         return create_error_response(
             message="Movie not found",
-            code="MOVIE_NOT_FOUND", 
+            code="INTERNAL_SERVER_ERROR", 
             details=f"No movie found with ID: {id}"
         )
     
@@ -289,7 +341,11 @@ async def find_and_delete_movie(id: str):
     try:
         object_id = ObjectId(id)
     except InvalidId:
-        raise HTTPException(status_code=400, detail="Invalid movie ID format")
+        return create_error_response(
+            message="Invalid movie ID format",
+            code="INTERNAL_SERVER_ERROR",
+            details=f"The provided ID '{id}' is not a valid ObjectId"
+        )
 
     movies_collection = get_collection("movies")
     # Use find_one_and_delete() to find and delete in a single atomic operation
@@ -298,12 +354,16 @@ async def find_and_delete_movie(id: str):
     try:
         deleted_movie = await movies_collection.find_one_and_delete({"_id": object_id})
     except Exception as e:
-        raise HTTPException(status_code=500, detail=f"Database error occurred: {str(e)}")
+        return create_error_response(
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
 
     if deleted_movie is None:
         return create_error_response(
             message="Movie not found",
-            code="MOVIE_NOT_FOUND", 
+            code="INTERNAL_SERVER_ERROR", 
             details=f"No movie found with ID: {id}"
         )
     deleted_movie["_id"] = str(deleted_movie["_id"]) # Convert ObjectId to string
@@ -326,63 +386,8 @@ async def execute_aggregation(pipeline: list) -> list:
     
     return results
 
-
-"""
-    GET /api/movies/aggregate/by-genre
-    Aggregate movies by genre with statistics using MongoDB aggregation pipeline.
-    Demonstrates grouping values from multiple documents and performing operations on grouped data.
-    Returns:
-        SuccessResponse[List[dict]]: A response object containing aggregated genre statistics.
-"""
-
-@router.get("/aggregate/by-genre", response_model=SuccessResponse[List[dict]])
-async def aggregate_movies_by_genre():
-    # Define an aggregation pipeline with match, unwind, group, and sort stages
-    pipeline = [
-        # Clean data: ensure year is an integer
-        {
-            "$match": {
-                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
-            }
-        },
-        {"$unwind": "$genres"},
-        {
-            "$group": {
-                "_id": "$genres",
-                "count": {"$sum": 1},
-                "avgRating": {"$avg": "$imdb.rating"},
-                "minYear": {"$min": "$year"},
-                "maxYear": {"$max": "$year"},
-                "totalVotes": {"$sum": "$imdb.votes"}
-            }
-        },
-        {"$sort": {"count": -1}},
-        {
-            "$project": {
-                "genre": "$_id",
-                "movieCount": "$count",
-                "averageRating": {"$round": ["$avgRating", 2]},
-                "yearRange": {
-                    "min": "$minYear",
-                    "max": "$maxYear"
-                },
-                "totalVotes": "$totalVotes",
-                "_id": 0
-            }
-        }
-    ]
-
-    # Execute the aggregation
-    results = await execute_aggregation(pipeline)
-    
-    return create_success_response(
-        results, 
-        f"Aggregated statistics for {len(results)} genres"
-    )
-
-
 """
-    GET /api/movies/aggregate/recent-commented
+    GET /api/movies/reportingByComments
     Aggregate movies with their most recent comments using MongoDB $lookup aggregation.
     Joins movies with comments collection to show recent comment activity.
     Query Parameters:
@@ -392,7 +397,7 @@ async def aggregate_movies_by_genre():
         SuccessResponse[List[dict]]: A response object containing movies with their most recent comments.
 """
 
-@router.get("/aggregate/recent-commented", response_model=SuccessResponse[List[dict]])
+@router.get("/api/movies/reportingByComments", response_model=SuccessResponse[List[dict]])
 async def aggregate_movies_recent_commented(
     limit: int = Query(default=10, ge=1, le=50),
     movie_id: str = Query(default=None)
@@ -412,7 +417,11 @@ async def aggregate_movies_recent_commented(
             object_id = ObjectId(movie_id)
             pipeline[0]["$match"]["_id"] = object_id
         except Exception:
-            raise HTTPException(status_code=400, detail="Invalid movie_id format")
+            return create_error_response(
+                message="Invalid movie ID format",
+                code="INTERNAL_SERVER_ERROR",
+                details="The provided movie_id is not a valid ObjectId"
+            )
     
     # Add lookup and additional pipeline stages
     pipeline.extend([
@@ -451,7 +460,7 @@ async def aggregate_movies_recent_commented(
             "$sort": {"mostRecentCommentDate": -1}
         },
         {
-            "$limit": 50 if movie_id else 20
+            "$limit": limit
         },
         {
             "$project": {
@@ -478,8 +487,15 @@ async def aggregate_movies_recent_commented(
     ])
 
     # Execute the aggregation
-    results = await execute_aggregation(pipeline)
-    
+    try:
+        results = await execute_aggregation(pipeline)
+    except Exception as e:
+        return create_error_response(
+            message="Database error occurred during aggregation",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
+
     # Convert ObjectId to string for response
     for result in results:
         if "_id" in result:
@@ -495,14 +511,14 @@ async def aggregate_movies_recent_commented(
 
 
 """
-    GET /api/movies/aggregate/by-year
+    GET /api/movies/reportingByYear
     Aggregate movies by year with average rating and movie count.
     Reports yearly statistics including average rating and total movies per year.
     Returns:
         SuccessResponse[List[dict]]: A response object containing yearly movie statistics.
 """
 
-@router.get("/aggregate/by-year", response_model=SuccessResponse[List[dict]])
+@router.get("/api/movies/reportingByYear", response_model=SuccessResponse[List[dict]])
 async def aggregate_movies_by_year():
     # Define aggregation pipeline to group movies by year
     pipeline = [
@@ -574,7 +590,14 @@ async def aggregate_movies_by_year():
     ]
 
     # Execute the aggregation
-    results = await execute_aggregation(pipeline)
+    try:
+        results = await execute_aggregation(pipeline)
+    except Exception as e:
+        return create_error_response(
+            message="Database error occurred during aggregation",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
     
     return create_success_response(
         results, 
@@ -583,7 +606,7 @@ async def aggregate_movies_by_year():
 
 
 """
-    GET /api/movies/aggregate/directors
+    GET /api/movies/reportingByDirectors
     Aggregate directors with the most movies and their statistics.
     Reports directors sorted by number of movies directed.
     Query Parameters:
@@ -592,7 +615,7 @@ async def aggregate_movies_by_year():
         SuccessResponse[List[dict]]: A response object containing director statistics.
 """
 
-@router.get("/aggregate/directors", response_model=SuccessResponse[List[dict]])
+@router.get("/api/movies/reportingByDirectors", response_model=SuccessResponse[List[dict]])
 async def aggregate_directors_most_movies(
     limit: int = Query(default=20, ge=1, le=100)
 ):
@@ -632,7 +655,14 @@ async def aggregate_directors_most_movies(
     ]
 
     # Execute the aggregation
-    results = await execute_aggregation(pipeline)
+    try:
+        results = await execute_aggregation(pipeline)
+    except Exception as e:
+        return create_error_response(
+            message="Database error occurred during aggregation",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
     
     return create_success_response(
         results, 

From 0362be78d9a54b3785e9f12983687d29cfcfedbc Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Mon, 27 Oct 2025 16:39:04 -0400
Subject: [PATCH 006/110] remove unneeded imports

---
 server/python/src/routers/movies.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 6c4895f..0d2f785 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -1,5 +1,5 @@
-from fastapi import APIRouter, Query, Body, HTTPException
-from src.database.mongo_client import db, get_collection
+from fastapi import APIRouter, Query
+from src.database.mongo_client import get_collection
 from src.models.models import CreateMovieRequest, Movie, SuccessResponse
 from typing import List
 from datetime import datetime

From 1cc125a0be7a7e9cc15e6e5b3503757749d01252 Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Tue, 28 Oct 2025 16:01:12 -0400
Subject: [PATCH 007/110] add agg stage comments

---
 server/python/src/routers/movies.py | 164 ++++++++++++++++++++++------
 1 file changed, 129 insertions(+), 35 deletions(-)

diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 0d2f785..bbde50f 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -165,7 +165,7 @@ async def get_all_movies(
 
 @router.post("/", response_model=SuccessResponse[Movie], status_code=201)
 async def create_movie(movie: CreateMovieRequest):
-    # Pydantic will automatically validate the structure
+    # Pydantic automatically validates the structure
     movie_data = movie.model_dump(by_alias=True, exclude_none=True)
     
     movies_collection = get_collection("movies")
@@ -423,8 +423,29 @@ async def aggregate_movies_recent_commented(
                 details="The provided movie_id is not a valid ObjectId"
             )
     
-    # Add lookup and additional pipeline stages
+    # Add a multi-stage aggregation that:
+    # 1. Filters movies by valid year range
+    # 2. Joins with comments collection (like SQL JOIN)
+    # 3. Filters to only movies that have comments
+    # 4. Sorts comments by date and extracts most recent ones
+    # 5. Sorts movies by their most recent comment date
+    # 6. Shapes the final output with transformed comment structure
+    
+    pipeline = [
+        # STAGE 1: $match - Initial Filter
+        # Filter movies to only those with valid year data
+        # Tip: Use $match early to reduce the initial dataset for better performance
+        {
+            "$match": {
+                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
+            }
+        }
+    ]
+    
+    # Add remaining pipeline stages
     pipeline.extend([
+        # STAGE 2: $lookup - Join with the 'comments' Collection
+        # This gives each movie document a 'comments' array containing all its comments
         {
             "$lookup": {
                 "from": "comments",
@@ -433,59 +454,74 @@ async def aggregate_movies_recent_commented(
                 "as": "comments"
             }
         },
+        # STAGE 3: $match - Filter Movies with at Least One Comment
+        # This helps reduces dataset to only movies with user engagement
         {
             "$match": {
                 "comments": {"$ne": []}
             }
         },
+        # STAGE 4: $addFields - Add New Computed Fields
         {
             "$addFields": {
+                # Add computed field 'recentComments' that extracts only the N most recent comments (up to 'limit')
                 "recentComments": {
                     "$slice": [
                         {
                             "$sortArray": {
                                 "input": "$comments",
-                                "sortBy": {"date": -1}
+                                "sortBy": {"date": -1}  # -1 = descending (newest first)
                             }
                         },
-                        limit
+                        limit  # Number of comments to keep
                     ]
                 },
+                # Add computed field 'mostRecentCommentDate' that gets the date of the most recent comment (to use in the next $sort stage)
                 "mostRecentCommentDate": {
                     "$max": "$comments.date"
                 }
             }
         },
+        # STAGE 5: $sort - Sort Movies by Most Recent Comment Date
         {
             "$sort": {"mostRecentCommentDate": -1}
         },
+        # STAGE 6: $limit - Restrict Result Set Size
+        # - If querying single movie: return up to 50 results
+        # - If querying all movies: return up to 20 results
+        # Tip: This prevents overwhelming the client with too much data
         {
-            "$limit": limit
+            "$limit": 50 if movie_id else 20
         },
+        # STAGE 7: $project - Shape Final Response Output
         {
             "$project": {
+                # Include basic movie fields
                 "title": 1,
                 "year": 1,
                 "genres": 1,
+                "_id": 1,
+                # Extract nested field: imdb.rating -> imdbRating
                 "imdbRating": "$imdb.rating",
+                # Use $map to reshape computed 'recentComments' field with cleaner field names
                 "recentComments": {
                     "$map": {
                         "input": "$recentComments",
                         "as": "comment",
                         "in": {
-                            "userName": "$$comment.name",
-                            "userEmail": "$$comment.email",
-                            "text": "$$comment.text",
-                            "date": "$$comment.date"
+                            "userName": "$$comment.name",      # Rename: name -> userName
+                            "userEmail": "$$comment.email",    # Rename: email -> userEmail
+                            "text": "$$comment.text",          # Keep: text
+                            "date": "$$comment.date"           # Keep: date
                         }
                     }
                 },
-                "totalComments": {"$size": "$comments"},
-                "_id": 1
+                # Calculate the total number of comments into 'totalComments' (not just 'recentComments')
+                # Used in display (e.g., "Showing 5 of 127 comments")
+                "totalComments": {"$size": "$comments"}
             }
         }
     ])
-
     # Execute the aggregation
     try:
         results = await execute_aggregation(pipeline)
@@ -520,32 +556,48 @@ async def aggregate_movies_recent_commented(
 
 @router.get("/api/movies/reportingByYear", response_model=SuccessResponse[List[dict]])
 async def aggregate_movies_by_year():
-    # Define aggregation pipeline to group movies by year
+    # Define aggregation pipeline to group movies by year with statistics
+    # This pipeline demonstrates grouping, statistical calculations, and data cleaning
+
+    # Add a multi-stage aggregation that:
+    # 1. Filters movies by valid year range (data quality filter)
+    # 2. Groups movies by release year and calculates statistics per year
+    # 3. Shapes the final output with clean field names and rounded averages
+    # 4. Sorts results by year (newest first) for chronological presentation
+    
     pipeline = [
+        # STAGE 1: $match - Data Quality Filter
         # Clean data: ensure year is an integer and within reasonable range
+        # Tip: Filter early to reduce dataset size and improve performance
         {
             "$match": {
                 "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
             }
         },
-        # Group by year and calculate statistics
+        
+        # STAGE 2: $group - Aggregate Movies by Year
+        # Group all movies by their release year and calculate various statistics
         {
             "$group": {
-                "_id": "$year",
-                "movieCount": {"$sum": 1},
+                "_id": "$year",  # Group by year field
+                "movieCount": {"$sum": 1},  # Count total movies per year
+                
+                # Calculate average rating (only for valid numeric ratings)
                 "averageRating": {
                     "$avg": {
                         "$cond": [
                             {"$and": [
-                                {"$ne": ["$imdb.rating", None]},
-                                {"$ne": ["$imdb.rating", ""]},
-                                {"$eq": [{"$type": "$imdb.rating"}, "double"]}
+                                {"$ne": ["$imdb.rating", None]},           # Not null
+                                {"$ne": ["$imdb.rating", ""]},             # Not empty string
+                                {"$eq": [{"$type": "$imdb.rating"}, "double"]}  # Is numeric
                             ]},
-                            "$imdb.rating",
-                            "$$REMOVE"
+                            "$imdb.rating",  # Include valid IMDB ratings
+                            "$$REMOVE"       # Exclude invalid IMDB ratings
                         ]
                     }
                 },
+                
+                # Find highest rating for the year (same validation as average rating)
                 "highestRating": {
                     "$max": {
                         "$cond": [
@@ -559,6 +611,8 @@ async def aggregate_movies_by_year():
                         ]
                     }
                 },
+                
+                # Find lowest rating for the year (same validation as average and highest rating)
                 "lowestRating": {
                     "$min": {
                         "$cond": [
@@ -572,21 +626,29 @@ async def aggregate_movies_by_year():
                         ]
                     }
                 },
+                
+                # Sum total votes across all movies in the year
                 "totalVotes": {"$sum": "$imdb.votes"}
             }
         },
+        
+        # STAGE 3: $project - Shape Final Output
+        # Transform the grouped data into a clean, readable format
         {
             "$project": {
-                "year": "$_id",
+                "year": "$_id",  # Rename _id back to year because grouping was done by year but values were stored in _id
                 "movieCount": 1,
-                "averageRating": {"$round": ["$averageRating", 2]},
+                "averageRating": {"$round": ["$averageRating", 2]},  # Round to 2 decimal places
                 "highestRating": 1,
                 "lowestRating": 1,
                 "totalVotes": 1,
-                "_id": 0
+                "_id": 0  # Exclude the _id field from output
             }
         },
-        {"$sort": {"year": -1}}
+        
+        # STAGE 4: $sort - Sort by Year (Newest First)
+        # Sort results in descending order to show most recent years first
+        {"$sort": {"year": -1}}  # -1 = descending order
     ]
 
     # Execute the aggregation
@@ -619,37 +681,69 @@ async def aggregate_movies_by_year():
 async def aggregate_directors_most_movies(
     limit: int = Query(default=20, ge=1, le=100)
 ):
-    # Define aggregation pipeline to find directors with most movies
+    # Define aggregation pipeline to find directors with the most movies
+    # This pipeline demonstrates array unwinding, filtering, and ranking
+    
+    # Add a multi-stage aggregation that:
+    # 1. Filters movies with valid directors and year data (data quality filter)
+    # 2. Unwinds directors array to create separate documents per director
+    # 3. Cleans director names by filtering out null/empty names
+    # 4. Groups movies by individual director and calculates statistics per director
+    # 5. Sorts directors based on movie count
+    # 6. Limits results to top N directors
+    # 7. Shapes the final output with clean field names and rounded averages
+
     pipeline = [
+        # STAGE 1: $match - Initial Data Quality Filter
+        # Filter movies that have director information and valid years
         {
             "$match": {
-                "directors": {"$exists": True, "$ne": None, "$ne": []},
-                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
+                "directors": {"$exists": True, "$ne": None, "$ne": []},  # Has directors array
+                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}  # Valid year range
             }
         },
+        
+        # STAGE 2: $unwind - Flatten Directors Array
+        # Convert each movie's directors array into separate documents
+        # Example: Movie with ["Director A", "Director B"] becomes 2 documents
         {
             "$unwind": "$directors"
         },
+        
+        # STAGE 3: $match - Clean Director Names
+        # Filter out any null or empty director names after unwinding
         {
             "$match": {
                 "directors": {"$ne": None, "$ne": ""}
             }
         },
+        
+        # STAGE 4: $group - Aggregate by Director
+        # Group all movies by director name and calculate statistics
         {
             "$group": {
-                "_id": "$directors",
-                "movieCount": {"$sum": 1},
-                "averageRating": {"$avg": "$imdb.rating"}
+                "_id": "$directors",  # Group by individual director name
+                "movieCount": {"$sum": 1},  # Count movies per director
+                "averageRating": {"$avg": "$imdb.rating"}  # Average rating of director's movies
             }
         },
-        {"$sort": {"movieCount": -1}},
+        
+        # STAGE 5: $sort - Rank Directors by Movie Count
+        # Sort directors by number of movies (highest first)
+        {"$sort": {"movieCount": -1}},  # -1 = descending (most movies first)
+        
+        # STAGE 6: $limit - Restrict Results
+        # Limit to top N directors based on user input
         {"$limit": limit},
+        
+        # STAGE 7: $project - Shape Final Output
+        # Transform the grouped data into a clean, readable format
         {
             "$project": {
-                "director": "$_id",
+                "director": "$_id",  # Rename _id to director
                 "movieCount": 1,
-                "averageRating": {"$round": ["$averageRating", 2]},
-                "_id": 0
+                "averageRating": {"$round": ["$averageRating", 2]},  # Round to 2 decimal places
+                "_id": 0  # Exclude the _id field from output
             }
         }
     ]

From 49b967a841648beb1d21c7737eada963c4725732 Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Tue, 28 Oct 2025 16:23:00 -0400
Subject: [PATCH 008/110] fix broken code

---
 server/python/src/routers/movies.py | 32 +++++++++++------------------
 1 file changed, 12 insertions(+), 20 deletions(-)

diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index bbde50f..6e8d959 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -402,26 +402,6 @@ async def aggregate_movies_recent_commented(
     limit: int = Query(default=10, ge=1, le=50),
     movie_id: str = Query(default=None)
 ):
-    # Define aggregation pipeline to join movies with their most recent comments
-    pipeline = [
-        {
-            "$match": {
-                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
-            }
-        }
-    ]
-    
-    # Add movie_id filter if provided
-    if movie_id:
-        try:
-            object_id = ObjectId(movie_id)
-            pipeline[0]["$match"]["_id"] = object_id
-        except Exception:
-            return create_error_response(
-                message="Invalid movie ID format",
-                code="INTERNAL_SERVER_ERROR",
-                details="The provided movie_id is not a valid ObjectId"
-            )
     
     # Add a multi-stage aggregation that:
     # 1. Filters movies by valid year range
@@ -441,6 +421,18 @@ async def aggregate_movies_recent_commented(
             }
         }
     ]
+
+    # Add movie_id filter if provided
+    if movie_id:
+        try:
+            object_id = ObjectId(movie_id)
+            pipeline[0]["$match"]["_id"] = object_id
+        except Exception:
+            return create_error_response(
+                message="Invalid movie ID format",
+                code="INTERNAL_SERVER_ERROR",
+                details="The provided movie_id is not a valid ObjectId"
+            )
     
     # Add remaining pipeline stages
     pipeline.extend([

From 9536cde3caae156cd6b0c884e7bfe6b1903eb176 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Fri, 24 Oct 2025 14:06:21 -0400
Subject: [PATCH 009/110] feat: set up repo structure and backend connection

---
 .gitignore                                    |   54 +
 JAVA-SPRING-IMPLEMENTATION-PLAN.md            |  665 +++
 client/next-env.d.ts                          |    6 +
 client/package-lock.json                      | 5007 +++++++++++++++++
 server/express/package-lock.json              | 4748 ++++++++++++++++
 server/java-spring/.env.example               |   13 +
 server/java-spring/.gitignore                 |   66 +
 .../.mvn/wrapper/maven-wrapper.properties     |    3 +
 server/java-spring/README.md                  |  200 +
 server/java-spring/mvnw                       |  295 +
 server/java-spring/mvnw.cmd                   |  189 +
 server/java-spring/pom.xml                    |   85 +
 .../samplemflix/SampleMflixApplication.java   |   23 +
 .../samplemflix/config/CorsConfig.java        |   53 +
 .../config/DatabaseVerification.java          |  145 +
 .../samplemflix/config/MongoConfig.java       |  110 +
 .../controller/MovieController.java           |   31 +
 .../exception/GlobalExceptionHandler.java     |   26 +
 .../exception/ResourceNotFoundException.java  |   20 +
 .../exception/ValidationException.java        |   20 +
 .../com/mongodb/samplemflix/model/Movie.java  |   38 +
 .../model/dto/CreateMovieRequest.java         |   16 +
 .../model/dto/UpdateMovieRequest.java         |   15 +
 .../model/response/ApiResponse.java           |   15 +
 .../model/response/ErrorResponse.java         |   15 +
 .../model/response/SuccessResponse.java       |   15 +
 .../repository/MovieRepository.java           |   27 +
 .../samplemflix/service/MovieService.java     |   25 +
 .../samplemflix/util/ValidationUtils.java     |   18 +
 .../src/main/resources/application.properties |   29 +
 .../controller/MovieControllerTest.java       |   14 +
 .../integration/MovieIntegrationTest.java     |   16 +
 .../samplemflix/service/MovieServiceTest.java |   14 +
 33 files changed, 12016 insertions(+)
 create mode 100644 JAVA-SPRING-IMPLEMENTATION-PLAN.md
 create mode 100644 client/next-env.d.ts
 create mode 100644 client/package-lock.json
 create mode 100644 server/express/package-lock.json
 create mode 100644 server/java-spring/.env.example
 create mode 100644 server/java-spring/.gitignore
 create mode 100644 server/java-spring/.mvn/wrapper/maven-wrapper.properties
 create mode 100644 server/java-spring/README.md
 create mode 100755 server/java-spring/mvnw
 create mode 100644 server/java-spring/mvnw.cmd
 create mode 100644 server/java-spring/pom.xml
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieController.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ResourceNotFoundException.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
 create mode 100644 server/java-spring/src/main/resources/application.properties
 create mode 100644 server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
 create mode 100644 server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
 create mode 100644 server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java

diff --git a/.gitignore b/.gitignore
index e69de29..e90af98 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1,54 @@
+# =============================================================================
+# Root .gitignore for MongoDB Sample Apps Monorepo
+# =============================================================================
+# This file contains patterns common to all projects in the monorepo.
+# Backend-specific patterns are defined in each backend's .gitignore file.
+# =============================================================================
+
+# Environment Variables (Global)
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+!.env.example
+
+# Operating System Files
+.DS_Store
+Thumbs.db
+
+# IDE and Editor Files (Global)
+.idea/
+.vscode/
+*.swp
+*.swo
+*.swn
+*.bak
+*.tmp
+*.iml
+.project
+.classpath
+.settings/
+*.sublime-project
+*.sublime-workspace
+
+# Logs (Global)
+logs/
+*.log
+
+# Temporary Files (Global)
+*.tmp
+*.temp
+.cache/
+
+# Node.js (Global - applies to all Node.js projects)
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# Test Coverage (Global)
+coverage/
+*.lcov
+.nyc_output
diff --git a/JAVA-SPRING-IMPLEMENTATION-PLAN.md b/JAVA-SPRING-IMPLEMENTATION-PLAN.md
new file mode 100644
index 0000000..e761fe8
--- /dev/null
+++ b/JAVA-SPRING-IMPLEMENTATION-PLAN.md
@@ -0,0 +1,665 @@
+# Java Spring Backend Implementation Plan
+
+## Executive Summary
+
+This document outlines the comprehensive implementation plan for translating the Express.js/TypeScript backend into a Java Spring Boot application. The implementation will maintain feature parity with the existing Express backend while following Spring Boot best practices and the MongoDB Java Driver conventions.
+
+---
+
+## 1. Project Overview
+
+### 1.1 Current State Analysis
+
+**Existing Express Backend Features:**
+- ✅ Basic CRUD operations (insertOne, insertMany, findOne, find, updateOne, updateMany, deleteOne, deleteMany, findOneAndDelete)
+- ✅ MongoDB connection management with pre-flight verification
+- ✅ Text search index creation and verification
+- ✅ Comprehensive error handling
+- ✅ Request validation
+- ✅ CORS configuration
+- ✅ Environment variable configuration
+- ✅ Unit tests with Jest
+
+**Python Backend Status:**
+- Partially implemented (only GET and batch POST endpoints)
+- Uses FastAPI with PyMongo driver
+- Async/await pattern
+
+### 1.2 Target Architecture
+
+**Java Spring Boot Stack:**
+- **Framework:** Spring Boot 3.x
+- **MongoDB Driver:** MongoDB Java Driver (latest stable version)
+- **Build Tool:** Maven or Gradle
+- **Java Version:** Java 17 or 21 (LTS)
+- **Testing:** JUnit 5 + Mockito + Spring Boot Test
+- **Documentation:** SpringDoc OpenAPI (Swagger)
+
+---
+
+## 2. Project Structure
+
+### 2.1 Directory Layout
+
+```
+server/java-spring/
+├── src/
+│   ├── main/
+│   │   ├── java/
+│   │   │   └── com/
+│   │   │       └── mongodb/
+│   │   │           └── samplemflix/
+│   │   │               ├── SampleMflixApplication.java
+│   │   │               ├── config/
+│   │   │               │   ├── MongoConfig.java
+│   │   │               │   ├── CorsConfig.java
+│   │   │               │   └── DatabaseVerification.java
+│   │   │               ├── controller/
+│   │   │               │   └── MovieController.java
+│   │   │               ├── service/
+│   │   │               │   └── MovieService.java
+│   │   │               ├── repository/
+│   │   │               │   └── MovieRepository.java
+│   │   │               ├── model/
+│   │   │               │   ├── Movie.java
+│   │   │               │   ├── Theater.java
+│   │   │               │   ├── Comment.java
+│   │   │               │   ├── dto/
+│   │   │               │   │   ├── CreateMovieRequest.java
+│   │   │               │   │   ├── UpdateMovieRequest.java
+│   │   │               │   │   └── MovieSearchQuery.java
+│   │   │               │   └── response/
+│   │   │               │       ├── ApiResponse.java
+│   │   │               │       ├── SuccessResponse.java
+│   │   │               │       └── ErrorResponse.java
+│   │   │               ├── exception/
+│   │   │               │   ├── GlobalExceptionHandler.java
+│   │   │               │   ├── ValidationException.java
+│   │   │               │   └── ResourceNotFoundException.java
+│   │   │               └── util/
+│   │   │                   └── ValidationUtils.java
+│   │   └── resources/
+│   │       ├── application.properties
+│   │       └── application-dev.properties
+│   └── test/
+│       └── java/
+│           └── com/
+│               └── mongodb/
+│                   └── samplemflix/
+│                       ├── controller/
+│                       │   └── MovieControllerTest.java
+│                       ├── service/
+│                       │   └── MovieServiceTest.java
+│                       └── integration/
+│                           └── MovieIntegrationTest.java
+├── pom.xml (or build.gradle)
+├── README.md
+└── .env.example
+```
+
+---
+
+## 3. Implementation Phases
+
+### Phase 1: Project Setup and Configuration (Days 1-2)
+
+#### 1.1 Initialize Spring Boot Project
+- [ ] Create Spring Boot project using Spring Initializr
+- [ ] Configure Maven/Gradle with required dependencies
+- [ ] Set up project structure following Spring conventions
+- [ ] Configure `.gitignore` for Java/Spring projects
+
+#### 1.2 Dependencies Configuration
+
+**Required Dependencies:**
+```xml
+<!-- Core Spring Boot -->
+<dependency>
+    <groupId>org.springframework.boot</groupId>
+    <artifactId>spring-boot-starter-web</artifactId>
+</dependency>
+
+<!-- MongoDB Driver -->
+<dependency>
+    <groupId>org.mongodb</groupId>
+    <artifactId>mongodb-driver-sync</artifactId>
+</dependency>
+
+<!-- Validation -->
+<dependency>
+    <groupId>org.springframework.boot</groupId>
+    <artifactId>spring-boot-starter-validation</artifactId>
+</dependency>
+
+<!-- Lombok (optional, for reducing boilerplate) -->
+<dependency>
+    <groupId>org.projectlombok</groupId>
+    <artifactId>lombok</artifactId>
+    <optional>true</optional>
+</dependency>
+
+<!-- Testing -->
+<dependency>
+    <groupId>org.springframework.boot</groupId>
+    <artifactId>spring-boot-starter-test</artifactId>
+    <scope>test</scope>
+</dependency>
+
+<!-- SpringDoc OpenAPI (Swagger) -->
+<dependency>
+    <groupId>org.springdoc</groupId>
+    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+</dependency>
+```
+
+#### 1.3 Environment Configuration
+- [ ] Create `application.properties` with MongoDB connection settings
+- [ ] Create `.env.example` file documenting required environment variables
+- [ ] Implement environment variable loading (Spring Boot handles this natively)
+- [ ] Configure CORS settings
+
+**application.properties:**
+```properties
+# MongoDB Configuration
+spring.data.mongodb.uri=${MONGODB_URI}
+spring.data.mongodb.database=sample_mflix
+
+# Server Configuration
+server.port=${PORT:3001}
+
+# CORS Configuration
+cors.allowed.origins=${CORS_ORIGIN:http://localhost:3000}
+
+# Application Info
+spring.application.name=MongoDB Sample MFlix API
+```
+
+---
+
+### Phase 2: Database Configuration and Connection (Days 2-3) ✅ COMPLETE
+
+#### 2.1 MongoDB Configuration Class ✅
+- [x] Create `MongoConfig.java` to configure MongoDB client
+- [x] Implement connection pooling and timeout settings
+- [x] Add connection lifecycle management
+
+**Key Features:**
+- ✅ Singleton MongoClient instance
+- ✅ Connection string validation
+- ✅ Database reference management
+- ✅ Graceful shutdown handling (managed by Spring)
+- ✅ Connection pool settings (max 100, min 10 connections)
+- ✅ Socket timeouts (10s connect, 10s read)
+- ✅ Server selection timeout (10s)
+
+#### 2.2 Database Verification Service ✅
+- [x] Create `DatabaseVerification.java` as a Spring component
+- [x] Implement `@PostConstruct` method for startup verification
+- [x] Check for movies collection and document count
+- [x] Create text search indexes if missing
+- [x] Log verification results
+
+**Verification Checklist:**
+- ✅ Movies collection exists
+- ✅ Movies collection has documents (with warning if empty)
+- ✅ Text search index on plot, title, fullplot fields
+- ✅ Log warnings if data is missing
+- ✅ Non-blocking verification (app starts even if verification fails)
+
+---
+
+### Phase 3: Model Layer Implementation (Days 3-4)
+
+#### 3.1 Domain Models
+- [ ] Create `Movie.java` entity class
+- [ ] Create `Theater.java` entity class
+- [ ] Create `Comment.java` entity class
+- [ ] Add BSON annotations for MongoDB mapping
+- [ ] Implement nested objects (Awards, IMDB, Tomatoes)
+
+**Movie.java Structure:**
+```java
+@Document(collection = "movies")
+public class Movie {
+    @Id
+    private ObjectId id;
+    
+    private String title;
+    private Integer year;
+    private String plot;
+    private String fullplot;
+    private List<String> genres;
+    private List<String> directors;
+    private List<String> writers;
+    private List<String> cast;
+    private List<String> countries;
+    private List<String> languages;
+    private String rated;
+    private Integer runtime;
+    private String poster;
+    
+    private Awards awards;
+    private IMDB imdb;
+    private Tomatoes tomatoes;
+    private Integer metacritic;
+    private String type;
+    
+    // Nested classes for complex fields
+    public static class Awards { ... }
+    public static class IMDB { ... }
+    public static class Tomatoes { ... }
+}
+```
+
+#### 3.2 DTOs (Data Transfer Objects)
+- [ ] Create `CreateMovieRequest.java`
+- [ ] Create `UpdateMovieRequest.java`
+- [ ] Create `MovieSearchQuery.java`
+- [ ] Add validation annotations (@NotNull, @NotBlank, etc.)
+
+#### 3.3 Response Models
+- [ ] Create generic `ApiResponse<T>` interface
+- [ ] Create `SuccessResponse<T>` class
+- [ ] Create `ErrorResponse` class
+- [ ] Add timestamp and metadata fields
+
+---
+
+### Phase 4: Repository Layer (Days 4-5)
+
+#### 4.1 Custom Repository Implementation
+- [ ] Create `MovieRepository.java` interface
+- [ ] Implement custom repository using MongoTemplate or MongoCollection
+- [ ] Add methods for all CRUD operations
+
+**Repository Methods:**
+```java
+public interface MovieRepository {
+    // Basic CRUD
+    Movie insertOne(Movie movie);
+    List<ObjectId> insertMany(List<Movie> movies);
+    Optional<Movie> findById(ObjectId id);
+    List<Movie> find(Document filter, Document sort, int skip, int limit);
+    UpdateResult updateOne(ObjectId id, Document update);
+    UpdateResult updateMany(Document filter, Document update);
+    DeleteResult deleteOne(ObjectId id);
+    DeleteResult deleteMany(Document filter);
+    Optional<Movie> findOneAndDelete(ObjectId id);
+    
+    // Utility
+    long countDocuments();
+}
+```
+
+---
+
+### Phase 5: Service Layer (Days 5-7)
+
+#### 5.1 Movie Service Implementation
+- [ ] Create `MovieService.java` with business logic
+- [ ] Implement all CRUD operations
+- [ ] Add query building logic for filtering
+- [ ] Implement pagination and sorting
+- [ ] Add validation logic
+
+**Service Responsibilities:**
+- Business logic and validation
+- Query construction (filters, sorts, pagination)
+- Data transformation between DTOs and entities
+- Error handling and exception throwing
+
+---
+
+### Phase 6: Controller Layer (Days 7-9)
+
+#### 6.1 REST API Endpoints
+- [ ] Create `MovieController.java` with REST endpoints
+- [ ] Implement all endpoints matching Express routes
+- [ ] Add request validation
+- [ ] Add API documentation annotations
+
+**Endpoint Mapping:**
+```
+GET    /api/movies              -> getAllMovies()
+GET    /api/movies/{id}         -> getMovieById()
+POST   /api/movies              -> createMovie()
+POST   /api/movies/batch        -> createMoviesBatch()
+PUT    /api/movies/{id}         -> updateMovie()
+PATCH  /api/movies              -> updateMoviesBatch()
+DELETE /api/movies/{id}         -> deleteMovie()
+DELETE /api/movies              -> deleteMoviesBatch()
+DELETE /api/movies/{id}/find-and-delete -> findAndDeleteMovie()
+```
+
+#### 6.2 Request/Response Handling
+- [ ] Implement consistent response wrapping
+- [ ] Add query parameter parsing
+- [ ] Implement request body validation
+- [ ] Add proper HTTP status codes
+
+---
+
+### Phase 7: Error Handling (Days 9-10)
+
+#### 7.1 Exception Hierarchy
+- [ ] Create custom exception classes
+- [ ] Implement `GlobalExceptionHandler` with @ControllerAdvice
+- [ ] Handle MongoDB-specific exceptions
+- [ ] Handle validation exceptions
+
+**Exception Types:**
+- `ResourceNotFoundException` (404)
+- `ValidationException` (400)
+- `DuplicateKeyException` (409)
+- `DatabaseException` (500)
+
+#### 7.2 Error Response Format
+- [ ] Standardize error response structure
+- [ ] Include error codes and messages
+- [ ] Add timestamp and request path
+- [ ] Log errors appropriately
+
+---
+
+### Phase 8: Testing (Days 10-12)
+
+#### 8.1 Unit Tests
+- [ ] Test MovieService methods
+- [ ] Test MovieController endpoints
+- [ ] Mock repository layer
+- [ ] Achieve >80% code coverage
+
+#### 8.2 Integration Tests
+- [ ] Test with embedded MongoDB or Testcontainers
+- [ ] Test full request/response cycle
+- [ ] Test error scenarios
+- [ ] Test database operations
+
+#### 8.3 Test Configuration
+- [ ] Create test application.properties
+- [ ] Set up test fixtures and data
+- [ ] Configure test MongoDB instance
+
+---
+
+### Phase 9: Documentation and Polish (Days 12-13)
+
+#### 9.1 Code Documentation
+- [ ] Add comprehensive JavaDoc comments
+- [ ] Document MongoDB operations clearly
+- [ ] Add inline comments explaining driver usage
+- [ ] Note deviations from standard practices
+
+#### 9.2 API Documentation
+- [ ] Configure Swagger/OpenAPI
+- [ ] Add endpoint descriptions
+- [ ] Document request/response schemas
+- [ ] Add example requests
+
+#### 9.3 README and Setup Guide
+- [ ] Create comprehensive README.md
+- [ ] Document prerequisites (Java version, Maven/Gradle)
+- [ ] Provide setup instructions
+- [ ] Document environment variables
+- [ ] Add troubleshooting section
+
+---
+
+## 4. Technical Implementation Details
+
+### 4.1 MongoDB Driver Usage Patterns
+
+**Connection Management:**
+```java
+@Configuration
+public class MongoConfig {
+    @Bean
+    public MongoClient mongoClient(@Value("${spring.data.mongodb.uri}") String uri) {
+        return MongoClients.create(uri);
+    }
+    
+    @Bean
+    public MongoDatabase mongoDatabase(MongoClient client) {
+        return client.getDatabase("sample_mflix");
+    }
+}
+```
+
+**Collection Access:**
+```java
+@Repository
+public class MovieRepositoryImpl implements MovieRepository {
+    private final MongoCollection<Document> collection;
+    
+    public MovieRepositoryImpl(MongoDatabase database) {
+        this.collection = database.getCollection("movies");
+    }
+}
+```
+
+### 4.2 Query Building Examples
+
+**Text Search:**
+```java
+Document filter = new Document("$text", new Document("$search", searchQuery));
+```
+
+**Range Queries:**
+```java
+Document ratingFilter = new Document()
+    .append("$gte", minRating)
+    .append("$lte", maxRating);
+filter.append("imdb.rating", ratingFilter);
+```
+
+**Sorting:**
+```java
+Document sort = new Document(sortBy, sortOrder.equals("desc") ? -1 : 1);
+```
+
+### 4.3 Error Handling Pattern
+
+```java
+@ControllerAdvice
+public class GlobalExceptionHandler {
+    @ExceptionHandler(MongoException.class)
+    public ResponseEntity<ErrorResponse> handleMongoException(MongoException ex) {
+        // Parse MongoDB error codes
+        // Return appropriate HTTP status and error response
+    }
+}
+```
+
+---
+
+## 5. Migration Mapping
+
+### 5.1 Express to Spring Equivalents
+
+| Express Concept | Spring Boot Equivalent |
+|----------------|------------------------|
+| `app.ts` | `SampleMflixApplication.java` (main class) |
+| Routes (`movies.ts`) | `@RestController` in `MovieController.java` |
+| Controllers | `@Service` in `MovieService.java` |
+| `database.ts` | `MongoConfig.java` + `DatabaseVerification.java` |
+| `errorHandler.ts` | `GlobalExceptionHandler.java` |
+| Types/Interfaces | Java classes with proper annotations |
+| `asyncHandler` | Spring handles async automatically |
+| `dotenv` | `application.properties` + environment variables |
+
+### 5.2 Code Pattern Translations
+
+**Express Pattern:**
+```typescript
+router.get("/", asyncHandler(movieController.getAllMovies));
+```
+
+**Spring Pattern:**
+```java
+@GetMapping
+public ResponseEntity<SuccessResponse<List<Movie>>> getAllMovies(
+    @RequestParam(required = false) String q,
+    // ... other params
+) {
+    // Implementation
+}
+```
+
+---
+
+## 6. Quality Assurance Checklist
+
+### 6.1 Functional Requirements
+- [ ] All CRUD operations work correctly
+- [ ] Text search functionality works
+- [ ] Filtering and pagination work
+- [ ] Sorting works correctly
+- [ ] Batch operations work
+- [ ] Error handling is comprehensive
+
+### 6.2 Code Quality
+- [ ] Code follows Spring Boot best practices
+- [ ] Comprehensive comments explaining MongoDB operations
+- [ ] Proper separation of concerns (Controller/Service/Repository)
+- [ ] No hardcoded values
+- [ ] Proper exception handling
+
+### 6.3 Testing
+- [ ] Unit tests pass
+- [ ] Integration tests pass
+- [ ] Code coverage >80%
+- [ ] Edge cases tested
+
+### 6.4 Documentation
+- [ ] README is comprehensive
+- [ ] API documentation is complete
+- [ ] Code comments are thorough
+- [ ] Setup instructions are clear
+
+---
+
+## 7. Timeline and Milestones
+
+| Phase | Duration | Deliverable |
+|-------|----------|-------------|
+| Phase 1: Setup | 2 days | Project structure, dependencies configured |
+| Phase 2: Database | 1 day | MongoDB connection and verification working |
+| Phase 3: Models | 1 day | All model classes implemented |
+| Phase 4: Repository | 1 day | Repository layer complete |
+| Phase 5: Service | 2 days | Business logic implemented |
+| Phase 6: Controller | 2 days | All REST endpoints working |
+| Phase 7: Error Handling | 1 day | Comprehensive error handling |
+| Phase 8: Testing | 2 days | Tests written and passing |
+| Phase 9: Documentation | 1 day | Documentation complete |
+| **Total** | **13 days** | **Production-ready Java Spring backend** |
+
+---
+
+## 8. Post-Implementation Tasks
+
+### 8.1 Integration with Frontend
+- [ ] Test with existing Next.js frontend
+- [ ] Verify CORS configuration
+- [ ] Test all API endpoints from frontend
+- [ ] Verify response format compatibility
+
+### 8.2 Performance Optimization
+- [ ] Add connection pooling configuration
+- [ ] Optimize query performance
+- [ ] Add caching if needed
+- [ ] Profile and optimize hot paths
+
+### 8.3 Deployment Preparation
+- [ ] Create Docker configuration
+- [ ] Document deployment process
+- [ ] Create production configuration
+- [ ] Add health check endpoints
+
+---
+
+## 9. Success Criteria
+
+The Java Spring implementation will be considered complete when:
+
+1. ✅ All CRUD operations match Express functionality
+2. ✅ All tests pass with >80% coverage
+3. ✅ API responses match Express format exactly
+4. ✅ Frontend works without modifications
+5. ✅ Documentation is comprehensive
+6. ✅ Code follows Spring Boot best practices
+7. ✅ MongoDB operations are well-documented
+8. ✅ Error handling is robust
+9. ✅ Pre-flight verification works
+10. ✅ README provides clear setup instructions
+
+---
+
+## 10. Notes and Considerations
+
+### 10.1 Design Decisions
+
+**Why not Spring Data MongoDB?**
+- The scope requires direct MongoDB Driver usage to demonstrate driver operations
+- Spring Data MongoDB abstracts away driver details
+- Educational value is in showing raw driver usage
+
+**Lombok Usage:**
+- Optional but recommended for reducing boilerplate
+- Helps maintain readability
+- Can be removed if team prefers explicit code
+
+**Testing Strategy:**
+- Unit tests for service layer
+- Integration tests for full stack
+- Consider Testcontainers for realistic MongoDB testing
+
+### 10.2 Future Enhancements (Post-MVP)
+
+- [ ] Aggregation pipeline endpoints
+- [ ] Full-text search with Atlas Search
+- [ ] Vector search implementation
+- [ ] Geospatial queries for theaters
+- [ ] Caching layer
+- [ ] Rate limiting
+- [ ] Metrics and monitoring
+
+---
+
+## Appendix A: Key Files Reference
+
+### Express Backend Files to Reference
+- `server/express/src/app.ts` - Main application setup
+- `server/express/src/config/database.ts` - Database configuration
+- `server/express/src/controllers/movieController.ts` - Business logic
+- `server/express/src/routes/movies.ts` - Route definitions
+- `server/express/src/types/index.ts` - Type definitions
+- `server/express/src/utils/errorHandler.ts` - Error handling
+
+### Python Backend Files (for comparison)
+- `server/python/main.py` - FastAPI application
+- `server/python/src/routers/movies.py` - Route handlers
+- `server/python/src/database/mongo_client.py` - Database connection
+
+---
+
+## Appendix B: Environment Variables
+
+Required environment variables for Java Spring backend:
+
+```properties
+# MongoDB Connection
+MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/?retryWrites=true&w=majority
+
+# Server Configuration
+PORT=3001
+
+# CORS Configuration
+CORS_ORIGIN=http://localhost:3000
+```
+
+---
+
+**Document Version:** 1.0  
+**Last Updated:** 2025-10-23  
+**Author:** Implementation Plan Generator  
+**Status:** Ready for Implementation
diff --git a/client/next-env.d.ts b/client/next-env.d.ts
new file mode 100644
index 0000000..830fb59
--- /dev/null
+++ b/client/next-env.d.ts
@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+/// <reference path="./.next/types/routes.d.ts" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
diff --git a/client/package-lock.json b/client/package-lock.json
new file mode 100644
index 0000000..498a11c
--- /dev/null
+++ b/client/package-lock.json
@@ -0,0 +1,5007 @@
+{
+  "name": "sample-mflix-front-end",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "sample-mflix-front-end",
+      "version": "0.1.0",
+      "dependencies": {
+        "next": "15.5.5",
+        "react": "19.1.0",
+        "react-dom": "19.1.0"
+      },
+      "devDependencies": {
+        "@eslint/eslintrc": "^3",
+        "@types/node": "^20",
+        "@types/react": "^19",
+        "@types/react-dom": "^19",
+        "eslint": "^9",
+        "eslint-config-next": "15.5.5",
+        "typescript": "^5"
+      }
+    },
+    "node_modules/@emnapi/core": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.6.0.tgz",
+      "integrity": "sha512-zq/ay+9fNIJJtJiZxdTnXS20PllcYMX3OE23ESc4HK/bdYu3cOWYVhsOhVnXALfU/uqJIxn5NBPd9z4v+SfoSg==",
+      "dev": true,
+      "optional": true,
+      "dependencies": {
+        "@emnapi/wasi-threads": "1.1.0",
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@emnapi/runtime": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.6.0.tgz",
+      "integrity": "sha512-obtUmAHTMjll499P+D9A3axeJFlhdjOWdKUNs/U6QIGT7V5RjcUW1xToAzjvmgTSQhDbYn/NwfTRoJcQ2rNBxA==",
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@emnapi/wasi-threads": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.1.0.tgz",
+      "integrity": "sha512-WI0DdZ8xFSbgMjR1sFsKABJ/C5OnRrjT06JXbZKexJGrDuPTzZdDYfFlsgcCXCyf+suG5QU2e/y1Wo2V/OapLQ==",
+      "dev": true,
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@eslint-community/eslint-utils": {
+      "version": "4.9.0",
+      "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz",
+      "integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==",
+      "dev": true,
+      "dependencies": {
+        "eslint-visitor-keys": "^3.4.3"
+      },
+      "engines": {
+        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0"
+      }
+    },
+    "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": {
+      "version": "3.4.3",
+      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz",
+      "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==",
+      "dev": true,
+      "engines": {
+        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/@eslint-community/regexpp": {
+      "version": "4.12.2",
+      "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz",
+      "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==",
+      "dev": true,
+      "engines": {
+        "node": "^12.0.0 || ^14.0.0 || >=16.0.0"
+      }
+    },
+    "node_modules/@eslint/config-array": {
+      "version": "0.21.1",
+      "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.1.tgz",
+      "integrity": "sha512-aw1gNayWpdI/jSYVgzN5pL0cfzU02GT3NBpeT/DXbx1/1x7ZKxFPd9bwrzygx/qiwIQiJ1sw/zD8qY/kRvlGHA==",
+      "dev": true,
+      "dependencies": {
+        "@eslint/object-schema": "^2.1.7",
+        "debug": "^4.3.1",
+        "minimatch": "^3.1.2"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      }
+    },
+    "node_modules/@eslint/config-helpers": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.1.tgz",
+      "integrity": "sha512-csZAzkNhsgwb0I/UAV6/RGFTbiakPCf0ZrGmrIxQpYvGZ00PhTkSnyKNolphgIvmnJeGw6rcGVEXfTzUnFuEvw==",
+      "dev": true,
+      "dependencies": {
+        "@eslint/core": "^0.16.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      }
+    },
+    "node_modules/@eslint/core": {
+      "version": "0.16.0",
+      "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.16.0.tgz",
+      "integrity": "sha512-nmC8/totwobIiFcGkDza3GIKfAw1+hLiYVrh3I1nIomQ8PEr5cxg34jnkmGawul/ep52wGRAcyeDCNtWKSOj4Q==",
+      "dev": true,
+      "dependencies": {
+        "@types/json-schema": "^7.0.15"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      }
+    },
+    "node_modules/@eslint/eslintrc": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.1.tgz",
+      "integrity": "sha512-gtF186CXhIl1p4pJNGZw8Yc6RlshoePRvE0X91oPGb3vZ8pM3qOS9W9NGPat9LziaBV7XrJWGylNQXkGcnM3IQ==",
+      "dev": true,
+      "dependencies": {
+        "ajv": "^6.12.4",
+        "debug": "^4.3.2",
+        "espree": "^10.0.1",
+        "globals": "^14.0.0",
+        "ignore": "^5.2.0",
+        "import-fresh": "^3.2.1",
+        "js-yaml": "^4.1.0",
+        "minimatch": "^3.1.2",
+        "strip-json-comments": "^3.1.1"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/@eslint/js": {
+      "version": "9.38.0",
+      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.38.0.tgz",
+      "integrity": "sha512-UZ1VpFvXf9J06YG9xQBdnzU+kthors6KjhMAl6f4gH4usHyh31rUf2DLGInT8RFYIReYXNSydgPY0V2LuWgl7A==",
+      "dev": true,
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "url": "https://eslint.org/donate"
+      }
+    },
+    "node_modules/@eslint/object-schema": {
+      "version": "2.1.7",
+      "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz",
+      "integrity": "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==",
+      "dev": true,
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      }
+    },
+    "node_modules/@eslint/plugin-kit": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.4.0.tgz",
+      "integrity": "sha512-sB5uyeq+dwCWyPi31B2gQlVlo+j5brPlWx4yZBrEaRo/nhdDE8Xke1gsGgtiBdaBTxuTkceLVuVt/pclrasb0A==",
+      "dev": true,
+      "dependencies": {
+        "@eslint/core": "^0.16.0",
+        "levn": "^0.4.1"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      }
+    },
+    "node_modules/@humanfs/core": {
+      "version": "0.19.1",
+      "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.1.tgz",
+      "integrity": "sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==",
+      "dev": true,
+      "engines": {
+        "node": ">=18.18.0"
+      }
+    },
+    "node_modules/@humanfs/node": {
+      "version": "0.16.7",
+      "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.7.tgz",
+      "integrity": "sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ==",
+      "dev": true,
+      "dependencies": {
+        "@humanfs/core": "^0.19.1",
+        "@humanwhocodes/retry": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18.18.0"
+      }
+    },
+    "node_modules/@humanwhocodes/module-importer": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz",
+      "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==",
+      "dev": true,
+      "engines": {
+        "node": ">=12.22"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/nzakas"
+      }
+    },
+    "node_modules/@humanwhocodes/retry": {
+      "version": "0.4.3",
+      "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz",
+      "integrity": "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=18.18"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/nzakas"
+      }
+    },
+    "node_modules/@img/colour": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.0.0.tgz",
+      "integrity": "sha512-A5P/LfWGFSl6nsckYtjw9da+19jB8hkJ6ACTGcDfEJ0aE+l2n2El7dsVM7UVHZQ9s2lmYMWlrS21YLy2IR1LUw==",
+      "optional": true,
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@img/sharp-darwin-arm64": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.34.4.tgz",
+      "integrity": "sha512-sitdlPzDVyvmINUdJle3TNHl+AG9QcwiAMsXmccqsCOMZNIdW2/7S26w0LyU8euiLVzFBL3dXPwVCq/ODnf2vA==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-darwin-arm64": "1.2.3"
+      }
+    },
+    "node_modules/@img/sharp-darwin-x64": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.34.4.tgz",
+      "integrity": "sha512-rZheupWIoa3+SOdF/IcUe1ah4ZDpKBGWcsPX6MT0lYniH9micvIU7HQkYTfrx5Xi8u+YqwLtxC/3vl8TQN6rMg==",
+      "cpu": [
+        "x64"
+      ],
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-darwin-x64": "1.2.3"
+      }
+    },
+    "node_modules/@img/sharp-libvips-darwin-arm64": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.2.3.tgz",
+      "integrity": "sha512-QzWAKo7kpHxbuHqUC28DZ9pIKpSi2ts2OJnoIGI26+HMgq92ZZ4vk8iJd4XsxN+tYfNJxzH6W62X5eTcsBymHw==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-darwin-x64": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.2.3.tgz",
+      "integrity": "sha512-Ju+g2xn1E2AKO6YBhxjj+ACcsPQRHT0bhpglxcEf+3uyPY+/gL8veniKoo96335ZaPo03bdDXMv0t+BBFAbmRA==",
+      "cpu": [
+        "x64"
+      ],
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-arm": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.2.3.tgz",
+      "integrity": "sha512-x1uE93lyP6wEwGvgAIV0gP6zmaL/a0tGzJs/BIDDG0zeBhMnuUPm7ptxGhUbcGs4okDJrk4nxgrmxpib9g6HpA==",
+      "cpu": [
+        "arm"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-arm64": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.2.3.tgz",
+      "integrity": "sha512-I4RxkXU90cpufazhGPyVujYwfIm9Nk1QDEmiIsaPwdnm013F7RIceaCc87kAH+oUB1ezqEvC6ga4m7MSlqsJvQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-ppc64": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.2.3.tgz",
+      "integrity": "sha512-Y2T7IsQvJLMCBM+pmPbM3bKT/yYJvVtLJGfCs4Sp95SjvnFIjynbjzsa7dY1fRJX45FTSfDksbTp6AGWudiyCg==",
+      "cpu": [
+        "ppc64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-s390x": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.2.3.tgz",
+      "integrity": "sha512-RgWrs/gVU7f+K7P+KeHFaBAJlNkD1nIZuVXdQv6S+fNA6syCcoboNjsV2Pou7zNlVdNQoQUpQTk8SWDHUA3y/w==",
+      "cpu": [
+        "s390x"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-x64": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.2.3.tgz",
+      "integrity": "sha512-3JU7LmR85K6bBiRzSUc/Ff9JBVIFVvq6bomKE0e63UXGeRw2HPVEjoJke1Yx+iU4rL7/7kUjES4dZ/81Qjhyxg==",
+      "cpu": [
+        "x64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linuxmusl-arm64": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.2.3.tgz",
+      "integrity": "sha512-F9q83RZ8yaCwENw1GieztSfj5msz7GGykG/BA+MOUefvER69K/ubgFHNeSyUu64amHIYKGDs4sRCMzXVj8sEyw==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linuxmusl-x64": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.2.3.tgz",
+      "integrity": "sha512-U5PUY5jbc45ANM6tSJpsgqmBF/VsL6LnxJmIf11kB7J5DctHgqm0SkuXzVWtIY90GnJxKnC/JT251TDnk1fu/g==",
+      "cpu": [
+        "x64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-linux-arm": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.34.4.tgz",
+      "integrity": "sha512-Xyam4mlqM0KkTHYVSuc6wXRmM7LGN0P12li03jAnZ3EJWZqj83+hi8Y9UxZUbxsgsK1qOEwg7O0Bc0LjqQVtxA==",
+      "cpu": [
+        "arm"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-arm": "1.2.3"
+      }
+    },
+    "node_modules/@img/sharp-linux-arm64": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.34.4.tgz",
+      "integrity": "sha512-YXU1F/mN/Wu786tl72CyJjP/Ngl8mGHN1hST4BGl+hiW5jhCnV2uRVTNOcaYPs73NeT/H8Upm3y9582JVuZHrQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-arm64": "1.2.3"
+      }
+    },
+    "node_modules/@img/sharp-linux-ppc64": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.34.4.tgz",
+      "integrity": "sha512-F4PDtF4Cy8L8hXA2p3TO6s4aDt93v+LKmpcYFLAVdkkD3hSxZzee0rh6/+94FpAynsuMpLX5h+LRsSG3rIciUQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-ppc64": "1.2.3"
+      }
+    },
+    "node_modules/@img/sharp-linux-s390x": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.34.4.tgz",
+      "integrity": "sha512-qVrZKE9Bsnzy+myf7lFKvng6bQzhNUAYcVORq2P7bDlvmF6u2sCmK2KyEQEBdYk+u3T01pVsPrkj943T1aJAsw==",
+      "cpu": [
+        "s390x"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-s390x": "1.2.3"
+      }
+    },
+    "node_modules/@img/sharp-linux-x64": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.34.4.tgz",
+      "integrity": "sha512-ZfGtcp2xS51iG79c6Vhw9CWqQC8l2Ot8dygxoDoIQPTat/Ov3qAa8qpxSrtAEAJW+UjTXc4yxCjNfxm4h6Xm2A==",
+      "cpu": [
+        "x64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-x64": "1.2.3"
+      }
+    },
+    "node_modules/@img/sharp-linuxmusl-arm64": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.34.4.tgz",
+      "integrity": "sha512-8hDVvW9eu4yHWnjaOOR8kHVrew1iIX+MUgwxSuH2XyYeNRtLUe4VNioSqbNkB7ZYQJj9rUTT4PyRscyk2PXFKA==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linuxmusl-arm64": "1.2.3"
+      }
+    },
+    "node_modules/@img/sharp-linuxmusl-x64": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.34.4.tgz",
+      "integrity": "sha512-lU0aA5L8QTlfKjpDCEFOZsTYGn3AEiO6db8W5aQDxj0nQkVrZWmN3ZP9sYKWJdtq3PWPhUNlqehWyXpYDcI9Sg==",
+      "cpu": [
+        "x64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linuxmusl-x64": "1.2.3"
+      }
+    },
+    "node_modules/@img/sharp-wasm32": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.34.4.tgz",
+      "integrity": "sha512-33QL6ZO/qpRyG7woB/HUALz28WnTMI2W1jgX3Nu2bypqLIKx/QKMILLJzJjI+SIbvXdG9fUnmrxR7vbi1sTBeA==",
+      "cpu": [
+        "wasm32"
+      ],
+      "optional": true,
+      "dependencies": {
+        "@emnapi/runtime": "^1.5.0"
+      },
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-win32-arm64": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.34.4.tgz",
+      "integrity": "sha512-2Q250do/5WXTwxW3zjsEuMSv5sUU4Tq9VThWKlU2EYLm4MB7ZeMwF+SFJutldYODXF6jzc6YEOC+VfX0SZQPqA==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-win32-ia32": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.34.4.tgz",
+      "integrity": "sha512-3ZeLue5V82dT92CNL6rsal6I2weKw1cYu+rGKm8fOCCtJTR2gYeUfY3FqUnIJsMUPIH68oS5jmZ0NiJ508YpEw==",
+      "cpu": [
+        "ia32"
+      ],
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-win32-x64": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.34.4.tgz",
+      "integrity": "sha512-xIyj4wpYs8J18sVN3mSQjwrw7fKUqRw+Z5rnHNCy5fYTxigBz81u5mOMPmFumwjcn8+ld1ppptMBCLic1nz6ig==",
+      "cpu": [
+        "x64"
+      ],
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@napi-rs/wasm-runtime": {
+      "version": "0.2.12",
+      "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-0.2.12.tgz",
+      "integrity": "sha512-ZVWUcfwY4E/yPitQJl481FjFo3K22D6qF0DuFH6Y/nbnE11GY5uguDxZMGXPQ8WQ0128MXQD7TnfHyK4oWoIJQ==",
+      "dev": true,
+      "optional": true,
+      "dependencies": {
+        "@emnapi/core": "^1.4.3",
+        "@emnapi/runtime": "^1.4.3",
+        "@tybys/wasm-util": "^0.10.0"
+      }
+    },
+    "node_modules/@next/env": {
+      "version": "15.5.5",
+      "resolved": "https://registry.npmjs.org/@next/env/-/env-15.5.5.tgz",
+      "integrity": "sha512-2Zhvss36s/yL+YSxD5ZL5dz5pI6ki1OLxYlh6O77VJ68sBnlUrl5YqhBgCy7FkdMsp9RBeGFwpuDCdpJOqdKeQ=="
+    },
+    "node_modules/@next/eslint-plugin-next": {
+      "version": "15.5.5",
+      "resolved": "https://registry.npmjs.org/@next/eslint-plugin-next/-/eslint-plugin-next-15.5.5.tgz",
+      "integrity": "sha512-FMzm412l9oFB8zdRD+K6HQ1VzlS+sNNsdg0MfvTg0i8lfCyTgP/RFxiu/pGJqZ/IQnzn9xSiLkjOVI7Iv4nbdQ==",
+      "dev": true,
+      "dependencies": {
+        "fast-glob": "3.3.1"
+      }
+    },
+    "node_modules/@next/swc-darwin-arm64": {
+      "version": "15.5.5",
+      "resolved": "https://registry.npmjs.org/@next/swc-darwin-arm64/-/swc-darwin-arm64-15.5.5.tgz",
+      "integrity": "sha512-lYExGHuFIHeOxf40mRLWoA84iY2sLELB23BV5FIDHhdJkN1LpRTPc1MDOawgTo5ifbM5dvAwnGuHyNm60G1+jw==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@next/swc-darwin-x64": {
+      "version": "15.5.5",
+      "resolved": "https://registry.npmjs.org/@next/swc-darwin-x64/-/swc-darwin-x64-15.5.5.tgz",
+      "integrity": "sha512-cacs/WQqa96IhqUm+7CY+z/0j9sW6X80KE07v3IAJuv+z0UNvJtKSlT/T1w1SpaQRa9l0wCYYZlRZUhUOvEVmg==",
+      "cpu": [
+        "x64"
+      ],
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@next/swc-linux-arm64-gnu": {
+      "version": "15.5.5",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-gnu/-/swc-linux-arm64-gnu-15.5.5.tgz",
+      "integrity": "sha512-tLd90SvkRFik6LSfuYjcJEmwqcNEnVYVOyKTacSazya/SLlSwy/VYKsDE4GIzOBd+h3gW+FXqShc2XBavccHCg==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@next/swc-linux-arm64-musl": {
+      "version": "15.5.5",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-musl/-/swc-linux-arm64-musl-15.5.5.tgz",
+      "integrity": "sha512-ekV76G2R/l3nkvylkfy9jBSYHeB4QcJ7LdDseT6INnn1p51bmDS1eGoSoq+RxfQ7B1wt+Qa0pIl5aqcx0GLpbw==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@next/swc-linux-x64-gnu": {
+      "version": "15.5.5",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-gnu/-/swc-linux-x64-gnu-15.5.5.tgz",
+      "integrity": "sha512-tI+sBu+3FmWtqlqD4xKJcj3KJtqbniLombKTE7/UWyyoHmOyAo3aZ7QcEHIOgInXOG1nt0rwh0KGmNbvSB0Djg==",
+      "cpu": [
+        "x64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@next/swc-linux-x64-musl": {
+      "version": "15.5.5",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-musl/-/swc-linux-x64-musl-15.5.5.tgz",
+      "integrity": "sha512-kDRh+epN/ulroNJLr+toDjN+/JClY5L+OAWjOrrKCI0qcKvTw9GBx7CU/rdA2bgi4WpZN3l0rf/3+b8rduEwrQ==",
+      "cpu": [
+        "x64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@next/swc-win32-arm64-msvc": {
+      "version": "15.5.5",
+      "resolved": "https://registry.npmjs.org/@next/swc-win32-arm64-msvc/-/swc-win32-arm64-msvc-15.5.5.tgz",
+      "integrity": "sha512-GDgdNPFFqiKjTrmfw01sMMRWhVN5wOCmFzPloxa7ksDfX6TZt62tAK986f0ZYqWpvDFqeBCLAzmgTURvtQBdgw==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@next/swc-win32-x64-msvc": {
+      "version": "15.5.5",
+      "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-15.5.5.tgz",
+      "integrity": "sha512-5kE3oRJxc7M8RmcTANP8RGoJkaYlwIiDD92gSwCjJY0+j8w8Sl1lvxgQ3bxfHY2KkHFai9tpy/Qx1saWV8eaJQ==",
+      "cpu": [
+        "x64"
+      ],
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@nodelib/fs.scandir": {
+      "version": "2.1.5",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
+      "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==",
+      "dev": true,
+      "dependencies": {
+        "@nodelib/fs.stat": "2.0.5",
+        "run-parallel": "^1.1.9"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nodelib/fs.stat": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz",
+      "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==",
+      "dev": true,
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nodelib/fs.walk": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz",
+      "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==",
+      "dev": true,
+      "dependencies": {
+        "@nodelib/fs.scandir": "2.1.5",
+        "fastq": "^1.6.0"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nolyfill/is-core-module": {
+      "version": "1.0.39",
+      "resolved": "https://registry.npmjs.org/@nolyfill/is-core-module/-/is-core-module-1.0.39.tgz",
+      "integrity": "sha512-nn5ozdjYQpUCZlWGuxcJY/KpxkWQs4DcbMCmKojjyrYDEAGy4Ce19NN4v5MduafTwJlbKc99UA8YhSVqq9yPZA==",
+      "dev": true,
+      "engines": {
+        "node": ">=12.4.0"
+      }
+    },
+    "node_modules/@rtsao/scc": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@rtsao/scc/-/scc-1.1.0.tgz",
+      "integrity": "sha512-zt6OdqaDoOnJ1ZYsCYGt9YmWzDXl4vQdKTyJev62gFhRGKdx7mcT54V9KIjg+d2wi9EXsPvAPKe7i7WjfVWB8g==",
+      "dev": true
+    },
+    "node_modules/@rushstack/eslint-patch": {
+      "version": "1.14.0",
+      "resolved": "https://registry.npmjs.org/@rushstack/eslint-patch/-/eslint-patch-1.14.0.tgz",
+      "integrity": "sha512-WJFej426qe4RWOm9MMtP4V3CV4AucXolQty+GRgAWLgQXmpCuwzs7hEpxxhSc/znXUSxum9d/P/32MW0FlAAlA==",
+      "dev": true
+    },
+    "node_modules/@swc/helpers": {
+      "version": "0.5.15",
+      "resolved": "https://registry.npmjs.org/@swc/helpers/-/helpers-0.5.15.tgz",
+      "integrity": "sha512-JQ5TuMi45Owi4/BIMAJBoSQoOJu12oOk/gADqlcUL9JEdHB8vyjUSsxqeNXnmXHjYKMi2WcYtezGEEhqUI/E2g==",
+      "dependencies": {
+        "tslib": "^2.8.0"
+      }
+    },
+    "node_modules/@tybys/wasm-util": {
+      "version": "0.10.1",
+      "resolved": "https://registry.npmjs.org/@tybys/wasm-util/-/wasm-util-0.10.1.tgz",
+      "integrity": "sha512-9tTaPJLSiejZKx+Bmog4uSubteqTvFrVrURwkmHixBo0G4seD0zUxp98E1DzUBJxLQ3NPwXrGKDiVjwx/DpPsg==",
+      "dev": true,
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@types/estree": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
+      "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
+      "dev": true
+    },
+    "node_modules/@types/json-schema": {
+      "version": "7.0.15",
+      "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz",
+      "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==",
+      "dev": true
+    },
+    "node_modules/@types/json5": {
+      "version": "0.0.29",
+      "resolved": "https://registry.npmjs.org/@types/json5/-/json5-0.0.29.tgz",
+      "integrity": "sha512-dRLjCWHYg4oaA77cxO64oO+7JwCwnIzkZPdrrC71jQmQtlhM556pwKo5bUzqvZndkVbeFLIIi+9TC40JNF5hNQ==",
+      "dev": true
+    },
+    "node_modules/@types/node": {
+      "version": "20.19.23",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.23.tgz",
+      "integrity": "sha512-yIdlVVVHXpmqRhtyovZAcSy0MiPcYWGkoO4CGe/+jpP0hmNuihm4XhHbADpK++MsiLHP5MVlv+bcgdF99kSiFQ==",
+      "dev": true,
+      "dependencies": {
+        "undici-types": "~6.21.0"
+      }
+    },
+    "node_modules/@types/react": {
+      "version": "19.2.2",
+      "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.2.tgz",
+      "integrity": "sha512-6mDvHUFSjyT2B2yeNx2nUgMxh9LtOWvkhIU3uePn2I2oyNymUAX1NIsdgviM4CH+JSrp2D2hsMvJOkxY+0wNRA==",
+      "dev": true,
+      "dependencies": {
+        "csstype": "^3.0.2"
+      }
+    },
+    "node_modules/@types/react-dom": {
+      "version": "19.2.2",
+      "resolved": "https://registry.npmjs.org/@types/react-dom/-/react-dom-19.2.2.tgz",
+      "integrity": "sha512-9KQPoO6mZCi7jcIStSnlOWn2nEF3mNmyr3rIAsGnAbQKYbRLyqmeSc39EVgtxXVia+LMT8j3knZLAZAh+xLmrw==",
+      "dev": true,
+      "peerDependencies": {
+        "@types/react": "^19.2.0"
+      }
+    },
+    "node_modules/@typescript-eslint/eslint-plugin": {
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.46.2.tgz",
+      "integrity": "sha512-ZGBMToy857/NIPaaCucIUQgqueOiq7HeAKkhlvqVV4lm089zUFW6ikRySx2v+cAhKeUCPuWVHeimyk6Dw1iY3w==",
+      "dev": true,
+      "dependencies": {
+        "@eslint-community/regexpp": "^4.10.0",
+        "@typescript-eslint/scope-manager": "8.46.2",
+        "@typescript-eslint/type-utils": "8.46.2",
+        "@typescript-eslint/utils": "8.46.2",
+        "@typescript-eslint/visitor-keys": "8.46.2",
+        "graphemer": "^1.4.0",
+        "ignore": "^7.0.0",
+        "natural-compare": "^1.4.0",
+        "ts-api-utils": "^2.1.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "@typescript-eslint/parser": "^8.46.2",
+        "eslint": "^8.57.0 || ^9.0.0",
+        "typescript": ">=4.8.4 <6.0.0"
+      }
+    },
+    "node_modules/@typescript-eslint/eslint-plugin/node_modules/ignore": {
+      "version": "7.0.5",
+      "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.5.tgz",
+      "integrity": "sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==",
+      "dev": true,
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/@typescript-eslint/parser": {
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.46.2.tgz",
+      "integrity": "sha512-BnOroVl1SgrPLywqxyqdJ4l3S2MsKVLDVxZvjI1Eoe8ev2r3kGDo+PcMihNmDE+6/KjkTubSJnmqGZZjQSBq/g==",
+      "dev": true,
+      "dependencies": {
+        "@typescript-eslint/scope-manager": "8.46.2",
+        "@typescript-eslint/types": "8.46.2",
+        "@typescript-eslint/typescript-estree": "8.46.2",
+        "@typescript-eslint/visitor-keys": "8.46.2",
+        "debug": "^4.3.4"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^8.57.0 || ^9.0.0",
+        "typescript": ">=4.8.4 <6.0.0"
+      }
+    },
+    "node_modules/@typescript-eslint/project-service": {
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.46.2.tgz",
+      "integrity": "sha512-PULOLZ9iqwI7hXcmL4fVfIsBi6AN9YxRc0frbvmg8f+4hQAjQ5GYNKK0DIArNo+rOKmR/iBYwkpBmnIwin4wBg==",
+      "dev": true,
+      "dependencies": {
+        "@typescript-eslint/tsconfig-utils": "^8.46.2",
+        "@typescript-eslint/types": "^8.46.2",
+        "debug": "^4.3.4"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.8.4 <6.0.0"
+      }
+    },
+    "node_modules/@typescript-eslint/scope-manager": {
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.46.2.tgz",
+      "integrity": "sha512-LF4b/NmGvdWEHD2H4MsHD8ny6JpiVNDzrSZr3CsckEgCbAGZbYM4Cqxvi9L+WqDMT+51Ozy7lt2M+d0JLEuBqA==",
+      "dev": true,
+      "dependencies": {
+        "@typescript-eslint/types": "8.46.2",
+        "@typescript-eslint/visitor-keys": "8.46.2"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      }
+    },
+    "node_modules/@typescript-eslint/tsconfig-utils": {
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.46.2.tgz",
+      "integrity": "sha512-a7QH6fw4S57+F5y2FIxxSDyi5M4UfGF+Jl1bCGd7+L4KsaUY80GsiF/t0UoRFDHAguKlBaACWJRmdrc6Xfkkag==",
+      "dev": true,
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.8.4 <6.0.0"
+      }
+    },
+    "node_modules/@typescript-eslint/type-utils": {
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.46.2.tgz",
+      "integrity": "sha512-HbPM4LbaAAt/DjxXaG9yiS9brOOz6fabal4uvUmaUYe6l3K1phQDMQKBRUrr06BQkxkvIZVVHttqiybM9nJsLA==",
+      "dev": true,
+      "dependencies": {
+        "@typescript-eslint/types": "8.46.2",
+        "@typescript-eslint/typescript-estree": "8.46.2",
+        "@typescript-eslint/utils": "8.46.2",
+        "debug": "^4.3.4",
+        "ts-api-utils": "^2.1.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^8.57.0 || ^9.0.0",
+        "typescript": ">=4.8.4 <6.0.0"
+      }
+    },
+    "node_modules/@typescript-eslint/types": {
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.46.2.tgz",
+      "integrity": "sha512-lNCWCbq7rpg7qDsQrd3D6NyWYu+gkTENkG5IKYhUIcxSb59SQC/hEQ+MrG4sTgBVghTonNWq42bA/d4yYumldQ==",
+      "dev": true,
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      }
+    },
+    "node_modules/@typescript-eslint/typescript-estree": {
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.46.2.tgz",
+      "integrity": "sha512-f7rW7LJ2b7Uh2EiQ+7sza6RDZnajbNbemn54Ob6fRwQbgcIn+GWfyuHDHRYgRoZu1P4AayVScrRW+YfbTvPQoQ==",
+      "dev": true,
+      "dependencies": {
+        "@typescript-eslint/project-service": "8.46.2",
+        "@typescript-eslint/tsconfig-utils": "8.46.2",
+        "@typescript-eslint/types": "8.46.2",
+        "@typescript-eslint/visitor-keys": "8.46.2",
+        "debug": "^4.3.4",
+        "fast-glob": "^3.3.2",
+        "is-glob": "^4.0.3",
+        "minimatch": "^9.0.4",
+        "semver": "^7.6.0",
+        "ts-api-utils": "^2.1.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.8.4 <6.0.0"
+      }
+    },
+    "node_modules/@typescript-eslint/typescript-estree/node_modules/brace-expansion": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz",
+      "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==",
+      "dev": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0"
+      }
+    },
+    "node_modules/@typescript-eslint/typescript-estree/node_modules/fast-glob": {
+      "version": "3.3.3",
+      "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz",
+      "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==",
+      "dev": true,
+      "dependencies": {
+        "@nodelib/fs.stat": "^2.0.2",
+        "@nodelib/fs.walk": "^1.2.3",
+        "glob-parent": "^5.1.2",
+        "merge2": "^1.3.0",
+        "micromatch": "^4.0.8"
+      },
+      "engines": {
+        "node": ">=8.6.0"
+      }
+    },
+    "node_modules/@typescript-eslint/typescript-estree/node_modules/glob-parent": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
+      "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
+      "dev": true,
+      "dependencies": {
+        "is-glob": "^4.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/@typescript-eslint/typescript-estree/node_modules/minimatch": {
+      "version": "9.0.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz",
+      "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==",
+      "dev": true,
+      "dependencies": {
+        "brace-expansion": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/@typescript-eslint/utils": {
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.46.2.tgz",
+      "integrity": "sha512-sExxzucx0Tud5tE0XqR0lT0psBQvEpnpiul9XbGUB1QwpWJJAps1O/Z7hJxLGiZLBKMCutjTzDgmd1muEhBnVg==",
+      "dev": true,
+      "dependencies": {
+        "@eslint-community/eslint-utils": "^4.7.0",
+        "@typescript-eslint/scope-manager": "8.46.2",
+        "@typescript-eslint/types": "8.46.2",
+        "@typescript-eslint/typescript-estree": "8.46.2"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^8.57.0 || ^9.0.0",
+        "typescript": ">=4.8.4 <6.0.0"
+      }
+    },
+    "node_modules/@typescript-eslint/visitor-keys": {
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.46.2.tgz",
+      "integrity": "sha512-tUFMXI4gxzzMXt4xpGJEsBsTox0XbNQ1y94EwlD/CuZwFcQP79xfQqMhau9HsRc/J0cAPA/HZt1dZPtGn9V/7w==",
+      "dev": true,
+      "dependencies": {
+        "@typescript-eslint/types": "8.46.2",
+        "eslint-visitor-keys": "^4.2.1"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      }
+    },
+    "node_modules/@unrs/resolver-binding-android-arm-eabi": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-android-arm-eabi/-/resolver-binding-android-arm-eabi-1.11.1.tgz",
+      "integrity": "sha512-ppLRUgHVaGRWUx0R0Ut06Mjo9gBaBkg3v/8AxusGLhsIotbBLuRk51rAzqLC8gq6NyyAojEXglNjzf6R948DNw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-android-arm64": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-android-arm64/-/resolver-binding-android-arm64-1.11.1.tgz",
+      "integrity": "sha512-lCxkVtb4wp1v+EoN+HjIG9cIIzPkX5OtM03pQYkG+U5O/wL53LC4QbIeazgiKqluGeVEeBlZahHalCaBvU1a2g==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-darwin-arm64": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-darwin-arm64/-/resolver-binding-darwin-arm64-1.11.1.tgz",
+      "integrity": "sha512-gPVA1UjRu1Y/IsB/dQEsp2V1pm44Of6+LWvbLc9SDk1c2KhhDRDBUkQCYVWe6f26uJb3fOK8saWMgtX8IrMk3g==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-darwin-x64": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-darwin-x64/-/resolver-binding-darwin-x64-1.11.1.tgz",
+      "integrity": "sha512-cFzP7rWKd3lZaCsDze07QX1SC24lO8mPty9vdP+YVa3MGdVgPmFc59317b2ioXtgCMKGiCLxJ4HQs62oz6GfRQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-freebsd-x64": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-freebsd-x64/-/resolver-binding-freebsd-x64-1.11.1.tgz",
+      "integrity": "sha512-fqtGgak3zX4DCB6PFpsH5+Kmt/8CIi4Bry4rb1ho6Av2QHTREM+47y282Uqiu3ZRF5IQioJQ5qWRV6jduA+iGw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-linux-arm-gnueabihf": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-arm-gnueabihf/-/resolver-binding-linux-arm-gnueabihf-1.11.1.tgz",
+      "integrity": "sha512-u92mvlcYtp9MRKmP+ZvMmtPN34+/3lMHlyMj7wXJDeXxuM0Vgzz0+PPJNsro1m3IZPYChIkn944wW8TYgGKFHw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-linux-arm-musleabihf": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-arm-musleabihf/-/resolver-binding-linux-arm-musleabihf-1.11.1.tgz",
+      "integrity": "sha512-cINaoY2z7LVCrfHkIcmvj7osTOtm6VVT16b5oQdS4beibX2SYBwgYLmqhBjA1t51CarSaBuX5YNsWLjsqfW5Cw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-linux-arm64-gnu": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-arm64-gnu/-/resolver-binding-linux-arm64-gnu-1.11.1.tgz",
+      "integrity": "sha512-34gw7PjDGB9JgePJEmhEqBhWvCiiWCuXsL9hYphDF7crW7UgI05gyBAi6MF58uGcMOiOqSJ2ybEeCvHcq0BCmQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-linux-arm64-musl": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-arm64-musl/-/resolver-binding-linux-arm64-musl-1.11.1.tgz",
+      "integrity": "sha512-RyMIx6Uf53hhOtJDIamSbTskA99sPHS96wxVE/bJtePJJtpdKGXO1wY90oRdXuYOGOTuqjT8ACccMc4K6QmT3w==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-linux-ppc64-gnu": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-ppc64-gnu/-/resolver-binding-linux-ppc64-gnu-1.11.1.tgz",
+      "integrity": "sha512-D8Vae74A4/a+mZH0FbOkFJL9DSK2R6TFPC9M+jCWYia/q2einCubX10pecpDiTmkJVUH+y8K3BZClycD8nCShA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-linux-riscv64-gnu": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-riscv64-gnu/-/resolver-binding-linux-riscv64-gnu-1.11.1.tgz",
+      "integrity": "sha512-frxL4OrzOWVVsOc96+V3aqTIQl1O2TjgExV4EKgRY09AJ9leZpEg8Ak9phadbuX0BA4k8U5qtvMSQQGGmaJqcQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-linux-riscv64-musl": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-riscv64-musl/-/resolver-binding-linux-riscv64-musl-1.11.1.tgz",
+      "integrity": "sha512-mJ5vuDaIZ+l/acv01sHoXfpnyrNKOk/3aDoEdLO/Xtn9HuZlDD6jKxHlkN8ZhWyLJsRBxfv9GYM2utQ1SChKew==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-linux-s390x-gnu": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-s390x-gnu/-/resolver-binding-linux-s390x-gnu-1.11.1.tgz",
+      "integrity": "sha512-kELo8ebBVtb9sA7rMe1Cph4QHreByhaZ2QEADd9NzIQsYNQpt9UkM9iqr2lhGr5afh885d/cB5QeTXSbZHTYPg==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-linux-x64-gnu": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-x64-gnu/-/resolver-binding-linux-x64-gnu-1.11.1.tgz",
+      "integrity": "sha512-C3ZAHugKgovV5YvAMsxhq0gtXuwESUKc5MhEtjBpLoHPLYM+iuwSj3lflFwK3DPm68660rZ7G8BMcwSro7hD5w==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-linux-x64-musl": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-x64-musl/-/resolver-binding-linux-x64-musl-1.11.1.tgz",
+      "integrity": "sha512-rV0YSoyhK2nZ4vEswT/QwqzqQXw5I6CjoaYMOX0TqBlWhojUf8P94mvI7nuJTeaCkkds3QE4+zS8Ko+GdXuZtA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-wasm32-wasi": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-wasm32-wasi/-/resolver-binding-wasm32-wasi-1.11.1.tgz",
+      "integrity": "sha512-5u4RkfxJm+Ng7IWgkzi3qrFOvLvQYnPBmjmZQ8+szTK/b31fQCnleNl1GgEt7nIsZRIf5PLhPwT0WM+q45x/UQ==",
+      "cpu": [
+        "wasm32"
+      ],
+      "dev": true,
+      "optional": true,
+      "dependencies": {
+        "@napi-rs/wasm-runtime": "^0.2.11"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/@unrs/resolver-binding-win32-arm64-msvc": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-win32-arm64-msvc/-/resolver-binding-win32-arm64-msvc-1.11.1.tgz",
+      "integrity": "sha512-nRcz5Il4ln0kMhfL8S3hLkxI85BXs3o8EYoattsJNdsX4YUU89iOkVn7g0VHSRxFuVMdM4Q1jEpIId1Ihim/Uw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-win32-ia32-msvc": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-win32-ia32-msvc/-/resolver-binding-win32-ia32-msvc-1.11.1.tgz",
+      "integrity": "sha512-DCEI6t5i1NmAZp6pFonpD5m7i6aFrpofcp4LA2i8IIq60Jyo28hamKBxNrZcyOwVOZkgsRp9O2sXWBWP8MnvIQ==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@unrs/resolver-binding-win32-x64-msvc": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-win32-x64-msvc/-/resolver-binding-win32-x64-msvc-1.11.1.tgz",
+      "integrity": "sha512-lrW200hZdbfRtztbygyaq/6jP6AKE8qQN2KvPcJ+x7wiD038YtnYtZ82IMNJ69GJibV7bwL3y9FgK+5w/pYt6g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/acorn": {
+      "version": "8.15.0",
+      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz",
+      "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
+      "dev": true,
+      "bin": {
+        "acorn": "bin/acorn"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/acorn-jsx": {
+      "version": "5.3.2",
+      "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz",
+      "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==",
+      "dev": true,
+      "peerDependencies": {
+        "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0"
+      }
+    },
+    "node_modules/ajv": {
+      "version": "6.12.6",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz",
+      "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==",
+      "dev": true,
+      "dependencies": {
+        "fast-deep-equal": "^3.1.1",
+        "fast-json-stable-stringify": "^2.0.0",
+        "json-schema-traverse": "^0.4.1",
+        "uri-js": "^4.2.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "dev": true,
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/argparse": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
+      "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
+      "dev": true
+    },
+    "node_modules/aria-query": {
+      "version": "5.3.2",
+      "resolved": "https://registry.npmjs.org/aria-query/-/aria-query-5.3.2.tgz",
+      "integrity": "sha512-COROpnaoap1E2F000S62r6A60uHZnmlvomhfyT2DlTcrY1OrBKn2UhH7qn5wTC9zMvD0AY7csdPSNwKP+7WiQw==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/array-buffer-byte-length": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/array-buffer-byte-length/-/array-buffer-byte-length-1.0.2.tgz",
+      "integrity": "sha512-LHE+8BuR7RYGDKvnrmcuSq3tDcKv9OFEXQt/HpbZhY7V6h0zlUXutnAD82GiFx9rdieCMjkvtcsPqBwgUl1Iiw==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "is-array-buffer": "^3.0.5"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/array-includes": {
+      "version": "3.1.9",
+      "resolved": "https://registry.npmjs.org/array-includes/-/array-includes-3.1.9.tgz",
+      "integrity": "sha512-FmeCCAenzH0KH381SPT5FZmiA/TmpndpcaShhfgEN9eCVjnFBqq3l1xrI42y8+PPLI6hypzou4GXw00WHmPBLQ==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.4",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.24.0",
+        "es-object-atoms": "^1.1.1",
+        "get-intrinsic": "^1.3.0",
+        "is-string": "^1.1.1",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/array.prototype.findlast": {
+      "version": "1.2.5",
+      "resolved": "https://registry.npmjs.org/array.prototype.findlast/-/array.prototype.findlast-1.2.5.tgz",
+      "integrity": "sha512-CVvd6FHg1Z3POpBLxO6E6zr+rSKEQ9L6rZHAaY7lLfhKsWYUBBOuMs0e9o24oopj6H+geRCX0YJ+TJLBK2eHyQ==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.7",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.2",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.0.0",
+        "es-shim-unscopables": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/array.prototype.findlastindex": {
+      "version": "1.2.6",
+      "resolved": "https://registry.npmjs.org/array.prototype.findlastindex/-/array.prototype.findlastindex-1.2.6.tgz",
+      "integrity": "sha512-F/TKATkzseUExPlfvmwQKGITM3DGTK+vkAsCZoDc5daVygbJBnjEUCbgkAvVFsgfXfX4YIqZ/27G3k3tdXrTxQ==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.4",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.9",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "es-shim-unscopables": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/array.prototype.flat": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/array.prototype.flat/-/array.prototype.flat-1.3.3.tgz",
+      "integrity": "sha512-rwG/ja1neyLqCuGZ5YYrznA62D4mZXg0i1cIskIUKSiqF3Cje9/wXAls9B9s1Wa2fomMsIv8czB8jZcPmxCXFg==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.5",
+        "es-shim-unscopables": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/array.prototype.flatmap": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/array.prototype.flatmap/-/array.prototype.flatmap-1.3.3.tgz",
+      "integrity": "sha512-Y7Wt51eKJSyi80hFrJCePGGNo5ktJCslFuboqJsbf57CCPcm5zztluPlc4/aD8sWsKvlwatezpV4U1efk8kpjg==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.5",
+        "es-shim-unscopables": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/array.prototype.tosorted": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/array.prototype.tosorted/-/array.prototype.tosorted-1.1.4.tgz",
+      "integrity": "sha512-p6Fx8B7b7ZhL/gmUsAy0D15WhvDccw3mnGNbZpi3pmeJdxtWsj2jEaI4Y6oo3XiHfzuSgPwKc04MYt6KgvC/wA==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.7",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.3",
+        "es-errors": "^1.3.0",
+        "es-shim-unscopables": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/arraybuffer.prototype.slice": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/arraybuffer.prototype.slice/-/arraybuffer.prototype.slice-1.0.4.tgz",
+      "integrity": "sha512-BNoCY6SXXPQ7gF2opIP4GBE+Xw7U+pHMYKuzjgCN3GwiaIR09UUeKfheyIry77QtrCBlC0KK0q5/TER/tYh3PQ==",
+      "dev": true,
+      "dependencies": {
+        "array-buffer-byte-length": "^1.0.1",
+        "call-bind": "^1.0.8",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.5",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6",
+        "is-array-buffer": "^3.0.4"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/ast-types-flow": {
+      "version": "0.0.8",
+      "resolved": "https://registry.npmjs.org/ast-types-flow/-/ast-types-flow-0.0.8.tgz",
+      "integrity": "sha512-OH/2E5Fg20h2aPrbe+QL8JZQFko0YZaF+j4mnQ7BGhfavO7OpSLa8a0y9sBwomHdSbkhTS8TQNayBfnW5DwbvQ==",
+      "dev": true
+    },
+    "node_modules/async-function": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/async-function/-/async-function-1.0.0.tgz",
+      "integrity": "sha512-hsU18Ae8CDTR6Kgu9DYf0EbCr/a5iGL0rytQDobUcdpYOKokk8LEjVphnXkDkgpi0wYVsqrXuP0bZxJaTqdgoA==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/available-typed-arrays": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/available-typed-arrays/-/available-typed-arrays-1.0.7.tgz",
+      "integrity": "sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ==",
+      "dev": true,
+      "dependencies": {
+        "possible-typed-array-names": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/axe-core": {
+      "version": "4.11.0",
+      "resolved": "https://registry.npmjs.org/axe-core/-/axe-core-4.11.0.tgz",
+      "integrity": "sha512-ilYanEU8vxxBexpJd8cWM4ElSQq4QctCLKih0TSfjIfCQTeyH/6zVrmIJfLPrKTKJRbiG+cfnZbQIjAlJmF1jQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/axobject-query": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/axobject-query/-/axobject-query-4.1.0.tgz",
+      "integrity": "sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true
+    },
+    "node_modules/brace-expansion": {
+      "version": "1.1.12",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
+      "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
+      "dev": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/braces": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
+      "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
+      "dev": true,
+      "dependencies": {
+        "fill-range": "^7.1.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/call-bind": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.8.tgz",
+      "integrity": "sha512-oKlSFMcMwpUg2ednkhQ454wfWiU/ul3CkJe/PEHcTKuiX6RpbehUiFMXu13HalGZxfUwCQzZG747YXBn1im9ww==",
+      "dev": true,
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.0",
+        "es-define-property": "^1.0.0",
+        "get-intrinsic": "^1.2.4",
+        "set-function-length": "^1.2.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "dev": true,
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/call-bound": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+      "dev": true,
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "get-intrinsic": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/callsites": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz",
+      "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/caniuse-lite": {
+      "version": "1.0.30001751",
+      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001751.tgz",
+      "integrity": "sha512-A0QJhug0Ly64Ii3eIqHu5X51ebln3k4yTUkY1j8drqpWHVreg/VLijN48cZ1bYPiqOQuqpkIKnzr/Ul8V+p6Cw==",
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ]
+    },
+    "node_modules/chalk": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
+      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
+      "dev": true,
+      "dependencies": {
+        "ansi-styles": "^4.1.0",
+        "supports-color": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
+    "node_modules/client-only": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/client-only/-/client-only-0.0.1.tgz",
+      "integrity": "sha512-IV3Ou0jSMzZrd3pZ48nLkT9DA7Ag1pnPzaiQhpW7c3RbcqqzvzzVu+L8gfqMp/8IM2MQtSiqaCxrrcfu8I8rMA=="
+    },
+    "node_modules/color-convert": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "dev": true,
+      "dependencies": {
+        "color-name": "~1.1.4"
+      },
+      "engines": {
+        "node": ">=7.0.0"
+      }
+    },
+    "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+      "dev": true
+    },
+    "node_modules/concat-map": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
+      "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
+      "dev": true
+    },
+    "node_modules/cross-spawn": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+      "dev": true,
+      "dependencies": {
+        "path-key": "^3.1.0",
+        "shebang-command": "^2.0.0",
+        "which": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/csstype": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.1.3.tgz",
+      "integrity": "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw==",
+      "dev": true
+    },
+    "node_modules/damerau-levenshtein": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/damerau-levenshtein/-/damerau-levenshtein-1.0.8.tgz",
+      "integrity": "sha512-sdQSFB7+llfUcQHUQO3+B8ERRj0Oa4w9POWMI/puGtuf7gFywGmkaLCElnudfTiKZV+NvHqL0ifzdrI8Ro7ESA==",
+      "dev": true
+    },
+    "node_modules/data-view-buffer": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/data-view-buffer/-/data-view-buffer-1.0.2.tgz",
+      "integrity": "sha512-EmKO5V3OLXh1rtK2wgXRansaK1/mtVdTUEiEI0W8RkvgT05kfxaH29PliLnpLP73yYO6142Q72QNa8Wx/A5CqQ==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "es-errors": "^1.3.0",
+        "is-data-view": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/data-view-byte-length": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/data-view-byte-length/-/data-view-byte-length-1.0.2.tgz",
+      "integrity": "sha512-tuhGbE6CfTM9+5ANGf+oQb72Ky/0+s3xKUpHvShfiz2RxMFgFPjsXuRLBVMtvMs15awe45SRb83D6wH4ew6wlQ==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "es-errors": "^1.3.0",
+        "is-data-view": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/inspect-js"
+      }
+    },
+    "node_modules/data-view-byte-offset": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/data-view-byte-offset/-/data-view-byte-offset-1.0.1.tgz",
+      "integrity": "sha512-BS8PfmtDGnrgYdOonGZQdLZslWIeCGFP9tpan0hi1Co2Zr2NKADsvGYA8XxuG/4UWgJ6Cjtv+YJnB6MM69QGlQ==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "is-data-view": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "dev": true,
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/deep-is": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz",
+      "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==",
+      "dev": true
+    },
+    "node_modules/define-data-property": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz",
+      "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==",
+      "dev": true,
+      "dependencies": {
+        "es-define-property": "^1.0.0",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/define-properties": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.2.1.tgz",
+      "integrity": "sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==",
+      "dev": true,
+      "dependencies": {
+        "define-data-property": "^1.0.1",
+        "has-property-descriptors": "^1.0.0",
+        "object-keys": "^1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/detect-libc": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+      "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
+      "optional": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/doctrine": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-2.1.0.tgz",
+      "integrity": "sha512-35mSku4ZXK0vfCuHEDAwt55dg2jNajHZ1odvF+8SSr82EsZY4QmXfuWso8oEd8zRhVObSN18aM0CjSdoBX7zIw==",
+      "dev": true,
+      "dependencies": {
+        "esutils": "^2.0.2"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "dev": true,
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/emoji-regex": {
+      "version": "9.2.2",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
+      "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
+      "dev": true
+    },
+    "node_modules/es-abstract": {
+      "version": "1.24.0",
+      "resolved": "https://registry.npmjs.org/es-abstract/-/es-abstract-1.24.0.tgz",
+      "integrity": "sha512-WSzPgsdLtTcQwm4CROfS5ju2Wa1QQcVeT37jFjYzdFz1r9ahadC8B8/a4qxJxM+09F18iumCdRmlr96ZYkQvEg==",
+      "dev": true,
+      "dependencies": {
+        "array-buffer-byte-length": "^1.0.2",
+        "arraybuffer.prototype.slice": "^1.0.4",
+        "available-typed-arrays": "^1.0.7",
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.4",
+        "data-view-buffer": "^1.0.2",
+        "data-view-byte-length": "^1.0.2",
+        "data-view-byte-offset": "^1.0.1",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "es-set-tostringtag": "^2.1.0",
+        "es-to-primitive": "^1.3.0",
+        "function.prototype.name": "^1.1.8",
+        "get-intrinsic": "^1.3.0",
+        "get-proto": "^1.0.1",
+        "get-symbol-description": "^1.1.0",
+        "globalthis": "^1.0.4",
+        "gopd": "^1.2.0",
+        "has-property-descriptors": "^1.0.2",
+        "has-proto": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "internal-slot": "^1.1.0",
+        "is-array-buffer": "^3.0.5",
+        "is-callable": "^1.2.7",
+        "is-data-view": "^1.0.2",
+        "is-negative-zero": "^2.0.3",
+        "is-regex": "^1.2.1",
+        "is-set": "^2.0.3",
+        "is-shared-array-buffer": "^1.0.4",
+        "is-string": "^1.1.1",
+        "is-typed-array": "^1.1.15",
+        "is-weakref": "^1.1.1",
+        "math-intrinsics": "^1.1.0",
+        "object-inspect": "^1.13.4",
+        "object-keys": "^1.1.1",
+        "object.assign": "^4.1.7",
+        "own-keys": "^1.0.1",
+        "regexp.prototype.flags": "^1.5.4",
+        "safe-array-concat": "^1.1.3",
+        "safe-push-apply": "^1.0.0",
+        "safe-regex-test": "^1.1.0",
+        "set-proto": "^1.0.0",
+        "stop-iteration-iterator": "^1.1.0",
+        "string.prototype.trim": "^1.2.10",
+        "string.prototype.trimend": "^1.0.9",
+        "string.prototype.trimstart": "^1.0.8",
+        "typed-array-buffer": "^1.0.3",
+        "typed-array-byte-length": "^1.0.3",
+        "typed-array-byte-offset": "^1.0.4",
+        "typed-array-length": "^1.0.7",
+        "unbox-primitive": "^1.1.0",
+        "which-typed-array": "^1.1.19"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-iterator-helpers": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/es-iterator-helpers/-/es-iterator-helpers-1.2.1.tgz",
+      "integrity": "sha512-uDn+FE1yrDzyC0pCo961B2IHbdM8y/ACZsKD4dG6WqrjV53BADjwa7D+1aom2rsNVfLyDgU/eigvlJGJ08OQ4w==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.3",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.6",
+        "es-errors": "^1.3.0",
+        "es-set-tostringtag": "^2.0.3",
+        "function-bind": "^1.1.2",
+        "get-intrinsic": "^1.2.6",
+        "globalthis": "^1.0.4",
+        "gopd": "^1.2.0",
+        "has-property-descriptors": "^1.0.2",
+        "has-proto": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "internal-slot": "^1.1.0",
+        "iterator.prototype": "^1.1.4",
+        "safe-array-concat": "^1.1.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+      "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+      "dev": true,
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-set-tostringtag": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
+      "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
+      "dev": true,
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6",
+        "has-tostringtag": "^1.0.2",
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-shim-unscopables": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/es-shim-unscopables/-/es-shim-unscopables-1.1.0.tgz",
+      "integrity": "sha512-d9T8ucsEhh8Bi1woXCf+TIKDIROLG5WCkxg8geBCbvk22kzwC5G2OnXVMO6FUsvQlgUUXQ2itephWDLqDzbeCw==",
+      "dev": true,
+      "dependencies": {
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-to-primitive": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-to-primitive/-/es-to-primitive-1.3.0.tgz",
+      "integrity": "sha512-w+5mJ3GuFL+NjVtJlvydShqE1eN3h3PbI7/5LAsYJP/2qtuMXjfL2LpHSRqo4b4eSF5K/DH1JXKUAHSB2UW50g==",
+      "dev": true,
+      "dependencies": {
+        "is-callable": "^1.2.7",
+        "is-date-object": "^1.0.5",
+        "is-symbol": "^1.0.4"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/escape-string-regexp": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
+      "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==",
+      "dev": true,
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/eslint": {
+      "version": "9.38.0",
+      "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.38.0.tgz",
+      "integrity": "sha512-t5aPOpmtJcZcz5UJyY2GbvpDlsK5E8JqRqoKtfiKE3cNh437KIqfJr3A3AKf5k64NPx6d0G3dno6XDY05PqPtw==",
+      "dev": true,
+      "dependencies": {
+        "@eslint-community/eslint-utils": "^4.8.0",
+        "@eslint-community/regexpp": "^4.12.1",
+        "@eslint/config-array": "^0.21.1",
+        "@eslint/config-helpers": "^0.4.1",
+        "@eslint/core": "^0.16.0",
+        "@eslint/eslintrc": "^3.3.1",
+        "@eslint/js": "9.38.0",
+        "@eslint/plugin-kit": "^0.4.0",
+        "@humanfs/node": "^0.16.6",
+        "@humanwhocodes/module-importer": "^1.0.1",
+        "@humanwhocodes/retry": "^0.4.2",
+        "@types/estree": "^1.0.6",
+        "ajv": "^6.12.4",
+        "chalk": "^4.0.0",
+        "cross-spawn": "^7.0.6",
+        "debug": "^4.3.2",
+        "escape-string-regexp": "^4.0.0",
+        "eslint-scope": "^8.4.0",
+        "eslint-visitor-keys": "^4.2.1",
+        "espree": "^10.4.0",
+        "esquery": "^1.5.0",
+        "esutils": "^2.0.2",
+        "fast-deep-equal": "^3.1.3",
+        "file-entry-cache": "^8.0.0",
+        "find-up": "^5.0.0",
+        "glob-parent": "^6.0.2",
+        "ignore": "^5.2.0",
+        "imurmurhash": "^0.1.4",
+        "is-glob": "^4.0.0",
+        "json-stable-stringify-without-jsonify": "^1.0.1",
+        "lodash.merge": "^4.6.2",
+        "minimatch": "^3.1.2",
+        "natural-compare": "^1.4.0",
+        "optionator": "^0.9.3"
+      },
+      "bin": {
+        "eslint": "bin/eslint.js"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "url": "https://eslint.org/donate"
+      },
+      "peerDependencies": {
+        "jiti": "*"
+      },
+      "peerDependenciesMeta": {
+        "jiti": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/eslint-config-next": {
+      "version": "15.5.5",
+      "resolved": "https://registry.npmjs.org/eslint-config-next/-/eslint-config-next-15.5.5.tgz",
+      "integrity": "sha512-f8lRSSelp6cqrYjxEMjJ5En3WV913gTu/w9goYShnIujwDSQlKt4x9MwSDiduE9R5mmFETK44+qlQDxeSA0rUA==",
+      "dev": true,
+      "dependencies": {
+        "@next/eslint-plugin-next": "15.5.5",
+        "@rushstack/eslint-patch": "^1.10.3",
+        "@typescript-eslint/eslint-plugin": "^5.4.2 || ^6.0.0 || ^7.0.0 || ^8.0.0",
+        "@typescript-eslint/parser": "^5.4.2 || ^6.0.0 || ^7.0.0 || ^8.0.0",
+        "eslint-import-resolver-node": "^0.3.6",
+        "eslint-import-resolver-typescript": "^3.5.2",
+        "eslint-plugin-import": "^2.31.0",
+        "eslint-plugin-jsx-a11y": "^6.10.0",
+        "eslint-plugin-react": "^7.37.0",
+        "eslint-plugin-react-hooks": "^5.0.0"
+      },
+      "peerDependencies": {
+        "eslint": "^7.23.0 || ^8.0.0 || ^9.0.0",
+        "typescript": ">=3.3.1"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/eslint-import-resolver-node": {
+      "version": "0.3.9",
+      "resolved": "https://registry.npmjs.org/eslint-import-resolver-node/-/eslint-import-resolver-node-0.3.9.tgz",
+      "integrity": "sha512-WFj2isz22JahUv+B788TlO3N6zL3nNJGU8CcZbPZvVEkBPaJdCV4vy5wyghty5ROFbCRnm132v8BScu5/1BQ8g==",
+      "dev": true,
+      "dependencies": {
+        "debug": "^3.2.7",
+        "is-core-module": "^2.13.0",
+        "resolve": "^1.22.4"
+      }
+    },
+    "node_modules/eslint-import-resolver-node/node_modules/debug": {
+      "version": "3.2.7",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz",
+      "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==",
+      "dev": true,
+      "dependencies": {
+        "ms": "^2.1.1"
+      }
+    },
+    "node_modules/eslint-import-resolver-typescript": {
+      "version": "3.10.1",
+      "resolved": "https://registry.npmjs.org/eslint-import-resolver-typescript/-/eslint-import-resolver-typescript-3.10.1.tgz",
+      "integrity": "sha512-A1rHYb06zjMGAxdLSkN2fXPBwuSaQ0iO5M/hdyS0Ajj1VBaRp0sPD3dn1FhME3c/JluGFbwSxyCfqdSbtQLAHQ==",
+      "dev": true,
+      "dependencies": {
+        "@nolyfill/is-core-module": "1.0.39",
+        "debug": "^4.4.0",
+        "get-tsconfig": "^4.10.0",
+        "is-bun-module": "^2.0.0",
+        "stable-hash": "^0.0.5",
+        "tinyglobby": "^0.2.13",
+        "unrs-resolver": "^1.6.2"
+      },
+      "engines": {
+        "node": "^14.18.0 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint-import-resolver-typescript"
+      },
+      "peerDependencies": {
+        "eslint": "*",
+        "eslint-plugin-import": "*",
+        "eslint-plugin-import-x": "*"
+      },
+      "peerDependenciesMeta": {
+        "eslint-plugin-import": {
+          "optional": true
+        },
+        "eslint-plugin-import-x": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/eslint-module-utils": {
+      "version": "2.12.1",
+      "resolved": "https://registry.npmjs.org/eslint-module-utils/-/eslint-module-utils-2.12.1.tgz",
+      "integrity": "sha512-L8jSWTze7K2mTg0vos/RuLRS5soomksDPoJLXIslC7c8Wmut3bx7CPpJijDcBZtxQ5lrbUdM+s0OlNbz0DCDNw==",
+      "dev": true,
+      "dependencies": {
+        "debug": "^3.2.7"
+      },
+      "engines": {
+        "node": ">=4"
+      },
+      "peerDependenciesMeta": {
+        "eslint": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/eslint-module-utils/node_modules/debug": {
+      "version": "3.2.7",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz",
+      "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==",
+      "dev": true,
+      "dependencies": {
+        "ms": "^2.1.1"
+      }
+    },
+    "node_modules/eslint-plugin-import": {
+      "version": "2.32.0",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-import/-/eslint-plugin-import-2.32.0.tgz",
+      "integrity": "sha512-whOE1HFo/qJDyX4SnXzP4N6zOWn79WhnCUY/iDR0mPfQZO8wcYE4JClzI2oZrhBnnMUCBCHZhO6VQyoBU95mZA==",
+      "dev": true,
+      "dependencies": {
+        "@rtsao/scc": "^1.1.0",
+        "array-includes": "^3.1.9",
+        "array.prototype.findlastindex": "^1.2.6",
+        "array.prototype.flat": "^1.3.3",
+        "array.prototype.flatmap": "^1.3.3",
+        "debug": "^3.2.7",
+        "doctrine": "^2.1.0",
+        "eslint-import-resolver-node": "^0.3.9",
+        "eslint-module-utils": "^2.12.1",
+        "hasown": "^2.0.2",
+        "is-core-module": "^2.16.1",
+        "is-glob": "^4.0.3",
+        "minimatch": "^3.1.2",
+        "object.fromentries": "^2.0.8",
+        "object.groupby": "^1.0.3",
+        "object.values": "^1.2.1",
+        "semver": "^6.3.1",
+        "string.prototype.trimend": "^1.0.9",
+        "tsconfig-paths": "^3.15.0"
+      },
+      "engines": {
+        "node": ">=4"
+      },
+      "peerDependencies": {
+        "eslint": "^2 || ^3 || ^4 || ^5 || ^6 || ^7.2.0 || ^8 || ^9"
+      }
+    },
+    "node_modules/eslint-plugin-import/node_modules/debug": {
+      "version": "3.2.7",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz",
+      "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==",
+      "dev": true,
+      "dependencies": {
+        "ms": "^2.1.1"
+      }
+    },
+    "node_modules/eslint-plugin-import/node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/eslint-plugin-jsx-a11y": {
+      "version": "6.10.2",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-jsx-a11y/-/eslint-plugin-jsx-a11y-6.10.2.tgz",
+      "integrity": "sha512-scB3nz4WmG75pV8+3eRUQOHZlNSUhFNq37xnpgRkCCELU3XMvXAxLk1eqWWyE22Ki4Q01Fnsw9BA3cJHDPgn2Q==",
+      "dev": true,
+      "dependencies": {
+        "aria-query": "^5.3.2",
+        "array-includes": "^3.1.8",
+        "array.prototype.flatmap": "^1.3.2",
+        "ast-types-flow": "^0.0.8",
+        "axe-core": "^4.10.0",
+        "axobject-query": "^4.1.0",
+        "damerau-levenshtein": "^1.0.8",
+        "emoji-regex": "^9.2.2",
+        "hasown": "^2.0.2",
+        "jsx-ast-utils": "^3.3.5",
+        "language-tags": "^1.0.9",
+        "minimatch": "^3.1.2",
+        "object.fromentries": "^2.0.8",
+        "safe-regex-test": "^1.0.3",
+        "string.prototype.includes": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=4.0"
+      },
+      "peerDependencies": {
+        "eslint": "^3 || ^4 || ^5 || ^6 || ^7 || ^8 || ^9"
+      }
+    },
+    "node_modules/eslint-plugin-react": {
+      "version": "7.37.5",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-react/-/eslint-plugin-react-7.37.5.tgz",
+      "integrity": "sha512-Qteup0SqU15kdocexFNAJMvCJEfa2xUKNV4CC1xsVMrIIqEy3SQ/rqyxCWNzfrd3/ldy6HMlD2e0JDVpDg2qIA==",
+      "dev": true,
+      "dependencies": {
+        "array-includes": "^3.1.8",
+        "array.prototype.findlast": "^1.2.5",
+        "array.prototype.flatmap": "^1.3.3",
+        "array.prototype.tosorted": "^1.1.4",
+        "doctrine": "^2.1.0",
+        "es-iterator-helpers": "^1.2.1",
+        "estraverse": "^5.3.0",
+        "hasown": "^2.0.2",
+        "jsx-ast-utils": "^2.4.1 || ^3.0.0",
+        "minimatch": "^3.1.2",
+        "object.entries": "^1.1.9",
+        "object.fromentries": "^2.0.8",
+        "object.values": "^1.2.1",
+        "prop-types": "^15.8.1",
+        "resolve": "^2.0.0-next.5",
+        "semver": "^6.3.1",
+        "string.prototype.matchall": "^4.0.12",
+        "string.prototype.repeat": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      },
+      "peerDependencies": {
+        "eslint": "^3 || ^4 || ^5 || ^6 || ^7 || ^8 || ^9.7"
+      }
+    },
+    "node_modules/eslint-plugin-react-hooks": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-react-hooks/-/eslint-plugin-react-hooks-5.2.0.tgz",
+      "integrity": "sha512-+f15FfK64YQwZdJNELETdn5ibXEUQmW1DZL6KXhNnc2heoy/sg9VJJeT7n8TlMWouzWqSWavFkIhHyIbIAEapg==",
+      "dev": true,
+      "engines": {
+        "node": ">=10"
+      },
+      "peerDependencies": {
+        "eslint": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0-0 || ^9.0.0"
+      }
+    },
+    "node_modules/eslint-plugin-react/node_modules/resolve": {
+      "version": "2.0.0-next.5",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-2.0.0-next.5.tgz",
+      "integrity": "sha512-U7WjGVG9sH8tvjW5SmGbQuui75FiyjAX72HX15DwBBwF9dNiQZRQAg9nnPhYy+TUnE0+VcrttuvNI8oSxZcocA==",
+      "dev": true,
+      "dependencies": {
+        "is-core-module": "^2.13.0",
+        "path-parse": "^1.0.7",
+        "supports-preserve-symlinks-flag": "^1.0.0"
+      },
+      "bin": {
+        "resolve": "bin/resolve"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/eslint-plugin-react/node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/eslint-scope": {
+      "version": "8.4.0",
+      "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.4.0.tgz",
+      "integrity": "sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==",
+      "dev": true,
+      "dependencies": {
+        "esrecurse": "^4.3.0",
+        "estraverse": "^5.2.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/eslint-visitor-keys": {
+      "version": "4.2.1",
+      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz",
+      "integrity": "sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==",
+      "dev": true,
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/espree": {
+      "version": "10.4.0",
+      "resolved": "https://registry.npmjs.org/espree/-/espree-10.4.0.tgz",
+      "integrity": "sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==",
+      "dev": true,
+      "dependencies": {
+        "acorn": "^8.15.0",
+        "acorn-jsx": "^5.3.2",
+        "eslint-visitor-keys": "^4.2.1"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/esquery": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz",
+      "integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==",
+      "dev": true,
+      "dependencies": {
+        "estraverse": "^5.1.0"
+      },
+      "engines": {
+        "node": ">=0.10"
+      }
+    },
+    "node_modules/esrecurse": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz",
+      "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==",
+      "dev": true,
+      "dependencies": {
+        "estraverse": "^5.2.0"
+      },
+      "engines": {
+        "node": ">=4.0"
+      }
+    },
+    "node_modules/estraverse": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz",
+      "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==",
+      "dev": true,
+      "engines": {
+        "node": ">=4.0"
+      }
+    },
+    "node_modules/esutils": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz",
+      "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "dev": true
+    },
+    "node_modules/fast-glob": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.1.tgz",
+      "integrity": "sha512-kNFPyjhh5cKjrUltxs+wFx+ZkbRaxxmZ+X0ZU31SOsxCEtP9VPgtq2teZw1DebupL5GmDaNQ6yKMMVcM41iqDg==",
+      "dev": true,
+      "dependencies": {
+        "@nodelib/fs.stat": "^2.0.2",
+        "@nodelib/fs.walk": "^1.2.3",
+        "glob-parent": "^5.1.2",
+        "merge2": "^1.3.0",
+        "micromatch": "^4.0.4"
+      },
+      "engines": {
+        "node": ">=8.6.0"
+      }
+    },
+    "node_modules/fast-glob/node_modules/glob-parent": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
+      "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
+      "dev": true,
+      "dependencies": {
+        "is-glob": "^4.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/fast-json-stable-stringify": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",
+      "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==",
+      "dev": true
+    },
+    "node_modules/fast-levenshtein": {
+      "version": "2.0.6",
+      "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz",
+      "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==",
+      "dev": true
+    },
+    "node_modules/fastq": {
+      "version": "1.19.1",
+      "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.19.1.tgz",
+      "integrity": "sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==",
+      "dev": true,
+      "dependencies": {
+        "reusify": "^1.0.4"
+      }
+    },
+    "node_modules/file-entry-cache": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz",
+      "integrity": "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==",
+      "dev": true,
+      "dependencies": {
+        "flat-cache": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=16.0.0"
+      }
+    },
+    "node_modules/fill-range": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
+      "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
+      "dev": true,
+      "dependencies": {
+        "to-regex-range": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/find-up": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz",
+      "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==",
+      "dev": true,
+      "dependencies": {
+        "locate-path": "^6.0.0",
+        "path-exists": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/flat-cache": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz",
+      "integrity": "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==",
+      "dev": true,
+      "dependencies": {
+        "flatted": "^3.2.9",
+        "keyv": "^4.5.4"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/flatted": {
+      "version": "3.3.3",
+      "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz",
+      "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==",
+      "dev": true
+    },
+    "node_modules/for-each": {
+      "version": "0.3.5",
+      "resolved": "https://registry.npmjs.org/for-each/-/for-each-0.3.5.tgz",
+      "integrity": "sha512-dKx12eRCVIzqCxFGplyFKJMPvLEWgmNtUrpTiJIR5u97zEhRG8ySrtboPHZXx7daLxQVrl643cTzbab2tkQjxg==",
+      "dev": true,
+      "dependencies": {
+        "is-callable": "^1.2.7"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "dev": true,
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/function.prototype.name": {
+      "version": "1.1.8",
+      "resolved": "https://registry.npmjs.org/function.prototype.name/-/function.prototype.name-1.1.8.tgz",
+      "integrity": "sha512-e5iwyodOHhbMr/yNrc7fDYG4qlbIvI5gajyzPnb5TCwyhjApznQh1BMFou9b30SevY43gCJKXycoCBjMbsuW0Q==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.3",
+        "define-properties": "^1.2.1",
+        "functions-have-names": "^1.2.3",
+        "hasown": "^2.0.2",
+        "is-callable": "^1.2.7"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/functions-have-names": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/functions-have-names/-/functions-have-names-1.2.3.tgz",
+      "integrity": "sha512-xckBUXyTIqT97tq2x2AMb+g163b5JFysYk0x4qxNFwbfQkmNZoiRHb6sPzI9/QV33WeuvVYBUIiD4NzNIyqaRQ==",
+      "dev": true,
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/generator-function": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/generator-function/-/generator-function-2.0.1.tgz",
+      "integrity": "sha512-SFdFmIJi+ybC0vjlHN0ZGVGHc3lgE0DxPAT0djjVg+kjOnSqclqmj0KQ7ykTOLP6YxoqOvuAODGdcHJn+43q3g==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "dev": true,
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "dev": true,
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/get-symbol-description": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/get-symbol-description/-/get-symbol-description-1.1.0.tgz",
+      "integrity": "sha512-w9UMqWwJxHNOvoNzSJ2oPF5wvYcvP7jUvYzhp67yEhTi17ZDBBC1z9pTdGuzjD+EFIqLSYRweZjqfiPzQ06Ebg==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-tsconfig": {
+      "version": "4.13.0",
+      "resolved": "https://registry.npmjs.org/get-tsconfig/-/get-tsconfig-4.13.0.tgz",
+      "integrity": "sha512-1VKTZJCwBrvbd+Wn3AOgQP/2Av+TfTCOlE4AcRJE72W1ksZXbAx8PPBR9RzgTeSPzlPMHrbANMH3LbltH73wxQ==",
+      "dev": true,
+      "dependencies": {
+        "resolve-pkg-maps": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/privatenumber/get-tsconfig?sponsor=1"
+      }
+    },
+    "node_modules/glob-parent": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz",
+      "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==",
+      "dev": true,
+      "dependencies": {
+        "is-glob": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=10.13.0"
+      }
+    },
+    "node_modules/globals": {
+      "version": "14.0.0",
+      "resolved": "https://registry.npmjs.org/globals/-/globals-14.0.0.tgz",
+      "integrity": "sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/globalthis": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/globalthis/-/globalthis-1.0.4.tgz",
+      "integrity": "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==",
+      "dev": true,
+      "dependencies": {
+        "define-properties": "^1.2.1",
+        "gopd": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/graphemer": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/graphemer/-/graphemer-1.4.0.tgz",
+      "integrity": "sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==",
+      "dev": true
+    },
+    "node_modules/has-bigints": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-bigints/-/has-bigints-1.1.0.tgz",
+      "integrity": "sha512-R3pbpkcIqv2Pm3dUwgjclDRVmWpTJW2DcMzcIhEXEx1oh/CEMObMm3KLmRJOdvhM7o4uQBnwr8pzRK2sJWIqfg==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-flag": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+      "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/has-property-descriptors": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz",
+      "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==",
+      "dev": true,
+      "dependencies": {
+        "es-define-property": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-proto": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/has-proto/-/has-proto-1.2.0.tgz",
+      "integrity": "sha512-KIL7eQPfHQRC8+XluaIw7BHUwwqL19bQn4hzNgdr+1wXoU0KKj6rufu47lhY7KbJR2C6T6+PfyN0Ea7wkSS+qQ==",
+      "dev": true,
+      "dependencies": {
+        "dunder-proto": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-tostringtag": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
+      "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
+      "dev": true,
+      "dependencies": {
+        "has-symbols": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+      "dev": true,
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/ignore": {
+      "version": "5.3.2",
+      "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",
+      "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",
+      "dev": true,
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/import-fresh": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz",
+      "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==",
+      "dev": true,
+      "dependencies": {
+        "parent-module": "^1.0.0",
+        "resolve-from": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/imurmurhash": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz",
+      "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.8.19"
+      }
+    },
+    "node_modules/internal-slot": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/internal-slot/-/internal-slot-1.1.0.tgz",
+      "integrity": "sha512-4gd7VpWNQNB4UKKCFFVcp1AVv+FMOgs9NKzjHKusc8jTMhd5eL1NqQqOpE0KzMds804/yHlglp3uxgluOqAPLw==",
+      "dev": true,
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "hasown": "^2.0.2",
+        "side-channel": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/is-array-buffer": {
+      "version": "3.0.5",
+      "resolved": "https://registry.npmjs.org/is-array-buffer/-/is-array-buffer-3.0.5.tgz",
+      "integrity": "sha512-DDfANUiiG2wC1qawP66qlTugJeL5HyzMpfr8lLK+jMQirGzNod0B12cFB/9q838Ru27sBwfw78/rdoU7RERz6A==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.3",
+        "get-intrinsic": "^1.2.6"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-async-function": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/is-async-function/-/is-async-function-2.1.1.tgz",
+      "integrity": "sha512-9dgM/cZBnNvjzaMYHVoxxfPj2QXt22Ev7SuuPrs+xav0ukGB0S6d4ydZdEiM48kLx5kDV+QBPrpVnFyefL8kkQ==",
+      "dev": true,
+      "dependencies": {
+        "async-function": "^1.0.0",
+        "call-bound": "^1.0.3",
+        "get-proto": "^1.0.1",
+        "has-tostringtag": "^1.0.2",
+        "safe-regex-test": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-bigint": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/is-bigint/-/is-bigint-1.1.0.tgz",
+      "integrity": "sha512-n4ZT37wG78iz03xPRKJrHTdZbe3IicyucEtdRsV5yglwc3GyUfbAfpSeD0FJ41NbUNSt5wbhqfp1fS+BgnvDFQ==",
+      "dev": true,
+      "dependencies": {
+        "has-bigints": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-boolean-object": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/is-boolean-object/-/is-boolean-object-1.2.2.tgz",
+      "integrity": "sha512-wa56o2/ElJMYqjCjGkXri7it5FbebW5usLw/nPmCMs5DeZ7eziSYZhSmPRn0txqeW4LnAmQQU7FgqLpsEFKM4A==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "has-tostringtag": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-bun-module": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/is-bun-module/-/is-bun-module-2.0.0.tgz",
+      "integrity": "sha512-gNCGbnnnnFAUGKeZ9PdbyeGYJqewpmc2aKHUEMO5nQPWU9lOmv7jcmQIv+qHD8fXW6W7qfuCwX4rY9LNRjXrkQ==",
+      "dev": true,
+      "dependencies": {
+        "semver": "^7.7.1"
+      }
+    },
+    "node_modules/is-callable": {
+      "version": "1.2.7",
+      "resolved": "https://registry.npmjs.org/is-callable/-/is-callable-1.2.7.tgz",
+      "integrity": "sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-core-module": {
+      "version": "2.16.1",
+      "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz",
+      "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==",
+      "dev": true,
+      "dependencies": {
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-data-view": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/is-data-view/-/is-data-view-1.0.2.tgz",
+      "integrity": "sha512-RKtWF8pGmS87i2D6gqQu/l7EYRlVdfzemCJN/P3UOs//x1QE7mfhvzHIApBTRf7axvT6DMGwSwBXYCT0nfB9xw==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "get-intrinsic": "^1.2.6",
+        "is-typed-array": "^1.1.13"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-date-object": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/is-date-object/-/is-date-object-1.1.0.tgz",
+      "integrity": "sha512-PwwhEakHVKTdRNVOw+/Gyh0+MzlCl4R6qKvkhuvLtPMggI1WAHt9sOwZxQLSGpUaDnrdyDsomoRgNnCfKNSXXg==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "has-tostringtag": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-extglob": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
+      "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-finalizationregistry": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/is-finalizationregistry/-/is-finalizationregistry-1.1.1.tgz",
+      "integrity": "sha512-1pC6N8qWJbWoPtEjgcL2xyhQOP491EQjeUo3qTKcmV8YSDDJrOepfG8pcC7h/QgnQHYSv0mJ3Z/ZWxmatVrysg==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-generator-function": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/is-generator-function/-/is-generator-function-1.1.2.tgz",
+      "integrity": "sha512-upqt1SkGkODW9tsGNG5mtXTXtECizwtS2kA161M+gJPc1xdb/Ax629af6YrTwcOeQHbewrPNlE5Dx7kzvXTizA==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.4",
+        "generator-function": "^2.0.0",
+        "get-proto": "^1.0.1",
+        "has-tostringtag": "^1.0.2",
+        "safe-regex-test": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-glob": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
+      "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
+      "dev": true,
+      "dependencies": {
+        "is-extglob": "^2.1.1"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-map": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/is-map/-/is-map-2.0.3.tgz",
+      "integrity": "sha512-1Qed0/Hr2m+YqxnM09CjA2d/i6YZNfF6R2oRAOj36eUdS6qIV/huPJNSEpKbupewFs+ZsJlxsjjPbc0/afW6Lw==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-negative-zero": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/is-negative-zero/-/is-negative-zero-2.0.3.tgz",
+      "integrity": "sha512-5KoIu2Ngpyek75jXodFvnafB6DJgr3u8uuK0LEZJjrU19DrMD3EVERaR8sjz8CCGgpZvxPl9SuE1GMVPFHx1mw==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-number": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
+      "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.12.0"
+      }
+    },
+    "node_modules/is-number-object": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/is-number-object/-/is-number-object-1.1.1.tgz",
+      "integrity": "sha512-lZhclumE1G6VYD8VHe35wFaIif+CTy5SJIi5+3y4psDgWu4wPDoBhF8NxUOinEc7pHgiTsT6MaBb92rKhhD+Xw==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "has-tostringtag": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-regex": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/is-regex/-/is-regex-1.2.1.tgz",
+      "integrity": "sha512-MjYsKHO5O7mCsmRGxWcLWheFqN9DJ/2TmngvjKXihe6efViPqc274+Fx/4fYj/r03+ESvBdTXK0V6tA3rgez1g==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "gopd": "^1.2.0",
+        "has-tostringtag": "^1.0.2",
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-set": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/is-set/-/is-set-2.0.3.tgz",
+      "integrity": "sha512-iPAjerrse27/ygGLxw+EBR9agv9Y6uLeYVJMu+QNCoouJ1/1ri0mGrcWpfCqFZuzzx3WjtwxG098X+n4OuRkPg==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-shared-array-buffer": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/is-shared-array-buffer/-/is-shared-array-buffer-1.0.4.tgz",
+      "integrity": "sha512-ISWac8drv4ZGfwKl5slpHG9OwPNty4jOWPRIhBpxOoD+hqITiwuipOQ2bNthAzwA3B4fIjO4Nln74N0S9byq8A==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-string": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/is-string/-/is-string-1.1.1.tgz",
+      "integrity": "sha512-BtEeSsoaQjlSPBemMQIrY1MY0uM6vnS1g5fmufYOtnxLGUZM2178PKbhsk7Ffv58IX+ZtcvoGwccYsh0PglkAA==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "has-tostringtag": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-symbol": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/is-symbol/-/is-symbol-1.1.1.tgz",
+      "integrity": "sha512-9gGx6GTtCQM73BgmHQXfDmLtfjjTUDSyoxTCbp5WtoixAhfgsDirWIcVQ/IHpvI5Vgd5i/J5F7B9cN/WlVbC/w==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "has-symbols": "^1.1.0",
+        "safe-regex-test": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-typed-array": {
+      "version": "1.1.15",
+      "resolved": "https://registry.npmjs.org/is-typed-array/-/is-typed-array-1.1.15.tgz",
+      "integrity": "sha512-p3EcsicXjit7SaskXHs1hA91QxgTw46Fv6EFKKGS5DRFLD8yKnohjF3hxoju94b/OcMZoQukzpPpBE9uLVKzgQ==",
+      "dev": true,
+      "dependencies": {
+        "which-typed-array": "^1.1.16"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-weakmap": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/is-weakmap/-/is-weakmap-2.0.2.tgz",
+      "integrity": "sha512-K5pXYOm9wqY1RgjpL3YTkF39tni1XajUIkawTLUo9EZEVUFga5gSQJF8nNS7ZwJQ02y+1YCNYcMh+HIf1ZqE+w==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-weakref": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/is-weakref/-/is-weakref-1.1.1.tgz",
+      "integrity": "sha512-6i9mGWSlqzNMEqpCp93KwRS1uUOodk2OJ6b+sq7ZPDSy2WuI5NFIxp/254TytR8ftefexkWn5xNiHUNpPOfSew==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-weakset": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/is-weakset/-/is-weakset-2.0.4.tgz",
+      "integrity": "sha512-mfcwb6IzQyOKTs84CQMrOwW4gQcaTOAWJ0zzJCl2WSPDrWk/OzDaImWFH3djXhb24g4eudZfLRozAvPGw4d9hQ==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "get-intrinsic": "^1.2.6"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/isarray": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-2.0.5.tgz",
+      "integrity": "sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==",
+      "dev": true
+    },
+    "node_modules/isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+      "dev": true
+    },
+    "node_modules/iterator.prototype": {
+      "version": "1.1.5",
+      "resolved": "https://registry.npmjs.org/iterator.prototype/-/iterator.prototype-1.1.5.tgz",
+      "integrity": "sha512-H0dkQoCa3b2VEeKQBOxFph+JAbcrQdE7KC0UkqwpLmv2EC4P41QXP+rqo9wYodACiG5/WM5s9oDApTU8utwj9g==",
+      "dev": true,
+      "dependencies": {
+        "define-data-property": "^1.1.4",
+        "es-object-atoms": "^1.0.0",
+        "get-intrinsic": "^1.2.6",
+        "get-proto": "^1.0.0",
+        "has-symbols": "^1.1.0",
+        "set-function-name": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/js-tokens": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+      "dev": true
+    },
+    "node_modules/js-yaml": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz",
+      "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==",
+      "dev": true,
+      "dependencies": {
+        "argparse": "^2.0.1"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/json-buffer": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz",
+      "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==",
+      "dev": true
+    },
+    "node_modules/json-schema-traverse": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
+      "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
+      "dev": true
+    },
+    "node_modules/json-stable-stringify-without-jsonify": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz",
+      "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==",
+      "dev": true
+    },
+    "node_modules/json5": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/json5/-/json5-1.0.2.tgz",
+      "integrity": "sha512-g1MWMLBiz8FKi1e4w0UyVL3w+iJceWAFBAaBnnGKOpNa5f8TLktkbre1+s6oICydWAm+HRUGTmI+//xv2hvXYA==",
+      "dev": true,
+      "dependencies": {
+        "minimist": "^1.2.0"
+      },
+      "bin": {
+        "json5": "lib/cli.js"
+      }
+    },
+    "node_modules/jsx-ast-utils": {
+      "version": "3.3.5",
+      "resolved": "https://registry.npmjs.org/jsx-ast-utils/-/jsx-ast-utils-3.3.5.tgz",
+      "integrity": "sha512-ZZow9HBI5O6EPgSJLUb8n2NKgmVWTwCvHGwFuJlMjvLFqlGG6pjirPhtdsseaLZjSibD8eegzmYpUZwoIlj2cQ==",
+      "dev": true,
+      "dependencies": {
+        "array-includes": "^3.1.6",
+        "array.prototype.flat": "^1.3.1",
+        "object.assign": "^4.1.4",
+        "object.values": "^1.1.6"
+      },
+      "engines": {
+        "node": ">=4.0"
+      }
+    },
+    "node_modules/keyv": {
+      "version": "4.5.4",
+      "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz",
+      "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==",
+      "dev": true,
+      "dependencies": {
+        "json-buffer": "3.0.1"
+      }
+    },
+    "node_modules/language-subtag-registry": {
+      "version": "0.3.23",
+      "resolved": "https://registry.npmjs.org/language-subtag-registry/-/language-subtag-registry-0.3.23.tgz",
+      "integrity": "sha512-0K65Lea881pHotoGEa5gDlMxt3pctLi2RplBb7Ezh4rRdLEOtgi7n4EwK9lamnUCkKBqaeKRVebTq6BAxSkpXQ==",
+      "dev": true
+    },
+    "node_modules/language-tags": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/language-tags/-/language-tags-1.0.9.tgz",
+      "integrity": "sha512-MbjN408fEndfiQXbFQ1vnd+1NoLDsnQW41410oQBXiyXDMYH5z505juWa4KUE1LqxRC7DgOgZDbKLxHIwm27hA==",
+      "dev": true,
+      "dependencies": {
+        "language-subtag-registry": "^0.3.20"
+      },
+      "engines": {
+        "node": ">=0.10"
+      }
+    },
+    "node_modules/levn": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz",
+      "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==",
+      "dev": true,
+      "dependencies": {
+        "prelude-ls": "^1.2.1",
+        "type-check": "~0.4.0"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/locate-path": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz",
+      "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==",
+      "dev": true,
+      "dependencies": {
+        "p-locate": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/lodash.merge": {
+      "version": "4.6.2",
+      "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz",
+      "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==",
+      "dev": true
+    },
+    "node_modules/loose-envify": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz",
+      "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==",
+      "dev": true,
+      "dependencies": {
+        "js-tokens": "^3.0.0 || ^4.0.0"
+      },
+      "bin": {
+        "loose-envify": "cli.js"
+      }
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/merge2": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",
+      "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",
+      "dev": true,
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/micromatch": {
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
+      "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",
+      "dev": true,
+      "dependencies": {
+        "braces": "^3.0.3",
+        "picomatch": "^2.3.1"
+      },
+      "engines": {
+        "node": ">=8.6"
+      }
+    },
+    "node_modules/minimatch": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "dev": true,
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/minimist": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
+      "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
+      "dev": true,
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "dev": true
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.11",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+      "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/napi-postinstall": {
+      "version": "0.3.4",
+      "resolved": "https://registry.npmjs.org/napi-postinstall/-/napi-postinstall-0.3.4.tgz",
+      "integrity": "sha512-PHI5f1O0EP5xJ9gQmFGMS6IZcrVvTjpXjz7Na41gTE7eE2hK11lg04CECCYEEjdc17EV4DO+fkGEtt7TpTaTiQ==",
+      "dev": true,
+      "bin": {
+        "napi-postinstall": "lib/cli.js"
+      },
+      "engines": {
+        "node": "^12.20.0 || ^14.18.0 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/napi-postinstall"
+      }
+    },
+    "node_modules/natural-compare": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz",
+      "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==",
+      "dev": true
+    },
+    "node_modules/next": {
+      "version": "15.5.5",
+      "resolved": "https://registry.npmjs.org/next/-/next-15.5.5.tgz",
+      "integrity": "sha512-OQVdBPtpBfq7HxFN0kOVb7rXXOSIkt5lTzDJDGRBcOyVvNRIWFauMqi1gIHd1pszq1542vMOGY0HP4CaiALfkA==",
+      "dependencies": {
+        "@next/env": "15.5.5",
+        "@swc/helpers": "0.5.15",
+        "caniuse-lite": "^1.0.30001579",
+        "postcss": "8.4.31",
+        "styled-jsx": "5.1.6"
+      },
+      "bin": {
+        "next": "dist/bin/next"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^19.8.0 || >= 20.0.0"
+      },
+      "optionalDependencies": {
+        "@next/swc-darwin-arm64": "15.5.5",
+        "@next/swc-darwin-x64": "15.5.5",
+        "@next/swc-linux-arm64-gnu": "15.5.5",
+        "@next/swc-linux-arm64-musl": "15.5.5",
+        "@next/swc-linux-x64-gnu": "15.5.5",
+        "@next/swc-linux-x64-musl": "15.5.5",
+        "@next/swc-win32-arm64-msvc": "15.5.5",
+        "@next/swc-win32-x64-msvc": "15.5.5",
+        "sharp": "^0.34.3"
+      },
+      "peerDependencies": {
+        "@opentelemetry/api": "^1.1.0",
+        "@playwright/test": "^1.51.1",
+        "babel-plugin-react-compiler": "*",
+        "react": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0",
+        "react-dom": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0",
+        "sass": "^1.3.0"
+      },
+      "peerDependenciesMeta": {
+        "@opentelemetry/api": {
+          "optional": true
+        },
+        "@playwright/test": {
+          "optional": true
+        },
+        "babel-plugin-react-compiler": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/object-assign": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
+      "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/object-inspect": {
+      "version": "1.13.4",
+      "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
+      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/object-keys": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz",
+      "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/object.assign": {
+      "version": "4.1.7",
+      "resolved": "https://registry.npmjs.org/object.assign/-/object.assign-4.1.7.tgz",
+      "integrity": "sha512-nK28WOo+QIjBkDduTINE4JkF/UJJKyf2EJxvJKfblDpyg0Q+pkOHNTL0Qwy6NP6FhE/EnzV73BxxqcJaXY9anw==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.3",
+        "define-properties": "^1.2.1",
+        "es-object-atoms": "^1.0.0",
+        "has-symbols": "^1.1.0",
+        "object-keys": "^1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/object.entries": {
+      "version": "1.1.9",
+      "resolved": "https://registry.npmjs.org/object.entries/-/object.entries-1.1.9.tgz",
+      "integrity": "sha512-8u/hfXFRBD1O0hPUjioLhoWFHRmt6tKA4/vZPyckBr18l1KE9uHrFaFaUi8MDRTpi4uak2goyPTSNJLXX2k2Hw==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.4",
+        "define-properties": "^1.2.1",
+        "es-object-atoms": "^1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/object.fromentries": {
+      "version": "2.0.8",
+      "resolved": "https://registry.npmjs.org/object.fromentries/-/object.fromentries-2.0.8.tgz",
+      "integrity": "sha512-k6E21FzySsSK5a21KRADBd/NGneRegFO5pLHfdQLpRDETUNJueLXs3WCzyQ3tFRDYgbq3KHGXfTbi2bs8WQ6rQ==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.7",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.2",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/object.groupby": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/object.groupby/-/object.groupby-1.0.3.tgz",
+      "integrity": "sha512-+Lhy3TQTuzXI5hevh8sBGqbmurHbbIjAi0Z4S63nthVLmLxfbj4T54a4CfZrXIrt9iP4mVAPYMo/v99taj3wjQ==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.7",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/object.values": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/object.values/-/object.values-1.2.1.tgz",
+      "integrity": "sha512-gXah6aZrcUxjWg2zR2MwouP2eHlCBzdV4pygudehaKXSGW4v2AsRQUK+lwwXhii6KFZcunEnmSUoYp5CXibxtA==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.3",
+        "define-properties": "^1.2.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/optionator": {
+      "version": "0.9.4",
+      "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz",
+      "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==",
+      "dev": true,
+      "dependencies": {
+        "deep-is": "^0.1.3",
+        "fast-levenshtein": "^2.0.6",
+        "levn": "^0.4.1",
+        "prelude-ls": "^1.2.1",
+        "type-check": "^0.4.0",
+        "word-wrap": "^1.2.5"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/own-keys": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/own-keys/-/own-keys-1.0.1.tgz",
+      "integrity": "sha512-qFOyK5PjiWZd+QQIh+1jhdb9LpxTF0qs7Pm8o5QHYZ0M3vKqSqzsZaEB6oWlxZ+q2sJBMI/Ktgd2N5ZwQoRHfg==",
+      "dev": true,
+      "dependencies": {
+        "get-intrinsic": "^1.2.6",
+        "object-keys": "^1.1.1",
+        "safe-push-apply": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/p-limit": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz",
+      "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==",
+      "dev": true,
+      "dependencies": {
+        "yocto-queue": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-locate": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz",
+      "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==",
+      "dev": true,
+      "dependencies": {
+        "p-limit": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/parent-module": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz",
+      "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==",
+      "dev": true,
+      "dependencies": {
+        "callsites": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/path-exists": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
+      "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-key": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-parse": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
+      "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
+      "dev": true
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="
+    },
+    "node_modules/picomatch": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
+      "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
+      "dev": true,
+      "engines": {
+        "node": ">=8.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/possible-typed-array-names": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/possible-typed-array-names/-/possible-typed-array-names-1.1.0.tgz",
+      "integrity": "sha512-/+5VFTchJDoVj3bhoqi6UeymcD00DAwb1nJwamzPvHEszJ4FpF6SNNbUbOS8yI56qHzdV8eK0qEfOSiodkTdxg==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/postcss": {
+      "version": "8.4.31",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.31.tgz",
+      "integrity": "sha512-PS08Iboia9mts/2ygV3eLpY5ghnUcfLV/EXTOW1E2qYxJKGGBUtNjN76FYHnMs36RmARn41bC0AZmn+rR0OVpQ==",
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "dependencies": {
+        "nanoid": "^3.3.6",
+        "picocolors": "^1.0.0",
+        "source-map-js": "^1.0.2"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "node_modules/prelude-ls": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz",
+      "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/prop-types": {
+      "version": "15.8.1",
+      "resolved": "https://registry.npmjs.org/prop-types/-/prop-types-15.8.1.tgz",
+      "integrity": "sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg==",
+      "dev": true,
+      "dependencies": {
+        "loose-envify": "^1.4.0",
+        "object-assign": "^4.1.1",
+        "react-is": "^16.13.1"
+      }
+    },
+    "node_modules/punycode": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
+      "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/queue-microtask": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",
+      "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ]
+    },
+    "node_modules/react": {
+      "version": "19.1.0",
+      "resolved": "https://registry.npmjs.org/react/-/react-19.1.0.tgz",
+      "integrity": "sha512-FS+XFBNvn3GTAWq26joslQgWNoFu08F4kl0J4CgdNKADkdSGXQyTCnKteIAJy96Br6YbpEU1LSzV5dYtjMkMDg==",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/react-dom": {
+      "version": "19.1.0",
+      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.1.0.tgz",
+      "integrity": "sha512-Xs1hdnE+DyKgeHJeJznQmYMIBG3TKIHJJT95Q58nHLSrElKlGQqDTR2HQ9fx5CN/Gk6Vh/kupBTDLU11/nDk/g==",
+      "dependencies": {
+        "scheduler": "^0.26.0"
+      },
+      "peerDependencies": {
+        "react": "^19.1.0"
+      }
+    },
+    "node_modules/react-is": {
+      "version": "16.13.1",
+      "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz",
+      "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==",
+      "dev": true
+    },
+    "node_modules/reflect.getprototypeof": {
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/reflect.getprototypeof/-/reflect.getprototypeof-1.0.10.tgz",
+      "integrity": "sha512-00o4I+DVrefhv+nX0ulyi3biSHCPDe+yLv5o/p6d/UVlirijB8E16FtfwSAi4g3tcqrQ4lRAqQSoFEZJehYEcw==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.9",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.0.0",
+        "get-intrinsic": "^1.2.7",
+        "get-proto": "^1.0.1",
+        "which-builtin-type": "^1.2.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/regexp.prototype.flags": {
+      "version": "1.5.4",
+      "resolved": "https://registry.npmjs.org/regexp.prototype.flags/-/regexp.prototype.flags-1.5.4.tgz",
+      "integrity": "sha512-dYqgNSZbDwkaJ2ceRd9ojCGjBq+mOm9LmtXnAnEGyHhN/5R7iDW2TRw3h+o/jCFxus3P2LfWIIiwowAjANm7IA==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "define-properties": "^1.2.1",
+        "es-errors": "^1.3.0",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "set-function-name": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/resolve": {
+      "version": "1.22.11",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.11.tgz",
+      "integrity": "sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==",
+      "dev": true,
+      "dependencies": {
+        "is-core-module": "^2.16.1",
+        "path-parse": "^1.0.7",
+        "supports-preserve-symlinks-flag": "^1.0.0"
+      },
+      "bin": {
+        "resolve": "bin/resolve"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/resolve-from": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz",
+      "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==",
+      "dev": true,
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/resolve-pkg-maps": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz",
+      "integrity": "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==",
+      "dev": true,
+      "funding": {
+        "url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1"
+      }
+    },
+    "node_modules/reusify": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz",
+      "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==",
+      "dev": true,
+      "engines": {
+        "iojs": ">=1.0.0",
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/run-parallel": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz",
+      "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "dependencies": {
+        "queue-microtask": "^1.2.2"
+      }
+    },
+    "node_modules/safe-array-concat": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/safe-array-concat/-/safe-array-concat-1.1.3.tgz",
+      "integrity": "sha512-AURm5f0jYEOydBj7VQlVvDrjeFgthDdEF5H1dP+6mNpoXOMo1quQqJ4wvJDyRZ9+pO3kGWoOdmV08cSv2aJV6Q==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.2",
+        "get-intrinsic": "^1.2.6",
+        "has-symbols": "^1.1.0",
+        "isarray": "^2.0.5"
+      },
+      "engines": {
+        "node": ">=0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/safe-push-apply": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/safe-push-apply/-/safe-push-apply-1.0.0.tgz",
+      "integrity": "sha512-iKE9w/Z7xCzUMIZqdBsp6pEQvwuEebH4vdpjcDWnyzaI6yl6O9FHvVpmGelvEHNsoY6wGblkxR6Zty/h00WiSA==",
+      "dev": true,
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "isarray": "^2.0.5"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/safe-regex-test": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/safe-regex-test/-/safe-regex-test-1.1.0.tgz",
+      "integrity": "sha512-x/+Cz4YrimQxQccJf5mKEbIa1NzeCRNI5Ecl/ekmlYaampdNLPalVyIcCZNNH3MvmqBugV5TMYZXv0ljslUlaw==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "is-regex": "^1.2.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/scheduler": {
+      "version": "0.26.0",
+      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.26.0.tgz",
+      "integrity": "sha512-NlHwttCI/l5gCPR3D1nNXtWABUmBwvZpEQiD4IXSbIDq8BzLIK/7Ir5gTFSGZDUu37K5cMNp0hFtzO38sC7gWA=="
+    },
+    "node_modules/semver": {
+      "version": "7.7.3",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz",
+      "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==",
+      "devOptional": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/set-function-length": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz",
+      "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==",
+      "dev": true,
+      "dependencies": {
+        "define-data-property": "^1.1.4",
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2",
+        "get-intrinsic": "^1.2.4",
+        "gopd": "^1.0.1",
+        "has-property-descriptors": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/set-function-name": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/set-function-name/-/set-function-name-2.0.2.tgz",
+      "integrity": "sha512-7PGFlmtwsEADb0WYyvCMa1t+yke6daIG4Wirafur5kcf+MhUnPms1UeR0CKQdTZD81yESwMHbtn+TR+dMviakQ==",
+      "dev": true,
+      "dependencies": {
+        "define-data-property": "^1.1.4",
+        "es-errors": "^1.3.0",
+        "functions-have-names": "^1.2.3",
+        "has-property-descriptors": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/set-proto": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/set-proto/-/set-proto-1.0.0.tgz",
+      "integrity": "sha512-RJRdvCo6IAnPdsvP/7m6bsQqNnn1FCBX5ZNtFL98MmFF/4xAIJTIg1YbHW5DC2W5SKZanrC6i4HsJqlajw/dZw==",
+      "dev": true,
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/sharp": {
+      "version": "0.34.4",
+      "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.34.4.tgz",
+      "integrity": "sha512-FUH39xp3SBPnxWvd5iib1X8XY7J0K0X7d93sie9CJg2PO8/7gmg89Nve6OjItK53/MlAushNNxteBYfM6DEuoA==",
+      "hasInstallScript": true,
+      "optional": true,
+      "dependencies": {
+        "@img/colour": "^1.0.0",
+        "detect-libc": "^2.1.0",
+        "semver": "^7.7.2"
+      },
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-darwin-arm64": "0.34.4",
+        "@img/sharp-darwin-x64": "0.34.4",
+        "@img/sharp-libvips-darwin-arm64": "1.2.3",
+        "@img/sharp-libvips-darwin-x64": "1.2.3",
+        "@img/sharp-libvips-linux-arm": "1.2.3",
+        "@img/sharp-libvips-linux-arm64": "1.2.3",
+        "@img/sharp-libvips-linux-ppc64": "1.2.3",
+        "@img/sharp-libvips-linux-s390x": "1.2.3",
+        "@img/sharp-libvips-linux-x64": "1.2.3",
+        "@img/sharp-libvips-linuxmusl-arm64": "1.2.3",
+        "@img/sharp-libvips-linuxmusl-x64": "1.2.3",
+        "@img/sharp-linux-arm": "0.34.4",
+        "@img/sharp-linux-arm64": "0.34.4",
+        "@img/sharp-linux-ppc64": "0.34.4",
+        "@img/sharp-linux-s390x": "0.34.4",
+        "@img/sharp-linux-x64": "0.34.4",
+        "@img/sharp-linuxmusl-arm64": "0.34.4",
+        "@img/sharp-linuxmusl-x64": "0.34.4",
+        "@img/sharp-wasm32": "0.34.4",
+        "@img/sharp-win32-arm64": "0.34.4",
+        "@img/sharp-win32-ia32": "0.34.4",
+        "@img/sharp-win32-x64": "0.34.4"
+      }
+    },
+    "node_modules/shebang-command": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+      "dev": true,
+      "dependencies": {
+        "shebang-regex": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-regex": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/side-channel": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
+      "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
+      "dev": true,
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3",
+        "side-channel-list": "^1.0.0",
+        "side-channel-map": "^1.0.1",
+        "side-channel-weakmap": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-list": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz",
+      "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==",
+      "dev": true,
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-map": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
+      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-weakmap": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
+      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3",
+        "side-channel-map": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/stable-hash": {
+      "version": "0.0.5",
+      "resolved": "https://registry.npmjs.org/stable-hash/-/stable-hash-0.0.5.tgz",
+      "integrity": "sha512-+L3ccpzibovGXFK+Ap/f8LOS0ahMrHTf3xu7mMLSpEGU0EO9ucaysSylKo9eRDFNhWve/y275iPmIZ4z39a9iA==",
+      "dev": true
+    },
+    "node_modules/stop-iteration-iterator": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/stop-iteration-iterator/-/stop-iteration-iterator-1.1.0.tgz",
+      "integrity": "sha512-eLoXW/DHyl62zxY4SCaIgnRhuMr6ri4juEYARS8E6sCEqzKpOiE521Ucofdx+KnDZl5xmvGYaaKCk5FEOxJCoQ==",
+      "dev": true,
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "internal-slot": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/string.prototype.includes": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/string.prototype.includes/-/string.prototype.includes-2.0.1.tgz",
+      "integrity": "sha512-o7+c9bW6zpAdJHTtujeePODAhkuicdAryFsfVKwA+wGw89wJ4GTY484WTucM9hLtDEOpOvI+aHnzqnC5lHp4Rg==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.7",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/string.prototype.matchall": {
+      "version": "4.0.12",
+      "resolved": "https://registry.npmjs.org/string.prototype.matchall/-/string.prototype.matchall-4.0.12.tgz",
+      "integrity": "sha512-6CC9uyBL+/48dYizRf7H7VAYCMCNTBeM78x/VTUe9bFEaxBepPJDa1Ow99LqI/1yF7kuy7Q3cQsYMrcjGUcskA==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.3",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.6",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.0.0",
+        "get-intrinsic": "^1.2.6",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "internal-slot": "^1.1.0",
+        "regexp.prototype.flags": "^1.5.3",
+        "set-function-name": "^2.0.2",
+        "side-channel": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/string.prototype.repeat": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/string.prototype.repeat/-/string.prototype.repeat-1.0.0.tgz",
+      "integrity": "sha512-0u/TldDbKD8bFCQ/4f5+mNRrXwZ8hg2w7ZR8wa16e8z9XpePWl3eGEcUD0OXpEH/VJH/2G3gjUtR3ZOiBe2S/w==",
+      "dev": true,
+      "dependencies": {
+        "define-properties": "^1.1.3",
+        "es-abstract": "^1.17.5"
+      }
+    },
+    "node_modules/string.prototype.trim": {
+      "version": "1.2.10",
+      "resolved": "https://registry.npmjs.org/string.prototype.trim/-/string.prototype.trim-1.2.10.tgz",
+      "integrity": "sha512-Rs66F0P/1kedk5lyYyH9uBzuiI/kNRmwJAR9quK6VOtIpZ2G+hMZd+HQbbv25MgCA6gEffoMZYxlTod4WcdrKA==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.2",
+        "define-data-property": "^1.1.4",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.5",
+        "es-object-atoms": "^1.0.0",
+        "has-property-descriptors": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/string.prototype.trimend": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/string.prototype.trimend/-/string.prototype.trimend-1.0.9.tgz",
+      "integrity": "sha512-G7Ok5C6E/j4SGfyLCloXTrngQIQU3PWtXGst3yM7Bea9FRURf1S42ZHlZZtsNque2FN2PoUhfZXYLNWwEr4dLQ==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.2",
+        "define-properties": "^1.2.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/string.prototype.trimstart": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/string.prototype.trimstart/-/string.prototype.trimstart-1.0.8.tgz",
+      "integrity": "sha512-UXSH262CSZY1tfu3G3Secr6uGLCFVPMhIqHjlgCUtCCcgihYc/xKs9djMTMUOb2j1mVSeU8EU6NWc/iQKU6Gfg==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.7",
+        "define-properties": "^1.2.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/strip-bom": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz",
+      "integrity": "sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==",
+      "dev": true,
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/strip-json-comments": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz",
+      "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/styled-jsx": {
+      "version": "5.1.6",
+      "resolved": "https://registry.npmjs.org/styled-jsx/-/styled-jsx-5.1.6.tgz",
+      "integrity": "sha512-qSVyDTeMotdvQYoHWLNGwRFJHC+i+ZvdBRYosOFgC+Wg1vx4frN2/RG/NA7SYqqvKNLf39P2LSRA2pu6n0XYZA==",
+      "dependencies": {
+        "client-only": "0.0.1"
+      },
+      "engines": {
+        "node": ">= 12.0.0"
+      },
+      "peerDependencies": {
+        "react": ">= 16.8.0 || 17.x.x || ^18.0.0-0 || ^19.0.0-0"
+      },
+      "peerDependenciesMeta": {
+        "@babel/core": {
+          "optional": true
+        },
+        "babel-plugin-macros": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/supports-color": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+      "dev": true,
+      "dependencies": {
+        "has-flag": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/supports-preserve-symlinks-flag": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz",
+      "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/tinyglobby": {
+      "version": "0.2.15",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
+      "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
+      "dev": true,
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/tinyglobby/node_modules/fdir": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+      "dev": true,
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/tinyglobby/node_modules/picomatch": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
+      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
+      "dev": true,
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/to-regex-range": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
+      "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
+      "dev": true,
+      "dependencies": {
+        "is-number": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=8.0"
+      }
+    },
+    "node_modules/ts-api-utils": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.1.0.tgz",
+      "integrity": "sha512-CUgTZL1irw8u29bzrOD/nH85jqyc74D6SshFgujOIA7osm2Rz7dYH77agkx7H4FBNxDq7Cjf+IjaX/8zwFW+ZQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=18.12"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.8.4"
+      }
+    },
+    "node_modules/tsconfig-paths": {
+      "version": "3.15.0",
+      "resolved": "https://registry.npmjs.org/tsconfig-paths/-/tsconfig-paths-3.15.0.tgz",
+      "integrity": "sha512-2Ac2RgzDe/cn48GvOe3M+o82pEFewD3UPbyoUHHdKasHwJKjds4fLXWf/Ux5kATBKN20oaFGu+jbElp1pos0mg==",
+      "dev": true,
+      "dependencies": {
+        "@types/json5": "^0.0.29",
+        "json5": "^1.0.2",
+        "minimist": "^1.2.6",
+        "strip-bom": "^3.0.0"
+      }
+    },
+    "node_modules/tslib": {
+      "version": "2.8.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="
+    },
+    "node_modules/type-check": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz",
+      "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==",
+      "dev": true,
+      "dependencies": {
+        "prelude-ls": "^1.2.1"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/typed-array-buffer": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/typed-array-buffer/-/typed-array-buffer-1.0.3.tgz",
+      "integrity": "sha512-nAYYwfY3qnzX30IkA6AQZjVbtK6duGontcQm1WSG1MD94YLqK0515GNApXkoxKOWMusVssAHWLh9SeaoefYFGw==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "es-errors": "^1.3.0",
+        "is-typed-array": "^1.1.14"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/typed-array-byte-length": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/typed-array-byte-length/-/typed-array-byte-length-1.0.3.tgz",
+      "integrity": "sha512-BaXgOuIxz8n8pIq3e7Atg/7s+DpiYrxn4vdot3w9KbnBhcRQq6o3xemQdIfynqSeXeDrF32x+WvfzmOjPiY9lg==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "for-each": "^0.3.3",
+        "gopd": "^1.2.0",
+        "has-proto": "^1.2.0",
+        "is-typed-array": "^1.1.14"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/typed-array-byte-offset": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/typed-array-byte-offset/-/typed-array-byte-offset-1.0.4.tgz",
+      "integrity": "sha512-bTlAFB/FBYMcuX81gbL4OcpH5PmlFHqlCCpAl8AlEzMz5k53oNDvN8p1PNOWLEmI2x4orp3raOFB51tv9X+MFQ==",
+      "dev": true,
+      "dependencies": {
+        "available-typed-arrays": "^1.0.7",
+        "call-bind": "^1.0.8",
+        "for-each": "^0.3.3",
+        "gopd": "^1.2.0",
+        "has-proto": "^1.2.0",
+        "is-typed-array": "^1.1.15",
+        "reflect.getprototypeof": "^1.0.9"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/typed-array-length": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/typed-array-length/-/typed-array-length-1.0.7.tgz",
+      "integrity": "sha512-3KS2b+kL7fsuk/eJZ7EQdnEmQoaho/r6KUef7hxvltNA5DR8NAUM+8wJMbJyZ4G9/7i3v5zPBIMN5aybAh2/Jg==",
+      "dev": true,
+      "dependencies": {
+        "call-bind": "^1.0.7",
+        "for-each": "^0.3.3",
+        "gopd": "^1.0.1",
+        "is-typed-array": "^1.1.13",
+        "possible-typed-array-names": "^1.0.0",
+        "reflect.getprototypeof": "^1.0.6"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.9.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+      "dev": true,
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/unbox-primitive": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/unbox-primitive/-/unbox-primitive-1.1.0.tgz",
+      "integrity": "sha512-nWJ91DjeOkej/TA8pXQ3myruKpKEYgqvpw9lz4OPHj/NWFNluYrjbz9j01CJ8yKQd2g4jFoOkINCTW2I5LEEyw==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "has-bigints": "^1.0.2",
+        "has-symbols": "^1.1.0",
+        "which-boxed-primitive": "^1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "dev": true
+    },
+    "node_modules/unrs-resolver": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/unrs-resolver/-/unrs-resolver-1.11.1.tgz",
+      "integrity": "sha512-bSjt9pjaEBnNiGgc9rUiHGKv5l4/TGzDmYw3RhnkJGtLhbnnA/5qJj7x3dNDCRx/PJxu774LlH8lCOlB4hEfKg==",
+      "dev": true,
+      "hasInstallScript": true,
+      "dependencies": {
+        "napi-postinstall": "^0.3.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/unrs-resolver"
+      },
+      "optionalDependencies": {
+        "@unrs/resolver-binding-android-arm-eabi": "1.11.1",
+        "@unrs/resolver-binding-android-arm64": "1.11.1",
+        "@unrs/resolver-binding-darwin-arm64": "1.11.1",
+        "@unrs/resolver-binding-darwin-x64": "1.11.1",
+        "@unrs/resolver-binding-freebsd-x64": "1.11.1",
+        "@unrs/resolver-binding-linux-arm-gnueabihf": "1.11.1",
+        "@unrs/resolver-binding-linux-arm-musleabihf": "1.11.1",
+        "@unrs/resolver-binding-linux-arm64-gnu": "1.11.1",
+        "@unrs/resolver-binding-linux-arm64-musl": "1.11.1",
+        "@unrs/resolver-binding-linux-ppc64-gnu": "1.11.1",
+        "@unrs/resolver-binding-linux-riscv64-gnu": "1.11.1",
+        "@unrs/resolver-binding-linux-riscv64-musl": "1.11.1",
+        "@unrs/resolver-binding-linux-s390x-gnu": "1.11.1",
+        "@unrs/resolver-binding-linux-x64-gnu": "1.11.1",
+        "@unrs/resolver-binding-linux-x64-musl": "1.11.1",
+        "@unrs/resolver-binding-wasm32-wasi": "1.11.1",
+        "@unrs/resolver-binding-win32-arm64-msvc": "1.11.1",
+        "@unrs/resolver-binding-win32-ia32-msvc": "1.11.1",
+        "@unrs/resolver-binding-win32-x64-msvc": "1.11.1"
+      }
+    },
+    "node_modules/uri-js": {
+      "version": "4.4.1",
+      "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz",
+      "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==",
+      "dev": true,
+      "dependencies": {
+        "punycode": "^2.1.0"
+      }
+    },
+    "node_modules/which": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+      "dev": true,
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "node-which": "bin/node-which"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/which-boxed-primitive": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/which-boxed-primitive/-/which-boxed-primitive-1.1.1.tgz",
+      "integrity": "sha512-TbX3mj8n0odCBFVlY8AxkqcHASw3L60jIuF8jFP78az3C2YhmGvqbHBpAjTRH2/xqYunrJ9g1jSyjCjpoWzIAA==",
+      "dev": true,
+      "dependencies": {
+        "is-bigint": "^1.1.0",
+        "is-boolean-object": "^1.2.1",
+        "is-number-object": "^1.1.1",
+        "is-string": "^1.1.1",
+        "is-symbol": "^1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/which-builtin-type": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/which-builtin-type/-/which-builtin-type-1.2.1.tgz",
+      "integrity": "sha512-6iBczoX+kDQ7a3+YJBnh3T+KZRxM/iYNPXicqk66/Qfm1b93iu+yOImkg0zHbj5LNOcNv1TEADiZ0xa34B4q6Q==",
+      "dev": true,
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "function.prototype.name": "^1.1.6",
+        "has-tostringtag": "^1.0.2",
+        "is-async-function": "^2.0.0",
+        "is-date-object": "^1.1.0",
+        "is-finalizationregistry": "^1.1.0",
+        "is-generator-function": "^1.0.10",
+        "is-regex": "^1.2.1",
+        "is-weakref": "^1.0.2",
+        "isarray": "^2.0.5",
+        "which-boxed-primitive": "^1.1.0",
+        "which-collection": "^1.0.2",
+        "which-typed-array": "^1.1.16"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/which-collection": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/which-collection/-/which-collection-1.0.2.tgz",
+      "integrity": "sha512-K4jVyjnBdgvc86Y6BkaLZEN933SwYOuBFkdmBu9ZfkcAbdVbpITnDmjvZ/aQjRXQrv5EPkTnD1s39GiiqbngCw==",
+      "dev": true,
+      "dependencies": {
+        "is-map": "^2.0.3",
+        "is-set": "^2.0.3",
+        "is-weakmap": "^2.0.2",
+        "is-weakset": "^2.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/which-typed-array": {
+      "version": "1.1.19",
+      "resolved": "https://registry.npmjs.org/which-typed-array/-/which-typed-array-1.1.19.tgz",
+      "integrity": "sha512-rEvr90Bck4WZt9HHFC4DJMsjvu7x+r6bImz0/BrbWb7A2djJ8hnZMrWnHo9F8ssv0OMErasDhftrfROTyqSDrw==",
+      "dev": true,
+      "dependencies": {
+        "available-typed-arrays": "^1.0.7",
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.4",
+        "for-each": "^0.3.5",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-tostringtag": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/word-wrap": {
+      "version": "1.2.5",
+      "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz",
+      "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/yocto-queue": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",
+      "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==",
+      "dev": true,
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    }
+  }
+}
diff --git a/server/express/package-lock.json b/server/express/package-lock.json
new file mode 100644
index 0000000..c9b2554
--- /dev/null
+++ b/server/express/package-lock.json
@@ -0,0 +1,4748 @@
+{
+  "name": "sample-mflix-express-backend",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "sample-mflix-express-backend",
+      "version": "1.0.0",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "cors": "^2.8.5",
+        "dotenv": "^16.3.1",
+        "express": "^5.1.0",
+        "mongodb": "^6.3.0"
+      },
+      "devDependencies": {
+        "@types/cors": "^2.8.17",
+        "@types/express": "^4.17.21",
+        "@types/jest": "^29.5.14",
+        "@types/node": "^20.10.5",
+        "jest": "^29.7.0",
+        "ts-jest": "^29.1.1",
+        "ts-node": "^10.9.2",
+        "typescript": "^5.3.3"
+      }
+    },
+    "node_modules/@babel/code-frame": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz",
+      "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-validator-identifier": "^7.27.1",
+        "js-tokens": "^4.0.0",
+        "picocolors": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/compat-data": {
+      "version": "7.28.4",
+      "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.4.tgz",
+      "integrity": "sha512-YsmSKC29MJwf0gF8Rjjrg5LQCmyh+j/nD8/eP7f+BeoQTKYqs9RoWbjGOdy0+1Ekr68RJZMUOPVQaQisnIo4Rw==",
+      "dev": true,
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/core": {
+      "version": "7.28.4",
+      "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.4.tgz",
+      "integrity": "sha512-2BCOP7TN8M+gVDj7/ht3hsaO/B/n5oDbiAyyvnRlNOs+u1o+JWNYTQrmpuNp1/Wq2gcFrI01JAW+paEKDMx/CA==",
+      "dev": true,
+      "dependencies": {
+        "@babel/code-frame": "^7.27.1",
+        "@babel/generator": "^7.28.3",
+        "@babel/helper-compilation-targets": "^7.27.2",
+        "@babel/helper-module-transforms": "^7.28.3",
+        "@babel/helpers": "^7.28.4",
+        "@babel/parser": "^7.28.4",
+        "@babel/template": "^7.27.2",
+        "@babel/traverse": "^7.28.4",
+        "@babel/types": "^7.28.4",
+        "@jridgewell/remapping": "^2.3.5",
+        "convert-source-map": "^2.0.0",
+        "debug": "^4.1.0",
+        "gensync": "^1.0.0-beta.2",
+        "json5": "^2.2.3",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/babel"
+      }
+    },
+    "node_modules/@babel/generator": {
+      "version": "7.28.3",
+      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.3.tgz",
+      "integrity": "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw==",
+      "dev": true,
+      "dependencies": {
+        "@babel/parser": "^7.28.3",
+        "@babel/types": "^7.28.2",
+        "@jridgewell/gen-mapping": "^0.3.12",
+        "@jridgewell/trace-mapping": "^0.3.28",
+        "jsesc": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/generator/node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.31",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+      "dev": true,
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.1.0",
+        "@jridgewell/sourcemap-codec": "^1.4.14"
+      }
+    },
+    "node_modules/@babel/helper-compilation-targets": {
+      "version": "7.27.2",
+      "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.2.tgz",
+      "integrity": "sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==",
+      "dev": true,
+      "dependencies": {
+        "@babel/compat-data": "^7.27.2",
+        "@babel/helper-validator-option": "^7.27.1",
+        "browserslist": "^4.24.0",
+        "lru-cache": "^5.1.1",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-globals": {
+      "version": "7.28.0",
+      "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz",
+      "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==",
+      "dev": true,
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-module-imports": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.27.1.tgz",
+      "integrity": "sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==",
+      "dev": true,
+      "dependencies": {
+        "@babel/traverse": "^7.27.1",
+        "@babel/types": "^7.27.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-module-transforms": {
+      "version": "7.28.3",
+      "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.3.tgz",
+      "integrity": "sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-module-imports": "^7.27.1",
+        "@babel/helper-validator-identifier": "^7.27.1",
+        "@babel/traverse": "^7.28.3"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-plugin-utils": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.27.1.tgz",
+      "integrity": "sha512-1gn1Up5YXka3YYAHGKpbideQ5Yjf1tDa9qYcgysz+cNCXukyLl6DjPXhD3VRwSb8c0J9tA4b2+rHEZtc6R0tlw==",
+      "dev": true,
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-string-parser": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz",
+      "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==",
+      "dev": true,
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-identifier": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.27.1.tgz",
+      "integrity": "sha512-D2hP9eA+Sqx1kBZgzxZh0y1trbuU+JoDkiEwqhQ36nodYqJwyEIhPSdMNd7lOm/4io72luTPWH20Yda0xOuUow==",
+      "dev": true,
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-option": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz",
+      "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==",
+      "dev": true,
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helpers": {
+      "version": "7.28.4",
+      "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.4.tgz",
+      "integrity": "sha512-HFN59MmQXGHVyYadKLVumYsA9dBFun/ldYxipEjzA4196jpLZd8UjEEBLkbEkvfYreDqJhZxYAWFPtrfhNpj4w==",
+      "dev": true,
+      "dependencies": {
+        "@babel/template": "^7.27.2",
+        "@babel/types": "^7.28.4"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/parser": {
+      "version": "7.28.4",
+      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.4.tgz",
+      "integrity": "sha512-yZbBqeM6TkpP9du/I2pUZnJsRMGGvOuIrhjzC1AwHwW+6he4mni6Bp/m8ijn0iOuZuPI2BfkCoSRunpyjnrQKg==",
+      "dev": true,
+      "dependencies": {
+        "@babel/types": "^7.28.4"
+      },
+      "bin": {
+        "parser": "bin/babel-parser.js"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-async-generators": {
+      "version": "7.8.4",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-async-generators/-/plugin-syntax-async-generators-7.8.4.tgz",
+      "integrity": "sha512-tycmZxkGfZaxhMRbXlPXuVFpdWlXpir2W4AMhSJgRKzk/eDlIXOhb2LHWoLpDF7TEHylV5zNhykX6KAgHJmTNw==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.8.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-bigint": {
+      "version": "7.8.3",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-bigint/-/plugin-syntax-bigint-7.8.3.tgz",
+      "integrity": "sha512-wnTnFlG+YxQm3vDxpGE57Pj0srRU4sHE/mDkt1qv2YJJSeUAec2ma4WLUnUPeKjyrfntVwe/N6dCXpU+zL3Npg==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.8.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-class-properties": {
+      "version": "7.12.13",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-properties/-/plugin-syntax-class-properties-7.12.13.tgz",
+      "integrity": "sha512-fm4idjKla0YahUNgFNLCB0qySdsoPiZP3iQE3rky0mBUtMZ23yDJ9SJdg6dXTSDnulOVqiF3Hgr9nbXvXTQZYA==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.12.13"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-class-static-block": {
+      "version": "7.14.5",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-static-block/-/plugin-syntax-class-static-block-7.14.5.tgz",
+      "integrity": "sha512-b+YyPmr6ldyNnM6sqYeMWE+bgJcJpO6yS4QD7ymxgH34GBPNDM/THBh8iunyvKIZztiwLH4CJZ0RxTk9emgpjw==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.14.5"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-import-attributes": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.27.1.tgz",
+      "integrity": "sha512-oFT0FrKHgF53f4vOsZGi2Hh3I35PfSmVs4IBFLFj4dnafP+hIWDLg3VyKmUHfLoLHlyxY4C7DGtmHuJgn+IGww==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.27.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-import-meta": {
+      "version": "7.10.4",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-meta/-/plugin-syntax-import-meta-7.10.4.tgz",
+      "integrity": "sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.10.4"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-json-strings": {
+      "version": "7.8.3",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-json-strings/-/plugin-syntax-json-strings-7.8.3.tgz",
+      "integrity": "sha512-lY6kdGpWHvjoe2vk4WrAapEuBR69EMxZl+RoGRhrFGNYVK8mOPAW8VfbT/ZgrFbXlDNiiaxQnAtgVCZ6jv30EA==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.8.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-jsx": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.27.1.tgz",
+      "integrity": "sha512-y8YTNIeKoyhGd9O0Jiyzyyqk8gdjnumGTQPsz0xOZOQ2RmkVJeZ1vmmfIvFEKqucBG6axJGBZDE/7iI5suUI/w==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.27.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-logical-assignment-operators": {
+      "version": "7.10.4",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-logical-assignment-operators/-/plugin-syntax-logical-assignment-operators-7.10.4.tgz",
+      "integrity": "sha512-d8waShlpFDinQ5MtvGU9xDAOzKH47+FFoney2baFIoMr952hKOLp1HR7VszoZvOsV/4+RRszNY7D17ba0te0ig==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.10.4"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-nullish-coalescing-operator": {
+      "version": "7.8.3",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-nullish-coalescing-operator/-/plugin-syntax-nullish-coalescing-operator-7.8.3.tgz",
+      "integrity": "sha512-aSff4zPII1u2QD7y+F8oDsz19ew4IGEJg9SVW+bqwpwtfFleiQDMdzA/R+UlWDzfnHFCxxleFT0PMIrR36XLNQ==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.8.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-numeric-separator": {
+      "version": "7.10.4",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-numeric-separator/-/plugin-syntax-numeric-separator-7.10.4.tgz",
+      "integrity": "sha512-9H6YdfkcK/uOnY/K7/aA2xpzaAgkQn37yzWUMRK7OaPOqOpGS1+n0H5hxT9AUw9EsSjPW8SVyMJwYRtWs3X3ug==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.10.4"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-object-rest-spread": {
+      "version": "7.8.3",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-object-rest-spread/-/plugin-syntax-object-rest-spread-7.8.3.tgz",
+      "integrity": "sha512-XoqMijGZb9y3y2XskN+P1wUGiVwWZ5JmoDRwx5+3GmEplNyVM2s2Dg8ILFQm8rWM48orGy5YpI5Bl8U1y7ydlA==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.8.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-optional-catch-binding": {
+      "version": "7.8.3",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-catch-binding/-/plugin-syntax-optional-catch-binding-7.8.3.tgz",
+      "integrity": "sha512-6VPD0Pc1lpTqw0aKoeRTMiB+kWhAoT24PA+ksWSBrFtl5SIRVpZlwN3NNPQjehA2E/91FV3RjLWoVTglWcSV3Q==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.8.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-optional-chaining": {
+      "version": "7.8.3",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-chaining/-/plugin-syntax-optional-chaining-7.8.3.tgz",
+      "integrity": "sha512-KoK9ErH1MBlCPxV0VANkXW2/dw4vlbGDrFgz8bmUsBGYkFRcbRwMh6cIJubdPrkxRwuGdtCk0v/wPTKbQgBjkg==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.8.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-private-property-in-object": {
+      "version": "7.14.5",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-private-property-in-object/-/plugin-syntax-private-property-in-object-7.14.5.tgz",
+      "integrity": "sha512-0wVnp9dxJ72ZUJDV27ZfbSj6iHLoytYZmh3rFcxNnvsJF3ktkzLDZPy/mA17HGsaQT3/DQsWYX1f1QGWkCoVUg==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.14.5"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-top-level-await": {
+      "version": "7.14.5",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-top-level-await/-/plugin-syntax-top-level-await-7.14.5.tgz",
+      "integrity": "sha512-hx++upLv5U1rgYfwe1xBQUhRmU41NEvpUvrp8jkrSCdvGSnM5/qdRMtylJ6PG5OFkBaHkbTAKTnd3/YyESRHFw==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.14.5"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-typescript": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.27.1.tgz",
+      "integrity": "sha512-xfYCBMxveHrRMnAWl1ZlPXOZjzkN82THFvLhQhFXFt81Z5HnN+EtUkZhv/zcKpmT3fzmWZB0ywiBrbC3vogbwQ==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.27.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/template": {
+      "version": "7.27.2",
+      "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.27.2.tgz",
+      "integrity": "sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==",
+      "dev": true,
+      "dependencies": {
+        "@babel/code-frame": "^7.27.1",
+        "@babel/parser": "^7.27.2",
+        "@babel/types": "^7.27.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/traverse": {
+      "version": "7.28.4",
+      "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.4.tgz",
+      "integrity": "sha512-YEzuboP2qvQavAcjgQNVgsvHIDv6ZpwXvcvjmyySP2DIMuByS/6ioU5G9pYrWHM6T2YDfc7xga9iNzYOs12CFQ==",
+      "dev": true,
+      "dependencies": {
+        "@babel/code-frame": "^7.27.1",
+        "@babel/generator": "^7.28.3",
+        "@babel/helper-globals": "^7.28.0",
+        "@babel/parser": "^7.28.4",
+        "@babel/template": "^7.27.2",
+        "@babel/types": "^7.28.4",
+        "debug": "^4.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/types": {
+      "version": "7.28.4",
+      "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.4.tgz",
+      "integrity": "sha512-bkFqkLhh3pMBUQQkpVgWDWq/lqzc2678eUyDlTBhRqhCHFguYYGM0Efga7tYk4TogG/3x0EEl66/OQ+WGbWB/Q==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-string-parser": "^7.27.1",
+        "@babel/helper-validator-identifier": "^7.27.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@bcoe/v8-coverage": {
+      "version": "0.2.3",
+      "resolved": "https://registry.npmjs.org/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz",
+      "integrity": "sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==",
+      "dev": true
+    },
+    "node_modules/@cspotcode/source-map-support": {
+      "version": "0.8.1",
+      "resolved": "https://registry.npmjs.org/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz",
+      "integrity": "sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==",
+      "dev": true,
+      "dependencies": {
+        "@jridgewell/trace-mapping": "0.3.9"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@istanbuljs/load-nyc-config": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@istanbuljs/load-nyc-config/-/load-nyc-config-1.1.0.tgz",
+      "integrity": "sha512-VjeHSlIzpv/NyD3N0YuHfXOPDIixcA1q2ZV98wsMqcYlPmv2n3Yb2lYP9XMElnaFVXg5A7YLTeLu6V84uQDjmQ==",
+      "dev": true,
+      "dependencies": {
+        "camelcase": "^5.3.1",
+        "find-up": "^4.1.0",
+        "get-package-type": "^0.1.0",
+        "js-yaml": "^3.13.1",
+        "resolve-from": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/@istanbuljs/schema": {
+      "version": "0.1.3",
+      "resolved": "https://registry.npmjs.org/@istanbuljs/schema/-/schema-0.1.3.tgz",
+      "integrity": "sha512-ZXRY4jNvVgSVQ8DL3LTcakaAtXwTVUxE81hslsyD2AtoXW/wVob10HkOJ1X/pAlcI7D+2YoZKg5do8G/w6RYgA==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/@jest/console": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/@jest/console/-/console-29.7.0.tgz",
+      "integrity": "sha512-5Ni4CU7XHQi32IJ398EEP4RrB8eV09sXP2ROqD4bksHrnTree52PsxvX8tpL8LvTZ3pFzXyPbNQReSN41CAhOg==",
+      "dev": true,
+      "dependencies": {
+        "@jest/types": "^29.6.3",
+        "@types/node": "*",
+        "chalk": "^4.0.0",
+        "jest-message-util": "^29.7.0",
+        "jest-util": "^29.7.0",
+        "slash": "^3.0.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/@jest/core": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/@jest/core/-/core-29.7.0.tgz",
+      "integrity": "sha512-n7aeXWKMnGtDA48y8TLWJPJmLmmZ642Ceo78cYWEpiD7FzDgmNDV/GCVRorPABdXLJZ/9wzzgZAlHjXjxDHGsg==",
+      "dev": true,
+      "dependencies": {
+        "@jest/console": "^29.7.0",
+        "@jest/reporters": "^29.7.0",
+        "@jest/test-result": "^29.7.0",
+        "@jest/transform": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "@types/node": "*",
+        "ansi-escapes": "^4.2.1",
+        "chalk": "^4.0.0",
+        "ci-info": "^3.2.0",
+        "exit": "^0.1.2",
+        "graceful-fs": "^4.2.9",
+        "jest-changed-files": "^29.7.0",
+        "jest-config": "^29.7.0",
+        "jest-haste-map": "^29.7.0",
+        "jest-message-util": "^29.7.0",
+        "jest-regex-util": "^29.6.3",
+        "jest-resolve": "^29.7.0",
+        "jest-resolve-dependencies": "^29.7.0",
+        "jest-runner": "^29.7.0",
+        "jest-runtime": "^29.7.0",
+        "jest-snapshot": "^29.7.0",
+        "jest-util": "^29.7.0",
+        "jest-validate": "^29.7.0",
+        "jest-watcher": "^29.7.0",
+        "micromatch": "^4.0.4",
+        "pretty-format": "^29.7.0",
+        "slash": "^3.0.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      },
+      "peerDependencies": {
+        "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0"
+      },
+      "peerDependenciesMeta": {
+        "node-notifier": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@jest/environment": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/@jest/environment/-/environment-29.7.0.tgz",
+      "integrity": "sha512-aQIfHDq33ExsN4jP1NWGXhxgQ/wixs60gDiKO+XVMd8Mn0NWPWgc34ZQDTb2jKaUWQ7MuwoitXAsN2XVXNMpAw==",
+      "dev": true,
+      "dependencies": {
+        "@jest/fake-timers": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "@types/node": "*",
+        "jest-mock": "^29.7.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/@jest/expect": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/@jest/expect/-/expect-29.7.0.tgz",
+      "integrity": "sha512-8uMeAMycttpva3P1lBHB8VciS9V0XAr3GymPpipdyQXbBcuhkLQOSe8E/p92RyAdToS6ZD1tFkX+CkhoECE0dQ==",
+      "dev": true,
+      "dependencies": {
+        "expect": "^29.7.0",
+        "jest-snapshot": "^29.7.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/@jest/expect-utils": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/@jest/expect-utils/-/expect-utils-29.7.0.tgz",
+      "integrity": "sha512-GlsNBWiFQFCVi9QVSx7f5AgMeLxe9YCCs5PuP2O2LdjDAA8Jh9eX7lA1Jq/xdXw3Wb3hyvlFNfZIfcRetSzYcA==",
+      "dev": true,
+      "dependencies": {
+        "jest-get-type": "^29.6.3"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/@jest/fake-timers": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/@jest/fake-timers/-/fake-timers-29.7.0.tgz",
+      "integrity": "sha512-q4DH1Ha4TTFPdxLsqDXK1d3+ioSL7yL5oCMJZgDYm6i+6CygW5E5xVr/D1HdsGxjt1ZWSfUAs9OxSB/BNelWrQ==",
+      "dev": true,
+      "dependencies": {
+        "@jest/types": "^29.6.3",
+        "@sinonjs/fake-timers": "^10.0.2",
+        "@types/node": "*",
+        "jest-message-util": "^29.7.0",
+        "jest-mock": "^29.7.0",
+        "jest-util": "^29.7.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/@jest/globals": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/@jest/globals/-/globals-29.7.0.tgz",
+      "integrity": "sha512-mpiz3dutLbkW2MNFubUGUEVLkTGiqW6yLVTA+JbP6fI6J5iL9Y0Nlg8k95pcF8ctKwCS7WVxteBs29hhfAotzQ==",
+      "dev": true,
+      "dependencies": {
+        "@jest/environment": "^29.7.0",
+        "@jest/expect": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "jest-mock": "^29.7.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/@jest/reporters": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/@jest/reporters/-/reporters-29.7.0.tgz",
+      "integrity": "sha512-DApq0KJbJOEzAFYjHADNNxAE3KbhxQB1y5Kplb5Waqw6zVbuWatSnMjE5gs8FUgEPmNsnZA3NCWl9NG0ia04Pg==",
+      "dev": true,
+      "dependencies": {
+        "@bcoe/v8-coverage": "^0.2.3",
+        "@jest/console": "^29.7.0",
+        "@jest/test-result": "^29.7.0",
+        "@jest/transform": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "@jridgewell/trace-mapping": "^0.3.18",
+        "@types/node": "*",
+        "chalk": "^4.0.0",
+        "collect-v8-coverage": "^1.0.0",
+        "exit": "^0.1.2",
+        "glob": "^7.1.3",
+        "graceful-fs": "^4.2.9",
+        "istanbul-lib-coverage": "^3.0.0",
+        "istanbul-lib-instrument": "^6.0.0",
+        "istanbul-lib-report": "^3.0.0",
+        "istanbul-lib-source-maps": "^4.0.0",
+        "istanbul-reports": "^3.1.3",
+        "jest-message-util": "^29.7.0",
+        "jest-util": "^29.7.0",
+        "jest-worker": "^29.7.0",
+        "slash": "^3.0.0",
+        "string-length": "^4.0.1",
+        "strip-ansi": "^6.0.0",
+        "v8-to-istanbul": "^9.0.1"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      },
+      "peerDependencies": {
+        "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0"
+      },
+      "peerDependenciesMeta": {
+        "node-notifier": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@jest/reporters/node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.31",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+      "dev": true,
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.1.0",
+        "@jridgewell/sourcemap-codec": "^1.4.14"
+      }
+    },
+    "node_modules/@jest/schemas": {
+      "version": "29.6.3",
+      "resolved": "https://registry.npmjs.org/@jest/schemas/-/schemas-29.6.3.tgz",
+      "integrity": "sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==",
+      "dev": true,
+      "dependencies": {
+        "@sinclair/typebox": "^0.27.8"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/@jest/source-map": {
+      "version": "29.6.3",
+      "resolved": "https://registry.npmjs.org/@jest/source-map/-/source-map-29.6.3.tgz",
+      "integrity": "sha512-MHjT95QuipcPrpLM+8JMSzFx6eHp5Bm+4XeFDJlwsvVBjmKNiIAvasGK2fxz2WbGRlnvqehFbh07MMa7n3YJnw==",
+      "dev": true,
+      "dependencies": {
+        "@jridgewell/trace-mapping": "^0.3.18",
+        "callsites": "^3.0.0",
+        "graceful-fs": "^4.2.9"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/@jest/source-map/node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.31",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+      "dev": true,
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.1.0",
+        "@jridgewell/sourcemap-codec": "^1.4.14"
+      }
+    },
+    "node_modules/@jest/test-result": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/@jest/test-result/-/test-result-29.7.0.tgz",
+      "integrity": "sha512-Fdx+tv6x1zlkJPcWXmMDAG2HBnaR9XPSd5aDWQVsfrZmLVT3lU1cwyxLgRmXR9yrq4NBoEm9BMsfgFzTQAbJYA==",
+      "dev": true,
+      "dependencies": {
+        "@jest/console": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "@types/istanbul-lib-coverage": "^2.0.0",
+        "collect-v8-coverage": "^1.0.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/@jest/test-sequencer": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/@jest/test-sequencer/-/test-sequencer-29.7.0.tgz",
+      "integrity": "sha512-GQwJ5WZVrKnOJuiYiAF52UNUJXgTZx1NHjFSEB0qEMmSZKAkdMoIzw/Cj6x6NF4AvV23AUqDpFzQkN/eYCYTxw==",
+      "dev": true,
+      "dependencies": {
+        "@jest/test-result": "^29.7.0",
+        "graceful-fs": "^4.2.9",
+        "jest-haste-map": "^29.7.0",
+        "slash": "^3.0.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/@jest/transform": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/@jest/transform/-/transform-29.7.0.tgz",
+      "integrity": "sha512-ok/BTPFzFKVMwO5eOHRrvnBVHdRy9IrsrW1GpMaQ9MCnilNLXQKmAX8s1YXDFaai9xJpac2ySzV0YeRRECr2Vw==",
+      "dev": true,
+      "dependencies": {
+        "@babel/core": "^7.11.6",
+        "@jest/types": "^29.6.3",
+        "@jridgewell/trace-mapping": "^0.3.18",
+        "babel-plugin-istanbul": "^6.1.1",
+        "chalk": "^4.0.0",
+        "convert-source-map": "^2.0.0",
+        "fast-json-stable-stringify": "^2.1.0",
+        "graceful-fs": "^4.2.9",
+        "jest-haste-map": "^29.7.0",
+        "jest-regex-util": "^29.6.3",
+        "jest-util": "^29.7.0",
+        "micromatch": "^4.0.4",
+        "pirates": "^4.0.4",
+        "slash": "^3.0.0",
+        "write-file-atomic": "^4.0.2"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/@jest/transform/node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.31",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+      "dev": true,
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.1.0",
+        "@jridgewell/sourcemap-codec": "^1.4.14"
+      }
+    },
+    "node_modules/@jest/types": {
+      "version": "29.6.3",
+      "resolved": "https://registry.npmjs.org/@jest/types/-/types-29.6.3.tgz",
+      "integrity": "sha512-u3UPsIilWKOM3F9CXtrG8LEJmNxwoCQC/XVj4IKYXvvpx7QIi/Kg1LI5uDmDpKlac62NUtX7eLjRh+jVZcLOzw==",
+      "dev": true,
+      "dependencies": {
+        "@jest/schemas": "^29.6.3",
+        "@types/istanbul-lib-coverage": "^2.0.0",
+        "@types/istanbul-reports": "^3.0.0",
+        "@types/node": "*",
+        "@types/yargs": "^17.0.8",
+        "chalk": "^4.0.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/@jridgewell/gen-mapping": {
+      "version": "0.3.13",
+      "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz",
+      "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==",
+      "dev": true,
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.0",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/gen-mapping/node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.31",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+      "dev": true,
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.1.0",
+        "@jridgewell/sourcemap-codec": "^1.4.14"
+      }
+    },
+    "node_modules/@jridgewell/remapping": {
+      "version": "2.3.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz",
+      "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==",
+      "dev": true,
+      "dependencies": {
+        "@jridgewell/gen-mapping": "^0.3.5",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/remapping/node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.31",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+      "dev": true,
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.1.0",
+        "@jridgewell/sourcemap-codec": "^1.4.14"
+      }
+    },
+    "node_modules/@jridgewell/resolve-uri": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
+      "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
+      "dev": true,
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@jridgewell/sourcemap-codec": {
+      "version": "1.5.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
+      "dev": true
+    },
+    "node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.9",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz",
+      "integrity": "sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==",
+      "dev": true,
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.0.3",
+        "@jridgewell/sourcemap-codec": "^1.4.10"
+      }
+    },
+    "node_modules/@mongodb-js/saslprep": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/@mongodb-js/saslprep/-/saslprep-1.3.1.tgz",
+      "integrity": "sha512-6nZrq5kfAz0POWyhljnbWQQJQ5uT8oE2ddX303q1uY0tWsivWKgBDXBBvuFPwOqRRalXJuVO9EjOdVtuhLX0zg==",
+      "dependencies": {
+        "sparse-bitfield": "^3.0.3"
+      }
+    },
+    "node_modules/@sinclair/typebox": {
+      "version": "0.27.8",
+      "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.8.tgz",
+      "integrity": "sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA==",
+      "dev": true
+    },
+    "node_modules/@sinonjs/commons": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/@sinonjs/commons/-/commons-3.0.1.tgz",
+      "integrity": "sha512-K3mCHKQ9sVh8o1C9cxkwxaOmXoAMlDxC1mYyHrjqOWEcBjYr76t96zL2zlj5dUGZ3HSw240X1qgH3Mjf1yJWpQ==",
+      "dev": true,
+      "dependencies": {
+        "type-detect": "4.0.8"
+      }
+    },
+    "node_modules/@sinonjs/fake-timers": {
+      "version": "10.3.0",
+      "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-10.3.0.tgz",
+      "integrity": "sha512-V4BG07kuYSUkTCSBHG8G8TNhM+F19jXFWnQtzj+we8DrkpSBCee9Z3Ms8yiGer/dlmhe35/Xdgyo3/0rQKg7YA==",
+      "dev": true,
+      "dependencies": {
+        "@sinonjs/commons": "^3.0.0"
+      }
+    },
+    "node_modules/@tsconfig/node10": {
+      "version": "1.0.11",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.11.tgz",
+      "integrity": "sha512-DcRjDCujK/kCk/cUe8Xz8ZSpm8mS3mNNpta+jGCA6USEDfktlNvm1+IuZ9eTcDbNk41BHwpHHeW+N1lKCz4zOw==",
+      "dev": true
+    },
+    "node_modules/@tsconfig/node12": {
+      "version": "1.0.11",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node12/-/node12-1.0.11.tgz",
+      "integrity": "sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==",
+      "dev": true
+    },
+    "node_modules/@tsconfig/node14": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node14/-/node14-1.0.3.tgz",
+      "integrity": "sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==",
+      "dev": true
+    },
+    "node_modules/@tsconfig/node16": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node16/-/node16-1.0.4.tgz",
+      "integrity": "sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==",
+      "dev": true
+    },
+    "node_modules/@types/babel__core": {
+      "version": "7.20.5",
+      "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz",
+      "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==",
+      "dev": true,
+      "dependencies": {
+        "@babel/parser": "^7.20.7",
+        "@babel/types": "^7.20.7",
+        "@types/babel__generator": "*",
+        "@types/babel__template": "*",
+        "@types/babel__traverse": "*"
+      }
+    },
+    "node_modules/@types/babel__generator": {
+      "version": "7.27.0",
+      "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.27.0.tgz",
+      "integrity": "sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==",
+      "dev": true,
+      "dependencies": {
+        "@babel/types": "^7.0.0"
+      }
+    },
+    "node_modules/@types/babel__template": {
+      "version": "7.4.4",
+      "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz",
+      "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==",
+      "dev": true,
+      "dependencies": {
+        "@babel/parser": "^7.1.0",
+        "@babel/types": "^7.0.0"
+      }
+    },
+    "node_modules/@types/babel__traverse": {
+      "version": "7.28.0",
+      "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.28.0.tgz",
+      "integrity": "sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==",
+      "dev": true,
+      "dependencies": {
+        "@babel/types": "^7.28.2"
+      }
+    },
+    "node_modules/@types/body-parser": {
+      "version": "1.19.6",
+      "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.6.tgz",
+      "integrity": "sha512-HLFeCYgz89uk22N5Qg3dvGvsv46B8GLvKKo1zKG4NybA8U2DiEO3w9lqGg29t/tfLRJpJ6iQxnVw4OnB7MoM9g==",
+      "dev": true,
+      "dependencies": {
+        "@types/connect": "*",
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/connect": {
+      "version": "3.4.38",
+      "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.38.tgz",
+      "integrity": "sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==",
+      "dev": true,
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/cors": {
+      "version": "2.8.19",
+      "resolved": "https://registry.npmjs.org/@types/cors/-/cors-2.8.19.tgz",
+      "integrity": "sha512-mFNylyeyqN93lfe/9CSxOGREz8cpzAhH+E93xJ4xWQf62V8sQ/24reV2nyzUWM6H6Xji+GGHpkbLe7pVoUEskg==",
+      "dev": true,
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/express": {
+      "version": "4.17.23",
+      "resolved": "https://registry.npmjs.org/@types/express/-/express-4.17.23.tgz",
+      "integrity": "sha512-Crp6WY9aTYP3qPi2wGDo9iUe/rceX01UMhnF1jmwDcKCFM6cx7YhGP/Mpr3y9AASpfHixIG0E6azCcL5OcDHsQ==",
+      "dev": true,
+      "dependencies": {
+        "@types/body-parser": "*",
+        "@types/express-serve-static-core": "^4.17.33",
+        "@types/qs": "*",
+        "@types/serve-static": "*"
+      }
+    },
+    "node_modules/@types/express-serve-static-core": {
+      "version": "4.19.7",
+      "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-4.19.7.tgz",
+      "integrity": "sha512-FvPtiIf1LfhzsaIXhv/PHan/2FeQBbtBDtfX2QfvPxdUelMDEckK08SM6nqo1MIZY3RUlfA+HV8+hFUSio78qg==",
+      "dev": true,
+      "dependencies": {
+        "@types/node": "*",
+        "@types/qs": "*",
+        "@types/range-parser": "*",
+        "@types/send": "*"
+      }
+    },
+    "node_modules/@types/graceful-fs": {
+      "version": "4.1.9",
+      "resolved": "https://registry.npmjs.org/@types/graceful-fs/-/graceful-fs-4.1.9.tgz",
+      "integrity": "sha512-olP3sd1qOEe5dXTSaFvQG+02VdRXcdytWLAZsAq1PecU8uqQAhkrnbli7DagjtXKW/Bl7YJbUsa8MPcuc8LHEQ==",
+      "dev": true,
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/http-errors": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/@types/http-errors/-/http-errors-2.0.5.tgz",
+      "integrity": "sha512-r8Tayk8HJnX0FztbZN7oVqGccWgw98T/0neJphO91KkmOzug1KkofZURD4UaD5uH8AqcFLfdPErnBod0u71/qg==",
+      "dev": true
+    },
+    "node_modules/@types/istanbul-lib-coverage": {
+      "version": "2.0.6",
+      "resolved": "https://registry.npmjs.org/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.6.tgz",
+      "integrity": "sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==",
+      "dev": true
+    },
+    "node_modules/@types/istanbul-lib-report": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/@types/istanbul-lib-report/-/istanbul-lib-report-3.0.3.tgz",
+      "integrity": "sha512-NQn7AHQnk/RSLOxrBbGyJM/aVQ+pjj5HCgasFxc0K/KhoATfQ/47AyUl15I2yBUpihjmas+a+VJBOqecrFH+uA==",
+      "dev": true,
+      "dependencies": {
+        "@types/istanbul-lib-coverage": "*"
+      }
+    },
+    "node_modules/@types/istanbul-reports": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/@types/istanbul-reports/-/istanbul-reports-3.0.4.tgz",
+      "integrity": "sha512-pk2B1NWalF9toCRu6gjBzR69syFjP4Od8WRAX+0mmf9lAjCRicLOWc+ZrxZHx/0XRjotgkF9t6iaMJ+aXcOdZQ==",
+      "dev": true,
+      "dependencies": {
+        "@types/istanbul-lib-report": "*"
+      }
+    },
+    "node_modules/@types/jest": {
+      "version": "29.5.14",
+      "resolved": "https://registry.npmjs.org/@types/jest/-/jest-29.5.14.tgz",
+      "integrity": "sha512-ZN+4sdnLUbo8EVvVc2ao0GFW6oVrQRPn4K2lglySj7APvSrgzxHiNNK99us4WDMi57xxA2yggblIAMNhXOotLQ==",
+      "dev": true,
+      "dependencies": {
+        "expect": "^29.0.0",
+        "pretty-format": "^29.0.0"
+      }
+    },
+    "node_modules/@types/mime": {
+      "version": "1.3.5",
+      "resolved": "https://registry.npmjs.org/@types/mime/-/mime-1.3.5.tgz",
+      "integrity": "sha512-/pyBZWSLD2n0dcHE3hq8s8ZvcETHtEuF+3E7XVt0Ig2nvsVQXdghHVcEkIWjy9A0wKfTn97a/PSDYohKIlnP/w==",
+      "dev": true
+    },
+    "node_modules/@types/node": {
+      "version": "20.19.20",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.20.tgz",
+      "integrity": "sha512-2Q7WS25j4pS1cS8yw3d6buNCVJukOTeQ39bAnwR6sOJbaxvyCGebzTMypDFN82CxBLnl+lSWVdCCWbRY6y9yZQ==",
+      "dev": true,
+      "dependencies": {
+        "undici-types": "~6.21.0"
+      }
+    },
+    "node_modules/@types/qs": {
+      "version": "6.14.0",
+      "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.14.0.tgz",
+      "integrity": "sha512-eOunJqu0K1923aExK6y8p6fsihYEn/BYuQ4g0CxAAgFc4b/ZLN4CrsRZ55srTdqoiLzU2B2evC+apEIxprEzkQ==",
+      "dev": true
+    },
+    "node_modules/@types/range-parser": {
+      "version": "1.2.7",
+      "resolved": "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.7.tgz",
+      "integrity": "sha512-hKormJbkJqzQGhziax5PItDUTMAM9uE2XXQmM37dyd4hVM+5aVl7oVxMVUiVQn2oCQFN/LKCZdvSM0pFRqbSmQ==",
+      "dev": true
+    },
+    "node_modules/@types/send": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@types/send/-/send-1.2.0.tgz",
+      "integrity": "sha512-zBF6vZJn1IaMpg3xUF25VK3gd3l8zwE0ZLRX7dsQyQi+jp4E8mMDJNGDYnYse+bQhYwWERTxVwHpi3dMOq7RKQ==",
+      "dev": true,
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/serve-static": {
+      "version": "1.15.9",
+      "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-1.15.9.tgz",
+      "integrity": "sha512-dOTIuqpWLyl3BBXU3maNQsS4A3zuuoYRNIvYSxxhebPfXg2mzWQEPne/nlJ37yOse6uGgR386uTpdsx4D0QZWA==",
+      "dev": true,
+      "dependencies": {
+        "@types/http-errors": "*",
+        "@types/node": "*",
+        "@types/send": "<1"
+      }
+    },
+    "node_modules/@types/serve-static/node_modules/@types/send": {
+      "version": "0.17.5",
+      "resolved": "https://registry.npmjs.org/@types/send/-/send-0.17.5.tgz",
+      "integrity": "sha512-z6F2D3cOStZvuk2SaP6YrwkNO65iTZcwA2ZkSABegdkAh/lf+Aa/YQndZVfmEXT5vgAp6zv06VQ3ejSVjAny4w==",
+      "dev": true,
+      "dependencies": {
+        "@types/mime": "^1",
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/stack-utils": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/@types/stack-utils/-/stack-utils-2.0.3.tgz",
+      "integrity": "sha512-9aEbYZ3TbYMznPdcdr3SmIrLXwC/AKZXQeCf9Pgao5CKb8CyHuEX5jzWPTkvregvhRJHcpRO6BFoGW9ycaOkYw==",
+      "dev": true
+    },
+    "node_modules/@types/webidl-conversions": {
+      "version": "7.0.3",
+      "resolved": "https://registry.npmjs.org/@types/webidl-conversions/-/webidl-conversions-7.0.3.tgz",
+      "integrity": "sha512-CiJJvcRtIgzadHCYXw7dqEnMNRjhGZlYK05Mj9OyktqV8uVT8fD2BFOB7S1uwBE3Kj2Z+4UyPmFw/Ixgw/LAlA=="
+    },
+    "node_modules/@types/whatwg-url": {
+      "version": "11.0.5",
+      "resolved": "https://registry.npmjs.org/@types/whatwg-url/-/whatwg-url-11.0.5.tgz",
+      "integrity": "sha512-coYR071JRaHa+xoEvvYqvnIHaVqaYrLPbsufM9BF63HkwI5Lgmy2QR8Q5K/lYDYo5AK82wOvSOS0UsLTpTG7uQ==",
+      "dependencies": {
+        "@types/webidl-conversions": "*"
+      }
+    },
+    "node_modules/@types/yargs": {
+      "version": "17.0.33",
+      "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.33.tgz",
+      "integrity": "sha512-WpxBCKWPLr4xSsHgz511rFJAM+wS28w2zEO1QDNY5zM/S8ok70NNfztH0xwhqKyaK0OHCbN98LDAZuy1ctxDkA==",
+      "dev": true,
+      "dependencies": {
+        "@types/yargs-parser": "*"
+      }
+    },
+    "node_modules/@types/yargs-parser": {
+      "version": "21.0.3",
+      "resolved": "https://registry.npmjs.org/@types/yargs-parser/-/yargs-parser-21.0.3.tgz",
+      "integrity": "sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ==",
+      "dev": true
+    },
+    "node_modules/accepts": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz",
+      "integrity": "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==",
+      "dependencies": {
+        "mime-types": "^3.0.0",
+        "negotiator": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/acorn": {
+      "version": "8.15.0",
+      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz",
+      "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
+      "dev": true,
+      "bin": {
+        "acorn": "bin/acorn"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/acorn-walk": {
+      "version": "8.3.4",
+      "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.4.tgz",
+      "integrity": "sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==",
+      "dev": true,
+      "dependencies": {
+        "acorn": "^8.11.0"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/ansi-escapes": {
+      "version": "4.3.2",
+      "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-4.3.2.tgz",
+      "integrity": "sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==",
+      "dev": true,
+      "dependencies": {
+        "type-fest": "^0.21.3"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "dev": true,
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/anymatch": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz",
+      "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==",
+      "dev": true,
+      "dependencies": {
+        "normalize-path": "^3.0.0",
+        "picomatch": "^2.0.4"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/arg": {
+      "version": "4.1.3",
+      "resolved": "https://registry.npmjs.org/arg/-/arg-4.1.3.tgz",
+      "integrity": "sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==",
+      "dev": true
+    },
+    "node_modules/argparse": {
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
+      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
+      "dev": true,
+      "dependencies": {
+        "sprintf-js": "~1.0.2"
+      }
+    },
+    "node_modules/babel-jest": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/babel-jest/-/babel-jest-29.7.0.tgz",
+      "integrity": "sha512-BrvGY3xZSwEcCzKvKsCi2GgHqDqsYkOP4/by5xCgIwGXQxIEh+8ew3gmrE1y7XRR6LHZIj6yLYnUi/mm2KXKBg==",
+      "dev": true,
+      "dependencies": {
+        "@jest/transform": "^29.7.0",
+        "@types/babel__core": "^7.1.14",
+        "babel-plugin-istanbul": "^6.1.1",
+        "babel-preset-jest": "^29.6.3",
+        "chalk": "^4.0.0",
+        "graceful-fs": "^4.2.9",
+        "slash": "^3.0.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.8.0"
+      }
+    },
+    "node_modules/babel-plugin-istanbul": {
+      "version": "6.1.1",
+      "resolved": "https://registry.npmjs.org/babel-plugin-istanbul/-/babel-plugin-istanbul-6.1.1.tgz",
+      "integrity": "sha512-Y1IQok9821cC9onCx5otgFfRm7Lm+I+wwxOx738M/WLPZ9Q42m4IG5W0FNX8WLL2gYMZo3JkuXIH2DOpWM+qwA==",
+      "dev": true,
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.0.0",
+        "@istanbuljs/load-nyc-config": "^1.0.0",
+        "@istanbuljs/schema": "^0.1.2",
+        "istanbul-lib-instrument": "^5.0.4",
+        "test-exclude": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/babel-plugin-istanbul/node_modules/istanbul-lib-instrument": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-5.2.1.tgz",
+      "integrity": "sha512-pzqtp31nLv/XFOzXGuvhCb8qhjmTVo5vjVk19XE4CRlSWz0KoeJ3bw9XsA7nOp9YBf4qHjwBxkDzKcME/J29Yg==",
+      "dev": true,
+      "dependencies": {
+        "@babel/core": "^7.12.3",
+        "@babel/parser": "^7.14.7",
+        "@istanbuljs/schema": "^0.1.2",
+        "istanbul-lib-coverage": "^3.2.0",
+        "semver": "^6.3.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/babel-plugin-jest-hoist": {
+      "version": "29.6.3",
+      "resolved": "https://registry.npmjs.org/babel-plugin-jest-hoist/-/babel-plugin-jest-hoist-29.6.3.tgz",
+      "integrity": "sha512-ESAc/RJvGTFEzRwOTT4+lNDk/GNHMkKbNzsvT0qKRfDyyYTskxB5rnU2njIDYVxXCBHHEI1c0YwHob3WaYujOg==",
+      "dev": true,
+      "dependencies": {
+        "@babel/template": "^7.3.3",
+        "@babel/types": "^7.3.3",
+        "@types/babel__core": "^7.1.14",
+        "@types/babel__traverse": "^7.0.6"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/babel-preset-current-node-syntax": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/babel-preset-current-node-syntax/-/babel-preset-current-node-syntax-1.2.0.tgz",
+      "integrity": "sha512-E/VlAEzRrsLEb2+dv8yp3bo4scof3l9nR4lrld+Iy5NyVqgVYUJnDAmunkhPMisRI32Qc4iRiz425d8vM++2fg==",
+      "dev": true,
+      "dependencies": {
+        "@babel/plugin-syntax-async-generators": "^7.8.4",
+        "@babel/plugin-syntax-bigint": "^7.8.3",
+        "@babel/plugin-syntax-class-properties": "^7.12.13",
+        "@babel/plugin-syntax-class-static-block": "^7.14.5",
+        "@babel/plugin-syntax-import-attributes": "^7.24.7",
+        "@babel/plugin-syntax-import-meta": "^7.10.4",
+        "@babel/plugin-syntax-json-strings": "^7.8.3",
+        "@babel/plugin-syntax-logical-assignment-operators": "^7.10.4",
+        "@babel/plugin-syntax-nullish-coalescing-operator": "^7.8.3",
+        "@babel/plugin-syntax-numeric-separator": "^7.10.4",
+        "@babel/plugin-syntax-object-rest-spread": "^7.8.3",
+        "@babel/plugin-syntax-optional-catch-binding": "^7.8.3",
+        "@babel/plugin-syntax-optional-chaining": "^7.8.3",
+        "@babel/plugin-syntax-private-property-in-object": "^7.14.5",
+        "@babel/plugin-syntax-top-level-await": "^7.14.5"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0 || ^8.0.0-0"
+      }
+    },
+    "node_modules/babel-preset-jest": {
+      "version": "29.6.3",
+      "resolved": "https://registry.npmjs.org/babel-preset-jest/-/babel-preset-jest-29.6.3.tgz",
+      "integrity": "sha512-0B3bhxR6snWXJZtR/RliHTDPRgn1sNHOR0yVtq/IiQFyuOVjFS+wuio/R4gSNkyYmKmJB4wGZv2NZanmKmTnNA==",
+      "dev": true,
+      "dependencies": {
+        "babel-plugin-jest-hoist": "^29.6.3",
+        "babel-preset-current-node-syntax": "^1.0.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true
+    },
+    "node_modules/baseline-browser-mapping": {
+      "version": "2.8.16",
+      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.8.16.tgz",
+      "integrity": "sha512-OMu3BGQ4E7P1ErFsIPpbJh0qvDudM/UuJeHgkAvfWe+0HFJCXh+t/l8L6fVLR55RI/UbKrVLnAXZSVwd9ysWYw==",
+      "dev": true,
+      "bin": {
+        "baseline-browser-mapping": "dist/cli.js"
+      }
+    },
+    "node_modules/body-parser": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-2.2.0.tgz",
+      "integrity": "sha512-02qvAaxv8tp7fBa/mw1ga98OGm+eCbqzJOKoRt70sLmfEEi+jyBYVTDGfCL/k06/4EMk/z01gCe7HoCH/f2LTg==",
+      "dependencies": {
+        "bytes": "^3.1.2",
+        "content-type": "^1.0.5",
+        "debug": "^4.4.0",
+        "http-errors": "^2.0.0",
+        "iconv-lite": "^0.6.3",
+        "on-finished": "^2.4.1",
+        "qs": "^6.14.0",
+        "raw-body": "^3.0.0",
+        "type-is": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/brace-expansion": {
+      "version": "1.1.12",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
+      "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
+      "dev": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/braces": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
+      "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
+      "dev": true,
+      "dependencies": {
+        "fill-range": "^7.1.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/browserslist": {
+      "version": "4.26.3",
+      "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.26.3.tgz",
+      "integrity": "sha512-lAUU+02RFBuCKQPj/P6NgjlbCnLBMp4UtgTx7vNHd3XSIJF87s9a5rA3aH2yw3GS9DqZAUbOtZdCCiZeVRqt0w==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/browserslist"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "dependencies": {
+        "baseline-browser-mapping": "^2.8.9",
+        "caniuse-lite": "^1.0.30001746",
+        "electron-to-chromium": "^1.5.227",
+        "node-releases": "^2.0.21",
+        "update-browserslist-db": "^1.1.3"
+      },
+      "bin": {
+        "browserslist": "cli.js"
+      },
+      "engines": {
+        "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
+      }
+    },
+    "node_modules/bs-logger": {
+      "version": "0.2.6",
+      "resolved": "https://registry.npmjs.org/bs-logger/-/bs-logger-0.2.6.tgz",
+      "integrity": "sha512-pd8DCoxmbgc7hyPKOvxtqNcjYoOsABPQdcCUjGp3d42VR2CX1ORhk2A87oqqu5R1kk+76nsxZupkmyd+MVtCog==",
+      "dev": true,
+      "dependencies": {
+        "fast-json-stable-stringify": "2.x"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/bser": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/bser/-/bser-2.1.1.tgz",
+      "integrity": "sha512-gQxTNE/GAfIIrmHLUE3oJyp5FO6HRBfhjnw4/wMmA63ZGDJnWBmgY/lyQBpnDUkGmAhbSe39tx2d/iTOAfglwQ==",
+      "dev": true,
+      "dependencies": {
+        "node-int64": "^0.4.0"
+      }
+    },
+    "node_modules/bson": {
+      "version": "6.10.4",
+      "resolved": "https://registry.npmjs.org/bson/-/bson-6.10.4.tgz",
+      "integrity": "sha512-WIsKqkSC0ABoBJuT1LEX+2HEvNmNKKgnTAyd0fL8qzK4SH2i9NXg+t08YtdZp/V9IZ33cxe3iV4yM0qg8lMQng==",
+      "engines": {
+        "node": ">=16.20.1"
+      }
+    },
+    "node_modules/buffer-from": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
+      "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
+      "dev": true
+    },
+    "node_modules/bytes": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
+      "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/call-bound": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "get-intrinsic": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/callsites": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz",
+      "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/camelcase": {
+      "version": "5.3.1",
+      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-5.3.1.tgz",
+      "integrity": "sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/caniuse-lite": {
+      "version": "1.0.30001750",
+      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001750.tgz",
+      "integrity": "sha512-cuom0g5sdX6rw00qOoLNSFCJ9/mYIsuSOA+yzpDw8eopiFqcVwQvZHqov0vmEighRxX++cfC0Vg1G+1Iy/mSpQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ]
+    },
+    "node_modules/chalk": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
+      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
+      "dev": true,
+      "dependencies": {
+        "ansi-styles": "^4.1.0",
+        "supports-color": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
+    "node_modules/char-regex": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/char-regex/-/char-regex-1.0.2.tgz",
+      "integrity": "sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==",
+      "dev": true,
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/ci-info": {
+      "version": "3.9.0",
+      "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-3.9.0.tgz",
+      "integrity": "sha512-NIxF55hv4nSqQswkAeiOi1r83xy8JldOFDTWiug55KBu9Jnblncd2U6ViHmYgHf01TPZS77NJBhBMKdWj9HQMQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/sibiraj-s"
+        }
+      ],
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/cjs-module-lexer": {
+      "version": "1.4.3",
+      "resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-1.4.3.tgz",
+      "integrity": "sha512-9z8TZaGM1pfswYeXrUpzPrkx8UnWYdhJclsiYMm6x/w5+nN+8Tf/LnAgfLGQCm59qAOxU8WwHEq2vNwF6i4j+Q==",
+      "dev": true
+    },
+    "node_modules/cliui": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz",
+      "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==",
+      "dev": true,
+      "dependencies": {
+        "string-width": "^4.2.0",
+        "strip-ansi": "^6.0.1",
+        "wrap-ansi": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/co": {
+      "version": "4.6.0",
+      "resolved": "https://registry.npmjs.org/co/-/co-4.6.0.tgz",
+      "integrity": "sha512-QVb0dM5HvG+uaxitm8wONl7jltx8dqhfU33DcqtOZcLSVIKSDDLDi7+0LbAKiyI8hD9u42m2YxXSkMGWThaecQ==",
+      "dev": true,
+      "engines": {
+        "iojs": ">= 1.0.0",
+        "node": ">= 0.12.0"
+      }
+    },
+    "node_modules/collect-v8-coverage": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/collect-v8-coverage/-/collect-v8-coverage-1.0.2.tgz",
+      "integrity": "sha512-lHl4d5/ONEbLlJvaJNtsF/Lz+WvB07u2ycqTYbdrq7UypDXailES4valYb2eWiJFxZlVmpGekfqoxQhzyFdT4Q==",
+      "dev": true
+    },
+    "node_modules/color-convert": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "dev": true,
+      "dependencies": {
+        "color-name": "~1.1.4"
+      },
+      "engines": {
+        "node": ">=7.0.0"
+      }
+    },
+    "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+      "dev": true
+    },
+    "node_modules/concat-map": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
+      "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
+      "dev": true
+    },
+    "node_modules/content-disposition": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.0.0.tgz",
+      "integrity": "sha512-Au9nRL8VNUut/XSzbQA38+M78dzP4D+eqg3gfJHMIHHYa3bg067xj1KxMUWj+VULbiZMowKngFFbKczUrNJ1mg==",
+      "dependencies": {
+        "safe-buffer": "5.2.1"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/content-type": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
+      "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/convert-source-map": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
+      "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
+      "dev": true
+    },
+    "node_modules/cookie": {
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
+      "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie-signature": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.2.2.tgz",
+      "integrity": "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==",
+      "engines": {
+        "node": ">=6.6.0"
+      }
+    },
+    "node_modules/cors": {
+      "version": "2.8.5",
+      "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.5.tgz",
+      "integrity": "sha512-KIHbLJqu73RGr/hnbrO9uBeixNGuvSQjul/jdFvS/KFSIH1hWVd1ng7zOHx+YrEfInLG7q4n6GHQ9cDtxv/P6g==",
+      "dependencies": {
+        "object-assign": "^4",
+        "vary": "^1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/create-jest": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/create-jest/-/create-jest-29.7.0.tgz",
+      "integrity": "sha512-Adz2bdH0Vq3F53KEMJOoftQFutWCukm6J24wbPWRO4k1kMY7gS7ds/uoJkNuV8wDCtWWnuwGcJwpWcih+zEW1Q==",
+      "dev": true,
+      "dependencies": {
+        "@jest/types": "^29.6.3",
+        "chalk": "^4.0.0",
+        "exit": "^0.1.2",
+        "graceful-fs": "^4.2.9",
+        "jest-config": "^29.7.0",
+        "jest-util": "^29.7.0",
+        "prompts": "^2.0.1"
+      },
+      "bin": {
+        "create-jest": "bin/create-jest.js"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/create-require": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/create-require/-/create-require-1.1.1.tgz",
+      "integrity": "sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==",
+      "dev": true
+    },
+    "node_modules/cross-spawn": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+      "dev": true,
+      "dependencies": {
+        "path-key": "^3.1.0",
+        "shebang-command": "^2.0.0",
+        "which": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/dedent": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/dedent/-/dedent-1.7.0.tgz",
+      "integrity": "sha512-HGFtf8yhuhGhqO07SV79tRp+br4MnbdjeVxotpn1QBl30pcLLCQjX5b2295ll0fv8RKDKsmWYrl05usHM9CewQ==",
+      "dev": true,
+      "peerDependencies": {
+        "babel-plugin-macros": "^3.1.0"
+      },
+      "peerDependenciesMeta": {
+        "babel-plugin-macros": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/deepmerge": {
+      "version": "4.3.1",
+      "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz",
+      "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/depd": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
+      "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/detect-newline": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/detect-newline/-/detect-newline-3.1.0.tgz",
+      "integrity": "sha512-TLz+x/vEXm/Y7P7wn1EJFNLxYpUD4TgMosxY6fAVJUnJMbupHBOncxyWUG9OpTaH9EBD7uFI5LfEgmMOc54DsA==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/diff": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/diff/-/diff-4.0.2.tgz",
+      "integrity": "sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.3.1"
+      }
+    },
+    "node_modules/diff-sequences": {
+      "version": "29.6.3",
+      "resolved": "https://registry.npmjs.org/diff-sequences/-/diff-sequences-29.6.3.tgz",
+      "integrity": "sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==",
+      "dev": true,
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/dotenv": {
+      "version": "16.6.1",
+      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz",
+      "integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://dotenvx.com"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/ee-first": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
+      "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow=="
+    },
+    "node_modules/electron-to-chromium": {
+      "version": "1.5.235",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.235.tgz",
+      "integrity": "sha512-i/7ntLFwOdoHY7sgjlTIDo4Sl8EdoTjWIaKinYOVfC6bOp71bmwenyZthWHcasxgHDNWbWxvG9M3Ia116zIaYQ==",
+      "dev": true
+    },
+    "node_modules/emittery": {
+      "version": "0.13.1",
+      "resolved": "https://registry.npmjs.org/emittery/-/emittery-0.13.1.tgz",
+      "integrity": "sha512-DeWwawk6r5yR9jFgnDKYt4sLS0LmHJJi3ZOnb5/JdbYwj3nW+FxQnHIjhBKz8YLC7oRNPVM9NQ47I3CVx34eqQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/emittery?sponsor=1"
+      }
+    },
+    "node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "dev": true
+    },
+    "node_modules/encodeurl": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
+      "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/error-ex": {
+      "version": "1.3.4",
+      "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.4.tgz",
+      "integrity": "sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ==",
+      "dev": true,
+      "dependencies": {
+        "is-arrayish": "^0.2.1"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+      "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/escalade": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
+      "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/escape-html": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
+      "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow=="
+    },
+    "node_modules/escape-string-regexp": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-2.0.0.tgz",
+      "integrity": "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/esprima": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
+      "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==",
+      "dev": true,
+      "bin": {
+        "esparse": "bin/esparse.js",
+        "esvalidate": "bin/esvalidate.js"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/etag": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
+      "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/execa": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz",
+      "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==",
+      "dev": true,
+      "dependencies": {
+        "cross-spawn": "^7.0.3",
+        "get-stream": "^6.0.0",
+        "human-signals": "^2.1.0",
+        "is-stream": "^2.0.0",
+        "merge-stream": "^2.0.0",
+        "npm-run-path": "^4.0.1",
+        "onetime": "^5.1.2",
+        "signal-exit": "^3.0.3",
+        "strip-final-newline": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/execa?sponsor=1"
+      }
+    },
+    "node_modules/exit": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/exit/-/exit-0.1.2.tgz",
+      "integrity": "sha512-Zk/eNKV2zbjpKzrsQ+n1G6poVbErQxJ0LBOJXaKZ1EViLzH+hrLu9cdXI4zw9dBQJslwBEpbQ2P1oS7nDxs6jQ==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/expect": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/expect/-/expect-29.7.0.tgz",
+      "integrity": "sha512-2Zks0hf1VLFYI1kbh0I5jP3KHHyCHpkfyHBzsSXRFgl/Bg9mWYfMW8oD+PdMPlEwy5HNsR9JutYy6pMeOh61nw==",
+      "dev": true,
+      "dependencies": {
+        "@jest/expect-utils": "^29.7.0",
+        "jest-get-type": "^29.6.3",
+        "jest-matcher-utils": "^29.7.0",
+        "jest-message-util": "^29.7.0",
+        "jest-util": "^29.7.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/express": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/express/-/express-5.1.0.tgz",
+      "integrity": "sha512-DT9ck5YIRU+8GYzzU5kT3eHGA5iL+1Zd0EutOmTE9Dtk+Tvuzd23VBU+ec7HPNSTxXYO55gPV/hq4pSBJDjFpA==",
+      "dependencies": {
+        "accepts": "^2.0.0",
+        "body-parser": "^2.2.0",
+        "content-disposition": "^1.0.0",
+        "content-type": "^1.0.5",
+        "cookie": "^0.7.1",
+        "cookie-signature": "^1.2.1",
+        "debug": "^4.4.0",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "etag": "^1.8.1",
+        "finalhandler": "^2.1.0",
+        "fresh": "^2.0.0",
+        "http-errors": "^2.0.0",
+        "merge-descriptors": "^2.0.0",
+        "mime-types": "^3.0.0",
+        "on-finished": "^2.4.1",
+        "once": "^1.4.0",
+        "parseurl": "^1.3.3",
+        "proxy-addr": "^2.0.7",
+        "qs": "^6.14.0",
+        "range-parser": "^1.2.1",
+        "router": "^2.2.0",
+        "send": "^1.1.0",
+        "serve-static": "^2.2.0",
+        "statuses": "^2.0.1",
+        "type-is": "^2.0.1",
+        "vary": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/fast-json-stable-stringify": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",
+      "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==",
+      "dev": true
+    },
+    "node_modules/fb-watchman": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/fb-watchman/-/fb-watchman-2.0.2.tgz",
+      "integrity": "sha512-p5161BqbuCaSnB8jIbzQHOlpgsPmK5rJVDfDKO91Axs5NC1uu3HRQm6wt9cd9/+GtQQIO53JdGXXoyDpTAsgYA==",
+      "dev": true,
+      "dependencies": {
+        "bser": "2.1.1"
+      }
+    },
+    "node_modules/fill-range": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
+      "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
+      "dev": true,
+      "dependencies": {
+        "to-regex-range": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/finalhandler": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.0.tgz",
+      "integrity": "sha512-/t88Ty3d5JWQbWYgaOGCCYfXRwV1+be02WqYYlL6h0lEiUAMPM8o8qKGO01YIkOHzka2up08wvgYD0mDiI+q3Q==",
+      "dependencies": {
+        "debug": "^4.4.0",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "on-finished": "^2.4.1",
+        "parseurl": "^1.3.3",
+        "statuses": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/find-up": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz",
+      "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==",
+      "dev": true,
+      "dependencies": {
+        "locate-path": "^5.0.0",
+        "path-exists": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/forwarded": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
+      "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/fresh": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/fresh/-/fresh-2.0.0.tgz",
+      "integrity": "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/fs.realpath": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
+      "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==",
+      "dev": true
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/gensync": {
+      "version": "1.0.0-beta.2",
+      "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz",
+      "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==",
+      "dev": true,
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/get-caller-file": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
+      "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
+      "dev": true,
+      "engines": {
+        "node": "6.* || 8.* || >= 10.*"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-package-type": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/get-package-type/-/get-package-type-0.1.0.tgz",
+      "integrity": "sha512-pjzuKtY64GYfWizNAJ0fr9VqttZkNiK2iS430LtIHzjBEr6bX8Am2zm4sW4Ro5wjWW5cAlRL1qAMTcXbjNAO2Q==",
+      "dev": true,
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/get-stream": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz",
+      "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==",
+      "dev": true,
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/glob": {
+      "version": "7.2.3",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz",
+      "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==",
+      "deprecated": "Glob versions prior to v9 are no longer supported",
+      "dev": true,
+      "dependencies": {
+        "fs.realpath": "^1.0.0",
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "^3.1.1",
+        "once": "^1.3.0",
+        "path-is-absolute": "^1.0.0"
+      },
+      "engines": {
+        "node": "*"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/graceful-fs": {
+      "version": "4.2.11",
+      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
+      "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
+      "dev": true
+    },
+    "node_modules/handlebars": {
+      "version": "4.7.8",
+      "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.8.tgz",
+      "integrity": "sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ==",
+      "dev": true,
+      "dependencies": {
+        "minimist": "^1.2.5",
+        "neo-async": "^2.6.2",
+        "source-map": "^0.6.1",
+        "wordwrap": "^1.0.0"
+      },
+      "bin": {
+        "handlebars": "bin/handlebars"
+      },
+      "engines": {
+        "node": ">=0.4.7"
+      },
+      "optionalDependencies": {
+        "uglify-js": "^3.1.4"
+      }
+    },
+    "node_modules/has-flag": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+      "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/html-escaper": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-2.0.2.tgz",
+      "integrity": "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==",
+      "dev": true
+    },
+    "node_modules/http-errors": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz",
+      "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==",
+      "dependencies": {
+        "depd": "2.0.0",
+        "inherits": "2.0.4",
+        "setprototypeof": "1.2.0",
+        "statuses": "2.0.1",
+        "toidentifier": "1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/http-errors/node_modules/statuses": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz",
+      "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/human-signals": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz",
+      "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==",
+      "dev": true,
+      "engines": {
+        "node": ">=10.17.0"
+      }
+    },
+    "node_modules/iconv-lite": {
+      "version": "0.6.3",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz",
+      "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/import-local": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.2.0.tgz",
+      "integrity": "sha512-2SPlun1JUPWoM6t3F0dw0FkCF/jWY8kttcY4f599GLTSjh2OCuuhdTkJQsEcZzBqbXZGKMK2OqW1oZsjtf/gQA==",
+      "dev": true,
+      "dependencies": {
+        "pkg-dir": "^4.2.0",
+        "resolve-cwd": "^3.0.0"
+      },
+      "bin": {
+        "import-local-fixture": "fixtures/cli.js"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/imurmurhash": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz",
+      "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.8.19"
+      }
+    },
+    "node_modules/inflight": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
+      "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==",
+      "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.",
+      "dev": true,
+      "dependencies": {
+        "once": "^1.3.0",
+        "wrappy": "1"
+      }
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="
+    },
+    "node_modules/ipaddr.js": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
+      "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/is-arrayish": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz",
+      "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==",
+      "dev": true
+    },
+    "node_modules/is-core-module": {
+      "version": "2.16.1",
+      "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz",
+      "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==",
+      "dev": true,
+      "dependencies": {
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-fullwidth-code-point": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/is-generator-fn": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/is-generator-fn/-/is-generator-fn-2.1.0.tgz",
+      "integrity": "sha512-cTIB4yPYL/Grw0EaSzASzg6bBy9gqCofvWN8okThAYIxKJZC+udlRAmGbM0XLeniEJSs8uEgHPGuHSe1XsOLSQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/is-number": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
+      "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.12.0"
+      }
+    },
+    "node_modules/is-promise": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz",
+      "integrity": "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ=="
+    },
+    "node_modules/is-stream": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
+      "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+      "dev": true
+    },
+    "node_modules/istanbul-lib-coverage": {
+      "version": "3.2.2",
+      "resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.2.tgz",
+      "integrity": "sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/istanbul-lib-instrument": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-6.0.3.tgz",
+      "integrity": "sha512-Vtgk7L/R2JHyyGW07spoFlB8/lpjiOLTjMdms6AFMraYt3BaJauod/NGrfnVG/y4Ix1JEuMRPDPEj2ua+zz1/Q==",
+      "dev": true,
+      "dependencies": {
+        "@babel/core": "^7.23.9",
+        "@babel/parser": "^7.23.9",
+        "@istanbuljs/schema": "^0.1.3",
+        "istanbul-lib-coverage": "^3.2.0",
+        "semver": "^7.5.4"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/istanbul-lib-instrument/node_modules/semver": {
+      "version": "7.7.3",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz",
+      "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==",
+      "dev": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/istanbul-lib-report": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/istanbul-lib-report/-/istanbul-lib-report-3.0.1.tgz",
+      "integrity": "sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==",
+      "dev": true,
+      "dependencies": {
+        "istanbul-lib-coverage": "^3.0.0",
+        "make-dir": "^4.0.0",
+        "supports-color": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/istanbul-lib-source-maps": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/istanbul-lib-source-maps/-/istanbul-lib-source-maps-4.0.1.tgz",
+      "integrity": "sha512-n3s8EwkdFIJCG3BPKBYvskgXGoy88ARzvegkitk60NxRdwltLOTaH7CUiMRXvwYorl0Q712iEjcWB+fK/MrWVw==",
+      "dev": true,
+      "dependencies": {
+        "debug": "^4.1.1",
+        "istanbul-lib-coverage": "^3.0.0",
+        "source-map": "^0.6.1"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/istanbul-reports": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/istanbul-reports/-/istanbul-reports-3.2.0.tgz",
+      "integrity": "sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==",
+      "dev": true,
+      "dependencies": {
+        "html-escaper": "^2.0.0",
+        "istanbul-lib-report": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/jest": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest/-/jest-29.7.0.tgz",
+      "integrity": "sha512-NIy3oAFp9shda19hy4HK0HRTWKtPJmGdnvywu01nOqNC2vZg+Z+fvJDxpMQA88eb2I9EcafcdjYgsDthnYTvGw==",
+      "dev": true,
+      "dependencies": {
+        "@jest/core": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "import-local": "^3.0.2",
+        "jest-cli": "^29.7.0"
+      },
+      "bin": {
+        "jest": "bin/jest.js"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      },
+      "peerDependencies": {
+        "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0"
+      },
+      "peerDependenciesMeta": {
+        "node-notifier": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/jest-changed-files": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-changed-files/-/jest-changed-files-29.7.0.tgz",
+      "integrity": "sha512-fEArFiwf1BpQ+4bXSprcDc3/x4HSzL4al2tozwVpDFpsxALjLYdyiIK4e5Vz66GQJIbXJ82+35PtysofptNX2w==",
+      "dev": true,
+      "dependencies": {
+        "execa": "^5.0.0",
+        "jest-util": "^29.7.0",
+        "p-limit": "^3.1.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-circus": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-circus/-/jest-circus-29.7.0.tgz",
+      "integrity": "sha512-3E1nCMgipcTkCocFwM90XXQab9bS+GMsjdpmPrlelaxwD93Ad8iVEjX/vvHPdLPnFf+L40u+5+iutRdA1N9myw==",
+      "dev": true,
+      "dependencies": {
+        "@jest/environment": "^29.7.0",
+        "@jest/expect": "^29.7.0",
+        "@jest/test-result": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "@types/node": "*",
+        "chalk": "^4.0.0",
+        "co": "^4.6.0",
+        "dedent": "^1.0.0",
+        "is-generator-fn": "^2.0.0",
+        "jest-each": "^29.7.0",
+        "jest-matcher-utils": "^29.7.0",
+        "jest-message-util": "^29.7.0",
+        "jest-runtime": "^29.7.0",
+        "jest-snapshot": "^29.7.0",
+        "jest-util": "^29.7.0",
+        "p-limit": "^3.1.0",
+        "pretty-format": "^29.7.0",
+        "pure-rand": "^6.0.0",
+        "slash": "^3.0.0",
+        "stack-utils": "^2.0.3"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-cli": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-cli/-/jest-cli-29.7.0.tgz",
+      "integrity": "sha512-OVVobw2IubN/GSYsxETi+gOe7Ka59EFMR/twOU3Jb2GnKKeMGJB5SGUUrEz3SFVmJASUdZUzy83sLNNQ2gZslg==",
+      "dev": true,
+      "dependencies": {
+        "@jest/core": "^29.7.0",
+        "@jest/test-result": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "chalk": "^4.0.0",
+        "create-jest": "^29.7.0",
+        "exit": "^0.1.2",
+        "import-local": "^3.0.2",
+        "jest-config": "^29.7.0",
+        "jest-util": "^29.7.0",
+        "jest-validate": "^29.7.0",
+        "yargs": "^17.3.1"
+      },
+      "bin": {
+        "jest": "bin/jest.js"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      },
+      "peerDependencies": {
+        "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0"
+      },
+      "peerDependenciesMeta": {
+        "node-notifier": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/jest-config": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-config/-/jest-config-29.7.0.tgz",
+      "integrity": "sha512-uXbpfeQ7R6TZBqI3/TxCU4q4ttk3u0PJeC+E0zbfSoSjq6bJ7buBPxzQPL0ifrkY4DNu4JUdk0ImlBUYi840eQ==",
+      "dev": true,
+      "dependencies": {
+        "@babel/core": "^7.11.6",
+        "@jest/test-sequencer": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "babel-jest": "^29.7.0",
+        "chalk": "^4.0.0",
+        "ci-info": "^3.2.0",
+        "deepmerge": "^4.2.2",
+        "glob": "^7.1.3",
+        "graceful-fs": "^4.2.9",
+        "jest-circus": "^29.7.0",
+        "jest-environment-node": "^29.7.0",
+        "jest-get-type": "^29.6.3",
+        "jest-regex-util": "^29.6.3",
+        "jest-resolve": "^29.7.0",
+        "jest-runner": "^29.7.0",
+        "jest-util": "^29.7.0",
+        "jest-validate": "^29.7.0",
+        "micromatch": "^4.0.4",
+        "parse-json": "^5.2.0",
+        "pretty-format": "^29.7.0",
+        "slash": "^3.0.0",
+        "strip-json-comments": "^3.1.1"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      },
+      "peerDependencies": {
+        "@types/node": "*",
+        "ts-node": ">=9.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "ts-node": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/jest-diff": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-diff/-/jest-diff-29.7.0.tgz",
+      "integrity": "sha512-LMIgiIrhigmPrs03JHpxUh2yISK3vLFPkAodPeo0+BuF7wA2FoQbkEg1u8gBYBThncu7e1oEDUfIXVuTqLRUjw==",
+      "dev": true,
+      "dependencies": {
+        "chalk": "^4.0.0",
+        "diff-sequences": "^29.6.3",
+        "jest-get-type": "^29.6.3",
+        "pretty-format": "^29.7.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-docblock": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-docblock/-/jest-docblock-29.7.0.tgz",
+      "integrity": "sha512-q617Auw3A612guyaFgsbFeYpNP5t2aoUNLwBUbc/0kD1R4t9ixDbyFTHd1nok4epoVFpr7PmeWHrhvuV3XaJ4g==",
+      "dev": true,
+      "dependencies": {
+        "detect-newline": "^3.0.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-each": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-each/-/jest-each-29.7.0.tgz",
+      "integrity": "sha512-gns+Er14+ZrEoC5fhOfYCY1LOHHr0TI+rQUHZS8Ttw2l7gl+80eHc/gFf2Ktkw0+SIACDTeWvpFcv3B04VembQ==",
+      "dev": true,
+      "dependencies": {
+        "@jest/types": "^29.6.3",
+        "chalk": "^4.0.0",
+        "jest-get-type": "^29.6.3",
+        "jest-util": "^29.7.0",
+        "pretty-format": "^29.7.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-environment-node": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-environment-node/-/jest-environment-node-29.7.0.tgz",
+      "integrity": "sha512-DOSwCRqXirTOyheM+4d5YZOrWcdu0LNZ87ewUoywbcb2XR4wKgqiG8vNeYwhjFMbEkfju7wx2GYH0P2gevGvFw==",
+      "dev": true,
+      "dependencies": {
+        "@jest/environment": "^29.7.0",
+        "@jest/fake-timers": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "@types/node": "*",
+        "jest-mock": "^29.7.0",
+        "jest-util": "^29.7.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-get-type": {
+      "version": "29.6.3",
+      "resolved": "https://registry.npmjs.org/jest-get-type/-/jest-get-type-29.6.3.tgz",
+      "integrity": "sha512-zrteXnqYxfQh7l5FHyL38jL39di8H8rHoecLH3JNxH3BwOrBsNeabdap5e0I23lD4HHI8W5VFBZqG4Eaq5LNcw==",
+      "dev": true,
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-haste-map": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-haste-map/-/jest-haste-map-29.7.0.tgz",
+      "integrity": "sha512-fP8u2pyfqx0K1rGn1R9pyE0/KTn+G7PxktWidOBTqFPLYX0b9ksaMFkhK5vrS3DVun09pckLdlx90QthlW7AmA==",
+      "dev": true,
+      "dependencies": {
+        "@jest/types": "^29.6.3",
+        "@types/graceful-fs": "^4.1.3",
+        "@types/node": "*",
+        "anymatch": "^3.0.3",
+        "fb-watchman": "^2.0.0",
+        "graceful-fs": "^4.2.9",
+        "jest-regex-util": "^29.6.3",
+        "jest-util": "^29.7.0",
+        "jest-worker": "^29.7.0",
+        "micromatch": "^4.0.4",
+        "walker": "^1.0.8"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      },
+      "optionalDependencies": {
+        "fsevents": "^2.3.2"
+      }
+    },
+    "node_modules/jest-leak-detector": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-leak-detector/-/jest-leak-detector-29.7.0.tgz",
+      "integrity": "sha512-kYA8IJcSYtST2BY9I+SMC32nDpBT3J2NvWJx8+JCuCdl/CR1I4EKUJROiP8XtCcxqgTTBGJNdbB1A8XRKbTetw==",
+      "dev": true,
+      "dependencies": {
+        "jest-get-type": "^29.6.3",
+        "pretty-format": "^29.7.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-matcher-utils": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-matcher-utils/-/jest-matcher-utils-29.7.0.tgz",
+      "integrity": "sha512-sBkD+Xi9DtcChsI3L3u0+N0opgPYnCRPtGcQYrgXmR+hmt/fYfWAL0xRXYU8eWOdfuLgBe0YCW3AFtnRLagq/g==",
+      "dev": true,
+      "dependencies": {
+        "chalk": "^4.0.0",
+        "jest-diff": "^29.7.0",
+        "jest-get-type": "^29.6.3",
+        "pretty-format": "^29.7.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-message-util": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-message-util/-/jest-message-util-29.7.0.tgz",
+      "integrity": "sha512-GBEV4GRADeP+qtB2+6u61stea8mGcOT4mCtrYISZwfu9/ISHFJ/5zOMXYbpBE9RsS5+Gb63DW4FgmnKJ79Kf6w==",
+      "dev": true,
+      "dependencies": {
+        "@babel/code-frame": "^7.12.13",
+        "@jest/types": "^29.6.3",
+        "@types/stack-utils": "^2.0.0",
+        "chalk": "^4.0.0",
+        "graceful-fs": "^4.2.9",
+        "micromatch": "^4.0.4",
+        "pretty-format": "^29.7.0",
+        "slash": "^3.0.0",
+        "stack-utils": "^2.0.3"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-mock": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-mock/-/jest-mock-29.7.0.tgz",
+      "integrity": "sha512-ITOMZn+UkYS4ZFh83xYAOzWStloNzJFO2s8DWrE4lhtGD+AorgnbkiKERe4wQVBydIGPx059g6riW5Btp6Llnw==",
+      "dev": true,
+      "dependencies": {
+        "@jest/types": "^29.6.3",
+        "@types/node": "*",
+        "jest-util": "^29.7.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-pnp-resolver": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/jest-pnp-resolver/-/jest-pnp-resolver-1.2.3.tgz",
+      "integrity": "sha512-+3NpwQEnRoIBtx4fyhblQDPgJI0H1IEIkX7ShLUjPGA7TtUTvI1oiKi3SR4oBR0hQhQR80l4WAe5RrXBwWMA8w==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      },
+      "peerDependencies": {
+        "jest-resolve": "*"
+      },
+      "peerDependenciesMeta": {
+        "jest-resolve": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/jest-regex-util": {
+      "version": "29.6.3",
+      "resolved": "https://registry.npmjs.org/jest-regex-util/-/jest-regex-util-29.6.3.tgz",
+      "integrity": "sha512-KJJBsRCyyLNWCNBOvZyRDnAIfUiRJ8v+hOBQYGn8gDyF3UegwiP4gwRR3/SDa42g1YbVycTidUF3rKjyLFDWbg==",
+      "dev": true,
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-resolve": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-resolve/-/jest-resolve-29.7.0.tgz",
+      "integrity": "sha512-IOVhZSrg+UvVAshDSDtHyFCCBUl/Q3AAJv8iZ6ZjnZ74xzvwuzLXid9IIIPgTnY62SJjfuupMKZsZQRsCvxEgA==",
+      "dev": true,
+      "dependencies": {
+        "chalk": "^4.0.0",
+        "graceful-fs": "^4.2.9",
+        "jest-haste-map": "^29.7.0",
+        "jest-pnp-resolver": "^1.2.2",
+        "jest-util": "^29.7.0",
+        "jest-validate": "^29.7.0",
+        "resolve": "^1.20.0",
+        "resolve.exports": "^2.0.0",
+        "slash": "^3.0.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-resolve-dependencies": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-resolve-dependencies/-/jest-resolve-dependencies-29.7.0.tgz",
+      "integrity": "sha512-un0zD/6qxJ+S0et7WxeI3H5XSe9lTBBR7bOHCHXkKR6luG5mwDDlIzVQ0V5cZCuoTgEdcdwzTghYkTWfubi+nA==",
+      "dev": true,
+      "dependencies": {
+        "jest-regex-util": "^29.6.3",
+        "jest-snapshot": "^29.7.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-runner": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-runner/-/jest-runner-29.7.0.tgz",
+      "integrity": "sha512-fsc4N6cPCAahybGBfTRcq5wFR6fpLznMg47sY5aDpsoejOcVYFb07AHuSnR0liMcPTgBsA3ZJL6kFOjPdoNipQ==",
+      "dev": true,
+      "dependencies": {
+        "@jest/console": "^29.7.0",
+        "@jest/environment": "^29.7.0",
+        "@jest/test-result": "^29.7.0",
+        "@jest/transform": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "@types/node": "*",
+        "chalk": "^4.0.0",
+        "emittery": "^0.13.1",
+        "graceful-fs": "^4.2.9",
+        "jest-docblock": "^29.7.0",
+        "jest-environment-node": "^29.7.0",
+        "jest-haste-map": "^29.7.0",
+        "jest-leak-detector": "^29.7.0",
+        "jest-message-util": "^29.7.0",
+        "jest-resolve": "^29.7.0",
+        "jest-runtime": "^29.7.0",
+        "jest-util": "^29.7.0",
+        "jest-watcher": "^29.7.0",
+        "jest-worker": "^29.7.0",
+        "p-limit": "^3.1.0",
+        "source-map-support": "0.5.13"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-runtime": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-runtime/-/jest-runtime-29.7.0.tgz",
+      "integrity": "sha512-gUnLjgwdGqW7B4LvOIkbKs9WGbn+QLqRQQ9juC6HndeDiezIwhDP+mhMwHWCEcfQ5RUXa6OPnFF8BJh5xegwwQ==",
+      "dev": true,
+      "dependencies": {
+        "@jest/environment": "^29.7.0",
+        "@jest/fake-timers": "^29.7.0",
+        "@jest/globals": "^29.7.0",
+        "@jest/source-map": "^29.6.3",
+        "@jest/test-result": "^29.7.0",
+        "@jest/transform": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "@types/node": "*",
+        "chalk": "^4.0.0",
+        "cjs-module-lexer": "^1.0.0",
+        "collect-v8-coverage": "^1.0.0",
+        "glob": "^7.1.3",
+        "graceful-fs": "^4.2.9",
+        "jest-haste-map": "^29.7.0",
+        "jest-message-util": "^29.7.0",
+        "jest-mock": "^29.7.0",
+        "jest-regex-util": "^29.6.3",
+        "jest-resolve": "^29.7.0",
+        "jest-snapshot": "^29.7.0",
+        "jest-util": "^29.7.0",
+        "slash": "^3.0.0",
+        "strip-bom": "^4.0.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-snapshot": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-snapshot/-/jest-snapshot-29.7.0.tgz",
+      "integrity": "sha512-Rm0BMWtxBcioHr1/OX5YCP8Uov4riHvKPknOGs804Zg9JGZgmIBkbtlxJC/7Z4msKYVbIJtfU+tKb8xlYNfdkw==",
+      "dev": true,
+      "dependencies": {
+        "@babel/core": "^7.11.6",
+        "@babel/generator": "^7.7.2",
+        "@babel/plugin-syntax-jsx": "^7.7.2",
+        "@babel/plugin-syntax-typescript": "^7.7.2",
+        "@babel/types": "^7.3.3",
+        "@jest/expect-utils": "^29.7.0",
+        "@jest/transform": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "babel-preset-current-node-syntax": "^1.0.0",
+        "chalk": "^4.0.0",
+        "expect": "^29.7.0",
+        "graceful-fs": "^4.2.9",
+        "jest-diff": "^29.7.0",
+        "jest-get-type": "^29.6.3",
+        "jest-matcher-utils": "^29.7.0",
+        "jest-message-util": "^29.7.0",
+        "jest-util": "^29.7.0",
+        "natural-compare": "^1.4.0",
+        "pretty-format": "^29.7.0",
+        "semver": "^7.5.3"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-snapshot/node_modules/semver": {
+      "version": "7.7.3",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz",
+      "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==",
+      "dev": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/jest-util": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-util/-/jest-util-29.7.0.tgz",
+      "integrity": "sha512-z6EbKajIpqGKU56y5KBUgy1dt1ihhQJgWzUlZHArA/+X2ad7Cb5iF+AK1EWVL/Bo7Rz9uurpqw6SiBCefUbCGA==",
+      "dev": true,
+      "dependencies": {
+        "@jest/types": "^29.6.3",
+        "@types/node": "*",
+        "chalk": "^4.0.0",
+        "ci-info": "^3.2.0",
+        "graceful-fs": "^4.2.9",
+        "picomatch": "^2.2.3"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-validate": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-validate/-/jest-validate-29.7.0.tgz",
+      "integrity": "sha512-ZB7wHqaRGVw/9hST/OuFUReG7M8vKeq0/J2egIGLdvjHCmYqGARhzXmtgi+gVeZ5uXFF219aOc3Ls2yLg27tkw==",
+      "dev": true,
+      "dependencies": {
+        "@jest/types": "^29.6.3",
+        "camelcase": "^6.2.0",
+        "chalk": "^4.0.0",
+        "jest-get-type": "^29.6.3",
+        "leven": "^3.1.0",
+        "pretty-format": "^29.7.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-validate/node_modules/camelcase": {
+      "version": "6.3.0",
+      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-6.3.0.tgz",
+      "integrity": "sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==",
+      "dev": true,
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/jest-watcher": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-watcher/-/jest-watcher-29.7.0.tgz",
+      "integrity": "sha512-49Fg7WXkU3Vl2h6LbLtMQ/HyB6rXSIX7SqvBLQmssRBGN9I0PNvPmAmCWSOY6SOvrjhI/F7/bGAv9RtnsPA03g==",
+      "dev": true,
+      "dependencies": {
+        "@jest/test-result": "^29.7.0",
+        "@jest/types": "^29.6.3",
+        "@types/node": "*",
+        "ansi-escapes": "^4.2.1",
+        "chalk": "^4.0.0",
+        "emittery": "^0.13.1",
+        "jest-util": "^29.7.0",
+        "string-length": "^4.0.1"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-worker": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-29.7.0.tgz",
+      "integrity": "sha512-eIz2msL/EzL9UFTFFx7jBTkeZfku0yUAyZZZmJ93H2TYEiroIx2PQjEXcwYtYl8zXCxb+PAmA2hLIt/6ZEkPHw==",
+      "dev": true,
+      "dependencies": {
+        "@types/node": "*",
+        "jest-util": "^29.7.0",
+        "merge-stream": "^2.0.0",
+        "supports-color": "^8.0.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/jest-worker/node_modules/supports-color": {
+      "version": "8.1.1",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz",
+      "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==",
+      "dev": true,
+      "dependencies": {
+        "has-flag": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/supports-color?sponsor=1"
+      }
+    },
+    "node_modules/js-tokens": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+      "dev": true
+    },
+    "node_modules/js-yaml": {
+      "version": "3.14.1",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz",
+      "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==",
+      "dev": true,
+      "dependencies": {
+        "argparse": "^1.0.7",
+        "esprima": "^4.0.0"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/jsesc": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz",
+      "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==",
+      "dev": true,
+      "bin": {
+        "jsesc": "bin/jsesc"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/json-parse-even-better-errors": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz",
+      "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==",
+      "dev": true
+    },
+    "node_modules/json5": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
+      "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
+      "dev": true,
+      "bin": {
+        "json5": "lib/cli.js"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/kleur": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz",
+      "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/leven": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/leven/-/leven-3.1.0.tgz",
+      "integrity": "sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/lines-and-columns": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz",
+      "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==",
+      "dev": true
+    },
+    "node_modules/locate-path": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz",
+      "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==",
+      "dev": true,
+      "dependencies": {
+        "p-locate": "^4.1.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/lodash.memoize": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/lodash.memoize/-/lodash.memoize-4.1.2.tgz",
+      "integrity": "sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==",
+      "dev": true
+    },
+    "node_modules/lru-cache": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz",
+      "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==",
+      "dev": true,
+      "dependencies": {
+        "yallist": "^3.0.2"
+      }
+    },
+    "node_modules/make-dir": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-4.0.0.tgz",
+      "integrity": "sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==",
+      "dev": true,
+      "dependencies": {
+        "semver": "^7.5.3"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/make-dir/node_modules/semver": {
+      "version": "7.7.3",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz",
+      "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==",
+      "dev": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/make-error": {
+      "version": "1.3.6",
+      "resolved": "https://registry.npmjs.org/make-error/-/make-error-1.3.6.tgz",
+      "integrity": "sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==",
+      "dev": true
+    },
+    "node_modules/makeerror": {
+      "version": "1.0.12",
+      "resolved": "https://registry.npmjs.org/makeerror/-/makeerror-1.0.12.tgz",
+      "integrity": "sha512-JmqCvUhmt43madlpFzG4BQzG2Z3m6tvQDNKdClZnO3VbIudJYmxsT0FNJMeiB2+JTSlTQTSbU8QdesVmwJcmLg==",
+      "dev": true,
+      "dependencies": {
+        "tmpl": "1.0.5"
+      }
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/media-typer": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-1.1.0.tgz",
+      "integrity": "sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/memory-pager": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/memory-pager/-/memory-pager-1.5.0.tgz",
+      "integrity": "sha512-ZS4Bp4r/Zoeq6+NLJpP+0Zzm0pR8whtGPf1XExKLJBAczGMnSi3It14OiNCStjQjM6NU1okjQGSxgEZN8eBYKg=="
+    },
+    "node_modules/merge-descriptors": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz",
+      "integrity": "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/merge-stream": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz",
+      "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==",
+      "dev": true
+    },
+    "node_modules/micromatch": {
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
+      "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",
+      "dev": true,
+      "dependencies": {
+        "braces": "^3.0.3",
+        "picomatch": "^2.3.1"
+      },
+      "engines": {
+        "node": ">=8.6"
+      }
+    },
+    "node_modules/mime-db": {
+      "version": "1.54.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz",
+      "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.1.tgz",
+      "integrity": "sha512-xRc4oEhT6eaBpU1XF7AjpOFD+xQmXNB5OVKwp4tqCuBpHLS/ZbBDrc07mYTDqVMg6PfxUjjNp85O6Cd2Z/5HWA==",
+      "dependencies": {
+        "mime-db": "^1.54.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mimic-fn": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz",
+      "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/minimatch": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "dev": true,
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/minimist": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
+      "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
+      "dev": true,
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/mongodb": {
+      "version": "6.20.0",
+      "resolved": "https://registry.npmjs.org/mongodb/-/mongodb-6.20.0.tgz",
+      "integrity": "sha512-Tl6MEIU3K4Rq3TSHd+sZQqRBoGlFsOgNrH5ltAcFBV62Re3Fd+FcaVf8uSEQFOJ51SDowDVttBTONMfoYWrWlQ==",
+      "dependencies": {
+        "@mongodb-js/saslprep": "^1.3.0",
+        "bson": "^6.10.4",
+        "mongodb-connection-string-url": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=16.20.1"
+      },
+      "peerDependencies": {
+        "@aws-sdk/credential-providers": "^3.188.0",
+        "@mongodb-js/zstd": "^1.1.0 || ^2.0.0",
+        "gcp-metadata": "^5.2.0",
+        "kerberos": "^2.0.1",
+        "mongodb-client-encryption": ">=6.0.0 <7",
+        "snappy": "^7.3.2",
+        "socks": "^2.7.1"
+      },
+      "peerDependenciesMeta": {
+        "@aws-sdk/credential-providers": {
+          "optional": true
+        },
+        "@mongodb-js/zstd": {
+          "optional": true
+        },
+        "gcp-metadata": {
+          "optional": true
+        },
+        "kerberos": {
+          "optional": true
+        },
+        "mongodb-client-encryption": {
+          "optional": true
+        },
+        "snappy": {
+          "optional": true
+        },
+        "socks": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/mongodb-connection-string-url": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/mongodb-connection-string-url/-/mongodb-connection-string-url-3.0.2.tgz",
+      "integrity": "sha512-rMO7CGo/9BFwyZABcKAWL8UJwH/Kc2x0g72uhDWzG48URRax5TCIcJ7Rc3RZqffZzO/Gwff/jyKwCU9TN8gehA==",
+      "dependencies": {
+        "@types/whatwg-url": "^11.0.2",
+        "whatwg-url": "^14.1.0 || ^13.0.0"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="
+    },
+    "node_modules/natural-compare": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz",
+      "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==",
+      "dev": true
+    },
+    "node_modules/negotiator": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-1.0.0.tgz",
+      "integrity": "sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg==",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/neo-async": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz",
+      "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==",
+      "dev": true
+    },
+    "node_modules/node-int64": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/node-int64/-/node-int64-0.4.0.tgz",
+      "integrity": "sha512-O5lz91xSOeoXP6DulyHfllpq+Eg00MWitZIbtPfoSEvqIHdl5gfcY6hYzDWnj0qD5tz52PI08u9qUvSVeUBeHw==",
+      "dev": true
+    },
+    "node_modules/node-releases": {
+      "version": "2.0.23",
+      "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.23.tgz",
+      "integrity": "sha512-cCmFDMSm26S6tQSDpBCg/NR8NENrVPhAJSf+XbxBG4rPFaaonlEoE9wHQmun+cls499TQGSb7ZyPBRlzgKfpeg==",
+      "dev": true
+    },
+    "node_modules/normalize-path": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
+      "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/npm-run-path": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz",
+      "integrity": "sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==",
+      "dev": true,
+      "dependencies": {
+        "path-key": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/object-assign": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
+      "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/object-inspect": {
+      "version": "1.13.4",
+      "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
+      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/on-finished": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
+      "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
+      "dependencies": {
+        "ee-first": "1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/once": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+      "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+      "dependencies": {
+        "wrappy": "1"
+      }
+    },
+    "node_modules/onetime": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz",
+      "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==",
+      "dev": true,
+      "dependencies": {
+        "mimic-fn": "^2.1.0"
+      },
+      "engines": {
+        "node": ">=6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-limit": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz",
+      "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==",
+      "dev": true,
+      "dependencies": {
+        "yocto-queue": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-locate": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz",
+      "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==",
+      "dev": true,
+      "dependencies": {
+        "p-limit": "^2.2.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/p-locate/node_modules/p-limit": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz",
+      "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==",
+      "dev": true,
+      "dependencies": {
+        "p-try": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-try": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz",
+      "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/parse-json": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz",
+      "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==",
+      "dev": true,
+      "dependencies": {
+        "@babel/code-frame": "^7.0.0",
+        "error-ex": "^1.3.1",
+        "json-parse-even-better-errors": "^2.3.0",
+        "lines-and-columns": "^1.1.6"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/parseurl": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
+      "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/path-exists": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
+      "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-is-absolute": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
+      "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/path-key": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-parse": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
+      "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
+      "dev": true
+    },
+    "node_modules/path-to-regexp": {
+      "version": "8.3.0",
+      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.3.0.tgz",
+      "integrity": "sha512-7jdwVIRtsP8MYpdXSwOS0YdD0Du+qOoF/AEPIt88PcCFrZCzx41oxku1jD88hZBwbNUIEfpqvuhjFaMAqMTWnA==",
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "dev": true
+    },
+    "node_modules/picomatch": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
+      "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
+      "dev": true,
+      "engines": {
+        "node": ">=8.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/pirates": {
+      "version": "4.0.7",
+      "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.7.tgz",
+      "integrity": "sha512-TfySrs/5nm8fQJDcBDuUng3VOUKsd7S+zqvbOTiGXHfxX4wK31ard+hoNuvkicM/2YFzlpDgABOevKSsB4G/FA==",
+      "dev": true,
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/pkg-dir": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-4.2.0.tgz",
+      "integrity": "sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==",
+      "dev": true,
+      "dependencies": {
+        "find-up": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/pretty-format": {
+      "version": "29.7.0",
+      "resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-29.7.0.tgz",
+      "integrity": "sha512-Pdlw/oPxN+aXdmM9R00JVC9WVFoCLTKJvDVLgmJ+qAffBMxsV85l/Lu7sNx4zSzPyoL2euImuEwHhOXdEgNFZQ==",
+      "dev": true,
+      "dependencies": {
+        "@jest/schemas": "^29.6.3",
+        "ansi-styles": "^5.0.0",
+        "react-is": "^18.0.0"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
+      }
+    },
+    "node_modules/pretty-format/node_modules/ansi-styles": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz",
+      "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==",
+      "dev": true,
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/prompts": {
+      "version": "2.4.2",
+      "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz",
+      "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==",
+      "dev": true,
+      "dependencies": {
+        "kleur": "^3.0.3",
+        "sisteransi": "^1.0.5"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/proxy-addr": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
+      "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
+      "dependencies": {
+        "forwarded": "0.2.0",
+        "ipaddr.js": "1.9.1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/punycode": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
+      "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/pure-rand": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/pure-rand/-/pure-rand-6.1.0.tgz",
+      "integrity": "sha512-bVWawvoZoBYpp6yIoQtQXHZjmz35RSVHnUOTefl8Vcjr8snTPY1wnpSPMWekcFwbxI6gtmT7rSYPFvz71ldiOA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/dubzzz"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fast-check"
+        }
+      ]
+    },
+    "node_modules/qs": {
+      "version": "6.14.0",
+      "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.0.tgz",
+      "integrity": "sha512-YWWTjgABSKcvs/nWBi9PycY/JiPJqOD4JA6o9Sej2AtvSGarXxKC3OQSk4pAarbdQlKAh5D4FCQkJNkW+GAn3w==",
+      "dependencies": {
+        "side-channel": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=0.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/range-parser": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
+      "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/raw-body": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-3.0.1.tgz",
+      "integrity": "sha512-9G8cA+tuMS75+6G/TzW8OtLzmBDMo8p1JRxN5AZ+LAp8uxGA8V8GZm4GQ4/N5QNQEnLmg6SS7wyuSmbKepiKqA==",
+      "dependencies": {
+        "bytes": "3.1.2",
+        "http-errors": "2.0.0",
+        "iconv-lite": "0.7.0",
+        "unpipe": "1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/raw-body/node_modules/iconv-lite": {
+      "version": "0.7.0",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.7.0.tgz",
+      "integrity": "sha512-cf6L2Ds3h57VVmkZe+Pn+5APsT7FpqJtEhhieDCvrE2MK5Qk9MyffgQyuxQTm6BChfeZNtcOLHp9IcWRVcIcBQ==",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/react-is": {
+      "version": "18.3.1",
+      "resolved": "https://registry.npmjs.org/react-is/-/react-is-18.3.1.tgz",
+      "integrity": "sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==",
+      "dev": true
+    },
+    "node_modules/require-directory": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
+      "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/resolve": {
+      "version": "1.22.10",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.10.tgz",
+      "integrity": "sha512-NPRy+/ncIMeDlTAsuqwKIiferiawhefFJtkNSW0qZJEqMEb+qBt/77B/jGeeek+F0uOeN05CDa6HXbbIgtVX4w==",
+      "dev": true,
+      "dependencies": {
+        "is-core-module": "^2.16.0",
+        "path-parse": "^1.0.7",
+        "supports-preserve-symlinks-flag": "^1.0.0"
+      },
+      "bin": {
+        "resolve": "bin/resolve"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/resolve-cwd": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-cwd/-/resolve-cwd-3.0.0.tgz",
+      "integrity": "sha512-OrZaX2Mb+rJCpH/6CpSqt9xFVpN++x01XnN2ie9g6P5/3xelLAkXWVADpdz1IHD/KFfEXyE6V0U01OQ3UO2rEg==",
+      "dev": true,
+      "dependencies": {
+        "resolve-from": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/resolve-from": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz",
+      "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/resolve.exports": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/resolve.exports/-/resolve.exports-2.0.3.tgz",
+      "integrity": "sha512-OcXjMsGdhL4XnbShKpAcSqPMzQoYkYyhbEaeSko47MjRP9NfEQMhZkXL1DoFlt9LWQn4YttrdnV6X2OiyzBi+A==",
+      "dev": true,
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/router": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/router/-/router-2.2.0.tgz",
+      "integrity": "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==",
+      "dependencies": {
+        "debug": "^4.4.0",
+        "depd": "^2.0.0",
+        "is-promise": "^4.0.0",
+        "parseurl": "^1.3.3",
+        "path-to-regexp": "^8.0.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ]
+    },
+    "node_modules/safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg=="
+    },
+    "node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/send": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/send/-/send-1.2.0.tgz",
+      "integrity": "sha512-uaW0WwXKpL9blXE2o0bRhoL2EGXIrZxQ2ZQ4mgcfoBxdFmQold+qWsD2jLrfZ0trjKL6vOw0j//eAwcALFjKSw==",
+      "dependencies": {
+        "debug": "^4.3.5",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "etag": "^1.8.1",
+        "fresh": "^2.0.0",
+        "http-errors": "^2.0.0",
+        "mime-types": "^3.0.1",
+        "ms": "^2.1.3",
+        "on-finished": "^2.4.1",
+        "range-parser": "^1.2.1",
+        "statuses": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/serve-static": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-2.2.0.tgz",
+      "integrity": "sha512-61g9pCh0Vnh7IutZjtLGGpTA355+OPn2TyDv/6ivP2h/AdAVX9azsoxmg2/M6nZeQZNYBEwIcsne1mJd9oQItQ==",
+      "dependencies": {
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "parseurl": "^1.3.3",
+        "send": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/setprototypeof": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
+      "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw=="
+    },
+    "node_modules/shebang-command": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+      "dev": true,
+      "dependencies": {
+        "shebang-regex": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-regex": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/side-channel": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
+      "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3",
+        "side-channel-list": "^1.0.0",
+        "side-channel-map": "^1.0.1",
+        "side-channel-weakmap": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-list": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz",
+      "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-map": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
+      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-weakmap": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
+      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3",
+        "side-channel-map": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/signal-exit": {
+      "version": "3.0.7",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz",
+      "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==",
+      "dev": true
+    },
+    "node_modules/sisteransi": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz",
+      "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==",
+      "dev": true
+    },
+    "node_modules/slash": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz",
+      "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/source-map": {
+      "version": "0.6.1",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+      "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/source-map-support": {
+      "version": "0.5.13",
+      "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.13.tgz",
+      "integrity": "sha512-SHSKFHadjVA5oR4PPqhtAVdcBWwRYVd6g6cAXnIbRiIwc2EhPrTuKUBdSLvlEKyIP3GCf89fltvcZiP9MMFA1w==",
+      "dev": true,
+      "dependencies": {
+        "buffer-from": "^1.0.0",
+        "source-map": "^0.6.0"
+      }
+    },
+    "node_modules/sparse-bitfield": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/sparse-bitfield/-/sparse-bitfield-3.0.3.tgz",
+      "integrity": "sha512-kvzhi7vqKTfkh0PZU+2D2PIllw2ymqJKujUcyPMd9Y75Nv4nPbGJZXNhxsgdQab2BmlDct1YnfQCguEvHr7VsQ==",
+      "dependencies": {
+        "memory-pager": "^1.0.2"
+      }
+    },
+    "node_modules/sprintf-js": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
+      "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==",
+      "dev": true
+    },
+    "node_modules/stack-utils": {
+      "version": "2.0.6",
+      "resolved": "https://registry.npmjs.org/stack-utils/-/stack-utils-2.0.6.tgz",
+      "integrity": "sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ==",
+      "dev": true,
+      "dependencies": {
+        "escape-string-regexp": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/statuses": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
+      "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/string-length": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/string-length/-/string-length-4.0.2.tgz",
+      "integrity": "sha512-+l6rNN5fYHNhZZy41RXsYptCjA2Igmq4EG7kZAYFQI1E1VTXarr6ZPXBg6eq7Y6eK4FEhY6AJlyuFIb/v/S0VQ==",
+      "dev": true,
+      "dependencies": {
+        "char-regex": "^1.0.2",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "dev": true,
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "dev": true,
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-bom": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-4.0.0.tgz",
+      "integrity": "sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-final-newline": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz",
+      "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/strip-json-comments": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz",
+      "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==",
+      "dev": true,
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/supports-color": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+      "dev": true,
+      "dependencies": {
+        "has-flag": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/supports-preserve-symlinks-flag": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz",
+      "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/test-exclude": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/test-exclude/-/test-exclude-6.0.0.tgz",
+      "integrity": "sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w==",
+      "dev": true,
+      "dependencies": {
+        "@istanbuljs/schema": "^0.1.2",
+        "glob": "^7.1.4",
+        "minimatch": "^3.0.4"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/tmpl": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/tmpl/-/tmpl-1.0.5.tgz",
+      "integrity": "sha512-3f0uOEAQwIqGuWW2MVzYg8fV/QNnc/IpuJNG837rLuczAaLVHslWHZQj4IGiEl5Hs3kkbhwL9Ab7Hrsmuj+Smw==",
+      "dev": true
+    },
+    "node_modules/to-regex-range": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
+      "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
+      "dev": true,
+      "dependencies": {
+        "is-number": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=8.0"
+      }
+    },
+    "node_modules/toidentifier": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
+      "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
+      "engines": {
+        "node": ">=0.6"
+      }
+    },
+    "node_modules/tr46": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/tr46/-/tr46-5.1.1.tgz",
+      "integrity": "sha512-hdF5ZgjTqgAntKkklYw0R03MG2x/bSzTtkxmIRw/sTNV8YXsCJ1tfLAX23lhxhHJlEf3CRCOCGGWw3vI3GaSPw==",
+      "dependencies": {
+        "punycode": "^2.3.1"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/ts-jest": {
+      "version": "29.4.5",
+      "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.4.5.tgz",
+      "integrity": "sha512-HO3GyiWn2qvTQA4kTgjDcXiMwYQt68a1Y8+JuLRVpdIzm+UOLSHgl/XqR4c6nzJkq5rOkjc02O2I7P7l/Yof0Q==",
+      "dev": true,
+      "dependencies": {
+        "bs-logger": "^0.2.6",
+        "fast-json-stable-stringify": "^2.1.0",
+        "handlebars": "^4.7.8",
+        "json5": "^2.2.3",
+        "lodash.memoize": "^4.1.2",
+        "make-error": "^1.3.6",
+        "semver": "^7.7.3",
+        "type-fest": "^4.41.0",
+        "yargs-parser": "^21.1.1"
+      },
+      "bin": {
+        "ts-jest": "cli.js"
+      },
+      "engines": {
+        "node": "^14.15.0 || ^16.10.0 || ^18.0.0 || >=20.0.0"
+      },
+      "peerDependencies": {
+        "@babel/core": ">=7.0.0-beta.0 <8",
+        "@jest/transform": "^29.0.0 || ^30.0.0",
+        "@jest/types": "^29.0.0 || ^30.0.0",
+        "babel-jest": "^29.0.0 || ^30.0.0",
+        "jest": "^29.0.0 || ^30.0.0",
+        "jest-util": "^29.0.0 || ^30.0.0",
+        "typescript": ">=4.3 <6"
+      },
+      "peerDependenciesMeta": {
+        "@babel/core": {
+          "optional": true
+        },
+        "@jest/transform": {
+          "optional": true
+        },
+        "@jest/types": {
+          "optional": true
+        },
+        "babel-jest": {
+          "optional": true
+        },
+        "esbuild": {
+          "optional": true
+        },
+        "jest-util": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/ts-jest/node_modules/semver": {
+      "version": "7.7.3",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz",
+      "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==",
+      "dev": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/ts-jest/node_modules/type-fest": {
+      "version": "4.41.0",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-4.41.0.tgz",
+      "integrity": "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==",
+      "dev": true,
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/ts-node": {
+      "version": "10.9.2",
+      "resolved": "https://registry.npmjs.org/ts-node/-/ts-node-10.9.2.tgz",
+      "integrity": "sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==",
+      "dev": true,
+      "dependencies": {
+        "@cspotcode/source-map-support": "^0.8.0",
+        "@tsconfig/node10": "^1.0.7",
+        "@tsconfig/node12": "^1.0.7",
+        "@tsconfig/node14": "^1.0.0",
+        "@tsconfig/node16": "^1.0.2",
+        "acorn": "^8.4.1",
+        "acorn-walk": "^8.1.1",
+        "arg": "^4.1.0",
+        "create-require": "^1.1.0",
+        "diff": "^4.0.1",
+        "make-error": "^1.1.1",
+        "v8-compile-cache-lib": "^3.0.1",
+        "yn": "3.1.1"
+      },
+      "bin": {
+        "ts-node": "dist/bin.js",
+        "ts-node-cwd": "dist/bin-cwd.js",
+        "ts-node-esm": "dist/bin-esm.js",
+        "ts-node-script": "dist/bin-script.js",
+        "ts-node-transpile-only": "dist/bin-transpile.js",
+        "ts-script": "dist/bin-script-deprecated.js"
+      },
+      "peerDependencies": {
+        "@swc/core": ">=1.2.50",
+        "@swc/wasm": ">=1.2.50",
+        "@types/node": "*",
+        "typescript": ">=2.7"
+      },
+      "peerDependenciesMeta": {
+        "@swc/core": {
+          "optional": true
+        },
+        "@swc/wasm": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/type-detect": {
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.0.8.tgz",
+      "integrity": "sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==",
+      "dev": true,
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/type-fest": {
+      "version": "0.21.3",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.21.3.tgz",
+      "integrity": "sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==",
+      "dev": true,
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/type-is": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/type-is/-/type-is-2.0.1.tgz",
+      "integrity": "sha512-OZs6gsjF4vMp32qrCbiVSkrFmXtG/AZhY3t0iAMrMBiAZyV9oALtXO8hsrHbMXF9x6L3grlFuwW2oAz7cav+Gw==",
+      "dependencies": {
+        "content-type": "^1.0.5",
+        "media-typer": "^1.1.0",
+        "mime-types": "^3.0.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.9.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+      "dev": true,
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/uglify-js": {
+      "version": "3.19.3",
+      "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.3.tgz",
+      "integrity": "sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==",
+      "dev": true,
+      "optional": true,
+      "bin": {
+        "uglifyjs": "bin/uglifyjs"
+      },
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "dev": true
+    },
+    "node_modules/unpipe": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
+      "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/update-browserslist-db": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.3.tgz",
+      "integrity": "sha512-UxhIZQ+QInVdunkDAaiazvvT/+fXL5Osr0JZlJulepYu6Jd7qJtDZjlur0emRlT71EN3ScPoE7gvsuIKKNavKw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/browserslist"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "dependencies": {
+        "escalade": "^3.2.0",
+        "picocolors": "^1.1.1"
+      },
+      "bin": {
+        "update-browserslist-db": "cli.js"
+      },
+      "peerDependencies": {
+        "browserslist": ">= 4.21.0"
+      }
+    },
+    "node_modules/v8-compile-cache-lib": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz",
+      "integrity": "sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==",
+      "dev": true
+    },
+    "node_modules/v8-to-istanbul": {
+      "version": "9.3.0",
+      "resolved": "https://registry.npmjs.org/v8-to-istanbul/-/v8-to-istanbul-9.3.0.tgz",
+      "integrity": "sha512-kiGUalWN+rgBJ/1OHZsBtU4rXZOfj/7rKQxULKlIzwzQSvMJUUNgPwJEEh7gU6xEVxC0ahoOBvN2YI8GH6FNgA==",
+      "dev": true,
+      "dependencies": {
+        "@jridgewell/trace-mapping": "^0.3.12",
+        "@types/istanbul-lib-coverage": "^2.0.1",
+        "convert-source-map": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10.12.0"
+      }
+    },
+    "node_modules/v8-to-istanbul/node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.31",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+      "dev": true,
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.1.0",
+        "@jridgewell/sourcemap-codec": "^1.4.14"
+      }
+    },
+    "node_modules/vary": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
+      "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/walker": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/walker/-/walker-1.0.8.tgz",
+      "integrity": "sha512-ts/8E8l5b7kY0vlWLewOkDXMmPdLcVV4GmOQLyxuSswIJsweeFZtAsMF7k1Nszz+TYBQrlYRmzOnr398y1JemQ==",
+      "dev": true,
+      "dependencies": {
+        "makeerror": "1.0.12"
+      }
+    },
+    "node_modules/webidl-conversions": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-7.0.0.tgz",
+      "integrity": "sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g==",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/whatwg-url": {
+      "version": "14.2.0",
+      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-14.2.0.tgz",
+      "integrity": "sha512-De72GdQZzNTUBBChsXueQUnPKDkg/5A5zp7pFDuQAj5UFoENpiACU0wlCvzpAGnTkj++ihpKwKyYewn/XNUbKw==",
+      "dependencies": {
+        "tr46": "^5.1.0",
+        "webidl-conversions": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/which": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+      "dev": true,
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "node-which": "bin/node-which"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/wordwrap": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz",
+      "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==",
+      "dev": true
+    },
+    "node_modules/wrap-ansi": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+      "dev": true,
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "string-width": "^4.1.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/wrappy": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+      "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ=="
+    },
+    "node_modules/write-file-atomic": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/write-file-atomic/-/write-file-atomic-4.0.2.tgz",
+      "integrity": "sha512-7KxauUdBmSdWnmpaGFg+ppNjKF8uNLry8LyzjauQDOVONfFLNKrKvQOxZ/VuTIcS/gge/YNahf5RIIQWTSarlg==",
+      "dev": true,
+      "dependencies": {
+        "imurmurhash": "^0.1.4",
+        "signal-exit": "^3.0.7"
+      },
+      "engines": {
+        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+      }
+    },
+    "node_modules/y18n": {
+      "version": "5.0.8",
+      "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
+      "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",
+      "dev": true,
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/yallist": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz",
+      "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==",
+      "dev": true
+    },
+    "node_modules/yargs": {
+      "version": "17.7.2",
+      "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.2.tgz",
+      "integrity": "sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==",
+      "dev": true,
+      "dependencies": {
+        "cliui": "^8.0.1",
+        "escalade": "^3.1.1",
+        "get-caller-file": "^2.0.5",
+        "require-directory": "^2.1.1",
+        "string-width": "^4.2.3",
+        "y18n": "^5.0.5",
+        "yargs-parser": "^21.1.1"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/yargs-parser": {
+      "version": "21.1.1",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz",
+      "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==",
+      "dev": true,
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/yn": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/yn/-/yn-3.1.1.tgz",
+      "integrity": "sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/yocto-queue": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",
+      "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==",
+      "dev": true,
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    }
+  }
+}
diff --git a/server/java-spring/.env.example b/server/java-spring/.env.example
new file mode 100644
index 0000000..df7ce44
--- /dev/null
+++ b/server/java-spring/.env.example
@@ -0,0 +1,13 @@
+# MongoDB Connection
+# Replace with your MongoDB Atlas connection string or local MongoDB URI
+MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/?retryWrites=true&w=majority
+
+# Server Configuration
+# Port on which the Spring Boot application will run
+PORT=3001
+
+# CORS Configuration
+# Allowed origin for cross-origin requests (frontend URL)
+# For multiple origins, separate with commas
+CORS_ORIGIN=http://localhost:3000
+
diff --git a/server/java-spring/.gitignore b/server/java-spring/.gitignore
new file mode 100644
index 0000000..4a4b992
--- /dev/null
+++ b/server/java-spring/.gitignore
@@ -0,0 +1,66 @@
+# Java/Spring Boot - Specific Ignores
+# Common patterns (.env, .DS_Store, .idea/, .vscode/, logs) in root .gitignore
+
+# Compiled Files
+*.class
+*.ctxt
+.mtj.tmp/
+
+# Package Files
+*.jar
+*.war
+*.nar
+*.ear
+
+# Crash Logs
+hs_err_pid*
+replay_pid*
+
+# Maven
+target/
+pom.xml.tag
+pom.xml.releaseBackup
+pom.xml.versionsBackup
+pom.xml.next
+release.properties
+dependency-reduced-pom.xml
+buildNumber.properties
+.mvn/timing.properties
+.mvn/wrapper/maven-wrapper.jar
+
+# Gradle
+.gradle/
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+# IntelliJ IDEA
+*.iws
+*.iml
+*.ipr
+out/
+!**/src/main/**/out/
+!**/src/test/**/out/
+
+# Eclipse
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+bin/
+!**/src/main/**/bin/
+!**/src/test/**/bin/
+
+# NetBeans
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+
+# Spring Boot
+spring-boot-devtools.properties
diff --git a/server/java-spring/.mvn/wrapper/maven-wrapper.properties b/server/java-spring/.mvn/wrapper/maven-wrapper.properties
new file mode 100644
index 0000000..7fb0190
--- /dev/null
+++ b/server/java-spring/.mvn/wrapper/maven-wrapper.properties
@@ -0,0 +1,3 @@
+wrapperVersion=3.3.4
+distributionType=only-script
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.6/apache-maven-3.8.6-bin.zip
diff --git a/server/java-spring/README.md b/server/java-spring/README.md
new file mode 100644
index 0000000..20c2f87
--- /dev/null
+++ b/server/java-spring/README.md
@@ -0,0 +1,200 @@
+# MongoDB Sample MFlix - Java Spring Boot Backend [DRAFT]
+
+A Spring Boot REST API demonstrating MongoDB CRUD operations using the MongoDB Java Driver with the sample_mflix database.
+
+## Overview
+
+This application provides a REST API for managing movie data from MongoDB's sample_mflix database. It demonstrates:
+
+- Direct usage of the MongoDB Java Driver (not Spring Data MongoDB)
+- CRUD operations (Create, Read, Update, Delete)
+- Text search functionality
+- Filtering, sorting, and pagination
+- Comprehensive error handling
+- API documentation with Swagger/OpenAPI
+
+## Prerequisites
+
+- Java 17 or later
+- Maven 3.6 or later
+- MongoDB Atlas account or local MongoDB instance with sample_mflix database
+
+## Project Structure
+
+```
+server/java-spring/
+├── src/
+│   ├── main/
+│   │   ├── java/com/mongodb/samplemflix/
+│   │   │   ├── SampleMflixApplication.java    # Main application class
+│   │   │   ├── config/                         # Configuration classes
+│   │   │   │   ├── MongoConfig.java           # MongoDB client configuration
+│   │   │   │   ├── CorsConfig.java            # CORS configuration
+│   │   │   │   └── DatabaseVerification.java  # Startup database verification
+│   │   │   ├── controller/                     # REST controllers
+│   │   │   ├── service/                        # Business logic layer
+│   │   │   ├── repository/                     # Data access layer
+│   │   │   ├── model/                          # Domain models and DTOs
+│   │   │   ├── exception/                      # Custom exceptions
+│   │   │   └── util/                           # Utility classes
+│   │   └── resources/
+│   │       └── application.properties          # Application configuration
+│   └── test/                                   # Test classes
+├── pom.xml                                     # Maven dependencies
+└── README.md
+```
+
+## Setup Instructions
+
+### 1. Clone the Repository
+
+```bash
+git clone <repository-url>
+cd server/java-spring
+```
+
+### 2. Configure Environment Variables
+
+Copy the example environment file and update with your MongoDB connection details:
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env` and set your MongoDB connection string:
+
+```properties
+MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/?retryWrites=true&w=majority
+PORT=3001
+CORS_ORIGIN=http://localhost:3000
+```
+
+### 3. Load Sample Data
+
+If you haven't already, load the `sample_mflix` database into your MongoDB instance:
+
+- **MongoDB Atlas**: Use the "Load Sample Dataset" option in your cluster
+- **Local MongoDB**: Follow the [MongoDB sample data documentation](https://www.mongodb.com/docs/atlas/sample-data/)
+
+### 4. Build the Project
+
+```bash
+mvn clean install
+```
+
+### 5. Run the Application
+
+```bash
+mvn spring-boot:run
+```
+
+The application will start on `http://localhost:3001` (or the port specified in your `.env` file).
+
+## API Documentation
+
+Once the application is running, you can access:
+
+- **Swagger UI**: http://localhost:3001/swagger-ui.html
+- **OpenAPI JSON**: http://localhost:3001/api-docs
+
+## API Endpoints
+
+### Movies
+
+- `GET /api/movies` - Get all movies (with filtering, sorting, pagination)
+- `GET /api/movies/{id}` - Get a single movie by ID
+- `POST /api/movies` - Create a new movie
+- `POST /api/movies/batch` - Create multiple movies
+- `PUT /api/movies/{id}` - Update a movie
+- `PATCH /api/movies` - Update multiple movies
+- `DELETE /api/movies/{id}` - Delete a movie
+- `DELETE /api/movies` - Delete multiple movies
+- `DELETE /api/movies/{id}/find-and-delete` - Find and delete a movie
+
+> **Note**: Full endpoint implementation is planned for later phases. See the implementation plan for details.
+
+## Development
+
+### Running Tests
+
+```bash
+# Run all tests
+mvn test
+
+# Run tests with coverage
+mvn test jacoco:report
+```
+
+### Building for Production
+
+```bash
+mvn clean package
+java -jar target/sample-mflix-spring-1.0.0.jar
+```
+
+## Implementation Status
+
+This project is being implemented in phases:
+
+- ✅ **Phase 1**: Project Setup and Configuration (CURRENT)
+- ⏳ **Phase 2**: Database Configuration and Connection
+- ⏳ **Phase 3**: Model Layer Implementation
+- ⏳ **Phase 4**: Repository Layer
+- ⏳ **Phase 5**: Service Layer
+- ⏳ **Phase 6**: Controller Layer
+- ⏳ **Phase 7**: Error Handling
+- ⏳ **Phase 8**: Testing
+- ⏳ **Phase 9**: Documentation and Polish
+
+See `JAVA-SPRING-IMPLEMENTATION-PLAN.md` in the repository root for the complete implementation plan.
+
+## Technology Stack
+
+- **Framework**: Spring Boot 3.2.0
+- **Java Version**: 17
+- **MongoDB Driver**: MongoDB Java Driver 5.1.4 (Sync)
+- **Build Tool**: Maven
+- **API Documentation**: SpringDoc OpenAPI 2.3.0
+- **Testing**: JUnit 5, Mockito, Spring Boot Test
+
+## Educational Purpose
+
+This application is designed as an educational sample to demonstrate:
+
+1. How to use the MongoDB Java Driver directly (without Spring Data MongoDB)
+2. Best practices for Spring Boot REST API development
+3. Proper separation of concerns (Controller → Service → Repository)
+4. MongoDB CRUD operations and query patterns
+5. Error handling and validation in Spring Boot
+
+## Troubleshooting
+
+### Connection Issues
+
+If you encounter connection issues:
+
+1. Verify your `MONGODB_URI` is correct
+2. Check that your IP address is whitelisted in MongoDB Atlas
+3. Ensure the sample_mflix database exists and contains data
+4. Check the application logs for detailed error messages
+
+### Build Issues
+
+If Maven build fails:
+
+1. Ensure you have Java 17 or later installed: `java -version`
+2. Ensure Maven is installed: `mvn -version`
+3. Clear Maven cache: `mvn clean`
+4. Try rebuilding: `mvn clean install`
+
+## License
+
+[TBD]
+
+## Contributing
+
+[TBD]
+
+## Issues
+
+[TBD]
diff --git a/server/java-spring/mvnw b/server/java-spring/mvnw
new file mode 100755
index 0000000..bd8896b
--- /dev/null
+++ b/server/java-spring/mvnw
@@ -0,0 +1,295 @@
+#!/bin/sh
+# ----------------------------------------------------------------------------
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# ----------------------------------------------------------------------------
+
+# ----------------------------------------------------------------------------
+# Apache Maven Wrapper startup batch script, version 3.3.4
+#
+# Optional ENV vars
+# -----------------
+#   JAVA_HOME - location of a JDK home dir, required when download maven via java source
+#   MVNW_REPOURL - repo url base for downloading maven distribution
+#   MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven
+#   MVNW_VERBOSE - true: enable verbose log; debug: trace the mvnw script; others: silence the output
+# ----------------------------------------------------------------------------
+
+set -euf
+[ "${MVNW_VERBOSE-}" != debug ] || set -x
+
+# OS specific support.
+native_path() { printf %s\\n "$1"; }
+case "$(uname)" in
+CYGWIN* | MINGW*)
+  [ -z "${JAVA_HOME-}" ] || JAVA_HOME="$(cygpath --unix "$JAVA_HOME")"
+  native_path() { cygpath --path --windows "$1"; }
+  ;;
+esac
+
+# set JAVACMD and JAVACCMD
+set_java_home() {
+  # For Cygwin and MinGW, ensure paths are in Unix format before anything is touched
+  if [ -n "${JAVA_HOME-}" ]; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ]; then
+      # IBM's JDK on AIX uses strange locations for the executables
+      JAVACMD="$JAVA_HOME/jre/sh/java"
+      JAVACCMD="$JAVA_HOME/jre/sh/javac"
+    else
+      JAVACMD="$JAVA_HOME/bin/java"
+      JAVACCMD="$JAVA_HOME/bin/javac"
+
+      if [ ! -x "$JAVACMD" ] || [ ! -x "$JAVACCMD" ]; then
+        echo "The JAVA_HOME environment variable is not defined correctly, so mvnw cannot run." >&2
+        echo "JAVA_HOME is set to \"$JAVA_HOME\", but \"\$JAVA_HOME/bin/java\" or \"\$JAVA_HOME/bin/javac\" does not exist." >&2
+        return 1
+      fi
+    fi
+  else
+    JAVACMD="$(
+      'set' +e
+      'unset' -f command 2>/dev/null
+      'command' -v java
+    )" || :
+    JAVACCMD="$(
+      'set' +e
+      'unset' -f command 2>/dev/null
+      'command' -v javac
+    )" || :
+
+    if [ ! -x "${JAVACMD-}" ] || [ ! -x "${JAVACCMD-}" ]; then
+      echo "The java/javac command does not exist in PATH nor is JAVA_HOME set, so mvnw cannot run." >&2
+      return 1
+    fi
+  fi
+}
+
+# hash string like Java String::hashCode
+hash_string() {
+  str="${1:-}" h=0
+  while [ -n "$str" ]; do
+    char="${str%"${str#?}"}"
+    h=$(((h * 31 + $(LC_CTYPE=C printf %d "'$char")) % 4294967296))
+    str="${str#?}"
+  done
+  printf %x\\n $h
+}
+
+verbose() { :; }
+[ "${MVNW_VERBOSE-}" != true ] || verbose() { printf %s\\n "${1-}"; }
+
+die() {
+  printf %s\\n "$1" >&2
+  exit 1
+}
+
+trim() {
+  # MWRAPPER-139:
+  #   Trims trailing and leading whitespace, carriage returns, tabs, and linefeeds.
+  #   Needed for removing poorly interpreted newline sequences when running in more
+  #   exotic environments such as mingw bash on Windows.
+  printf "%s" "${1}" | tr -d '[:space:]'
+}
+
+scriptDir="$(dirname "$0")"
+scriptName="$(basename "$0")"
+
+# parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties
+while IFS="=" read -r key value; do
+  case "${key-}" in
+  distributionUrl) distributionUrl=$(trim "${value-}") ;;
+  distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;;
+  esac
+done <"$scriptDir/.mvn/wrapper/maven-wrapper.properties"
+[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties"
+
+case "${distributionUrl##*/}" in
+maven-mvnd-*bin.*)
+  MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/
+  case "${PROCESSOR_ARCHITECTURE-}${PROCESSOR_ARCHITEW6432-}:$(uname -a)" in
+  *AMD64:CYGWIN* | *AMD64:MINGW*) distributionPlatform=windows-amd64 ;;
+  :Darwin*x86_64) distributionPlatform=darwin-amd64 ;;
+  :Darwin*arm64) distributionPlatform=darwin-aarch64 ;;
+  :Linux*x86_64*) distributionPlatform=linux-amd64 ;;
+  *)
+    echo "Cannot detect native platform for mvnd on $(uname)-$(uname -m), use pure java version" >&2
+    distributionPlatform=linux-amd64
+    ;;
+  esac
+  distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip"
+  ;;
+maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;;
+*) MVN_CMD="mvn${scriptName#mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;;
+esac
+
+# apply MVNW_REPOURL and calculate MAVEN_HOME
+# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-<version>,maven-mvnd-<version>-<platform>}/<hash>
+[ -z "${MVNW_REPOURL-}" ] || distributionUrl="$MVNW_REPOURL$_MVNW_REPO_PATTERN${distributionUrl#*"$_MVNW_REPO_PATTERN"}"
+distributionUrlName="${distributionUrl##*/}"
+distributionUrlNameMain="${distributionUrlName%.*}"
+distributionUrlNameMain="${distributionUrlNameMain%-bin}"
+MAVEN_USER_HOME="${MAVEN_USER_HOME:-${HOME}/.m2}"
+MAVEN_HOME="${MAVEN_USER_HOME}/wrapper/dists/${distributionUrlNameMain-}/$(hash_string "$distributionUrl")"
+
+exec_maven() {
+  unset MVNW_VERBOSE MVNW_USERNAME MVNW_PASSWORD MVNW_REPOURL || :
+  exec "$MAVEN_HOME/bin/$MVN_CMD" "$@" || die "cannot exec $MAVEN_HOME/bin/$MVN_CMD"
+}
+
+if [ -d "$MAVEN_HOME" ]; then
+  verbose "found existing MAVEN_HOME at $MAVEN_HOME"
+  exec_maven "$@"
+fi
+
+case "${distributionUrl-}" in
+*?-bin.zip | *?maven-mvnd-?*-?*.zip) ;;
+*) die "distributionUrl is not valid, must match *-bin.zip or maven-mvnd-*.zip, but found '${distributionUrl-}'" ;;
+esac
+
+# prepare tmp dir
+if TMP_DOWNLOAD_DIR="$(mktemp -d)" && [ -d "$TMP_DOWNLOAD_DIR" ]; then
+  clean() { rm -rf -- "$TMP_DOWNLOAD_DIR"; }
+  trap clean HUP INT TERM EXIT
+else
+  die "cannot create temp dir"
+fi
+
+mkdir -p -- "${MAVEN_HOME%/*}"
+
+# Download and Install Apache Maven
+verbose "Couldn't find MAVEN_HOME, downloading and installing it ..."
+verbose "Downloading from: $distributionUrl"
+verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName"
+
+# select .zip or .tar.gz
+if ! command -v unzip >/dev/null; then
+  distributionUrl="${distributionUrl%.zip}.tar.gz"
+  distributionUrlName="${distributionUrl##*/}"
+fi
+
+# verbose opt
+__MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR=''
+[ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v
+
+# normalize http auth
+case "${MVNW_PASSWORD:+has-password}" in
+'') MVNW_USERNAME='' MVNW_PASSWORD='' ;;
+has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;;
+esac
+
+if [ -z "${MVNW_USERNAME-}" ] && command -v wget >/dev/null; then
+  verbose "Found wget ... using wget"
+  wget ${__MVNW_QUIET_WGET:+"$__MVNW_QUIET_WGET"} "$distributionUrl" -O "$TMP_DOWNLOAD_DIR/$distributionUrlName" || die "wget: Failed to fetch $distributionUrl"
+elif [ -z "${MVNW_USERNAME-}" ] && command -v curl >/dev/null; then
+  verbose "Found curl ... using curl"
+  curl ${__MVNW_QUIET_CURL:+"$__MVNW_QUIET_CURL"} -f -L -o "$TMP_DOWNLOAD_DIR/$distributionUrlName" "$distributionUrl" || die "curl: Failed to fetch $distributionUrl"
+elif set_java_home; then
+  verbose "Falling back to use Java to download"
+  javaSource="$TMP_DOWNLOAD_DIR/Downloader.java"
+  targetZip="$TMP_DOWNLOAD_DIR/$distributionUrlName"
+  cat >"$javaSource" <<-END
+	public class Downloader extends java.net.Authenticator
+	{
+	  protected java.net.PasswordAuthentication getPasswordAuthentication()
+	  {
+	    return new java.net.PasswordAuthentication( System.getenv( "MVNW_USERNAME" ), System.getenv( "MVNW_PASSWORD" ).toCharArray() );
+	  }
+	  public static void main( String[] args ) throws Exception
+	  {
+	    setDefault( new Downloader() );
+	    java.nio.file.Files.copy( java.net.URI.create( args[0] ).toURL().openStream(), java.nio.file.Paths.get( args[1] ).toAbsolutePath().normalize() );
+	  }
+	}
+	END
+  # For Cygwin/MinGW, switch paths to Windows format before running javac and java
+  verbose " - Compiling Downloader.java ..."
+  "$(native_path "$JAVACCMD")" "$(native_path "$javaSource")" || die "Failed to compile Downloader.java"
+  verbose " - Running Downloader.java ..."
+  "$(native_path "$JAVACMD")" -cp "$(native_path "$TMP_DOWNLOAD_DIR")" Downloader "$distributionUrl" "$(native_path "$targetZip")"
+fi
+
+# If specified, validate the SHA-256 sum of the Maven distribution zip file
+if [ -n "${distributionSha256Sum-}" ]; then
+  distributionSha256Result=false
+  if [ "$MVN_CMD" = mvnd.sh ]; then
+    echo "Checksum validation is not supported for maven-mvnd." >&2
+    echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2
+    exit 1
+  elif command -v sha256sum >/dev/null; then
+    if echo "$distributionSha256Sum  $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c - >/dev/null 2>&1; then
+      distributionSha256Result=true
+    fi
+  elif command -v shasum >/dev/null; then
+    if echo "$distributionSha256Sum  $TMP_DOWNLOAD_DIR/$distributionUrlName" | shasum -a 256 -c >/dev/null 2>&1; then
+      distributionSha256Result=true
+    fi
+  else
+    echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." >&2
+    echo "Please install either command, or disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2
+    exit 1
+  fi
+  if [ $distributionSha256Result = false ]; then
+    echo "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised." >&2
+    echo "If you updated your Maven version, you need to update the specified distributionSha256Sum property." >&2
+    exit 1
+  fi
+fi
+
+# unzip and move
+if command -v unzip >/dev/null; then
+  unzip ${__MVNW_QUIET_UNZIP:+"$__MVNW_QUIET_UNZIP"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -d "$TMP_DOWNLOAD_DIR" || die "failed to unzip"
+else
+  tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar"
+fi
+
+# Find the actual extracted directory name (handles snapshots where filename != directory name)
+actualDistributionDir=""
+
+# First try the expected directory name (for regular distributions)
+if [ -d "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" ]; then
+  if [ -f "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/bin/$MVN_CMD" ]; then
+    actualDistributionDir="$distributionUrlNameMain"
+  fi
+fi
+
+# If not found, search for any directory with the Maven executable (for snapshots)
+if [ -z "$actualDistributionDir" ]; then
+  # enable globbing to iterate over items
+  set +f
+  for dir in "$TMP_DOWNLOAD_DIR"/*; do
+    if [ -d "$dir" ]; then
+      if [ -f "$dir/bin/$MVN_CMD" ]; then
+        actualDistributionDir="$(basename "$dir")"
+        break
+      fi
+    fi
+  done
+  set -f
+fi
+
+if [ -z "$actualDistributionDir" ]; then
+  verbose "Contents of $TMP_DOWNLOAD_DIR:"
+  verbose "$(ls -la "$TMP_DOWNLOAD_DIR")"
+  die "Could not find Maven distribution directory in extracted archive"
+fi
+
+verbose "Found extracted Maven distribution directory: $actualDistributionDir"
+printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$actualDistributionDir/mvnw.url"
+mv -- "$TMP_DOWNLOAD_DIR/$actualDistributionDir" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME"
+
+clean || :
+exec_maven "$@"
diff --git a/server/java-spring/mvnw.cmd b/server/java-spring/mvnw.cmd
new file mode 100644
index 0000000..5761d94
--- /dev/null
+++ b/server/java-spring/mvnw.cmd
@@ -0,0 +1,189 @@
+<# : batch portion
+@REM ----------------------------------------------------------------------------
+@REM Licensed to the Apache Software Foundation (ASF) under one
+@REM or more contributor license agreements.  See the NOTICE file
+@REM distributed with this work for additional information
+@REM regarding copyright ownership.  The ASF licenses this file
+@REM to you under the Apache License, Version 2.0 (the
+@REM "License"); you may not use this file except in compliance
+@REM with the License.  You may obtain a copy of the License at
+@REM
+@REM    http://www.apache.org/licenses/LICENSE-2.0
+@REM
+@REM Unless required by applicable law or agreed to in writing,
+@REM software distributed under the License is distributed on an
+@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+@REM KIND, either express or implied.  See the License for the
+@REM specific language governing permissions and limitations
+@REM under the License.
+@REM ----------------------------------------------------------------------------
+
+@REM ----------------------------------------------------------------------------
+@REM Apache Maven Wrapper startup batch script, version 3.3.4
+@REM
+@REM Optional ENV vars
+@REM   MVNW_REPOURL - repo url base for downloading maven distribution
+@REM   MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven
+@REM   MVNW_VERBOSE - true: enable verbose log; others: silence the output
+@REM ----------------------------------------------------------------------------
+
+@IF "%__MVNW_ARG0_NAME__%"=="" (SET __MVNW_ARG0_NAME__=%~nx0)
+@SET __MVNW_CMD__=
+@SET __MVNW_ERROR__=
+@SET __MVNW_PSMODULEP_SAVE=%PSModulePath%
+@SET PSModulePath=
+@FOR /F "usebackq tokens=1* delims==" %%A IN (`powershell -noprofile "& {$scriptDir='%~dp0'; $script='%__MVNW_ARG0_NAME__%'; icm -ScriptBlock ([Scriptblock]::Create((Get-Content -Raw '%~f0'))) -NoNewScope}"`) DO @(
+  IF "%%A"=="MVN_CMD" (set __MVNW_CMD__=%%B) ELSE IF "%%B"=="" (echo %%A) ELSE (echo %%A=%%B)
+)
+@SET PSModulePath=%__MVNW_PSMODULEP_SAVE%
+@SET __MVNW_PSMODULEP_SAVE=
+@SET __MVNW_ARG0_NAME__=
+@SET MVNW_USERNAME=
+@SET MVNW_PASSWORD=
+@IF NOT "%__MVNW_CMD__%"=="" ("%__MVNW_CMD__%" %*)
+@echo Cannot start maven from wrapper >&2 && exit /b 1
+@GOTO :EOF
+: end batch / begin powershell #>
+
+$ErrorActionPreference = "Stop"
+if ($env:MVNW_VERBOSE -eq "true") {
+  $VerbosePreference = "Continue"
+}
+
+# calculate distributionUrl, requires .mvn/wrapper/maven-wrapper.properties
+$distributionUrl = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionUrl
+if (!$distributionUrl) {
+  Write-Error "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties"
+}
+
+switch -wildcard -casesensitive ( $($distributionUrl -replace '^.*/','') ) {
+  "maven-mvnd-*" {
+    $USE_MVND = $true
+    $distributionUrl = $distributionUrl -replace '-bin\.[^.]*$',"-windows-amd64.zip"
+    $MVN_CMD = "mvnd.cmd"
+    break
+  }
+  default {
+    $USE_MVND = $false
+    $MVN_CMD = $script -replace '^mvnw','mvn'
+    break
+  }
+}
+
+# apply MVNW_REPOURL and calculate MAVEN_HOME
+# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-<version>,maven-mvnd-<version>-<platform>}/<hash>
+if ($env:MVNW_REPOURL) {
+  $MVNW_REPO_PATTERN = if ($USE_MVND -eq $False) { "/org/apache/maven/" } else { "/maven/mvnd/" }
+  $distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace "^.*$MVNW_REPO_PATTERN",'')"
+}
+$distributionUrlName = $distributionUrl -replace '^.*/',''
+$distributionUrlNameMain = $distributionUrlName -replace '\.[^.]*$','' -replace '-bin$',''
+
+$MAVEN_M2_PATH = "$HOME/.m2"
+if ($env:MAVEN_USER_HOME) {
+  $MAVEN_M2_PATH = "$env:MAVEN_USER_HOME"
+}
+
+if (-not (Test-Path -Path $MAVEN_M2_PATH)) {
+    New-Item -Path $MAVEN_M2_PATH -ItemType Directory | Out-Null
+}
+
+$MAVEN_WRAPPER_DISTS = $null
+if ((Get-Item $MAVEN_M2_PATH).Target[0] -eq $null) {
+  $MAVEN_WRAPPER_DISTS = "$MAVEN_M2_PATH/wrapper/dists"
+} else {
+  $MAVEN_WRAPPER_DISTS = (Get-Item $MAVEN_M2_PATH).Target[0] + "/wrapper/dists"
+}
+
+$MAVEN_HOME_PARENT = "$MAVEN_WRAPPER_DISTS/$distributionUrlNameMain"
+$MAVEN_HOME_NAME = ([System.Security.Cryptography.SHA256]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join ''
+$MAVEN_HOME = "$MAVEN_HOME_PARENT/$MAVEN_HOME_NAME"
+
+if (Test-Path -Path "$MAVEN_HOME" -PathType Container) {
+  Write-Verbose "found existing MAVEN_HOME at $MAVEN_HOME"
+  Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD"
+  exit $?
+}
+
+if (! $distributionUrlNameMain -or ($distributionUrlName -eq $distributionUrlNameMain)) {
+  Write-Error "distributionUrl is not valid, must end with *-bin.zip, but found $distributionUrl"
+}
+
+# prepare tmp dir
+$TMP_DOWNLOAD_DIR_HOLDER = New-TemporaryFile
+$TMP_DOWNLOAD_DIR = New-Item -Itemtype Directory -Path "$TMP_DOWNLOAD_DIR_HOLDER.dir"
+$TMP_DOWNLOAD_DIR_HOLDER.Delete() | Out-Null
+trap {
+  if ($TMP_DOWNLOAD_DIR.Exists) {
+    try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null }
+    catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" }
+  }
+}
+
+New-Item -Itemtype Directory -Path "$MAVEN_HOME_PARENT" -Force | Out-Null
+
+# Download and Install Apache Maven
+Write-Verbose "Couldn't find MAVEN_HOME, downloading and installing it ..."
+Write-Verbose "Downloading from: $distributionUrl"
+Write-Verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName"
+
+$webclient = New-Object System.Net.WebClient
+if ($env:MVNW_USERNAME -and $env:MVNW_PASSWORD) {
+  $webclient.Credentials = New-Object System.Net.NetworkCredential($env:MVNW_USERNAME, $env:MVNW_PASSWORD)
+}
+[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
+$webclient.DownloadFile($distributionUrl, "$TMP_DOWNLOAD_DIR/$distributionUrlName") | Out-Null
+
+# If specified, validate the SHA-256 sum of the Maven distribution zip file
+$distributionSha256Sum = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionSha256Sum
+if ($distributionSha256Sum) {
+  if ($USE_MVND) {
+    Write-Error "Checksum validation is not supported for maven-mvnd. `nPlease disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties."
+  }
+  Import-Module $PSHOME\Modules\Microsoft.PowerShell.Utility -Function Get-FileHash
+  if ((Get-FileHash "$TMP_DOWNLOAD_DIR/$distributionUrlName" -Algorithm SHA256).Hash.ToLower() -ne $distributionSha256Sum) {
+    Write-Error "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised. If you updated your Maven version, you need to update the specified distributionSha256Sum property."
+  }
+}
+
+# unzip and move
+Expand-Archive "$TMP_DOWNLOAD_DIR/$distributionUrlName" -DestinationPath "$TMP_DOWNLOAD_DIR" | Out-Null
+
+# Find the actual extracted directory name (handles snapshots where filename != directory name)
+$actualDistributionDir = ""
+
+# First try the expected directory name (for regular distributions)
+$expectedPath = Join-Path "$TMP_DOWNLOAD_DIR" "$distributionUrlNameMain"
+$expectedMvnPath = Join-Path "$expectedPath" "bin/$MVN_CMD"
+if ((Test-Path -Path $expectedPath -PathType Container) -and (Test-Path -Path $expectedMvnPath -PathType Leaf)) {
+  $actualDistributionDir = $distributionUrlNameMain
+}
+
+# If not found, search for any directory with the Maven executable (for snapshots)
+if (!$actualDistributionDir) {
+  Get-ChildItem -Path "$TMP_DOWNLOAD_DIR" -Directory | ForEach-Object {
+    $testPath = Join-Path $_.FullName "bin/$MVN_CMD"
+    if (Test-Path -Path $testPath -PathType Leaf) {
+      $actualDistributionDir = $_.Name
+    }
+  }
+}
+
+if (!$actualDistributionDir) {
+  Write-Error "Could not find Maven distribution directory in extracted archive"
+}
+
+Write-Verbose "Found extracted Maven distribution directory: $actualDistributionDir"
+Rename-Item -Path "$TMP_DOWNLOAD_DIR/$actualDistributionDir" -NewName $MAVEN_HOME_NAME | Out-Null
+try {
+  Move-Item -Path "$TMP_DOWNLOAD_DIR/$MAVEN_HOME_NAME" -Destination $MAVEN_HOME_PARENT | Out-Null
+} catch {
+  if (! (Test-Path -Path "$MAVEN_HOME" -PathType Container)) {
+    Write-Error "fail to move MAVEN_HOME"
+  }
+} finally {
+  try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null }
+  catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" }
+}
+
+Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD"
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
new file mode 100644
index 0000000..3dc71af
--- /dev/null
+++ b/server/java-spring/pom.xml
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
+         https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>3.5.7</version>
+        <relativePath/>
+    </parent>
+    
+    <groupId>com.mongodb</groupId>
+    <artifactId>sample-mflix-spring</artifactId>
+    <version>1.0.0</version>
+    <name>MongoDB Sample MFlix Spring API</name>
+    <description>Spring Boot backend for MongoDB sample mflix application demonstrating CRUD operations using MongoDB Java Driver</description>
+    
+    <properties>
+        <java.version>17</java.version>
+        <mongodb.driver.version>5.6.1</mongodb.driver.version>
+        <springdoc.version>2.8.13</springdoc.version>
+    </properties>
+    
+    <dependencies>
+        <!-- Spring Boot Web Starter -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        
+        <!-- Spring Boot Validation Starter -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+        </dependency>
+        
+        <!-- MongoDB Java Driver (Sync) -->
+        <dependency>
+            <groupId>org.mongodb</groupId>
+            <artifactId>mongodb-driver-sync</artifactId>
+            <version>${mongodb.driver.version}</version>
+        </dependency>
+        
+        <!-- Lombok for reducing boilerplate code -->
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <optional>true</optional>
+        </dependency>
+        
+        <!-- SpringDoc OpenAPI (Swagger UI) -->
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+            <version>${springdoc.version}</version>
+        </dependency>
+        
+        <!-- Spring Boot Test Starter -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+    
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <configuration>
+                    <excludes>
+                        <exclude>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok</artifactId>
+                        </exclude>
+                    </excludes>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+</project>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
new file mode 100644
index 0000000..52f367b
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
@@ -0,0 +1,23 @@
+package com.mongodb.samplemflix;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+/**
+ * Main Spring Boot application class for the MongoDB Sample MFlix API.
+ * 
+ * This application demonstrates MongoDB CRUD operations using the MongoDB Java Driver
+ * in a Spring Boot environment. It provides a REST API for managing movie data from
+ * the sample_mflix database.
+ * 
+ * @author MongoDB Documentation Team
+ * @version 1.0
+ */
+@SpringBootApplication
+public class SampleMflixApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(SampleMflixApplication.class, args);
+    }
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
new file mode 100644
index 0000000..f1a9ae6
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
@@ -0,0 +1,53 @@
+package com.mongodb.samplemflix.config;
+
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.cors.CorsConfiguration;
+import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
+import org.springframework.web.filter.CorsFilter;
+
+import java.util.Arrays;
+
+/**
+ * CORS (Cross-Origin Resource Sharing) configuration for the Sample MFlix API.
+ * 
+ * This configuration allows the frontend application (typically running on a different port
+ * during development) to make requests to this backend API.
+ * 
+ * The allowed origins are configured via the CORS_ORIGIN environment variable.
+ */
+@Configuration
+public class CorsConfig {
+
+    @Value("${cors.allowed.origins}")
+    private String allowedOrigins;
+
+    /**
+     * Configures CORS filter to allow cross-origin requests from the frontend.
+     * 
+     * @return configured CorsFilter
+     */
+    @Bean
+    public CorsFilter corsFilter() {
+        CorsConfiguration config = new CorsConfiguration();
+        
+        // Allow credentials (cookies, authorization headers)
+        config.setAllowCredentials(true);
+        
+        // Set allowed origins from environment variable
+        config.setAllowedOrigins(Arrays.asList(allowedOrigins.split(",")));
+        
+        // Allow all headers
+        config.addAllowedHeader("*");
+        
+        // Allow all HTTP methods
+        config.addAllowedMethod("*");
+        
+        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
+        source.registerCorsConfiguration("/**", config);
+        
+        return new CorsFilter(source);
+    }
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
new file mode 100644
index 0000000..38cb728
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -0,0 +1,145 @@
+package com.mongodb.samplemflix.config;
+
+import com.mongodb.client.MongoCollection;
+import com.mongodb.client.MongoDatabase;
+import com.mongodb.client.model.IndexOptions;
+import com.mongodb.client.model.Indexes;
+import org.bson.Document;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.stereotype.Component;
+
+import jakarta.annotation.PostConstruct;
+
+/**
+ * Database verification component that runs on application startup.
+ *
+ * This component performs pre-flight checks to ensure the MongoDB database
+ * is properly configured and contains the expected data and indexes.
+ *
+ * Verification steps:
+ * 1. Check if the movies collection exists
+ * 2. Verify the collection contains documents
+ * 3. Check for text search indexes on plot, title, and fullplot fields
+ * 4. Create text search index if missing
+ *
+ * This matches the behavior of the Express.js backend's verifyRequirements() function.
+ * The verification is non-blocking - the application will start even if verification fails,
+ * but warnings will be logged to help developers identify configuration issues.
+ */
+@Component
+public class DatabaseVerification {
+
+    private static final Logger logger = LoggerFactory.getLogger(DatabaseVerification.class);
+
+    private static final String MOVIES_COLLECTION = "movies";
+    private static final String TEXT_INDEX_NAME = "text_search_index";
+
+    private final MongoDatabase database;
+
+    public DatabaseVerification(MongoDatabase database) {
+        this.database = database;
+    }
+
+    /**
+     * Runs database verification checks after the bean is constructed.
+     *
+     * This method is called automatically by Spring after dependency injection
+     * is complete. It performs all verification steps and logs the results.
+     *
+     * The method catches all exceptions to prevent application startup failure,
+     * but logs errors to help developers identify issues.
+     */
+    @PostConstruct
+    public void verifyDatabase() {
+        logger.info("Starting database verification for '{}'...", database.getName());
+
+        try {
+            // Verify movies collection exists and has data
+            verifyMoviesCollection();
+
+            logger.info("Database verification completed successfully");
+
+        } catch (Exception e) {
+            logger.error("Database verification failed: {}", e.getMessage(), e);
+            // Don't throw exception - allow application to start even if verification fails
+            // This allows developers to troubleshoot connection issues without preventing startup
+        }
+    }
+
+    /**
+     * Verifies the movies collection exists, contains data, and has required indexes.
+     *
+     * This method:
+     * 1. Checks if the movies collection exists (implicitly by accessing it)
+     * 2. Counts documents to verify sample data is loaded
+     * 3. Creates a text search index on plot, title, and fullplot fields
+     *
+     * The text search index enables full-text search functionality across movie
+     * descriptions and titles, which is used by the search endpoint.
+     */
+    private void verifyMoviesCollection() {
+        MongoCollection<Document> moviesCollection = database.getCollection(MOVIES_COLLECTION);
+
+        // Check if collection has documents
+        // Using estimatedDocumentCount() for better performance (doesn't scan all documents)
+        long count = moviesCollection.estimatedDocumentCount();
+
+        logger.info("Movies collection found with {} documents", count);
+
+        if (count == 0) {
+            logger.warn(
+                "Movies collection is empty. Please ensure sample_mflix data is loaded. " +
+                "Visit https://www.mongodb.com/docs/atlas/sample-data/ for instructions."
+            );
+        }
+
+        // Create text search index for full-text search functionality
+        createTextSearchIndex(moviesCollection);
+    }
+
+    /**
+     * Creates a text search index on the movies collection if it doesn't already exist.
+     *
+     * The index is created on three fields:
+     * - plot: Short movie description
+     * - title: Movie title
+     * - fullplot: Full movie description
+     *
+     * This enables the $text search operator to perform full-text search across
+     * these fields, which is used by the search endpoint in the API.
+     *
+     * The index is created in the background to avoid blocking other operations.
+     * If the index already exists, MongoDB will ignore the duplicate creation request.
+     *
+     * @param moviesCollection the movies collection to create the index on
+     */
+    private void createTextSearchIndex(MongoCollection<Document> moviesCollection) {
+        try {
+            // Create compound text index on plot, title, and fullplot fields
+            // The background option allows the index to be built without blocking other operations
+            IndexOptions indexOptions = new IndexOptions()
+                    .name(TEXT_INDEX_NAME)
+                    .background(true);
+
+            // Create the text index
+            // MongoDB will automatically ignore this if the index already exists
+            moviesCollection.createIndex(
+                Indexes.compoundIndex(
+                    Indexes.text("plot"),
+                    Indexes.text("title"),
+                    Indexes.text("fullplot")
+                ),
+                indexOptions
+            );
+
+            logger.info("Text search index '{}' created/verified for movies collection", TEXT_INDEX_NAME);
+
+        } catch (Exception e) {
+            // Log error but don't fail - the application can still function without the index
+            // (though text search queries will fail)
+            logger.error("Could not create text search index: {}", e.getMessage());
+            logger.warn("Text search functionality may not work without the index");
+        }
+    }
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
new file mode 100644
index 0000000..ee6a58e
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
@@ -0,0 +1,110 @@
+package com.mongodb.samplemflix.config;
+
+import com.mongodb.ConnectionString;
+import com.mongodb.MongoClientSettings;
+import com.mongodb.client.MongoClient;
+import com.mongodb.client.MongoClients;
+import com.mongodb.client.MongoDatabase;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+import java.util.concurrent.TimeUnit;
+
+/**
+ * MongoDB configuration class for the Sample MFlix application.
+ *
+ * This class configures the MongoDB client connection using the MongoDB Java Driver.
+ * It creates singleton beans for MongoClient and MongoDatabase that will be injected
+ * throughout the application.
+ *
+ * Key features:
+ * - Connection pooling with configurable settings (max 100 connections, min 10)
+ * - Connection timeout configuration (10 seconds for connect and read)
+ * - Graceful shutdown handling (managed by Spring's bean lifecycle)
+ * - Connection string validation
+ *
+ * The MongoClient is thread-safe and designed to be shared across the application.
+ * Spring automatically manages the lifecycle and closes the client on shutdown.
+ */
+@Configuration
+public class MongoConfig {
+
+    @Value("${spring.data.mongodb.uri}")
+    private String mongoUri;
+
+    @Value("${spring.data.mongodb.database}")
+    private String databaseName;
+
+    /**
+     * Creates and configures the MongoDB client with connection pooling and timeout settings.
+     *
+     * Connection Pool Settings:
+     * - Max pool size: 100 connections (handles high concurrent load)
+     * - Min pool size: 10 connections (maintains ready connections)
+     * - Max connection idle time: 60 seconds (releases idle connections)
+     * - Max wait time: 10 seconds (time to wait for available connection)
+     *
+     * Socket Settings:
+     * - Connect timeout: 10 seconds (time to establish connection)
+     * - Read timeout: 10 seconds (time to wait for server response)
+     *
+     * The MongoClient is thread-safe and should be shared across the application.
+     * Spring will automatically close this client when the application shuts down.
+     *
+     * @return configured MongoClient instance
+     * @throws IllegalArgumentException if connection string is invalid
+     */
+    @Bean
+    public MongoClient mongoClient() {
+        // Validate connection string is not empty
+        if (mongoUri == null || mongoUri.trim().isEmpty()) {
+            throw new IllegalArgumentException(
+                "MONGODB_URI is not configured. Please check application.properties"
+            );
+        }
+
+        // Parse and validate the connection string
+        ConnectionString connectionString = new ConnectionString(mongoUri);
+
+        // Build client settings with connection pooling and timeouts
+        // These settings optimize for both performance and resource management
+        MongoClientSettings settings = MongoClientSettings.builder()
+                .applyConnectionString(connectionString)
+                // Configure connection pool for optimal performance
+                .applyToConnectionPoolSettings(builder ->
+                    builder.maxSize(100)                                    // Maximum connections in pool
+                           .minSize(10)                                     // Minimum connections to maintain
+                           .maxConnectionIdleTime(60000, TimeUnit.MILLISECONDS)  // Release idle connections after 60s
+                           .maxWaitTime(10000, TimeUnit.MILLISECONDS)       // Wait up to 10s for available connection
+                )
+                // Configure socket timeouts to prevent hanging connections
+                .applyToSocketSettings(builder ->
+                    builder.connectTimeout(10000, TimeUnit.MILLISECONDS)    // 10s to establish connection
+                           .readTimeout(10000, TimeUnit.MILLISECONDS)       // 10s to wait for server response
+                )
+                // Configure server selection timeout
+                .applyToClusterSettings(builder ->
+                    builder.serverSelectionTimeout(10000, TimeUnit.MILLISECONDS)  // 10s to select server
+                )
+                .build();
+
+        return MongoClients.create(settings);
+    }
+
+    /**
+     * Creates a reference to the MongoDB database.
+     *
+     * This bean provides access to the sample_mflix database and can be injected
+     * into repositories and services throughout the application.
+     *
+     * The database name is configured in application.properties and defaults to "sample_mflix".
+     *
+     * @param mongoClient the MongoDB client (injected by Spring)
+     * @return MongoDatabase instance for the configured database
+     */
+    @Bean
+    public MongoDatabase mongoDatabase(MongoClient mongoClient) {
+        return mongoClient.getDatabase(databaseName);
+    }
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieController.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieController.java
new file mode 100644
index 0000000..463e27c
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieController.java
@@ -0,0 +1,31 @@
+package com.mongodb.samplemflix.controller;
+
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+/**
+ * REST controller for movie-related endpoints.
+ * 
+ * This controller handles all HTTP requests for movie operations including:
+ * - GET /api/movies - Get all movies with filtering, sorting, and pagination
+ * - GET /api/movies/{id} - Get a single movie by ID
+ * - POST /api/movies - Create a new movie
+ * - POST /api/movies/batch - Create multiple movies
+ * - PUT /api/movies/{id} - Update a movie
+ * - PATCH /api/movies - Update multiple movies
+ * - DELETE /api/movies/{id} - Delete a movie
+ * - DELETE /api/movies - Delete multiple movies
+ * - DELETE /api/movies/{id}/find-and-delete - Find and delete a movie
+ * 
+ * TODO: Phase 6 - Implement all REST endpoints
+ * TODO: Phase 6 - Add request validation
+ * TODO: Phase 6 - Add API documentation annotations
+ */
+@RestController
+@RequestMapping("/api/movies")
+public class MovieController {
+    
+    // TODO: Phase 6 - Inject MovieService
+    // TODO: Phase 6 - Implement endpoint methods
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
new file mode 100644
index 0000000..4fbfaf8
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
@@ -0,0 +1,26 @@
+package com.mongodb.samplemflix.exception;
+
+import org.springframework.web.bind.annotation.ControllerAdvice;
+
+/**
+ * Global exception handler for the application.
+ * 
+ * This class uses @ControllerAdvice to handle exceptions thrown by controllers
+ * and convert them into appropriate HTTP responses.
+ * 
+ * Exception types to handle:
+ * - ResourceNotFoundException (404)
+ * - ValidationException (400)
+ * - DuplicateKeyException (409)
+ * - MongoException (500)
+ * - General exceptions (500)
+ * 
+ * TODO: Phase 7 - Implement exception handler methods
+ * TODO: Phase 7 - Add @ExceptionHandler methods for each exception type
+ */
+@ControllerAdvice
+public class GlobalExceptionHandler {
+    
+    // TODO: Phase 7 - Implement exception handlers
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ResourceNotFoundException.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ResourceNotFoundException.java
new file mode 100644
index 0000000..ac2c81c
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ResourceNotFoundException.java
@@ -0,0 +1,20 @@
+package com.mongodb.samplemflix.exception;
+
+/**
+ * Exception thrown when a requested resource is not found.
+ * 
+ * This exception results in a 404 Not Found response.
+ * 
+ * TODO: Phase 7 - Implement custom exception
+ */
+public class ResourceNotFoundException extends RuntimeException {
+    
+    public ResourceNotFoundException(String message) {
+        super(message);
+    }
+    
+    public ResourceNotFoundException(String message, Throwable cause) {
+        super(message, cause);
+    }
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java
new file mode 100644
index 0000000..84175df
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java
@@ -0,0 +1,20 @@
+package com.mongodb.samplemflix.exception;
+
+/**
+ * Exception thrown when request validation fails.
+ * 
+ * This exception results in a 400 Bad Request response.
+ * 
+ * TODO: Phase 7 - Implement custom exception
+ */
+public class ValidationException extends RuntimeException {
+    
+    public ValidationException(String message) {
+        super(message);
+    }
+    
+    public ValidationException(String message, Throwable cause) {
+        super(message, cause);
+    }
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
new file mode 100644
index 0000000..52fc785
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
@@ -0,0 +1,38 @@
+package com.mongodb.samplemflix.model;
+
+/**
+ * Domain model representing a movie document from the MongoDB movies collection.
+ * 
+ * This class maps to the movies collection in the sample_mflix database.
+ * It includes all fields from the movie documents including nested objects
+ * for awards, IMDB ratings, and Tomatoes ratings.
+ * 
+ * TODO: Phase 3 - Implement full Movie class with all fields
+ * TODO: Phase 3 - Add BSON annotations for MongoDB mapping
+ * TODO: Phase 3 - Implement nested classes (Awards, IMDB, Tomatoes)
+ */
+public class Movie {
+    
+    // TODO: Phase 3 - Add fields and annotations
+    // Fields to include:
+    // - ObjectId id
+    // - String title
+    // - Integer year
+    // - String plot
+    // - String fullplot
+    // - List<String> genres
+    // - List<String> directors
+    // - List<String> writers
+    // - List<String> cast
+    // - List<String> countries
+    // - List<String> languages
+    // - String rated
+    // - Integer runtime
+    // - String poster
+    // - Awards awards
+    // - IMDB imdb
+    // - Tomatoes tomatoes
+    // - Integer metacritic
+    // - String type
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
new file mode 100644
index 0000000..383d212
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
@@ -0,0 +1,16 @@
+package com.mongodb.samplemflix.model.dto;
+
+/**
+ * Data Transfer Object for creating a new movie.
+ * 
+ * This DTO is used for POST /api/movies requests.
+ * It includes validation annotations to ensure required fields are present.
+ * 
+ * TODO: Phase 3 - Implement with validation annotations
+ * TODO: Phase 3 - Add @NotNull, @NotBlank annotations as needed
+ */
+public class CreateMovieRequest {
+    
+    // TODO: Phase 3 - Add fields and validation annotations
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
new file mode 100644
index 0000000..9551482
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
@@ -0,0 +1,15 @@
+package com.mongodb.samplemflix.model.dto;
+
+/**
+ * Data Transfer Object for updating an existing movie.
+ * 
+ * This DTO is used for PUT /api/movies/{id} requests.
+ * All fields are optional since partial updates are allowed.
+ * 
+ * TODO: Phase 3 - Implement with optional fields
+ */
+public class UpdateMovieRequest {
+    
+    // TODO: Phase 3 - Add fields (all optional)
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
new file mode 100644
index 0000000..60acdf5
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
@@ -0,0 +1,15 @@
+package com.mongodb.samplemflix.model.response;
+
+/**
+ * Generic API response interface.
+ * 
+ * This interface is implemented by both SuccessResponse and ErrorResponse
+ * to provide a consistent response structure.
+ * 
+ * TODO: Phase 3 - Define interface methods
+ */
+public interface ApiResponse {
+    
+    // TODO: Phase 3 - Add common response methods
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
new file mode 100644
index 0000000..e328a56
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
@@ -0,0 +1,15 @@
+package com.mongodb.samplemflix.model.response;
+
+/**
+ * Error response wrapper for API error responses.
+ * 
+ * This class wraps error responses with error codes, messages, and metadata.
+ * 
+ * TODO: Phase 3 - Implement error response structure
+ * TODO: Phase 3 - Add error code, message, timestamp, path fields
+ */
+public class ErrorResponse implements ApiResponse {
+    
+    // TODO: Phase 3 - Add fields: error, message, timestamp, path, etc.
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
new file mode 100644
index 0000000..6bb47de
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
@@ -0,0 +1,15 @@
+package com.mongodb.samplemflix.model.response;
+
+/**
+ * Success response wrapper for API responses.
+ * 
+ * This class wraps successful API responses with metadata like timestamp.
+ * 
+ * TODO: Phase 3 - Implement with generic type parameter
+ * TODO: Phase 3 - Add timestamp and metadata fields
+ */
+public class SuccessResponse<T> implements ApiResponse {
+    
+    // TODO: Phase 3 - Add fields: data, timestamp, etc.
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
new file mode 100644
index 0000000..a4efb4e
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
@@ -0,0 +1,27 @@
+package com.mongodb.samplemflix.repository;
+
+/**
+ * Repository interface for movie data access.
+ * 
+ * This repository provides methods for all CRUD operations using the MongoDB Java Driver.
+ * 
+ * Methods to implement:
+ * - insertOne(Movie movie)
+ * - insertMany(List<Movie> movies)
+ * - findById(ObjectId id)
+ * - find(Document filter, Document sort, int skip, int limit)
+ * - updateOne(ObjectId id, Document update)
+ * - updateMany(Document filter, Document update)
+ * - deleteOne(ObjectId id)
+ * - deleteMany(Document filter)
+ * - findOneAndDelete(ObjectId id)
+ * - countDocuments()
+ * 
+ * TODO: Phase 4 - Define repository interface methods
+ * TODO: Phase 4 - Create implementation class using MongoCollection
+ */
+public interface MovieRepository {
+    
+    // TODO: Phase 4 - Add method signatures
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
new file mode 100644
index 0000000..529b20d
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
@@ -0,0 +1,25 @@
+package com.mongodb.samplemflix.service;
+
+import org.springframework.stereotype.Service;
+
+/**
+ * Service layer for movie business logic.
+ * 
+ * This service handles:
+ * - Business logic and validation
+ * - Query construction (filters, sorts, pagination)
+ * - Data transformation between DTOs and entities
+ * - Error handling and exception throwing
+ * 
+ * TODO: Phase 5 - Implement all CRUD operations
+ * TODO: Phase 5 - Add query building logic for filtering
+ * TODO: Phase 5 - Implement pagination and sorting
+ * TODO: Phase 5 - Add validation logic
+ */
+@Service
+public class MovieService {
+    
+    // TODO: Phase 5 - Inject MovieRepository
+    // TODO: Phase 5 - Implement service methods
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
new file mode 100644
index 0000000..4c28104
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
@@ -0,0 +1,18 @@
+package com.mongodb.samplemflix.util;
+
+/**
+ * Utility class for validation operations.
+ * 
+ * This class provides helper methods for validating request data.
+ * 
+ * TODO: Phase 5 - Implement validation utility methods
+ */
+public class ValidationUtils {
+    
+    private ValidationUtils() {
+        // Private constructor to prevent instantiation
+    }
+    
+    // TODO: Phase 5 - Add validation methods
+}
+
diff --git a/server/java-spring/src/main/resources/application.properties b/server/java-spring/src/main/resources/application.properties
new file mode 100644
index 0000000..276a15b
--- /dev/null
+++ b/server/java-spring/src/main/resources/application.properties
@@ -0,0 +1,29 @@
+# MongoDB Configuration
+# Connection URI should be provided via MONGODB_URI environment variable
+spring.data.mongodb.uri=${MONGODB_URI}
+spring.data.mongodb.database=sample_mflix
+
+# Server Configuration
+# Default port is 3001, can be overridden via PORT environment variable
+server.port=${PORT:3001}
+
+# CORS Configuration
+# Allowed origins for cross-origin requests (typically the frontend URL)
+cors.allowed.origins=${CORS_ORIGIN:http://localhost:3000}
+
+# Application Info
+spring.application.name=MongoDB Sample MFlix API
+
+# Logging Configuration
+logging.level.com.mongodb.samplemflix=INFO
+logging.level.org.mongodb.driver=WARN
+
+# Jackson Configuration (JSON serialization)
+spring.jackson.default-property-inclusion=non_null
+spring.jackson.serialization.write-dates-as-timestamps=false
+
+# API Documentation (Swagger/OpenAPI)
+springdoc.api-docs.path=/api-docs
+springdoc.swagger-ui.path=/swagger-ui.html
+springdoc.swagger-ui.operationsSorter=method
+
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
new file mode 100644
index 0000000..f8c6da0
--- /dev/null
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
@@ -0,0 +1,14 @@
+package com.mongodb.samplemflix.controller;
+
+/**
+ * Unit tests for MovieController.
+ * 
+ * TODO: Phase 8 - Implement controller unit tests
+ * TODO: Phase 8 - Mock service layer
+ * TODO: Phase 8 - Test all endpoints
+ */
+public class MovieControllerTest {
+    
+    // TODO: Phase 8 - Add test methods
+}
+
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
new file mode 100644
index 0000000..92d6e2b
--- /dev/null
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
@@ -0,0 +1,16 @@
+package com.mongodb.samplemflix.integration;
+
+/**
+ * Integration tests for the movie API.
+ * 
+ * These tests verify the full request/response cycle including database operations.
+ * 
+ * TODO: Phase 8 - Implement integration tests
+ * TODO: Phase 8 - Set up test MongoDB instance (Testcontainers or embedded)
+ * TODO: Phase 8 - Test full request/response cycle
+ */
+public class MovieIntegrationTest {
+    
+    // TODO: Phase 8 - Add integration test methods
+}
+
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
new file mode 100644
index 0000000..bf8dabe
--- /dev/null
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
@@ -0,0 +1,14 @@
+package com.mongodb.samplemflix.service;
+
+/**
+ * Unit tests for MovieService.
+ * 
+ * TODO: Phase 8 - Implement service unit tests
+ * TODO: Phase 8 - Mock repository layer
+ * TODO: Phase 8 - Test business logic
+ */
+public class MovieServiceTest {
+    
+    // TODO: Phase 8 - Add test methods
+}
+

From f55b1d6954425b3563a57399eaa674ccb05594a7 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Fri, 24 Oct 2025 14:41:35 -0400
Subject: [PATCH 010/110] feat: add model layer

---
 JAVA-SPRING-IMPLEMENTATION-PLAN.md            | 122 ++++----
 PR_DESCRIPTION.md                             | 274 +++++++++++++++++
 .../.mvn/wrapper/maven-wrapper.properties     |  10 +
 server/java-spring/pom.xml                    |  13 +-
 .../samplemflix/config/MongoConfig.java       |  10 +-
 .../mongodb/samplemflix/model/Comment.java    |  58 ++++
 .../com/mongodb/samplemflix/model/Movie.java  | 288 ++++++++++++++++--
 .../mongodb/samplemflix/model/Theater.java    | 109 +++++++
 .../model/dto/CreateMovieRequest.java         |  90 +++++-
 .../model/dto/MovieSearchQuery.java           |  70 +++++
 .../model/dto/UpdateMovieRequest.java         |  86 +++++-
 .../model/response/ApiResponse.java           |  29 +-
 .../model/response/ErrorResponse.java         |  79 ++++-
 .../model/response/SuccessResponse.java       |  89 +++++-
 14 files changed, 1204 insertions(+), 123 deletions(-)
 create mode 100644 PR_DESCRIPTION.md
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java

diff --git a/JAVA-SPRING-IMPLEMENTATION-PLAN.md b/JAVA-SPRING-IMPLEMENTATION-PLAN.md
index e761fe8..206e08e 100644
--- a/JAVA-SPRING-IMPLEMENTATION-PLAN.md
+++ b/JAVA-SPRING-IMPLEMENTATION-PLAN.md
@@ -208,60 +208,74 @@ spring.application.name=MongoDB Sample MFlix API
 
 ---
 
-### Phase 3: Model Layer Implementation (Days 3-4)
-
-#### 3.1 Domain Models
-- [ ] Create `Movie.java` entity class
-- [ ] Create `Theater.java` entity class
-- [ ] Create `Comment.java` entity class
-- [ ] Add BSON annotations for MongoDB mapping
-- [ ] Implement nested objects (Awards, IMDB, Tomatoes)
-
-**Movie.java Structure:**
-```java
-@Document(collection = "movies")
-public class Movie {
-    @Id
-    private ObjectId id;
-    
-    private String title;
-    private Integer year;
-    private String plot;
-    private String fullplot;
-    private List<String> genres;
-    private List<String> directors;
-    private List<String> writers;
-    private List<String> cast;
-    private List<String> countries;
-    private List<String> languages;
-    private String rated;
-    private Integer runtime;
-    private String poster;
-    
-    private Awards awards;
-    private IMDB imdb;
-    private Tomatoes tomatoes;
-    private Integer metacritic;
-    private String type;
-    
-    // Nested classes for complex fields
-    public static class Awards { ... }
-    public static class IMDB { ... }
-    public static class Tomatoes { ... }
-}
-```
-
-#### 3.2 DTOs (Data Transfer Objects)
-- [ ] Create `CreateMovieRequest.java`
-- [ ] Create `UpdateMovieRequest.java`
-- [ ] Create `MovieSearchQuery.java`
-- [ ] Add validation annotations (@NotNull, @NotBlank, etc.)
-
-#### 3.3 Response Models
-- [ ] Create generic `ApiResponse<T>` interface
-- [ ] Create `SuccessResponse<T>` class
-- [ ] Create `ErrorResponse` class
-- [ ] Add timestamp and metadata fields
+### Phase 3: Model Layer Implementation (Days 3-4) ✅ COMPLETE
+
+#### 3.1 Domain Models ✅
+- [x] Create `Movie.java` entity class
+- [x] Create `Theater.java` entity class
+- [x] Create `Comment.java` entity class
+- [x] Add BSON annotations for MongoDB mapping (using Lombok)
+- [x] Implement nested objects (Awards, IMDB, Tomatoes)
+
+**Movie.java Structure:** ✅
+- ✅ All fields from TypeScript Movie interface
+- ✅ Nested class: Awards (wins, nominations, text)
+- ✅ Nested class: Imdb (rating, votes, id)
+- ✅ Nested class: Tomatoes (viewer, critic, fresh, rotten, production, lastUpdated)
+- ✅ Nested classes: Tomatoes.Viewer and Tomatoes.Critic
+- ✅ Lombok annotations (@Data, @Builder, @NoArgsConstructor, @AllArgsConstructor)
+- ✅ Comprehensive JavaDoc documentation
+
+**Theater.java Structure:** ✅
+- ✅ All fields from TypeScript Theater interface
+- ✅ Nested class: Location (address, geo)
+- ✅ Nested class: Location.Address (street1, city, state, zipcode)
+- ✅ Nested class: Location.Geo (type, coordinates)
+- ✅ GeoJSON format support for geospatial queries
+
+**Comment.java Structure:** ✅
+- ✅ All fields from TypeScript Comment interface
+- ✅ Fields: id, name, email, movieId, text, date
+
+#### 3.2 DTOs (Data Transfer Objects) ✅
+- [x] Create `CreateMovieRequest.java`
+- [x] Create `UpdateMovieRequest.java`
+- [x] Create `MovieSearchQuery.java`
+- [x] Add validation annotations (@NotBlank for required fields)
+
+**CreateMovieRequest.java:** ✅
+- ✅ Required field: title (with @NotBlank validation)
+- ✅ Optional fields: year, plot, fullplot, genres, directors, writers, cast, countries, languages, rated, runtime, poster
+
+**UpdateMovieRequest.java:** ✅
+- ✅ All fields optional (for partial updates)
+- ✅ Same fields as CreateMovieRequest
+
+**MovieSearchQuery.java:** ✅
+- ✅ Full-text search: q
+- ✅ Filters: genre, year, minRating, maxRating
+- ✅ Pagination: limit, skip
+- ✅ Sorting: sortBy, sortOrder
+
+#### 3.3 Response Models ✅
+- [x] Create generic `ApiResponse` interface
+- [x] Create `SuccessResponse<T>` class
+- [x] Create `ErrorResponse` class
+- [x] Add timestamp and metadata fields
+
+**ApiResponse Interface:** ✅
+- ✅ Methods: isSuccess(), getTimestamp()
+
+**SuccessResponse<T>:** ✅
+- ✅ Generic type parameter for data
+- ✅ Fields: success (true), message, data, timestamp, pagination
+- ✅ Nested class: Pagination (page, limit, total, pages)
+- ✅ @JsonInclude(NON_NULL) to exclude null fields
+
+**ErrorResponse:** ✅
+- ✅ Fields: success (false), message, error, timestamp
+- ✅ Nested class: ErrorDetails (message, code, details)
+- ✅ Matches Express backend error format
 
 ---
 
diff --git a/PR_DESCRIPTION.md b/PR_DESCRIPTION.md
new file mode 100644
index 0000000..2d46f00
--- /dev/null
+++ b/PR_DESCRIPTION.md
@@ -0,0 +1,274 @@
+# Java Spring Backend Implementation - Phases 2 & 3
+
+## 📋 Overview
+
+This PR implements **Phase 2 (Database Configuration)** and **Phase 3 (Model Layer)** of the Java Spring Boot backend for the MongoDB Sample MFlix application. This backend will provide feature parity with the existing Express.js/TypeScript backend while demonstrating direct MongoDB Java Driver usage.
+
+**Branch:** `java-scaffolding-setup`  
+**Base:** `main`
+
+---
+
+## ✅ What's Completed
+
+### Phase 2: Database Configuration and Connection ✅
+
+#### MongoDB Configuration (`MongoConfig.java`)
+- ✅ **Connection pooling** with production-ready settings:
+  - Max pool size: 100 connections
+  - Min pool size: 10 connections
+  - Max connection idle time: 60 seconds
+  - Max wait time: 10 seconds
+- ✅ **Socket timeouts** to prevent hanging connections:
+  - Connect timeout: 10 seconds
+  - Read timeout: 10 seconds
+- ✅ **Server selection timeout**: 10 seconds
+- ✅ **Connection string validation** before attempting connection
+- ✅ **Graceful shutdown** managed by Spring's bean lifecycle
+- ✅ Singleton `MongoClient` and `MongoDatabase` beans
+
+#### Database Verification (`DatabaseVerification.java`)
+- ✅ **Startup verification** via `@PostConstruct`
+- ✅ **Collection verification**: Checks if movies collection exists and contains data
+- ✅ **Text search index creation**: Creates compound text index on `plot`, `title`, and `fullplot` fields
+- ✅ **Background index creation** to avoid blocking operations
+- ✅ **Non-blocking verification**: Application starts even if verification fails
+- ✅ **Comprehensive logging** with helpful error messages and links to MongoDB documentation
+
+### Phase 3: Model Layer Implementation ✅
+
+#### Domain Models (3 classes)
+
+**1. Movie.java** (270 lines)
+- ✅ All fields from TypeScript `Movie` interface
+- ✅ Nested classes:
+  - `Awards` (wins, nominations, text)
+  - `Imdb` (rating, votes, id)
+  - `Tomatoes` (viewer, critic, fresh, rotten, production, lastUpdated)
+    - `Tomatoes.Viewer` (rating, numReviews, meter)
+    - `Tomatoes.Critic` (rating, numReviews, meter)
+- ✅ Lombok annotations for reduced boilerplate
+- ✅ Comprehensive JavaDoc documentation
+
+**2. Theater.java** (103 lines)
+- ✅ All fields from TypeScript `Theater` interface
+- ✅ Nested classes:
+  - `Location` (address, geo)
+    - `Location.Address` (street1, city, state, zipcode)
+    - `Location.Geo` (type, coordinates in GeoJSON format)
+- ✅ GeoJSON format support for geospatial queries
+
+**3. Comment.java** (56 lines)
+- ✅ All fields from TypeScript `Comment` interface
+- ✅ Fields: id, name, email, movieId, text, date
+
+#### DTOs - Data Transfer Objects (3 classes)
+
+**1. CreateMovieRequest.java** (92 lines)
+- ✅ Required field: `title` with `@NotBlank` validation
+- ✅ Optional fields: year, plot, fullplot, genres, directors, writers, cast, countries, languages, rated, runtime, poster
+- ✅ Matches Express backend `CreateMovieRequest` interface
+
+**2. UpdateMovieRequest.java** (89 lines)
+- ✅ All fields optional (for partial updates)
+- ✅ Same fields as `CreateMovieRequest`
+
+**3. MovieSearchQuery.java** (64 lines)
+- ✅ Full-text search: `q` parameter
+- ✅ Filters: genre, year, minRating, maxRating
+- ✅ Pagination: limit, skip
+- ✅ Sorting: sortBy, sortOrder
+
+#### Response Models (3 classes + 1 interface)
+
+**1. ApiResponse Interface** (30 lines)
+- ✅ Common interface for all API responses
+- ✅ Methods: `isSuccess()`, `getTimestamp()`
+
+**2. SuccessResponse<T>** (88 lines)
+- ✅ Generic type parameter for flexible data responses
+- ✅ Fields: success (true), message, data, timestamp, pagination
+- ✅ Nested class: `Pagination` (page, limit, total, pages)
+- ✅ `@JsonInclude(NON_NULL)` to exclude null fields from JSON
+- ✅ Auto-generated timestamp using `Instant.now()`
+
+**3. ErrorResponse** (80 lines)
+- ✅ Fields: success (false), message, error, timestamp
+- ✅ Nested class: `ErrorDetails` (message, code, details)
+- ✅ Matches Express backend error format
+
+---
+
+## 📁 Files Changed
+
+### Modified Files (8)
+- `server/java-spring/pom.xml` - Updated dependencies
+- `server/java-spring/.mvn/wrapper/maven-wrapper.properties` - Maven wrapper config
+- `server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java` - **Phase 2**
+- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java` - **Phase 3**
+- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java` - **Phase 3**
+- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java` - **Phase 3**
+- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java` - **Phase 3**
+- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java` - **Phase 3**
+- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java` - **Phase 3**
+
+### New Files (4)
+- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java` - **Phase 3**
+- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java` - **Phase 3**
+- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java` - **Phase 3**
+
+### Not Staged (Documentation)
+- `JAVA-SPRING-IMPLEMENTATION-PLAN.md` - Updated with Phase 2 & 3 completion status
+
+---
+
+## 🔍 What to Review
+
+### 1. Database Configuration (`config/`)
+**Focus Areas:**
+- [ ] Connection pool settings are appropriate for production use
+- [ ] Timeout values (10s) are reasonable
+- [ ] Error handling in `DatabaseVerification` is robust
+- [ ] Text index creation matches Express backend behavior
+- [ ] Logging messages are helpful and informative
+
+**Questions for Reviewers:**
+- Are the connection pool settings (max 100, min 10) appropriate?
+- Should we add more comprehensive index verification (check if index exists before creating)?
+
+### 2. Domain Models (`model/`)
+**Focus Areas:**
+- [ ] All fields match the TypeScript interfaces from Express backend
+- [ ] Nested class structure is clean and maintainable
+- [ ] Lombok annotations are used appropriately
+- [ ] JavaDoc documentation is comprehensive
+- [ ] Field types are correct (Integer vs int, Date vs Instant, etc.)
+
+**Questions for Reviewers:**
+- Should we use `Instant` instead of `Date` for date fields?
+- Are the nested classes appropriately structured, or should some be top-level classes?
+
+### 3. DTOs (`model/dto/`)
+**Focus Areas:**
+- [ ] Validation annotations are appropriate (`@NotBlank` on title)
+- [ ] All optional fields are correctly marked
+- [ ] DTOs match Express backend request structures
+- [ ] Field naming conventions are consistent
+
+**Questions for Reviewers:**
+- Should we add more validation annotations (e.g., `@Min`, `@Max` for year/rating)?
+- Should `MovieSearchQuery` have default values for limit/skip?
+
+### 4. Response Models (`model/response/`)
+**Focus Areas:**
+- [ ] Generic type usage in `SuccessResponse<T>` is correct
+- [ ] `@JsonInclude(NON_NULL)` behavior is desired
+- [ ] Timestamp format (ISO 8601) matches Express backend
+- [ ] Error response structure matches Express backend
+- [ ] Builder pattern with defaults works as expected
+
+**Questions for Reviewers:**
+- Should we use a custom timestamp format instead of `Instant.now().toString()`?
+- Is the `ErrorDetails` nested class structure appropriate?
+
+---
+
+## 🚧 What's NOT in This PR (Pending Work)
+
+### Phase 4: Repository Layer (Next PR)
+- [ ] `MovieRepository` interface
+- [ ] `MovieRepositoryImpl` using `MongoCollection<Document>` directly
+- [ ] Manual BSON Document ↔ Movie object conversion
+- [ ] All CRUD operations: insertOne, insertMany, findById, find, updateOne, updateMany, deleteOne, deleteMany, findOneAndDelete
+
+### Phase 5: Service Layer (Future PR)
+- [ ] `MovieService` with business logic
+- [ ] Request validation
+- [ ] DTO ↔ Domain model conversion
+- [ ] Query building for search/filter operations
+
+### Phase 6: Controller Layer (Future PR)
+- [ ] `MovieController` with REST endpoints
+- [ ] Request/response mapping
+- [ ] Exception handling
+
+### Phase 7-9: Testing, Error Handling, Documentation (Future PRs)
+- [ ] Unit tests
+- [ ] Integration tests
+- [ ] Global exception handler
+- [ ] API documentation (Swagger/OpenAPI)
+- [ ] README updates
+
+---
+
+## ✅ Build Verification
+
+```bash
+$ cd server/java-spring && ./mvnw clean compile
+[INFO] BUILD SUCCESS
+[INFO] Compiling 20 source files
+```
+
+All files compile successfully with no errors or warnings.
+
+---
+
+## 🎯 Design Decisions
+
+### Why Lombok?
+- **Reduces boilerplate**: No need to write getters, setters, constructors, toString, equals, hashCode
+- **Improves readability**: Focus on business logic, not boilerplate
+- **Maintainability**: Changes to fields automatically update generated methods
+- **Industry standard**: Widely used in Spring Boot projects
+
+### Why Custom Repository (Not Spring Data)?
+- **Educational value**: Demonstrates direct MongoDB Driver usage
+- **Matches Express backend**: Similar to how Node.js driver is used
+- **Full control**: Complete control over BSON document structure and queries
+- **Explicit operations**: Shows exactly what MongoDB operations are being performed
+
+### Why Nested Classes?
+- **Encapsulation**: Nested classes are only used within their parent context
+- **Namespace clarity**: `Movie.Awards` is clearer than a separate `MovieAwards` class
+- **Matches MongoDB structure**: Reflects the nested document structure in MongoDB
+
+---
+
+## 📚 References
+
+- **Implementation Plan**: `JAVA-SPRING-IMPLEMENTATION-PLAN.md`
+- **Express Backend**: `server/express/src/` (reference implementation)
+- **MongoDB Java Driver Docs**: https://www.mongodb.com/docs/drivers/java/sync/current/
+- **Spring Boot Docs**: https://docs.spring.io/spring-boot/docs/current/reference/html/
+
+---
+
+## 🤔 Questions for Discussion
+
+1. **Date Types**: Should we use `java.time.Instant` instead of `java.util.Date` for better Java 8+ compatibility?
+2. **Validation**: Should we add more comprehensive validation annotations on DTOs?
+3. **Index Management**: Should we check if indexes exist before creating them, or rely on MongoDB's idempotent behavior?
+4. **Error Messages**: Are the error messages and logging levels appropriate?
+5. **Pagination Defaults**: Should `MovieSearchQuery` have default values (e.g., limit=20, skip=0)?
+
+---
+
+## 📝 Reviewer Checklist
+
+- [ ] Code compiles without errors
+- [ ] All models match Express backend TypeScript interfaces
+- [ ] Lombok annotations are used appropriately
+- [ ] JavaDoc documentation is comprehensive
+- [ ] Connection pool settings are production-ready
+- [ ] Database verification logic is sound
+- [ ] Response models match Express backend format
+- [ ] Validation annotations are appropriate
+- [ ] No security vulnerabilities introduced
+- [ ] Code follows Java/Spring Boot best practices
+
+---
+
+**Ready for Review** ✅
+
+This PR lays the foundation for the Java Spring backend by implementing database configuration and all model classes. The next PR will implement the Repository layer with direct MongoDB Driver usage.
+
diff --git a/server/java-spring/.mvn/wrapper/maven-wrapper.properties b/server/java-spring/.mvn/wrapper/maven-wrapper.properties
index 7fb0190..a57d0ee 100644
--- a/server/java-spring/.mvn/wrapper/maven-wrapper.properties
+++ b/server/java-spring/.mvn/wrapper/maven-wrapper.properties
@@ -1,3 +1,13 @@
+# Maven Wrapper Configuration
+# Use ./mvnw instead of mvn to automatically download and use the specified Maven version.
+
+# Maven Wrapper version (not the Maven version itself)
 wrapperVersion=3.3.4
+
+# Download only Maven binaries (recommended for most projects)
 distributionType=only-script
+
+# Maven version to download - pins everyone to Maven 3.8.6 for consistent builds
 distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.6/apache-maven-3.8.6-bin.zip
+
+# Usage: ./mvnw clean install (Unix/macOS) or mvnw.cmd clean install (Windows)
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index 3dc71af..e5dcafc 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -50,12 +50,23 @@
             <artifactId>lombok</artifactId>
             <optional>true</optional>
         </dependency>
-        
+        <!-- Commons Lang for utility functions (force version) -->
+        <dependency>
+            <groupId>org.apache.commons</groupId>
+            <artifactId>commons-lang3</artifactId>
+            <version>3.19.0</version>
+        </dependency>
         <!-- SpringDoc OpenAPI (Swagger UI) -->
         <dependency>
             <groupId>org.springdoc</groupId>
             <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
             <version>${springdoc.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.apache.commons</groupId>
+                    <artifactId>commons-lang3</artifactId>
+                </exclusion>
+            </exclusions>
         </dependency>
         
         <!-- Spring Boot Test Starter -->
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
index ee6a58e..e6d294a 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
@@ -38,17 +38,17 @@ public class MongoConfig {
 
     /**
      * Creates and configures the MongoDB client with connection pooling and timeout settings.
-     *
+     * <p>
      * Connection Pool Settings:
      * - Max pool size: 100 connections (handles high concurrent load)
      * - Min pool size: 10 connections (maintains ready connections)
      * - Max connection idle time: 60 seconds (releases idle connections)
      * - Max wait time: 10 seconds (time to wait for available connection)
-     *
+     * <p>
      * Socket Settings:
      * - Connect timeout: 10 seconds (time to establish connection)
      * - Read timeout: 10 seconds (time to wait for server response)
-     *
+     * <p>
      * The MongoClient is thread-safe and should be shared across the application.
      * Spring will automatically close this client when the application shuts down.
      *
@@ -94,10 +94,10 @@ public MongoClient mongoClient() {
 
     /**
      * Creates a reference to the MongoDB database.
-     *
+     * <p>
      * This bean provides access to the sample_mflix database and can be injected
      * into repositories and services throughout the application.
-     *
+     * <p>
      * The database name is configured in application.properties and defaults to "sample_mflix".
      *
      * @param mongoClient the MongoDB client (injected by Spring)
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
new file mode 100644
index 0000000..2702f6b
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
@@ -0,0 +1,58 @@
+package com.mongodb.samplemflix.model;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.bson.types.ObjectId;
+
+import java.util.Date;
+
+/**
+ * Domain model representing a comment document from the MongoDB comments collection.
+ * 
+ * This class maps to the comments collection in the sample_mflix database.
+ * Comments are user reviews/comments associated with movies.
+ * 
+ * The structure matches the TypeScript Comment interface from the Express backend
+ * to ensure API compatibility.
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Comment {
+    
+    /**
+     * MongoDB document ID.
+     * Maps to the _id field in MongoDB.
+     */
+    private ObjectId id;
+    
+    /**
+     * Name of the commenter.
+     */
+    private String name;
+    
+    /**
+     * Email address of the commenter.
+     */
+    private String email;
+    
+    /**
+     * ID of the movie this comment is associated with.
+     * References a document in the movies collection.
+     */
+    private ObjectId movieId;
+    
+    /**
+     * Comment text content.
+     */
+    private String text;
+    
+    /**
+     * Date when the comment was posted.
+     */
+    private Date date;
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
index 52fc785..e0c6acb 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
@@ -1,38 +1,270 @@
 package com.mongodb.samplemflix.model;
 
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.bson.types.ObjectId;
+
+import java.util.Date;
+import java.util.List;
+
 /**
  * Domain model representing a movie document from the MongoDB movies collection.
- * 
+ *
  * This class maps to the movies collection in the sample_mflix database.
  * It includes all fields from the movie documents including nested objects
  * for awards, IMDB ratings, and Tomatoes ratings.
- * 
- * TODO: Phase 3 - Implement full Movie class with all fields
- * TODO: Phase 3 - Add BSON annotations for MongoDB mapping
- * TODO: Phase 3 - Implement nested classes (Awards, IMDB, Tomatoes)
+ *
+ * The structure matches the TypeScript Movie interface from the Express backend
+ * to ensure API compatibility.
+ *
+ * Note: We use Lombok annotations to reduce boilerplate code:
+ * - @Data: Generates getters, setters, toString, equals, and hashCode
+ * - @Builder: Provides a fluent builder pattern for object construction
+ * - @NoArgsConstructor: Generates a no-argument constructor (required by MongoDB driver)
+ * - @AllArgsConstructor: Generates a constructor with all fields
  */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
 public class Movie {
-    
-    // TODO: Phase 3 - Add fields and annotations
-    // Fields to include:
-    // - ObjectId id
-    // - String title
-    // - Integer year
-    // - String plot
-    // - String fullplot
-    // - List<String> genres
-    // - List<String> directors
-    // - List<String> writers
-    // - List<String> cast
-    // - List<String> countries
-    // - List<String> languages
-    // - String rated
-    // - Integer runtime
-    // - String poster
-    // - Awards awards
-    // - IMDB imdb
-    // - Tomatoes tomatoes
-    // - Integer metacritic
-    // - String type
-}
 
+    /**
+     * MongoDB document ID.
+     * Maps to the _id field in MongoDB.
+     * Can be null for new documents (MongoDB will generate it).
+     */
+    private ObjectId id;
+
+    /**
+     * Movie title (required field).
+     */
+    private String title;
+
+    /**
+     * Release year.
+     */
+    private Integer year;
+
+    /**
+     * Short plot summary.
+     */
+    private String plot;
+
+    /**
+     * Full plot description.
+     */
+    private String fullplot;
+
+    /**
+     * Release date.
+     */
+    private Date released;
+
+    /**
+     * Runtime in minutes.
+     */
+    private Integer runtime;
+
+    /**
+     * Poster image URL.
+     */
+    private String poster;
+
+    /**
+     * List of genres (e.g., "Action", "Drama", "Comedy").
+     */
+    private List<String> genres;
+
+    /**
+     * List of directors.
+     */
+    private List<String> directors;
+
+    /**
+     * List of writers.
+     */
+    private List<String> writers;
+
+    /**
+     * List of cast members.
+     */
+    private List<String> cast;
+
+    /**
+     * List of countries where the movie was produced.
+     */
+    private List<String> countries;
+
+    /**
+     * List of languages in the movie.
+     */
+    private List<String> languages;
+
+    /**
+     * Movie rating (e.g., "PG", "PG-13", "R").
+     */
+    private String rated;
+
+    /**
+     * Awards information (wins, nominations, text).
+     */
+    private Awards awards;
+
+    /**
+     * IMDB rating information.
+     */
+    private Imdb imdb;
+
+    /**
+     * Rotten Tomatoes rating information.
+     */
+    private Tomatoes tomatoes;
+
+    /**
+     * Metacritic score.
+     */
+    private Integer metacritic;
+
+    /**
+     * Type of content (e.g., "movie", "series").
+     */
+    private String type;
+
+    /**
+     * Nested class representing awards information.
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Awards {
+        /**
+         * Number of awards won.
+         */
+        private Integer wins;
+
+        /**
+         * Number of nominations.
+         */
+        private Integer nominations;
+
+        /**
+         * Text description of awards.
+         */
+        private String text;
+    }
+
+    /**
+     * Nested class representing IMDB rating information.
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Imdb {
+        /**
+         * IMDB rating (0.0 to 10.0).
+         */
+        private Double rating;
+
+        /**
+         * Number of votes.
+         */
+        private Integer votes;
+
+        /**
+         * IMDB ID number.
+         */
+        private Integer id;
+    }
+
+    /**
+     * Nested class representing Rotten Tomatoes rating information.
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Tomatoes {
+        /**
+         * Viewer ratings information.
+         */
+        private Viewer viewer;
+
+        /**
+         * Critic ratings information.
+         */
+        private Critic critic;
+
+        /**
+         * Number of fresh reviews.
+         */
+        private Integer fresh;
+
+        /**
+         * Number of rotten reviews.
+         */
+        private Integer rotten;
+
+        /**
+         * Production company.
+         */
+        private String production;
+
+        /**
+         * Last updated date.
+         */
+        private Date lastUpdated;
+
+        /**
+         * Nested class for viewer ratings.
+         */
+        @Data
+        @Builder
+        @NoArgsConstructor
+        @AllArgsConstructor
+        public static class Viewer {
+            /**
+             * Viewer rating (0.0 to 5.0).
+             */
+            private Double rating;
+
+            /**
+             * Number of viewer reviews.
+             */
+            private Integer numReviews;
+
+            /**
+             * Viewer meter percentage (0-100).
+             */
+            private Integer meter;
+        }
+
+        /**
+         * Nested class for critic ratings.
+         */
+        @Data
+        @Builder
+        @NoArgsConstructor
+        @AllArgsConstructor
+        public static class Critic {
+            /**
+             * Critic rating (0.0 to 5.0).
+             */
+            private Double rating;
+
+            /**
+             * Number of critic reviews.
+             */
+            private Integer numReviews;
+
+            /**
+             * Critic meter percentage (0-100).
+             */
+            private Integer meter;
+        }
+    }
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
new file mode 100644
index 0000000..e636226
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
@@ -0,0 +1,109 @@
+package com.mongodb.samplemflix.model;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.bson.types.ObjectId;
+
+/**
+ * Domain model representing a theater document from the MongoDB theaters collection.
+ * 
+ * This class maps to the theaters collection in the sample_mflix database.
+ * It includes location information with address and geospatial coordinates.
+ * 
+ * The structure matches the TypeScript Theater interface from the Express backend
+ * to ensure API compatibility.
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Theater {
+    
+    /**
+     * MongoDB document ID.
+     * Maps to the _id field in MongoDB.
+     */
+    private ObjectId id;
+    
+    /**
+     * Theater ID number.
+     */
+    private Integer theaterId;
+    
+    /**
+     * Location information including address and geospatial coordinates.
+     */
+    private Location location;
+    
+    /**
+     * Nested class representing location information.
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Location {
+        /**
+         * Address information.
+         */
+        private Address address;
+        
+        /**
+         * Geospatial coordinates.
+         */
+        private Geo geo;
+        
+        /**
+         * Nested class for address information.
+         */
+        @Data
+        @Builder
+        @NoArgsConstructor
+        @AllArgsConstructor
+        public static class Address {
+            /**
+             * Street address line 1.
+             */
+            private String street1;
+            
+            /**
+             * City name.
+             */
+            private String city;
+            
+            /**
+             * State or province.
+             */
+            private String state;
+            
+            /**
+             * ZIP or postal code.
+             */
+            private String zipcode;
+        }
+        
+        /**
+         * Nested class for geospatial coordinates.
+         * Uses GeoJSON format for MongoDB geospatial queries.
+         */
+        @Data
+        @Builder
+        @NoArgsConstructor
+        @AllArgsConstructor
+        public static class Geo {
+            /**
+             * GeoJSON type (always "Point" for theater locations).
+             */
+            private String type;
+            
+            /**
+             * Coordinates array: [longitude, latitude].
+             * Note: GeoJSON uses longitude first, then latitude.
+             */
+            private double[] coordinates;
+        }
+    }
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
index 383d212..179bb03 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
@@ -1,16 +1,92 @@
 package com.mongodb.samplemflix.model.dto;
 
+import jakarta.validation.constraints.NotBlank;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.List;
+
 /**
  * Data Transfer Object for creating a new movie.
- * 
+ *
  * This DTO is used for POST /api/movies requests.
  * It includes validation annotations to ensure required fields are present.
- * 
- * TODO: Phase 3 - Implement with validation annotations
- * TODO: Phase 3 - Add @NotNull, @NotBlank annotations as needed
+ *
+ * The structure matches the TypeScript CreateMovieRequest interface from the Express backend.
+ * Only the title field is required; all other fields are optional.
  */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
 public class CreateMovieRequest {
-    
-    // TODO: Phase 3 - Add fields and validation annotations
-}
 
+    /**
+     * Movie title (required).
+     * Must not be blank.
+     */
+    @NotBlank(message = "Title is required")
+    private String title;
+
+    /**
+     * Release year (optional).
+     */
+    private Integer year;
+
+    /**
+     * Short plot summary (optional).
+     */
+    private String plot;
+
+    /**
+     * Full plot description (optional).
+     */
+    private String fullplot;
+
+    /**
+     * List of genres (optional).
+     */
+    private List<String> genres;
+
+    /**
+     * List of directors (optional).
+     */
+    private List<String> directors;
+
+    /**
+     * List of writers (optional).
+     */
+    private List<String> writers;
+
+    /**
+     * List of cast members (optional).
+     */
+    private List<String> cast;
+
+    /**
+     * List of countries (optional).
+     */
+    private List<String> countries;
+
+    /**
+     * List of languages (optional).
+     */
+    private List<String> languages;
+
+    /**
+     * Movie rating (optional).
+     */
+    private String rated;
+
+    /**
+     * Runtime in minutes (optional).
+     */
+    private Integer runtime;
+
+    /**
+     * Poster image URL (optional).
+     */
+    private String poster;
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java
new file mode 100644
index 0000000..b9ad823
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java
@@ -0,0 +1,70 @@
+package com.mongodb.samplemflix.model.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Data Transfer Object for movie search query parameters.
+ * 
+ * This DTO is used to parse and validate query parameters for GET /api/movies requests.
+ * It supports full-text search, filtering by genre/year/rating, sorting, and pagination.
+ * 
+ * The structure matches the search functionality from the Express backend.
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MovieSearchQuery {
+    
+    /**
+     * Full-text search query.
+     * Searches across plot, title, and fullplot fields using MongoDB text index.
+     */
+    private String q;
+    
+    /**
+     * Filter by genre (case-insensitive partial match).
+     */
+    private String genre;
+    
+    /**
+     * Filter by exact year.
+     */
+    private Integer year;
+    
+    /**
+     * Minimum IMDB rating (inclusive).
+     */
+    private Double minRating;
+    
+    /**
+     * Maximum IMDB rating (inclusive).
+     */
+    private Double maxRating;
+    
+    /**
+     * Number of results to return (default: 20, max: 100).
+     */
+    private Integer limit;
+    
+    /**
+     * Number of results to skip for pagination (default: 0).
+     */
+    private Integer skip;
+    
+    /**
+     * Field to sort by (e.g., "title", "year", "imdb.rating").
+     * Default: "title"
+     */
+    private String sortBy;
+    
+    /**
+     * Sort order: "asc" or "desc".
+     * Default: "asc"
+     */
+    private String sortOrder;
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
index 9551482..50423cb 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
@@ -1,15 +1,89 @@
 package com.mongodb.samplemflix.model.dto;
 
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.List;
+
 /**
  * Data Transfer Object for updating an existing movie.
- * 
+ *
  * This DTO is used for PUT /api/movies/{id} requests.
  * All fields are optional since partial updates are allowed.
- * 
- * TODO: Phase 3 - Implement with optional fields
+ *
+ * The structure matches the TypeScript UpdateMovieRequest interface from the Express backend.
+ * Any field that is null will not be updated in the database.
  */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
 public class UpdateMovieRequest {
-    
-    // TODO: Phase 3 - Add fields (all optional)
-}
 
+    /**
+     * Movie title (optional).
+     */
+    private String title;
+
+    /**
+     * Release year (optional).
+     */
+    private Integer year;
+
+    /**
+     * Short plot summary (optional).
+     */
+    private String plot;
+
+    /**
+     * Full plot description (optional).
+     */
+    private String fullplot;
+
+    /**
+     * List of genres (optional).
+     */
+    private List<String> genres;
+
+    /**
+     * List of directors (optional).
+     */
+    private List<String> directors;
+
+    /**
+     * List of writers (optional).
+     */
+    private List<String> writers;
+
+    /**
+     * List of cast members (optional).
+     */
+    private List<String> cast;
+
+    /**
+     * List of countries (optional).
+     */
+    private List<String> countries;
+
+    /**
+     * List of languages (optional).
+     */
+    private List<String> languages;
+
+    /**
+     * Movie rating (optional).
+     */
+    private String rated;
+
+    /**
+     * Runtime in minutes (optional).
+     */
+    private Integer runtime;
+
+    /**
+     * Poster image URL (optional).
+     */
+    private String poster;
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
index 60acdf5..fb06da9 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
@@ -2,14 +2,29 @@
 
 /**
  * Generic API response interface.
- * 
+ *
  * This interface is implemented by both SuccessResponse and ErrorResponse
- * to provide a consistent response structure.
- * 
- * TODO: Phase 3 - Define interface methods
+ * to provide a consistent response structure across all API endpoints.
+ *
+ * All API responses include:
+ * - success: boolean indicating if the request was successful
+ * - timestamp: ISO 8601 timestamp of when the response was generated
+ *
+ * This matches the TypeScript ApiResponse type from the Express backend.
  */
 public interface ApiResponse {
-    
-    // TODO: Phase 3 - Add common response methods
-}
 
+    /**
+     * Indicates whether the request was successful.
+     *
+     * @return true for successful responses, false for error responses
+     */
+    boolean isSuccess();
+
+    /**
+     * Gets the timestamp when the response was generated.
+     *
+     * @return ISO 8601 formatted timestamp string
+     */
+    String getTimestamp();
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
index e328a56..f81ded1 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
@@ -1,15 +1,80 @@
 package com.mongodb.samplemflix.model.response;
 
+import com.fasterxml.jackson.annotation.JsonInclude;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.Instant;
+
 /**
  * Error response wrapper for API error responses.
- * 
+ *
  * This class wraps error responses with error codes, messages, and metadata.
- * 
- * TODO: Phase 3 - Implement error response structure
- * TODO: Phase 3 - Add error code, message, timestamp, path fields
+ *
+ * The structure matches the TypeScript ErrorResponse type from the Express backend:
+ * {
+ *   success: false,
+ *   message: string,
+ *   error: {
+ *     message: string,
+ *     code?: string,
+ *     details?: any
+ *   },
+ *   timestamp: string
+ * }
  */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@JsonInclude(JsonInclude.Include.NON_NULL)
 public class ErrorResponse implements ApiResponse {
-    
-    // TODO: Phase 3 - Add fields: error, message, timestamp, path, etc.
-}
 
+    /**
+     * Always false for error responses.
+     */
+    @Builder.Default
+    private boolean success = false;
+
+    /**
+     * High-level error message.
+     */
+    private String message;
+
+    /**
+     * Detailed error information.
+     */
+    private ErrorDetails error;
+
+    /**
+     * ISO 8601 timestamp when the error occurred.
+     */
+    @Builder.Default
+    private String timestamp = Instant.now().toString();
+
+    /**
+     * Nested class for detailed error information.
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class ErrorDetails {
+        /**
+         * Detailed error message.
+         */
+        private String message;
+
+        /**
+         * Error code (e.g., "VALIDATION_ERROR", "NOT_FOUND").
+         */
+        private String code;
+
+        /**
+         * Additional error details (optional).
+         */
+        private Object details;
+    }
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
index 6bb47de..36c0e41 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
@@ -1,15 +1,88 @@
 package com.mongodb.samplemflix.model.response;
 
+import com.fasterxml.jackson.annotation.JsonInclude;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.Instant;
+
 /**
  * Success response wrapper for API responses.
- * 
- * This class wraps successful API responses with metadata like timestamp.
- * 
- * TODO: Phase 3 - Implement with generic type parameter
- * TODO: Phase 3 - Add timestamp and metadata fields
+ *
+ * This class wraps successful API responses with metadata like timestamp and pagination.
+ * It uses a generic type parameter T to hold the response data.
+ *
+ * The structure matches the TypeScript SuccessResponse type from the Express backend:
+ * {
+ *   success: true,
+ *   message?: string,
+ *   data: T,
+ *   timestamp: string,
+ *   pagination?: { page, limit, total, pages }
+ * }
  */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@JsonInclude(JsonInclude.Include.NON_NULL)
 public class SuccessResponse<T> implements ApiResponse {
-    
-    // TODO: Phase 3 - Add fields: data, timestamp, etc.
-}
 
+    /**
+     * Always true for success responses.
+     */
+    @Builder.Default
+    private boolean success = true;
+
+    /**
+     * Optional success message.
+     */
+    private String message;
+
+    /**
+     * The response data (generic type).
+     */
+    private T data;
+
+    /**
+     * ISO 8601 timestamp when the response was generated.
+     */
+    @Builder.Default
+    private String timestamp = Instant.now().toString();
+
+    /**
+     * Optional pagination metadata (for list responses).
+     */
+    private Pagination pagination;
+
+    /**
+     * Nested class for pagination metadata.
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Pagination {
+        /**
+         * Current page number (1-based).
+         */
+        private int page;
+
+        /**
+         * Number of items per page.
+         */
+        private int limit;
+
+        /**
+         * Total number of items.
+         */
+        private long total;
+
+        /**
+         * Total number of pages.
+         */
+        private int pages;
+    }
+}

From 7e25be694b74d6dd644f058df9d1c282403b298d Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Fri, 24 Oct 2025 15:20:16 -0400
Subject: [PATCH 011/110] feat: add CRUD endpoints

---
 JAVA-SPRING-IMPLEMENTATION-PLAN.md            | 679 ------------------
 server/express/.gitignore                     |  30 +-
 server/express/src/utils/errorHandler.ts      |   4 +-
 .../samplemflix/SampleMflixApplication.java   |  23 +-
 .../samplemflix/config/CorsConfig.java        |   5 +-
 .../config/DatabaseVerification.java          |  10 +-
 .../samplemflix/config/MongoConfig.java       |   6 +-
 .../controller/MovieController.java           |  31 -
 .../controller/MovieControllerImpl.java       | 248 +++++++
 .../exception/GlobalExceptionHandler.java     | 110 ++-
 .../mongodb/samplemflix/model/Comment.java    |   6 +-
 .../com/mongodb/samplemflix/model/Movie.java  |   7 +-
 .../mongodb/samplemflix/model/Theater.java    |   6 +-
 .../model/dto/CreateMovieRequest.java         |   4 +-
 .../model/dto/MovieSearchQuery.java           |   5 +-
 .../model/dto/UpdateMovieRequest.java         |   4 +-
 .../model/response/ApiResponse.java           |   6 +-
 .../model/response/ErrorResponse.java         |   5 +-
 .../model/response/SuccessResponse.java       |   5 +-
 .../repository/MovieRepository.java           | 118 ++-
 .../repository/MovieRepositoryImpl.java       | 353 +++++++++
 .../samplemflix/service/MovieService.java     |  47 +-
 .../samplemflix/service/MovieServiceImpl.java | 309 ++++++++
 .../src/main/resources/application.properties |   5 +-
 24 files changed, 1189 insertions(+), 837 deletions(-)
 delete mode 100644 JAVA-SPRING-IMPLEMENTATION-PLAN.md
 delete mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieController.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java

diff --git a/JAVA-SPRING-IMPLEMENTATION-PLAN.md b/JAVA-SPRING-IMPLEMENTATION-PLAN.md
deleted file mode 100644
index 206e08e..0000000
--- a/JAVA-SPRING-IMPLEMENTATION-PLAN.md
+++ /dev/null
@@ -1,679 +0,0 @@
-# Java Spring Backend Implementation Plan
-
-## Executive Summary
-
-This document outlines the comprehensive implementation plan for translating the Express.js/TypeScript backend into a Java Spring Boot application. The implementation will maintain feature parity with the existing Express backend while following Spring Boot best practices and the MongoDB Java Driver conventions.
-
----
-
-## 1. Project Overview
-
-### 1.1 Current State Analysis
-
-**Existing Express Backend Features:**
-- ✅ Basic CRUD operations (insertOne, insertMany, findOne, find, updateOne, updateMany, deleteOne, deleteMany, findOneAndDelete)
-- ✅ MongoDB connection management with pre-flight verification
-- ✅ Text search index creation and verification
-- ✅ Comprehensive error handling
-- ✅ Request validation
-- ✅ CORS configuration
-- ✅ Environment variable configuration
-- ✅ Unit tests with Jest
-
-**Python Backend Status:**
-- Partially implemented (only GET and batch POST endpoints)
-- Uses FastAPI with PyMongo driver
-- Async/await pattern
-
-### 1.2 Target Architecture
-
-**Java Spring Boot Stack:**
-- **Framework:** Spring Boot 3.x
-- **MongoDB Driver:** MongoDB Java Driver (latest stable version)
-- **Build Tool:** Maven or Gradle
-- **Java Version:** Java 17 or 21 (LTS)
-- **Testing:** JUnit 5 + Mockito + Spring Boot Test
-- **Documentation:** SpringDoc OpenAPI (Swagger)
-
----
-
-## 2. Project Structure
-
-### 2.1 Directory Layout
-
-```
-server/java-spring/
-├── src/
-│   ├── main/
-│   │   ├── java/
-│   │   │   └── com/
-│   │   │       └── mongodb/
-│   │   │           └── samplemflix/
-│   │   │               ├── SampleMflixApplication.java
-│   │   │               ├── config/
-│   │   │               │   ├── MongoConfig.java
-│   │   │               │   ├── CorsConfig.java
-│   │   │               │   └── DatabaseVerification.java
-│   │   │               ├── controller/
-│   │   │               │   └── MovieController.java
-│   │   │               ├── service/
-│   │   │               │   └── MovieService.java
-│   │   │               ├── repository/
-│   │   │               │   └── MovieRepository.java
-│   │   │               ├── model/
-│   │   │               │   ├── Movie.java
-│   │   │               │   ├── Theater.java
-│   │   │               │   ├── Comment.java
-│   │   │               │   ├── dto/
-│   │   │               │   │   ├── CreateMovieRequest.java
-│   │   │               │   │   ├── UpdateMovieRequest.java
-│   │   │               │   │   └── MovieSearchQuery.java
-│   │   │               │   └── response/
-│   │   │               │       ├── ApiResponse.java
-│   │   │               │       ├── SuccessResponse.java
-│   │   │               │       └── ErrorResponse.java
-│   │   │               ├── exception/
-│   │   │               │   ├── GlobalExceptionHandler.java
-│   │   │               │   ├── ValidationException.java
-│   │   │               │   └── ResourceNotFoundException.java
-│   │   │               └── util/
-│   │   │                   └── ValidationUtils.java
-│   │   └── resources/
-│   │       ├── application.properties
-│   │       └── application-dev.properties
-│   └── test/
-│       └── java/
-│           └── com/
-│               └── mongodb/
-│                   └── samplemflix/
-│                       ├── controller/
-│                       │   └── MovieControllerTest.java
-│                       ├── service/
-│                       │   └── MovieServiceTest.java
-│                       └── integration/
-│                           └── MovieIntegrationTest.java
-├── pom.xml (or build.gradle)
-├── README.md
-└── .env.example
-```
-
----
-
-## 3. Implementation Phases
-
-### Phase 1: Project Setup and Configuration (Days 1-2)
-
-#### 1.1 Initialize Spring Boot Project
-- [ ] Create Spring Boot project using Spring Initializr
-- [ ] Configure Maven/Gradle with required dependencies
-- [ ] Set up project structure following Spring conventions
-- [ ] Configure `.gitignore` for Java/Spring projects
-
-#### 1.2 Dependencies Configuration
-
-**Required Dependencies:**
-```xml
-<!-- Core Spring Boot -->
-<dependency>
-    <groupId>org.springframework.boot</groupId>
-    <artifactId>spring-boot-starter-web</artifactId>
-</dependency>
-
-<!-- MongoDB Driver -->
-<dependency>
-    <groupId>org.mongodb</groupId>
-    <artifactId>mongodb-driver-sync</artifactId>
-</dependency>
-
-<!-- Validation -->
-<dependency>
-    <groupId>org.springframework.boot</groupId>
-    <artifactId>spring-boot-starter-validation</artifactId>
-</dependency>
-
-<!-- Lombok (optional, for reducing boilerplate) -->
-<dependency>
-    <groupId>org.projectlombok</groupId>
-    <artifactId>lombok</artifactId>
-    <optional>true</optional>
-</dependency>
-
-<!-- Testing -->
-<dependency>
-    <groupId>org.springframework.boot</groupId>
-    <artifactId>spring-boot-starter-test</artifactId>
-    <scope>test</scope>
-</dependency>
-
-<!-- SpringDoc OpenAPI (Swagger) -->
-<dependency>
-    <groupId>org.springdoc</groupId>
-    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
-</dependency>
-```
-
-#### 1.3 Environment Configuration
-- [ ] Create `application.properties` with MongoDB connection settings
-- [ ] Create `.env.example` file documenting required environment variables
-- [ ] Implement environment variable loading (Spring Boot handles this natively)
-- [ ] Configure CORS settings
-
-**application.properties:**
-```properties
-# MongoDB Configuration
-spring.data.mongodb.uri=${MONGODB_URI}
-spring.data.mongodb.database=sample_mflix
-
-# Server Configuration
-server.port=${PORT:3001}
-
-# CORS Configuration
-cors.allowed.origins=${CORS_ORIGIN:http://localhost:3000}
-
-# Application Info
-spring.application.name=MongoDB Sample MFlix API
-```
-
----
-
-### Phase 2: Database Configuration and Connection (Days 2-3) ✅ COMPLETE
-
-#### 2.1 MongoDB Configuration Class ✅
-- [x] Create `MongoConfig.java` to configure MongoDB client
-- [x] Implement connection pooling and timeout settings
-- [x] Add connection lifecycle management
-
-**Key Features:**
-- ✅ Singleton MongoClient instance
-- ✅ Connection string validation
-- ✅ Database reference management
-- ✅ Graceful shutdown handling (managed by Spring)
-- ✅ Connection pool settings (max 100, min 10 connections)
-- ✅ Socket timeouts (10s connect, 10s read)
-- ✅ Server selection timeout (10s)
-
-#### 2.2 Database Verification Service ✅
-- [x] Create `DatabaseVerification.java` as a Spring component
-- [x] Implement `@PostConstruct` method for startup verification
-- [x] Check for movies collection and document count
-- [x] Create text search indexes if missing
-- [x] Log verification results
-
-**Verification Checklist:**
-- ✅ Movies collection exists
-- ✅ Movies collection has documents (with warning if empty)
-- ✅ Text search index on plot, title, fullplot fields
-- ✅ Log warnings if data is missing
-- ✅ Non-blocking verification (app starts even if verification fails)
-
----
-
-### Phase 3: Model Layer Implementation (Days 3-4) ✅ COMPLETE
-
-#### 3.1 Domain Models ✅
-- [x] Create `Movie.java` entity class
-- [x] Create `Theater.java` entity class
-- [x] Create `Comment.java` entity class
-- [x] Add BSON annotations for MongoDB mapping (using Lombok)
-- [x] Implement nested objects (Awards, IMDB, Tomatoes)
-
-**Movie.java Structure:** ✅
-- ✅ All fields from TypeScript Movie interface
-- ✅ Nested class: Awards (wins, nominations, text)
-- ✅ Nested class: Imdb (rating, votes, id)
-- ✅ Nested class: Tomatoes (viewer, critic, fresh, rotten, production, lastUpdated)
-- ✅ Nested classes: Tomatoes.Viewer and Tomatoes.Critic
-- ✅ Lombok annotations (@Data, @Builder, @NoArgsConstructor, @AllArgsConstructor)
-- ✅ Comprehensive JavaDoc documentation
-
-**Theater.java Structure:** ✅
-- ✅ All fields from TypeScript Theater interface
-- ✅ Nested class: Location (address, geo)
-- ✅ Nested class: Location.Address (street1, city, state, zipcode)
-- ✅ Nested class: Location.Geo (type, coordinates)
-- ✅ GeoJSON format support for geospatial queries
-
-**Comment.java Structure:** ✅
-- ✅ All fields from TypeScript Comment interface
-- ✅ Fields: id, name, email, movieId, text, date
-
-#### 3.2 DTOs (Data Transfer Objects) ✅
-- [x] Create `CreateMovieRequest.java`
-- [x] Create `UpdateMovieRequest.java`
-- [x] Create `MovieSearchQuery.java`
-- [x] Add validation annotations (@NotBlank for required fields)
-
-**CreateMovieRequest.java:** ✅
-- ✅ Required field: title (with @NotBlank validation)
-- ✅ Optional fields: year, plot, fullplot, genres, directors, writers, cast, countries, languages, rated, runtime, poster
-
-**UpdateMovieRequest.java:** ✅
-- ✅ All fields optional (for partial updates)
-- ✅ Same fields as CreateMovieRequest
-
-**MovieSearchQuery.java:** ✅
-- ✅ Full-text search: q
-- ✅ Filters: genre, year, minRating, maxRating
-- ✅ Pagination: limit, skip
-- ✅ Sorting: sortBy, sortOrder
-
-#### 3.3 Response Models ✅
-- [x] Create generic `ApiResponse` interface
-- [x] Create `SuccessResponse<T>` class
-- [x] Create `ErrorResponse` class
-- [x] Add timestamp and metadata fields
-
-**ApiResponse Interface:** ✅
-- ✅ Methods: isSuccess(), getTimestamp()
-
-**SuccessResponse<T>:** ✅
-- ✅ Generic type parameter for data
-- ✅ Fields: success (true), message, data, timestamp, pagination
-- ✅ Nested class: Pagination (page, limit, total, pages)
-- ✅ @JsonInclude(NON_NULL) to exclude null fields
-
-**ErrorResponse:** ✅
-- ✅ Fields: success (false), message, error, timestamp
-- ✅ Nested class: ErrorDetails (message, code, details)
-- ✅ Matches Express backend error format
-
----
-
-### Phase 4: Repository Layer (Days 4-5)
-
-#### 4.1 Custom Repository Implementation
-- [ ] Create `MovieRepository.java` interface
-- [ ] Implement custom repository using MongoTemplate or MongoCollection
-- [ ] Add methods for all CRUD operations
-
-**Repository Methods:**
-```java
-public interface MovieRepository {
-    // Basic CRUD
-    Movie insertOne(Movie movie);
-    List<ObjectId> insertMany(List<Movie> movies);
-    Optional<Movie> findById(ObjectId id);
-    List<Movie> find(Document filter, Document sort, int skip, int limit);
-    UpdateResult updateOne(ObjectId id, Document update);
-    UpdateResult updateMany(Document filter, Document update);
-    DeleteResult deleteOne(ObjectId id);
-    DeleteResult deleteMany(Document filter);
-    Optional<Movie> findOneAndDelete(ObjectId id);
-    
-    // Utility
-    long countDocuments();
-}
-```
-
----
-
-### Phase 5: Service Layer (Days 5-7)
-
-#### 5.1 Movie Service Implementation
-- [ ] Create `MovieService.java` with business logic
-- [ ] Implement all CRUD operations
-- [ ] Add query building logic for filtering
-- [ ] Implement pagination and sorting
-- [ ] Add validation logic
-
-**Service Responsibilities:**
-- Business logic and validation
-- Query construction (filters, sorts, pagination)
-- Data transformation between DTOs and entities
-- Error handling and exception throwing
-
----
-
-### Phase 6: Controller Layer (Days 7-9)
-
-#### 6.1 REST API Endpoints
-- [ ] Create `MovieController.java` with REST endpoints
-- [ ] Implement all endpoints matching Express routes
-- [ ] Add request validation
-- [ ] Add API documentation annotations
-
-**Endpoint Mapping:**
-```
-GET    /api/movies              -> getAllMovies()
-GET    /api/movies/{id}         -> getMovieById()
-POST   /api/movies              -> createMovie()
-POST   /api/movies/batch        -> createMoviesBatch()
-PUT    /api/movies/{id}         -> updateMovie()
-PATCH  /api/movies              -> updateMoviesBatch()
-DELETE /api/movies/{id}         -> deleteMovie()
-DELETE /api/movies              -> deleteMoviesBatch()
-DELETE /api/movies/{id}/find-and-delete -> findAndDeleteMovie()
-```
-
-#### 6.2 Request/Response Handling
-- [ ] Implement consistent response wrapping
-- [ ] Add query parameter parsing
-- [ ] Implement request body validation
-- [ ] Add proper HTTP status codes
-
----
-
-### Phase 7: Error Handling (Days 9-10)
-
-#### 7.1 Exception Hierarchy
-- [ ] Create custom exception classes
-- [ ] Implement `GlobalExceptionHandler` with @ControllerAdvice
-- [ ] Handle MongoDB-specific exceptions
-- [ ] Handle validation exceptions
-
-**Exception Types:**
-- `ResourceNotFoundException` (404)
-- `ValidationException` (400)
-- `DuplicateKeyException` (409)
-- `DatabaseException` (500)
-
-#### 7.2 Error Response Format
-- [ ] Standardize error response structure
-- [ ] Include error codes and messages
-- [ ] Add timestamp and request path
-- [ ] Log errors appropriately
-
----
-
-### Phase 8: Testing (Days 10-12)
-
-#### 8.1 Unit Tests
-- [ ] Test MovieService methods
-- [ ] Test MovieController endpoints
-- [ ] Mock repository layer
-- [ ] Achieve >80% code coverage
-
-#### 8.2 Integration Tests
-- [ ] Test with embedded MongoDB or Testcontainers
-- [ ] Test full request/response cycle
-- [ ] Test error scenarios
-- [ ] Test database operations
-
-#### 8.3 Test Configuration
-- [ ] Create test application.properties
-- [ ] Set up test fixtures and data
-- [ ] Configure test MongoDB instance
-
----
-
-### Phase 9: Documentation and Polish (Days 12-13)
-
-#### 9.1 Code Documentation
-- [ ] Add comprehensive JavaDoc comments
-- [ ] Document MongoDB operations clearly
-- [ ] Add inline comments explaining driver usage
-- [ ] Note deviations from standard practices
-
-#### 9.2 API Documentation
-- [ ] Configure Swagger/OpenAPI
-- [ ] Add endpoint descriptions
-- [ ] Document request/response schemas
-- [ ] Add example requests
-
-#### 9.3 README and Setup Guide
-- [ ] Create comprehensive README.md
-- [ ] Document prerequisites (Java version, Maven/Gradle)
-- [ ] Provide setup instructions
-- [ ] Document environment variables
-- [ ] Add troubleshooting section
-
----
-
-## 4. Technical Implementation Details
-
-### 4.1 MongoDB Driver Usage Patterns
-
-**Connection Management:**
-```java
-@Configuration
-public class MongoConfig {
-    @Bean
-    public MongoClient mongoClient(@Value("${spring.data.mongodb.uri}") String uri) {
-        return MongoClients.create(uri);
-    }
-    
-    @Bean
-    public MongoDatabase mongoDatabase(MongoClient client) {
-        return client.getDatabase("sample_mflix");
-    }
-}
-```
-
-**Collection Access:**
-```java
-@Repository
-public class MovieRepositoryImpl implements MovieRepository {
-    private final MongoCollection<Document> collection;
-    
-    public MovieRepositoryImpl(MongoDatabase database) {
-        this.collection = database.getCollection("movies");
-    }
-}
-```
-
-### 4.2 Query Building Examples
-
-**Text Search:**
-```java
-Document filter = new Document("$text", new Document("$search", searchQuery));
-```
-
-**Range Queries:**
-```java
-Document ratingFilter = new Document()
-    .append("$gte", minRating)
-    .append("$lte", maxRating);
-filter.append("imdb.rating", ratingFilter);
-```
-
-**Sorting:**
-```java
-Document sort = new Document(sortBy, sortOrder.equals("desc") ? -1 : 1);
-```
-
-### 4.3 Error Handling Pattern
-
-```java
-@ControllerAdvice
-public class GlobalExceptionHandler {
-    @ExceptionHandler(MongoException.class)
-    public ResponseEntity<ErrorResponse> handleMongoException(MongoException ex) {
-        // Parse MongoDB error codes
-        // Return appropriate HTTP status and error response
-    }
-}
-```
-
----
-
-## 5. Migration Mapping
-
-### 5.1 Express to Spring Equivalents
-
-| Express Concept | Spring Boot Equivalent |
-|----------------|------------------------|
-| `app.ts` | `SampleMflixApplication.java` (main class) |
-| Routes (`movies.ts`) | `@RestController` in `MovieController.java` |
-| Controllers | `@Service` in `MovieService.java` |
-| `database.ts` | `MongoConfig.java` + `DatabaseVerification.java` |
-| `errorHandler.ts` | `GlobalExceptionHandler.java` |
-| Types/Interfaces | Java classes with proper annotations |
-| `asyncHandler` | Spring handles async automatically |
-| `dotenv` | `application.properties` + environment variables |
-
-### 5.2 Code Pattern Translations
-
-**Express Pattern:**
-```typescript
-router.get("/", asyncHandler(movieController.getAllMovies));
-```
-
-**Spring Pattern:**
-```java
-@GetMapping
-public ResponseEntity<SuccessResponse<List<Movie>>> getAllMovies(
-    @RequestParam(required = false) String q,
-    // ... other params
-) {
-    // Implementation
-}
-```
-
----
-
-## 6. Quality Assurance Checklist
-
-### 6.1 Functional Requirements
-- [ ] All CRUD operations work correctly
-- [ ] Text search functionality works
-- [ ] Filtering and pagination work
-- [ ] Sorting works correctly
-- [ ] Batch operations work
-- [ ] Error handling is comprehensive
-
-### 6.2 Code Quality
-- [ ] Code follows Spring Boot best practices
-- [ ] Comprehensive comments explaining MongoDB operations
-- [ ] Proper separation of concerns (Controller/Service/Repository)
-- [ ] No hardcoded values
-- [ ] Proper exception handling
-
-### 6.3 Testing
-- [ ] Unit tests pass
-- [ ] Integration tests pass
-- [ ] Code coverage >80%
-- [ ] Edge cases tested
-
-### 6.4 Documentation
-- [ ] README is comprehensive
-- [ ] API documentation is complete
-- [ ] Code comments are thorough
-- [ ] Setup instructions are clear
-
----
-
-## 7. Timeline and Milestones
-
-| Phase | Duration | Deliverable |
-|-------|----------|-------------|
-| Phase 1: Setup | 2 days | Project structure, dependencies configured |
-| Phase 2: Database | 1 day | MongoDB connection and verification working |
-| Phase 3: Models | 1 day | All model classes implemented |
-| Phase 4: Repository | 1 day | Repository layer complete |
-| Phase 5: Service | 2 days | Business logic implemented |
-| Phase 6: Controller | 2 days | All REST endpoints working |
-| Phase 7: Error Handling | 1 day | Comprehensive error handling |
-| Phase 8: Testing | 2 days | Tests written and passing |
-| Phase 9: Documentation | 1 day | Documentation complete |
-| **Total** | **13 days** | **Production-ready Java Spring backend** |
-
----
-
-## 8. Post-Implementation Tasks
-
-### 8.1 Integration with Frontend
-- [ ] Test with existing Next.js frontend
-- [ ] Verify CORS configuration
-- [ ] Test all API endpoints from frontend
-- [ ] Verify response format compatibility
-
-### 8.2 Performance Optimization
-- [ ] Add connection pooling configuration
-- [ ] Optimize query performance
-- [ ] Add caching if needed
-- [ ] Profile and optimize hot paths
-
-### 8.3 Deployment Preparation
-- [ ] Create Docker configuration
-- [ ] Document deployment process
-- [ ] Create production configuration
-- [ ] Add health check endpoints
-
----
-
-## 9. Success Criteria
-
-The Java Spring implementation will be considered complete when:
-
-1. ✅ All CRUD operations match Express functionality
-2. ✅ All tests pass with >80% coverage
-3. ✅ API responses match Express format exactly
-4. ✅ Frontend works without modifications
-5. ✅ Documentation is comprehensive
-6. ✅ Code follows Spring Boot best practices
-7. ✅ MongoDB operations are well-documented
-8. ✅ Error handling is robust
-9. ✅ Pre-flight verification works
-10. ✅ README provides clear setup instructions
-
----
-
-## 10. Notes and Considerations
-
-### 10.1 Design Decisions
-
-**Why not Spring Data MongoDB?**
-- The scope requires direct MongoDB Driver usage to demonstrate driver operations
-- Spring Data MongoDB abstracts away driver details
-- Educational value is in showing raw driver usage
-
-**Lombok Usage:**
-- Optional but recommended for reducing boilerplate
-- Helps maintain readability
-- Can be removed if team prefers explicit code
-
-**Testing Strategy:**
-- Unit tests for service layer
-- Integration tests for full stack
-- Consider Testcontainers for realistic MongoDB testing
-
-### 10.2 Future Enhancements (Post-MVP)
-
-- [ ] Aggregation pipeline endpoints
-- [ ] Full-text search with Atlas Search
-- [ ] Vector search implementation
-- [ ] Geospatial queries for theaters
-- [ ] Caching layer
-- [ ] Rate limiting
-- [ ] Metrics and monitoring
-
----
-
-## Appendix A: Key Files Reference
-
-### Express Backend Files to Reference
-- `server/express/src/app.ts` - Main application setup
-- `server/express/src/config/database.ts` - Database configuration
-- `server/express/src/controllers/movieController.ts` - Business logic
-- `server/express/src/routes/movies.ts` - Route definitions
-- `server/express/src/types/index.ts` - Type definitions
-- `server/express/src/utils/errorHandler.ts` - Error handling
-
-### Python Backend Files (for comparison)
-- `server/python/main.py` - FastAPI application
-- `server/python/src/routers/movies.py` - Route handlers
-- `server/python/src/database/mongo_client.py` - Database connection
-
----
-
-## Appendix B: Environment Variables
-
-Required environment variables for Java Spring backend:
-
-```properties
-# MongoDB Connection
-MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/?retryWrites=true&w=majority
-
-# Server Configuration
-PORT=3001
-
-# CORS Configuration
-CORS_ORIGIN=http://localhost:3000
-```
-
----
-
-**Document Version:** 1.0  
-**Last Updated:** 2025-10-23  
-**Author:** Implementation Plan Generator  
-**Status:** Ready for Implementation
diff --git a/server/express/.gitignore b/server/express/.gitignore
index 26db928..8fa0429 100644
--- a/server/express/.gitignore
+++ b/server/express/.gitignore
@@ -1,26 +1,16 @@
-# Dependencies
-node_modules/
-npm-debug.log*
-package-lock.json
+# =============================================================================
+# Express.js Backend - Specific Ignores
+# =============================================================================
+# Common patterns (node_modules, .env, .DS_Store, etc.) are in root .gitignore
+# This file only contains Express/TypeScript-specific patterns
+# =============================================================================
 
-# Environment variables
-.env
-
-# Build output
+# Build Output
 dist/
+build/
 
 # TypeScript
 *.tsbuildinfo
 
-# Logs
-logs
-*.log
-
-# Test coverage
-coverage/
-
-# Optional npm cache directory
-.npm
-
-# macOS
-.DS_Store
\ No newline at end of file
+# Package Lock (optional - remove this line if you want to commit package-lock.json)
+# package-lock.json
diff --git a/server/express/src/utils/errorHandler.ts b/server/express/src/utils/errorHandler.ts
index 929cf29..83a2b54 100644
--- a/server/express/src/utils/errorHandler.ts
+++ b/server/express/src/utils/errorHandler.ts
@@ -28,13 +28,13 @@ export class ValidationError extends Error {
  * @param err - The error that was thrown
  * @param req - Express request object
  * @param res - Express response object
- * @param next - Express next function
+ * @param _next - Express next function
  */
 export function errorHandler(
   err: Error,
   req: Request,
   res: Response,
-  next: NextFunction
+  _next: NextFunction
 ): void {
   // Log the error for debugging purposes
   // In production, we recommend using a logging service
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
index 52f367b..86ea28f 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
@@ -2,22 +2,39 @@
 
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Map;
 
 /**
  * Main Spring Boot application class for the MongoDB Sample MFlix API.
- * 
+ *
  * This application demonstrates MongoDB CRUD operations using the MongoDB Java Driver
  * in a Spring Boot environment. It provides a REST API for managing movie data from
  * the sample_mflix database.
- * 
+ *
  * @author MongoDB Documentation Team
  * @version 1.0
  */
 @SpringBootApplication
+@RestController
 public class SampleMflixApplication {
 
     public static void main(String[] args) {
         SpringApplication.run(SampleMflixApplication.class, args);
     }
-}
 
+    /**
+     * Root endpoint providing basic information about the API.
+     */
+    @GetMapping("/")
+    public Map<String, Object> root() {
+        return Map.of(
+                "name", "MongoDB Sample MFlix API",
+                "version", "1.0.0",
+                "description", "Java Spring Boot backend demonstrating MongoDB operations with the sample_mflix dataset",
+                "endpoints", Map.of("movies", "/api/movies")
+        );
+    }
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
index f1a9ae6..178cdc3 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
@@ -11,10 +11,10 @@
 
 /**
  * CORS (Cross-Origin Resource Sharing) configuration for the Sample MFlix API.
- * 
+ * <p>
  * This configuration allows the frontend application (typically running on a different port
  * during development) to make requests to this backend API.
- * 
+ * <p>
  * The allowed origins are configured via the CORS_ORIGIN environment variable.
  */
 @Configuration
@@ -50,4 +50,3 @@ public CorsFilter corsFilter() {
         return new CorsFilter(source);
     }
 }
-
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
index 38cb728..6063bb6 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -13,16 +13,16 @@
 
 /**
  * Database verification component that runs on application startup.
- *
+ * <p>
  * This component performs pre-flight checks to ensure the MongoDB database
  * is properly configured and contains the expected data and indexes.
- *
+ * <p>
  * Verification steps:
  * 1. Check if the movies collection exists
  * 2. Verify the collection contains documents
  * 3. Check for text search indexes on plot, title, and fullplot fields
  * 4. Create text search index if missing
- *
+ * <p>
  * This matches the behavior of the Express.js backend's verifyRequirements() function.
  * The verification is non-blocking - the application will start even if verification fails,
  * but warnings will be logged to help developers identify configuration issues.
@@ -43,10 +43,10 @@ public DatabaseVerification(MongoDatabase database) {
 
     /**
      * Runs database verification checks after the bean is constructed.
-     *
+     * <p>
      * This method is called automatically by Spring after dependency injection
      * is complete. It performs all verification steps and logs the results.
-     *
+     * <p>
      * The method catches all exceptions to prevent application startup failure,
      * but logs errors to help developers identify issues.
      */
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
index e6d294a..3afa3a4 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
@@ -13,17 +13,17 @@
 
 /**
  * MongoDB configuration class for the Sample MFlix application.
- *
+ * <p>
  * This class configures the MongoDB client connection using the MongoDB Java Driver.
  * It creates singleton beans for MongoClient and MongoDatabase that will be injected
  * throughout the application.
- *
+ * <p>
  * Key features:
  * - Connection pooling with configurable settings (max 100 connections, min 10)
  * - Connection timeout configuration (10 seconds for connect and read)
  * - Graceful shutdown handling (managed by Spring's bean lifecycle)
  * - Connection string validation
- *
+ * <p>
  * The MongoClient is thread-safe and designed to be shared across the application.
  * Spring automatically manages the lifecycle and closes the client on shutdown.
  */
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieController.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieController.java
deleted file mode 100644
index 463e27c..0000000
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieController.java
+++ /dev/null
@@ -1,31 +0,0 @@
-package com.mongodb.samplemflix.controller;
-
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
-
-/**
- * REST controller for movie-related endpoints.
- * 
- * This controller handles all HTTP requests for movie operations including:
- * - GET /api/movies - Get all movies with filtering, sorting, and pagination
- * - GET /api/movies/{id} - Get a single movie by ID
- * - POST /api/movies - Create a new movie
- * - POST /api/movies/batch - Create multiple movies
- * - PUT /api/movies/{id} - Update a movie
- * - PATCH /api/movies - Update multiple movies
- * - DELETE /api/movies/{id} - Delete a movie
- * - DELETE /api/movies - Delete multiple movies
- * - DELETE /api/movies/{id}/find-and-delete - Find and delete a movie
- * 
- * TODO: Phase 6 - Implement all REST endpoints
- * TODO: Phase 6 - Add request validation
- * TODO: Phase 6 - Add API documentation annotations
- */
-@RestController
-@RequestMapping("/api/movies")
-public class MovieController {
-    
-    // TODO: Phase 6 - Inject MovieService
-    // TODO: Phase 6 - Implement endpoint methods
-}
-
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
new file mode 100644
index 0000000..643b48e
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -0,0 +1,248 @@
+package com.mongodb.samplemflix.controller;
+
+import com.mongodb.samplemflix.model.Movie;
+import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
+import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
+import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
+import com.mongodb.samplemflix.model.response.SuccessResponse;
+import com.mongodb.samplemflix.service.MovieService;
+import jakarta.validation.Valid;
+import org.bson.Document;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import java.time.Instant;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * REST controller for movie-related endpoints.
+ * <p>
+ * This controller handles all HTTP requests for movie operations including:
+ * - GET /api/movies - Get all movies with filtering, sorting, and pagination
+ * - GET /api/movies/{id} - Get a single movie by ID
+ * - POST /api/movies - Create a new movie
+ * - POST /api/movies/batch - Create multiple movies
+ * - PUT /api/movies/{id} - Update a movie
+ * - PATCH /api/movies - Update multiple movies
+ * - DELETE /api/movies/{id} - Delete a movie
+ * - DELETE /api/movies - Delete multiple movies
+ * - DELETE /api/movies/{id}/find-and-delete - Find and delete a movie
+ */
+@RestController
+@RequestMapping("/api/movies")
+public class MovieControllerImpl {
+    
+    private final MovieService movieService;
+    
+    public MovieControllerImpl(MovieService movieService) {
+        this.movieService = movieService;
+    }
+    
+    /**
+     * GET /api/movies
+     * <p>
+     * Retrieves multiple movies with optional filtering, sorting, and pagination.
+     */
+    @GetMapping
+    public ResponseEntity<SuccessResponse<List<Movie>>> getAllMovies(
+            @RequestParam(required = false) String q,
+            @RequestParam(required = false) String genre,
+            @RequestParam(required = false) Integer year,
+            @RequestParam(required = false) Double minRating,
+            @RequestParam(required = false) Double maxRating,
+            @RequestParam(defaultValue = "20") Integer limit,
+            @RequestParam(defaultValue = "0") Integer skip,
+            @RequestParam(defaultValue = "title") String sortBy,
+            @RequestParam(defaultValue = "asc") String sortOrder) {
+        
+        MovieSearchQuery query = MovieSearchQuery.builder()
+                .q(q)
+                .genre(genre)
+                .year(year)
+                .minRating(minRating)
+                .maxRating(maxRating)
+                .limit(limit)
+                .skip(skip)
+                .sortBy(sortBy)
+                .sortOrder(sortOrder)
+                .build();
+        
+        List<Movie> movies = movieService.getAllMovies(query);
+        
+        SuccessResponse<List<Movie>> response = SuccessResponse.<List<Movie>>builder()
+                .success(true)
+                .message("Found " + movies.size() + " movies")
+                .data(movies)
+                .timestamp(Instant.now().toString())
+                .build();
+        
+        return ResponseEntity.ok(response);
+    }
+    
+    /**
+     * GET /api/movies/{id}
+     * <p>
+     * Retrieves a single movie by its ObjectId.
+     */
+    @GetMapping("/{id}")
+    public ResponseEntity<SuccessResponse<Movie>> getMovieById(@PathVariable String id) {
+        Movie movie = movieService.getMovieById(id);
+        
+        SuccessResponse<Movie> response = SuccessResponse.<Movie>builder()
+                .success(true)
+                .message("Movie retrieved successfully")
+                .data(movie)
+                .timestamp(Instant.now().toString())
+                .build();
+        
+        return ResponseEntity.ok(response);
+    }
+    
+    /**
+     * POST /api/movies
+     * <p>
+     * Creates a single new movie document.
+     */
+    @PostMapping
+    public ResponseEntity<SuccessResponse<Movie>> createMovie(@Valid @RequestBody CreateMovieRequest request) {
+        Movie movie = movieService.createMovie(request);
+        
+        SuccessResponse<Movie> response = SuccessResponse.<Movie>builder()
+                .success(true)
+                .message("Movie '" + request.getTitle() + "' created successfully")
+                .data(movie)
+                .timestamp(Instant.now().toString())
+                .build();
+        
+        return ResponseEntity.status(HttpStatus.CREATED).body(response);
+    }
+    
+    /**
+     * POST /api/movies/batch
+     * <p>
+     * Creates multiple movie documents in a single operation.
+     */
+    @PostMapping("/batch")
+    public ResponseEntity<SuccessResponse<Map<String, Object>>> createMoviesBatch(
+            @RequestBody List<CreateMovieRequest> requests) {
+        Map<String, Object> result = movieService.createMoviesBatch(requests);
+        
+        SuccessResponse<Map<String, Object>> response = SuccessResponse.<Map<String, Object>>builder()
+                .success(true)
+                .message("Successfully created " + result.get("insertedCount") + " movies")
+                .data(result)
+                .timestamp(Instant.now().toString())
+                .build();
+        
+        return ResponseEntity.status(HttpStatus.CREATED).body(response);
+    }
+    
+    /**
+     * PUT /api/movies/{id}
+     * <p>
+     * Updates a single movie document.
+     */
+    @PutMapping("/{id}")
+    public ResponseEntity<SuccessResponse<Movie>> updateMovie(
+            @PathVariable String id,
+            @RequestBody UpdateMovieRequest request) {
+        Movie movie = movieService.updateMovie(id, request);
+        
+        SuccessResponse<Movie> response = SuccessResponse.<Movie>builder()
+                .success(true)
+                .message("Movie updated successfully")
+                .data(movie)
+                .timestamp(Instant.now().toString())
+                .build();
+        
+        return ResponseEntity.ok(response);
+    }
+    
+    /**
+     * PATCH /api/movies
+     * <p>
+     * Updates multiple movies based on a filter.
+     */
+    @SuppressWarnings("unchecked")
+    @PatchMapping
+    public ResponseEntity<SuccessResponse<Map<String, Object>>> updateMoviesBatch(
+            @RequestBody Map<String, Object> body) {
+        Document filter = new Document((Map<String, Object>) body.get("filter"));
+        Document update = new Document((Map<String, Object>) body.get("update"));
+
+        Map<String, Object> result = movieService.updateMoviesBatch(filter, update);
+
+        SuccessResponse<Map<String, Object>> response = SuccessResponse.<Map<String, Object>>builder()
+                .success(true)
+                .message("Update operation completed. Matched " + result.get("matchedCount") +
+                        " documents, modified " + result.get("modifiedCount") + " documents.")
+                .data(result)
+                .timestamp(Instant.now().toString())
+                .build();
+
+        return ResponseEntity.ok(response);
+    }
+    
+    /**
+     * DELETE /api/movies/{id}/find-and-delete
+     * <p>
+     * Finds and deletes a movie in a single atomic operation.
+     */
+    @DeleteMapping("/{id}/find-and-delete")
+    public ResponseEntity<SuccessResponse<Movie>> findAndDeleteMovie(@PathVariable String id) {
+        Movie movie = movieService.findAndDeleteMovie(id);
+        
+        SuccessResponse<Movie> response = SuccessResponse.<Movie>builder()
+                .success(true)
+                .message("Movie found and deleted successfully")
+                .data(movie)
+                .timestamp(Instant.now().toString())
+                .build();
+        
+        return ResponseEntity.ok(response);
+    }
+    
+    /**
+     * DELETE /api/movies/{id}
+     * <p>
+     * Deletes a single movie document.
+     */
+    @DeleteMapping("/{id}")
+    public ResponseEntity<SuccessResponse<Map<String, Object>>> deleteMovie(@PathVariable String id) {
+        Map<String, Object> result = movieService.deleteMovie(id);
+        
+        SuccessResponse<Map<String, Object>> response = SuccessResponse.<Map<String, Object>>builder()
+                .success(true)
+                .message("Movie deleted successfully")
+                .data(result)
+                .timestamp(Instant.now().toString())
+                .build();
+        
+        return ResponseEntity.ok(response);
+    }
+    
+    /**
+     * DELETE /api/movies
+     * <p>
+     * Deletes multiple movies based on a filter.
+     */
+    @SuppressWarnings("unchecked")
+    @DeleteMapping
+    public ResponseEntity<SuccessResponse<Map<String, Object>>> deleteMoviesBatch(
+            @RequestBody Map<String, Object> body) {
+        Document filter = new Document((Map<String, Object>) body.get("filter"));
+
+        Map<String, Object> result = movieService.deleteMoviesBatch(filter);
+
+        SuccessResponse<Map<String, Object>> response = SuccessResponse.<Map<String, Object>>builder()
+                .success(true)
+                .message("Delete operation completed. Removed " + result.get("deletedCount") + " documents.")
+                .data(result)
+                .timestamp(Instant.now().toString())
+                .build();
+
+        return ResponseEntity.ok(response);
+    }
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
index 4fbfaf8..fc344ea 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
@@ -1,26 +1,108 @@
 package com.mongodb.samplemflix.exception;
 
+import com.mongodb.MongoWriteException;
+import com.mongodb.samplemflix.model.response.ErrorResponse;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.ControllerAdvice;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.context.request.WebRequest;
+
+import java.time.Instant;
 
 /**
  * Global exception handler for the application.
- * 
+ *
  * This class uses @ControllerAdvice to handle exceptions thrown by controllers
  * and convert them into appropriate HTTP responses.
- * 
- * Exception types to handle:
- * - ResourceNotFoundException (404)
- * - ValidationException (400)
- * - DuplicateKeyException (409)
- * - MongoException (500)
- * - General exceptions (500)
- * 
- * TODO: Phase 7 - Implement exception handler methods
- * TODO: Phase 7 - Add @ExceptionHandler methods for each exception type
  */
 @ControllerAdvice
 public class GlobalExceptionHandler {
-    
-    // TODO: Phase 7 - Implement exception handlers
-}
 
+    private static final Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);
+
+    @ExceptionHandler(ResourceNotFoundException.class)
+    public ResponseEntity<ErrorResponse> handleResourceNotFoundException(
+            ResourceNotFoundException ex, WebRequest request) {
+        logger.error("Resource not found: {}", ex.getMessage());
+
+        ErrorResponse errorResponse = ErrorResponse.builder()
+                .success(false)
+                .message(ex.getMessage())
+                .error(ErrorResponse.ErrorDetails.builder()
+                        .message(ex.getMessage())
+                        .code("RESOURCE_NOT_FOUND")
+                        .build())
+                .timestamp(Instant.now().toString())
+                .build();
+
+        return new ResponseEntity<>(errorResponse, HttpStatus.NOT_FOUND);
+    }
+
+    @ExceptionHandler(ValidationException.class)
+    public ResponseEntity<ErrorResponse> handleValidationException(
+            ValidationException ex, WebRequest request) {
+        logger.error("Validation error: {}", ex.getMessage());
+
+        ErrorResponse errorResponse = ErrorResponse.builder()
+                .success(false)
+                .message("Validation failed")
+                .error(ErrorResponse.ErrorDetails.builder()
+                        .message(ex.getMessage())
+                        .code("VALIDATION_ERROR")
+                        .build())
+                .timestamp(Instant.now().toString())
+                .build();
+
+        return new ResponseEntity<>(errorResponse, HttpStatus.BAD_REQUEST);
+    }
+
+    @ExceptionHandler(MongoWriteException.class)
+    public ResponseEntity<ErrorResponse> handleMongoWriteException(
+            MongoWriteException ex, WebRequest request) {
+        logger.error("MongoDB write error: {}", ex.getMessage());
+
+        String message = "Database error";
+        String code = "DATABASE_ERROR";
+        HttpStatus status = HttpStatus.INTERNAL_SERVER_ERROR;
+
+        if (ex.getError().getCode() == 11000) {
+            message = "Duplicate key error";
+            code = "DUPLICATE_KEY";
+            status = HttpStatus.CONFLICT;
+        }
+
+        ErrorResponse errorResponse = ErrorResponse.builder()
+                .success(false)
+                .message(message)
+                .error(ErrorResponse.ErrorDetails.builder()
+                        .message(message)
+                        .code(code)
+                        .details(ex.getError().getCode())
+                        .build())
+                .timestamp(Instant.now().toString())
+                .build();
+
+        return new ResponseEntity<>(errorResponse, status);
+    }
+
+    @ExceptionHandler(Exception.class)
+    public ResponseEntity<ErrorResponse> handleGenericException(
+            Exception ex, WebRequest request) {
+        logger.error("Unexpected error occurred", ex);
+
+        ErrorResponse errorResponse = ErrorResponse.builder()
+                .success(false)
+                .message(ex.getMessage() != null ? ex.getMessage() : "Internal server error")
+                .error(ErrorResponse.ErrorDetails.builder()
+                        .message(ex.getMessage() != null ? ex.getMessage() : "Internal server error")
+                        .code("INTERNAL_ERROR")
+                        .build())
+                .timestamp(Instant.now().toString())
+                .build();
+
+        return new ResponseEntity<>(errorResponse, HttpStatus.INTERNAL_SERVER_ERROR);
+    }
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
index 2702f6b..e7a61f4 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
@@ -10,12 +10,9 @@
 
 /**
  * Domain model representing a comment document from the MongoDB comments collection.
- * 
+ * <p>
  * This class maps to the comments collection in the sample_mflix database.
  * Comments are user reviews/comments associated with movies.
- * 
- * The structure matches the TypeScript Comment interface from the Express backend
- * to ensure API compatibility.
  */
 @Data
 @Builder
@@ -55,4 +52,3 @@ public class Comment {
      */
     private Date date;
 }
-
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
index e0c6acb..98235e0 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
@@ -11,14 +11,11 @@
 
 /**
  * Domain model representing a movie document from the MongoDB movies collection.
- *
+ * <p>
  * This class maps to the movies collection in the sample_mflix database.
  * It includes all fields from the movie documents including nested objects
  * for awards, IMDB ratings, and Tomatoes ratings.
- *
- * The structure matches the TypeScript Movie interface from the Express backend
- * to ensure API compatibility.
- *
+ * <p>
  * Note: We use Lombok annotations to reduce boilerplate code:
  * - @Data: Generates getters, setters, toString, equals, and hashCode
  * - @Builder: Provides a fluent builder pattern for object construction
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
index e636226..2dc8161 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
@@ -8,12 +8,9 @@
 
 /**
  * Domain model representing a theater document from the MongoDB theaters collection.
- * 
+ * <p>
  * This class maps to the theaters collection in the sample_mflix database.
  * It includes location information with address and geospatial coordinates.
- * 
- * The structure matches the TypeScript Theater interface from the Express backend
- * to ensure API compatibility.
  */
 @Data
 @Builder
@@ -106,4 +103,3 @@ public static class Geo {
         }
     }
 }
-
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
index 179bb03..485f65b 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
@@ -10,11 +10,9 @@
 
 /**
  * Data Transfer Object for creating a new movie.
- *
+ * <p>
  * This DTO is used for POST /api/movies requests.
  * It includes validation annotations to ensure required fields are present.
- *
- * The structure matches the TypeScript CreateMovieRequest interface from the Express backend.
  * Only the title field is required; all other fields are optional.
  */
 @Data
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java
index b9ad823..20d6833 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java
@@ -7,11 +7,9 @@
 
 /**
  * Data Transfer Object for movie search query parameters.
- * 
+ * <p>
  * This DTO is used to parse and validate query parameters for GET /api/movies requests.
  * It supports full-text search, filtering by genre/year/rating, sorting, and pagination.
- * 
- * The structure matches the search functionality from the Express backend.
  */
 @Data
 @Builder
@@ -67,4 +65,3 @@ public class MovieSearchQuery {
      */
     private String sortOrder;
 }
-
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
index 50423cb..99d9ab3 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
@@ -9,11 +9,9 @@
 
 /**
  * Data Transfer Object for updating an existing movie.
- *
+ * <p>
  * This DTO is used for PUT /api/movies/{id} requests.
  * All fields are optional since partial updates are allowed.
- *
- * The structure matches the TypeScript UpdateMovieRequest interface from the Express backend.
  * Any field that is null will not be updated in the database.
  */
 @Data
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
index fb06da9..b76fa3d 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
@@ -2,15 +2,13 @@
 
 /**
  * Generic API response interface.
- *
+ * <p>
  * This interface is implemented by both SuccessResponse and ErrorResponse
  * to provide a consistent response structure across all API endpoints.
- *
+ * <p>
  * All API responses include:
  * - success: boolean indicating if the request was successful
  * - timestamp: ISO 8601 timestamp of when the response was generated
- *
- * This matches the TypeScript ApiResponse type from the Express backend.
  */
 public interface ApiResponse {
 
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
index f81ded1..457dd52 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
@@ -10,10 +10,9 @@
 
 /**
  * Error response wrapper for API error responses.
- *
+ * <p>
  * This class wraps error responses with error codes, messages, and metadata.
- *
- * The structure matches the TypeScript ErrorResponse type from the Express backend:
+ * <p>
  * {
  *   success: false,
  *   message: string,
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
index 36c0e41..251c6f3 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
@@ -10,11 +10,10 @@
 
 /**
  * Success response wrapper for API responses.
- *
+ * <p>
  * This class wraps successful API responses with metadata like timestamp and pagination.
  * It uses a generic type parameter T to hold the response data.
- *
- * The structure matches the TypeScript SuccessResponse type from the Express backend:
+ * <p>
  * {
  *   success: true,
  *   message?: string,
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
index a4efb4e..b416ba1 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
@@ -1,27 +1,105 @@
 package com.mongodb.samplemflix.repository;
 
+import com.mongodb.client.result.DeleteResult;
+import com.mongodb.client.result.InsertManyResult;
+import com.mongodb.client.result.InsertOneResult;
+import com.mongodb.client.result.UpdateResult;
+import com.mongodb.samplemflix.model.Movie;
+import org.bson.Document;
+import org.bson.types.ObjectId;
+
+import java.util.List;
+import java.util.Optional;
+
 /**
  * Repository interface for movie data access.
- * 
- * This repository provides methods for all CRUD operations using the MongoDB Java Driver.
- * 
- * Methods to implement:
- * - insertOne(Movie movie)
- * - insertMany(List<Movie> movies)
- * - findById(ObjectId id)
- * - find(Document filter, Document sort, int skip, int limit)
- * - updateOne(ObjectId id, Document update)
- * - updateMany(Document filter, Document update)
- * - deleteOne(ObjectId id)
- * - deleteMany(Document filter)
- * - findOneAndDelete(ObjectId id)
- * - countDocuments()
- * 
- * TODO: Phase 4 - Define repository interface methods
- * TODO: Phase 4 - Create implementation class using MongoCollection
+ *
+ * This repository provides methods for all CRUD operations using the MongoDB Java Driver directly.
+ * The implementation uses MongoCollection<Document> for direct control over BSON documents.
  */
 public interface MovieRepository {
-    
-    // TODO: Phase 4 - Add method signatures
-}
 
+    /**
+     * Inserts a single movie document.
+     *
+     * @param movie the movie to insert
+     * @return the result of the insert operation
+     */
+    InsertOneResult insertOne(Movie movie);
+
+    /**
+     * Inserts multiple movie documents.
+     *
+     * @param movies the list of movies to insert
+     * @return the result of the insert operation
+     */
+    InsertManyResult insertMany(List<Movie> movies);
+
+    /**
+     * Finds a single movie by its ID.
+     *
+     * @param id the movie ID
+     * @return Optional containing the movie if found, empty otherwise
+     */
+    Optional<Movie> findById(ObjectId id);
+
+    /**
+     * Finds multiple movies with filtering, sorting, and pagination.
+     *
+     * @param filter the filter document
+     * @param sort the sort document
+     * @param skip number of documents to skip
+     * @param limit maximum number of documents to return
+     * @return list of movies matching the criteria
+     */
+    List<Movie> find(Document filter, Document sort, int skip, int limit);
+
+    /**
+     * Updates a single movie by ID.
+     *
+     * @param id the movie ID
+     * @param update the update document
+     * @return the result of the update operation
+     */
+    UpdateResult updateOne(ObjectId id, Document update);
+
+    /**
+     * Updates multiple movies matching the filter.
+     *
+     * @param filter the filter document
+     * @param update the update document
+     * @return the result of the update operation
+     */
+    UpdateResult updateMany(Document filter, Document update);
+
+    /**
+     * Deletes a single movie by ID.
+     *
+     * @param id the movie ID
+     * @return the result of the delete operation
+     */
+    DeleteResult deleteOne(ObjectId id);
+
+    /**
+     * Deletes multiple movies matching the filter.
+     *
+     * @param filter the filter document
+     * @return the result of the delete operation
+     */
+    DeleteResult deleteMany(Document filter);
+
+    /**
+     * Finds and deletes a single movie in one atomic operation.
+     *
+     * @param id the movie ID
+     * @return Optional containing the deleted movie if found, empty otherwise
+     */
+    Optional<Movie> findOneAndDelete(ObjectId id);
+
+    /**
+     * Counts the total number of documents in the movies collection.
+     *
+     * @return the count of documents
+     */
+    long countDocuments();
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java
new file mode 100644
index 0000000..a8ccc16
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java
@@ -0,0 +1,353 @@
+package com.mongodb.samplemflix.repository;
+
+import com.mongodb.client.MongoCollection;
+import com.mongodb.client.MongoDatabase;
+import com.mongodb.client.model.Filters;
+import com.mongodb.client.result.DeleteResult;
+import com.mongodb.client.result.InsertManyResult;
+import com.mongodb.client.result.InsertOneResult;
+import com.mongodb.client.result.UpdateResult;
+import com.mongodb.samplemflix.model.Movie;
+import org.bson.Document;
+import org.bson.types.ObjectId;
+import org.springframework.stereotype.Repository;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Optional;
+import java.util.stream.Collectors;
+
+/**
+ * Implementation of MovieRepository using MongoDB Java Driver directly.
+ * 
+ * This class demonstrates direct usage of MongoCollection<Document> for CRUD operations.
+ * It manually converts between Movie objects and BSON Documents to provide full control
+ * over the MongoDB operations.
+ * 
+ * This approach is used for educational purposes to show how the MongoDB driver works,
+ * rather than using Spring Data MongoDB which abstracts these details.
+ */
+@Repository
+public class MovieRepositoryImpl implements MovieRepository {
+    
+    private final MongoCollection<Document> moviesCollection;
+    
+    public MovieRepositoryImpl(MongoDatabase mongoDatabase) {
+        this.moviesCollection = mongoDatabase.getCollection("movies");
+    }
+    
+    @Override
+    public InsertOneResult insertOne(Movie movie) {
+        Document doc = movieToDocument(movie);
+        return moviesCollection.insertOne(doc);
+    }
+    
+    @Override
+    public InsertManyResult insertMany(List<Movie> movies) {
+        List<Document> documents = movies.stream()
+                .map(this::movieToDocument)
+                .collect(Collectors.toList());
+        return moviesCollection.insertMany(documents);
+    }
+    
+    @Override
+    public Optional<Movie> findById(ObjectId id) {
+        Document doc = moviesCollection.find(Filters.eq("_id", id)).first();
+        return Optional.ofNullable(doc).map(this::documentToMovie);
+    }
+    
+    @Override
+    public List<Movie> find(Document filter, Document sort, int skip, int limit) {
+        List<Movie> movies = new ArrayList<>();
+        moviesCollection.find(filter)
+                .sort(sort)
+                .skip(skip)
+                .limit(limit)
+                .forEach(doc -> movies.add(documentToMovie(doc)));
+        return movies;
+    }
+    
+    @Override
+    public UpdateResult updateOne(ObjectId id, Document update) {
+        return moviesCollection.updateOne(Filters.eq("_id", id), update);
+    }
+    
+    @Override
+    public UpdateResult updateMany(Document filter, Document update) {
+        return moviesCollection.updateMany(filter, update);
+    }
+    
+    @Override
+    public DeleteResult deleteOne(ObjectId id) {
+        return moviesCollection.deleteOne(Filters.eq("_id", id));
+    }
+    
+    @Override
+    public DeleteResult deleteMany(Document filter) {
+        return moviesCollection.deleteMany(filter);
+    }
+    
+    @Override
+    public Optional<Movie> findOneAndDelete(ObjectId id) {
+        Document doc = moviesCollection.findOneAndDelete(Filters.eq("_id", id));
+        return Optional.ofNullable(doc).map(this::documentToMovie);
+    }
+    
+    @Override
+    public long countDocuments() {
+        return moviesCollection.countDocuments();
+    }
+    
+    /**
+     * Converts a Movie object to a BSON Document.
+     * 
+     * @param movie the Movie object
+     * @return the BSON Document
+     */
+    private Document movieToDocument(Movie movie) {
+        Document doc = new Document();
+        
+        if (movie.getId() != null) {
+            doc.append("_id", movie.getId());
+        }
+        if (movie.getTitle() != null) {
+            doc.append("title", movie.getTitle());
+        }
+        if (movie.getYear() != null) {
+            doc.append("year", movie.getYear());
+        }
+        if (movie.getPlot() != null) {
+            doc.append("plot", movie.getPlot());
+        }
+        if (movie.getFullplot() != null) {
+            doc.append("fullplot", movie.getFullplot());
+        }
+        if (movie.getReleased() != null) {
+            doc.append("released", movie.getReleased());
+        }
+        if (movie.getRuntime() != null) {
+            doc.append("runtime", movie.getRuntime());
+        }
+        if (movie.getPoster() != null) {
+            doc.append("poster", movie.getPoster());
+        }
+        if (movie.getGenres() != null) {
+            doc.append("genres", movie.getGenres());
+        }
+        if (movie.getDirectors() != null) {
+            doc.append("directors", movie.getDirectors());
+        }
+        if (movie.getWriters() != null) {
+            doc.append("writers", movie.getWriters());
+        }
+        if (movie.getCast() != null) {
+            doc.append("cast", movie.getCast());
+        }
+        if (movie.getCountries() != null) {
+            doc.append("countries", movie.getCountries());
+        }
+        if (movie.getLanguages() != null) {
+            doc.append("languages", movie.getLanguages());
+        }
+        if (movie.getRated() != null) {
+            doc.append("rated", movie.getRated());
+        }
+        if (movie.getAwards() != null) {
+            doc.append("awards", awardsToDocument(movie.getAwards()));
+        }
+        if (movie.getImdb() != null) {
+            doc.append("imdb", imdbToDocument(movie.getImdb()));
+        }
+        if (movie.getTomatoes() != null) {
+            doc.append("tomatoes", tomatoesToDocument(movie.getTomatoes()));
+        }
+        if (movie.getMetacritic() != null) {
+            doc.append("metacritic", movie.getMetacritic());
+        }
+        if (movie.getType() != null) {
+            doc.append("type", movie.getType());
+        }
+        
+        return doc;
+    }
+    
+    /**
+     * Converts a BSON Document to a Movie object.
+     * 
+     * @param doc the BSON Document
+     * @return the Movie object
+     */
+    @SuppressWarnings("unchecked")
+    private Movie documentToMovie(Document doc) {
+        Movie movie = new Movie();
+        
+        movie.setId(doc.getObjectId("_id"));
+        movie.setTitle(doc.getString("title"));
+        movie.setYear(doc.getInteger("year"));
+        movie.setPlot(doc.getString("plot"));
+        movie.setFullplot(doc.getString("fullplot"));
+        movie.setReleased(doc.getDate("released"));
+        movie.setRuntime(doc.getInteger("runtime"));
+        movie.setPoster(doc.getString("poster"));
+        movie.setGenres((List<String>) doc.get("genres"));
+        movie.setDirectors((List<String>) doc.get("directors"));
+        movie.setWriters((List<String>) doc.get("writers"));
+        movie.setCast((List<String>) doc.get("cast"));
+        movie.setCountries((List<String>) doc.get("countries"));
+        movie.setLanguages((List<String>) doc.get("languages"));
+        movie.setRated(doc.getString("rated"));
+        movie.setMetacritic(doc.getInteger("metacritic"));
+        movie.setType(doc.getString("type"));
+        
+        Document awardsDoc = (Document) doc.get("awards");
+        if (awardsDoc != null) {
+            movie.setAwards(documentToAwards(awardsDoc));
+        }
+        
+        Document imdbDoc = (Document) doc.get("imdb");
+        if (imdbDoc != null) {
+            movie.setImdb(documentToImdb(imdbDoc));
+        }
+        
+        Document tomatoesDoc = (Document) doc.get("tomatoes");
+        if (tomatoesDoc != null) {
+            movie.setTomatoes(documentToTomatoes(tomatoesDoc));
+        }
+        
+        return movie;
+    }
+    
+    private Document awardsToDocument(Movie.Awards awards) {
+        Document doc = new Document();
+        if (awards.getWins() != null) {
+            doc.append("wins", awards.getWins());
+        }
+        if (awards.getNominations() != null) {
+            doc.append("nominations", awards.getNominations());
+        }
+        if (awards.getText() != null) {
+            doc.append("text", awards.getText());
+        }
+        return doc;
+    }
+    
+    private Movie.Awards documentToAwards(Document doc) {
+        return Movie.Awards.builder()
+                .wins(doc.getInteger("wins"))
+                .nominations(doc.getInteger("nominations"))
+                .text(doc.getString("text"))
+                .build();
+    }
+    
+    private Document imdbToDocument(Movie.Imdb imdb) {
+        Document doc = new Document();
+        if (imdb.getRating() != null) {
+            doc.append("rating", imdb.getRating());
+        }
+        if (imdb.getVotes() != null) {
+            doc.append("votes", imdb.getVotes());
+        }
+        if (imdb.getId() != null) {
+            doc.append("id", imdb.getId());
+        }
+        return doc;
+    }
+    
+    private Movie.Imdb documentToImdb(Document doc) {
+        return Movie.Imdb.builder()
+                .rating(doc.getDouble("rating"))
+                .votes(doc.getInteger("votes"))
+                .id(doc.getInteger("id"))
+                .build();
+    }
+
+    private Document tomatoesToDocument(Movie.Tomatoes tomatoes) {
+        Document doc = new Document();
+        if (tomatoes.getViewer() != null) {
+            doc.append("viewer", viewerToDocument(tomatoes.getViewer()));
+        }
+        if (tomatoes.getCritic() != null) {
+            doc.append("critic", criticToDocument(tomatoes.getCritic()));
+        }
+        if (tomatoes.getFresh() != null) {
+            doc.append("fresh", tomatoes.getFresh());
+        }
+        if (tomatoes.getRotten() != null) {
+            doc.append("rotten", tomatoes.getRotten());
+        }
+        if (tomatoes.getProduction() != null) {
+            doc.append("production", tomatoes.getProduction());
+        }
+        if (tomatoes.getLastUpdated() != null) {
+            doc.append("lastUpdated", tomatoes.getLastUpdated());
+        }
+        return doc;
+    }
+
+    private Movie.Tomatoes documentToTomatoes(Document doc) {
+        Movie.Tomatoes.Viewer viewer = null;
+        Document viewerDoc = (Document) doc.get("viewer");
+        if (viewerDoc != null) {
+            viewer = documentToViewer(viewerDoc);
+        }
+
+        Movie.Tomatoes.Critic critic = null;
+        Document criticDoc = (Document) doc.get("critic");
+        if (criticDoc != null) {
+            critic = documentToCritic(criticDoc);
+        }
+
+        return Movie.Tomatoes.builder()
+                .viewer(viewer)
+                .critic(critic)
+                .fresh(doc.getInteger("fresh"))
+                .rotten(doc.getInteger("rotten"))
+                .production(doc.getString("production"))
+                .lastUpdated(doc.getDate("lastUpdated"))
+                .build();
+    }
+
+    private Document viewerToDocument(Movie.Tomatoes.Viewer viewer) {
+        Document doc = new Document();
+        if (viewer.getRating() != null) {
+            doc.append("rating", viewer.getRating());
+        }
+        if (viewer.getNumReviews() != null) {
+            doc.append("numReviews", viewer.getNumReviews());
+        }
+        if (viewer.getMeter() != null) {
+            doc.append("meter", viewer.getMeter());
+        }
+        return doc;
+    }
+
+    private Movie.Tomatoes.Viewer documentToViewer(Document doc) {
+        return Movie.Tomatoes.Viewer.builder()
+                .rating(doc.getDouble("rating"))
+                .numReviews(doc.getInteger("numReviews"))
+                .meter(doc.getInteger("meter"))
+                .build();
+    }
+
+    private Document criticToDocument(Movie.Tomatoes.Critic critic) {
+        Document doc = new Document();
+        if (critic.getRating() != null) {
+            doc.append("rating", critic.getRating());
+        }
+        if (critic.getNumReviews() != null) {
+            doc.append("numReviews", critic.getNumReviews());
+        }
+        if (critic.getMeter() != null) {
+            doc.append("meter", critic.getMeter());
+        }
+        return doc;
+    }
+
+    private Movie.Tomatoes.Critic documentToCritic(Document doc) {
+        return Movie.Tomatoes.Critic.builder()
+                .rating(doc.getDouble("rating"))
+                .numReviews(doc.getInteger("numReviews"))
+                .meter(doc.getInteger("meter"))
+                .build();
+    }
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
index 529b20d..4e44003 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
@@ -1,25 +1,34 @@
 package com.mongodb.samplemflix.service;
 
-import org.springframework.stereotype.Service;
+import com.mongodb.samplemflix.model.Movie;
+import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
+import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
+import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
+import org.bson.Document;
+
+import java.util.List;
+import java.util.Map;
 
 /**
- * Service layer for movie business logic.
- * 
- * This service handles:
- * - Business logic and validation
- * - Query construction (filters, sorts, pagination)
- * - Data transformation between DTOs and entities
- * - Error handling and exception throwing
- * 
- * TODO: Phase 5 - Implement all CRUD operations
- * TODO: Phase 5 - Add query building logic for filtering
- * TODO: Phase 5 - Implement pagination and sorting
- * TODO: Phase 5 - Add validation logic
+ * Service interface for movie business logic.
  */
-@Service
-public class MovieService {
-    
-    // TODO: Phase 5 - Inject MovieRepository
-    // TODO: Phase 5 - Implement service methods
-}
+public interface MovieService {
+
+    List<Movie> getAllMovies(MovieSearchQuery query);
+
+    Movie getMovieById(String id);
+
+    Movie createMovie(CreateMovieRequest request);
+
+    Map<String, Object> createMoviesBatch(List<CreateMovieRequest> requests);
 
+    Movie updateMovie(String id, UpdateMovieRequest request);
+
+    Map<String, Object> updateMoviesBatch(Document filter, Document update);
+
+    Map<String, Object> deleteMovie(String id);
+
+    Map<String, Object> deleteMoviesBatch(Document filter);
+
+    Movie findAndDeleteMovie(String id);
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
new file mode 100644
index 0000000..e049cfe
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -0,0 +1,309 @@
+package com.mongodb.samplemflix.service;
+
+import com.mongodb.client.result.DeleteResult;
+import com.mongodb.client.result.InsertManyResult;
+import com.mongodb.client.result.InsertOneResult;
+import com.mongodb.client.result.UpdateResult;
+import com.mongodb.samplemflix.exception.ResourceNotFoundException;
+import com.mongodb.samplemflix.exception.ValidationException;
+import com.mongodb.samplemflix.model.Movie;
+import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
+import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
+import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
+import com.mongodb.samplemflix.repository.MovieRepository;
+import org.bson.Document;
+import org.bson.types.ObjectId;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+import java.util.Map;
+import java.util.regex.Pattern;
+
+/**
+ * Service layer for movie business logic.
+ * 
+ * This service handles:
+ * - Business logic and validation
+ * - Query construction (filters, sorts, pagination)
+ * - Data transformation between DTOs and entities
+ * - Error handling and exception throwing
+ */
+@Service
+public class MovieServiceImpl implements MovieService {
+    
+    private final MovieRepository movieRepository;
+    
+    public MovieServiceImpl(MovieRepository movieRepository) {
+        this.movieRepository = movieRepository;
+    }
+    
+    @Override
+    public List<Movie> getAllMovies(MovieSearchQuery query) {
+        Document filter = buildFilter(query);
+        Document sort = buildSort(query.getSortBy(), query.getSortOrder());
+        
+        int limit = Math.min(Math.max(query.getLimit() != null ? query.getLimit() : 20, 1), 100);
+        int skip = Math.max(query.getSkip() != null ? query.getSkip() : 0, 0);
+        
+        return movieRepository.find(filter, sort, skip, limit);
+    }
+    
+    @Override
+    public Movie getMovieById(String id) {
+        if (!ObjectId.isValid(id)) {
+            throw new ValidationException("Invalid movie ID format");
+        }
+        
+        return movieRepository.findById(new ObjectId(id))
+                .orElseThrow(() -> new ResourceNotFoundException("Movie not found"));
+    }
+    
+    @Override
+    public Movie createMovie(CreateMovieRequest request) {
+        if (request.getTitle() == null || request.getTitle().trim().isEmpty()) {
+            throw new ValidationException("Title is required");
+        }
+        
+        Movie movie = Movie.builder()
+                .title(request.getTitle())
+                .year(request.getYear())
+                .plot(request.getPlot())
+                .fullplot(request.getFullplot())
+                .genres(request.getGenres())
+                .directors(request.getDirectors())
+                .writers(request.getWriters())
+                .cast(request.getCast())
+                .countries(request.getCountries())
+                .languages(request.getLanguages())
+                .rated(request.getRated())
+                .runtime(request.getRuntime())
+                .poster(request.getPoster())
+                .build();
+        
+        InsertOneResult result = movieRepository.insertOne(movie);
+        
+        if (!result.wasAcknowledged()) {
+            throw new RuntimeException("Movie insertion was not acknowledged by the database");
+        }
+        
+        return movieRepository.findById(result.getInsertedId().asObjectId().getValue())
+                .orElseThrow(() -> new RuntimeException("Failed to retrieve created movie"));
+    }
+    
+    @Override
+    public Map<String, Object> createMoviesBatch(List<CreateMovieRequest> requests) {
+        if (requests == null || requests.isEmpty()) {
+            throw new ValidationException("Request body must be a non-empty array of movie objects");
+        }
+        
+        for (int i = 0; i < requests.size(); i++) {
+            CreateMovieRequest request = requests.get(i);
+            if (request.getTitle() == null || request.getTitle().trim().isEmpty()) {
+                throw new ValidationException("Movie at index " + i + ": Title is required");
+            }
+        }
+        
+        List<Movie> movies = requests.stream()
+                .map(request -> Movie.builder()
+                        .title(request.getTitle())
+                        .year(request.getYear())
+                        .plot(request.getPlot())
+                        .fullplot(request.getFullplot())
+                        .genres(request.getGenres())
+                        .directors(request.getDirectors())
+                        .writers(request.getWriters())
+                        .cast(request.getCast())
+                        .countries(request.getCountries())
+                        .languages(request.getLanguages())
+                        .rated(request.getRated())
+                        .runtime(request.getRuntime())
+                        .poster(request.getPoster())
+                        .build())
+                .toList();
+        
+        InsertManyResult result = movieRepository.insertMany(movies);
+        
+        if (!result.wasAcknowledged()) {
+            throw new RuntimeException("Batch movie insertion was not acknowledged by the database");
+        }
+        
+        return Map.of(
+                "insertedCount", result.getInsertedIds().size(),
+                "insertedIds", result.getInsertedIds().values()
+        );
+    }
+    
+    @Override
+    public Movie updateMovie(String id, UpdateMovieRequest request) {
+        if (!ObjectId.isValid(id)) {
+            throw new ValidationException("Invalid movie ID format");
+        }
+        
+        if (request == null || isUpdateRequestEmpty(request)) {
+            throw new ValidationException("No update data provided");
+        }
+        
+        Document update = new Document("$set", buildUpdateDocument(request));
+        UpdateResult result = movieRepository.updateOne(new ObjectId(id), update);
+        
+        if (result.getMatchedCount() == 0) {
+            throw new ResourceNotFoundException("Movie not found");
+        }
+        
+        return movieRepository.findById(new ObjectId(id))
+                .orElseThrow(() -> new RuntimeException("Failed to retrieve updated movie"));
+    }
+    
+    @Override
+    public Map<String, Object> updateMoviesBatch(Document filter, Document update) {
+        if (filter == null || update == null) {
+            throw new ValidationException("Both filter and update objects are required");
+        }
+        
+        if (update.isEmpty()) {
+            throw new ValidationException("Update object cannot be empty");
+        }
+        
+        Document setUpdate = new Document("$set", update);
+        UpdateResult result = movieRepository.updateMany(filter, setUpdate);
+        
+        return Map.of(
+                "matchedCount", result.getMatchedCount(),
+                "modifiedCount", result.getModifiedCount()
+        );
+    }
+    
+    @Override
+    public Map<String, Object> deleteMovie(String id) {
+        if (!ObjectId.isValid(id)) {
+            throw new ValidationException("Invalid movie ID format");
+        }
+        
+        DeleteResult result = movieRepository.deleteOne(new ObjectId(id));
+        
+        if (result.getDeletedCount() == 0) {
+            throw new ResourceNotFoundException("Movie not found");
+        }
+        
+        return Map.of("deletedCount", result.getDeletedCount());
+    }
+    
+    @Override
+    public Map<String, Object> deleteMoviesBatch(Document filter) {
+        if (filter == null || filter.isEmpty()) {
+            throw new ValidationException("Filter object is required and cannot be empty. This prevents accidental deletion of all documents.");
+        }
+        
+        DeleteResult result = movieRepository.deleteMany(filter);
+        
+        return Map.of("deletedCount", result.getDeletedCount());
+    }
+    
+    @Override
+    public Movie findAndDeleteMovie(String id) {
+        if (!ObjectId.isValid(id)) {
+            throw new ValidationException("Invalid movie ID format");
+        }
+        
+        return movieRepository.findOneAndDelete(new ObjectId(id))
+                .orElseThrow(() -> new ResourceNotFoundException("Movie not found"));
+    }
+    
+    private Document buildFilter(MovieSearchQuery query) {
+        Document filter = new Document();
+        
+        if (query.getQ() != null && !query.getQ().trim().isEmpty()) {
+            filter.append("$text", new Document("$search", query.getQ()));
+        }
+        
+        if (query.getGenre() != null && !query.getGenre().trim().isEmpty()) {
+            filter.append("genres", new Document("$regex", Pattern.compile(query.getGenre(), Pattern.CASE_INSENSITIVE)));
+        }
+        
+        if (query.getYear() != null) {
+            filter.append("year", query.getYear());
+        }
+        
+        if (query.getMinRating() != null || query.getMaxRating() != null) {
+            Document ratingFilter = new Document();
+            if (query.getMinRating() != null) {
+                ratingFilter.append("$gte", query.getMinRating());
+            }
+            if (query.getMaxRating() != null) {
+                ratingFilter.append("$lte", query.getMaxRating());
+            }
+            filter.append("imdb.rating", ratingFilter);
+        }
+        
+        return filter;
+    }
+    
+    private Document buildSort(String sortBy, String sortOrder) {
+        String field = sortBy != null && !sortBy.trim().isEmpty() ? sortBy : "title";
+        int order = "desc".equalsIgnoreCase(sortOrder) ? -1 : 1;
+        return new Document(field, order);
+    }
+    
+    private boolean isUpdateRequestEmpty(UpdateMovieRequest request) {
+        return request.getTitle() == null &&
+               request.getYear() == null &&
+               request.getPlot() == null &&
+               request.getFullplot() == null &&
+               request.getGenres() == null &&
+               request.getDirectors() == null &&
+               request.getWriters() == null &&
+               request.getCast() == null &&
+               request.getCountries() == null &&
+               request.getLanguages() == null &&
+               request.getRated() == null &&
+               request.getRuntime() == null &&
+               request.getPoster() == null;
+    }
+    
+    private Document buildUpdateDocument(UpdateMovieRequest request) {
+        Document doc = new Document();
+        
+        if (request.getTitle() != null) {
+            doc.append("title", request.getTitle());
+        }
+        if (request.getYear() != null) {
+            doc.append("year", request.getYear());
+        }
+        if (request.getPlot() != null) {
+            doc.append("plot", request.getPlot());
+        }
+        if (request.getFullplot() != null) {
+            doc.append("fullplot", request.getFullplot());
+        }
+        if (request.getGenres() != null) {
+            doc.append("genres", request.getGenres());
+        }
+        if (request.getDirectors() != null) {
+            doc.append("directors", request.getDirectors());
+        }
+        if (request.getWriters() != null) {
+            doc.append("writers", request.getWriters());
+        }
+        if (request.getCast() != null) {
+            doc.append("cast", request.getCast());
+        }
+        if (request.getCountries() != null) {
+            doc.append("countries", request.getCountries());
+        }
+        if (request.getLanguages() != null) {
+            doc.append("languages", request.getLanguages());
+        }
+        if (request.getRated() != null) {
+            doc.append("rated", request.getRated());
+        }
+        if (request.getRuntime() != null) {
+            doc.append("runtime", request.getRuntime());
+        }
+        if (request.getPoster() != null) {
+            doc.append("poster", request.getPoster());
+        }
+        
+        return doc;
+    }
+}
+
diff --git a/server/java-spring/src/main/resources/application.properties b/server/java-spring/src/main/resources/application.properties
index 276a15b..46705ba 100644
--- a/server/java-spring/src/main/resources/application.properties
+++ b/server/java-spring/src/main/resources/application.properties
@@ -1,10 +1,10 @@
 # MongoDB Configuration
-# Connection URI should be provided via MONGODB_URI environment variable
+# Connection URI should be provided with the MONGODB_URI environment variable
 spring.data.mongodb.uri=${MONGODB_URI}
 spring.data.mongodb.database=sample_mflix
 
 # Server Configuration
-# Default port is 3001, can be overridden via PORT environment variable
+# Default port is 3001, can be overridden with the PORT environment variable
 server.port=${PORT:3001}
 
 # CORS Configuration
@@ -26,4 +26,3 @@ spring.jackson.serialization.write-dates-as-timestamps=false
 springdoc.api-docs.path=/api-docs
 springdoc.swagger-ui.path=/swagger-ui.html
 springdoc.swagger-ui.operationsSorter=method
-

From dd8fe3a2c1fdd6b790cc9db93424a4fa277d822e Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Fri, 24 Oct 2025 15:52:35 -0400
Subject: [PATCH 012/110] fix: remove unneeded files and update .gitignore and
 .gitattributes

---
 .gitattributes                   |    8 +
 PR_DESCRIPTION.md                |  274 --
 client/next-env.d.ts             |    6 -
 client/package-lock.json         | 5007 ------------------------------
 server/express/.gitignore        |    4 +-
 server/express/package-lock.json | 4748 ----------------------------
 6 files changed, 10 insertions(+), 10037 deletions(-)
 create mode 100644 .gitattributes
 delete mode 100644 PR_DESCRIPTION.md
 delete mode 100644 client/next-env.d.ts
 delete mode 100644 client/package-lock.json
 delete mode 100644 server/express/package-lock.json

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..f0749cd
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,8 @@
+# Git Attributes for docs-sample-apps
+# Marks auto-generated files that are committed to version control
+# so they're collapsed in GitHub PR diffs and excluded from code review
+
+# Maven Wrapper - Auto-generated by Apache Maven (committed to git)
+# See: https://maven.apache.org/wrapper/
+server/java-spring/mvnw linguist-generated=true
+server/java-spring/mvnw.cmd linguist-generated=true
diff --git a/PR_DESCRIPTION.md b/PR_DESCRIPTION.md
deleted file mode 100644
index 2d46f00..0000000
--- a/PR_DESCRIPTION.md
+++ /dev/null
@@ -1,274 +0,0 @@
-# Java Spring Backend Implementation - Phases 2 & 3
-
-## 📋 Overview
-
-This PR implements **Phase 2 (Database Configuration)** and **Phase 3 (Model Layer)** of the Java Spring Boot backend for the MongoDB Sample MFlix application. This backend will provide feature parity with the existing Express.js/TypeScript backend while demonstrating direct MongoDB Java Driver usage.
-
-**Branch:** `java-scaffolding-setup`  
-**Base:** `main`
-
----
-
-## ✅ What's Completed
-
-### Phase 2: Database Configuration and Connection ✅
-
-#### MongoDB Configuration (`MongoConfig.java`)
-- ✅ **Connection pooling** with production-ready settings:
-  - Max pool size: 100 connections
-  - Min pool size: 10 connections
-  - Max connection idle time: 60 seconds
-  - Max wait time: 10 seconds
-- ✅ **Socket timeouts** to prevent hanging connections:
-  - Connect timeout: 10 seconds
-  - Read timeout: 10 seconds
-- ✅ **Server selection timeout**: 10 seconds
-- ✅ **Connection string validation** before attempting connection
-- ✅ **Graceful shutdown** managed by Spring's bean lifecycle
-- ✅ Singleton `MongoClient` and `MongoDatabase` beans
-
-#### Database Verification (`DatabaseVerification.java`)
-- ✅ **Startup verification** via `@PostConstruct`
-- ✅ **Collection verification**: Checks if movies collection exists and contains data
-- ✅ **Text search index creation**: Creates compound text index on `plot`, `title`, and `fullplot` fields
-- ✅ **Background index creation** to avoid blocking operations
-- ✅ **Non-blocking verification**: Application starts even if verification fails
-- ✅ **Comprehensive logging** with helpful error messages and links to MongoDB documentation
-
-### Phase 3: Model Layer Implementation ✅
-
-#### Domain Models (3 classes)
-
-**1. Movie.java** (270 lines)
-- ✅ All fields from TypeScript `Movie` interface
-- ✅ Nested classes:
-  - `Awards` (wins, nominations, text)
-  - `Imdb` (rating, votes, id)
-  - `Tomatoes` (viewer, critic, fresh, rotten, production, lastUpdated)
-    - `Tomatoes.Viewer` (rating, numReviews, meter)
-    - `Tomatoes.Critic` (rating, numReviews, meter)
-- ✅ Lombok annotations for reduced boilerplate
-- ✅ Comprehensive JavaDoc documentation
-
-**2. Theater.java** (103 lines)
-- ✅ All fields from TypeScript `Theater` interface
-- ✅ Nested classes:
-  - `Location` (address, geo)
-    - `Location.Address` (street1, city, state, zipcode)
-    - `Location.Geo` (type, coordinates in GeoJSON format)
-- ✅ GeoJSON format support for geospatial queries
-
-**3. Comment.java** (56 lines)
-- ✅ All fields from TypeScript `Comment` interface
-- ✅ Fields: id, name, email, movieId, text, date
-
-#### DTOs - Data Transfer Objects (3 classes)
-
-**1. CreateMovieRequest.java** (92 lines)
-- ✅ Required field: `title` with `@NotBlank` validation
-- ✅ Optional fields: year, plot, fullplot, genres, directors, writers, cast, countries, languages, rated, runtime, poster
-- ✅ Matches Express backend `CreateMovieRequest` interface
-
-**2. UpdateMovieRequest.java** (89 lines)
-- ✅ All fields optional (for partial updates)
-- ✅ Same fields as `CreateMovieRequest`
-
-**3. MovieSearchQuery.java** (64 lines)
-- ✅ Full-text search: `q` parameter
-- ✅ Filters: genre, year, minRating, maxRating
-- ✅ Pagination: limit, skip
-- ✅ Sorting: sortBy, sortOrder
-
-#### Response Models (3 classes + 1 interface)
-
-**1. ApiResponse Interface** (30 lines)
-- ✅ Common interface for all API responses
-- ✅ Methods: `isSuccess()`, `getTimestamp()`
-
-**2. SuccessResponse<T>** (88 lines)
-- ✅ Generic type parameter for flexible data responses
-- ✅ Fields: success (true), message, data, timestamp, pagination
-- ✅ Nested class: `Pagination` (page, limit, total, pages)
-- ✅ `@JsonInclude(NON_NULL)` to exclude null fields from JSON
-- ✅ Auto-generated timestamp using `Instant.now()`
-
-**3. ErrorResponse** (80 lines)
-- ✅ Fields: success (false), message, error, timestamp
-- ✅ Nested class: `ErrorDetails` (message, code, details)
-- ✅ Matches Express backend error format
-
----
-
-## 📁 Files Changed
-
-### Modified Files (8)
-- `server/java-spring/pom.xml` - Updated dependencies
-- `server/java-spring/.mvn/wrapper/maven-wrapper.properties` - Maven wrapper config
-- `server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java` - **Phase 2**
-- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java` - **Phase 3**
-- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java` - **Phase 3**
-- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java` - **Phase 3**
-- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java` - **Phase 3**
-- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java` - **Phase 3**
-- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java` - **Phase 3**
-
-### New Files (4)
-- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java` - **Phase 3**
-- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java` - **Phase 3**
-- `server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java` - **Phase 3**
-
-### Not Staged (Documentation)
-- `JAVA-SPRING-IMPLEMENTATION-PLAN.md` - Updated with Phase 2 & 3 completion status
-
----
-
-## 🔍 What to Review
-
-### 1. Database Configuration (`config/`)
-**Focus Areas:**
-- [ ] Connection pool settings are appropriate for production use
-- [ ] Timeout values (10s) are reasonable
-- [ ] Error handling in `DatabaseVerification` is robust
-- [ ] Text index creation matches Express backend behavior
-- [ ] Logging messages are helpful and informative
-
-**Questions for Reviewers:**
-- Are the connection pool settings (max 100, min 10) appropriate?
-- Should we add more comprehensive index verification (check if index exists before creating)?
-
-### 2. Domain Models (`model/`)
-**Focus Areas:**
-- [ ] All fields match the TypeScript interfaces from Express backend
-- [ ] Nested class structure is clean and maintainable
-- [ ] Lombok annotations are used appropriately
-- [ ] JavaDoc documentation is comprehensive
-- [ ] Field types are correct (Integer vs int, Date vs Instant, etc.)
-
-**Questions for Reviewers:**
-- Should we use `Instant` instead of `Date` for date fields?
-- Are the nested classes appropriately structured, or should some be top-level classes?
-
-### 3. DTOs (`model/dto/`)
-**Focus Areas:**
-- [ ] Validation annotations are appropriate (`@NotBlank` on title)
-- [ ] All optional fields are correctly marked
-- [ ] DTOs match Express backend request structures
-- [ ] Field naming conventions are consistent
-
-**Questions for Reviewers:**
-- Should we add more validation annotations (e.g., `@Min`, `@Max` for year/rating)?
-- Should `MovieSearchQuery` have default values for limit/skip?
-
-### 4. Response Models (`model/response/`)
-**Focus Areas:**
-- [ ] Generic type usage in `SuccessResponse<T>` is correct
-- [ ] `@JsonInclude(NON_NULL)` behavior is desired
-- [ ] Timestamp format (ISO 8601) matches Express backend
-- [ ] Error response structure matches Express backend
-- [ ] Builder pattern with defaults works as expected
-
-**Questions for Reviewers:**
-- Should we use a custom timestamp format instead of `Instant.now().toString()`?
-- Is the `ErrorDetails` nested class structure appropriate?
-
----
-
-## 🚧 What's NOT in This PR (Pending Work)
-
-### Phase 4: Repository Layer (Next PR)
-- [ ] `MovieRepository` interface
-- [ ] `MovieRepositoryImpl` using `MongoCollection<Document>` directly
-- [ ] Manual BSON Document ↔ Movie object conversion
-- [ ] All CRUD operations: insertOne, insertMany, findById, find, updateOne, updateMany, deleteOne, deleteMany, findOneAndDelete
-
-### Phase 5: Service Layer (Future PR)
-- [ ] `MovieService` with business logic
-- [ ] Request validation
-- [ ] DTO ↔ Domain model conversion
-- [ ] Query building for search/filter operations
-
-### Phase 6: Controller Layer (Future PR)
-- [ ] `MovieController` with REST endpoints
-- [ ] Request/response mapping
-- [ ] Exception handling
-
-### Phase 7-9: Testing, Error Handling, Documentation (Future PRs)
-- [ ] Unit tests
-- [ ] Integration tests
-- [ ] Global exception handler
-- [ ] API documentation (Swagger/OpenAPI)
-- [ ] README updates
-
----
-
-## ✅ Build Verification
-
-```bash
-$ cd server/java-spring && ./mvnw clean compile
-[INFO] BUILD SUCCESS
-[INFO] Compiling 20 source files
-```
-
-All files compile successfully with no errors or warnings.
-
----
-
-## 🎯 Design Decisions
-
-### Why Lombok?
-- **Reduces boilerplate**: No need to write getters, setters, constructors, toString, equals, hashCode
-- **Improves readability**: Focus on business logic, not boilerplate
-- **Maintainability**: Changes to fields automatically update generated methods
-- **Industry standard**: Widely used in Spring Boot projects
-
-### Why Custom Repository (Not Spring Data)?
-- **Educational value**: Demonstrates direct MongoDB Driver usage
-- **Matches Express backend**: Similar to how Node.js driver is used
-- **Full control**: Complete control over BSON document structure and queries
-- **Explicit operations**: Shows exactly what MongoDB operations are being performed
-
-### Why Nested Classes?
-- **Encapsulation**: Nested classes are only used within their parent context
-- **Namespace clarity**: `Movie.Awards` is clearer than a separate `MovieAwards` class
-- **Matches MongoDB structure**: Reflects the nested document structure in MongoDB
-
----
-
-## 📚 References
-
-- **Implementation Plan**: `JAVA-SPRING-IMPLEMENTATION-PLAN.md`
-- **Express Backend**: `server/express/src/` (reference implementation)
-- **MongoDB Java Driver Docs**: https://www.mongodb.com/docs/drivers/java/sync/current/
-- **Spring Boot Docs**: https://docs.spring.io/spring-boot/docs/current/reference/html/
-
----
-
-## 🤔 Questions for Discussion
-
-1. **Date Types**: Should we use `java.time.Instant` instead of `java.util.Date` for better Java 8+ compatibility?
-2. **Validation**: Should we add more comprehensive validation annotations on DTOs?
-3. **Index Management**: Should we check if indexes exist before creating them, or rely on MongoDB's idempotent behavior?
-4. **Error Messages**: Are the error messages and logging levels appropriate?
-5. **Pagination Defaults**: Should `MovieSearchQuery` have default values (e.g., limit=20, skip=0)?
-
----
-
-## 📝 Reviewer Checklist
-
-- [ ] Code compiles without errors
-- [ ] All models match Express backend TypeScript interfaces
-- [ ] Lombok annotations are used appropriately
-- [ ] JavaDoc documentation is comprehensive
-- [ ] Connection pool settings are production-ready
-- [ ] Database verification logic is sound
-- [ ] Response models match Express backend format
-- [ ] Validation annotations are appropriate
-- [ ] No security vulnerabilities introduced
-- [ ] Code follows Java/Spring Boot best practices
-
----
-
-**Ready for Review** ✅
-
-This PR lays the foundation for the Java Spring backend by implementing database configuration and all model classes. The next PR will implement the Repository layer with direct MongoDB Driver usage.
-
diff --git a/client/next-env.d.ts b/client/next-env.d.ts
deleted file mode 100644
index 830fb59..0000000
--- a/client/next-env.d.ts
+++ /dev/null
@@ -1,6 +0,0 @@
-/// <reference types="next" />
-/// <reference types="next/image-types/global" />
-/// <reference path="./.next/types/routes.d.ts" />
-
-// NOTE: This file should not be edited
-// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
diff --git a/client/package-lock.json b/client/package-lock.json
deleted file mode 100644
index 498a11c..0000000
--- a/client/package-lock.json
+++ /dev/null
@@ -1,5007 +0,0 @@
-{
-  "name": "sample-mflix-front-end",
-  "version": "0.1.0",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "": {
-      "name": "sample-mflix-front-end",
-      "version": "0.1.0",
-      "dependencies": {
-        "next": "15.5.5",
-        "react": "19.1.0",
-        "react-dom": "19.1.0"
-      },
-      "devDependencies": {
-        "@eslint/eslintrc": "^3",
-        "@types/node": "^20",
-        "@types/react": "^19",
-        "@types/react-dom": "^19",
-        "eslint": "^9",
-        "eslint-config-next": "15.5.5",
-        "typescript": "^5"
-      }
-    },
-    "node_modules/@emnapi/core": {
-      "version": "1.6.0",
-      "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.6.0.tgz",
-      "integrity": "sha512-zq/ay+9fNIJJtJiZxdTnXS20PllcYMX3OE23ESc4HK/bdYu3cOWYVhsOhVnXALfU/uqJIxn5NBPd9z4v+SfoSg==",
-      "dev": true,
-      "optional": true,
-      "dependencies": {
-        "@emnapi/wasi-threads": "1.1.0",
-        "tslib": "^2.4.0"
-      }
-    },
-    "node_modules/@emnapi/runtime": {
-      "version": "1.6.0",
-      "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.6.0.tgz",
-      "integrity": "sha512-obtUmAHTMjll499P+D9A3axeJFlhdjOWdKUNs/U6QIGT7V5RjcUW1xToAzjvmgTSQhDbYn/NwfTRoJcQ2rNBxA==",
-      "optional": true,
-      "dependencies": {
-        "tslib": "^2.4.0"
-      }
-    },
-    "node_modules/@emnapi/wasi-threads": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.1.0.tgz",
-      "integrity": "sha512-WI0DdZ8xFSbgMjR1sFsKABJ/C5OnRrjT06JXbZKexJGrDuPTzZdDYfFlsgcCXCyf+suG5QU2e/y1Wo2V/OapLQ==",
-      "dev": true,
-      "optional": true,
-      "dependencies": {
-        "tslib": "^2.4.0"
-      }
-    },
-    "node_modules/@eslint-community/eslint-utils": {
-      "version": "4.9.0",
-      "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz",
-      "integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==",
-      "dev": true,
-      "dependencies": {
-        "eslint-visitor-keys": "^3.4.3"
-      },
-      "engines": {
-        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/eslint"
-      },
-      "peerDependencies": {
-        "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0"
-      }
-    },
-    "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": {
-      "version": "3.4.3",
-      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz",
-      "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==",
-      "dev": true,
-      "engines": {
-        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/eslint"
-      }
-    },
-    "node_modules/@eslint-community/regexpp": {
-      "version": "4.12.2",
-      "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz",
-      "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==",
-      "dev": true,
-      "engines": {
-        "node": "^12.0.0 || ^14.0.0 || >=16.0.0"
-      }
-    },
-    "node_modules/@eslint/config-array": {
-      "version": "0.21.1",
-      "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.1.tgz",
-      "integrity": "sha512-aw1gNayWpdI/jSYVgzN5pL0cfzU02GT3NBpeT/DXbx1/1x7ZKxFPd9bwrzygx/qiwIQiJ1sw/zD8qY/kRvlGHA==",
-      "dev": true,
-      "dependencies": {
-        "@eslint/object-schema": "^2.1.7",
-        "debug": "^4.3.1",
-        "minimatch": "^3.1.2"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      }
-    },
-    "node_modules/@eslint/config-helpers": {
-      "version": "0.4.1",
-      "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.1.tgz",
-      "integrity": "sha512-csZAzkNhsgwb0I/UAV6/RGFTbiakPCf0ZrGmrIxQpYvGZ00PhTkSnyKNolphgIvmnJeGw6rcGVEXfTzUnFuEvw==",
-      "dev": true,
-      "dependencies": {
-        "@eslint/core": "^0.16.0"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      }
-    },
-    "node_modules/@eslint/core": {
-      "version": "0.16.0",
-      "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.16.0.tgz",
-      "integrity": "sha512-nmC8/totwobIiFcGkDza3GIKfAw1+hLiYVrh3I1nIomQ8PEr5cxg34jnkmGawul/ep52wGRAcyeDCNtWKSOj4Q==",
-      "dev": true,
-      "dependencies": {
-        "@types/json-schema": "^7.0.15"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      }
-    },
-    "node_modules/@eslint/eslintrc": {
-      "version": "3.3.1",
-      "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.1.tgz",
-      "integrity": "sha512-gtF186CXhIl1p4pJNGZw8Yc6RlshoePRvE0X91oPGb3vZ8pM3qOS9W9NGPat9LziaBV7XrJWGylNQXkGcnM3IQ==",
-      "dev": true,
-      "dependencies": {
-        "ajv": "^6.12.4",
-        "debug": "^4.3.2",
-        "espree": "^10.0.1",
-        "globals": "^14.0.0",
-        "ignore": "^5.2.0",
-        "import-fresh": "^3.2.1",
-        "js-yaml": "^4.1.0",
-        "minimatch": "^3.1.2",
-        "strip-json-comments": "^3.1.1"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/eslint"
-      }
-    },
-    "node_modules/@eslint/js": {
-      "version": "9.38.0",
-      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.38.0.tgz",
-      "integrity": "sha512-UZ1VpFvXf9J06YG9xQBdnzU+kthors6KjhMAl6f4gH4usHyh31rUf2DLGInT8RFYIReYXNSydgPY0V2LuWgl7A==",
-      "dev": true,
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "url": "https://eslint.org/donate"
-      }
-    },
-    "node_modules/@eslint/object-schema": {
-      "version": "2.1.7",
-      "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz",
-      "integrity": "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==",
-      "dev": true,
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      }
-    },
-    "node_modules/@eslint/plugin-kit": {
-      "version": "0.4.0",
-      "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.4.0.tgz",
-      "integrity": "sha512-sB5uyeq+dwCWyPi31B2gQlVlo+j5brPlWx4yZBrEaRo/nhdDE8Xke1gsGgtiBdaBTxuTkceLVuVt/pclrasb0A==",
-      "dev": true,
-      "dependencies": {
-        "@eslint/core": "^0.16.0",
-        "levn": "^0.4.1"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      }
-    },
-    "node_modules/@humanfs/core": {
-      "version": "0.19.1",
-      "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.1.tgz",
-      "integrity": "sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==",
-      "dev": true,
-      "engines": {
-        "node": ">=18.18.0"
-      }
-    },
-    "node_modules/@humanfs/node": {
-      "version": "0.16.7",
-      "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.7.tgz",
-      "integrity": "sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ==",
-      "dev": true,
-      "dependencies": {
-        "@humanfs/core": "^0.19.1",
-        "@humanwhocodes/retry": "^0.4.0"
-      },
-      "engines": {
-        "node": ">=18.18.0"
-      }
-    },
-    "node_modules/@humanwhocodes/module-importer": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz",
-      "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==",
-      "dev": true,
-      "engines": {
-        "node": ">=12.22"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/nzakas"
-      }
-    },
-    "node_modules/@humanwhocodes/retry": {
-      "version": "0.4.3",
-      "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz",
-      "integrity": "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=18.18"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/nzakas"
-      }
-    },
-    "node_modules/@img/colour": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.0.0.tgz",
-      "integrity": "sha512-A5P/LfWGFSl6nsckYtjw9da+19jB8hkJ6ACTGcDfEJ0aE+l2n2El7dsVM7UVHZQ9s2lmYMWlrS21YLy2IR1LUw==",
-      "optional": true,
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@img/sharp-darwin-arm64": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.34.4.tgz",
-      "integrity": "sha512-sitdlPzDVyvmINUdJle3TNHl+AG9QcwiAMsXmccqsCOMZNIdW2/7S26w0LyU8euiLVzFBL3dXPwVCq/ODnf2vA==",
-      "cpu": [
-        "arm64"
-      ],
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      },
-      "optionalDependencies": {
-        "@img/sharp-libvips-darwin-arm64": "1.2.3"
-      }
-    },
-    "node_modules/@img/sharp-darwin-x64": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.34.4.tgz",
-      "integrity": "sha512-rZheupWIoa3+SOdF/IcUe1ah4ZDpKBGWcsPX6MT0lYniH9micvIU7HQkYTfrx5Xi8u+YqwLtxC/3vl8TQN6rMg==",
-      "cpu": [
-        "x64"
-      ],
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      },
-      "optionalDependencies": {
-        "@img/sharp-libvips-darwin-x64": "1.2.3"
-      }
-    },
-    "node_modules/@img/sharp-libvips-darwin-arm64": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.2.3.tgz",
-      "integrity": "sha512-QzWAKo7kpHxbuHqUC28DZ9pIKpSi2ts2OJnoIGI26+HMgq92ZZ4vk8iJd4XsxN+tYfNJxzH6W62X5eTcsBymHw==",
-      "cpu": [
-        "arm64"
-      ],
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      }
-    },
-    "node_modules/@img/sharp-libvips-darwin-x64": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.2.3.tgz",
-      "integrity": "sha512-Ju+g2xn1E2AKO6YBhxjj+ACcsPQRHT0bhpglxcEf+3uyPY+/gL8veniKoo96335ZaPo03bdDXMv0t+BBFAbmRA==",
-      "cpu": [
-        "x64"
-      ],
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      }
-    },
-    "node_modules/@img/sharp-libvips-linux-arm": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.2.3.tgz",
-      "integrity": "sha512-x1uE93lyP6wEwGvgAIV0gP6zmaL/a0tGzJs/BIDDG0zeBhMnuUPm7ptxGhUbcGs4okDJrk4nxgrmxpib9g6HpA==",
-      "cpu": [
-        "arm"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      }
-    },
-    "node_modules/@img/sharp-libvips-linux-arm64": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.2.3.tgz",
-      "integrity": "sha512-I4RxkXU90cpufazhGPyVujYwfIm9Nk1QDEmiIsaPwdnm013F7RIceaCc87kAH+oUB1ezqEvC6ga4m7MSlqsJvQ==",
-      "cpu": [
-        "arm64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      }
-    },
-    "node_modules/@img/sharp-libvips-linux-ppc64": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.2.3.tgz",
-      "integrity": "sha512-Y2T7IsQvJLMCBM+pmPbM3bKT/yYJvVtLJGfCs4Sp95SjvnFIjynbjzsa7dY1fRJX45FTSfDksbTp6AGWudiyCg==",
-      "cpu": [
-        "ppc64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      }
-    },
-    "node_modules/@img/sharp-libvips-linux-s390x": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.2.3.tgz",
-      "integrity": "sha512-RgWrs/gVU7f+K7P+KeHFaBAJlNkD1nIZuVXdQv6S+fNA6syCcoboNjsV2Pou7zNlVdNQoQUpQTk8SWDHUA3y/w==",
-      "cpu": [
-        "s390x"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      }
-    },
-    "node_modules/@img/sharp-libvips-linux-x64": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.2.3.tgz",
-      "integrity": "sha512-3JU7LmR85K6bBiRzSUc/Ff9JBVIFVvq6bomKE0e63UXGeRw2HPVEjoJke1Yx+iU4rL7/7kUjES4dZ/81Qjhyxg==",
-      "cpu": [
-        "x64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      }
-    },
-    "node_modules/@img/sharp-libvips-linuxmusl-arm64": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.2.3.tgz",
-      "integrity": "sha512-F9q83RZ8yaCwENw1GieztSfj5msz7GGykG/BA+MOUefvER69K/ubgFHNeSyUu64amHIYKGDs4sRCMzXVj8sEyw==",
-      "cpu": [
-        "arm64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      }
-    },
-    "node_modules/@img/sharp-libvips-linuxmusl-x64": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.2.3.tgz",
-      "integrity": "sha512-U5PUY5jbc45ANM6tSJpsgqmBF/VsL6LnxJmIf11kB7J5DctHgqm0SkuXzVWtIY90GnJxKnC/JT251TDnk1fu/g==",
-      "cpu": [
-        "x64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      }
-    },
-    "node_modules/@img/sharp-linux-arm": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.34.4.tgz",
-      "integrity": "sha512-Xyam4mlqM0KkTHYVSuc6wXRmM7LGN0P12li03jAnZ3EJWZqj83+hi8Y9UxZUbxsgsK1qOEwg7O0Bc0LjqQVtxA==",
-      "cpu": [
-        "arm"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      },
-      "optionalDependencies": {
-        "@img/sharp-libvips-linux-arm": "1.2.3"
-      }
-    },
-    "node_modules/@img/sharp-linux-arm64": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.34.4.tgz",
-      "integrity": "sha512-YXU1F/mN/Wu786tl72CyJjP/Ngl8mGHN1hST4BGl+hiW5jhCnV2uRVTNOcaYPs73NeT/H8Upm3y9582JVuZHrQ==",
-      "cpu": [
-        "arm64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      },
-      "optionalDependencies": {
-        "@img/sharp-libvips-linux-arm64": "1.2.3"
-      }
-    },
-    "node_modules/@img/sharp-linux-ppc64": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.34.4.tgz",
-      "integrity": "sha512-F4PDtF4Cy8L8hXA2p3TO6s4aDt93v+LKmpcYFLAVdkkD3hSxZzee0rh6/+94FpAynsuMpLX5h+LRsSG3rIciUQ==",
-      "cpu": [
-        "ppc64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      },
-      "optionalDependencies": {
-        "@img/sharp-libvips-linux-ppc64": "1.2.3"
-      }
-    },
-    "node_modules/@img/sharp-linux-s390x": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.34.4.tgz",
-      "integrity": "sha512-qVrZKE9Bsnzy+myf7lFKvng6bQzhNUAYcVORq2P7bDlvmF6u2sCmK2KyEQEBdYk+u3T01pVsPrkj943T1aJAsw==",
-      "cpu": [
-        "s390x"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      },
-      "optionalDependencies": {
-        "@img/sharp-libvips-linux-s390x": "1.2.3"
-      }
-    },
-    "node_modules/@img/sharp-linux-x64": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.34.4.tgz",
-      "integrity": "sha512-ZfGtcp2xS51iG79c6Vhw9CWqQC8l2Ot8dygxoDoIQPTat/Ov3qAa8qpxSrtAEAJW+UjTXc4yxCjNfxm4h6Xm2A==",
-      "cpu": [
-        "x64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      },
-      "optionalDependencies": {
-        "@img/sharp-libvips-linux-x64": "1.2.3"
-      }
-    },
-    "node_modules/@img/sharp-linuxmusl-arm64": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.34.4.tgz",
-      "integrity": "sha512-8hDVvW9eu4yHWnjaOOR8kHVrew1iIX+MUgwxSuH2XyYeNRtLUe4VNioSqbNkB7ZYQJj9rUTT4PyRscyk2PXFKA==",
-      "cpu": [
-        "arm64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      },
-      "optionalDependencies": {
-        "@img/sharp-libvips-linuxmusl-arm64": "1.2.3"
-      }
-    },
-    "node_modules/@img/sharp-linuxmusl-x64": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.34.4.tgz",
-      "integrity": "sha512-lU0aA5L8QTlfKjpDCEFOZsTYGn3AEiO6db8W5aQDxj0nQkVrZWmN3ZP9sYKWJdtq3PWPhUNlqehWyXpYDcI9Sg==",
-      "cpu": [
-        "x64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      },
-      "optionalDependencies": {
-        "@img/sharp-libvips-linuxmusl-x64": "1.2.3"
-      }
-    },
-    "node_modules/@img/sharp-wasm32": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.34.4.tgz",
-      "integrity": "sha512-33QL6ZO/qpRyG7woB/HUALz28WnTMI2W1jgX3Nu2bypqLIKx/QKMILLJzJjI+SIbvXdG9fUnmrxR7vbi1sTBeA==",
-      "cpu": [
-        "wasm32"
-      ],
-      "optional": true,
-      "dependencies": {
-        "@emnapi/runtime": "^1.5.0"
-      },
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      }
-    },
-    "node_modules/@img/sharp-win32-arm64": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.34.4.tgz",
-      "integrity": "sha512-2Q250do/5WXTwxW3zjsEuMSv5sUU4Tq9VThWKlU2EYLm4MB7ZeMwF+SFJutldYODXF6jzc6YEOC+VfX0SZQPqA==",
-      "cpu": [
-        "arm64"
-      ],
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      }
-    },
-    "node_modules/@img/sharp-win32-ia32": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.34.4.tgz",
-      "integrity": "sha512-3ZeLue5V82dT92CNL6rsal6I2weKw1cYu+rGKm8fOCCtJTR2gYeUfY3FqUnIJsMUPIH68oS5jmZ0NiJ508YpEw==",
-      "cpu": [
-        "ia32"
-      ],
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      }
-    },
-    "node_modules/@img/sharp-win32-x64": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.34.4.tgz",
-      "integrity": "sha512-xIyj4wpYs8J18sVN3mSQjwrw7fKUqRw+Z5rnHNCy5fYTxigBz81u5mOMPmFumwjcn8+ld1ppptMBCLic1nz6ig==",
-      "cpu": [
-        "x64"
-      ],
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      }
-    },
-    "node_modules/@napi-rs/wasm-runtime": {
-      "version": "0.2.12",
-      "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-0.2.12.tgz",
-      "integrity": "sha512-ZVWUcfwY4E/yPitQJl481FjFo3K22D6qF0DuFH6Y/nbnE11GY5uguDxZMGXPQ8WQ0128MXQD7TnfHyK4oWoIJQ==",
-      "dev": true,
-      "optional": true,
-      "dependencies": {
-        "@emnapi/core": "^1.4.3",
-        "@emnapi/runtime": "^1.4.3",
-        "@tybys/wasm-util": "^0.10.0"
-      }
-    },
-    "node_modules/@next/env": {
-      "version": "15.5.5",
-      "resolved": "https://registry.npmjs.org/@next/env/-/env-15.5.5.tgz",
-      "integrity": "sha512-2Zhvss36s/yL+YSxD5ZL5dz5pI6ki1OLxYlh6O77VJ68sBnlUrl5YqhBgCy7FkdMsp9RBeGFwpuDCdpJOqdKeQ=="
-    },
-    "node_modules/@next/eslint-plugin-next": {
-      "version": "15.5.5",
-      "resolved": "https://registry.npmjs.org/@next/eslint-plugin-next/-/eslint-plugin-next-15.5.5.tgz",
-      "integrity": "sha512-FMzm412l9oFB8zdRD+K6HQ1VzlS+sNNsdg0MfvTg0i8lfCyTgP/RFxiu/pGJqZ/IQnzn9xSiLkjOVI7Iv4nbdQ==",
-      "dev": true,
-      "dependencies": {
-        "fast-glob": "3.3.1"
-      }
-    },
-    "node_modules/@next/swc-darwin-arm64": {
-      "version": "15.5.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-darwin-arm64/-/swc-darwin-arm64-15.5.5.tgz",
-      "integrity": "sha512-lYExGHuFIHeOxf40mRLWoA84iY2sLELB23BV5FIDHhdJkN1LpRTPc1MDOawgTo5ifbM5dvAwnGuHyNm60G1+jw==",
-      "cpu": [
-        "arm64"
-      ],
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": ">= 10"
-      }
-    },
-    "node_modules/@next/swc-darwin-x64": {
-      "version": "15.5.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-darwin-x64/-/swc-darwin-x64-15.5.5.tgz",
-      "integrity": "sha512-cacs/WQqa96IhqUm+7CY+z/0j9sW6X80KE07v3IAJuv+z0UNvJtKSlT/T1w1SpaQRa9l0wCYYZlRZUhUOvEVmg==",
-      "cpu": [
-        "x64"
-      ],
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": ">= 10"
-      }
-    },
-    "node_modules/@next/swc-linux-arm64-gnu": {
-      "version": "15.5.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-gnu/-/swc-linux-arm64-gnu-15.5.5.tgz",
-      "integrity": "sha512-tLd90SvkRFik6LSfuYjcJEmwqcNEnVYVOyKTacSazya/SLlSwy/VYKsDE4GIzOBd+h3gW+FXqShc2XBavccHCg==",
-      "cpu": [
-        "arm64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">= 10"
-      }
-    },
-    "node_modules/@next/swc-linux-arm64-musl": {
-      "version": "15.5.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-musl/-/swc-linux-arm64-musl-15.5.5.tgz",
-      "integrity": "sha512-ekV76G2R/l3nkvylkfy9jBSYHeB4QcJ7LdDseT6INnn1p51bmDS1eGoSoq+RxfQ7B1wt+Qa0pIl5aqcx0GLpbw==",
-      "cpu": [
-        "arm64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">= 10"
-      }
-    },
-    "node_modules/@next/swc-linux-x64-gnu": {
-      "version": "15.5.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-gnu/-/swc-linux-x64-gnu-15.5.5.tgz",
-      "integrity": "sha512-tI+sBu+3FmWtqlqD4xKJcj3KJtqbniLombKTE7/UWyyoHmOyAo3aZ7QcEHIOgInXOG1nt0rwh0KGmNbvSB0Djg==",
-      "cpu": [
-        "x64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">= 10"
-      }
-    },
-    "node_modules/@next/swc-linux-x64-musl": {
-      "version": "15.5.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-musl/-/swc-linux-x64-musl-15.5.5.tgz",
-      "integrity": "sha512-kDRh+epN/ulroNJLr+toDjN+/JClY5L+OAWjOrrKCI0qcKvTw9GBx7CU/rdA2bgi4WpZN3l0rf/3+b8rduEwrQ==",
-      "cpu": [
-        "x64"
-      ],
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">= 10"
-      }
-    },
-    "node_modules/@next/swc-win32-arm64-msvc": {
-      "version": "15.5.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-win32-arm64-msvc/-/swc-win32-arm64-msvc-15.5.5.tgz",
-      "integrity": "sha512-GDgdNPFFqiKjTrmfw01sMMRWhVN5wOCmFzPloxa7ksDfX6TZt62tAK986f0ZYqWpvDFqeBCLAzmgTURvtQBdgw==",
-      "cpu": [
-        "arm64"
-      ],
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">= 10"
-      }
-    },
-    "node_modules/@next/swc-win32-x64-msvc": {
-      "version": "15.5.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-15.5.5.tgz",
-      "integrity": "sha512-5kE3oRJxc7M8RmcTANP8RGoJkaYlwIiDD92gSwCjJY0+j8w8Sl1lvxgQ3bxfHY2KkHFai9tpy/Qx1saWV8eaJQ==",
-      "cpu": [
-        "x64"
-      ],
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">= 10"
-      }
-    },
-    "node_modules/@nodelib/fs.scandir": {
-      "version": "2.1.5",
-      "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
-      "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==",
-      "dev": true,
-      "dependencies": {
-        "@nodelib/fs.stat": "2.0.5",
-        "run-parallel": "^1.1.9"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/@nodelib/fs.stat": {
-      "version": "2.0.5",
-      "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz",
-      "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==",
-      "dev": true,
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/@nodelib/fs.walk": {
-      "version": "1.2.8",
-      "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz",
-      "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==",
-      "dev": true,
-      "dependencies": {
-        "@nodelib/fs.scandir": "2.1.5",
-        "fastq": "^1.6.0"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/@nolyfill/is-core-module": {
-      "version": "1.0.39",
-      "resolved": "https://registry.npmjs.org/@nolyfill/is-core-module/-/is-core-module-1.0.39.tgz",
-      "integrity": "sha512-nn5ozdjYQpUCZlWGuxcJY/KpxkWQs4DcbMCmKojjyrYDEAGy4Ce19NN4v5MduafTwJlbKc99UA8YhSVqq9yPZA==",
-      "dev": true,
-      "engines": {
-        "node": ">=12.4.0"
-      }
-    },
-    "node_modules/@rtsao/scc": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/@rtsao/scc/-/scc-1.1.0.tgz",
-      "integrity": "sha512-zt6OdqaDoOnJ1ZYsCYGt9YmWzDXl4vQdKTyJev62gFhRGKdx7mcT54V9KIjg+d2wi9EXsPvAPKe7i7WjfVWB8g==",
-      "dev": true
-    },
-    "node_modules/@rushstack/eslint-patch": {
-      "version": "1.14.0",
-      "resolved": "https://registry.npmjs.org/@rushstack/eslint-patch/-/eslint-patch-1.14.0.tgz",
-      "integrity": "sha512-WJFej426qe4RWOm9MMtP4V3CV4AucXolQty+GRgAWLgQXmpCuwzs7hEpxxhSc/znXUSxum9d/P/32MW0FlAAlA==",
-      "dev": true
-    },
-    "node_modules/@swc/helpers": {
-      "version": "0.5.15",
-      "resolved": "https://registry.npmjs.org/@swc/helpers/-/helpers-0.5.15.tgz",
-      "integrity": "sha512-JQ5TuMi45Owi4/BIMAJBoSQoOJu12oOk/gADqlcUL9JEdHB8vyjUSsxqeNXnmXHjYKMi2WcYtezGEEhqUI/E2g==",
-      "dependencies": {
-        "tslib": "^2.8.0"
-      }
-    },
-    "node_modules/@tybys/wasm-util": {
-      "version": "0.10.1",
-      "resolved": "https://registry.npmjs.org/@tybys/wasm-util/-/wasm-util-0.10.1.tgz",
-      "integrity": "sha512-9tTaPJLSiejZKx+Bmog4uSubteqTvFrVrURwkmHixBo0G4seD0zUxp98E1DzUBJxLQ3NPwXrGKDiVjwx/DpPsg==",
-      "dev": true,
-      "optional": true,
-      "dependencies": {
-        "tslib": "^2.4.0"
-      }
-    },
-    "node_modules/@types/estree": {
-      "version": "1.0.8",
-      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
-      "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
-      "dev": true
-    },
-    "node_modules/@types/json-schema": {
-      "version": "7.0.15",
-      "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz",
-      "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==",
-      "dev": true
-    },
-    "node_modules/@types/json5": {
-      "version": "0.0.29",
-      "resolved": "https://registry.npmjs.org/@types/json5/-/json5-0.0.29.tgz",
-      "integrity": "sha512-dRLjCWHYg4oaA77cxO64oO+7JwCwnIzkZPdrrC71jQmQtlhM556pwKo5bUzqvZndkVbeFLIIi+9TC40JNF5hNQ==",
-      "dev": true
-    },
-    "node_modules/@types/node": {
-      "version": "20.19.23",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.23.tgz",
-      "integrity": "sha512-yIdlVVVHXpmqRhtyovZAcSy0MiPcYWGkoO4CGe/+jpP0hmNuihm4XhHbADpK++MsiLHP5MVlv+bcgdF99kSiFQ==",
-      "dev": true,
-      "dependencies": {
-        "undici-types": "~6.21.0"
-      }
-    },
-    "node_modules/@types/react": {
-      "version": "19.2.2",
-      "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.2.tgz",
-      "integrity": "sha512-6mDvHUFSjyT2B2yeNx2nUgMxh9LtOWvkhIU3uePn2I2oyNymUAX1NIsdgviM4CH+JSrp2D2hsMvJOkxY+0wNRA==",
-      "dev": true,
-      "dependencies": {
-        "csstype": "^3.0.2"
-      }
-    },
-    "node_modules/@types/react-dom": {
-      "version": "19.2.2",
-      "resolved": "https://registry.npmjs.org/@types/react-dom/-/react-dom-19.2.2.tgz",
-      "integrity": "sha512-9KQPoO6mZCi7jcIStSnlOWn2nEF3mNmyr3rIAsGnAbQKYbRLyqmeSc39EVgtxXVia+LMT8j3knZLAZAh+xLmrw==",
-      "dev": true,
-      "peerDependencies": {
-        "@types/react": "^19.2.0"
-      }
-    },
-    "node_modules/@typescript-eslint/eslint-plugin": {
-      "version": "8.46.2",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.46.2.tgz",
-      "integrity": "sha512-ZGBMToy857/NIPaaCucIUQgqueOiq7HeAKkhlvqVV4lm089zUFW6ikRySx2v+cAhKeUCPuWVHeimyk6Dw1iY3w==",
-      "dev": true,
-      "dependencies": {
-        "@eslint-community/regexpp": "^4.10.0",
-        "@typescript-eslint/scope-manager": "8.46.2",
-        "@typescript-eslint/type-utils": "8.46.2",
-        "@typescript-eslint/utils": "8.46.2",
-        "@typescript-eslint/visitor-keys": "8.46.2",
-        "graphemer": "^1.4.0",
-        "ignore": "^7.0.0",
-        "natural-compare": "^1.4.0",
-        "ts-api-utils": "^2.1.0"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/typescript-eslint"
-      },
-      "peerDependencies": {
-        "@typescript-eslint/parser": "^8.46.2",
-        "eslint": "^8.57.0 || ^9.0.0",
-        "typescript": ">=4.8.4 <6.0.0"
-      }
-    },
-    "node_modules/@typescript-eslint/eslint-plugin/node_modules/ignore": {
-      "version": "7.0.5",
-      "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.5.tgz",
-      "integrity": "sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==",
-      "dev": true,
-      "engines": {
-        "node": ">= 4"
-      }
-    },
-    "node_modules/@typescript-eslint/parser": {
-      "version": "8.46.2",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.46.2.tgz",
-      "integrity": "sha512-BnOroVl1SgrPLywqxyqdJ4l3S2MsKVLDVxZvjI1Eoe8ev2r3kGDo+PcMihNmDE+6/KjkTubSJnmqGZZjQSBq/g==",
-      "dev": true,
-      "dependencies": {
-        "@typescript-eslint/scope-manager": "8.46.2",
-        "@typescript-eslint/types": "8.46.2",
-        "@typescript-eslint/typescript-estree": "8.46.2",
-        "@typescript-eslint/visitor-keys": "8.46.2",
-        "debug": "^4.3.4"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/typescript-eslint"
-      },
-      "peerDependencies": {
-        "eslint": "^8.57.0 || ^9.0.0",
-        "typescript": ">=4.8.4 <6.0.0"
-      }
-    },
-    "node_modules/@typescript-eslint/project-service": {
-      "version": "8.46.2",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.46.2.tgz",
-      "integrity": "sha512-PULOLZ9iqwI7hXcmL4fVfIsBi6AN9YxRc0frbvmg8f+4hQAjQ5GYNKK0DIArNo+rOKmR/iBYwkpBmnIwin4wBg==",
-      "dev": true,
-      "dependencies": {
-        "@typescript-eslint/tsconfig-utils": "^8.46.2",
-        "@typescript-eslint/types": "^8.46.2",
-        "debug": "^4.3.4"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/typescript-eslint"
-      },
-      "peerDependencies": {
-        "typescript": ">=4.8.4 <6.0.0"
-      }
-    },
-    "node_modules/@typescript-eslint/scope-manager": {
-      "version": "8.46.2",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.46.2.tgz",
-      "integrity": "sha512-LF4b/NmGvdWEHD2H4MsHD8ny6JpiVNDzrSZr3CsckEgCbAGZbYM4Cqxvi9L+WqDMT+51Ozy7lt2M+d0JLEuBqA==",
-      "dev": true,
-      "dependencies": {
-        "@typescript-eslint/types": "8.46.2",
-        "@typescript-eslint/visitor-keys": "8.46.2"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/typescript-eslint"
-      }
-    },
-    "node_modules/@typescript-eslint/tsconfig-utils": {
-      "version": "8.46.2",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.46.2.tgz",
-      "integrity": "sha512-a7QH6fw4S57+F5y2FIxxSDyi5M4UfGF+Jl1bCGd7+L4KsaUY80GsiF/t0UoRFDHAguKlBaACWJRmdrc6Xfkkag==",
-      "dev": true,
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/typescript-eslint"
-      },
-      "peerDependencies": {
-        "typescript": ">=4.8.4 <6.0.0"
-      }
-    },
-    "node_modules/@typescript-eslint/type-utils": {
-      "version": "8.46.2",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.46.2.tgz",
-      "integrity": "sha512-HbPM4LbaAAt/DjxXaG9yiS9brOOz6fabal4uvUmaUYe6l3K1phQDMQKBRUrr06BQkxkvIZVVHttqiybM9nJsLA==",
-      "dev": true,
-      "dependencies": {
-        "@typescript-eslint/types": "8.46.2",
-        "@typescript-eslint/typescript-estree": "8.46.2",
-        "@typescript-eslint/utils": "8.46.2",
-        "debug": "^4.3.4",
-        "ts-api-utils": "^2.1.0"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/typescript-eslint"
-      },
-      "peerDependencies": {
-        "eslint": "^8.57.0 || ^9.0.0",
-        "typescript": ">=4.8.4 <6.0.0"
-      }
-    },
-    "node_modules/@typescript-eslint/types": {
-      "version": "8.46.2",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.46.2.tgz",
-      "integrity": "sha512-lNCWCbq7rpg7qDsQrd3D6NyWYu+gkTENkG5IKYhUIcxSb59SQC/hEQ+MrG4sTgBVghTonNWq42bA/d4yYumldQ==",
-      "dev": true,
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/typescript-eslint"
-      }
-    },
-    "node_modules/@typescript-eslint/typescript-estree": {
-      "version": "8.46.2",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.46.2.tgz",
-      "integrity": "sha512-f7rW7LJ2b7Uh2EiQ+7sza6RDZnajbNbemn54Ob6fRwQbgcIn+GWfyuHDHRYgRoZu1P4AayVScrRW+YfbTvPQoQ==",
-      "dev": true,
-      "dependencies": {
-        "@typescript-eslint/project-service": "8.46.2",
-        "@typescript-eslint/tsconfig-utils": "8.46.2",
-        "@typescript-eslint/types": "8.46.2",
-        "@typescript-eslint/visitor-keys": "8.46.2",
-        "debug": "^4.3.4",
-        "fast-glob": "^3.3.2",
-        "is-glob": "^4.0.3",
-        "minimatch": "^9.0.4",
-        "semver": "^7.6.0",
-        "ts-api-utils": "^2.1.0"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/typescript-eslint"
-      },
-      "peerDependencies": {
-        "typescript": ">=4.8.4 <6.0.0"
-      }
-    },
-    "node_modules/@typescript-eslint/typescript-estree/node_modules/brace-expansion": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz",
-      "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==",
-      "dev": true,
-      "dependencies": {
-        "balanced-match": "^1.0.0"
-      }
-    },
-    "node_modules/@typescript-eslint/typescript-estree/node_modules/fast-glob": {
-      "version": "3.3.3",
-      "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz",
-      "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==",
-      "dev": true,
-      "dependencies": {
-        "@nodelib/fs.stat": "^2.0.2",
-        "@nodelib/fs.walk": "^1.2.3",
-        "glob-parent": "^5.1.2",
-        "merge2": "^1.3.0",
-        "micromatch": "^4.0.8"
-      },
-      "engines": {
-        "node": ">=8.6.0"
-      }
-    },
-    "node_modules/@typescript-eslint/typescript-estree/node_modules/glob-parent": {
-      "version": "5.1.2",
-      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
-      "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
-      "dev": true,
-      "dependencies": {
-        "is-glob": "^4.0.1"
-      },
-      "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/@typescript-eslint/typescript-estree/node_modules/minimatch": {
-      "version": "9.0.5",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz",
-      "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==",
-      "dev": true,
-      "dependencies": {
-        "brace-expansion": "^2.0.1"
-      },
-      "engines": {
-        "node": ">=16 || 14 >=14.17"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/isaacs"
-      }
-    },
-    "node_modules/@typescript-eslint/utils": {
-      "version": "8.46.2",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.46.2.tgz",
-      "integrity": "sha512-sExxzucx0Tud5tE0XqR0lT0psBQvEpnpiul9XbGUB1QwpWJJAps1O/Z7hJxLGiZLBKMCutjTzDgmd1muEhBnVg==",
-      "dev": true,
-      "dependencies": {
-        "@eslint-community/eslint-utils": "^4.7.0",
-        "@typescript-eslint/scope-manager": "8.46.2",
-        "@typescript-eslint/types": "8.46.2",
-        "@typescript-eslint/typescript-estree": "8.46.2"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/typescript-eslint"
-      },
-      "peerDependencies": {
-        "eslint": "^8.57.0 || ^9.0.0",
-        "typescript": ">=4.8.4 <6.0.0"
-      }
-    },
-    "node_modules/@typescript-eslint/visitor-keys": {
-      "version": "8.46.2",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.46.2.tgz",
-      "integrity": "sha512-tUFMXI4gxzzMXt4xpGJEsBsTox0XbNQ1y94EwlD/CuZwFcQP79xfQqMhau9HsRc/J0cAPA/HZt1dZPtGn9V/7w==",
-      "dev": true,
-      "dependencies": {
-        "@typescript-eslint/types": "8.46.2",
-        "eslint-visitor-keys": "^4.2.1"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/typescript-eslint"
-      }
-    },
-    "node_modules/@unrs/resolver-binding-android-arm-eabi": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-android-arm-eabi/-/resolver-binding-android-arm-eabi-1.11.1.tgz",
-      "integrity": "sha512-ppLRUgHVaGRWUx0R0Ut06Mjo9gBaBkg3v/8AxusGLhsIotbBLuRk51rAzqLC8gq6NyyAojEXglNjzf6R948DNw==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "android"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-android-arm64": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-android-arm64/-/resolver-binding-android-arm64-1.11.1.tgz",
-      "integrity": "sha512-lCxkVtb4wp1v+EoN+HjIG9cIIzPkX5OtM03pQYkG+U5O/wL53LC4QbIeazgiKqluGeVEeBlZahHalCaBvU1a2g==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "android"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-darwin-arm64": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-darwin-arm64/-/resolver-binding-darwin-arm64-1.11.1.tgz",
-      "integrity": "sha512-gPVA1UjRu1Y/IsB/dQEsp2V1pm44Of6+LWvbLc9SDk1c2KhhDRDBUkQCYVWe6f26uJb3fOK8saWMgtX8IrMk3g==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "darwin"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-darwin-x64": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-darwin-x64/-/resolver-binding-darwin-x64-1.11.1.tgz",
-      "integrity": "sha512-cFzP7rWKd3lZaCsDze07QX1SC24lO8mPty9vdP+YVa3MGdVgPmFc59317b2ioXtgCMKGiCLxJ4HQs62oz6GfRQ==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "darwin"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-freebsd-x64": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-freebsd-x64/-/resolver-binding-freebsd-x64-1.11.1.tgz",
-      "integrity": "sha512-fqtGgak3zX4DCB6PFpsH5+Kmt/8CIi4Bry4rb1ho6Av2QHTREM+47y282Uqiu3ZRF5IQioJQ5qWRV6jduA+iGw==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "freebsd"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-linux-arm-gnueabihf": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-arm-gnueabihf/-/resolver-binding-linux-arm-gnueabihf-1.11.1.tgz",
-      "integrity": "sha512-u92mvlcYtp9MRKmP+ZvMmtPN34+/3lMHlyMj7wXJDeXxuM0Vgzz0+PPJNsro1m3IZPYChIkn944wW8TYgGKFHw==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-linux-arm-musleabihf": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-arm-musleabihf/-/resolver-binding-linux-arm-musleabihf-1.11.1.tgz",
-      "integrity": "sha512-cINaoY2z7LVCrfHkIcmvj7osTOtm6VVT16b5oQdS4beibX2SYBwgYLmqhBjA1t51CarSaBuX5YNsWLjsqfW5Cw==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-linux-arm64-gnu": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-arm64-gnu/-/resolver-binding-linux-arm64-gnu-1.11.1.tgz",
-      "integrity": "sha512-34gw7PjDGB9JgePJEmhEqBhWvCiiWCuXsL9hYphDF7crW7UgI05gyBAi6MF58uGcMOiOqSJ2ybEeCvHcq0BCmQ==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-linux-arm64-musl": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-arm64-musl/-/resolver-binding-linux-arm64-musl-1.11.1.tgz",
-      "integrity": "sha512-RyMIx6Uf53hhOtJDIamSbTskA99sPHS96wxVE/bJtePJJtpdKGXO1wY90oRdXuYOGOTuqjT8ACccMc4K6QmT3w==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-linux-ppc64-gnu": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-ppc64-gnu/-/resolver-binding-linux-ppc64-gnu-1.11.1.tgz",
-      "integrity": "sha512-D8Vae74A4/a+mZH0FbOkFJL9DSK2R6TFPC9M+jCWYia/q2einCubX10pecpDiTmkJVUH+y8K3BZClycD8nCShA==",
-      "cpu": [
-        "ppc64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-linux-riscv64-gnu": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-riscv64-gnu/-/resolver-binding-linux-riscv64-gnu-1.11.1.tgz",
-      "integrity": "sha512-frxL4OrzOWVVsOc96+V3aqTIQl1O2TjgExV4EKgRY09AJ9leZpEg8Ak9phadbuX0BA4k8U5qtvMSQQGGmaJqcQ==",
-      "cpu": [
-        "riscv64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-linux-riscv64-musl": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-riscv64-musl/-/resolver-binding-linux-riscv64-musl-1.11.1.tgz",
-      "integrity": "sha512-mJ5vuDaIZ+l/acv01sHoXfpnyrNKOk/3aDoEdLO/Xtn9HuZlDD6jKxHlkN8ZhWyLJsRBxfv9GYM2utQ1SChKew==",
-      "cpu": [
-        "riscv64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-linux-s390x-gnu": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-s390x-gnu/-/resolver-binding-linux-s390x-gnu-1.11.1.tgz",
-      "integrity": "sha512-kELo8ebBVtb9sA7rMe1Cph4QHreByhaZ2QEADd9NzIQsYNQpt9UkM9iqr2lhGr5afh885d/cB5QeTXSbZHTYPg==",
-      "cpu": [
-        "s390x"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-linux-x64-gnu": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-x64-gnu/-/resolver-binding-linux-x64-gnu-1.11.1.tgz",
-      "integrity": "sha512-C3ZAHugKgovV5YvAMsxhq0gtXuwESUKc5MhEtjBpLoHPLYM+iuwSj3lflFwK3DPm68660rZ7G8BMcwSro7hD5w==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-linux-x64-musl": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-x64-musl/-/resolver-binding-linux-x64-musl-1.11.1.tgz",
-      "integrity": "sha512-rV0YSoyhK2nZ4vEswT/QwqzqQXw5I6CjoaYMOX0TqBlWhojUf8P94mvI7nuJTeaCkkds3QE4+zS8Ko+GdXuZtA==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-wasm32-wasi": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-wasm32-wasi/-/resolver-binding-wasm32-wasi-1.11.1.tgz",
-      "integrity": "sha512-5u4RkfxJm+Ng7IWgkzi3qrFOvLvQYnPBmjmZQ8+szTK/b31fQCnleNl1GgEt7nIsZRIf5PLhPwT0WM+q45x/UQ==",
-      "cpu": [
-        "wasm32"
-      ],
-      "dev": true,
-      "optional": true,
-      "dependencies": {
-        "@napi-rs/wasm-runtime": "^0.2.11"
-      },
-      "engines": {
-        "node": ">=14.0.0"
-      }
-    },
-    "node_modules/@unrs/resolver-binding-win32-arm64-msvc": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-win32-arm64-msvc/-/resolver-binding-win32-arm64-msvc-1.11.1.tgz",
-      "integrity": "sha512-nRcz5Il4ln0kMhfL8S3hLkxI85BXs3o8EYoattsJNdsX4YUU89iOkVn7g0VHSRxFuVMdM4Q1jEpIId1Ihim/Uw==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "win32"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-win32-ia32-msvc": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-win32-ia32-msvc/-/resolver-binding-win32-ia32-msvc-1.11.1.tgz",
-      "integrity": "sha512-DCEI6t5i1NmAZp6pFonpD5m7i6aFrpofcp4LA2i8IIq60Jyo28hamKBxNrZcyOwVOZkgsRp9O2sXWBWP8MnvIQ==",
-      "cpu": [
-        "ia32"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "win32"
-      ]
-    },
-    "node_modules/@unrs/resolver-binding-win32-x64-msvc": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-win32-x64-msvc/-/resolver-binding-win32-x64-msvc-1.11.1.tgz",
-      "integrity": "sha512-lrW200hZdbfRtztbygyaq/6jP6AKE8qQN2KvPcJ+x7wiD038YtnYtZ82IMNJ69GJibV7bwL3y9FgK+5w/pYt6g==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "win32"
-      ]
-    },
-    "node_modules/acorn": {
-      "version": "8.15.0",
-      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz",
-      "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
-      "dev": true,
-      "bin": {
-        "acorn": "bin/acorn"
-      },
-      "engines": {
-        "node": ">=0.4.0"
-      }
-    },
-    "node_modules/acorn-jsx": {
-      "version": "5.3.2",
-      "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz",
-      "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==",
-      "dev": true,
-      "peerDependencies": {
-        "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0"
-      }
-    },
-    "node_modules/ajv": {
-      "version": "6.12.6",
-      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz",
-      "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==",
-      "dev": true,
-      "dependencies": {
-        "fast-deep-equal": "^3.1.1",
-        "fast-json-stable-stringify": "^2.0.0",
-        "json-schema-traverse": "^0.4.1",
-        "uri-js": "^4.2.2"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/epoberezkin"
-      }
-    },
-    "node_modules/ansi-styles": {
-      "version": "4.3.0",
-      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
-      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
-      "dev": true,
-      "dependencies": {
-        "color-convert": "^2.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
-      }
-    },
-    "node_modules/argparse": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
-      "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
-      "dev": true
-    },
-    "node_modules/aria-query": {
-      "version": "5.3.2",
-      "resolved": "https://registry.npmjs.org/aria-query/-/aria-query-5.3.2.tgz",
-      "integrity": "sha512-COROpnaoap1E2F000S62r6A60uHZnmlvomhfyT2DlTcrY1OrBKn2UhH7qn5wTC9zMvD0AY7csdPSNwKP+7WiQw==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/array-buffer-byte-length": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/array-buffer-byte-length/-/array-buffer-byte-length-1.0.2.tgz",
-      "integrity": "sha512-LHE+8BuR7RYGDKvnrmcuSq3tDcKv9OFEXQt/HpbZhY7V6h0zlUXutnAD82GiFx9rdieCMjkvtcsPqBwgUl1Iiw==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.3",
-        "is-array-buffer": "^3.0.5"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/array-includes": {
-      "version": "3.1.9",
-      "resolved": "https://registry.npmjs.org/array-includes/-/array-includes-3.1.9.tgz",
-      "integrity": "sha512-FmeCCAenzH0KH381SPT5FZmiA/TmpndpcaShhfgEN9eCVjnFBqq3l1xrI42y8+PPLI6hypzou4GXw00WHmPBLQ==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.4",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.24.0",
-        "es-object-atoms": "^1.1.1",
-        "get-intrinsic": "^1.3.0",
-        "is-string": "^1.1.1",
-        "math-intrinsics": "^1.1.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/array.prototype.findlast": {
-      "version": "1.2.5",
-      "resolved": "https://registry.npmjs.org/array.prototype.findlast/-/array.prototype.findlast-1.2.5.tgz",
-      "integrity": "sha512-CVvd6FHg1Z3POpBLxO6E6zr+rSKEQ9L6rZHAaY7lLfhKsWYUBBOuMs0e9o24oopj6H+geRCX0YJ+TJLBK2eHyQ==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.7",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.23.2",
-        "es-errors": "^1.3.0",
-        "es-object-atoms": "^1.0.0",
-        "es-shim-unscopables": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/array.prototype.findlastindex": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/array.prototype.findlastindex/-/array.prototype.findlastindex-1.2.6.tgz",
-      "integrity": "sha512-F/TKATkzseUExPlfvmwQKGITM3DGTK+vkAsCZoDc5daVygbJBnjEUCbgkAvVFsgfXfX4YIqZ/27G3k3tdXrTxQ==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.4",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.23.9",
-        "es-errors": "^1.3.0",
-        "es-object-atoms": "^1.1.1",
-        "es-shim-unscopables": "^1.1.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/array.prototype.flat": {
-      "version": "1.3.3",
-      "resolved": "https://registry.npmjs.org/array.prototype.flat/-/array.prototype.flat-1.3.3.tgz",
-      "integrity": "sha512-rwG/ja1neyLqCuGZ5YYrznA62D4mZXg0i1cIskIUKSiqF3Cje9/wXAls9B9s1Wa2fomMsIv8czB8jZcPmxCXFg==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.23.5",
-        "es-shim-unscopables": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/array.prototype.flatmap": {
-      "version": "1.3.3",
-      "resolved": "https://registry.npmjs.org/array.prototype.flatmap/-/array.prototype.flatmap-1.3.3.tgz",
-      "integrity": "sha512-Y7Wt51eKJSyi80hFrJCePGGNo5ktJCslFuboqJsbf57CCPcm5zztluPlc4/aD8sWsKvlwatezpV4U1efk8kpjg==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.23.5",
-        "es-shim-unscopables": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/array.prototype.tosorted": {
-      "version": "1.1.4",
-      "resolved": "https://registry.npmjs.org/array.prototype.tosorted/-/array.prototype.tosorted-1.1.4.tgz",
-      "integrity": "sha512-p6Fx8B7b7ZhL/gmUsAy0D15WhvDccw3mnGNbZpi3pmeJdxtWsj2jEaI4Y6oo3XiHfzuSgPwKc04MYt6KgvC/wA==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.7",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.23.3",
-        "es-errors": "^1.3.0",
-        "es-shim-unscopables": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/arraybuffer.prototype.slice": {
-      "version": "1.0.4",
-      "resolved": "https://registry.npmjs.org/arraybuffer.prototype.slice/-/arraybuffer.prototype.slice-1.0.4.tgz",
-      "integrity": "sha512-BNoCY6SXXPQ7gF2opIP4GBE+Xw7U+pHMYKuzjgCN3GwiaIR09UUeKfheyIry77QtrCBlC0KK0q5/TER/tYh3PQ==",
-      "dev": true,
-      "dependencies": {
-        "array-buffer-byte-length": "^1.0.1",
-        "call-bind": "^1.0.8",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.23.5",
-        "es-errors": "^1.3.0",
-        "get-intrinsic": "^1.2.6",
-        "is-array-buffer": "^3.0.4"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/ast-types-flow": {
-      "version": "0.0.8",
-      "resolved": "https://registry.npmjs.org/ast-types-flow/-/ast-types-flow-0.0.8.tgz",
-      "integrity": "sha512-OH/2E5Fg20h2aPrbe+QL8JZQFko0YZaF+j4mnQ7BGhfavO7OpSLa8a0y9sBwomHdSbkhTS8TQNayBfnW5DwbvQ==",
-      "dev": true
-    },
-    "node_modules/async-function": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/async-function/-/async-function-1.0.0.tgz",
-      "integrity": "sha512-hsU18Ae8CDTR6Kgu9DYf0EbCr/a5iGL0rytQDobUcdpYOKokk8LEjVphnXkDkgpi0wYVsqrXuP0bZxJaTqdgoA==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/available-typed-arrays": {
-      "version": "1.0.7",
-      "resolved": "https://registry.npmjs.org/available-typed-arrays/-/available-typed-arrays-1.0.7.tgz",
-      "integrity": "sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ==",
-      "dev": true,
-      "dependencies": {
-        "possible-typed-array-names": "^1.0.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/axe-core": {
-      "version": "4.11.0",
-      "resolved": "https://registry.npmjs.org/axe-core/-/axe-core-4.11.0.tgz",
-      "integrity": "sha512-ilYanEU8vxxBexpJd8cWM4ElSQq4QctCLKih0TSfjIfCQTeyH/6zVrmIJfLPrKTKJRbiG+cfnZbQIjAlJmF1jQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=4"
-      }
-    },
-    "node_modules/axobject-query": {
-      "version": "4.1.0",
-      "resolved": "https://registry.npmjs.org/axobject-query/-/axobject-query-4.1.0.tgz",
-      "integrity": "sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/balanced-match": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
-      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
-      "dev": true
-    },
-    "node_modules/brace-expansion": {
-      "version": "1.1.12",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
-      "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
-      "dev": true,
-      "dependencies": {
-        "balanced-match": "^1.0.0",
-        "concat-map": "0.0.1"
-      }
-    },
-    "node_modules/braces": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
-      "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
-      "dev": true,
-      "dependencies": {
-        "fill-range": "^7.1.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/call-bind": {
-      "version": "1.0.8",
-      "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.8.tgz",
-      "integrity": "sha512-oKlSFMcMwpUg2ednkhQ454wfWiU/ul3CkJe/PEHcTKuiX6RpbehUiFMXu13HalGZxfUwCQzZG747YXBn1im9ww==",
-      "dev": true,
-      "dependencies": {
-        "call-bind-apply-helpers": "^1.0.0",
-        "es-define-property": "^1.0.0",
-        "get-intrinsic": "^1.2.4",
-        "set-function-length": "^1.2.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/call-bind-apply-helpers": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
-      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
-      "dev": true,
-      "dependencies": {
-        "es-errors": "^1.3.0",
-        "function-bind": "^1.1.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/call-bound": {
-      "version": "1.0.4",
-      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
-      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
-      "dev": true,
-      "dependencies": {
-        "call-bind-apply-helpers": "^1.0.2",
-        "get-intrinsic": "^1.3.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/callsites": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz",
-      "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/caniuse-lite": {
-      "version": "1.0.30001751",
-      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001751.tgz",
-      "integrity": "sha512-A0QJhug0Ly64Ii3eIqHu5X51ebln3k4yTUkY1j8drqpWHVreg/VLijN48cZ1bYPiqOQuqpkIKnzr/Ul8V+p6Cw==",
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/browserslist"
-        },
-        {
-          "type": "tidelift",
-          "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ]
-    },
-    "node_modules/chalk": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
-      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
-      "dev": true,
-      "dependencies": {
-        "ansi-styles": "^4.1.0",
-        "supports-color": "^7.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
-    "node_modules/client-only": {
-      "version": "0.0.1",
-      "resolved": "https://registry.npmjs.org/client-only/-/client-only-0.0.1.tgz",
-      "integrity": "sha512-IV3Ou0jSMzZrd3pZ48nLkT9DA7Ag1pnPzaiQhpW7c3RbcqqzvzzVu+L8gfqMp/8IM2MQtSiqaCxrrcfu8I8rMA=="
-    },
-    "node_modules/color-convert": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
-      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
-      "dev": true,
-      "dependencies": {
-        "color-name": "~1.1.4"
-      },
-      "engines": {
-        "node": ">=7.0.0"
-      }
-    },
-    "node_modules/color-name": {
-      "version": "1.1.4",
-      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
-      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
-      "dev": true
-    },
-    "node_modules/concat-map": {
-      "version": "0.0.1",
-      "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
-      "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
-      "dev": true
-    },
-    "node_modules/cross-spawn": {
-      "version": "7.0.6",
-      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
-      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
-      "dev": true,
-      "dependencies": {
-        "path-key": "^3.1.0",
-        "shebang-command": "^2.0.0",
-        "which": "^2.0.1"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/csstype": {
-      "version": "3.1.3",
-      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.1.3.tgz",
-      "integrity": "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw==",
-      "dev": true
-    },
-    "node_modules/damerau-levenshtein": {
-      "version": "1.0.8",
-      "resolved": "https://registry.npmjs.org/damerau-levenshtein/-/damerau-levenshtein-1.0.8.tgz",
-      "integrity": "sha512-sdQSFB7+llfUcQHUQO3+B8ERRj0Oa4w9POWMI/puGtuf7gFywGmkaLCElnudfTiKZV+NvHqL0ifzdrI8Ro7ESA==",
-      "dev": true
-    },
-    "node_modules/data-view-buffer": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/data-view-buffer/-/data-view-buffer-1.0.2.tgz",
-      "integrity": "sha512-EmKO5V3OLXh1rtK2wgXRansaK1/mtVdTUEiEI0W8RkvgT05kfxaH29PliLnpLP73yYO6142Q72QNa8Wx/A5CqQ==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.3",
-        "es-errors": "^1.3.0",
-        "is-data-view": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/data-view-byte-length": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/data-view-byte-length/-/data-view-byte-length-1.0.2.tgz",
-      "integrity": "sha512-tuhGbE6CfTM9+5ANGf+oQb72Ky/0+s3xKUpHvShfiz2RxMFgFPjsXuRLBVMtvMs15awe45SRb83D6wH4ew6wlQ==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.3",
-        "es-errors": "^1.3.0",
-        "is-data-view": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/inspect-js"
-      }
-    },
-    "node_modules/data-view-byte-offset": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/data-view-byte-offset/-/data-view-byte-offset-1.0.1.tgz",
-      "integrity": "sha512-BS8PfmtDGnrgYdOonGZQdLZslWIeCGFP9tpan0hi1Co2Zr2NKADsvGYA8XxuG/4UWgJ6Cjtv+YJnB6MM69QGlQ==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.2",
-        "es-errors": "^1.3.0",
-        "is-data-view": "^1.0.1"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/debug": {
-      "version": "4.4.3",
-      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
-      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
-      "dev": true,
-      "dependencies": {
-        "ms": "^2.1.3"
-      },
-      "engines": {
-        "node": ">=6.0"
-      },
-      "peerDependenciesMeta": {
-        "supports-color": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/deep-is": {
-      "version": "0.1.4",
-      "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz",
-      "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==",
-      "dev": true
-    },
-    "node_modules/define-data-property": {
-      "version": "1.1.4",
-      "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz",
-      "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==",
-      "dev": true,
-      "dependencies": {
-        "es-define-property": "^1.0.0",
-        "es-errors": "^1.3.0",
-        "gopd": "^1.0.1"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/define-properties": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.2.1.tgz",
-      "integrity": "sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==",
-      "dev": true,
-      "dependencies": {
-        "define-data-property": "^1.0.1",
-        "has-property-descriptors": "^1.0.0",
-        "object-keys": "^1.1.1"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/detect-libc": {
-      "version": "2.1.2",
-      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
-      "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
-      "optional": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/doctrine": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-2.1.0.tgz",
-      "integrity": "sha512-35mSku4ZXK0vfCuHEDAwt55dg2jNajHZ1odvF+8SSr82EsZY4QmXfuWso8oEd8zRhVObSN18aM0CjSdoBX7zIw==",
-      "dev": true,
-      "dependencies": {
-        "esutils": "^2.0.2"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/dunder-proto": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
-      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
-      "dev": true,
-      "dependencies": {
-        "call-bind-apply-helpers": "^1.0.1",
-        "es-errors": "^1.3.0",
-        "gopd": "^1.2.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/emoji-regex": {
-      "version": "9.2.2",
-      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
-      "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
-      "dev": true
-    },
-    "node_modules/es-abstract": {
-      "version": "1.24.0",
-      "resolved": "https://registry.npmjs.org/es-abstract/-/es-abstract-1.24.0.tgz",
-      "integrity": "sha512-WSzPgsdLtTcQwm4CROfS5ju2Wa1QQcVeT37jFjYzdFz1r9ahadC8B8/a4qxJxM+09F18iumCdRmlr96ZYkQvEg==",
-      "dev": true,
-      "dependencies": {
-        "array-buffer-byte-length": "^1.0.2",
-        "arraybuffer.prototype.slice": "^1.0.4",
-        "available-typed-arrays": "^1.0.7",
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.4",
-        "data-view-buffer": "^1.0.2",
-        "data-view-byte-length": "^1.0.2",
-        "data-view-byte-offset": "^1.0.1",
-        "es-define-property": "^1.0.1",
-        "es-errors": "^1.3.0",
-        "es-object-atoms": "^1.1.1",
-        "es-set-tostringtag": "^2.1.0",
-        "es-to-primitive": "^1.3.0",
-        "function.prototype.name": "^1.1.8",
-        "get-intrinsic": "^1.3.0",
-        "get-proto": "^1.0.1",
-        "get-symbol-description": "^1.1.0",
-        "globalthis": "^1.0.4",
-        "gopd": "^1.2.0",
-        "has-property-descriptors": "^1.0.2",
-        "has-proto": "^1.2.0",
-        "has-symbols": "^1.1.0",
-        "hasown": "^2.0.2",
-        "internal-slot": "^1.1.0",
-        "is-array-buffer": "^3.0.5",
-        "is-callable": "^1.2.7",
-        "is-data-view": "^1.0.2",
-        "is-negative-zero": "^2.0.3",
-        "is-regex": "^1.2.1",
-        "is-set": "^2.0.3",
-        "is-shared-array-buffer": "^1.0.4",
-        "is-string": "^1.1.1",
-        "is-typed-array": "^1.1.15",
-        "is-weakref": "^1.1.1",
-        "math-intrinsics": "^1.1.0",
-        "object-inspect": "^1.13.4",
-        "object-keys": "^1.1.1",
-        "object.assign": "^4.1.7",
-        "own-keys": "^1.0.1",
-        "regexp.prototype.flags": "^1.5.4",
-        "safe-array-concat": "^1.1.3",
-        "safe-push-apply": "^1.0.0",
-        "safe-regex-test": "^1.1.0",
-        "set-proto": "^1.0.0",
-        "stop-iteration-iterator": "^1.1.0",
-        "string.prototype.trim": "^1.2.10",
-        "string.prototype.trimend": "^1.0.9",
-        "string.prototype.trimstart": "^1.0.8",
-        "typed-array-buffer": "^1.0.3",
-        "typed-array-byte-length": "^1.0.3",
-        "typed-array-byte-offset": "^1.0.4",
-        "typed-array-length": "^1.0.7",
-        "unbox-primitive": "^1.1.0",
-        "which-typed-array": "^1.1.19"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/es-define-property": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
-      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/es-errors": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
-      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/es-iterator-helpers": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/es-iterator-helpers/-/es-iterator-helpers-1.2.1.tgz",
-      "integrity": "sha512-uDn+FE1yrDzyC0pCo961B2IHbdM8y/ACZsKD4dG6WqrjV53BADjwa7D+1aom2rsNVfLyDgU/eigvlJGJ08OQ4w==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.3",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.23.6",
-        "es-errors": "^1.3.0",
-        "es-set-tostringtag": "^2.0.3",
-        "function-bind": "^1.1.2",
-        "get-intrinsic": "^1.2.6",
-        "globalthis": "^1.0.4",
-        "gopd": "^1.2.0",
-        "has-property-descriptors": "^1.0.2",
-        "has-proto": "^1.2.0",
-        "has-symbols": "^1.1.0",
-        "internal-slot": "^1.1.0",
-        "iterator.prototype": "^1.1.4",
-        "safe-array-concat": "^1.1.3"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/es-object-atoms": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
-      "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
-      "dev": true,
-      "dependencies": {
-        "es-errors": "^1.3.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/es-set-tostringtag": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
-      "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
-      "dev": true,
-      "dependencies": {
-        "es-errors": "^1.3.0",
-        "get-intrinsic": "^1.2.6",
-        "has-tostringtag": "^1.0.2",
-        "hasown": "^2.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/es-shim-unscopables": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/es-shim-unscopables/-/es-shim-unscopables-1.1.0.tgz",
-      "integrity": "sha512-d9T8ucsEhh8Bi1woXCf+TIKDIROLG5WCkxg8geBCbvk22kzwC5G2OnXVMO6FUsvQlgUUXQ2itephWDLqDzbeCw==",
-      "dev": true,
-      "dependencies": {
-        "hasown": "^2.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/es-to-primitive": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/es-to-primitive/-/es-to-primitive-1.3.0.tgz",
-      "integrity": "sha512-w+5mJ3GuFL+NjVtJlvydShqE1eN3h3PbI7/5LAsYJP/2qtuMXjfL2LpHSRqo4b4eSF5K/DH1JXKUAHSB2UW50g==",
-      "dev": true,
-      "dependencies": {
-        "is-callable": "^1.2.7",
-        "is-date-object": "^1.0.5",
-        "is-symbol": "^1.0.4"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/escape-string-regexp": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
-      "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==",
-      "dev": true,
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/eslint": {
-      "version": "9.38.0",
-      "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.38.0.tgz",
-      "integrity": "sha512-t5aPOpmtJcZcz5UJyY2GbvpDlsK5E8JqRqoKtfiKE3cNh437KIqfJr3A3AKf5k64NPx6d0G3dno6XDY05PqPtw==",
-      "dev": true,
-      "dependencies": {
-        "@eslint-community/eslint-utils": "^4.8.0",
-        "@eslint-community/regexpp": "^4.12.1",
-        "@eslint/config-array": "^0.21.1",
-        "@eslint/config-helpers": "^0.4.1",
-        "@eslint/core": "^0.16.0",
-        "@eslint/eslintrc": "^3.3.1",
-        "@eslint/js": "9.38.0",
-        "@eslint/plugin-kit": "^0.4.0",
-        "@humanfs/node": "^0.16.6",
-        "@humanwhocodes/module-importer": "^1.0.1",
-        "@humanwhocodes/retry": "^0.4.2",
-        "@types/estree": "^1.0.6",
-        "ajv": "^6.12.4",
-        "chalk": "^4.0.0",
-        "cross-spawn": "^7.0.6",
-        "debug": "^4.3.2",
-        "escape-string-regexp": "^4.0.0",
-        "eslint-scope": "^8.4.0",
-        "eslint-visitor-keys": "^4.2.1",
-        "espree": "^10.4.0",
-        "esquery": "^1.5.0",
-        "esutils": "^2.0.2",
-        "fast-deep-equal": "^3.1.3",
-        "file-entry-cache": "^8.0.0",
-        "find-up": "^5.0.0",
-        "glob-parent": "^6.0.2",
-        "ignore": "^5.2.0",
-        "imurmurhash": "^0.1.4",
-        "is-glob": "^4.0.0",
-        "json-stable-stringify-without-jsonify": "^1.0.1",
-        "lodash.merge": "^4.6.2",
-        "minimatch": "^3.1.2",
-        "natural-compare": "^1.4.0",
-        "optionator": "^0.9.3"
-      },
-      "bin": {
-        "eslint": "bin/eslint.js"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "url": "https://eslint.org/donate"
-      },
-      "peerDependencies": {
-        "jiti": "*"
-      },
-      "peerDependenciesMeta": {
-        "jiti": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/eslint-config-next": {
-      "version": "15.5.5",
-      "resolved": "https://registry.npmjs.org/eslint-config-next/-/eslint-config-next-15.5.5.tgz",
-      "integrity": "sha512-f8lRSSelp6cqrYjxEMjJ5En3WV913gTu/w9goYShnIujwDSQlKt4x9MwSDiduE9R5mmFETK44+qlQDxeSA0rUA==",
-      "dev": true,
-      "dependencies": {
-        "@next/eslint-plugin-next": "15.5.5",
-        "@rushstack/eslint-patch": "^1.10.3",
-        "@typescript-eslint/eslint-plugin": "^5.4.2 || ^6.0.0 || ^7.0.0 || ^8.0.0",
-        "@typescript-eslint/parser": "^5.4.2 || ^6.0.0 || ^7.0.0 || ^8.0.0",
-        "eslint-import-resolver-node": "^0.3.6",
-        "eslint-import-resolver-typescript": "^3.5.2",
-        "eslint-plugin-import": "^2.31.0",
-        "eslint-plugin-jsx-a11y": "^6.10.0",
-        "eslint-plugin-react": "^7.37.0",
-        "eslint-plugin-react-hooks": "^5.0.0"
-      },
-      "peerDependencies": {
-        "eslint": "^7.23.0 || ^8.0.0 || ^9.0.0",
-        "typescript": ">=3.3.1"
-      },
-      "peerDependenciesMeta": {
-        "typescript": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/eslint-import-resolver-node": {
-      "version": "0.3.9",
-      "resolved": "https://registry.npmjs.org/eslint-import-resolver-node/-/eslint-import-resolver-node-0.3.9.tgz",
-      "integrity": "sha512-WFj2isz22JahUv+B788TlO3N6zL3nNJGU8CcZbPZvVEkBPaJdCV4vy5wyghty5ROFbCRnm132v8BScu5/1BQ8g==",
-      "dev": true,
-      "dependencies": {
-        "debug": "^3.2.7",
-        "is-core-module": "^2.13.0",
-        "resolve": "^1.22.4"
-      }
-    },
-    "node_modules/eslint-import-resolver-node/node_modules/debug": {
-      "version": "3.2.7",
-      "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz",
-      "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==",
-      "dev": true,
-      "dependencies": {
-        "ms": "^2.1.1"
-      }
-    },
-    "node_modules/eslint-import-resolver-typescript": {
-      "version": "3.10.1",
-      "resolved": "https://registry.npmjs.org/eslint-import-resolver-typescript/-/eslint-import-resolver-typescript-3.10.1.tgz",
-      "integrity": "sha512-A1rHYb06zjMGAxdLSkN2fXPBwuSaQ0iO5M/hdyS0Ajj1VBaRp0sPD3dn1FhME3c/JluGFbwSxyCfqdSbtQLAHQ==",
-      "dev": true,
-      "dependencies": {
-        "@nolyfill/is-core-module": "1.0.39",
-        "debug": "^4.4.0",
-        "get-tsconfig": "^4.10.0",
-        "is-bun-module": "^2.0.0",
-        "stable-hash": "^0.0.5",
-        "tinyglobby": "^0.2.13",
-        "unrs-resolver": "^1.6.2"
-      },
-      "engines": {
-        "node": "^14.18.0 || >=16.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/eslint-import-resolver-typescript"
-      },
-      "peerDependencies": {
-        "eslint": "*",
-        "eslint-plugin-import": "*",
-        "eslint-plugin-import-x": "*"
-      },
-      "peerDependenciesMeta": {
-        "eslint-plugin-import": {
-          "optional": true
-        },
-        "eslint-plugin-import-x": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/eslint-module-utils": {
-      "version": "2.12.1",
-      "resolved": "https://registry.npmjs.org/eslint-module-utils/-/eslint-module-utils-2.12.1.tgz",
-      "integrity": "sha512-L8jSWTze7K2mTg0vos/RuLRS5soomksDPoJLXIslC7c8Wmut3bx7CPpJijDcBZtxQ5lrbUdM+s0OlNbz0DCDNw==",
-      "dev": true,
-      "dependencies": {
-        "debug": "^3.2.7"
-      },
-      "engines": {
-        "node": ">=4"
-      },
-      "peerDependenciesMeta": {
-        "eslint": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/eslint-module-utils/node_modules/debug": {
-      "version": "3.2.7",
-      "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz",
-      "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==",
-      "dev": true,
-      "dependencies": {
-        "ms": "^2.1.1"
-      }
-    },
-    "node_modules/eslint-plugin-import": {
-      "version": "2.32.0",
-      "resolved": "https://registry.npmjs.org/eslint-plugin-import/-/eslint-plugin-import-2.32.0.tgz",
-      "integrity": "sha512-whOE1HFo/qJDyX4SnXzP4N6zOWn79WhnCUY/iDR0mPfQZO8wcYE4JClzI2oZrhBnnMUCBCHZhO6VQyoBU95mZA==",
-      "dev": true,
-      "dependencies": {
-        "@rtsao/scc": "^1.1.0",
-        "array-includes": "^3.1.9",
-        "array.prototype.findlastindex": "^1.2.6",
-        "array.prototype.flat": "^1.3.3",
-        "array.prototype.flatmap": "^1.3.3",
-        "debug": "^3.2.7",
-        "doctrine": "^2.1.0",
-        "eslint-import-resolver-node": "^0.3.9",
-        "eslint-module-utils": "^2.12.1",
-        "hasown": "^2.0.2",
-        "is-core-module": "^2.16.1",
-        "is-glob": "^4.0.3",
-        "minimatch": "^3.1.2",
-        "object.fromentries": "^2.0.8",
-        "object.groupby": "^1.0.3",
-        "object.values": "^1.2.1",
-        "semver": "^6.3.1",
-        "string.prototype.trimend": "^1.0.9",
-        "tsconfig-paths": "^3.15.0"
-      },
-      "engines": {
-        "node": ">=4"
-      },
-      "peerDependencies": {
-        "eslint": "^2 || ^3 || ^4 || ^5 || ^6 || ^7.2.0 || ^8 || ^9"
-      }
-    },
-    "node_modules/eslint-plugin-import/node_modules/debug": {
-      "version": "3.2.7",
-      "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz",
-      "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==",
-      "dev": true,
-      "dependencies": {
-        "ms": "^2.1.1"
-      }
-    },
-    "node_modules/eslint-plugin-import/node_modules/semver": {
-      "version": "6.3.1",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-      "dev": true,
-      "bin": {
-        "semver": "bin/semver.js"
-      }
-    },
-    "node_modules/eslint-plugin-jsx-a11y": {
-      "version": "6.10.2",
-      "resolved": "https://registry.npmjs.org/eslint-plugin-jsx-a11y/-/eslint-plugin-jsx-a11y-6.10.2.tgz",
-      "integrity": "sha512-scB3nz4WmG75pV8+3eRUQOHZlNSUhFNq37xnpgRkCCELU3XMvXAxLk1eqWWyE22Ki4Q01Fnsw9BA3cJHDPgn2Q==",
-      "dev": true,
-      "dependencies": {
-        "aria-query": "^5.3.2",
-        "array-includes": "^3.1.8",
-        "array.prototype.flatmap": "^1.3.2",
-        "ast-types-flow": "^0.0.8",
-        "axe-core": "^4.10.0",
-        "axobject-query": "^4.1.0",
-        "damerau-levenshtein": "^1.0.8",
-        "emoji-regex": "^9.2.2",
-        "hasown": "^2.0.2",
-        "jsx-ast-utils": "^3.3.5",
-        "language-tags": "^1.0.9",
-        "minimatch": "^3.1.2",
-        "object.fromentries": "^2.0.8",
-        "safe-regex-test": "^1.0.3",
-        "string.prototype.includes": "^2.0.1"
-      },
-      "engines": {
-        "node": ">=4.0"
-      },
-      "peerDependencies": {
-        "eslint": "^3 || ^4 || ^5 || ^6 || ^7 || ^8 || ^9"
-      }
-    },
-    "node_modules/eslint-plugin-react": {
-      "version": "7.37.5",
-      "resolved": "https://registry.npmjs.org/eslint-plugin-react/-/eslint-plugin-react-7.37.5.tgz",
-      "integrity": "sha512-Qteup0SqU15kdocexFNAJMvCJEfa2xUKNV4CC1xsVMrIIqEy3SQ/rqyxCWNzfrd3/ldy6HMlD2e0JDVpDg2qIA==",
-      "dev": true,
-      "dependencies": {
-        "array-includes": "^3.1.8",
-        "array.prototype.findlast": "^1.2.5",
-        "array.prototype.flatmap": "^1.3.3",
-        "array.prototype.tosorted": "^1.1.4",
-        "doctrine": "^2.1.0",
-        "es-iterator-helpers": "^1.2.1",
-        "estraverse": "^5.3.0",
-        "hasown": "^2.0.2",
-        "jsx-ast-utils": "^2.4.1 || ^3.0.0",
-        "minimatch": "^3.1.2",
-        "object.entries": "^1.1.9",
-        "object.fromentries": "^2.0.8",
-        "object.values": "^1.2.1",
-        "prop-types": "^15.8.1",
-        "resolve": "^2.0.0-next.5",
-        "semver": "^6.3.1",
-        "string.prototype.matchall": "^4.0.12",
-        "string.prototype.repeat": "^1.0.0"
-      },
-      "engines": {
-        "node": ">=4"
-      },
-      "peerDependencies": {
-        "eslint": "^3 || ^4 || ^5 || ^6 || ^7 || ^8 || ^9.7"
-      }
-    },
-    "node_modules/eslint-plugin-react-hooks": {
-      "version": "5.2.0",
-      "resolved": "https://registry.npmjs.org/eslint-plugin-react-hooks/-/eslint-plugin-react-hooks-5.2.0.tgz",
-      "integrity": "sha512-+f15FfK64YQwZdJNELETdn5ibXEUQmW1DZL6KXhNnc2heoy/sg9VJJeT7n8TlMWouzWqSWavFkIhHyIbIAEapg==",
-      "dev": true,
-      "engines": {
-        "node": ">=10"
-      },
-      "peerDependencies": {
-        "eslint": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0-0 || ^9.0.0"
-      }
-    },
-    "node_modules/eslint-plugin-react/node_modules/resolve": {
-      "version": "2.0.0-next.5",
-      "resolved": "https://registry.npmjs.org/resolve/-/resolve-2.0.0-next.5.tgz",
-      "integrity": "sha512-U7WjGVG9sH8tvjW5SmGbQuui75FiyjAX72HX15DwBBwF9dNiQZRQAg9nnPhYy+TUnE0+VcrttuvNI8oSxZcocA==",
-      "dev": true,
-      "dependencies": {
-        "is-core-module": "^2.13.0",
-        "path-parse": "^1.0.7",
-        "supports-preserve-symlinks-flag": "^1.0.0"
-      },
-      "bin": {
-        "resolve": "bin/resolve"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/eslint-plugin-react/node_modules/semver": {
-      "version": "6.3.1",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-      "dev": true,
-      "bin": {
-        "semver": "bin/semver.js"
-      }
-    },
-    "node_modules/eslint-scope": {
-      "version": "8.4.0",
-      "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.4.0.tgz",
-      "integrity": "sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==",
-      "dev": true,
-      "dependencies": {
-        "esrecurse": "^4.3.0",
-        "estraverse": "^5.2.0"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/eslint"
-      }
-    },
-    "node_modules/eslint-visitor-keys": {
-      "version": "4.2.1",
-      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz",
-      "integrity": "sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==",
-      "dev": true,
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/eslint"
-      }
-    },
-    "node_modules/espree": {
-      "version": "10.4.0",
-      "resolved": "https://registry.npmjs.org/espree/-/espree-10.4.0.tgz",
-      "integrity": "sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==",
-      "dev": true,
-      "dependencies": {
-        "acorn": "^8.15.0",
-        "acorn-jsx": "^5.3.2",
-        "eslint-visitor-keys": "^4.2.1"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/eslint"
-      }
-    },
-    "node_modules/esquery": {
-      "version": "1.6.0",
-      "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz",
-      "integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==",
-      "dev": true,
-      "dependencies": {
-        "estraverse": "^5.1.0"
-      },
-      "engines": {
-        "node": ">=0.10"
-      }
-    },
-    "node_modules/esrecurse": {
-      "version": "4.3.0",
-      "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz",
-      "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==",
-      "dev": true,
-      "dependencies": {
-        "estraverse": "^5.2.0"
-      },
-      "engines": {
-        "node": ">=4.0"
-      }
-    },
-    "node_modules/estraverse": {
-      "version": "5.3.0",
-      "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz",
-      "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==",
-      "dev": true,
-      "engines": {
-        "node": ">=4.0"
-      }
-    },
-    "node_modules/esutils": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz",
-      "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/fast-deep-equal": {
-      "version": "3.1.3",
-      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
-      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
-      "dev": true
-    },
-    "node_modules/fast-glob": {
-      "version": "3.3.1",
-      "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.1.tgz",
-      "integrity": "sha512-kNFPyjhh5cKjrUltxs+wFx+ZkbRaxxmZ+X0ZU31SOsxCEtP9VPgtq2teZw1DebupL5GmDaNQ6yKMMVcM41iqDg==",
-      "dev": true,
-      "dependencies": {
-        "@nodelib/fs.stat": "^2.0.2",
-        "@nodelib/fs.walk": "^1.2.3",
-        "glob-parent": "^5.1.2",
-        "merge2": "^1.3.0",
-        "micromatch": "^4.0.4"
-      },
-      "engines": {
-        "node": ">=8.6.0"
-      }
-    },
-    "node_modules/fast-glob/node_modules/glob-parent": {
-      "version": "5.1.2",
-      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
-      "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
-      "dev": true,
-      "dependencies": {
-        "is-glob": "^4.0.1"
-      },
-      "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/fast-json-stable-stringify": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",
-      "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==",
-      "dev": true
-    },
-    "node_modules/fast-levenshtein": {
-      "version": "2.0.6",
-      "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz",
-      "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==",
-      "dev": true
-    },
-    "node_modules/fastq": {
-      "version": "1.19.1",
-      "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.19.1.tgz",
-      "integrity": "sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==",
-      "dev": true,
-      "dependencies": {
-        "reusify": "^1.0.4"
-      }
-    },
-    "node_modules/file-entry-cache": {
-      "version": "8.0.0",
-      "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz",
-      "integrity": "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==",
-      "dev": true,
-      "dependencies": {
-        "flat-cache": "^4.0.0"
-      },
-      "engines": {
-        "node": ">=16.0.0"
-      }
-    },
-    "node_modules/fill-range": {
-      "version": "7.1.1",
-      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
-      "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
-      "dev": true,
-      "dependencies": {
-        "to-regex-range": "^5.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/find-up": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz",
-      "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==",
-      "dev": true,
-      "dependencies": {
-        "locate-path": "^6.0.0",
-        "path-exists": "^4.0.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/flat-cache": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz",
-      "integrity": "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==",
-      "dev": true,
-      "dependencies": {
-        "flatted": "^3.2.9",
-        "keyv": "^4.5.4"
-      },
-      "engines": {
-        "node": ">=16"
-      }
-    },
-    "node_modules/flatted": {
-      "version": "3.3.3",
-      "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz",
-      "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==",
-      "dev": true
-    },
-    "node_modules/for-each": {
-      "version": "0.3.5",
-      "resolved": "https://registry.npmjs.org/for-each/-/for-each-0.3.5.tgz",
-      "integrity": "sha512-dKx12eRCVIzqCxFGplyFKJMPvLEWgmNtUrpTiJIR5u97zEhRG8ySrtboPHZXx7daLxQVrl643cTzbab2tkQjxg==",
-      "dev": true,
-      "dependencies": {
-        "is-callable": "^1.2.7"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/function-bind": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
-      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
-      "dev": true,
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/function.prototype.name": {
-      "version": "1.1.8",
-      "resolved": "https://registry.npmjs.org/function.prototype.name/-/function.prototype.name-1.1.8.tgz",
-      "integrity": "sha512-e5iwyodOHhbMr/yNrc7fDYG4qlbIvI5gajyzPnb5TCwyhjApznQh1BMFou9b30SevY43gCJKXycoCBjMbsuW0Q==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.3",
-        "define-properties": "^1.2.1",
-        "functions-have-names": "^1.2.3",
-        "hasown": "^2.0.2",
-        "is-callable": "^1.2.7"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/functions-have-names": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/functions-have-names/-/functions-have-names-1.2.3.tgz",
-      "integrity": "sha512-xckBUXyTIqT97tq2x2AMb+g163b5JFysYk0x4qxNFwbfQkmNZoiRHb6sPzI9/QV33WeuvVYBUIiD4NzNIyqaRQ==",
-      "dev": true,
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/generator-function": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/generator-function/-/generator-function-2.0.1.tgz",
-      "integrity": "sha512-SFdFmIJi+ybC0vjlHN0ZGVGHc3lgE0DxPAT0djjVg+kjOnSqclqmj0KQ7ykTOLP6YxoqOvuAODGdcHJn+43q3g==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/get-intrinsic": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
-      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
-      "dev": true,
-      "dependencies": {
-        "call-bind-apply-helpers": "^1.0.2",
-        "es-define-property": "^1.0.1",
-        "es-errors": "^1.3.0",
-        "es-object-atoms": "^1.1.1",
-        "function-bind": "^1.1.2",
-        "get-proto": "^1.0.1",
-        "gopd": "^1.2.0",
-        "has-symbols": "^1.1.0",
-        "hasown": "^2.0.2",
-        "math-intrinsics": "^1.1.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/get-proto": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
-      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
-      "dev": true,
-      "dependencies": {
-        "dunder-proto": "^1.0.1",
-        "es-object-atoms": "^1.0.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/get-symbol-description": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/get-symbol-description/-/get-symbol-description-1.1.0.tgz",
-      "integrity": "sha512-w9UMqWwJxHNOvoNzSJ2oPF5wvYcvP7jUvYzhp67yEhTi17ZDBBC1z9pTdGuzjD+EFIqLSYRweZjqfiPzQ06Ebg==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.3",
-        "es-errors": "^1.3.0",
-        "get-intrinsic": "^1.2.6"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/get-tsconfig": {
-      "version": "4.13.0",
-      "resolved": "https://registry.npmjs.org/get-tsconfig/-/get-tsconfig-4.13.0.tgz",
-      "integrity": "sha512-1VKTZJCwBrvbd+Wn3AOgQP/2Av+TfTCOlE4AcRJE72W1ksZXbAx8PPBR9RzgTeSPzlPMHrbANMH3LbltH73wxQ==",
-      "dev": true,
-      "dependencies": {
-        "resolve-pkg-maps": "^1.0.0"
-      },
-      "funding": {
-        "url": "https://github.com/privatenumber/get-tsconfig?sponsor=1"
-      }
-    },
-    "node_modules/glob-parent": {
-      "version": "6.0.2",
-      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz",
-      "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==",
-      "dev": true,
-      "dependencies": {
-        "is-glob": "^4.0.3"
-      },
-      "engines": {
-        "node": ">=10.13.0"
-      }
-    },
-    "node_modules/globals": {
-      "version": "14.0.0",
-      "resolved": "https://registry.npmjs.org/globals/-/globals-14.0.0.tgz",
-      "integrity": "sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=18"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/globalthis": {
-      "version": "1.0.4",
-      "resolved": "https://registry.npmjs.org/globalthis/-/globalthis-1.0.4.tgz",
-      "integrity": "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==",
-      "dev": true,
-      "dependencies": {
-        "define-properties": "^1.2.1",
-        "gopd": "^1.0.1"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/gopd": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
-      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/graphemer": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/graphemer/-/graphemer-1.4.0.tgz",
-      "integrity": "sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==",
-      "dev": true
-    },
-    "node_modules/has-bigints": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/has-bigints/-/has-bigints-1.1.0.tgz",
-      "integrity": "sha512-R3pbpkcIqv2Pm3dUwgjclDRVmWpTJW2DcMzcIhEXEx1oh/CEMObMm3KLmRJOdvhM7o4uQBnwr8pzRK2sJWIqfg==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/has-flag": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
-      "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/has-property-descriptors": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz",
-      "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==",
-      "dev": true,
-      "dependencies": {
-        "es-define-property": "^1.0.0"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/has-proto": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/has-proto/-/has-proto-1.2.0.tgz",
-      "integrity": "sha512-KIL7eQPfHQRC8+XluaIw7BHUwwqL19bQn4hzNgdr+1wXoU0KKj6rufu47lhY7KbJR2C6T6+PfyN0Ea7wkSS+qQ==",
-      "dev": true,
-      "dependencies": {
-        "dunder-proto": "^1.0.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/has-symbols": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
-      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/has-tostringtag": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
-      "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
-      "dev": true,
-      "dependencies": {
-        "has-symbols": "^1.0.3"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/hasown": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
-      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
-      "dev": true,
-      "dependencies": {
-        "function-bind": "^1.1.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/ignore": {
-      "version": "5.3.2",
-      "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",
-      "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",
-      "dev": true,
-      "engines": {
-        "node": ">= 4"
-      }
-    },
-    "node_modules/import-fresh": {
-      "version": "3.3.1",
-      "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz",
-      "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==",
-      "dev": true,
-      "dependencies": {
-        "parent-module": "^1.0.0",
-        "resolve-from": "^4.0.0"
-      },
-      "engines": {
-        "node": ">=6"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/imurmurhash": {
-      "version": "0.1.4",
-      "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz",
-      "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.8.19"
-      }
-    },
-    "node_modules/internal-slot": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/internal-slot/-/internal-slot-1.1.0.tgz",
-      "integrity": "sha512-4gd7VpWNQNB4UKKCFFVcp1AVv+FMOgs9NKzjHKusc8jTMhd5eL1NqQqOpE0KzMds804/yHlglp3uxgluOqAPLw==",
-      "dev": true,
-      "dependencies": {
-        "es-errors": "^1.3.0",
-        "hasown": "^2.0.2",
-        "side-channel": "^1.1.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/is-array-buffer": {
-      "version": "3.0.5",
-      "resolved": "https://registry.npmjs.org/is-array-buffer/-/is-array-buffer-3.0.5.tgz",
-      "integrity": "sha512-DDfANUiiG2wC1qawP66qlTugJeL5HyzMpfr8lLK+jMQirGzNod0B12cFB/9q838Ru27sBwfw78/rdoU7RERz6A==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.3",
-        "get-intrinsic": "^1.2.6"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-async-function": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/is-async-function/-/is-async-function-2.1.1.tgz",
-      "integrity": "sha512-9dgM/cZBnNvjzaMYHVoxxfPj2QXt22Ev7SuuPrs+xav0ukGB0S6d4ydZdEiM48kLx5kDV+QBPrpVnFyefL8kkQ==",
-      "dev": true,
-      "dependencies": {
-        "async-function": "^1.0.0",
-        "call-bound": "^1.0.3",
-        "get-proto": "^1.0.1",
-        "has-tostringtag": "^1.0.2",
-        "safe-regex-test": "^1.1.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-bigint": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/is-bigint/-/is-bigint-1.1.0.tgz",
-      "integrity": "sha512-n4ZT37wG78iz03xPRKJrHTdZbe3IicyucEtdRsV5yglwc3GyUfbAfpSeD0FJ41NbUNSt5wbhqfp1fS+BgnvDFQ==",
-      "dev": true,
-      "dependencies": {
-        "has-bigints": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-boolean-object": {
-      "version": "1.2.2",
-      "resolved": "https://registry.npmjs.org/is-boolean-object/-/is-boolean-object-1.2.2.tgz",
-      "integrity": "sha512-wa56o2/ElJMYqjCjGkXri7it5FbebW5usLw/nPmCMs5DeZ7eziSYZhSmPRn0txqeW4LnAmQQU7FgqLpsEFKM4A==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.3",
-        "has-tostringtag": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-bun-module": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/is-bun-module/-/is-bun-module-2.0.0.tgz",
-      "integrity": "sha512-gNCGbnnnnFAUGKeZ9PdbyeGYJqewpmc2aKHUEMO5nQPWU9lOmv7jcmQIv+qHD8fXW6W7qfuCwX4rY9LNRjXrkQ==",
-      "dev": true,
-      "dependencies": {
-        "semver": "^7.7.1"
-      }
-    },
-    "node_modules/is-callable": {
-      "version": "1.2.7",
-      "resolved": "https://registry.npmjs.org/is-callable/-/is-callable-1.2.7.tgz",
-      "integrity": "sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-core-module": {
-      "version": "2.16.1",
-      "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz",
-      "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==",
-      "dev": true,
-      "dependencies": {
-        "hasown": "^2.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-data-view": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/is-data-view/-/is-data-view-1.0.2.tgz",
-      "integrity": "sha512-RKtWF8pGmS87i2D6gqQu/l7EYRlVdfzemCJN/P3UOs//x1QE7mfhvzHIApBTRf7axvT6DMGwSwBXYCT0nfB9xw==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.2",
-        "get-intrinsic": "^1.2.6",
-        "is-typed-array": "^1.1.13"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-date-object": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/is-date-object/-/is-date-object-1.1.0.tgz",
-      "integrity": "sha512-PwwhEakHVKTdRNVOw+/Gyh0+MzlCl4R6qKvkhuvLtPMggI1WAHt9sOwZxQLSGpUaDnrdyDsomoRgNnCfKNSXXg==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.2",
-        "has-tostringtag": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-extglob": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
-      "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/is-finalizationregistry": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/is-finalizationregistry/-/is-finalizationregistry-1.1.1.tgz",
-      "integrity": "sha512-1pC6N8qWJbWoPtEjgcL2xyhQOP491EQjeUo3qTKcmV8YSDDJrOepfG8pcC7h/QgnQHYSv0mJ3Z/ZWxmatVrysg==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.3"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-generator-function": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/is-generator-function/-/is-generator-function-1.1.2.tgz",
-      "integrity": "sha512-upqt1SkGkODW9tsGNG5mtXTXtECizwtS2kA161M+gJPc1xdb/Ax629af6YrTwcOeQHbewrPNlE5Dx7kzvXTizA==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.4",
-        "generator-function": "^2.0.0",
-        "get-proto": "^1.0.1",
-        "has-tostringtag": "^1.0.2",
-        "safe-regex-test": "^1.1.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-glob": {
-      "version": "4.0.3",
-      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
-      "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
-      "dev": true,
-      "dependencies": {
-        "is-extglob": "^2.1.1"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/is-map": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/is-map/-/is-map-2.0.3.tgz",
-      "integrity": "sha512-1Qed0/Hr2m+YqxnM09CjA2d/i6YZNfF6R2oRAOj36eUdS6qIV/huPJNSEpKbupewFs+ZsJlxsjjPbc0/afW6Lw==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-negative-zero": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/is-negative-zero/-/is-negative-zero-2.0.3.tgz",
-      "integrity": "sha512-5KoIu2Ngpyek75jXodFvnafB6DJgr3u8uuK0LEZJjrU19DrMD3EVERaR8sjz8CCGgpZvxPl9SuE1GMVPFHx1mw==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-number": {
-      "version": "7.0.0",
-      "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
-      "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.12.0"
-      }
-    },
-    "node_modules/is-number-object": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/is-number-object/-/is-number-object-1.1.1.tgz",
-      "integrity": "sha512-lZhclumE1G6VYD8VHe35wFaIif+CTy5SJIi5+3y4psDgWu4wPDoBhF8NxUOinEc7pHgiTsT6MaBb92rKhhD+Xw==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.3",
-        "has-tostringtag": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-regex": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/is-regex/-/is-regex-1.2.1.tgz",
-      "integrity": "sha512-MjYsKHO5O7mCsmRGxWcLWheFqN9DJ/2TmngvjKXihe6efViPqc274+Fx/4fYj/r03+ESvBdTXK0V6tA3rgez1g==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.2",
-        "gopd": "^1.2.0",
-        "has-tostringtag": "^1.0.2",
-        "hasown": "^2.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-set": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/is-set/-/is-set-2.0.3.tgz",
-      "integrity": "sha512-iPAjerrse27/ygGLxw+EBR9agv9Y6uLeYVJMu+QNCoouJ1/1ri0mGrcWpfCqFZuzzx3WjtwxG098X+n4OuRkPg==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-shared-array-buffer": {
-      "version": "1.0.4",
-      "resolved": "https://registry.npmjs.org/is-shared-array-buffer/-/is-shared-array-buffer-1.0.4.tgz",
-      "integrity": "sha512-ISWac8drv4ZGfwKl5slpHG9OwPNty4jOWPRIhBpxOoD+hqITiwuipOQ2bNthAzwA3B4fIjO4Nln74N0S9byq8A==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.3"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-string": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/is-string/-/is-string-1.1.1.tgz",
-      "integrity": "sha512-BtEeSsoaQjlSPBemMQIrY1MY0uM6vnS1g5fmufYOtnxLGUZM2178PKbhsk7Ffv58IX+ZtcvoGwccYsh0PglkAA==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.3",
-        "has-tostringtag": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-symbol": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/is-symbol/-/is-symbol-1.1.1.tgz",
-      "integrity": "sha512-9gGx6GTtCQM73BgmHQXfDmLtfjjTUDSyoxTCbp5WtoixAhfgsDirWIcVQ/IHpvI5Vgd5i/J5F7B9cN/WlVbC/w==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.2",
-        "has-symbols": "^1.1.0",
-        "safe-regex-test": "^1.1.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-typed-array": {
-      "version": "1.1.15",
-      "resolved": "https://registry.npmjs.org/is-typed-array/-/is-typed-array-1.1.15.tgz",
-      "integrity": "sha512-p3EcsicXjit7SaskXHs1hA91QxgTw46Fv6EFKKGS5DRFLD8yKnohjF3hxoju94b/OcMZoQukzpPpBE9uLVKzgQ==",
-      "dev": true,
-      "dependencies": {
-        "which-typed-array": "^1.1.16"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-weakmap": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/is-weakmap/-/is-weakmap-2.0.2.tgz",
-      "integrity": "sha512-K5pXYOm9wqY1RgjpL3YTkF39tni1XajUIkawTLUo9EZEVUFga5gSQJF8nNS7ZwJQ02y+1YCNYcMh+HIf1ZqE+w==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-weakref": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/is-weakref/-/is-weakref-1.1.1.tgz",
-      "integrity": "sha512-6i9mGWSlqzNMEqpCp93KwRS1uUOodk2OJ6b+sq7ZPDSy2WuI5NFIxp/254TytR8ftefexkWn5xNiHUNpPOfSew==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.3"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-weakset": {
-      "version": "2.0.4",
-      "resolved": "https://registry.npmjs.org/is-weakset/-/is-weakset-2.0.4.tgz",
-      "integrity": "sha512-mfcwb6IzQyOKTs84CQMrOwW4gQcaTOAWJ0zzJCl2WSPDrWk/OzDaImWFH3djXhb24g4eudZfLRozAvPGw4d9hQ==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.3",
-        "get-intrinsic": "^1.2.6"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/isarray": {
-      "version": "2.0.5",
-      "resolved": "https://registry.npmjs.org/isarray/-/isarray-2.0.5.tgz",
-      "integrity": "sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==",
-      "dev": true
-    },
-    "node_modules/isexe": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
-      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
-      "dev": true
-    },
-    "node_modules/iterator.prototype": {
-      "version": "1.1.5",
-      "resolved": "https://registry.npmjs.org/iterator.prototype/-/iterator.prototype-1.1.5.tgz",
-      "integrity": "sha512-H0dkQoCa3b2VEeKQBOxFph+JAbcrQdE7KC0UkqwpLmv2EC4P41QXP+rqo9wYodACiG5/WM5s9oDApTU8utwj9g==",
-      "dev": true,
-      "dependencies": {
-        "define-data-property": "^1.1.4",
-        "es-object-atoms": "^1.0.0",
-        "get-intrinsic": "^1.2.6",
-        "get-proto": "^1.0.0",
-        "has-symbols": "^1.1.0",
-        "set-function-name": "^2.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/js-tokens": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
-      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
-      "dev": true
-    },
-    "node_modules/js-yaml": {
-      "version": "4.1.0",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz",
-      "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==",
-      "dev": true,
-      "dependencies": {
-        "argparse": "^2.0.1"
-      },
-      "bin": {
-        "js-yaml": "bin/js-yaml.js"
-      }
-    },
-    "node_modules/json-buffer": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz",
-      "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==",
-      "dev": true
-    },
-    "node_modules/json-schema-traverse": {
-      "version": "0.4.1",
-      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
-      "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
-      "dev": true
-    },
-    "node_modules/json-stable-stringify-without-jsonify": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz",
-      "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==",
-      "dev": true
-    },
-    "node_modules/json5": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/json5/-/json5-1.0.2.tgz",
-      "integrity": "sha512-g1MWMLBiz8FKi1e4w0UyVL3w+iJceWAFBAaBnnGKOpNa5f8TLktkbre1+s6oICydWAm+HRUGTmI+//xv2hvXYA==",
-      "dev": true,
-      "dependencies": {
-        "minimist": "^1.2.0"
-      },
-      "bin": {
-        "json5": "lib/cli.js"
-      }
-    },
-    "node_modules/jsx-ast-utils": {
-      "version": "3.3.5",
-      "resolved": "https://registry.npmjs.org/jsx-ast-utils/-/jsx-ast-utils-3.3.5.tgz",
-      "integrity": "sha512-ZZow9HBI5O6EPgSJLUb8n2NKgmVWTwCvHGwFuJlMjvLFqlGG6pjirPhtdsseaLZjSibD8eegzmYpUZwoIlj2cQ==",
-      "dev": true,
-      "dependencies": {
-        "array-includes": "^3.1.6",
-        "array.prototype.flat": "^1.3.1",
-        "object.assign": "^4.1.4",
-        "object.values": "^1.1.6"
-      },
-      "engines": {
-        "node": ">=4.0"
-      }
-    },
-    "node_modules/keyv": {
-      "version": "4.5.4",
-      "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz",
-      "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==",
-      "dev": true,
-      "dependencies": {
-        "json-buffer": "3.0.1"
-      }
-    },
-    "node_modules/language-subtag-registry": {
-      "version": "0.3.23",
-      "resolved": "https://registry.npmjs.org/language-subtag-registry/-/language-subtag-registry-0.3.23.tgz",
-      "integrity": "sha512-0K65Lea881pHotoGEa5gDlMxt3pctLi2RplBb7Ezh4rRdLEOtgi7n4EwK9lamnUCkKBqaeKRVebTq6BAxSkpXQ==",
-      "dev": true
-    },
-    "node_modules/language-tags": {
-      "version": "1.0.9",
-      "resolved": "https://registry.npmjs.org/language-tags/-/language-tags-1.0.9.tgz",
-      "integrity": "sha512-MbjN408fEndfiQXbFQ1vnd+1NoLDsnQW41410oQBXiyXDMYH5z505juWa4KUE1LqxRC7DgOgZDbKLxHIwm27hA==",
-      "dev": true,
-      "dependencies": {
-        "language-subtag-registry": "^0.3.20"
-      },
-      "engines": {
-        "node": ">=0.10"
-      }
-    },
-    "node_modules/levn": {
-      "version": "0.4.1",
-      "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz",
-      "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==",
-      "dev": true,
-      "dependencies": {
-        "prelude-ls": "^1.2.1",
-        "type-check": "~0.4.0"
-      },
-      "engines": {
-        "node": ">= 0.8.0"
-      }
-    },
-    "node_modules/locate-path": {
-      "version": "6.0.0",
-      "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz",
-      "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==",
-      "dev": true,
-      "dependencies": {
-        "p-locate": "^5.0.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/lodash.merge": {
-      "version": "4.6.2",
-      "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz",
-      "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==",
-      "dev": true
-    },
-    "node_modules/loose-envify": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz",
-      "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==",
-      "dev": true,
-      "dependencies": {
-        "js-tokens": "^3.0.0 || ^4.0.0"
-      },
-      "bin": {
-        "loose-envify": "cli.js"
-      }
-    },
-    "node_modules/math-intrinsics": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
-      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/merge2": {
-      "version": "1.4.1",
-      "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",
-      "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",
-      "dev": true,
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/micromatch": {
-      "version": "4.0.8",
-      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
-      "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",
-      "dev": true,
-      "dependencies": {
-        "braces": "^3.0.3",
-        "picomatch": "^2.3.1"
-      },
-      "engines": {
-        "node": ">=8.6"
-      }
-    },
-    "node_modules/minimatch": {
-      "version": "3.1.2",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
-      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
-      "dev": true,
-      "dependencies": {
-        "brace-expansion": "^1.1.7"
-      },
-      "engines": {
-        "node": "*"
-      }
-    },
-    "node_modules/minimist": {
-      "version": "1.2.8",
-      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
-      "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
-      "dev": true,
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/ms": {
-      "version": "2.1.3",
-      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
-      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
-      "dev": true
-    },
-    "node_modules/nanoid": {
-      "version": "3.3.11",
-      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
-      "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "bin": {
-        "nanoid": "bin/nanoid.cjs"
-      },
-      "engines": {
-        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
-      }
-    },
-    "node_modules/napi-postinstall": {
-      "version": "0.3.4",
-      "resolved": "https://registry.npmjs.org/napi-postinstall/-/napi-postinstall-0.3.4.tgz",
-      "integrity": "sha512-PHI5f1O0EP5xJ9gQmFGMS6IZcrVvTjpXjz7Na41gTE7eE2hK11lg04CECCYEEjdc17EV4DO+fkGEtt7TpTaTiQ==",
-      "dev": true,
-      "bin": {
-        "napi-postinstall": "lib/cli.js"
-      },
-      "engines": {
-        "node": "^12.20.0 || ^14.18.0 || >=16.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/napi-postinstall"
-      }
-    },
-    "node_modules/natural-compare": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz",
-      "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==",
-      "dev": true
-    },
-    "node_modules/next": {
-      "version": "15.5.5",
-      "resolved": "https://registry.npmjs.org/next/-/next-15.5.5.tgz",
-      "integrity": "sha512-OQVdBPtpBfq7HxFN0kOVb7rXXOSIkt5lTzDJDGRBcOyVvNRIWFauMqi1gIHd1pszq1542vMOGY0HP4CaiALfkA==",
-      "dependencies": {
-        "@next/env": "15.5.5",
-        "@swc/helpers": "0.5.15",
-        "caniuse-lite": "^1.0.30001579",
-        "postcss": "8.4.31",
-        "styled-jsx": "5.1.6"
-      },
-      "bin": {
-        "next": "dist/bin/next"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^19.8.0 || >= 20.0.0"
-      },
-      "optionalDependencies": {
-        "@next/swc-darwin-arm64": "15.5.5",
-        "@next/swc-darwin-x64": "15.5.5",
-        "@next/swc-linux-arm64-gnu": "15.5.5",
-        "@next/swc-linux-arm64-musl": "15.5.5",
-        "@next/swc-linux-x64-gnu": "15.5.5",
-        "@next/swc-linux-x64-musl": "15.5.5",
-        "@next/swc-win32-arm64-msvc": "15.5.5",
-        "@next/swc-win32-x64-msvc": "15.5.5",
-        "sharp": "^0.34.3"
-      },
-      "peerDependencies": {
-        "@opentelemetry/api": "^1.1.0",
-        "@playwright/test": "^1.51.1",
-        "babel-plugin-react-compiler": "*",
-        "react": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0",
-        "react-dom": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0",
-        "sass": "^1.3.0"
-      },
-      "peerDependenciesMeta": {
-        "@opentelemetry/api": {
-          "optional": true
-        },
-        "@playwright/test": {
-          "optional": true
-        },
-        "babel-plugin-react-compiler": {
-          "optional": true
-        },
-        "sass": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/object-assign": {
-      "version": "4.1.1",
-      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
-      "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/object-inspect": {
-      "version": "1.13.4",
-      "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
-      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/object-keys": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz",
-      "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/object.assign": {
-      "version": "4.1.7",
-      "resolved": "https://registry.npmjs.org/object.assign/-/object.assign-4.1.7.tgz",
-      "integrity": "sha512-nK28WOo+QIjBkDduTINE4JkF/UJJKyf2EJxvJKfblDpyg0Q+pkOHNTL0Qwy6NP6FhE/EnzV73BxxqcJaXY9anw==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.3",
-        "define-properties": "^1.2.1",
-        "es-object-atoms": "^1.0.0",
-        "has-symbols": "^1.1.0",
-        "object-keys": "^1.1.1"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/object.entries": {
-      "version": "1.1.9",
-      "resolved": "https://registry.npmjs.org/object.entries/-/object.entries-1.1.9.tgz",
-      "integrity": "sha512-8u/hfXFRBD1O0hPUjioLhoWFHRmt6tKA4/vZPyckBr18l1KE9uHrFaFaUi8MDRTpi4uak2goyPTSNJLXX2k2Hw==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.4",
-        "define-properties": "^1.2.1",
-        "es-object-atoms": "^1.1.1"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/object.fromentries": {
-      "version": "2.0.8",
-      "resolved": "https://registry.npmjs.org/object.fromentries/-/object.fromentries-2.0.8.tgz",
-      "integrity": "sha512-k6E21FzySsSK5a21KRADBd/NGneRegFO5pLHfdQLpRDETUNJueLXs3WCzyQ3tFRDYgbq3KHGXfTbi2bs8WQ6rQ==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.7",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.23.2",
-        "es-object-atoms": "^1.0.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/object.groupby": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/object.groupby/-/object.groupby-1.0.3.tgz",
-      "integrity": "sha512-+Lhy3TQTuzXI5hevh8sBGqbmurHbbIjAi0Z4S63nthVLmLxfbj4T54a4CfZrXIrt9iP4mVAPYMo/v99taj3wjQ==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.7",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.23.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/object.values": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/object.values/-/object.values-1.2.1.tgz",
-      "integrity": "sha512-gXah6aZrcUxjWg2zR2MwouP2eHlCBzdV4pygudehaKXSGW4v2AsRQUK+lwwXhii6KFZcunEnmSUoYp5CXibxtA==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.3",
-        "define-properties": "^1.2.1",
-        "es-object-atoms": "^1.0.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/optionator": {
-      "version": "0.9.4",
-      "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz",
-      "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==",
-      "dev": true,
-      "dependencies": {
-        "deep-is": "^0.1.3",
-        "fast-levenshtein": "^2.0.6",
-        "levn": "^0.4.1",
-        "prelude-ls": "^1.2.1",
-        "type-check": "^0.4.0",
-        "word-wrap": "^1.2.5"
-      },
-      "engines": {
-        "node": ">= 0.8.0"
-      }
-    },
-    "node_modules/own-keys": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/own-keys/-/own-keys-1.0.1.tgz",
-      "integrity": "sha512-qFOyK5PjiWZd+QQIh+1jhdb9LpxTF0qs7Pm8o5QHYZ0M3vKqSqzsZaEB6oWlxZ+q2sJBMI/Ktgd2N5ZwQoRHfg==",
-      "dev": true,
-      "dependencies": {
-        "get-intrinsic": "^1.2.6",
-        "object-keys": "^1.1.1",
-        "safe-push-apply": "^1.0.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/p-limit": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz",
-      "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==",
-      "dev": true,
-      "dependencies": {
-        "yocto-queue": "^0.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/p-locate": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz",
-      "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==",
-      "dev": true,
-      "dependencies": {
-        "p-limit": "^3.0.2"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/parent-module": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz",
-      "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==",
-      "dev": true,
-      "dependencies": {
-        "callsites": "^3.0.0"
-      },
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/path-exists": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
-      "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/path-key": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
-      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/path-parse": {
-      "version": "1.0.7",
-      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
-      "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
-      "dev": true
-    },
-    "node_modules/picocolors": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
-      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="
-    },
-    "node_modules/picomatch": {
-      "version": "2.3.1",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
-      "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
-      "dev": true,
-      "engines": {
-        "node": ">=8.6"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/jonschlinkert"
-      }
-    },
-    "node_modules/possible-typed-array-names": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/possible-typed-array-names/-/possible-typed-array-names-1.1.0.tgz",
-      "integrity": "sha512-/+5VFTchJDoVj3bhoqi6UeymcD00DAwb1nJwamzPvHEszJ4FpF6SNNbUbOS8yI56qHzdV8eK0qEfOSiodkTdxg==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/postcss": {
-      "version": "8.4.31",
-      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.31.tgz",
-      "integrity": "sha512-PS08Iboia9mts/2ygV3eLpY5ghnUcfLV/EXTOW1E2qYxJKGGBUtNjN76FYHnMs36RmARn41bC0AZmn+rR0OVpQ==",
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/postcss/"
-        },
-        {
-          "type": "tidelift",
-          "url": "https://tidelift.com/funding/github/npm/postcss"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "dependencies": {
-        "nanoid": "^3.3.6",
-        "picocolors": "^1.0.0",
-        "source-map-js": "^1.0.2"
-      },
-      "engines": {
-        "node": "^10 || ^12 || >=14"
-      }
-    },
-    "node_modules/prelude-ls": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz",
-      "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.8.0"
-      }
-    },
-    "node_modules/prop-types": {
-      "version": "15.8.1",
-      "resolved": "https://registry.npmjs.org/prop-types/-/prop-types-15.8.1.tgz",
-      "integrity": "sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg==",
-      "dev": true,
-      "dependencies": {
-        "loose-envify": "^1.4.0",
-        "object-assign": "^4.1.1",
-        "react-is": "^16.13.1"
-      }
-    },
-    "node_modules/punycode": {
-      "version": "2.3.1",
-      "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
-      "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/queue-microtask": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",
-      "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ]
-    },
-    "node_modules/react": {
-      "version": "19.1.0",
-      "resolved": "https://registry.npmjs.org/react/-/react-19.1.0.tgz",
-      "integrity": "sha512-FS+XFBNvn3GTAWq26joslQgWNoFu08F4kl0J4CgdNKADkdSGXQyTCnKteIAJy96Br6YbpEU1LSzV5dYtjMkMDg==",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/react-dom": {
-      "version": "19.1.0",
-      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.1.0.tgz",
-      "integrity": "sha512-Xs1hdnE+DyKgeHJeJznQmYMIBG3TKIHJJT95Q58nHLSrElKlGQqDTR2HQ9fx5CN/Gk6Vh/kupBTDLU11/nDk/g==",
-      "dependencies": {
-        "scheduler": "^0.26.0"
-      },
-      "peerDependencies": {
-        "react": "^19.1.0"
-      }
-    },
-    "node_modules/react-is": {
-      "version": "16.13.1",
-      "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz",
-      "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==",
-      "dev": true
-    },
-    "node_modules/reflect.getprototypeof": {
-      "version": "1.0.10",
-      "resolved": "https://registry.npmjs.org/reflect.getprototypeof/-/reflect.getprototypeof-1.0.10.tgz",
-      "integrity": "sha512-00o4I+DVrefhv+nX0ulyi3biSHCPDe+yLv5o/p6d/UVlirijB8E16FtfwSAi4g3tcqrQ4lRAqQSoFEZJehYEcw==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.23.9",
-        "es-errors": "^1.3.0",
-        "es-object-atoms": "^1.0.0",
-        "get-intrinsic": "^1.2.7",
-        "get-proto": "^1.0.1",
-        "which-builtin-type": "^1.2.1"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/regexp.prototype.flags": {
-      "version": "1.5.4",
-      "resolved": "https://registry.npmjs.org/regexp.prototype.flags/-/regexp.prototype.flags-1.5.4.tgz",
-      "integrity": "sha512-dYqgNSZbDwkaJ2ceRd9ojCGjBq+mOm9LmtXnAnEGyHhN/5R7iDW2TRw3h+o/jCFxus3P2LfWIIiwowAjANm7IA==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "define-properties": "^1.2.1",
-        "es-errors": "^1.3.0",
-        "get-proto": "^1.0.1",
-        "gopd": "^1.2.0",
-        "set-function-name": "^2.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/resolve": {
-      "version": "1.22.11",
-      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.11.tgz",
-      "integrity": "sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==",
-      "dev": true,
-      "dependencies": {
-        "is-core-module": "^2.16.1",
-        "path-parse": "^1.0.7",
-        "supports-preserve-symlinks-flag": "^1.0.0"
-      },
-      "bin": {
-        "resolve": "bin/resolve"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/resolve-from": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz",
-      "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==",
-      "dev": true,
-      "engines": {
-        "node": ">=4"
-      }
-    },
-    "node_modules/resolve-pkg-maps": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz",
-      "integrity": "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==",
-      "dev": true,
-      "funding": {
-        "url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1"
-      }
-    },
-    "node_modules/reusify": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz",
-      "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==",
-      "dev": true,
-      "engines": {
-        "iojs": ">=1.0.0",
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/run-parallel": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz",
-      "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "dependencies": {
-        "queue-microtask": "^1.2.2"
-      }
-    },
-    "node_modules/safe-array-concat": {
-      "version": "1.1.3",
-      "resolved": "https://registry.npmjs.org/safe-array-concat/-/safe-array-concat-1.1.3.tgz",
-      "integrity": "sha512-AURm5f0jYEOydBj7VQlVvDrjeFgthDdEF5H1dP+6mNpoXOMo1quQqJ4wvJDyRZ9+pO3kGWoOdmV08cSv2aJV6Q==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.2",
-        "get-intrinsic": "^1.2.6",
-        "has-symbols": "^1.1.0",
-        "isarray": "^2.0.5"
-      },
-      "engines": {
-        "node": ">=0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/safe-push-apply": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/safe-push-apply/-/safe-push-apply-1.0.0.tgz",
-      "integrity": "sha512-iKE9w/Z7xCzUMIZqdBsp6pEQvwuEebH4vdpjcDWnyzaI6yl6O9FHvVpmGelvEHNsoY6wGblkxR6Zty/h00WiSA==",
-      "dev": true,
-      "dependencies": {
-        "es-errors": "^1.3.0",
-        "isarray": "^2.0.5"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/safe-regex-test": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/safe-regex-test/-/safe-regex-test-1.1.0.tgz",
-      "integrity": "sha512-x/+Cz4YrimQxQccJf5mKEbIa1NzeCRNI5Ecl/ekmlYaampdNLPalVyIcCZNNH3MvmqBugV5TMYZXv0ljslUlaw==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.2",
-        "es-errors": "^1.3.0",
-        "is-regex": "^1.2.1"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/scheduler": {
-      "version": "0.26.0",
-      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.26.0.tgz",
-      "integrity": "sha512-NlHwttCI/l5gCPR3D1nNXtWABUmBwvZpEQiD4IXSbIDq8BzLIK/7Ir5gTFSGZDUu37K5cMNp0hFtzO38sC7gWA=="
-    },
-    "node_modules/semver": {
-      "version": "7.7.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz",
-      "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==",
-      "devOptional": true,
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/set-function-length": {
-      "version": "1.2.2",
-      "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz",
-      "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==",
-      "dev": true,
-      "dependencies": {
-        "define-data-property": "^1.1.4",
-        "es-errors": "^1.3.0",
-        "function-bind": "^1.1.2",
-        "get-intrinsic": "^1.2.4",
-        "gopd": "^1.0.1",
-        "has-property-descriptors": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/set-function-name": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/set-function-name/-/set-function-name-2.0.2.tgz",
-      "integrity": "sha512-7PGFlmtwsEADb0WYyvCMa1t+yke6daIG4Wirafur5kcf+MhUnPms1UeR0CKQdTZD81yESwMHbtn+TR+dMviakQ==",
-      "dev": true,
-      "dependencies": {
-        "define-data-property": "^1.1.4",
-        "es-errors": "^1.3.0",
-        "functions-have-names": "^1.2.3",
-        "has-property-descriptors": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/set-proto": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/set-proto/-/set-proto-1.0.0.tgz",
-      "integrity": "sha512-RJRdvCo6IAnPdsvP/7m6bsQqNnn1FCBX5ZNtFL98MmFF/4xAIJTIg1YbHW5DC2W5SKZanrC6i4HsJqlajw/dZw==",
-      "dev": true,
-      "dependencies": {
-        "dunder-proto": "^1.0.1",
-        "es-errors": "^1.3.0",
-        "es-object-atoms": "^1.0.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/sharp": {
-      "version": "0.34.4",
-      "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.34.4.tgz",
-      "integrity": "sha512-FUH39xp3SBPnxWvd5iib1X8XY7J0K0X7d93sie9CJg2PO8/7gmg89Nve6OjItK53/MlAushNNxteBYfM6DEuoA==",
-      "hasInstallScript": true,
-      "optional": true,
-      "dependencies": {
-        "@img/colour": "^1.0.0",
-        "detect-libc": "^2.1.0",
-        "semver": "^7.7.2"
-      },
-      "engines": {
-        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/libvips"
-      },
-      "optionalDependencies": {
-        "@img/sharp-darwin-arm64": "0.34.4",
-        "@img/sharp-darwin-x64": "0.34.4",
-        "@img/sharp-libvips-darwin-arm64": "1.2.3",
-        "@img/sharp-libvips-darwin-x64": "1.2.3",
-        "@img/sharp-libvips-linux-arm": "1.2.3",
-        "@img/sharp-libvips-linux-arm64": "1.2.3",
-        "@img/sharp-libvips-linux-ppc64": "1.2.3",
-        "@img/sharp-libvips-linux-s390x": "1.2.3",
-        "@img/sharp-libvips-linux-x64": "1.2.3",
-        "@img/sharp-libvips-linuxmusl-arm64": "1.2.3",
-        "@img/sharp-libvips-linuxmusl-x64": "1.2.3",
-        "@img/sharp-linux-arm": "0.34.4",
-        "@img/sharp-linux-arm64": "0.34.4",
-        "@img/sharp-linux-ppc64": "0.34.4",
-        "@img/sharp-linux-s390x": "0.34.4",
-        "@img/sharp-linux-x64": "0.34.4",
-        "@img/sharp-linuxmusl-arm64": "0.34.4",
-        "@img/sharp-linuxmusl-x64": "0.34.4",
-        "@img/sharp-wasm32": "0.34.4",
-        "@img/sharp-win32-arm64": "0.34.4",
-        "@img/sharp-win32-ia32": "0.34.4",
-        "@img/sharp-win32-x64": "0.34.4"
-      }
-    },
-    "node_modules/shebang-command": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
-      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
-      "dev": true,
-      "dependencies": {
-        "shebang-regex": "^3.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/shebang-regex": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
-      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/side-channel": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
-      "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
-      "dev": true,
-      "dependencies": {
-        "es-errors": "^1.3.0",
-        "object-inspect": "^1.13.3",
-        "side-channel-list": "^1.0.0",
-        "side-channel-map": "^1.0.1",
-        "side-channel-weakmap": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/side-channel-list": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz",
-      "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==",
-      "dev": true,
-      "dependencies": {
-        "es-errors": "^1.3.0",
-        "object-inspect": "^1.13.3"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/side-channel-map": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
-      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.2",
-        "es-errors": "^1.3.0",
-        "get-intrinsic": "^1.2.5",
-        "object-inspect": "^1.13.3"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/side-channel-weakmap": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
-      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.2",
-        "es-errors": "^1.3.0",
-        "get-intrinsic": "^1.2.5",
-        "object-inspect": "^1.13.3",
-        "side-channel-map": "^1.0.1"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/source-map-js": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
-      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/stable-hash": {
-      "version": "0.0.5",
-      "resolved": "https://registry.npmjs.org/stable-hash/-/stable-hash-0.0.5.tgz",
-      "integrity": "sha512-+L3ccpzibovGXFK+Ap/f8LOS0ahMrHTf3xu7mMLSpEGU0EO9ucaysSylKo9eRDFNhWve/y275iPmIZ4z39a9iA==",
-      "dev": true
-    },
-    "node_modules/stop-iteration-iterator": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/stop-iteration-iterator/-/stop-iteration-iterator-1.1.0.tgz",
-      "integrity": "sha512-eLoXW/DHyl62zxY4SCaIgnRhuMr6ri4juEYARS8E6sCEqzKpOiE521Ucofdx+KnDZl5xmvGYaaKCk5FEOxJCoQ==",
-      "dev": true,
-      "dependencies": {
-        "es-errors": "^1.3.0",
-        "internal-slot": "^1.1.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/string.prototype.includes": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/string.prototype.includes/-/string.prototype.includes-2.0.1.tgz",
-      "integrity": "sha512-o7+c9bW6zpAdJHTtujeePODAhkuicdAryFsfVKwA+wGw89wJ4GTY484WTucM9hLtDEOpOvI+aHnzqnC5lHp4Rg==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.7",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.23.3"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/string.prototype.matchall": {
-      "version": "4.0.12",
-      "resolved": "https://registry.npmjs.org/string.prototype.matchall/-/string.prototype.matchall-4.0.12.tgz",
-      "integrity": "sha512-6CC9uyBL+/48dYizRf7H7VAYCMCNTBeM78x/VTUe9bFEaxBepPJDa1Ow99LqI/1yF7kuy7Q3cQsYMrcjGUcskA==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.3",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.23.6",
-        "es-errors": "^1.3.0",
-        "es-object-atoms": "^1.0.0",
-        "get-intrinsic": "^1.2.6",
-        "gopd": "^1.2.0",
-        "has-symbols": "^1.1.0",
-        "internal-slot": "^1.1.0",
-        "regexp.prototype.flags": "^1.5.3",
-        "set-function-name": "^2.0.2",
-        "side-channel": "^1.1.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/string.prototype.repeat": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/string.prototype.repeat/-/string.prototype.repeat-1.0.0.tgz",
-      "integrity": "sha512-0u/TldDbKD8bFCQ/4f5+mNRrXwZ8hg2w7ZR8wa16e8z9XpePWl3eGEcUD0OXpEH/VJH/2G3gjUtR3ZOiBe2S/w==",
-      "dev": true,
-      "dependencies": {
-        "define-properties": "^1.1.3",
-        "es-abstract": "^1.17.5"
-      }
-    },
-    "node_modules/string.prototype.trim": {
-      "version": "1.2.10",
-      "resolved": "https://registry.npmjs.org/string.prototype.trim/-/string.prototype.trim-1.2.10.tgz",
-      "integrity": "sha512-Rs66F0P/1kedk5lyYyH9uBzuiI/kNRmwJAR9quK6VOtIpZ2G+hMZd+HQbbv25MgCA6gEffoMZYxlTod4WcdrKA==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.2",
-        "define-data-property": "^1.1.4",
-        "define-properties": "^1.2.1",
-        "es-abstract": "^1.23.5",
-        "es-object-atoms": "^1.0.0",
-        "has-property-descriptors": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/string.prototype.trimend": {
-      "version": "1.0.9",
-      "resolved": "https://registry.npmjs.org/string.prototype.trimend/-/string.prototype.trimend-1.0.9.tgz",
-      "integrity": "sha512-G7Ok5C6E/j4SGfyLCloXTrngQIQU3PWtXGst3yM7Bea9FRURf1S42ZHlZZtsNque2FN2PoUhfZXYLNWwEr4dLQ==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.2",
-        "define-properties": "^1.2.1",
-        "es-object-atoms": "^1.0.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/string.prototype.trimstart": {
-      "version": "1.0.8",
-      "resolved": "https://registry.npmjs.org/string.prototype.trimstart/-/string.prototype.trimstart-1.0.8.tgz",
-      "integrity": "sha512-UXSH262CSZY1tfu3G3Secr6uGLCFVPMhIqHjlgCUtCCcgihYc/xKs9djMTMUOb2j1mVSeU8EU6NWc/iQKU6Gfg==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.7",
-        "define-properties": "^1.2.1",
-        "es-object-atoms": "^1.0.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/strip-bom": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz",
-      "integrity": "sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==",
-      "dev": true,
-      "engines": {
-        "node": ">=4"
-      }
-    },
-    "node_modules/strip-json-comments": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz",
-      "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/styled-jsx": {
-      "version": "5.1.6",
-      "resolved": "https://registry.npmjs.org/styled-jsx/-/styled-jsx-5.1.6.tgz",
-      "integrity": "sha512-qSVyDTeMotdvQYoHWLNGwRFJHC+i+ZvdBRYosOFgC+Wg1vx4frN2/RG/NA7SYqqvKNLf39P2LSRA2pu6n0XYZA==",
-      "dependencies": {
-        "client-only": "0.0.1"
-      },
-      "engines": {
-        "node": ">= 12.0.0"
-      },
-      "peerDependencies": {
-        "react": ">= 16.8.0 || 17.x.x || ^18.0.0-0 || ^19.0.0-0"
-      },
-      "peerDependenciesMeta": {
-        "@babel/core": {
-          "optional": true
-        },
-        "babel-plugin-macros": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/supports-color": {
-      "version": "7.2.0",
-      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
-      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
-      "dev": true,
-      "dependencies": {
-        "has-flag": "^4.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/supports-preserve-symlinks-flag": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz",
-      "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/tinyglobby": {
-      "version": "0.2.15",
-      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
-      "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
-      "dev": true,
-      "dependencies": {
-        "fdir": "^6.5.0",
-        "picomatch": "^4.0.3"
-      },
-      "engines": {
-        "node": ">=12.0.0"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/SuperchupuDev"
-      }
-    },
-    "node_modules/tinyglobby/node_modules/fdir": {
-      "version": "6.5.0",
-      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
-      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
-      "dev": true,
-      "engines": {
-        "node": ">=12.0.0"
-      },
-      "peerDependencies": {
-        "picomatch": "^3 || ^4"
-      },
-      "peerDependenciesMeta": {
-        "picomatch": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/tinyglobby/node_modules/picomatch": {
-      "version": "4.0.3",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
-      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
-      "dev": true,
-      "engines": {
-        "node": ">=12"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/jonschlinkert"
-      }
-    },
-    "node_modules/to-regex-range": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
-      "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
-      "dev": true,
-      "dependencies": {
-        "is-number": "^7.0.0"
-      },
-      "engines": {
-        "node": ">=8.0"
-      }
-    },
-    "node_modules/ts-api-utils": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.1.0.tgz",
-      "integrity": "sha512-CUgTZL1irw8u29bzrOD/nH85jqyc74D6SshFgujOIA7osm2Rz7dYH77agkx7H4FBNxDq7Cjf+IjaX/8zwFW+ZQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=18.12"
-      },
-      "peerDependencies": {
-        "typescript": ">=4.8.4"
-      }
-    },
-    "node_modules/tsconfig-paths": {
-      "version": "3.15.0",
-      "resolved": "https://registry.npmjs.org/tsconfig-paths/-/tsconfig-paths-3.15.0.tgz",
-      "integrity": "sha512-2Ac2RgzDe/cn48GvOe3M+o82pEFewD3UPbyoUHHdKasHwJKjds4fLXWf/Ux5kATBKN20oaFGu+jbElp1pos0mg==",
-      "dev": true,
-      "dependencies": {
-        "@types/json5": "^0.0.29",
-        "json5": "^1.0.2",
-        "minimist": "^1.2.6",
-        "strip-bom": "^3.0.0"
-      }
-    },
-    "node_modules/tslib": {
-      "version": "2.8.1",
-      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
-      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="
-    },
-    "node_modules/type-check": {
-      "version": "0.4.0",
-      "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz",
-      "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==",
-      "dev": true,
-      "dependencies": {
-        "prelude-ls": "^1.2.1"
-      },
-      "engines": {
-        "node": ">= 0.8.0"
-      }
-    },
-    "node_modules/typed-array-buffer": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/typed-array-buffer/-/typed-array-buffer-1.0.3.tgz",
-      "integrity": "sha512-nAYYwfY3qnzX30IkA6AQZjVbtK6duGontcQm1WSG1MD94YLqK0515GNApXkoxKOWMusVssAHWLh9SeaoefYFGw==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.3",
-        "es-errors": "^1.3.0",
-        "is-typed-array": "^1.1.14"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/typed-array-byte-length": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/typed-array-byte-length/-/typed-array-byte-length-1.0.3.tgz",
-      "integrity": "sha512-BaXgOuIxz8n8pIq3e7Atg/7s+DpiYrxn4vdot3w9KbnBhcRQq6o3xemQdIfynqSeXeDrF32x+WvfzmOjPiY9lg==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.8",
-        "for-each": "^0.3.3",
-        "gopd": "^1.2.0",
-        "has-proto": "^1.2.0",
-        "is-typed-array": "^1.1.14"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/typed-array-byte-offset": {
-      "version": "1.0.4",
-      "resolved": "https://registry.npmjs.org/typed-array-byte-offset/-/typed-array-byte-offset-1.0.4.tgz",
-      "integrity": "sha512-bTlAFB/FBYMcuX81gbL4OcpH5PmlFHqlCCpAl8AlEzMz5k53oNDvN8p1PNOWLEmI2x4orp3raOFB51tv9X+MFQ==",
-      "dev": true,
-      "dependencies": {
-        "available-typed-arrays": "^1.0.7",
-        "call-bind": "^1.0.8",
-        "for-each": "^0.3.3",
-        "gopd": "^1.2.0",
-        "has-proto": "^1.2.0",
-        "is-typed-array": "^1.1.15",
-        "reflect.getprototypeof": "^1.0.9"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/typed-array-length": {
-      "version": "1.0.7",
-      "resolved": "https://registry.npmjs.org/typed-array-length/-/typed-array-length-1.0.7.tgz",
-      "integrity": "sha512-3KS2b+kL7fsuk/eJZ7EQdnEmQoaho/r6KUef7hxvltNA5DR8NAUM+8wJMbJyZ4G9/7i3v5zPBIMN5aybAh2/Jg==",
-      "dev": true,
-      "dependencies": {
-        "call-bind": "^1.0.7",
-        "for-each": "^0.3.3",
-        "gopd": "^1.0.1",
-        "is-typed-array": "^1.1.13",
-        "possible-typed-array-names": "^1.0.0",
-        "reflect.getprototypeof": "^1.0.6"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/typescript": {
-      "version": "5.9.3",
-      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
-      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
-      "dev": true,
-      "bin": {
-        "tsc": "bin/tsc",
-        "tsserver": "bin/tsserver"
-      },
-      "engines": {
-        "node": ">=14.17"
-      }
-    },
-    "node_modules/unbox-primitive": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/unbox-primitive/-/unbox-primitive-1.1.0.tgz",
-      "integrity": "sha512-nWJ91DjeOkej/TA8pXQ3myruKpKEYgqvpw9lz4OPHj/NWFNluYrjbz9j01CJ8yKQd2g4jFoOkINCTW2I5LEEyw==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.3",
-        "has-bigints": "^1.0.2",
-        "has-symbols": "^1.1.0",
-        "which-boxed-primitive": "^1.1.1"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/undici-types": {
-      "version": "6.21.0",
-      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
-      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
-      "dev": true
-    },
-    "node_modules/unrs-resolver": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/unrs-resolver/-/unrs-resolver-1.11.1.tgz",
-      "integrity": "sha512-bSjt9pjaEBnNiGgc9rUiHGKv5l4/TGzDmYw3RhnkJGtLhbnnA/5qJj7x3dNDCRx/PJxu774LlH8lCOlB4hEfKg==",
-      "dev": true,
-      "hasInstallScript": true,
-      "dependencies": {
-        "napi-postinstall": "^0.3.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/unrs-resolver"
-      },
-      "optionalDependencies": {
-        "@unrs/resolver-binding-android-arm-eabi": "1.11.1",
-        "@unrs/resolver-binding-android-arm64": "1.11.1",
-        "@unrs/resolver-binding-darwin-arm64": "1.11.1",
-        "@unrs/resolver-binding-darwin-x64": "1.11.1",
-        "@unrs/resolver-binding-freebsd-x64": "1.11.1",
-        "@unrs/resolver-binding-linux-arm-gnueabihf": "1.11.1",
-        "@unrs/resolver-binding-linux-arm-musleabihf": "1.11.1",
-        "@unrs/resolver-binding-linux-arm64-gnu": "1.11.1",
-        "@unrs/resolver-binding-linux-arm64-musl": "1.11.1",
-        "@unrs/resolver-binding-linux-ppc64-gnu": "1.11.1",
-        "@unrs/resolver-binding-linux-riscv64-gnu": "1.11.1",
-        "@unrs/resolver-binding-linux-riscv64-musl": "1.11.1",
-        "@unrs/resolver-binding-linux-s390x-gnu": "1.11.1",
-        "@unrs/resolver-binding-linux-x64-gnu": "1.11.1",
-        "@unrs/resolver-binding-linux-x64-musl": "1.11.1",
-        "@unrs/resolver-binding-wasm32-wasi": "1.11.1",
-        "@unrs/resolver-binding-win32-arm64-msvc": "1.11.1",
-        "@unrs/resolver-binding-win32-ia32-msvc": "1.11.1",
-        "@unrs/resolver-binding-win32-x64-msvc": "1.11.1"
-      }
-    },
-    "node_modules/uri-js": {
-      "version": "4.4.1",
-      "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz",
-      "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==",
-      "dev": true,
-      "dependencies": {
-        "punycode": "^2.1.0"
-      }
-    },
-    "node_modules/which": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
-      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
-      "dev": true,
-      "dependencies": {
-        "isexe": "^2.0.0"
-      },
-      "bin": {
-        "node-which": "bin/node-which"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/which-boxed-primitive": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/which-boxed-primitive/-/which-boxed-primitive-1.1.1.tgz",
-      "integrity": "sha512-TbX3mj8n0odCBFVlY8AxkqcHASw3L60jIuF8jFP78az3C2YhmGvqbHBpAjTRH2/xqYunrJ9g1jSyjCjpoWzIAA==",
-      "dev": true,
-      "dependencies": {
-        "is-bigint": "^1.1.0",
-        "is-boolean-object": "^1.2.1",
-        "is-number-object": "^1.1.1",
-        "is-string": "^1.1.1",
-        "is-symbol": "^1.1.1"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/which-builtin-type": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/which-builtin-type/-/which-builtin-type-1.2.1.tgz",
-      "integrity": "sha512-6iBczoX+kDQ7a3+YJBnh3T+KZRxM/iYNPXicqk66/Qfm1b93iu+yOImkg0zHbj5LNOcNv1TEADiZ0xa34B4q6Q==",
-      "dev": true,
-      "dependencies": {
-        "call-bound": "^1.0.2",
-        "function.prototype.name": "^1.1.6",
-        "has-tostringtag": "^1.0.2",
-        "is-async-function": "^2.0.0",
-        "is-date-object": "^1.1.0",
-        "is-finalizationregistry": "^1.1.0",
-        "is-generator-function": "^1.0.10",
-        "is-regex": "^1.2.1",
-        "is-weakref": "^1.0.2",
-        "isarray": "^2.0.5",
-        "which-boxed-primitive": "^1.1.0",
-        "which-collection": "^1.0.2",
-        "which-typed-array": "^1.1.16"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/which-collection": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/which-collection/-/which-collection-1.0.2.tgz",
-      "integrity": "sha512-K4jVyjnBdgvc86Y6BkaLZEN933SwYOuBFkdmBu9ZfkcAbdVbpITnDmjvZ/aQjRXQrv5EPkTnD1s39GiiqbngCw==",
-      "dev": true,
-      "dependencies": {
-        "is-map": "^2.0.3",
-        "is-set": "^2.0.3",
-        "is-weakmap": "^2.0.2",
-        "is-weakset": "^2.0.3"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/which-typed-array": {
-      "version": "1.1.19",
-      "resolved": "https://registry.npmjs.org/which-typed-array/-/which-typed-array-1.1.19.tgz",
-      "integrity": "sha512-rEvr90Bck4WZt9HHFC4DJMsjvu7x+r6bImz0/BrbWb7A2djJ8hnZMrWnHo9F8ssv0OMErasDhftrfROTyqSDrw==",
-      "dev": true,
-      "dependencies": {
-        "available-typed-arrays": "^1.0.7",
-        "call-bind": "^1.0.8",
-        "call-bound": "^1.0.4",
-        "for-each": "^0.3.5",
-        "get-proto": "^1.0.1",
-        "gopd": "^1.2.0",
-        "has-tostringtag": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/word-wrap": {
-      "version": "1.2.5",
-      "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz",
-      "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/yocto-queue": {
-      "version": "0.1.0",
-      "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",
-      "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==",
-      "dev": true,
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    }
-  }
-}
diff --git a/server/express/.gitignore b/server/express/.gitignore
index 8fa0429..d0ebe3f 100644
--- a/server/express/.gitignore
+++ b/server/express/.gitignore
@@ -12,5 +12,5 @@ build/
 # TypeScript
 *.tsbuildinfo
 
-# Package Lock (optional - remove this line if you want to commit package-lock.json)
-# package-lock.json
+# Package Lock
+package-lock.json
diff --git a/server/express/package-lock.json b/server/express/package-lock.json
deleted file mode 100644
index c9b2554..0000000
--- a/server/express/package-lock.json
+++ /dev/null
@@ -1,4748 +0,0 @@
-{
-  "name": "sample-mflix-express-backend",
-  "version": "1.0.0",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "": {
-      "name": "sample-mflix-express-backend",
-      "version": "1.0.0",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "cors": "^2.8.5",
-        "dotenv": "^16.3.1",
-        "express": "^5.1.0",
-        "mongodb": "^6.3.0"
-      },
-      "devDependencies": {
-        "@types/cors": "^2.8.17",
-        "@types/express": "^4.17.21",
-        "@types/jest": "^29.5.14",
-        "@types/node": "^20.10.5",
-        "jest": "^29.7.0",
-        "ts-jest": "^29.1.1",
-        "ts-node": "^10.9.2",
-        "typescript": "^5.3.3"
-      }
-    },
-    "node_modules/@babel/code-frame": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz",
-      "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-validator-identifier": "^7.27.1",
-        "js-tokens": "^4.0.0",
-        "picocolors": "^1.1.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/compat-data": {
-      "version": "7.28.4",
-      "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.4.tgz",
-      "integrity": "sha512-YsmSKC29MJwf0gF8Rjjrg5LQCmyh+j/nD8/eP7f+BeoQTKYqs9RoWbjGOdy0+1Ekr68RJZMUOPVQaQisnIo4Rw==",
-      "dev": true,
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/core": {
-      "version": "7.28.4",
-      "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.4.tgz",
-      "integrity": "sha512-2BCOP7TN8M+gVDj7/ht3hsaO/B/n5oDbiAyyvnRlNOs+u1o+JWNYTQrmpuNp1/Wq2gcFrI01JAW+paEKDMx/CA==",
-      "dev": true,
-      "dependencies": {
-        "@babel/code-frame": "^7.27.1",
-        "@babel/generator": "^7.28.3",
-        "@babel/helper-compilation-targets": "^7.27.2",
-        "@babel/helper-module-transforms": "^7.28.3",
-        "@babel/helpers": "^7.28.4",
-        "@babel/parser": "^7.28.4",
-        "@babel/template": "^7.27.2",
-        "@babel/traverse": "^7.28.4",
-        "@babel/types": "^7.28.4",
-        "@jridgewell/remapping": "^2.3.5",
-        "convert-source-map": "^2.0.0",
-        "debug": "^4.1.0",
-        "gensync": "^1.0.0-beta.2",
-        "json5": "^2.2.3",
-        "semver": "^6.3.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/babel"
-      }
-    },
-    "node_modules/@babel/generator": {
-      "version": "7.28.3",
-      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.3.tgz",
-      "integrity": "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw==",
-      "dev": true,
-      "dependencies": {
-        "@babel/parser": "^7.28.3",
-        "@babel/types": "^7.28.2",
-        "@jridgewell/gen-mapping": "^0.3.12",
-        "@jridgewell/trace-mapping": "^0.3.28",
-        "jsesc": "^3.0.2"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/generator/node_modules/@jridgewell/trace-mapping": {
-      "version": "0.3.31",
-      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
-      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
-      "dev": true,
-      "dependencies": {
-        "@jridgewell/resolve-uri": "^3.1.0",
-        "@jridgewell/sourcemap-codec": "^1.4.14"
-      }
-    },
-    "node_modules/@babel/helper-compilation-targets": {
-      "version": "7.27.2",
-      "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.2.tgz",
-      "integrity": "sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==",
-      "dev": true,
-      "dependencies": {
-        "@babel/compat-data": "^7.27.2",
-        "@babel/helper-validator-option": "^7.27.1",
-        "browserslist": "^4.24.0",
-        "lru-cache": "^5.1.1",
-        "semver": "^6.3.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helper-globals": {
-      "version": "7.28.0",
-      "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz",
-      "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==",
-      "dev": true,
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helper-module-imports": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.27.1.tgz",
-      "integrity": "sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==",
-      "dev": true,
-      "dependencies": {
-        "@babel/traverse": "^7.27.1",
-        "@babel/types": "^7.27.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helper-module-transforms": {
-      "version": "7.28.3",
-      "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.3.tgz",
-      "integrity": "sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-module-imports": "^7.27.1",
-        "@babel/helper-validator-identifier": "^7.27.1",
-        "@babel/traverse": "^7.28.3"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0"
-      }
-    },
-    "node_modules/@babel/helper-plugin-utils": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.27.1.tgz",
-      "integrity": "sha512-1gn1Up5YXka3YYAHGKpbideQ5Yjf1tDa9qYcgysz+cNCXukyLl6DjPXhD3VRwSb8c0J9tA4b2+rHEZtc6R0tlw==",
-      "dev": true,
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helper-string-parser": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz",
-      "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==",
-      "dev": true,
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helper-validator-identifier": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.27.1.tgz",
-      "integrity": "sha512-D2hP9eA+Sqx1kBZgzxZh0y1trbuU+JoDkiEwqhQ36nodYqJwyEIhPSdMNd7lOm/4io72luTPWH20Yda0xOuUow==",
-      "dev": true,
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helper-validator-option": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz",
-      "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==",
-      "dev": true,
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/helpers": {
-      "version": "7.28.4",
-      "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.4.tgz",
-      "integrity": "sha512-HFN59MmQXGHVyYadKLVumYsA9dBFun/ldYxipEjzA4196jpLZd8UjEEBLkbEkvfYreDqJhZxYAWFPtrfhNpj4w==",
-      "dev": true,
-      "dependencies": {
-        "@babel/template": "^7.27.2",
-        "@babel/types": "^7.28.4"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/parser": {
-      "version": "7.28.4",
-      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.4.tgz",
-      "integrity": "sha512-yZbBqeM6TkpP9du/I2pUZnJsRMGGvOuIrhjzC1AwHwW+6he4mni6Bp/m8ijn0iOuZuPI2BfkCoSRunpyjnrQKg==",
-      "dev": true,
-      "dependencies": {
-        "@babel/types": "^7.28.4"
-      },
-      "bin": {
-        "parser": "bin/babel-parser.js"
-      },
-      "engines": {
-        "node": ">=6.0.0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-async-generators": {
-      "version": "7.8.4",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-async-generators/-/plugin-syntax-async-generators-7.8.4.tgz",
-      "integrity": "sha512-tycmZxkGfZaxhMRbXlPXuVFpdWlXpir2W4AMhSJgRKzk/eDlIXOhb2LHWoLpDF7TEHylV5zNhykX6KAgHJmTNw==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.8.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-bigint": {
-      "version": "7.8.3",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-bigint/-/plugin-syntax-bigint-7.8.3.tgz",
-      "integrity": "sha512-wnTnFlG+YxQm3vDxpGE57Pj0srRU4sHE/mDkt1qv2YJJSeUAec2ma4WLUnUPeKjyrfntVwe/N6dCXpU+zL3Npg==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.8.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-class-properties": {
-      "version": "7.12.13",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-properties/-/plugin-syntax-class-properties-7.12.13.tgz",
-      "integrity": "sha512-fm4idjKla0YahUNgFNLCB0qySdsoPiZP3iQE3rky0mBUtMZ23yDJ9SJdg6dXTSDnulOVqiF3Hgr9nbXvXTQZYA==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.12.13"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-class-static-block": {
-      "version": "7.14.5",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-static-block/-/plugin-syntax-class-static-block-7.14.5.tgz",
-      "integrity": "sha512-b+YyPmr6ldyNnM6sqYeMWE+bgJcJpO6yS4QD7ymxgH34GBPNDM/THBh8iunyvKIZztiwLH4CJZ0RxTk9emgpjw==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.14.5"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-import-attributes": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.27.1.tgz",
-      "integrity": "sha512-oFT0FrKHgF53f4vOsZGi2Hh3I35PfSmVs4IBFLFj4dnafP+hIWDLg3VyKmUHfLoLHlyxY4C7DGtmHuJgn+IGww==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.27.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-import-meta": {
-      "version": "7.10.4",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-meta/-/plugin-syntax-import-meta-7.10.4.tgz",
-      "integrity": "sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.10.4"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-json-strings": {
-      "version": "7.8.3",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-json-strings/-/plugin-syntax-json-strings-7.8.3.tgz",
-      "integrity": "sha512-lY6kdGpWHvjoe2vk4WrAapEuBR69EMxZl+RoGRhrFGNYVK8mOPAW8VfbT/ZgrFbXlDNiiaxQnAtgVCZ6jv30EA==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.8.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-jsx": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.27.1.tgz",
-      "integrity": "sha512-y8YTNIeKoyhGd9O0Jiyzyyqk8gdjnumGTQPsz0xOZOQ2RmkVJeZ1vmmfIvFEKqucBG6axJGBZDE/7iI5suUI/w==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.27.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-logical-assignment-operators": {
-      "version": "7.10.4",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-logical-assignment-operators/-/plugin-syntax-logical-assignment-operators-7.10.4.tgz",
-      "integrity": "sha512-d8waShlpFDinQ5MtvGU9xDAOzKH47+FFoney2baFIoMr952hKOLp1HR7VszoZvOsV/4+RRszNY7D17ba0te0ig==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.10.4"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-nullish-coalescing-operator": {
-      "version": "7.8.3",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-nullish-coalescing-operator/-/plugin-syntax-nullish-coalescing-operator-7.8.3.tgz",
-      "integrity": "sha512-aSff4zPII1u2QD7y+F8oDsz19ew4IGEJg9SVW+bqwpwtfFleiQDMdzA/R+UlWDzfnHFCxxleFT0PMIrR36XLNQ==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.8.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-numeric-separator": {
-      "version": "7.10.4",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-numeric-separator/-/plugin-syntax-numeric-separator-7.10.4.tgz",
-      "integrity": "sha512-9H6YdfkcK/uOnY/K7/aA2xpzaAgkQn37yzWUMRK7OaPOqOpGS1+n0H5hxT9AUw9EsSjPW8SVyMJwYRtWs3X3ug==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.10.4"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-object-rest-spread": {
-      "version": "7.8.3",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-object-rest-spread/-/plugin-syntax-object-rest-spread-7.8.3.tgz",
-      "integrity": "sha512-XoqMijGZb9y3y2XskN+P1wUGiVwWZ5JmoDRwx5+3GmEplNyVM2s2Dg8ILFQm8rWM48orGy5YpI5Bl8U1y7ydlA==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.8.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-optional-catch-binding": {
-      "version": "7.8.3",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-catch-binding/-/plugin-syntax-optional-catch-binding-7.8.3.tgz",
-      "integrity": "sha512-6VPD0Pc1lpTqw0aKoeRTMiB+kWhAoT24PA+ksWSBrFtl5SIRVpZlwN3NNPQjehA2E/91FV3RjLWoVTglWcSV3Q==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.8.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-optional-chaining": {
-      "version": "7.8.3",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-chaining/-/plugin-syntax-optional-chaining-7.8.3.tgz",
-      "integrity": "sha512-KoK9ErH1MBlCPxV0VANkXW2/dw4vlbGDrFgz8bmUsBGYkFRcbRwMh6cIJubdPrkxRwuGdtCk0v/wPTKbQgBjkg==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.8.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-private-property-in-object": {
-      "version": "7.14.5",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-private-property-in-object/-/plugin-syntax-private-property-in-object-7.14.5.tgz",
-      "integrity": "sha512-0wVnp9dxJ72ZUJDV27ZfbSj6iHLoytYZmh3rFcxNnvsJF3ktkzLDZPy/mA17HGsaQT3/DQsWYX1f1QGWkCoVUg==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.14.5"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-top-level-await": {
-      "version": "7.14.5",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-top-level-await/-/plugin-syntax-top-level-await-7.14.5.tgz",
-      "integrity": "sha512-hx++upLv5U1rgYfwe1xBQUhRmU41NEvpUvrp8jkrSCdvGSnM5/qdRMtylJ6PG5OFkBaHkbTAKTnd3/YyESRHFw==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.14.5"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/plugin-syntax-typescript": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.27.1.tgz",
-      "integrity": "sha512-xfYCBMxveHrRMnAWl1ZlPXOZjzkN82THFvLhQhFXFt81Z5HnN+EtUkZhv/zcKpmT3fzmWZB0ywiBrbC3vogbwQ==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.27.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0-0"
-      }
-    },
-    "node_modules/@babel/template": {
-      "version": "7.27.2",
-      "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.27.2.tgz",
-      "integrity": "sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==",
-      "dev": true,
-      "dependencies": {
-        "@babel/code-frame": "^7.27.1",
-        "@babel/parser": "^7.27.2",
-        "@babel/types": "^7.27.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/traverse": {
-      "version": "7.28.4",
-      "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.4.tgz",
-      "integrity": "sha512-YEzuboP2qvQavAcjgQNVgsvHIDv6ZpwXvcvjmyySP2DIMuByS/6ioU5G9pYrWHM6T2YDfc7xga9iNzYOs12CFQ==",
-      "dev": true,
-      "dependencies": {
-        "@babel/code-frame": "^7.27.1",
-        "@babel/generator": "^7.28.3",
-        "@babel/helper-globals": "^7.28.0",
-        "@babel/parser": "^7.28.4",
-        "@babel/template": "^7.27.2",
-        "@babel/types": "^7.28.4",
-        "debug": "^4.3.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@babel/types": {
-      "version": "7.28.4",
-      "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.4.tgz",
-      "integrity": "sha512-bkFqkLhh3pMBUQQkpVgWDWq/lqzc2678eUyDlTBhRqhCHFguYYGM0Efga7tYk4TogG/3x0EEl66/OQ+WGbWB/Q==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-string-parser": "^7.27.1",
-        "@babel/helper-validator-identifier": "^7.27.1"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@bcoe/v8-coverage": {
-      "version": "0.2.3",
-      "resolved": "https://registry.npmjs.org/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz",
-      "integrity": "sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==",
-      "dev": true
-    },
-    "node_modules/@cspotcode/source-map-support": {
-      "version": "0.8.1",
-      "resolved": "https://registry.npmjs.org/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz",
-      "integrity": "sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==",
-      "dev": true,
-      "dependencies": {
-        "@jridgewell/trace-mapping": "0.3.9"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@istanbuljs/load-nyc-config": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/@istanbuljs/load-nyc-config/-/load-nyc-config-1.1.0.tgz",
-      "integrity": "sha512-VjeHSlIzpv/NyD3N0YuHfXOPDIixcA1q2ZV98wsMqcYlPmv2n3Yb2lYP9XMElnaFVXg5A7YLTeLu6V84uQDjmQ==",
-      "dev": true,
-      "dependencies": {
-        "camelcase": "^5.3.1",
-        "find-up": "^4.1.0",
-        "get-package-type": "^0.1.0",
-        "js-yaml": "^3.13.1",
-        "resolve-from": "^5.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/@istanbuljs/schema": {
-      "version": "0.1.3",
-      "resolved": "https://registry.npmjs.org/@istanbuljs/schema/-/schema-0.1.3.tgz",
-      "integrity": "sha512-ZXRY4jNvVgSVQ8DL3LTcakaAtXwTVUxE81hslsyD2AtoXW/wVob10HkOJ1X/pAlcI7D+2YoZKg5do8G/w6RYgA==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/@jest/console": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/@jest/console/-/console-29.7.0.tgz",
-      "integrity": "sha512-5Ni4CU7XHQi32IJ398EEP4RrB8eV09sXP2ROqD4bksHrnTree52PsxvX8tpL8LvTZ3pFzXyPbNQReSN41CAhOg==",
-      "dev": true,
-      "dependencies": {
-        "@jest/types": "^29.6.3",
-        "@types/node": "*",
-        "chalk": "^4.0.0",
-        "jest-message-util": "^29.7.0",
-        "jest-util": "^29.7.0",
-        "slash": "^3.0.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/@jest/core": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/@jest/core/-/core-29.7.0.tgz",
-      "integrity": "sha512-n7aeXWKMnGtDA48y8TLWJPJmLmmZ642Ceo78cYWEpiD7FzDgmNDV/GCVRorPABdXLJZ/9wzzgZAlHjXjxDHGsg==",
-      "dev": true,
-      "dependencies": {
-        "@jest/console": "^29.7.0",
-        "@jest/reporters": "^29.7.0",
-        "@jest/test-result": "^29.7.0",
-        "@jest/transform": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "@types/node": "*",
-        "ansi-escapes": "^4.2.1",
-        "chalk": "^4.0.0",
-        "ci-info": "^3.2.0",
-        "exit": "^0.1.2",
-        "graceful-fs": "^4.2.9",
-        "jest-changed-files": "^29.7.0",
-        "jest-config": "^29.7.0",
-        "jest-haste-map": "^29.7.0",
-        "jest-message-util": "^29.7.0",
-        "jest-regex-util": "^29.6.3",
-        "jest-resolve": "^29.7.0",
-        "jest-resolve-dependencies": "^29.7.0",
-        "jest-runner": "^29.7.0",
-        "jest-runtime": "^29.7.0",
-        "jest-snapshot": "^29.7.0",
-        "jest-util": "^29.7.0",
-        "jest-validate": "^29.7.0",
-        "jest-watcher": "^29.7.0",
-        "micromatch": "^4.0.4",
-        "pretty-format": "^29.7.0",
-        "slash": "^3.0.0",
-        "strip-ansi": "^6.0.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      },
-      "peerDependencies": {
-        "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0"
-      },
-      "peerDependenciesMeta": {
-        "node-notifier": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/@jest/environment": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/@jest/environment/-/environment-29.7.0.tgz",
-      "integrity": "sha512-aQIfHDq33ExsN4jP1NWGXhxgQ/wixs60gDiKO+XVMd8Mn0NWPWgc34ZQDTb2jKaUWQ7MuwoitXAsN2XVXNMpAw==",
-      "dev": true,
-      "dependencies": {
-        "@jest/fake-timers": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "@types/node": "*",
-        "jest-mock": "^29.7.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/@jest/expect": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/@jest/expect/-/expect-29.7.0.tgz",
-      "integrity": "sha512-8uMeAMycttpva3P1lBHB8VciS9V0XAr3GymPpipdyQXbBcuhkLQOSe8E/p92RyAdToS6ZD1tFkX+CkhoECE0dQ==",
-      "dev": true,
-      "dependencies": {
-        "expect": "^29.7.0",
-        "jest-snapshot": "^29.7.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/@jest/expect-utils": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/@jest/expect-utils/-/expect-utils-29.7.0.tgz",
-      "integrity": "sha512-GlsNBWiFQFCVi9QVSx7f5AgMeLxe9YCCs5PuP2O2LdjDAA8Jh9eX7lA1Jq/xdXw3Wb3hyvlFNfZIfcRetSzYcA==",
-      "dev": true,
-      "dependencies": {
-        "jest-get-type": "^29.6.3"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/@jest/fake-timers": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/@jest/fake-timers/-/fake-timers-29.7.0.tgz",
-      "integrity": "sha512-q4DH1Ha4TTFPdxLsqDXK1d3+ioSL7yL5oCMJZgDYm6i+6CygW5E5xVr/D1HdsGxjt1ZWSfUAs9OxSB/BNelWrQ==",
-      "dev": true,
-      "dependencies": {
-        "@jest/types": "^29.6.3",
-        "@sinonjs/fake-timers": "^10.0.2",
-        "@types/node": "*",
-        "jest-message-util": "^29.7.0",
-        "jest-mock": "^29.7.0",
-        "jest-util": "^29.7.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/@jest/globals": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/@jest/globals/-/globals-29.7.0.tgz",
-      "integrity": "sha512-mpiz3dutLbkW2MNFubUGUEVLkTGiqW6yLVTA+JbP6fI6J5iL9Y0Nlg8k95pcF8ctKwCS7WVxteBs29hhfAotzQ==",
-      "dev": true,
-      "dependencies": {
-        "@jest/environment": "^29.7.0",
-        "@jest/expect": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "jest-mock": "^29.7.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/@jest/reporters": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/@jest/reporters/-/reporters-29.7.0.tgz",
-      "integrity": "sha512-DApq0KJbJOEzAFYjHADNNxAE3KbhxQB1y5Kplb5Waqw6zVbuWatSnMjE5gs8FUgEPmNsnZA3NCWl9NG0ia04Pg==",
-      "dev": true,
-      "dependencies": {
-        "@bcoe/v8-coverage": "^0.2.3",
-        "@jest/console": "^29.7.0",
-        "@jest/test-result": "^29.7.0",
-        "@jest/transform": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "@jridgewell/trace-mapping": "^0.3.18",
-        "@types/node": "*",
-        "chalk": "^4.0.0",
-        "collect-v8-coverage": "^1.0.0",
-        "exit": "^0.1.2",
-        "glob": "^7.1.3",
-        "graceful-fs": "^4.2.9",
-        "istanbul-lib-coverage": "^3.0.0",
-        "istanbul-lib-instrument": "^6.0.0",
-        "istanbul-lib-report": "^3.0.0",
-        "istanbul-lib-source-maps": "^4.0.0",
-        "istanbul-reports": "^3.1.3",
-        "jest-message-util": "^29.7.0",
-        "jest-util": "^29.7.0",
-        "jest-worker": "^29.7.0",
-        "slash": "^3.0.0",
-        "string-length": "^4.0.1",
-        "strip-ansi": "^6.0.0",
-        "v8-to-istanbul": "^9.0.1"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      },
-      "peerDependencies": {
-        "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0"
-      },
-      "peerDependenciesMeta": {
-        "node-notifier": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/@jest/reporters/node_modules/@jridgewell/trace-mapping": {
-      "version": "0.3.31",
-      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
-      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
-      "dev": true,
-      "dependencies": {
-        "@jridgewell/resolve-uri": "^3.1.0",
-        "@jridgewell/sourcemap-codec": "^1.4.14"
-      }
-    },
-    "node_modules/@jest/schemas": {
-      "version": "29.6.3",
-      "resolved": "https://registry.npmjs.org/@jest/schemas/-/schemas-29.6.3.tgz",
-      "integrity": "sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==",
-      "dev": true,
-      "dependencies": {
-        "@sinclair/typebox": "^0.27.8"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/@jest/source-map": {
-      "version": "29.6.3",
-      "resolved": "https://registry.npmjs.org/@jest/source-map/-/source-map-29.6.3.tgz",
-      "integrity": "sha512-MHjT95QuipcPrpLM+8JMSzFx6eHp5Bm+4XeFDJlwsvVBjmKNiIAvasGK2fxz2WbGRlnvqehFbh07MMa7n3YJnw==",
-      "dev": true,
-      "dependencies": {
-        "@jridgewell/trace-mapping": "^0.3.18",
-        "callsites": "^3.0.0",
-        "graceful-fs": "^4.2.9"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/@jest/source-map/node_modules/@jridgewell/trace-mapping": {
-      "version": "0.3.31",
-      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
-      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
-      "dev": true,
-      "dependencies": {
-        "@jridgewell/resolve-uri": "^3.1.0",
-        "@jridgewell/sourcemap-codec": "^1.4.14"
-      }
-    },
-    "node_modules/@jest/test-result": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/@jest/test-result/-/test-result-29.7.0.tgz",
-      "integrity": "sha512-Fdx+tv6x1zlkJPcWXmMDAG2HBnaR9XPSd5aDWQVsfrZmLVT3lU1cwyxLgRmXR9yrq4NBoEm9BMsfgFzTQAbJYA==",
-      "dev": true,
-      "dependencies": {
-        "@jest/console": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "@types/istanbul-lib-coverage": "^2.0.0",
-        "collect-v8-coverage": "^1.0.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/@jest/test-sequencer": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/@jest/test-sequencer/-/test-sequencer-29.7.0.tgz",
-      "integrity": "sha512-GQwJ5WZVrKnOJuiYiAF52UNUJXgTZx1NHjFSEB0qEMmSZKAkdMoIzw/Cj6x6NF4AvV23AUqDpFzQkN/eYCYTxw==",
-      "dev": true,
-      "dependencies": {
-        "@jest/test-result": "^29.7.0",
-        "graceful-fs": "^4.2.9",
-        "jest-haste-map": "^29.7.0",
-        "slash": "^3.0.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/@jest/transform": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/@jest/transform/-/transform-29.7.0.tgz",
-      "integrity": "sha512-ok/BTPFzFKVMwO5eOHRrvnBVHdRy9IrsrW1GpMaQ9MCnilNLXQKmAX8s1YXDFaai9xJpac2ySzV0YeRRECr2Vw==",
-      "dev": true,
-      "dependencies": {
-        "@babel/core": "^7.11.6",
-        "@jest/types": "^29.6.3",
-        "@jridgewell/trace-mapping": "^0.3.18",
-        "babel-plugin-istanbul": "^6.1.1",
-        "chalk": "^4.0.0",
-        "convert-source-map": "^2.0.0",
-        "fast-json-stable-stringify": "^2.1.0",
-        "graceful-fs": "^4.2.9",
-        "jest-haste-map": "^29.7.0",
-        "jest-regex-util": "^29.6.3",
-        "jest-util": "^29.7.0",
-        "micromatch": "^4.0.4",
-        "pirates": "^4.0.4",
-        "slash": "^3.0.0",
-        "write-file-atomic": "^4.0.2"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/@jest/transform/node_modules/@jridgewell/trace-mapping": {
-      "version": "0.3.31",
-      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
-      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
-      "dev": true,
-      "dependencies": {
-        "@jridgewell/resolve-uri": "^3.1.0",
-        "@jridgewell/sourcemap-codec": "^1.4.14"
-      }
-    },
-    "node_modules/@jest/types": {
-      "version": "29.6.3",
-      "resolved": "https://registry.npmjs.org/@jest/types/-/types-29.6.3.tgz",
-      "integrity": "sha512-u3UPsIilWKOM3F9CXtrG8LEJmNxwoCQC/XVj4IKYXvvpx7QIi/Kg1LI5uDmDpKlac62NUtX7eLjRh+jVZcLOzw==",
-      "dev": true,
-      "dependencies": {
-        "@jest/schemas": "^29.6.3",
-        "@types/istanbul-lib-coverage": "^2.0.0",
-        "@types/istanbul-reports": "^3.0.0",
-        "@types/node": "*",
-        "@types/yargs": "^17.0.8",
-        "chalk": "^4.0.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/@jridgewell/gen-mapping": {
-      "version": "0.3.13",
-      "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz",
-      "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==",
-      "dev": true,
-      "dependencies": {
-        "@jridgewell/sourcemap-codec": "^1.5.0",
-        "@jridgewell/trace-mapping": "^0.3.24"
-      }
-    },
-    "node_modules/@jridgewell/gen-mapping/node_modules/@jridgewell/trace-mapping": {
-      "version": "0.3.31",
-      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
-      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
-      "dev": true,
-      "dependencies": {
-        "@jridgewell/resolve-uri": "^3.1.0",
-        "@jridgewell/sourcemap-codec": "^1.4.14"
-      }
-    },
-    "node_modules/@jridgewell/remapping": {
-      "version": "2.3.5",
-      "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz",
-      "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==",
-      "dev": true,
-      "dependencies": {
-        "@jridgewell/gen-mapping": "^0.3.5",
-        "@jridgewell/trace-mapping": "^0.3.24"
-      }
-    },
-    "node_modules/@jridgewell/remapping/node_modules/@jridgewell/trace-mapping": {
-      "version": "0.3.31",
-      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
-      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
-      "dev": true,
-      "dependencies": {
-        "@jridgewell/resolve-uri": "^3.1.0",
-        "@jridgewell/sourcemap-codec": "^1.4.14"
-      }
-    },
-    "node_modules/@jridgewell/resolve-uri": {
-      "version": "3.1.2",
-      "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
-      "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
-      "dev": true,
-      "engines": {
-        "node": ">=6.0.0"
-      }
-    },
-    "node_modules/@jridgewell/sourcemap-codec": {
-      "version": "1.5.5",
-      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
-      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
-      "dev": true
-    },
-    "node_modules/@jridgewell/trace-mapping": {
-      "version": "0.3.9",
-      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz",
-      "integrity": "sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==",
-      "dev": true,
-      "dependencies": {
-        "@jridgewell/resolve-uri": "^3.0.3",
-        "@jridgewell/sourcemap-codec": "^1.4.10"
-      }
-    },
-    "node_modules/@mongodb-js/saslprep": {
-      "version": "1.3.1",
-      "resolved": "https://registry.npmjs.org/@mongodb-js/saslprep/-/saslprep-1.3.1.tgz",
-      "integrity": "sha512-6nZrq5kfAz0POWyhljnbWQQJQ5uT8oE2ddX303q1uY0tWsivWKgBDXBBvuFPwOqRRalXJuVO9EjOdVtuhLX0zg==",
-      "dependencies": {
-        "sparse-bitfield": "^3.0.3"
-      }
-    },
-    "node_modules/@sinclair/typebox": {
-      "version": "0.27.8",
-      "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.8.tgz",
-      "integrity": "sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA==",
-      "dev": true
-    },
-    "node_modules/@sinonjs/commons": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/@sinonjs/commons/-/commons-3.0.1.tgz",
-      "integrity": "sha512-K3mCHKQ9sVh8o1C9cxkwxaOmXoAMlDxC1mYyHrjqOWEcBjYr76t96zL2zlj5dUGZ3HSw240X1qgH3Mjf1yJWpQ==",
-      "dev": true,
-      "dependencies": {
-        "type-detect": "4.0.8"
-      }
-    },
-    "node_modules/@sinonjs/fake-timers": {
-      "version": "10.3.0",
-      "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-10.3.0.tgz",
-      "integrity": "sha512-V4BG07kuYSUkTCSBHG8G8TNhM+F19jXFWnQtzj+we8DrkpSBCee9Z3Ms8yiGer/dlmhe35/Xdgyo3/0rQKg7YA==",
-      "dev": true,
-      "dependencies": {
-        "@sinonjs/commons": "^3.0.0"
-      }
-    },
-    "node_modules/@tsconfig/node10": {
-      "version": "1.0.11",
-      "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.11.tgz",
-      "integrity": "sha512-DcRjDCujK/kCk/cUe8Xz8ZSpm8mS3mNNpta+jGCA6USEDfktlNvm1+IuZ9eTcDbNk41BHwpHHeW+N1lKCz4zOw==",
-      "dev": true
-    },
-    "node_modules/@tsconfig/node12": {
-      "version": "1.0.11",
-      "resolved": "https://registry.npmjs.org/@tsconfig/node12/-/node12-1.0.11.tgz",
-      "integrity": "sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==",
-      "dev": true
-    },
-    "node_modules/@tsconfig/node14": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/@tsconfig/node14/-/node14-1.0.3.tgz",
-      "integrity": "sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==",
-      "dev": true
-    },
-    "node_modules/@tsconfig/node16": {
-      "version": "1.0.4",
-      "resolved": "https://registry.npmjs.org/@tsconfig/node16/-/node16-1.0.4.tgz",
-      "integrity": "sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==",
-      "dev": true
-    },
-    "node_modules/@types/babel__core": {
-      "version": "7.20.5",
-      "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz",
-      "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==",
-      "dev": true,
-      "dependencies": {
-        "@babel/parser": "^7.20.7",
-        "@babel/types": "^7.20.7",
-        "@types/babel__generator": "*",
-        "@types/babel__template": "*",
-        "@types/babel__traverse": "*"
-      }
-    },
-    "node_modules/@types/babel__generator": {
-      "version": "7.27.0",
-      "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.27.0.tgz",
-      "integrity": "sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==",
-      "dev": true,
-      "dependencies": {
-        "@babel/types": "^7.0.0"
-      }
-    },
-    "node_modules/@types/babel__template": {
-      "version": "7.4.4",
-      "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz",
-      "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==",
-      "dev": true,
-      "dependencies": {
-        "@babel/parser": "^7.1.0",
-        "@babel/types": "^7.0.0"
-      }
-    },
-    "node_modules/@types/babel__traverse": {
-      "version": "7.28.0",
-      "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.28.0.tgz",
-      "integrity": "sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==",
-      "dev": true,
-      "dependencies": {
-        "@babel/types": "^7.28.2"
-      }
-    },
-    "node_modules/@types/body-parser": {
-      "version": "1.19.6",
-      "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.6.tgz",
-      "integrity": "sha512-HLFeCYgz89uk22N5Qg3dvGvsv46B8GLvKKo1zKG4NybA8U2DiEO3w9lqGg29t/tfLRJpJ6iQxnVw4OnB7MoM9g==",
-      "dev": true,
-      "dependencies": {
-        "@types/connect": "*",
-        "@types/node": "*"
-      }
-    },
-    "node_modules/@types/connect": {
-      "version": "3.4.38",
-      "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.38.tgz",
-      "integrity": "sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==",
-      "dev": true,
-      "dependencies": {
-        "@types/node": "*"
-      }
-    },
-    "node_modules/@types/cors": {
-      "version": "2.8.19",
-      "resolved": "https://registry.npmjs.org/@types/cors/-/cors-2.8.19.tgz",
-      "integrity": "sha512-mFNylyeyqN93lfe/9CSxOGREz8cpzAhH+E93xJ4xWQf62V8sQ/24reV2nyzUWM6H6Xji+GGHpkbLe7pVoUEskg==",
-      "dev": true,
-      "dependencies": {
-        "@types/node": "*"
-      }
-    },
-    "node_modules/@types/express": {
-      "version": "4.17.23",
-      "resolved": "https://registry.npmjs.org/@types/express/-/express-4.17.23.tgz",
-      "integrity": "sha512-Crp6WY9aTYP3qPi2wGDo9iUe/rceX01UMhnF1jmwDcKCFM6cx7YhGP/Mpr3y9AASpfHixIG0E6azCcL5OcDHsQ==",
-      "dev": true,
-      "dependencies": {
-        "@types/body-parser": "*",
-        "@types/express-serve-static-core": "^4.17.33",
-        "@types/qs": "*",
-        "@types/serve-static": "*"
-      }
-    },
-    "node_modules/@types/express-serve-static-core": {
-      "version": "4.19.7",
-      "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-4.19.7.tgz",
-      "integrity": "sha512-FvPtiIf1LfhzsaIXhv/PHan/2FeQBbtBDtfX2QfvPxdUelMDEckK08SM6nqo1MIZY3RUlfA+HV8+hFUSio78qg==",
-      "dev": true,
-      "dependencies": {
-        "@types/node": "*",
-        "@types/qs": "*",
-        "@types/range-parser": "*",
-        "@types/send": "*"
-      }
-    },
-    "node_modules/@types/graceful-fs": {
-      "version": "4.1.9",
-      "resolved": "https://registry.npmjs.org/@types/graceful-fs/-/graceful-fs-4.1.9.tgz",
-      "integrity": "sha512-olP3sd1qOEe5dXTSaFvQG+02VdRXcdytWLAZsAq1PecU8uqQAhkrnbli7DagjtXKW/Bl7YJbUsa8MPcuc8LHEQ==",
-      "dev": true,
-      "dependencies": {
-        "@types/node": "*"
-      }
-    },
-    "node_modules/@types/http-errors": {
-      "version": "2.0.5",
-      "resolved": "https://registry.npmjs.org/@types/http-errors/-/http-errors-2.0.5.tgz",
-      "integrity": "sha512-r8Tayk8HJnX0FztbZN7oVqGccWgw98T/0neJphO91KkmOzug1KkofZURD4UaD5uH8AqcFLfdPErnBod0u71/qg==",
-      "dev": true
-    },
-    "node_modules/@types/istanbul-lib-coverage": {
-      "version": "2.0.6",
-      "resolved": "https://registry.npmjs.org/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.6.tgz",
-      "integrity": "sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==",
-      "dev": true
-    },
-    "node_modules/@types/istanbul-lib-report": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/@types/istanbul-lib-report/-/istanbul-lib-report-3.0.3.tgz",
-      "integrity": "sha512-NQn7AHQnk/RSLOxrBbGyJM/aVQ+pjj5HCgasFxc0K/KhoATfQ/47AyUl15I2yBUpihjmas+a+VJBOqecrFH+uA==",
-      "dev": true,
-      "dependencies": {
-        "@types/istanbul-lib-coverage": "*"
-      }
-    },
-    "node_modules/@types/istanbul-reports": {
-      "version": "3.0.4",
-      "resolved": "https://registry.npmjs.org/@types/istanbul-reports/-/istanbul-reports-3.0.4.tgz",
-      "integrity": "sha512-pk2B1NWalF9toCRu6gjBzR69syFjP4Od8WRAX+0mmf9lAjCRicLOWc+ZrxZHx/0XRjotgkF9t6iaMJ+aXcOdZQ==",
-      "dev": true,
-      "dependencies": {
-        "@types/istanbul-lib-report": "*"
-      }
-    },
-    "node_modules/@types/jest": {
-      "version": "29.5.14",
-      "resolved": "https://registry.npmjs.org/@types/jest/-/jest-29.5.14.tgz",
-      "integrity": "sha512-ZN+4sdnLUbo8EVvVc2ao0GFW6oVrQRPn4K2lglySj7APvSrgzxHiNNK99us4WDMi57xxA2yggblIAMNhXOotLQ==",
-      "dev": true,
-      "dependencies": {
-        "expect": "^29.0.0",
-        "pretty-format": "^29.0.0"
-      }
-    },
-    "node_modules/@types/mime": {
-      "version": "1.3.5",
-      "resolved": "https://registry.npmjs.org/@types/mime/-/mime-1.3.5.tgz",
-      "integrity": "sha512-/pyBZWSLD2n0dcHE3hq8s8ZvcETHtEuF+3E7XVt0Ig2nvsVQXdghHVcEkIWjy9A0wKfTn97a/PSDYohKIlnP/w==",
-      "dev": true
-    },
-    "node_modules/@types/node": {
-      "version": "20.19.20",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.20.tgz",
-      "integrity": "sha512-2Q7WS25j4pS1cS8yw3d6buNCVJukOTeQ39bAnwR6sOJbaxvyCGebzTMypDFN82CxBLnl+lSWVdCCWbRY6y9yZQ==",
-      "dev": true,
-      "dependencies": {
-        "undici-types": "~6.21.0"
-      }
-    },
-    "node_modules/@types/qs": {
-      "version": "6.14.0",
-      "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.14.0.tgz",
-      "integrity": "sha512-eOunJqu0K1923aExK6y8p6fsihYEn/BYuQ4g0CxAAgFc4b/ZLN4CrsRZ55srTdqoiLzU2B2evC+apEIxprEzkQ==",
-      "dev": true
-    },
-    "node_modules/@types/range-parser": {
-      "version": "1.2.7",
-      "resolved": "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.7.tgz",
-      "integrity": "sha512-hKormJbkJqzQGhziax5PItDUTMAM9uE2XXQmM37dyd4hVM+5aVl7oVxMVUiVQn2oCQFN/LKCZdvSM0pFRqbSmQ==",
-      "dev": true
-    },
-    "node_modules/@types/send": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/@types/send/-/send-1.2.0.tgz",
-      "integrity": "sha512-zBF6vZJn1IaMpg3xUF25VK3gd3l8zwE0ZLRX7dsQyQi+jp4E8mMDJNGDYnYse+bQhYwWERTxVwHpi3dMOq7RKQ==",
-      "dev": true,
-      "dependencies": {
-        "@types/node": "*"
-      }
-    },
-    "node_modules/@types/serve-static": {
-      "version": "1.15.9",
-      "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-1.15.9.tgz",
-      "integrity": "sha512-dOTIuqpWLyl3BBXU3maNQsS4A3zuuoYRNIvYSxxhebPfXg2mzWQEPne/nlJ37yOse6uGgR386uTpdsx4D0QZWA==",
-      "dev": true,
-      "dependencies": {
-        "@types/http-errors": "*",
-        "@types/node": "*",
-        "@types/send": "<1"
-      }
-    },
-    "node_modules/@types/serve-static/node_modules/@types/send": {
-      "version": "0.17.5",
-      "resolved": "https://registry.npmjs.org/@types/send/-/send-0.17.5.tgz",
-      "integrity": "sha512-z6F2D3cOStZvuk2SaP6YrwkNO65iTZcwA2ZkSABegdkAh/lf+Aa/YQndZVfmEXT5vgAp6zv06VQ3ejSVjAny4w==",
-      "dev": true,
-      "dependencies": {
-        "@types/mime": "^1",
-        "@types/node": "*"
-      }
-    },
-    "node_modules/@types/stack-utils": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/@types/stack-utils/-/stack-utils-2.0.3.tgz",
-      "integrity": "sha512-9aEbYZ3TbYMznPdcdr3SmIrLXwC/AKZXQeCf9Pgao5CKb8CyHuEX5jzWPTkvregvhRJHcpRO6BFoGW9ycaOkYw==",
-      "dev": true
-    },
-    "node_modules/@types/webidl-conversions": {
-      "version": "7.0.3",
-      "resolved": "https://registry.npmjs.org/@types/webidl-conversions/-/webidl-conversions-7.0.3.tgz",
-      "integrity": "sha512-CiJJvcRtIgzadHCYXw7dqEnMNRjhGZlYK05Mj9OyktqV8uVT8fD2BFOB7S1uwBE3Kj2Z+4UyPmFw/Ixgw/LAlA=="
-    },
-    "node_modules/@types/whatwg-url": {
-      "version": "11.0.5",
-      "resolved": "https://registry.npmjs.org/@types/whatwg-url/-/whatwg-url-11.0.5.tgz",
-      "integrity": "sha512-coYR071JRaHa+xoEvvYqvnIHaVqaYrLPbsufM9BF63HkwI5Lgmy2QR8Q5K/lYDYo5AK82wOvSOS0UsLTpTG7uQ==",
-      "dependencies": {
-        "@types/webidl-conversions": "*"
-      }
-    },
-    "node_modules/@types/yargs": {
-      "version": "17.0.33",
-      "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.33.tgz",
-      "integrity": "sha512-WpxBCKWPLr4xSsHgz511rFJAM+wS28w2zEO1QDNY5zM/S8ok70NNfztH0xwhqKyaK0OHCbN98LDAZuy1ctxDkA==",
-      "dev": true,
-      "dependencies": {
-        "@types/yargs-parser": "*"
-      }
-    },
-    "node_modules/@types/yargs-parser": {
-      "version": "21.0.3",
-      "resolved": "https://registry.npmjs.org/@types/yargs-parser/-/yargs-parser-21.0.3.tgz",
-      "integrity": "sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ==",
-      "dev": true
-    },
-    "node_modules/accepts": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz",
-      "integrity": "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==",
-      "dependencies": {
-        "mime-types": "^3.0.0",
-        "negotiator": "^1.0.0"
-      },
-      "engines": {
-        "node": ">= 0.6"
-      }
-    },
-    "node_modules/acorn": {
-      "version": "8.15.0",
-      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz",
-      "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
-      "dev": true,
-      "bin": {
-        "acorn": "bin/acorn"
-      },
-      "engines": {
-        "node": ">=0.4.0"
-      }
-    },
-    "node_modules/acorn-walk": {
-      "version": "8.3.4",
-      "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.4.tgz",
-      "integrity": "sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==",
-      "dev": true,
-      "dependencies": {
-        "acorn": "^8.11.0"
-      },
-      "engines": {
-        "node": ">=0.4.0"
-      }
-    },
-    "node_modules/ansi-escapes": {
-      "version": "4.3.2",
-      "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-4.3.2.tgz",
-      "integrity": "sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==",
-      "dev": true,
-      "dependencies": {
-        "type-fest": "^0.21.3"
-      },
-      "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/ansi-regex": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
-      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/ansi-styles": {
-      "version": "4.3.0",
-      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
-      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
-      "dev": true,
-      "dependencies": {
-        "color-convert": "^2.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
-      }
-    },
-    "node_modules/anymatch": {
-      "version": "3.1.3",
-      "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz",
-      "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==",
-      "dev": true,
-      "dependencies": {
-        "normalize-path": "^3.0.0",
-        "picomatch": "^2.0.4"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/arg": {
-      "version": "4.1.3",
-      "resolved": "https://registry.npmjs.org/arg/-/arg-4.1.3.tgz",
-      "integrity": "sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==",
-      "dev": true
-    },
-    "node_modules/argparse": {
-      "version": "1.0.10",
-      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
-      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
-      "dev": true,
-      "dependencies": {
-        "sprintf-js": "~1.0.2"
-      }
-    },
-    "node_modules/babel-jest": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/babel-jest/-/babel-jest-29.7.0.tgz",
-      "integrity": "sha512-BrvGY3xZSwEcCzKvKsCi2GgHqDqsYkOP4/by5xCgIwGXQxIEh+8ew3gmrE1y7XRR6LHZIj6yLYnUi/mm2KXKBg==",
-      "dev": true,
-      "dependencies": {
-        "@jest/transform": "^29.7.0",
-        "@types/babel__core": "^7.1.14",
-        "babel-plugin-istanbul": "^6.1.1",
-        "babel-preset-jest": "^29.6.3",
-        "chalk": "^4.0.0",
-        "graceful-fs": "^4.2.9",
-        "slash": "^3.0.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.8.0"
-      }
-    },
-    "node_modules/babel-plugin-istanbul": {
-      "version": "6.1.1",
-      "resolved": "https://registry.npmjs.org/babel-plugin-istanbul/-/babel-plugin-istanbul-6.1.1.tgz",
-      "integrity": "sha512-Y1IQok9821cC9onCx5otgFfRm7Lm+I+wwxOx738M/WLPZ9Q42m4IG5W0FNX8WLL2gYMZo3JkuXIH2DOpWM+qwA==",
-      "dev": true,
-      "dependencies": {
-        "@babel/helper-plugin-utils": "^7.0.0",
-        "@istanbuljs/load-nyc-config": "^1.0.0",
-        "@istanbuljs/schema": "^0.1.2",
-        "istanbul-lib-instrument": "^5.0.4",
-        "test-exclude": "^6.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/babel-plugin-istanbul/node_modules/istanbul-lib-instrument": {
-      "version": "5.2.1",
-      "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-5.2.1.tgz",
-      "integrity": "sha512-pzqtp31nLv/XFOzXGuvhCb8qhjmTVo5vjVk19XE4CRlSWz0KoeJ3bw9XsA7nOp9YBf4qHjwBxkDzKcME/J29Yg==",
-      "dev": true,
-      "dependencies": {
-        "@babel/core": "^7.12.3",
-        "@babel/parser": "^7.14.7",
-        "@istanbuljs/schema": "^0.1.2",
-        "istanbul-lib-coverage": "^3.2.0",
-        "semver": "^6.3.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/babel-plugin-jest-hoist": {
-      "version": "29.6.3",
-      "resolved": "https://registry.npmjs.org/babel-plugin-jest-hoist/-/babel-plugin-jest-hoist-29.6.3.tgz",
-      "integrity": "sha512-ESAc/RJvGTFEzRwOTT4+lNDk/GNHMkKbNzsvT0qKRfDyyYTskxB5rnU2njIDYVxXCBHHEI1c0YwHob3WaYujOg==",
-      "dev": true,
-      "dependencies": {
-        "@babel/template": "^7.3.3",
-        "@babel/types": "^7.3.3",
-        "@types/babel__core": "^7.1.14",
-        "@types/babel__traverse": "^7.0.6"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/babel-preset-current-node-syntax": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/babel-preset-current-node-syntax/-/babel-preset-current-node-syntax-1.2.0.tgz",
-      "integrity": "sha512-E/VlAEzRrsLEb2+dv8yp3bo4scof3l9nR4lrld+Iy5NyVqgVYUJnDAmunkhPMisRI32Qc4iRiz425d8vM++2fg==",
-      "dev": true,
-      "dependencies": {
-        "@babel/plugin-syntax-async-generators": "^7.8.4",
-        "@babel/plugin-syntax-bigint": "^7.8.3",
-        "@babel/plugin-syntax-class-properties": "^7.12.13",
-        "@babel/plugin-syntax-class-static-block": "^7.14.5",
-        "@babel/plugin-syntax-import-attributes": "^7.24.7",
-        "@babel/plugin-syntax-import-meta": "^7.10.4",
-        "@babel/plugin-syntax-json-strings": "^7.8.3",
-        "@babel/plugin-syntax-logical-assignment-operators": "^7.10.4",
-        "@babel/plugin-syntax-nullish-coalescing-operator": "^7.8.3",
-        "@babel/plugin-syntax-numeric-separator": "^7.10.4",
-        "@babel/plugin-syntax-object-rest-spread": "^7.8.3",
-        "@babel/plugin-syntax-optional-catch-binding": "^7.8.3",
-        "@babel/plugin-syntax-optional-chaining": "^7.8.3",
-        "@babel/plugin-syntax-private-property-in-object": "^7.14.5",
-        "@babel/plugin-syntax-top-level-await": "^7.14.5"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0 || ^8.0.0-0"
-      }
-    },
-    "node_modules/babel-preset-jest": {
-      "version": "29.6.3",
-      "resolved": "https://registry.npmjs.org/babel-preset-jest/-/babel-preset-jest-29.6.3.tgz",
-      "integrity": "sha512-0B3bhxR6snWXJZtR/RliHTDPRgn1sNHOR0yVtq/IiQFyuOVjFS+wuio/R4gSNkyYmKmJB4wGZv2NZanmKmTnNA==",
-      "dev": true,
-      "dependencies": {
-        "babel-plugin-jest-hoist": "^29.6.3",
-        "babel-preset-current-node-syntax": "^1.0.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      },
-      "peerDependencies": {
-        "@babel/core": "^7.0.0"
-      }
-    },
-    "node_modules/balanced-match": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
-      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
-      "dev": true
-    },
-    "node_modules/baseline-browser-mapping": {
-      "version": "2.8.16",
-      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.8.16.tgz",
-      "integrity": "sha512-OMu3BGQ4E7P1ErFsIPpbJh0qvDudM/UuJeHgkAvfWe+0HFJCXh+t/l8L6fVLR55RI/UbKrVLnAXZSVwd9ysWYw==",
-      "dev": true,
-      "bin": {
-        "baseline-browser-mapping": "dist/cli.js"
-      }
-    },
-    "node_modules/body-parser": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-2.2.0.tgz",
-      "integrity": "sha512-02qvAaxv8tp7fBa/mw1ga98OGm+eCbqzJOKoRt70sLmfEEi+jyBYVTDGfCL/k06/4EMk/z01gCe7HoCH/f2LTg==",
-      "dependencies": {
-        "bytes": "^3.1.2",
-        "content-type": "^1.0.5",
-        "debug": "^4.4.0",
-        "http-errors": "^2.0.0",
-        "iconv-lite": "^0.6.3",
-        "on-finished": "^2.4.1",
-        "qs": "^6.14.0",
-        "raw-body": "^3.0.0",
-        "type-is": "^2.0.0"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/brace-expansion": {
-      "version": "1.1.12",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
-      "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
-      "dev": true,
-      "dependencies": {
-        "balanced-match": "^1.0.0",
-        "concat-map": "0.0.1"
-      }
-    },
-    "node_modules/braces": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
-      "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
-      "dev": true,
-      "dependencies": {
-        "fill-range": "^7.1.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/browserslist": {
-      "version": "4.26.3",
-      "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.26.3.tgz",
-      "integrity": "sha512-lAUU+02RFBuCKQPj/P6NgjlbCnLBMp4UtgTx7vNHd3XSIJF87s9a5rA3aH2yw3GS9DqZAUbOtZdCCiZeVRqt0w==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/browserslist"
-        },
-        {
-          "type": "tidelift",
-          "url": "https://tidelift.com/funding/github/npm/browserslist"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "dependencies": {
-        "baseline-browser-mapping": "^2.8.9",
-        "caniuse-lite": "^1.0.30001746",
-        "electron-to-chromium": "^1.5.227",
-        "node-releases": "^2.0.21",
-        "update-browserslist-db": "^1.1.3"
-      },
-      "bin": {
-        "browserslist": "cli.js"
-      },
-      "engines": {
-        "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
-      }
-    },
-    "node_modules/bs-logger": {
-      "version": "0.2.6",
-      "resolved": "https://registry.npmjs.org/bs-logger/-/bs-logger-0.2.6.tgz",
-      "integrity": "sha512-pd8DCoxmbgc7hyPKOvxtqNcjYoOsABPQdcCUjGp3d42VR2CX1ORhk2A87oqqu5R1kk+76nsxZupkmyd+MVtCog==",
-      "dev": true,
-      "dependencies": {
-        "fast-json-stable-stringify": "2.x"
-      },
-      "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/bser": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/bser/-/bser-2.1.1.tgz",
-      "integrity": "sha512-gQxTNE/GAfIIrmHLUE3oJyp5FO6HRBfhjnw4/wMmA63ZGDJnWBmgY/lyQBpnDUkGmAhbSe39tx2d/iTOAfglwQ==",
-      "dev": true,
-      "dependencies": {
-        "node-int64": "^0.4.0"
-      }
-    },
-    "node_modules/bson": {
-      "version": "6.10.4",
-      "resolved": "https://registry.npmjs.org/bson/-/bson-6.10.4.tgz",
-      "integrity": "sha512-WIsKqkSC0ABoBJuT1LEX+2HEvNmNKKgnTAyd0fL8qzK4SH2i9NXg+t08YtdZp/V9IZ33cxe3iV4yM0qg8lMQng==",
-      "engines": {
-        "node": ">=16.20.1"
-      }
-    },
-    "node_modules/buffer-from": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
-      "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
-      "dev": true
-    },
-    "node_modules/bytes": {
-      "version": "3.1.2",
-      "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
-      "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
-      "engines": {
-        "node": ">= 0.8"
-      }
-    },
-    "node_modules/call-bind-apply-helpers": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
-      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
-      "dependencies": {
-        "es-errors": "^1.3.0",
-        "function-bind": "^1.1.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/call-bound": {
-      "version": "1.0.4",
-      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
-      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
-      "dependencies": {
-        "call-bind-apply-helpers": "^1.0.2",
-        "get-intrinsic": "^1.3.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/callsites": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz",
-      "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/camelcase": {
-      "version": "5.3.1",
-      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-5.3.1.tgz",
-      "integrity": "sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/caniuse-lite": {
-      "version": "1.0.30001750",
-      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001750.tgz",
-      "integrity": "sha512-cuom0g5sdX6rw00qOoLNSFCJ9/mYIsuSOA+yzpDw8eopiFqcVwQvZHqov0vmEighRxX++cfC0Vg1G+1Iy/mSpQ==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/browserslist"
-        },
-        {
-          "type": "tidelift",
-          "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ]
-    },
-    "node_modules/chalk": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
-      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
-      "dev": true,
-      "dependencies": {
-        "ansi-styles": "^4.1.0",
-        "supports-color": "^7.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
-    "node_modules/char-regex": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/char-regex/-/char-regex-1.0.2.tgz",
-      "integrity": "sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==",
-      "dev": true,
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/ci-info": {
-      "version": "3.9.0",
-      "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-3.9.0.tgz",
-      "integrity": "sha512-NIxF55hv4nSqQswkAeiOi1r83xy8JldOFDTWiug55KBu9Jnblncd2U6ViHmYgHf01TPZS77NJBhBMKdWj9HQMQ==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/sibiraj-s"
-        }
-      ],
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/cjs-module-lexer": {
-      "version": "1.4.3",
-      "resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-1.4.3.tgz",
-      "integrity": "sha512-9z8TZaGM1pfswYeXrUpzPrkx8UnWYdhJclsiYMm6x/w5+nN+8Tf/LnAgfLGQCm59qAOxU8WwHEq2vNwF6i4j+Q==",
-      "dev": true
-    },
-    "node_modules/cliui": {
-      "version": "8.0.1",
-      "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz",
-      "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==",
-      "dev": true,
-      "dependencies": {
-        "string-width": "^4.2.0",
-        "strip-ansi": "^6.0.1",
-        "wrap-ansi": "^7.0.0"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/co": {
-      "version": "4.6.0",
-      "resolved": "https://registry.npmjs.org/co/-/co-4.6.0.tgz",
-      "integrity": "sha512-QVb0dM5HvG+uaxitm8wONl7jltx8dqhfU33DcqtOZcLSVIKSDDLDi7+0LbAKiyI8hD9u42m2YxXSkMGWThaecQ==",
-      "dev": true,
-      "engines": {
-        "iojs": ">= 1.0.0",
-        "node": ">= 0.12.0"
-      }
-    },
-    "node_modules/collect-v8-coverage": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/collect-v8-coverage/-/collect-v8-coverage-1.0.2.tgz",
-      "integrity": "sha512-lHl4d5/ONEbLlJvaJNtsF/Lz+WvB07u2ycqTYbdrq7UypDXailES4valYb2eWiJFxZlVmpGekfqoxQhzyFdT4Q==",
-      "dev": true
-    },
-    "node_modules/color-convert": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
-      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
-      "dev": true,
-      "dependencies": {
-        "color-name": "~1.1.4"
-      },
-      "engines": {
-        "node": ">=7.0.0"
-      }
-    },
-    "node_modules/color-name": {
-      "version": "1.1.4",
-      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
-      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
-      "dev": true
-    },
-    "node_modules/concat-map": {
-      "version": "0.0.1",
-      "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
-      "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
-      "dev": true
-    },
-    "node_modules/content-disposition": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.0.0.tgz",
-      "integrity": "sha512-Au9nRL8VNUut/XSzbQA38+M78dzP4D+eqg3gfJHMIHHYa3bg067xj1KxMUWj+VULbiZMowKngFFbKczUrNJ1mg==",
-      "dependencies": {
-        "safe-buffer": "5.2.1"
-      },
-      "engines": {
-        "node": ">= 0.6"
-      }
-    },
-    "node_modules/content-type": {
-      "version": "1.0.5",
-      "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
-      "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
-      "engines": {
-        "node": ">= 0.6"
-      }
-    },
-    "node_modules/convert-source-map": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
-      "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
-      "dev": true
-    },
-    "node_modules/cookie": {
-      "version": "0.7.2",
-      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
-      "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
-      "engines": {
-        "node": ">= 0.6"
-      }
-    },
-    "node_modules/cookie-signature": {
-      "version": "1.2.2",
-      "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.2.2.tgz",
-      "integrity": "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==",
-      "engines": {
-        "node": ">=6.6.0"
-      }
-    },
-    "node_modules/cors": {
-      "version": "2.8.5",
-      "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.5.tgz",
-      "integrity": "sha512-KIHbLJqu73RGr/hnbrO9uBeixNGuvSQjul/jdFvS/KFSIH1hWVd1ng7zOHx+YrEfInLG7q4n6GHQ9cDtxv/P6g==",
-      "dependencies": {
-        "object-assign": "^4",
-        "vary": "^1"
-      },
-      "engines": {
-        "node": ">= 0.10"
-      }
-    },
-    "node_modules/create-jest": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/create-jest/-/create-jest-29.7.0.tgz",
-      "integrity": "sha512-Adz2bdH0Vq3F53KEMJOoftQFutWCukm6J24wbPWRO4k1kMY7gS7ds/uoJkNuV8wDCtWWnuwGcJwpWcih+zEW1Q==",
-      "dev": true,
-      "dependencies": {
-        "@jest/types": "^29.6.3",
-        "chalk": "^4.0.0",
-        "exit": "^0.1.2",
-        "graceful-fs": "^4.2.9",
-        "jest-config": "^29.7.0",
-        "jest-util": "^29.7.0",
-        "prompts": "^2.0.1"
-      },
-      "bin": {
-        "create-jest": "bin/create-jest.js"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/create-require": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/create-require/-/create-require-1.1.1.tgz",
-      "integrity": "sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==",
-      "dev": true
-    },
-    "node_modules/cross-spawn": {
-      "version": "7.0.6",
-      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
-      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
-      "dev": true,
-      "dependencies": {
-        "path-key": "^3.1.0",
-        "shebang-command": "^2.0.0",
-        "which": "^2.0.1"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/debug": {
-      "version": "4.4.3",
-      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
-      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
-      "dependencies": {
-        "ms": "^2.1.3"
-      },
-      "engines": {
-        "node": ">=6.0"
-      },
-      "peerDependenciesMeta": {
-        "supports-color": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/dedent": {
-      "version": "1.7.0",
-      "resolved": "https://registry.npmjs.org/dedent/-/dedent-1.7.0.tgz",
-      "integrity": "sha512-HGFtf8yhuhGhqO07SV79tRp+br4MnbdjeVxotpn1QBl30pcLLCQjX5b2295ll0fv8RKDKsmWYrl05usHM9CewQ==",
-      "dev": true,
-      "peerDependencies": {
-        "babel-plugin-macros": "^3.1.0"
-      },
-      "peerDependenciesMeta": {
-        "babel-plugin-macros": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/deepmerge": {
-      "version": "4.3.1",
-      "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz",
-      "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/depd": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
-      "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
-      "engines": {
-        "node": ">= 0.8"
-      }
-    },
-    "node_modules/detect-newline": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/detect-newline/-/detect-newline-3.1.0.tgz",
-      "integrity": "sha512-TLz+x/vEXm/Y7P7wn1EJFNLxYpUD4TgMosxY6fAVJUnJMbupHBOncxyWUG9OpTaH9EBD7uFI5LfEgmMOc54DsA==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/diff": {
-      "version": "4.0.2",
-      "resolved": "https://registry.npmjs.org/diff/-/diff-4.0.2.tgz",
-      "integrity": "sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.3.1"
-      }
-    },
-    "node_modules/diff-sequences": {
-      "version": "29.6.3",
-      "resolved": "https://registry.npmjs.org/diff-sequences/-/diff-sequences-29.6.3.tgz",
-      "integrity": "sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==",
-      "dev": true,
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/dotenv": {
-      "version": "16.6.1",
-      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz",
-      "integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==",
-      "engines": {
-        "node": ">=12"
-      },
-      "funding": {
-        "url": "https://dotenvx.com"
-      }
-    },
-    "node_modules/dunder-proto": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
-      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
-      "dependencies": {
-        "call-bind-apply-helpers": "^1.0.1",
-        "es-errors": "^1.3.0",
-        "gopd": "^1.2.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/ee-first": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
-      "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow=="
-    },
-    "node_modules/electron-to-chromium": {
-      "version": "1.5.235",
-      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.235.tgz",
-      "integrity": "sha512-i/7ntLFwOdoHY7sgjlTIDo4Sl8EdoTjWIaKinYOVfC6bOp71bmwenyZthWHcasxgHDNWbWxvG9M3Ia116zIaYQ==",
-      "dev": true
-    },
-    "node_modules/emittery": {
-      "version": "0.13.1",
-      "resolved": "https://registry.npmjs.org/emittery/-/emittery-0.13.1.tgz",
-      "integrity": "sha512-DeWwawk6r5yR9jFgnDKYt4sLS0LmHJJi3ZOnb5/JdbYwj3nW+FxQnHIjhBKz8YLC7oRNPVM9NQ47I3CVx34eqQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=12"
-      },
-      "funding": {
-        "url": "https://github.com/sindresorhus/emittery?sponsor=1"
-      }
-    },
-    "node_modules/emoji-regex": {
-      "version": "8.0.0",
-      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
-      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
-      "dev": true
-    },
-    "node_modules/encodeurl": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
-      "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
-      "engines": {
-        "node": ">= 0.8"
-      }
-    },
-    "node_modules/error-ex": {
-      "version": "1.3.4",
-      "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.4.tgz",
-      "integrity": "sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ==",
-      "dev": true,
-      "dependencies": {
-        "is-arrayish": "^0.2.1"
-      }
-    },
-    "node_modules/es-define-property": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
-      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/es-errors": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
-      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/es-object-atoms": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
-      "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
-      "dependencies": {
-        "es-errors": "^1.3.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/escalade": {
-      "version": "3.2.0",
-      "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
-      "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/escape-html": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
-      "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow=="
-    },
-    "node_modules/escape-string-regexp": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-2.0.0.tgz",
-      "integrity": "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/esprima": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
-      "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==",
-      "dev": true,
-      "bin": {
-        "esparse": "bin/esparse.js",
-        "esvalidate": "bin/esvalidate.js"
-      },
-      "engines": {
-        "node": ">=4"
-      }
-    },
-    "node_modules/etag": {
-      "version": "1.8.1",
-      "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
-      "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
-      "engines": {
-        "node": ">= 0.6"
-      }
-    },
-    "node_modules/execa": {
-      "version": "5.1.1",
-      "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz",
-      "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==",
-      "dev": true,
-      "dependencies": {
-        "cross-spawn": "^7.0.3",
-        "get-stream": "^6.0.0",
-        "human-signals": "^2.1.0",
-        "is-stream": "^2.0.0",
-        "merge-stream": "^2.0.0",
-        "npm-run-path": "^4.0.1",
-        "onetime": "^5.1.2",
-        "signal-exit": "^3.0.3",
-        "strip-final-newline": "^2.0.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sindresorhus/execa?sponsor=1"
-      }
-    },
-    "node_modules/exit": {
-      "version": "0.1.2",
-      "resolved": "https://registry.npmjs.org/exit/-/exit-0.1.2.tgz",
-      "integrity": "sha512-Zk/eNKV2zbjpKzrsQ+n1G6poVbErQxJ0LBOJXaKZ1EViLzH+hrLu9cdXI4zw9dBQJslwBEpbQ2P1oS7nDxs6jQ==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.8.0"
-      }
-    },
-    "node_modules/expect": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/expect/-/expect-29.7.0.tgz",
-      "integrity": "sha512-2Zks0hf1VLFYI1kbh0I5jP3KHHyCHpkfyHBzsSXRFgl/Bg9mWYfMW8oD+PdMPlEwy5HNsR9JutYy6pMeOh61nw==",
-      "dev": true,
-      "dependencies": {
-        "@jest/expect-utils": "^29.7.0",
-        "jest-get-type": "^29.6.3",
-        "jest-matcher-utils": "^29.7.0",
-        "jest-message-util": "^29.7.0",
-        "jest-util": "^29.7.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/express": {
-      "version": "5.1.0",
-      "resolved": "https://registry.npmjs.org/express/-/express-5.1.0.tgz",
-      "integrity": "sha512-DT9ck5YIRU+8GYzzU5kT3eHGA5iL+1Zd0EutOmTE9Dtk+Tvuzd23VBU+ec7HPNSTxXYO55gPV/hq4pSBJDjFpA==",
-      "dependencies": {
-        "accepts": "^2.0.0",
-        "body-parser": "^2.2.0",
-        "content-disposition": "^1.0.0",
-        "content-type": "^1.0.5",
-        "cookie": "^0.7.1",
-        "cookie-signature": "^1.2.1",
-        "debug": "^4.4.0",
-        "encodeurl": "^2.0.0",
-        "escape-html": "^1.0.3",
-        "etag": "^1.8.1",
-        "finalhandler": "^2.1.0",
-        "fresh": "^2.0.0",
-        "http-errors": "^2.0.0",
-        "merge-descriptors": "^2.0.0",
-        "mime-types": "^3.0.0",
-        "on-finished": "^2.4.1",
-        "once": "^1.4.0",
-        "parseurl": "^1.3.3",
-        "proxy-addr": "^2.0.7",
-        "qs": "^6.14.0",
-        "range-parser": "^1.2.1",
-        "router": "^2.2.0",
-        "send": "^1.1.0",
-        "serve-static": "^2.2.0",
-        "statuses": "^2.0.1",
-        "type-is": "^2.0.1",
-        "vary": "^1.1.2"
-      },
-      "engines": {
-        "node": ">= 18"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/express"
-      }
-    },
-    "node_modules/fast-json-stable-stringify": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",
-      "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==",
-      "dev": true
-    },
-    "node_modules/fb-watchman": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/fb-watchman/-/fb-watchman-2.0.2.tgz",
-      "integrity": "sha512-p5161BqbuCaSnB8jIbzQHOlpgsPmK5rJVDfDKO91Axs5NC1uu3HRQm6wt9cd9/+GtQQIO53JdGXXoyDpTAsgYA==",
-      "dev": true,
-      "dependencies": {
-        "bser": "2.1.1"
-      }
-    },
-    "node_modules/fill-range": {
-      "version": "7.1.1",
-      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
-      "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
-      "dev": true,
-      "dependencies": {
-        "to-regex-range": "^5.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/finalhandler": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.0.tgz",
-      "integrity": "sha512-/t88Ty3d5JWQbWYgaOGCCYfXRwV1+be02WqYYlL6h0lEiUAMPM8o8qKGO01YIkOHzka2up08wvgYD0mDiI+q3Q==",
-      "dependencies": {
-        "debug": "^4.4.0",
-        "encodeurl": "^2.0.0",
-        "escape-html": "^1.0.3",
-        "on-finished": "^2.4.1",
-        "parseurl": "^1.3.3",
-        "statuses": "^2.0.1"
-      },
-      "engines": {
-        "node": ">= 0.8"
-      }
-    },
-    "node_modules/find-up": {
-      "version": "4.1.0",
-      "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz",
-      "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==",
-      "dev": true,
-      "dependencies": {
-        "locate-path": "^5.0.0",
-        "path-exists": "^4.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/forwarded": {
-      "version": "0.2.0",
-      "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
-      "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
-      "engines": {
-        "node": ">= 0.6"
-      }
-    },
-    "node_modules/fresh": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/fresh/-/fresh-2.0.0.tgz",
-      "integrity": "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==",
-      "engines": {
-        "node": ">= 0.8"
-      }
-    },
-    "node_modules/fs.realpath": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
-      "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==",
-      "dev": true
-    },
-    "node_modules/fsevents": {
-      "version": "2.3.3",
-      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
-      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
-      "dev": true,
-      "hasInstallScript": true,
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
-      }
-    },
-    "node_modules/function-bind": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
-      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/gensync": {
-      "version": "1.0.0-beta.2",
-      "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz",
-      "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==",
-      "dev": true,
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/get-caller-file": {
-      "version": "2.0.5",
-      "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
-      "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
-      "dev": true,
-      "engines": {
-        "node": "6.* || 8.* || >= 10.*"
-      }
-    },
-    "node_modules/get-intrinsic": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
-      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
-      "dependencies": {
-        "call-bind-apply-helpers": "^1.0.2",
-        "es-define-property": "^1.0.1",
-        "es-errors": "^1.3.0",
-        "es-object-atoms": "^1.1.1",
-        "function-bind": "^1.1.2",
-        "get-proto": "^1.0.1",
-        "gopd": "^1.2.0",
-        "has-symbols": "^1.1.0",
-        "hasown": "^2.0.2",
-        "math-intrinsics": "^1.1.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/get-package-type": {
-      "version": "0.1.0",
-      "resolved": "https://registry.npmjs.org/get-package-type/-/get-package-type-0.1.0.tgz",
-      "integrity": "sha512-pjzuKtY64GYfWizNAJ0fr9VqttZkNiK2iS430LtIHzjBEr6bX8Am2zm4sW4Ro5wjWW5cAlRL1qAMTcXbjNAO2Q==",
-      "dev": true,
-      "engines": {
-        "node": ">=8.0.0"
-      }
-    },
-    "node_modules/get-proto": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
-      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
-      "dependencies": {
-        "dunder-proto": "^1.0.1",
-        "es-object-atoms": "^1.0.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/get-stream": {
-      "version": "6.0.1",
-      "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz",
-      "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==",
-      "dev": true,
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/glob": {
-      "version": "7.2.3",
-      "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz",
-      "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==",
-      "deprecated": "Glob versions prior to v9 are no longer supported",
-      "dev": true,
-      "dependencies": {
-        "fs.realpath": "^1.0.0",
-        "inflight": "^1.0.4",
-        "inherits": "2",
-        "minimatch": "^3.1.1",
-        "once": "^1.3.0",
-        "path-is-absolute": "^1.0.0"
-      },
-      "engines": {
-        "node": "*"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/isaacs"
-      }
-    },
-    "node_modules/gopd": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
-      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/graceful-fs": {
-      "version": "4.2.11",
-      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
-      "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
-      "dev": true
-    },
-    "node_modules/handlebars": {
-      "version": "4.7.8",
-      "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.8.tgz",
-      "integrity": "sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ==",
-      "dev": true,
-      "dependencies": {
-        "minimist": "^1.2.5",
-        "neo-async": "^2.6.2",
-        "source-map": "^0.6.1",
-        "wordwrap": "^1.0.0"
-      },
-      "bin": {
-        "handlebars": "bin/handlebars"
-      },
-      "engines": {
-        "node": ">=0.4.7"
-      },
-      "optionalDependencies": {
-        "uglify-js": "^3.1.4"
-      }
-    },
-    "node_modules/has-flag": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
-      "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/has-symbols": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
-      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/hasown": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
-      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
-      "dependencies": {
-        "function-bind": "^1.1.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/html-escaper": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-2.0.2.tgz",
-      "integrity": "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==",
-      "dev": true
-    },
-    "node_modules/http-errors": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz",
-      "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==",
-      "dependencies": {
-        "depd": "2.0.0",
-        "inherits": "2.0.4",
-        "setprototypeof": "1.2.0",
-        "statuses": "2.0.1",
-        "toidentifier": "1.0.1"
-      },
-      "engines": {
-        "node": ">= 0.8"
-      }
-    },
-    "node_modules/http-errors/node_modules/statuses": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz",
-      "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==",
-      "engines": {
-        "node": ">= 0.8"
-      }
-    },
-    "node_modules/human-signals": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz",
-      "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==",
-      "dev": true,
-      "engines": {
-        "node": ">=10.17.0"
-      }
-    },
-    "node_modules/iconv-lite": {
-      "version": "0.6.3",
-      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz",
-      "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==",
-      "dependencies": {
-        "safer-buffer": ">= 2.1.2 < 3.0.0"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/import-local": {
-      "version": "3.2.0",
-      "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.2.0.tgz",
-      "integrity": "sha512-2SPlun1JUPWoM6t3F0dw0FkCF/jWY8kttcY4f599GLTSjh2OCuuhdTkJQsEcZzBqbXZGKMK2OqW1oZsjtf/gQA==",
-      "dev": true,
-      "dependencies": {
-        "pkg-dir": "^4.2.0",
-        "resolve-cwd": "^3.0.0"
-      },
-      "bin": {
-        "import-local-fixture": "fixtures/cli.js"
-      },
-      "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/imurmurhash": {
-      "version": "0.1.4",
-      "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz",
-      "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.8.19"
-      }
-    },
-    "node_modules/inflight": {
-      "version": "1.0.6",
-      "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
-      "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==",
-      "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.",
-      "dev": true,
-      "dependencies": {
-        "once": "^1.3.0",
-        "wrappy": "1"
-      }
-    },
-    "node_modules/inherits": {
-      "version": "2.0.4",
-      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
-      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="
-    },
-    "node_modules/ipaddr.js": {
-      "version": "1.9.1",
-      "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
-      "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
-      "engines": {
-        "node": ">= 0.10"
-      }
-    },
-    "node_modules/is-arrayish": {
-      "version": "0.2.1",
-      "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz",
-      "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==",
-      "dev": true
-    },
-    "node_modules/is-core-module": {
-      "version": "2.16.1",
-      "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz",
-      "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==",
-      "dev": true,
-      "dependencies": {
-        "hasown": "^2.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/is-fullwidth-code-point": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
-      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/is-generator-fn": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/is-generator-fn/-/is-generator-fn-2.1.0.tgz",
-      "integrity": "sha512-cTIB4yPYL/Grw0EaSzASzg6bBy9gqCofvWN8okThAYIxKJZC+udlRAmGbM0XLeniEJSs8uEgHPGuHSe1XsOLSQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/is-number": {
-      "version": "7.0.0",
-      "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
-      "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.12.0"
-      }
-    },
-    "node_modules/is-promise": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz",
-      "integrity": "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ=="
-    },
-    "node_modules/is-stream": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
-      "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/isexe": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
-      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
-      "dev": true
-    },
-    "node_modules/istanbul-lib-coverage": {
-      "version": "3.2.2",
-      "resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.2.tgz",
-      "integrity": "sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/istanbul-lib-instrument": {
-      "version": "6.0.3",
-      "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-6.0.3.tgz",
-      "integrity": "sha512-Vtgk7L/R2JHyyGW07spoFlB8/lpjiOLTjMdms6AFMraYt3BaJauod/NGrfnVG/y4Ix1JEuMRPDPEj2ua+zz1/Q==",
-      "dev": true,
-      "dependencies": {
-        "@babel/core": "^7.23.9",
-        "@babel/parser": "^7.23.9",
-        "@istanbuljs/schema": "^0.1.3",
-        "istanbul-lib-coverage": "^3.2.0",
-        "semver": "^7.5.4"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/istanbul-lib-instrument/node_modules/semver": {
-      "version": "7.7.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz",
-      "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==",
-      "dev": true,
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/istanbul-lib-report": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/istanbul-lib-report/-/istanbul-lib-report-3.0.1.tgz",
-      "integrity": "sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==",
-      "dev": true,
-      "dependencies": {
-        "istanbul-lib-coverage": "^3.0.0",
-        "make-dir": "^4.0.0",
-        "supports-color": "^7.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/istanbul-lib-source-maps": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/istanbul-lib-source-maps/-/istanbul-lib-source-maps-4.0.1.tgz",
-      "integrity": "sha512-n3s8EwkdFIJCG3BPKBYvskgXGoy88ARzvegkitk60NxRdwltLOTaH7CUiMRXvwYorl0Q712iEjcWB+fK/MrWVw==",
-      "dev": true,
-      "dependencies": {
-        "debug": "^4.1.1",
-        "istanbul-lib-coverage": "^3.0.0",
-        "source-map": "^0.6.1"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/istanbul-reports": {
-      "version": "3.2.0",
-      "resolved": "https://registry.npmjs.org/istanbul-reports/-/istanbul-reports-3.2.0.tgz",
-      "integrity": "sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==",
-      "dev": true,
-      "dependencies": {
-        "html-escaper": "^2.0.0",
-        "istanbul-lib-report": "^3.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/jest": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest/-/jest-29.7.0.tgz",
-      "integrity": "sha512-NIy3oAFp9shda19hy4HK0HRTWKtPJmGdnvywu01nOqNC2vZg+Z+fvJDxpMQA88eb2I9EcafcdjYgsDthnYTvGw==",
-      "dev": true,
-      "dependencies": {
-        "@jest/core": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "import-local": "^3.0.2",
-        "jest-cli": "^29.7.0"
-      },
-      "bin": {
-        "jest": "bin/jest.js"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      },
-      "peerDependencies": {
-        "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0"
-      },
-      "peerDependenciesMeta": {
-        "node-notifier": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/jest-changed-files": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-changed-files/-/jest-changed-files-29.7.0.tgz",
-      "integrity": "sha512-fEArFiwf1BpQ+4bXSprcDc3/x4HSzL4al2tozwVpDFpsxALjLYdyiIK4e5Vz66GQJIbXJ82+35PtysofptNX2w==",
-      "dev": true,
-      "dependencies": {
-        "execa": "^5.0.0",
-        "jest-util": "^29.7.0",
-        "p-limit": "^3.1.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-circus": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-circus/-/jest-circus-29.7.0.tgz",
-      "integrity": "sha512-3E1nCMgipcTkCocFwM90XXQab9bS+GMsjdpmPrlelaxwD93Ad8iVEjX/vvHPdLPnFf+L40u+5+iutRdA1N9myw==",
-      "dev": true,
-      "dependencies": {
-        "@jest/environment": "^29.7.0",
-        "@jest/expect": "^29.7.0",
-        "@jest/test-result": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "@types/node": "*",
-        "chalk": "^4.0.0",
-        "co": "^4.6.0",
-        "dedent": "^1.0.0",
-        "is-generator-fn": "^2.0.0",
-        "jest-each": "^29.7.0",
-        "jest-matcher-utils": "^29.7.0",
-        "jest-message-util": "^29.7.0",
-        "jest-runtime": "^29.7.0",
-        "jest-snapshot": "^29.7.0",
-        "jest-util": "^29.7.0",
-        "p-limit": "^3.1.0",
-        "pretty-format": "^29.7.0",
-        "pure-rand": "^6.0.0",
-        "slash": "^3.0.0",
-        "stack-utils": "^2.0.3"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-cli": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-cli/-/jest-cli-29.7.0.tgz",
-      "integrity": "sha512-OVVobw2IubN/GSYsxETi+gOe7Ka59EFMR/twOU3Jb2GnKKeMGJB5SGUUrEz3SFVmJASUdZUzy83sLNNQ2gZslg==",
-      "dev": true,
-      "dependencies": {
-        "@jest/core": "^29.7.0",
-        "@jest/test-result": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "chalk": "^4.0.0",
-        "create-jest": "^29.7.0",
-        "exit": "^0.1.2",
-        "import-local": "^3.0.2",
-        "jest-config": "^29.7.0",
-        "jest-util": "^29.7.0",
-        "jest-validate": "^29.7.0",
-        "yargs": "^17.3.1"
-      },
-      "bin": {
-        "jest": "bin/jest.js"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      },
-      "peerDependencies": {
-        "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0"
-      },
-      "peerDependenciesMeta": {
-        "node-notifier": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/jest-config": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-config/-/jest-config-29.7.0.tgz",
-      "integrity": "sha512-uXbpfeQ7R6TZBqI3/TxCU4q4ttk3u0PJeC+E0zbfSoSjq6bJ7buBPxzQPL0ifrkY4DNu4JUdk0ImlBUYi840eQ==",
-      "dev": true,
-      "dependencies": {
-        "@babel/core": "^7.11.6",
-        "@jest/test-sequencer": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "babel-jest": "^29.7.0",
-        "chalk": "^4.0.0",
-        "ci-info": "^3.2.0",
-        "deepmerge": "^4.2.2",
-        "glob": "^7.1.3",
-        "graceful-fs": "^4.2.9",
-        "jest-circus": "^29.7.0",
-        "jest-environment-node": "^29.7.0",
-        "jest-get-type": "^29.6.3",
-        "jest-regex-util": "^29.6.3",
-        "jest-resolve": "^29.7.0",
-        "jest-runner": "^29.7.0",
-        "jest-util": "^29.7.0",
-        "jest-validate": "^29.7.0",
-        "micromatch": "^4.0.4",
-        "parse-json": "^5.2.0",
-        "pretty-format": "^29.7.0",
-        "slash": "^3.0.0",
-        "strip-json-comments": "^3.1.1"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      },
-      "peerDependencies": {
-        "@types/node": "*",
-        "ts-node": ">=9.0.0"
-      },
-      "peerDependenciesMeta": {
-        "@types/node": {
-          "optional": true
-        },
-        "ts-node": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/jest-diff": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-diff/-/jest-diff-29.7.0.tgz",
-      "integrity": "sha512-LMIgiIrhigmPrs03JHpxUh2yISK3vLFPkAodPeo0+BuF7wA2FoQbkEg1u8gBYBThncu7e1oEDUfIXVuTqLRUjw==",
-      "dev": true,
-      "dependencies": {
-        "chalk": "^4.0.0",
-        "diff-sequences": "^29.6.3",
-        "jest-get-type": "^29.6.3",
-        "pretty-format": "^29.7.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-docblock": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-docblock/-/jest-docblock-29.7.0.tgz",
-      "integrity": "sha512-q617Auw3A612guyaFgsbFeYpNP5t2aoUNLwBUbc/0kD1R4t9ixDbyFTHd1nok4epoVFpr7PmeWHrhvuV3XaJ4g==",
-      "dev": true,
-      "dependencies": {
-        "detect-newline": "^3.0.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-each": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-each/-/jest-each-29.7.0.tgz",
-      "integrity": "sha512-gns+Er14+ZrEoC5fhOfYCY1LOHHr0TI+rQUHZS8Ttw2l7gl+80eHc/gFf2Ktkw0+SIACDTeWvpFcv3B04VembQ==",
-      "dev": true,
-      "dependencies": {
-        "@jest/types": "^29.6.3",
-        "chalk": "^4.0.0",
-        "jest-get-type": "^29.6.3",
-        "jest-util": "^29.7.0",
-        "pretty-format": "^29.7.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-environment-node": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-environment-node/-/jest-environment-node-29.7.0.tgz",
-      "integrity": "sha512-DOSwCRqXirTOyheM+4d5YZOrWcdu0LNZ87ewUoywbcb2XR4wKgqiG8vNeYwhjFMbEkfju7wx2GYH0P2gevGvFw==",
-      "dev": true,
-      "dependencies": {
-        "@jest/environment": "^29.7.0",
-        "@jest/fake-timers": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "@types/node": "*",
-        "jest-mock": "^29.7.0",
-        "jest-util": "^29.7.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-get-type": {
-      "version": "29.6.3",
-      "resolved": "https://registry.npmjs.org/jest-get-type/-/jest-get-type-29.6.3.tgz",
-      "integrity": "sha512-zrteXnqYxfQh7l5FHyL38jL39di8H8rHoecLH3JNxH3BwOrBsNeabdap5e0I23lD4HHI8W5VFBZqG4Eaq5LNcw==",
-      "dev": true,
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-haste-map": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-haste-map/-/jest-haste-map-29.7.0.tgz",
-      "integrity": "sha512-fP8u2pyfqx0K1rGn1R9pyE0/KTn+G7PxktWidOBTqFPLYX0b9ksaMFkhK5vrS3DVun09pckLdlx90QthlW7AmA==",
-      "dev": true,
-      "dependencies": {
-        "@jest/types": "^29.6.3",
-        "@types/graceful-fs": "^4.1.3",
-        "@types/node": "*",
-        "anymatch": "^3.0.3",
-        "fb-watchman": "^2.0.0",
-        "graceful-fs": "^4.2.9",
-        "jest-regex-util": "^29.6.3",
-        "jest-util": "^29.7.0",
-        "jest-worker": "^29.7.0",
-        "micromatch": "^4.0.4",
-        "walker": "^1.0.8"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      },
-      "optionalDependencies": {
-        "fsevents": "^2.3.2"
-      }
-    },
-    "node_modules/jest-leak-detector": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-leak-detector/-/jest-leak-detector-29.7.0.tgz",
-      "integrity": "sha512-kYA8IJcSYtST2BY9I+SMC32nDpBT3J2NvWJx8+JCuCdl/CR1I4EKUJROiP8XtCcxqgTTBGJNdbB1A8XRKbTetw==",
-      "dev": true,
-      "dependencies": {
-        "jest-get-type": "^29.6.3",
-        "pretty-format": "^29.7.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-matcher-utils": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-matcher-utils/-/jest-matcher-utils-29.7.0.tgz",
-      "integrity": "sha512-sBkD+Xi9DtcChsI3L3u0+N0opgPYnCRPtGcQYrgXmR+hmt/fYfWAL0xRXYU8eWOdfuLgBe0YCW3AFtnRLagq/g==",
-      "dev": true,
-      "dependencies": {
-        "chalk": "^4.0.0",
-        "jest-diff": "^29.7.0",
-        "jest-get-type": "^29.6.3",
-        "pretty-format": "^29.7.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-message-util": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-message-util/-/jest-message-util-29.7.0.tgz",
-      "integrity": "sha512-GBEV4GRADeP+qtB2+6u61stea8mGcOT4mCtrYISZwfu9/ISHFJ/5zOMXYbpBE9RsS5+Gb63DW4FgmnKJ79Kf6w==",
-      "dev": true,
-      "dependencies": {
-        "@babel/code-frame": "^7.12.13",
-        "@jest/types": "^29.6.3",
-        "@types/stack-utils": "^2.0.0",
-        "chalk": "^4.0.0",
-        "graceful-fs": "^4.2.9",
-        "micromatch": "^4.0.4",
-        "pretty-format": "^29.7.0",
-        "slash": "^3.0.0",
-        "stack-utils": "^2.0.3"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-mock": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-mock/-/jest-mock-29.7.0.tgz",
-      "integrity": "sha512-ITOMZn+UkYS4ZFh83xYAOzWStloNzJFO2s8DWrE4lhtGD+AorgnbkiKERe4wQVBydIGPx059g6riW5Btp6Llnw==",
-      "dev": true,
-      "dependencies": {
-        "@jest/types": "^29.6.3",
-        "@types/node": "*",
-        "jest-util": "^29.7.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-pnp-resolver": {
-      "version": "1.2.3",
-      "resolved": "https://registry.npmjs.org/jest-pnp-resolver/-/jest-pnp-resolver-1.2.3.tgz",
-      "integrity": "sha512-+3NpwQEnRoIBtx4fyhblQDPgJI0H1IEIkX7ShLUjPGA7TtUTvI1oiKi3SR4oBR0hQhQR80l4WAe5RrXBwWMA8w==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      },
-      "peerDependencies": {
-        "jest-resolve": "*"
-      },
-      "peerDependenciesMeta": {
-        "jest-resolve": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/jest-regex-util": {
-      "version": "29.6.3",
-      "resolved": "https://registry.npmjs.org/jest-regex-util/-/jest-regex-util-29.6.3.tgz",
-      "integrity": "sha512-KJJBsRCyyLNWCNBOvZyRDnAIfUiRJ8v+hOBQYGn8gDyF3UegwiP4gwRR3/SDa42g1YbVycTidUF3rKjyLFDWbg==",
-      "dev": true,
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-resolve": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-resolve/-/jest-resolve-29.7.0.tgz",
-      "integrity": "sha512-IOVhZSrg+UvVAshDSDtHyFCCBUl/Q3AAJv8iZ6ZjnZ74xzvwuzLXid9IIIPgTnY62SJjfuupMKZsZQRsCvxEgA==",
-      "dev": true,
-      "dependencies": {
-        "chalk": "^4.0.0",
-        "graceful-fs": "^4.2.9",
-        "jest-haste-map": "^29.7.0",
-        "jest-pnp-resolver": "^1.2.2",
-        "jest-util": "^29.7.0",
-        "jest-validate": "^29.7.0",
-        "resolve": "^1.20.0",
-        "resolve.exports": "^2.0.0",
-        "slash": "^3.0.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-resolve-dependencies": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-resolve-dependencies/-/jest-resolve-dependencies-29.7.0.tgz",
-      "integrity": "sha512-un0zD/6qxJ+S0et7WxeI3H5XSe9lTBBR7bOHCHXkKR6luG5mwDDlIzVQ0V5cZCuoTgEdcdwzTghYkTWfubi+nA==",
-      "dev": true,
-      "dependencies": {
-        "jest-regex-util": "^29.6.3",
-        "jest-snapshot": "^29.7.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-runner": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-runner/-/jest-runner-29.7.0.tgz",
-      "integrity": "sha512-fsc4N6cPCAahybGBfTRcq5wFR6fpLznMg47sY5aDpsoejOcVYFb07AHuSnR0liMcPTgBsA3ZJL6kFOjPdoNipQ==",
-      "dev": true,
-      "dependencies": {
-        "@jest/console": "^29.7.0",
-        "@jest/environment": "^29.7.0",
-        "@jest/test-result": "^29.7.0",
-        "@jest/transform": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "@types/node": "*",
-        "chalk": "^4.0.0",
-        "emittery": "^0.13.1",
-        "graceful-fs": "^4.2.9",
-        "jest-docblock": "^29.7.0",
-        "jest-environment-node": "^29.7.0",
-        "jest-haste-map": "^29.7.0",
-        "jest-leak-detector": "^29.7.0",
-        "jest-message-util": "^29.7.0",
-        "jest-resolve": "^29.7.0",
-        "jest-runtime": "^29.7.0",
-        "jest-util": "^29.7.0",
-        "jest-watcher": "^29.7.0",
-        "jest-worker": "^29.7.0",
-        "p-limit": "^3.1.0",
-        "source-map-support": "0.5.13"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-runtime": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-runtime/-/jest-runtime-29.7.0.tgz",
-      "integrity": "sha512-gUnLjgwdGqW7B4LvOIkbKs9WGbn+QLqRQQ9juC6HndeDiezIwhDP+mhMwHWCEcfQ5RUXa6OPnFF8BJh5xegwwQ==",
-      "dev": true,
-      "dependencies": {
-        "@jest/environment": "^29.7.0",
-        "@jest/fake-timers": "^29.7.0",
-        "@jest/globals": "^29.7.0",
-        "@jest/source-map": "^29.6.3",
-        "@jest/test-result": "^29.7.0",
-        "@jest/transform": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "@types/node": "*",
-        "chalk": "^4.0.0",
-        "cjs-module-lexer": "^1.0.0",
-        "collect-v8-coverage": "^1.0.0",
-        "glob": "^7.1.3",
-        "graceful-fs": "^4.2.9",
-        "jest-haste-map": "^29.7.0",
-        "jest-message-util": "^29.7.0",
-        "jest-mock": "^29.7.0",
-        "jest-regex-util": "^29.6.3",
-        "jest-resolve": "^29.7.0",
-        "jest-snapshot": "^29.7.0",
-        "jest-util": "^29.7.0",
-        "slash": "^3.0.0",
-        "strip-bom": "^4.0.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-snapshot": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-snapshot/-/jest-snapshot-29.7.0.tgz",
-      "integrity": "sha512-Rm0BMWtxBcioHr1/OX5YCP8Uov4riHvKPknOGs804Zg9JGZgmIBkbtlxJC/7Z4msKYVbIJtfU+tKb8xlYNfdkw==",
-      "dev": true,
-      "dependencies": {
-        "@babel/core": "^7.11.6",
-        "@babel/generator": "^7.7.2",
-        "@babel/plugin-syntax-jsx": "^7.7.2",
-        "@babel/plugin-syntax-typescript": "^7.7.2",
-        "@babel/types": "^7.3.3",
-        "@jest/expect-utils": "^29.7.0",
-        "@jest/transform": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "babel-preset-current-node-syntax": "^1.0.0",
-        "chalk": "^4.0.0",
-        "expect": "^29.7.0",
-        "graceful-fs": "^4.2.9",
-        "jest-diff": "^29.7.0",
-        "jest-get-type": "^29.6.3",
-        "jest-matcher-utils": "^29.7.0",
-        "jest-message-util": "^29.7.0",
-        "jest-util": "^29.7.0",
-        "natural-compare": "^1.4.0",
-        "pretty-format": "^29.7.0",
-        "semver": "^7.5.3"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-snapshot/node_modules/semver": {
-      "version": "7.7.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz",
-      "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==",
-      "dev": true,
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/jest-util": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-util/-/jest-util-29.7.0.tgz",
-      "integrity": "sha512-z6EbKajIpqGKU56y5KBUgy1dt1ihhQJgWzUlZHArA/+X2ad7Cb5iF+AK1EWVL/Bo7Rz9uurpqw6SiBCefUbCGA==",
-      "dev": true,
-      "dependencies": {
-        "@jest/types": "^29.6.3",
-        "@types/node": "*",
-        "chalk": "^4.0.0",
-        "ci-info": "^3.2.0",
-        "graceful-fs": "^4.2.9",
-        "picomatch": "^2.2.3"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-validate": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-validate/-/jest-validate-29.7.0.tgz",
-      "integrity": "sha512-ZB7wHqaRGVw/9hST/OuFUReG7M8vKeq0/J2egIGLdvjHCmYqGARhzXmtgi+gVeZ5uXFF219aOc3Ls2yLg27tkw==",
-      "dev": true,
-      "dependencies": {
-        "@jest/types": "^29.6.3",
-        "camelcase": "^6.2.0",
-        "chalk": "^4.0.0",
-        "jest-get-type": "^29.6.3",
-        "leven": "^3.1.0",
-        "pretty-format": "^29.7.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-validate/node_modules/camelcase": {
-      "version": "6.3.0",
-      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-6.3.0.tgz",
-      "integrity": "sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==",
-      "dev": true,
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/jest-watcher": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-watcher/-/jest-watcher-29.7.0.tgz",
-      "integrity": "sha512-49Fg7WXkU3Vl2h6LbLtMQ/HyB6rXSIX7SqvBLQmssRBGN9I0PNvPmAmCWSOY6SOvrjhI/F7/bGAv9RtnsPA03g==",
-      "dev": true,
-      "dependencies": {
-        "@jest/test-result": "^29.7.0",
-        "@jest/types": "^29.6.3",
-        "@types/node": "*",
-        "ansi-escapes": "^4.2.1",
-        "chalk": "^4.0.0",
-        "emittery": "^0.13.1",
-        "jest-util": "^29.7.0",
-        "string-length": "^4.0.1"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-worker": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-29.7.0.tgz",
-      "integrity": "sha512-eIz2msL/EzL9UFTFFx7jBTkeZfku0yUAyZZZmJ93H2TYEiroIx2PQjEXcwYtYl8zXCxb+PAmA2hLIt/6ZEkPHw==",
-      "dev": true,
-      "dependencies": {
-        "@types/node": "*",
-        "jest-util": "^29.7.0",
-        "merge-stream": "^2.0.0",
-        "supports-color": "^8.0.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/jest-worker/node_modules/supports-color": {
-      "version": "8.1.1",
-      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz",
-      "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==",
-      "dev": true,
-      "dependencies": {
-        "has-flag": "^4.0.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/supports-color?sponsor=1"
-      }
-    },
-    "node_modules/js-tokens": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
-      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
-      "dev": true
-    },
-    "node_modules/js-yaml": {
-      "version": "3.14.1",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz",
-      "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==",
-      "dev": true,
-      "dependencies": {
-        "argparse": "^1.0.7",
-        "esprima": "^4.0.0"
-      },
-      "bin": {
-        "js-yaml": "bin/js-yaml.js"
-      }
-    },
-    "node_modules/jsesc": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz",
-      "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==",
-      "dev": true,
-      "bin": {
-        "jsesc": "bin/jsesc"
-      },
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/json-parse-even-better-errors": {
-      "version": "2.3.1",
-      "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz",
-      "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==",
-      "dev": true
-    },
-    "node_modules/json5": {
-      "version": "2.2.3",
-      "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
-      "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
-      "dev": true,
-      "bin": {
-        "json5": "lib/cli.js"
-      },
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/kleur": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz",
-      "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/leven": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/leven/-/leven-3.1.0.tgz",
-      "integrity": "sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/lines-and-columns": {
-      "version": "1.2.4",
-      "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz",
-      "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==",
-      "dev": true
-    },
-    "node_modules/locate-path": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz",
-      "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==",
-      "dev": true,
-      "dependencies": {
-        "p-locate": "^4.1.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/lodash.memoize": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/lodash.memoize/-/lodash.memoize-4.1.2.tgz",
-      "integrity": "sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==",
-      "dev": true
-    },
-    "node_modules/lru-cache": {
-      "version": "5.1.1",
-      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz",
-      "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==",
-      "dev": true,
-      "dependencies": {
-        "yallist": "^3.0.2"
-      }
-    },
-    "node_modules/make-dir": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-4.0.0.tgz",
-      "integrity": "sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==",
-      "dev": true,
-      "dependencies": {
-        "semver": "^7.5.3"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/make-dir/node_modules/semver": {
-      "version": "7.7.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz",
-      "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==",
-      "dev": true,
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/make-error": {
-      "version": "1.3.6",
-      "resolved": "https://registry.npmjs.org/make-error/-/make-error-1.3.6.tgz",
-      "integrity": "sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==",
-      "dev": true
-    },
-    "node_modules/makeerror": {
-      "version": "1.0.12",
-      "resolved": "https://registry.npmjs.org/makeerror/-/makeerror-1.0.12.tgz",
-      "integrity": "sha512-JmqCvUhmt43madlpFzG4BQzG2Z3m6tvQDNKdClZnO3VbIudJYmxsT0FNJMeiB2+JTSlTQTSbU8QdesVmwJcmLg==",
-      "dev": true,
-      "dependencies": {
-        "tmpl": "1.0.5"
-      }
-    },
-    "node_modules/math-intrinsics": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
-      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
-      "engines": {
-        "node": ">= 0.4"
-      }
-    },
-    "node_modules/media-typer": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-1.1.0.tgz",
-      "integrity": "sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==",
-      "engines": {
-        "node": ">= 0.8"
-      }
-    },
-    "node_modules/memory-pager": {
-      "version": "1.5.0",
-      "resolved": "https://registry.npmjs.org/memory-pager/-/memory-pager-1.5.0.tgz",
-      "integrity": "sha512-ZS4Bp4r/Zoeq6+NLJpP+0Zzm0pR8whtGPf1XExKLJBAczGMnSi3It14OiNCStjQjM6NU1okjQGSxgEZN8eBYKg=="
-    },
-    "node_modules/merge-descriptors": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz",
-      "integrity": "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==",
-      "engines": {
-        "node": ">=18"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/merge-stream": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz",
-      "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==",
-      "dev": true
-    },
-    "node_modules/micromatch": {
-      "version": "4.0.8",
-      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
-      "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",
-      "dev": true,
-      "dependencies": {
-        "braces": "^3.0.3",
-        "picomatch": "^2.3.1"
-      },
-      "engines": {
-        "node": ">=8.6"
-      }
-    },
-    "node_modules/mime-db": {
-      "version": "1.54.0",
-      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz",
-      "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==",
-      "engines": {
-        "node": ">= 0.6"
-      }
-    },
-    "node_modules/mime-types": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.1.tgz",
-      "integrity": "sha512-xRc4oEhT6eaBpU1XF7AjpOFD+xQmXNB5OVKwp4tqCuBpHLS/ZbBDrc07mYTDqVMg6PfxUjjNp85O6Cd2Z/5HWA==",
-      "dependencies": {
-        "mime-db": "^1.54.0"
-      },
-      "engines": {
-        "node": ">= 0.6"
-      }
-    },
-    "node_modules/mimic-fn": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz",
-      "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/minimatch": {
-      "version": "3.1.2",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
-      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
-      "dev": true,
-      "dependencies": {
-        "brace-expansion": "^1.1.7"
-      },
-      "engines": {
-        "node": "*"
-      }
-    },
-    "node_modules/minimist": {
-      "version": "1.2.8",
-      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
-      "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
-      "dev": true,
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/mongodb": {
-      "version": "6.20.0",
-      "resolved": "https://registry.npmjs.org/mongodb/-/mongodb-6.20.0.tgz",
-      "integrity": "sha512-Tl6MEIU3K4Rq3TSHd+sZQqRBoGlFsOgNrH5ltAcFBV62Re3Fd+FcaVf8uSEQFOJ51SDowDVttBTONMfoYWrWlQ==",
-      "dependencies": {
-        "@mongodb-js/saslprep": "^1.3.0",
-        "bson": "^6.10.4",
-        "mongodb-connection-string-url": "^3.0.2"
-      },
-      "engines": {
-        "node": ">=16.20.1"
-      },
-      "peerDependencies": {
-        "@aws-sdk/credential-providers": "^3.188.0",
-        "@mongodb-js/zstd": "^1.1.0 || ^2.0.0",
-        "gcp-metadata": "^5.2.0",
-        "kerberos": "^2.0.1",
-        "mongodb-client-encryption": ">=6.0.0 <7",
-        "snappy": "^7.3.2",
-        "socks": "^2.7.1"
-      },
-      "peerDependenciesMeta": {
-        "@aws-sdk/credential-providers": {
-          "optional": true
-        },
-        "@mongodb-js/zstd": {
-          "optional": true
-        },
-        "gcp-metadata": {
-          "optional": true
-        },
-        "kerberos": {
-          "optional": true
-        },
-        "mongodb-client-encryption": {
-          "optional": true
-        },
-        "snappy": {
-          "optional": true
-        },
-        "socks": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/mongodb-connection-string-url": {
-      "version": "3.0.2",
-      "resolved": "https://registry.npmjs.org/mongodb-connection-string-url/-/mongodb-connection-string-url-3.0.2.tgz",
-      "integrity": "sha512-rMO7CGo/9BFwyZABcKAWL8UJwH/Kc2x0g72uhDWzG48URRax5TCIcJ7Rc3RZqffZzO/Gwff/jyKwCU9TN8gehA==",
-      "dependencies": {
-        "@types/whatwg-url": "^11.0.2",
-        "whatwg-url": "^14.1.0 || ^13.0.0"
-      }
-    },
-    "node_modules/ms": {
-      "version": "2.1.3",
-      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
-      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="
-    },
-    "node_modules/natural-compare": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz",
-      "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==",
-      "dev": true
-    },
-    "node_modules/negotiator": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-1.0.0.tgz",
-      "integrity": "sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg==",
-      "engines": {
-        "node": ">= 0.6"
-      }
-    },
-    "node_modules/neo-async": {
-      "version": "2.6.2",
-      "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz",
-      "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==",
-      "dev": true
-    },
-    "node_modules/node-int64": {
-      "version": "0.4.0",
-      "resolved": "https://registry.npmjs.org/node-int64/-/node-int64-0.4.0.tgz",
-      "integrity": "sha512-O5lz91xSOeoXP6DulyHfllpq+Eg00MWitZIbtPfoSEvqIHdl5gfcY6hYzDWnj0qD5tz52PI08u9qUvSVeUBeHw==",
-      "dev": true
-    },
-    "node_modules/node-releases": {
-      "version": "2.0.23",
-      "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.23.tgz",
-      "integrity": "sha512-cCmFDMSm26S6tQSDpBCg/NR8NENrVPhAJSf+XbxBG4rPFaaonlEoE9wHQmun+cls499TQGSb7ZyPBRlzgKfpeg==",
-      "dev": true
-    },
-    "node_modules/normalize-path": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
-      "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/npm-run-path": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz",
-      "integrity": "sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==",
-      "dev": true,
-      "dependencies": {
-        "path-key": "^3.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/object-assign": {
-      "version": "4.1.1",
-      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
-      "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/object-inspect": {
-      "version": "1.13.4",
-      "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
-      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/on-finished": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
-      "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
-      "dependencies": {
-        "ee-first": "1.1.1"
-      },
-      "engines": {
-        "node": ">= 0.8"
-      }
-    },
-    "node_modules/once": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
-      "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
-      "dependencies": {
-        "wrappy": "1"
-      }
-    },
-    "node_modules/onetime": {
-      "version": "5.1.2",
-      "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz",
-      "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==",
-      "dev": true,
-      "dependencies": {
-        "mimic-fn": "^2.1.0"
-      },
-      "engines": {
-        "node": ">=6"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/p-limit": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz",
-      "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==",
-      "dev": true,
-      "dependencies": {
-        "yocto-queue": "^0.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/p-locate": {
-      "version": "4.1.0",
-      "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz",
-      "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==",
-      "dev": true,
-      "dependencies": {
-        "p-limit": "^2.2.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/p-locate/node_modules/p-limit": {
-      "version": "2.3.0",
-      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz",
-      "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==",
-      "dev": true,
-      "dependencies": {
-        "p-try": "^2.0.0"
-      },
-      "engines": {
-        "node": ">=6"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/p-try": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz",
-      "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/parse-json": {
-      "version": "5.2.0",
-      "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz",
-      "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==",
-      "dev": true,
-      "dependencies": {
-        "@babel/code-frame": "^7.0.0",
-        "error-ex": "^1.3.1",
-        "json-parse-even-better-errors": "^2.3.0",
-        "lines-and-columns": "^1.1.6"
-      },
-      "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/parseurl": {
-      "version": "1.3.3",
-      "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
-      "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
-      "engines": {
-        "node": ">= 0.8"
-      }
-    },
-    "node_modules/path-exists": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
-      "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/path-is-absolute": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
-      "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/path-key": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
-      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/path-parse": {
-      "version": "1.0.7",
-      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
-      "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
-      "dev": true
-    },
-    "node_modules/path-to-regexp": {
-      "version": "8.3.0",
-      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.3.0.tgz",
-      "integrity": "sha512-7jdwVIRtsP8MYpdXSwOS0YdD0Du+qOoF/AEPIt88PcCFrZCzx41oxku1jD88hZBwbNUIEfpqvuhjFaMAqMTWnA==",
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/express"
-      }
-    },
-    "node_modules/picocolors": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
-      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
-      "dev": true
-    },
-    "node_modules/picomatch": {
-      "version": "2.3.1",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
-      "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
-      "dev": true,
-      "engines": {
-        "node": ">=8.6"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/jonschlinkert"
-      }
-    },
-    "node_modules/pirates": {
-      "version": "4.0.7",
-      "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.7.tgz",
-      "integrity": "sha512-TfySrs/5nm8fQJDcBDuUng3VOUKsd7S+zqvbOTiGXHfxX4wK31ard+hoNuvkicM/2YFzlpDgABOevKSsB4G/FA==",
-      "dev": true,
-      "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/pkg-dir": {
-      "version": "4.2.0",
-      "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-4.2.0.tgz",
-      "integrity": "sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==",
-      "dev": true,
-      "dependencies": {
-        "find-up": "^4.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/pretty-format": {
-      "version": "29.7.0",
-      "resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-29.7.0.tgz",
-      "integrity": "sha512-Pdlw/oPxN+aXdmM9R00JVC9WVFoCLTKJvDVLgmJ+qAffBMxsV85l/Lu7sNx4zSzPyoL2euImuEwHhOXdEgNFZQ==",
-      "dev": true,
-      "dependencies": {
-        "@jest/schemas": "^29.6.3",
-        "ansi-styles": "^5.0.0",
-        "react-is": "^18.0.0"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
-      }
-    },
-    "node_modules/pretty-format/node_modules/ansi-styles": {
-      "version": "5.2.0",
-      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz",
-      "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==",
-      "dev": true,
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
-      }
-    },
-    "node_modules/prompts": {
-      "version": "2.4.2",
-      "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz",
-      "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==",
-      "dev": true,
-      "dependencies": {
-        "kleur": "^3.0.3",
-        "sisteransi": "^1.0.5"
-      },
-      "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/proxy-addr": {
-      "version": "2.0.7",
-      "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
-      "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
-      "dependencies": {
-        "forwarded": "0.2.0",
-        "ipaddr.js": "1.9.1"
-      },
-      "engines": {
-        "node": ">= 0.10"
-      }
-    },
-    "node_modules/punycode": {
-      "version": "2.3.1",
-      "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
-      "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/pure-rand": {
-      "version": "6.1.0",
-      "resolved": "https://registry.npmjs.org/pure-rand/-/pure-rand-6.1.0.tgz",
-      "integrity": "sha512-bVWawvoZoBYpp6yIoQtQXHZjmz35RSVHnUOTefl8Vcjr8snTPY1wnpSPMWekcFwbxI6gtmT7rSYPFvz71ldiOA==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "individual",
-          "url": "https://github.com/sponsors/dubzzz"
-        },
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/fast-check"
-        }
-      ]
-    },
-    "node_modules/qs": {
-      "version": "6.14.0",
-      "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.0.tgz",
-      "integrity": "sha512-YWWTjgABSKcvs/nWBi9PycY/JiPJqOD4JA6o9Sej2AtvSGarXxKC3OQSk4pAarbdQlKAh5D4FCQkJNkW+GAn3w==",
-      "dependencies": {
-        "side-channel": "^1.1.0"
-      },
-      "engines": {
-        "node": ">=0.6"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/range-parser": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
-      "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
-      "engines": {
-        "node": ">= 0.6"
-      }
-    },
-    "node_modules/raw-body": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-3.0.1.tgz",
-      "integrity": "sha512-9G8cA+tuMS75+6G/TzW8OtLzmBDMo8p1JRxN5AZ+LAp8uxGA8V8GZm4GQ4/N5QNQEnLmg6SS7wyuSmbKepiKqA==",
-      "dependencies": {
-        "bytes": "3.1.2",
-        "http-errors": "2.0.0",
-        "iconv-lite": "0.7.0",
-        "unpipe": "1.0.0"
-      },
-      "engines": {
-        "node": ">= 0.10"
-      }
-    },
-    "node_modules/raw-body/node_modules/iconv-lite": {
-      "version": "0.7.0",
-      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.7.0.tgz",
-      "integrity": "sha512-cf6L2Ds3h57VVmkZe+Pn+5APsT7FpqJtEhhieDCvrE2MK5Qk9MyffgQyuxQTm6BChfeZNtcOLHp9IcWRVcIcBQ==",
-      "dependencies": {
-        "safer-buffer": ">= 2.1.2 < 3.0.0"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/express"
-      }
-    },
-    "node_modules/react-is": {
-      "version": "18.3.1",
-      "resolved": "https://registry.npmjs.org/react-is/-/react-is-18.3.1.tgz",
-      "integrity": "sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==",
-      "dev": true
-    },
-    "node_modules/require-directory": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
-      "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/resolve": {
-      "version": "1.22.10",
-      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.10.tgz",
-      "integrity": "sha512-NPRy+/ncIMeDlTAsuqwKIiferiawhefFJtkNSW0qZJEqMEb+qBt/77B/jGeeek+F0uOeN05CDa6HXbbIgtVX4w==",
-      "dev": true,
-      "dependencies": {
-        "is-core-module": "^2.16.0",
-        "path-parse": "^1.0.7",
-        "supports-preserve-symlinks-flag": "^1.0.0"
-      },
-      "bin": {
-        "resolve": "bin/resolve"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/resolve-cwd": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/resolve-cwd/-/resolve-cwd-3.0.0.tgz",
-      "integrity": "sha512-OrZaX2Mb+rJCpH/6CpSqt9xFVpN++x01XnN2ie9g6P5/3xelLAkXWVADpdz1IHD/KFfEXyE6V0U01OQ3UO2rEg==",
-      "dev": true,
-      "dependencies": {
-        "resolve-from": "^5.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/resolve-from": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz",
-      "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/resolve.exports": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/resolve.exports/-/resolve.exports-2.0.3.tgz",
-      "integrity": "sha512-OcXjMsGdhL4XnbShKpAcSqPMzQoYkYyhbEaeSko47MjRP9NfEQMhZkXL1DoFlt9LWQn4YttrdnV6X2OiyzBi+A==",
-      "dev": true,
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/router": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/router/-/router-2.2.0.tgz",
-      "integrity": "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==",
-      "dependencies": {
-        "debug": "^4.4.0",
-        "depd": "^2.0.0",
-        "is-promise": "^4.0.0",
-        "parseurl": "^1.3.3",
-        "path-to-regexp": "^8.0.0"
-      },
-      "engines": {
-        "node": ">= 18"
-      }
-    },
-    "node_modules/safe-buffer": {
-      "version": "5.2.1",
-      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
-      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ]
-    },
-    "node_modules/safer-buffer": {
-      "version": "2.1.2",
-      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
-      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg=="
-    },
-    "node_modules/semver": {
-      "version": "6.3.1",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-      "dev": true,
-      "bin": {
-        "semver": "bin/semver.js"
-      }
-    },
-    "node_modules/send": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/send/-/send-1.2.0.tgz",
-      "integrity": "sha512-uaW0WwXKpL9blXE2o0bRhoL2EGXIrZxQ2ZQ4mgcfoBxdFmQold+qWsD2jLrfZ0trjKL6vOw0j//eAwcALFjKSw==",
-      "dependencies": {
-        "debug": "^4.3.5",
-        "encodeurl": "^2.0.0",
-        "escape-html": "^1.0.3",
-        "etag": "^1.8.1",
-        "fresh": "^2.0.0",
-        "http-errors": "^2.0.0",
-        "mime-types": "^3.0.1",
-        "ms": "^2.1.3",
-        "on-finished": "^2.4.1",
-        "range-parser": "^1.2.1",
-        "statuses": "^2.0.1"
-      },
-      "engines": {
-        "node": ">= 18"
-      }
-    },
-    "node_modules/serve-static": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-2.2.0.tgz",
-      "integrity": "sha512-61g9pCh0Vnh7IutZjtLGGpTA355+OPn2TyDv/6ivP2h/AdAVX9azsoxmg2/M6nZeQZNYBEwIcsne1mJd9oQItQ==",
-      "dependencies": {
-        "encodeurl": "^2.0.0",
-        "escape-html": "^1.0.3",
-        "parseurl": "^1.3.3",
-        "send": "^1.2.0"
-      },
-      "engines": {
-        "node": ">= 18"
-      }
-    },
-    "node_modules/setprototypeof": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
-      "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw=="
-    },
-    "node_modules/shebang-command": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
-      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
-      "dev": true,
-      "dependencies": {
-        "shebang-regex": "^3.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/shebang-regex": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
-      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/side-channel": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
-      "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
-      "dependencies": {
-        "es-errors": "^1.3.0",
-        "object-inspect": "^1.13.3",
-        "side-channel-list": "^1.0.0",
-        "side-channel-map": "^1.0.1",
-        "side-channel-weakmap": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/side-channel-list": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz",
-      "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==",
-      "dependencies": {
-        "es-errors": "^1.3.0",
-        "object-inspect": "^1.13.3"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/side-channel-map": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
-      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
-      "dependencies": {
-        "call-bound": "^1.0.2",
-        "es-errors": "^1.3.0",
-        "get-intrinsic": "^1.2.5",
-        "object-inspect": "^1.13.3"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/side-channel-weakmap": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
-      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
-      "dependencies": {
-        "call-bound": "^1.0.2",
-        "es-errors": "^1.3.0",
-        "get-intrinsic": "^1.2.5",
-        "object-inspect": "^1.13.3",
-        "side-channel-map": "^1.0.1"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/signal-exit": {
-      "version": "3.0.7",
-      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz",
-      "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==",
-      "dev": true
-    },
-    "node_modules/sisteransi": {
-      "version": "1.0.5",
-      "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz",
-      "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==",
-      "dev": true
-    },
-    "node_modules/slash": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz",
-      "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/source-map": {
-      "version": "0.6.1",
-      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
-      "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/source-map-support": {
-      "version": "0.5.13",
-      "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.13.tgz",
-      "integrity": "sha512-SHSKFHadjVA5oR4PPqhtAVdcBWwRYVd6g6cAXnIbRiIwc2EhPrTuKUBdSLvlEKyIP3GCf89fltvcZiP9MMFA1w==",
-      "dev": true,
-      "dependencies": {
-        "buffer-from": "^1.0.0",
-        "source-map": "^0.6.0"
-      }
-    },
-    "node_modules/sparse-bitfield": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/sparse-bitfield/-/sparse-bitfield-3.0.3.tgz",
-      "integrity": "sha512-kvzhi7vqKTfkh0PZU+2D2PIllw2ymqJKujUcyPMd9Y75Nv4nPbGJZXNhxsgdQab2BmlDct1YnfQCguEvHr7VsQ==",
-      "dependencies": {
-        "memory-pager": "^1.0.2"
-      }
-    },
-    "node_modules/sprintf-js": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
-      "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==",
-      "dev": true
-    },
-    "node_modules/stack-utils": {
-      "version": "2.0.6",
-      "resolved": "https://registry.npmjs.org/stack-utils/-/stack-utils-2.0.6.tgz",
-      "integrity": "sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ==",
-      "dev": true,
-      "dependencies": {
-        "escape-string-regexp": "^2.0.0"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/statuses": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
-      "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
-      "engines": {
-        "node": ">= 0.8"
-      }
-    },
-    "node_modules/string-length": {
-      "version": "4.0.2",
-      "resolved": "https://registry.npmjs.org/string-length/-/string-length-4.0.2.tgz",
-      "integrity": "sha512-+l6rNN5fYHNhZZy41RXsYptCjA2Igmq4EG7kZAYFQI1E1VTXarr6ZPXBg6eq7Y6eK4FEhY6AJlyuFIb/v/S0VQ==",
-      "dev": true,
-      "dependencies": {
-        "char-regex": "^1.0.2",
-        "strip-ansi": "^6.0.0"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/string-width": {
-      "version": "4.2.3",
-      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
-      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
-      "dev": true,
-      "dependencies": {
-        "emoji-regex": "^8.0.0",
-        "is-fullwidth-code-point": "^3.0.0",
-        "strip-ansi": "^6.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/strip-ansi": {
-      "version": "6.0.1",
-      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
-      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
-      "dev": true,
-      "dependencies": {
-        "ansi-regex": "^5.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/strip-bom": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-4.0.0.tgz",
-      "integrity": "sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/strip-final-newline": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz",
-      "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/strip-json-comments": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz",
-      "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/supports-color": {
-      "version": "7.2.0",
-      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
-      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
-      "dev": true,
-      "dependencies": {
-        "has-flag": "^4.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/supports-preserve-symlinks-flag": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz",
-      "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==",
-      "dev": true,
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/test-exclude": {
-      "version": "6.0.0",
-      "resolved": "https://registry.npmjs.org/test-exclude/-/test-exclude-6.0.0.tgz",
-      "integrity": "sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w==",
-      "dev": true,
-      "dependencies": {
-        "@istanbuljs/schema": "^0.1.2",
-        "glob": "^7.1.4",
-        "minimatch": "^3.0.4"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/tmpl": {
-      "version": "1.0.5",
-      "resolved": "https://registry.npmjs.org/tmpl/-/tmpl-1.0.5.tgz",
-      "integrity": "sha512-3f0uOEAQwIqGuWW2MVzYg8fV/QNnc/IpuJNG837rLuczAaLVHslWHZQj4IGiEl5Hs3kkbhwL9Ab7Hrsmuj+Smw==",
-      "dev": true
-    },
-    "node_modules/to-regex-range": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
-      "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
-      "dev": true,
-      "dependencies": {
-        "is-number": "^7.0.0"
-      },
-      "engines": {
-        "node": ">=8.0"
-      }
-    },
-    "node_modules/toidentifier": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
-      "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
-      "engines": {
-        "node": ">=0.6"
-      }
-    },
-    "node_modules/tr46": {
-      "version": "5.1.1",
-      "resolved": "https://registry.npmjs.org/tr46/-/tr46-5.1.1.tgz",
-      "integrity": "sha512-hdF5ZgjTqgAntKkklYw0R03MG2x/bSzTtkxmIRw/sTNV8YXsCJ1tfLAX23lhxhHJlEf3CRCOCGGWw3vI3GaSPw==",
-      "dependencies": {
-        "punycode": "^2.3.1"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/ts-jest": {
-      "version": "29.4.5",
-      "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.4.5.tgz",
-      "integrity": "sha512-HO3GyiWn2qvTQA4kTgjDcXiMwYQt68a1Y8+JuLRVpdIzm+UOLSHgl/XqR4c6nzJkq5rOkjc02O2I7P7l/Yof0Q==",
-      "dev": true,
-      "dependencies": {
-        "bs-logger": "^0.2.6",
-        "fast-json-stable-stringify": "^2.1.0",
-        "handlebars": "^4.7.8",
-        "json5": "^2.2.3",
-        "lodash.memoize": "^4.1.2",
-        "make-error": "^1.3.6",
-        "semver": "^7.7.3",
-        "type-fest": "^4.41.0",
-        "yargs-parser": "^21.1.1"
-      },
-      "bin": {
-        "ts-jest": "cli.js"
-      },
-      "engines": {
-        "node": "^14.15.0 || ^16.10.0 || ^18.0.0 || >=20.0.0"
-      },
-      "peerDependencies": {
-        "@babel/core": ">=7.0.0-beta.0 <8",
-        "@jest/transform": "^29.0.0 || ^30.0.0",
-        "@jest/types": "^29.0.0 || ^30.0.0",
-        "babel-jest": "^29.0.0 || ^30.0.0",
-        "jest": "^29.0.0 || ^30.0.0",
-        "jest-util": "^29.0.0 || ^30.0.0",
-        "typescript": ">=4.3 <6"
-      },
-      "peerDependenciesMeta": {
-        "@babel/core": {
-          "optional": true
-        },
-        "@jest/transform": {
-          "optional": true
-        },
-        "@jest/types": {
-          "optional": true
-        },
-        "babel-jest": {
-          "optional": true
-        },
-        "esbuild": {
-          "optional": true
-        },
-        "jest-util": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/ts-jest/node_modules/semver": {
-      "version": "7.7.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz",
-      "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==",
-      "dev": true,
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/ts-jest/node_modules/type-fest": {
-      "version": "4.41.0",
-      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-4.41.0.tgz",
-      "integrity": "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==",
-      "dev": true,
-      "engines": {
-        "node": ">=16"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/ts-node": {
-      "version": "10.9.2",
-      "resolved": "https://registry.npmjs.org/ts-node/-/ts-node-10.9.2.tgz",
-      "integrity": "sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==",
-      "dev": true,
-      "dependencies": {
-        "@cspotcode/source-map-support": "^0.8.0",
-        "@tsconfig/node10": "^1.0.7",
-        "@tsconfig/node12": "^1.0.7",
-        "@tsconfig/node14": "^1.0.0",
-        "@tsconfig/node16": "^1.0.2",
-        "acorn": "^8.4.1",
-        "acorn-walk": "^8.1.1",
-        "arg": "^4.1.0",
-        "create-require": "^1.1.0",
-        "diff": "^4.0.1",
-        "make-error": "^1.1.1",
-        "v8-compile-cache-lib": "^3.0.1",
-        "yn": "3.1.1"
-      },
-      "bin": {
-        "ts-node": "dist/bin.js",
-        "ts-node-cwd": "dist/bin-cwd.js",
-        "ts-node-esm": "dist/bin-esm.js",
-        "ts-node-script": "dist/bin-script.js",
-        "ts-node-transpile-only": "dist/bin-transpile.js",
-        "ts-script": "dist/bin-script-deprecated.js"
-      },
-      "peerDependencies": {
-        "@swc/core": ">=1.2.50",
-        "@swc/wasm": ">=1.2.50",
-        "@types/node": "*",
-        "typescript": ">=2.7"
-      },
-      "peerDependenciesMeta": {
-        "@swc/core": {
-          "optional": true
-        },
-        "@swc/wasm": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/type-detect": {
-      "version": "4.0.8",
-      "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.0.8.tgz",
-      "integrity": "sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==",
-      "dev": true,
-      "engines": {
-        "node": ">=4"
-      }
-    },
-    "node_modules/type-fest": {
-      "version": "0.21.3",
-      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.21.3.tgz",
-      "integrity": "sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==",
-      "dev": true,
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/type-is": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/type-is/-/type-is-2.0.1.tgz",
-      "integrity": "sha512-OZs6gsjF4vMp32qrCbiVSkrFmXtG/AZhY3t0iAMrMBiAZyV9oALtXO8hsrHbMXF9x6L3grlFuwW2oAz7cav+Gw==",
-      "dependencies": {
-        "content-type": "^1.0.5",
-        "media-typer": "^1.1.0",
-        "mime-types": "^3.0.0"
-      },
-      "engines": {
-        "node": ">= 0.6"
-      }
-    },
-    "node_modules/typescript": {
-      "version": "5.9.3",
-      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
-      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
-      "dev": true,
-      "bin": {
-        "tsc": "bin/tsc",
-        "tsserver": "bin/tsserver"
-      },
-      "engines": {
-        "node": ">=14.17"
-      }
-    },
-    "node_modules/uglify-js": {
-      "version": "3.19.3",
-      "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.3.tgz",
-      "integrity": "sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==",
-      "dev": true,
-      "optional": true,
-      "bin": {
-        "uglifyjs": "bin/uglifyjs"
-      },
-      "engines": {
-        "node": ">=0.8.0"
-      }
-    },
-    "node_modules/undici-types": {
-      "version": "6.21.0",
-      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
-      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
-      "dev": true
-    },
-    "node_modules/unpipe": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
-      "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
-      "engines": {
-        "node": ">= 0.8"
-      }
-    },
-    "node_modules/update-browserslist-db": {
-      "version": "1.1.3",
-      "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.3.tgz",
-      "integrity": "sha512-UxhIZQ+QInVdunkDAaiazvvT/+fXL5Osr0JZlJulepYu6Jd7qJtDZjlur0emRlT71EN3ScPoE7gvsuIKKNavKw==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/browserslist"
-        },
-        {
-          "type": "tidelift",
-          "url": "https://tidelift.com/funding/github/npm/browserslist"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "dependencies": {
-        "escalade": "^3.2.0",
-        "picocolors": "^1.1.1"
-      },
-      "bin": {
-        "update-browserslist-db": "cli.js"
-      },
-      "peerDependencies": {
-        "browserslist": ">= 4.21.0"
-      }
-    },
-    "node_modules/v8-compile-cache-lib": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz",
-      "integrity": "sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==",
-      "dev": true
-    },
-    "node_modules/v8-to-istanbul": {
-      "version": "9.3.0",
-      "resolved": "https://registry.npmjs.org/v8-to-istanbul/-/v8-to-istanbul-9.3.0.tgz",
-      "integrity": "sha512-kiGUalWN+rgBJ/1OHZsBtU4rXZOfj/7rKQxULKlIzwzQSvMJUUNgPwJEEh7gU6xEVxC0ahoOBvN2YI8GH6FNgA==",
-      "dev": true,
-      "dependencies": {
-        "@jridgewell/trace-mapping": "^0.3.12",
-        "@types/istanbul-lib-coverage": "^2.0.1",
-        "convert-source-map": "^2.0.0"
-      },
-      "engines": {
-        "node": ">=10.12.0"
-      }
-    },
-    "node_modules/v8-to-istanbul/node_modules/@jridgewell/trace-mapping": {
-      "version": "0.3.31",
-      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
-      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
-      "dev": true,
-      "dependencies": {
-        "@jridgewell/resolve-uri": "^3.1.0",
-        "@jridgewell/sourcemap-codec": "^1.4.14"
-      }
-    },
-    "node_modules/vary": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
-      "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
-      "engines": {
-        "node": ">= 0.8"
-      }
-    },
-    "node_modules/walker": {
-      "version": "1.0.8",
-      "resolved": "https://registry.npmjs.org/walker/-/walker-1.0.8.tgz",
-      "integrity": "sha512-ts/8E8l5b7kY0vlWLewOkDXMmPdLcVV4GmOQLyxuSswIJsweeFZtAsMF7k1Nszz+TYBQrlYRmzOnr398y1JemQ==",
-      "dev": true,
-      "dependencies": {
-        "makeerror": "1.0.12"
-      }
-    },
-    "node_modules/webidl-conversions": {
-      "version": "7.0.0",
-      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-7.0.0.tgz",
-      "integrity": "sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g==",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/whatwg-url": {
-      "version": "14.2.0",
-      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-14.2.0.tgz",
-      "integrity": "sha512-De72GdQZzNTUBBChsXueQUnPKDkg/5A5zp7pFDuQAj5UFoENpiACU0wlCvzpAGnTkj++ihpKwKyYewn/XNUbKw==",
-      "dependencies": {
-        "tr46": "^5.1.0",
-        "webidl-conversions": "^7.0.0"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/which": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
-      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
-      "dev": true,
-      "dependencies": {
-        "isexe": "^2.0.0"
-      },
-      "bin": {
-        "node-which": "bin/node-which"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/wordwrap": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz",
-      "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==",
-      "dev": true
-    },
-    "node_modules/wrap-ansi": {
-      "version": "7.0.0",
-      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
-      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
-      "dev": true,
-      "dependencies": {
-        "ansi-styles": "^4.0.0",
-        "string-width": "^4.1.0",
-        "strip-ansi": "^6.0.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
-      }
-    },
-    "node_modules/wrappy": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
-      "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ=="
-    },
-    "node_modules/write-file-atomic": {
-      "version": "4.0.2",
-      "resolved": "https://registry.npmjs.org/write-file-atomic/-/write-file-atomic-4.0.2.tgz",
-      "integrity": "sha512-7KxauUdBmSdWnmpaGFg+ppNjKF8uNLry8LyzjauQDOVONfFLNKrKvQOxZ/VuTIcS/gge/YNahf5RIIQWTSarlg==",
-      "dev": true,
-      "dependencies": {
-        "imurmurhash": "^0.1.4",
-        "signal-exit": "^3.0.7"
-      },
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/y18n": {
-      "version": "5.0.8",
-      "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
-      "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",
-      "dev": true,
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/yallist": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz",
-      "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==",
-      "dev": true
-    },
-    "node_modules/yargs": {
-      "version": "17.7.2",
-      "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.2.tgz",
-      "integrity": "sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==",
-      "dev": true,
-      "dependencies": {
-        "cliui": "^8.0.1",
-        "escalade": "^3.1.1",
-        "get-caller-file": "^2.0.5",
-        "require-directory": "^2.1.1",
-        "string-width": "^4.2.3",
-        "y18n": "^5.0.5",
-        "yargs-parser": "^21.1.1"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/yargs-parser": {
-      "version": "21.1.1",
-      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz",
-      "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==",
-      "dev": true,
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/yn": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/yn/-/yn-3.1.1.tgz",
-      "integrity": "sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/yocto-queue": {
-      "version": "0.1.0",
-      "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",
-      "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==",
-      "dev": true,
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    }
-  }
-}

From 7ea6b1ed74d6bf0b408b975a3f6d5a7eef8f0270 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Fri, 24 Oct 2025 16:57:12 -0400
Subject: [PATCH 013/110] fix: resolve module access issue with driver v5.6

---
 server/java-spring/README.md |  2 ++
 server/java-spring/pom.xml   | 26 +++++++++++++++++++++++---
 2 files changed, 25 insertions(+), 3 deletions(-)

diff --git a/server/java-spring/README.md b/server/java-spring/README.md
index 20c2f87..c0db54c 100644
--- a/server/java-spring/README.md
+++ b/server/java-spring/README.md
@@ -69,6 +69,8 @@ PORT=3001
 CORS_ORIGIN=http://localhost:3000
 ```
 
+> **Note**: This project uses [spring-dotenv](https://github.com/paulschwarz/spring-dotenv) to automatically load `.env` files, similar to Node.js applications. The `.env` file will be loaded automatically when you run the application.
+
 ### 3. Load Sample Data
 
 If you haven't already, load the `sample_mflix` database into your MongoDB instance:
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index e5dcafc..25bdd6e 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -20,8 +20,9 @@
     
     <properties>
         <java.version>17</java.version>
-        <mongodb.driver.version>5.6.1</mongodb.driver.version>
+        <mongodb.driver.version>5.6.0</mongodb.driver.version>
         <springdoc.version>2.8.13</springdoc.version>
+        <dotenv.version>4.0.0</dotenv.version>
     </properties>
     
     <dependencies>
@@ -43,14 +44,33 @@
             <artifactId>mongodb-driver-sync</artifactId>
             <version>${mongodb.driver.version}</version>
         </dependency>
-        
+
+        <!-- Force matching versions for MongoDB dependencies -->
+        <dependency>
+            <groupId>org.mongodb</groupId>
+            <artifactId>bson</artifactId>
+            <version>${mongodb.driver.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.mongodb</groupId>
+            <artifactId>mongodb-driver-core</artifactId>
+            <version>${mongodb.driver.version}</version>
+        </dependency>
+
+        <!-- Spring Dotenv - Load .env files -->
+        <dependency>
+            <groupId>me.paulschwarz</groupId>
+            <artifactId>spring-dotenv</artifactId>
+            <version>${dotenv.version}</version>
+        </dependency>
+
         <!-- Lombok for reducing boilerplate code -->
         <dependency>
             <groupId>org.projectlombok</groupId>
             <artifactId>lombok</artifactId>
             <optional>true</optional>
         </dependency>
-        <!-- Commons Lang for utility functions (force version) -->
+        <!-- Force version for Commons Lang -->
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-lang3</artifactId>

From 462d71fcdb2be0ece7f2bdf23d61dacacbd671f2 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 28 Oct 2025 15:11:51 -0400
Subject: [PATCH 014/110] refactor(RuntimeException): Add new
 DatabaseOperationException.java custom exception

---
 server/java-spring/pom.xml                    |  2 +-
 .../exception/DatabaseOperationException.java | 20 +++++++++++++++++++
 .../exception/GlobalExceptionHandler.java     | 18 +++++++++++++++++
 .../samplemflix/service/MovieServiceImpl.java | 18 ++++++++---------
 4 files changed, 48 insertions(+), 10 deletions(-)
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/exception/DatabaseOperationException.java

diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index 25bdd6e..ed33e67 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -70,7 +70,7 @@
             <artifactId>lombok</artifactId>
             <optional>true</optional>
         </dependency>
-        <!-- Force version for Commons Lang -->
+        <!-- Force version for Commons Lang used by SpringDoc (CVE-2025-48924) -->
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-lang3</artifactId>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/DatabaseOperationException.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/DatabaseOperationException.java
new file mode 100644
index 0000000..44cfd52
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/DatabaseOperationException.java
@@ -0,0 +1,20 @@
+package com.mongodb.samplemflix.exception;
+
+/**
+ * Exception thrown when a database operation fails unexpectedly.
+ * 
+ * This exception results in a 500 Internal Server Error response.
+ * Used for cases where database operations are not acknowledged or
+ * fail to complete as expected.
+ */
+public class DatabaseOperationException extends RuntimeException {
+    
+    public DatabaseOperationException(String message) {
+        super(message);
+    }
+    
+    public DatabaseOperationException(String message, Throwable cause) {
+        super(message, cause);
+    }
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
index fc344ea..c128981 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
@@ -59,6 +59,24 @@ public ResponseEntity<ErrorResponse> handleValidationException(
         return new ResponseEntity<>(errorResponse, HttpStatus.BAD_REQUEST);
     }
 
+    @ExceptionHandler(DatabaseOperationException.class)
+    public ResponseEntity<ErrorResponse> handleDatabaseOperationException(
+            DatabaseOperationException ex, WebRequest request) {
+        logger.error("Database operation error: {}", ex.getMessage());
+
+        ErrorResponse errorResponse = ErrorResponse.builder()
+                .success(false)
+                .message("Database operation failed")
+                .error(ErrorResponse.ErrorDetails.builder()
+                        .message(ex.getMessage())
+                        .code("DATABASE_OPERATION_ERROR")
+                        .build())
+                .timestamp(Instant.now().toString())
+                .build();
+
+        return new ResponseEntity<>(errorResponse, HttpStatus.INTERNAL_SERVER_ERROR);
+    }
+
     @ExceptionHandler(MongoWriteException.class)
     public ResponseEntity<ErrorResponse> handleMongoWriteException(
             MongoWriteException ex, WebRequest request) {
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index e049cfe..9ac2d17 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -4,6 +4,7 @@
 import com.mongodb.client.result.InsertManyResult;
 import com.mongodb.client.result.InsertOneResult;
 import com.mongodb.client.result.UpdateResult;
+import com.mongodb.samplemflix.exception.DatabaseOperationException;
 import com.mongodb.samplemflix.exception.ResourceNotFoundException;
 import com.mongodb.samplemflix.exception.ValidationException;
 import com.mongodb.samplemflix.model.Movie;
@@ -81,13 +82,13 @@ public Movie createMovie(CreateMovieRequest request) {
                 .build();
         
         InsertOneResult result = movieRepository.insertOne(movie);
-        
+
         if (!result.wasAcknowledged()) {
-            throw new RuntimeException("Movie insertion was not acknowledged by the database");
+            throw new DatabaseOperationException("Movie insertion was not acknowledged by the database");
         }
-        
+
         return movieRepository.findById(result.getInsertedId().asObjectId().getValue())
-                .orElseThrow(() -> new RuntimeException("Failed to retrieve created movie"));
+                .orElseThrow(() -> new DatabaseOperationException("Failed to retrieve created movie"));
     }
     
     @Override
@@ -122,9 +123,9 @@ public Map<String, Object> createMoviesBatch(List<CreateMovieRequest> requests)
                 .toList();
         
         InsertManyResult result = movieRepository.insertMany(movies);
-        
+
         if (!result.wasAcknowledged()) {
-            throw new RuntimeException("Batch movie insertion was not acknowledged by the database");
+            throw new DatabaseOperationException("Batch movie insertion was not acknowledged by the database");
         }
         
         return Map.of(
@@ -149,9 +150,9 @@ public Movie updateMovie(String id, UpdateMovieRequest request) {
         if (result.getMatchedCount() == 0) {
             throw new ResourceNotFoundException("Movie not found");
         }
-        
+
         return movieRepository.findById(new ObjectId(id))
-                .orElseThrow(() -> new RuntimeException("Failed to retrieve updated movie"));
+                .orElseThrow(() -> new DatabaseOperationException("Failed to retrieve updated movie"));
     }
     
     @Override
@@ -306,4 +307,3 @@ private Document buildUpdateDocument(UpdateMovieRequest request) {
         return doc;
     }
 }
-

From 170c3c54549594d4f06fd2af29ec3024386bf54e Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 28 Oct 2025 15:17:55 -0400
Subject: [PATCH 015/110] refactor(pojo): apply patch and use POJO codec

---
 .../samplemflix/config/MongoConfig.java       |  18 ++
 .../repository/MovieRepositoryImpl.java       | 289 +-----------------
 2 files changed, 34 insertions(+), 273 deletions(-)

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
index 3afa3a4..ba0c6d6 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
@@ -5,12 +5,17 @@
 import com.mongodb.client.MongoClient;
 import com.mongodb.client.MongoClients;
 import com.mongodb.client.MongoDatabase;
+import org.bson.codecs.configuration.CodecRegistry;
+import org.bson.codecs.pojo.PojoCodecProvider;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 
 import java.util.concurrent.TimeUnit;
 
+import static org.bson.codecs.configuration.CodecRegistries.fromProviders;
+import static org.bson.codecs.configuration.CodecRegistries.fromRegistries;
+
 /**
  * MongoDB configuration class for the Sample MFlix application.
  * <p>
@@ -64,12 +69,25 @@ public MongoClient mongoClient() {
             );
         }
 
+        // Create the POJO codec provider, enabling automatic POJO discovery
+        CodecRegistry pojoCodecRegistry = fromProviders(
+                PojoCodecProvider.builder().automatic(true).build()
+        );
+
+        // Combine the default registry with your new POJO registry
+        // IMPORTANT: The default registry must come FIRST.
+        CodecRegistry registry = fromRegistries(
+                MongoClientSettings.getDefaultCodecRegistry(),
+                pojoCodecRegistry
+        );
+
         // Parse and validate the connection string
         ConnectionString connectionString = new ConnectionString(mongoUri);
 
         // Build client settings with connection pooling and timeouts
         // These settings optimize for both performance and resource management
         MongoClientSettings settings = MongoClientSettings.builder()
+                .codecRegistry(registry)
                 .applyConnectionString(connectionString)
                 // Configure connection pool for optimal performance
                 .applyToConnectionPoolSettings(builder ->
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java
index a8ccc16..6f0c438 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java
@@ -15,45 +15,39 @@
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Optional;
-import java.util.stream.Collectors;
 
 /**
  * Implementation of MovieRepository using MongoDB Java Driver directly.
- * 
- * This class demonstrates direct usage of MongoCollection<Document> for CRUD operations.
- * It manually converts between Movie objects and BSON Documents to provide full control
- * over the MongoDB operations.
- * 
+ *
+ * This class demonstrates direct usage of MongoCollection<Movie> for CRUD operations.
+ * It uses MongoDB's POJO codec to automatically convert between Movie objects and BSON Documents.
+ *
  * This approach is used for educational purposes to show how the MongoDB driver works,
  * rather than using Spring Data MongoDB which abstracts these details.
  */
 @Repository
 public class MovieRepositoryImpl implements MovieRepository {
-    
-    private final MongoCollection<Document> moviesCollection;
-    
+
+    private final MongoCollection<Movie> moviesCollection;
+
     public MovieRepositoryImpl(MongoDatabase mongoDatabase) {
-        this.moviesCollection = mongoDatabase.getCollection("movies");
+        this.moviesCollection = mongoDatabase.getCollection("movies", Movie.class);
     }
     
     @Override
     public InsertOneResult insertOne(Movie movie) {
-        Document doc = movieToDocument(movie);
-        return moviesCollection.insertOne(doc);
+        return moviesCollection.insertOne(movie);
     }
     
     @Override
     public InsertManyResult insertMany(List<Movie> movies) {
-        List<Document> documents = movies.stream()
-                .map(this::movieToDocument)
-                .collect(Collectors.toList());
-        return moviesCollection.insertMany(documents);
+        return moviesCollection.insertMany(movies);
     }
     
     @Override
     public Optional<Movie> findById(ObjectId id) {
-        Document doc = moviesCollection.find(Filters.eq("_id", id)).first();
-        return Optional.ofNullable(doc).map(this::documentToMovie);
+        Movie doc = moviesCollection.find(Filters.eq("_id", id)).first();
+        return Optional.ofNullable(doc);
     }
     
     @Override
@@ -63,7 +57,8 @@ public List<Movie> find(Document filter, Document sort, int skip, int limit) {
                 .sort(sort)
                 .skip(skip)
                 .limit(limit)
-                .forEach(doc -> movies.add(documentToMovie(doc)));
+                .into(movies);
+
         return movies;
     }
     
@@ -89,265 +84,13 @@ public DeleteResult deleteMany(Document filter) {
     
     @Override
     public Optional<Movie> findOneAndDelete(ObjectId id) {
-        Document doc = moviesCollection.findOneAndDelete(Filters.eq("_id", id));
-        return Optional.ofNullable(doc).map(this::documentToMovie);
+        Movie doc = moviesCollection.findOneAndDelete(Filters.eq("_id", id));
+        return Optional.ofNullable(doc);
     }
     
     @Override
     public long countDocuments() {
         return moviesCollection.countDocuments();
     }
-    
-    /**
-     * Converts a Movie object to a BSON Document.
-     * 
-     * @param movie the Movie object
-     * @return the BSON Document
-     */
-    private Document movieToDocument(Movie movie) {
-        Document doc = new Document();
-        
-        if (movie.getId() != null) {
-            doc.append("_id", movie.getId());
-        }
-        if (movie.getTitle() != null) {
-            doc.append("title", movie.getTitle());
-        }
-        if (movie.getYear() != null) {
-            doc.append("year", movie.getYear());
-        }
-        if (movie.getPlot() != null) {
-            doc.append("plot", movie.getPlot());
-        }
-        if (movie.getFullplot() != null) {
-            doc.append("fullplot", movie.getFullplot());
-        }
-        if (movie.getReleased() != null) {
-            doc.append("released", movie.getReleased());
-        }
-        if (movie.getRuntime() != null) {
-            doc.append("runtime", movie.getRuntime());
-        }
-        if (movie.getPoster() != null) {
-            doc.append("poster", movie.getPoster());
-        }
-        if (movie.getGenres() != null) {
-            doc.append("genres", movie.getGenres());
-        }
-        if (movie.getDirectors() != null) {
-            doc.append("directors", movie.getDirectors());
-        }
-        if (movie.getWriters() != null) {
-            doc.append("writers", movie.getWriters());
-        }
-        if (movie.getCast() != null) {
-            doc.append("cast", movie.getCast());
-        }
-        if (movie.getCountries() != null) {
-            doc.append("countries", movie.getCountries());
-        }
-        if (movie.getLanguages() != null) {
-            doc.append("languages", movie.getLanguages());
-        }
-        if (movie.getRated() != null) {
-            doc.append("rated", movie.getRated());
-        }
-        if (movie.getAwards() != null) {
-            doc.append("awards", awardsToDocument(movie.getAwards()));
-        }
-        if (movie.getImdb() != null) {
-            doc.append("imdb", imdbToDocument(movie.getImdb()));
-        }
-        if (movie.getTomatoes() != null) {
-            doc.append("tomatoes", tomatoesToDocument(movie.getTomatoes()));
-        }
-        if (movie.getMetacritic() != null) {
-            doc.append("metacritic", movie.getMetacritic());
-        }
-        if (movie.getType() != null) {
-            doc.append("type", movie.getType());
-        }
-        
-        return doc;
-    }
-    
-    /**
-     * Converts a BSON Document to a Movie object.
-     * 
-     * @param doc the BSON Document
-     * @return the Movie object
-     */
-    @SuppressWarnings("unchecked")
-    private Movie documentToMovie(Document doc) {
-        Movie movie = new Movie();
-        
-        movie.setId(doc.getObjectId("_id"));
-        movie.setTitle(doc.getString("title"));
-        movie.setYear(doc.getInteger("year"));
-        movie.setPlot(doc.getString("plot"));
-        movie.setFullplot(doc.getString("fullplot"));
-        movie.setReleased(doc.getDate("released"));
-        movie.setRuntime(doc.getInteger("runtime"));
-        movie.setPoster(doc.getString("poster"));
-        movie.setGenres((List<String>) doc.get("genres"));
-        movie.setDirectors((List<String>) doc.get("directors"));
-        movie.setWriters((List<String>) doc.get("writers"));
-        movie.setCast((List<String>) doc.get("cast"));
-        movie.setCountries((List<String>) doc.get("countries"));
-        movie.setLanguages((List<String>) doc.get("languages"));
-        movie.setRated(doc.getString("rated"));
-        movie.setMetacritic(doc.getInteger("metacritic"));
-        movie.setType(doc.getString("type"));
-        
-        Document awardsDoc = (Document) doc.get("awards");
-        if (awardsDoc != null) {
-            movie.setAwards(documentToAwards(awardsDoc));
-        }
-        
-        Document imdbDoc = (Document) doc.get("imdb");
-        if (imdbDoc != null) {
-            movie.setImdb(documentToImdb(imdbDoc));
-        }
-        
-        Document tomatoesDoc = (Document) doc.get("tomatoes");
-        if (tomatoesDoc != null) {
-            movie.setTomatoes(documentToTomatoes(tomatoesDoc));
-        }
-        
-        return movie;
-    }
-    
-    private Document awardsToDocument(Movie.Awards awards) {
-        Document doc = new Document();
-        if (awards.getWins() != null) {
-            doc.append("wins", awards.getWins());
-        }
-        if (awards.getNominations() != null) {
-            doc.append("nominations", awards.getNominations());
-        }
-        if (awards.getText() != null) {
-            doc.append("text", awards.getText());
-        }
-        return doc;
-    }
-    
-    private Movie.Awards documentToAwards(Document doc) {
-        return Movie.Awards.builder()
-                .wins(doc.getInteger("wins"))
-                .nominations(doc.getInteger("nominations"))
-                .text(doc.getString("text"))
-                .build();
-    }
-    
-    private Document imdbToDocument(Movie.Imdb imdb) {
-        Document doc = new Document();
-        if (imdb.getRating() != null) {
-            doc.append("rating", imdb.getRating());
-        }
-        if (imdb.getVotes() != null) {
-            doc.append("votes", imdb.getVotes());
-        }
-        if (imdb.getId() != null) {
-            doc.append("id", imdb.getId());
-        }
-        return doc;
-    }
-    
-    private Movie.Imdb documentToImdb(Document doc) {
-        return Movie.Imdb.builder()
-                .rating(doc.getDouble("rating"))
-                .votes(doc.getInteger("votes"))
-                .id(doc.getInteger("id"))
-                .build();
-    }
-
-    private Document tomatoesToDocument(Movie.Tomatoes tomatoes) {
-        Document doc = new Document();
-        if (tomatoes.getViewer() != null) {
-            doc.append("viewer", viewerToDocument(tomatoes.getViewer()));
-        }
-        if (tomatoes.getCritic() != null) {
-            doc.append("critic", criticToDocument(tomatoes.getCritic()));
-        }
-        if (tomatoes.getFresh() != null) {
-            doc.append("fresh", tomatoes.getFresh());
-        }
-        if (tomatoes.getRotten() != null) {
-            doc.append("rotten", tomatoes.getRotten());
-        }
-        if (tomatoes.getProduction() != null) {
-            doc.append("production", tomatoes.getProduction());
-        }
-        if (tomatoes.getLastUpdated() != null) {
-            doc.append("lastUpdated", tomatoes.getLastUpdated());
-        }
-        return doc;
-    }
-
-    private Movie.Tomatoes documentToTomatoes(Document doc) {
-        Movie.Tomatoes.Viewer viewer = null;
-        Document viewerDoc = (Document) doc.get("viewer");
-        if (viewerDoc != null) {
-            viewer = documentToViewer(viewerDoc);
-        }
-
-        Movie.Tomatoes.Critic critic = null;
-        Document criticDoc = (Document) doc.get("critic");
-        if (criticDoc != null) {
-            critic = documentToCritic(criticDoc);
-        }
-
-        return Movie.Tomatoes.builder()
-                .viewer(viewer)
-                .critic(critic)
-                .fresh(doc.getInteger("fresh"))
-                .rotten(doc.getInteger("rotten"))
-                .production(doc.getString("production"))
-                .lastUpdated(doc.getDate("lastUpdated"))
-                .build();
-    }
 
-    private Document viewerToDocument(Movie.Tomatoes.Viewer viewer) {
-        Document doc = new Document();
-        if (viewer.getRating() != null) {
-            doc.append("rating", viewer.getRating());
-        }
-        if (viewer.getNumReviews() != null) {
-            doc.append("numReviews", viewer.getNumReviews());
-        }
-        if (viewer.getMeter() != null) {
-            doc.append("meter", viewer.getMeter());
-        }
-        return doc;
-    }
-
-    private Movie.Tomatoes.Viewer documentToViewer(Document doc) {
-        return Movie.Tomatoes.Viewer.builder()
-                .rating(doc.getDouble("rating"))
-                .numReviews(doc.getInteger("numReviews"))
-                .meter(doc.getInteger("meter"))
-                .build();
-    }
-
-    private Document criticToDocument(Movie.Tomatoes.Critic critic) {
-        Document doc = new Document();
-        if (critic.getRating() != null) {
-            doc.append("rating", critic.getRating());
-        }
-        if (critic.getNumReviews() != null) {
-            doc.append("numReviews", critic.getNumReviews());
-        }
-        if (critic.getMeter() != null) {
-            doc.append("meter", critic.getMeter());
-        }
-        return doc;
-    }
-
-    private Movie.Tomatoes.Critic documentToCritic(Document doc) {
-        return Movie.Tomatoes.Critic.builder()
-                .rating(doc.getDouble("rating"))
-                .numReviews(doc.getInteger("numReviews"))
-                .meter(doc.getInteger("meter"))
-                .build();
-    }
 }

From 2ea3ff0948d3e97033006470963590197fac9140 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 28 Oct 2025 15:21:38 -0400
Subject: [PATCH 016/110] refactor(serializer): Apply patch and use
 ObjectMapper

---
 .../config/ObjectIdSerializer.java            | 25 +++++++
 .../config/ObjectMapperConfig.java            | 39 ++++++++++
 .../samplemflix/service/MovieServiceImpl.java | 72 ++++---------------
 3 files changed, 77 insertions(+), 59 deletions(-)
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectIdSerializer.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectMapperConfig.java

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectIdSerializer.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectIdSerializer.java
new file mode 100644
index 0000000..56c2649
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectIdSerializer.java
@@ -0,0 +1,25 @@
+package com.mongodb.samplemflix.config;
+
+import com.fasterxml.jackson.core.JsonGenerator;
+import com.fasterxml.jackson.databind.SerializerProvider;
+import com.fasterxml.jackson.databind.ser.std.StdSerializer;
+import java.io.IOException;
+import org.bson.types.ObjectId;
+
+// ObjectId is a MognoDB GUID Class, an efficient 12 byte UUID starting with a
+// timestamp for efficnent indexing - we need to teach Jackson how to convert it
+// to JSON nicely
+
+public class ObjectIdSerializer extends StdSerializer<ObjectId> {
+
+    public ObjectIdSerializer() {
+        super(ObjectId.class);
+    }
+
+    @Override
+    public void serialize(ObjectId value, JsonGenerator gen, SerializerProvider provider)
+            throws IOException {
+        gen.writeString(value.toHexString());
+    }
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectMapperConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectMapperConfig.java
new file mode 100644
index 0000000..ba55e71
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectMapperConfig.java
@@ -0,0 +1,39 @@
+package com.mongodb.samplemflix.config;
+
+import com.fasterxml.jackson.core.JsonFactory;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.SerializationFeature;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
+import org.bson.types.ObjectId;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.core.io.buffer.DataBufferFactory;
+import org.springframework.core.io.buffer.DefaultDataBufferFactory;
+
+@Configuration
+public class ObjectMapperConfig {
+
+    @Bean
+    public ObjectMapper objectMapper(JsonFactory jsonFactory) {
+        ObjectMapper mapper =
+                new ObjectMapper(jsonFactory)
+                        .disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS)
+                        .registerModule(new JavaTimeModule());
+        SimpleModule module = new SimpleModule();
+        module.addSerializer(ObjectId.class, new ObjectIdSerializer());
+        mapper.registerModule(module);
+        return mapper;
+    }
+
+    @Bean
+    public JsonFactory jsonFactory() {
+        return new JsonFactory();
+    }
+
+    @Bean
+    public DataBufferFactory dataBufferFactory() {
+        return new DefaultDataBufferFactory();
+    }
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 9ac2d17..88a724d 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -3,6 +3,7 @@
 import com.mongodb.client.result.DeleteResult;
 import com.mongodb.client.result.InsertManyResult;
 import com.mongodb.client.result.InsertOneResult;
+import com.fasterxml.jackson.databind.ObjectMapper;
 import com.mongodb.client.result.UpdateResult;
 import com.mongodb.samplemflix.exception.DatabaseOperationException;
 import com.mongodb.samplemflix.exception.ResourceNotFoundException;
@@ -31,11 +32,13 @@
  */
 @Service
 public class MovieServiceImpl implements MovieService {
-    
+
     private final MovieRepository movieRepository;
-    
-    public MovieServiceImpl(MovieRepository movieRepository) {
+    private final ObjectMapper objectMapper;
+
+    public MovieServiceImpl(MovieRepository movieRepository, ObjectMapper objectMapper) {
         this.movieRepository = movieRepository;
+        this.objectMapper = objectMapper;
     }
     
     @Override
@@ -246,64 +249,15 @@ private Document buildSort(String sortBy, String sortOrder) {
     }
     
     private boolean isUpdateRequestEmpty(UpdateMovieRequest request) {
-        return request.getTitle() == null &&
-               request.getYear() == null &&
-               request.getPlot() == null &&
-               request.getFullplot() == null &&
-               request.getGenres() == null &&
-               request.getDirectors() == null &&
-               request.getWriters() == null &&
-               request.getCast() == null &&
-               request.getCountries() == null &&
-               request.getLanguages() == null &&
-               request.getRated() == null &&
-               request.getRuntime() == null &&
-               request.getPoster() == null;
+        @SuppressWarnings("unchecked")
+        Map<String, Object> requestMap = objectMapper.convertValue(request, Map.class);
+        return requestMap.values().stream().allMatch(java.util.Objects::isNull);
     }
     
     private Document buildUpdateDocument(UpdateMovieRequest request) {
-        Document doc = new Document();
-        
-        if (request.getTitle() != null) {
-            doc.append("title", request.getTitle());
-        }
-        if (request.getYear() != null) {
-            doc.append("year", request.getYear());
-        }
-        if (request.getPlot() != null) {
-            doc.append("plot", request.getPlot());
-        }
-        if (request.getFullplot() != null) {
-            doc.append("fullplot", request.getFullplot());
-        }
-        if (request.getGenres() != null) {
-            doc.append("genres", request.getGenres());
-        }
-        if (request.getDirectors() != null) {
-            doc.append("directors", request.getDirectors());
-        }
-        if (request.getWriters() != null) {
-            doc.append("writers", request.getWriters());
-        }
-        if (request.getCast() != null) {
-            doc.append("cast", request.getCast());
-        }
-        if (request.getCountries() != null) {
-            doc.append("countries", request.getCountries());
-        }
-        if (request.getLanguages() != null) {
-            doc.append("languages", request.getLanguages());
-        }
-        if (request.getRated() != null) {
-            doc.append("rated", request.getRated());
-        }
-        if (request.getRuntime() != null) {
-            doc.append("runtime", request.getRuntime());
-        }
-        if (request.getPoster() != null) {
-            doc.append("poster", request.getPoster());
-        }
-        
-        return doc;
+        @SuppressWarnings("unchecked")
+        Map<String, Object> requestMap = objectMapper.convertValue(request, Map.class);
+        requestMap.values().removeIf(java.util.Objects::isNull);
+        return new Document(requestMap);
     }
 }

From f454cc8892b65cdc4d96d59b33e06b2cb5a042e0 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 28 Oct 2025 15:26:58 -0400
Subject: [PATCH 017/110] refactor(field names): implement nested fields
 consistently

---
 .../config/DatabaseVerification.java          | 11 +++--
 .../com/mongodb/samplemflix/model/Movie.java  | 41 +++++++++++++++++++
 .../repository/MovieRepositoryImpl.java       |  8 ++--
 .../samplemflix/service/MovieServiceImpl.java | 18 ++++----
 4 files changed, 61 insertions(+), 17 deletions(-)

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
index 6063bb6..c11a4b6 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -4,6 +4,7 @@
 import com.mongodb.client.MongoDatabase;
 import com.mongodb.client.model.IndexOptions;
 import com.mongodb.client.model.Indexes;
+import com.mongodb.samplemflix.model.Movie;
 import org.bson.Document;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -122,13 +123,15 @@ private void createTextSearchIndex(MongoCollection<Document> moviesCollection) {
                     .name(TEXT_INDEX_NAME)
                     .background(true);
 
-            // Create the text index
+            // Create the text index using field name constants from Movie.Fields
+            // This makes the coupling between Movie class and index creation explicit
+            // and allows IDE "Find Usages" to track dependencies
             // MongoDB will automatically ignore this if the index already exists
             moviesCollection.createIndex(
                 Indexes.compoundIndex(
-                    Indexes.text("plot"),
-                    Indexes.text("title"),
-                    Indexes.text("fullplot")
+                    Indexes.text(Movie.Fields.PLOT),
+                    Indexes.text(Movie.Fields.TITLE),
+                    Indexes.text(Movie.Fields.FULLPLOT)
                 ),
                 indexOptions
             );
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
index 98235e0..4efe341 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
@@ -28,6 +28,47 @@
 @AllArgsConstructor
 public class Movie {
 
+    /**
+     * Field name constants for MongoDB operations.
+     * <p>
+     * These constants should be used when referencing field names in queries, filters,
+     * indexes, and other MongoDB operations to ensure type safety and enable IDE
+     * "Find Usages" functionality.
+     * <p>
+     * Example usage:
+     * <pre>
+     * filter.append(Movie.Fields.TITLE, "The Matrix");
+     * Indexes.text(Movie.Fields.PLOT);
+     * </pre>
+     */
+    public static class Fields {
+        public static final String ID = "_id";
+        public static final String TITLE = "title";
+        public static final String YEAR = "year";
+        public static final String PLOT = "plot";
+        public static final String FULLPLOT = "fullplot";
+        public static final String RELEASED = "released";
+        public static final String RUNTIME = "runtime";
+        public static final String POSTER = "poster";
+        public static final String GENRES = "genres";
+        public static final String DIRECTORS = "directors";
+        public static final String WRITERS = "writers";
+        public static final String CAST = "cast";
+        public static final String COUNTRIES = "countries";
+        public static final String LANGUAGES = "languages";
+        public static final String RATED = "rated";
+        public static final String AWARDS = "awards";
+        public static final String IMDB = "imdb";
+        public static final String IMDB_RATING = "imdb.rating";
+        public static final String TOMATOES = "tomatoes";
+        public static final String METACRITIC = "metacritic";
+        public static final String TYPE = "type";
+
+        private Fields() {
+            // Private constructor to prevent instantiation
+        }
+    }
+
     /**
      * MongoDB document ID.
      * Maps to the _id field in MongoDB.
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java
index 6f0c438..95a87c6 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java
@@ -46,7 +46,7 @@ public InsertManyResult insertMany(List<Movie> movies) {
     
     @Override
     public Optional<Movie> findById(ObjectId id) {
-        Movie doc = moviesCollection.find(Filters.eq("_id", id)).first();
+        Movie doc = moviesCollection.find(Filters.eq(Movie.Fields.ID, id)).first();
         return Optional.ofNullable(doc);
     }
     
@@ -64,7 +64,7 @@ public List<Movie> find(Document filter, Document sort, int skip, int limit) {
     
     @Override
     public UpdateResult updateOne(ObjectId id, Document update) {
-        return moviesCollection.updateOne(Filters.eq("_id", id), update);
+        return moviesCollection.updateOne(Filters.eq(Movie.Fields.ID, id), update);
     }
     
     @Override
@@ -74,7 +74,7 @@ public UpdateResult updateMany(Document filter, Document update) {
     
     @Override
     public DeleteResult deleteOne(ObjectId id) {
-        return moviesCollection.deleteOne(Filters.eq("_id", id));
+        return moviesCollection.deleteOne(Filters.eq(Movie.Fields.ID, id));
     }
     
     @Override
@@ -84,7 +84,7 @@ public DeleteResult deleteMany(Document filter) {
     
     @Override
     public Optional<Movie> findOneAndDelete(ObjectId id) {
-        Movie doc = moviesCollection.findOneAndDelete(Filters.eq("_id", id));
+        Movie doc = moviesCollection.findOneAndDelete(Filters.eq(Movie.Fields.ID, id));
         return Optional.ofNullable(doc);
     }
     
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 88a724d..e406ffe 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -215,19 +215,19 @@ public Movie findAndDeleteMovie(String id) {
     
     private Document buildFilter(MovieSearchQuery query) {
         Document filter = new Document();
-        
+
         if (query.getQ() != null && !query.getQ().trim().isEmpty()) {
             filter.append("$text", new Document("$search", query.getQ()));
         }
-        
+
         if (query.getGenre() != null && !query.getGenre().trim().isEmpty()) {
-            filter.append("genres", new Document("$regex", Pattern.compile(query.getGenre(), Pattern.CASE_INSENSITIVE)));
+            filter.append(Movie.Fields.GENRES, new Document("$regex", Pattern.compile(query.getGenre(), Pattern.CASE_INSENSITIVE)));
         }
-        
+
         if (query.getYear() != null) {
-            filter.append("year", query.getYear());
+            filter.append(Movie.Fields.YEAR, query.getYear());
         }
-        
+
         if (query.getMinRating() != null || query.getMaxRating() != null) {
             Document ratingFilter = new Document();
             if (query.getMinRating() != null) {
@@ -236,14 +236,14 @@ private Document buildFilter(MovieSearchQuery query) {
             if (query.getMaxRating() != null) {
                 ratingFilter.append("$lte", query.getMaxRating());
             }
-            filter.append("imdb.rating", ratingFilter);
+            filter.append(Movie.Fields.IMDB_RATING, ratingFilter);
         }
-        
+
         return filter;
     }
     
     private Document buildSort(String sortBy, String sortOrder) {
-        String field = sortBy != null && !sortBy.trim().isEmpty() ? sortBy : "title";
+        String field = sortBy != null && !sortBy.trim().isEmpty() ? sortBy : Movie.Fields.TITLE;
         int order = "desc".equalsIgnoreCase(sortOrder) ? -1 : 1;
         return new Document(field, order);
     }

From c6eeb46843a8cca597ea99f84f5ac59af3543cd9 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 28 Oct 2025 15:36:15 -0400
Subject: [PATCH 018/110] test: add new tests based on refactors

---
 .../samplemflix/service/MovieServiceImpl.java |   2 +-
 .../controller/MovieControllerTest.java       | 330 +++++++++++-
 .../samplemflix/service/MovieServiceTest.java | 483 +++++++++++++++++-
 3 files changed, 796 insertions(+), 19 deletions(-)

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index e406ffe..88c35cd 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -23,7 +23,7 @@
 
 /**
  * Service layer for movie business logic.
- * 
+ * <p>
  * This service handles:
  * - Business logic and validation
  * - Query construction (filters, sorts, pagination)
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
index f8c6da0..cf8dedd 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
@@ -1,14 +1,326 @@
 package com.mongodb.samplemflix.controller;
 
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.mongodb.samplemflix.exception.ResourceNotFoundException;
+import com.mongodb.samplemflix.exception.ValidationException;
+import com.mongodb.samplemflix.model.Movie;
+import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
+import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
+import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
+import com.mongodb.samplemflix.service.MovieService;
+import org.bson.types.ObjectId;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
+import org.springframework.boot.test.mock.mockito.MockBean;
+import org.springframework.http.MediaType;
+import org.springframework.test.web.servlet.MockMvc;
+
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.hamcrest.Matchers.*;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.Mockito.when;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
+
 /**
- * Unit tests for MovieController.
- * 
- * TODO: Phase 8 - Implement controller unit tests
- * TODO: Phase 8 - Mock service layer
- * TODO: Phase 8 - Test all endpoints
+ * Unit tests for MovieControllerImpl.
+ *
+ * These tests verify the REST API endpoints by mocking the service layer.
+ * Uses Spring's MockMvc for testing HTTP requests and responses.
  */
-public class MovieControllerTest {
-    
-    // TODO: Phase 8 - Add test methods
-}
+@WebMvcTest(MovieControllerImpl.class)
+@DisplayName("MovieController Unit Tests")
+class MovieControllerTest {
+
+    @Autowired
+    private MockMvc mockMvc;
+
+    @Autowired
+    private ObjectMapper objectMapper;
+
+    @MockBean
+    private MovieService movieService;
+
+    private ObjectId testId;
+    private Movie testMovie;
+    private CreateMovieRequest createRequest;
+    private UpdateMovieRequest updateRequest;
+
+    @BeforeEach
+    void setUp() {
+        testId = new ObjectId();
+
+        testMovie = Movie.builder()
+                .id(testId)
+                .title("Test Movie")
+                .year(2024)
+                .plot("A test plot")
+                .genres(Arrays.asList("Action", "Drama"))
+                .build();
+
+        createRequest = CreateMovieRequest.builder()
+                .title("New Movie")
+                .year(2024)
+                .plot("A new movie plot")
+                .build();
+
+        updateRequest = UpdateMovieRequest.builder()
+                .title("Updated Title")
+                .year(2025)
+                .build();
+    }
+
+    // ==================== GET ALL MOVIES TESTS ====================
+
+    @Test
+    @DisplayName("GET /api/movies - Should return list of movies")
+    void testGetAllMovies_Success() throws Exception {
+        // Arrange
+        List<Movie> movies = Arrays.asList(testMovie);
+        when(movieService.getAllMovies(any(MovieSearchQuery.class))).thenReturn(movies);
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray())
+                .andExpect(jsonPath("$.data", hasSize(1)))
+                .andExpect(jsonPath("$.data[0].title").value("Test Movie"))
+                .andExpect(jsonPath("$.data[0].year").value(2024));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies - Should handle query parameters")
+    void testGetAllMovies_WithQueryParams() throws Exception {
+        // Arrange
+        List<Movie> movies = Arrays.asList(testMovie);
+        when(movieService.getAllMovies(any(MovieSearchQuery.class))).thenReturn(movies);
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies")
+                        .param("q", "test")
+                        .param("genre", "Action")
+                        .param("year", "2024")
+                        .param("limit", "10")
+                        .param("skip", "0"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray());
+    }
+
+    // ==================== GET MOVIE BY ID TESTS ====================
+
+    @Test
+    @DisplayName("GET /api/movies/{id} - Should return movie by ID")
+    void testGetMovieById_Success() throws Exception {
+        // Arrange
+        String movieId = testId.toHexString();
+        when(movieService.getMovieById(movieId)).thenReturn(testMovie);
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/{id}", movieId))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data.title").value("Test Movie"))
+                .andExpect(jsonPath("$.data.year").value(2024));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/{id} - Should return 404 when movie not found")
+    void testGetMovieById_NotFound() throws Exception {
+        // Arrange
+        String movieId = testId.toHexString();
+        when(movieService.getMovieById(movieId))
+                .thenThrow(new ResourceNotFoundException("Movie not found"));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/{id}", movieId))
+                .andExpect(status().isNotFound())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("RESOURCE_NOT_FOUND"))
+                .andExpect(jsonPath("$.error.message").value("Movie not found"));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/{id} - Should return 400 for invalid ID")
+    void testGetMovieById_InvalidId() throws Exception {
+        // Arrange
+        String invalidId = "invalid-id";
+        when(movieService.getMovieById(invalidId))
+                .thenThrow(new ValidationException("Invalid movie ID format"));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/{id}", invalidId))
+                .andExpect(status().isBadRequest())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("VALIDATION_ERROR"));
+    }
 
+    // ==================== CREATE MOVIE TESTS ====================
+
+    @Test
+    @DisplayName("POST /api/movies - Should create movie successfully")
+    void testCreateMovie_Success() throws Exception {
+        // Arrange
+        when(movieService.createMovie(any(CreateMovieRequest.class))).thenReturn(testMovie);
+
+        // Act & Assert
+        mockMvc.perform(post("/api/movies")
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content(objectMapper.writeValueAsString(createRequest)))
+                .andExpect(status().isCreated())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data.title").value("Test Movie"));
+    }
+
+    @Test
+    @DisplayName("POST /api/movies - Should return 400 for validation error")
+    void testCreateMovie_ValidationError() throws Exception {
+        // Arrange
+        when(movieService.createMovie(any(CreateMovieRequest.class)))
+                .thenThrow(new ValidationException("Title is required"));
+
+        // Act & Assert
+        mockMvc.perform(post("/api/movies")
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content(objectMapper.writeValueAsString(createRequest)))
+                .andExpect(status().isBadRequest())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("VALIDATION_ERROR"));
+    }
+
+    @Test
+    @DisplayName("POST /api/movies/batch - Should create movies batch successfully")
+    void testCreateMoviesBatch_Success() throws Exception {
+        // Arrange
+        List<CreateMovieRequest> requests = Arrays.asList(createRequest, createRequest);
+        Map<String, Object> response = new HashMap<>();
+        response.put("success", true);
+        response.put("insertedCount", 2);
+
+        when(movieService.createMoviesBatch(anyList())).thenReturn(response);
+
+        // Act & Assert
+        mockMvc.perform(post("/api/movies/batch")
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content(objectMapper.writeValueAsString(requests)))
+                .andExpect(status().isCreated())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data.insertedCount").value(2));
+    }
+
+    // ==================== UPDATE MOVIE TESTS ====================
+
+    @Test
+    @DisplayName("PUT /api/movies/{id} - Should update movie successfully")
+    void testUpdateMovie_Success() throws Exception {
+        // Arrange
+        String movieId = testId.toHexString();
+        Movie updatedMovie = Movie.builder()
+                .id(testId)
+                .title("Updated Title")
+                .year(2025)
+                .build();
+
+        when(movieService.updateMovie(eq(movieId), any(UpdateMovieRequest.class)))
+                .thenReturn(updatedMovie);
+
+        // Act & Assert
+        mockMvc.perform(put("/api/movies/{id}", movieId)
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content(objectMapper.writeValueAsString(updateRequest)))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data.title").value("Updated Title"))
+                .andExpect(jsonPath("$.data.year").value(2025));
+    }
+
+    @Test
+    @DisplayName("PUT /api/movies/{id} - Should return 404 when movie not found")
+    void testUpdateMovie_NotFound() throws Exception {
+        // Arrange
+        String movieId = testId.toHexString();
+        when(movieService.updateMovie(eq(movieId), any(UpdateMovieRequest.class)))
+                .thenThrow(new ResourceNotFoundException("Movie not found"));
+
+        // Act & Assert
+        mockMvc.perform(put("/api/movies/{id}", movieId)
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content(objectMapper.writeValueAsString(updateRequest)))
+                .andExpect(status().isNotFound())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("RESOURCE_NOT_FOUND"));
+    }
+
+    // ==================== DELETE MOVIE TESTS ====================
+
+    @Test
+    @DisplayName("DELETE /api/movies/{id} - Should delete movie successfully")
+    void testDeleteMovie_Success() throws Exception {
+        // Arrange
+        String movieId = testId.toHexString();
+        Map<String, Object> response = new HashMap<>();
+        response.put("success", true);
+        response.put("deletedCount", 1L);
+
+        when(movieService.deleteMovie(movieId)).thenReturn(response);
+
+        // Act & Assert
+        mockMvc.perform(delete("/api/movies/{id}", movieId))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data.deletedCount").value(1));
+    }
+
+    @Test
+    @DisplayName("DELETE /api/movies/{id} - Should return 404 when movie not found")
+    void testDeleteMovie_NotFound() throws Exception {
+        // Arrange
+        String movieId = testId.toHexString();
+        when(movieService.deleteMovie(movieId))
+                .thenThrow(new ResourceNotFoundException("Movie not found"));
+
+        // Act & Assert
+        mockMvc.perform(delete("/api/movies/{id}", movieId))
+                .andExpect(status().isNotFound())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("RESOURCE_NOT_FOUND"));
+    }
+
+    @Test
+    @DisplayName("DELETE /api/movies/{id}/find-and-delete - Should find and delete movie successfully")
+    void testFindAndDeleteMovie_Success() throws Exception {
+        // Arrange
+        String movieId = testId.toHexString();
+        when(movieService.findAndDeleteMovie(movieId)).thenReturn(testMovie);
+
+        // Act & Assert
+        mockMvc.perform(delete("/api/movies/{id}/find-and-delete", movieId))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data.title").value("Test Movie"));
+    }
+
+    @Test
+    @DisplayName("DELETE /api/movies/{id}/find-and-delete - Should return 404 when movie not found")
+    void testFindAndDeleteMovie_NotFound() throws Exception {
+        // Arrange
+        String movieId = testId.toHexString();
+        when(movieService.findAndDeleteMovie(movieId))
+                .thenThrow(new ResourceNotFoundException("Movie not found"));
+
+        // Act & Assert
+        mockMvc.perform(delete("/api/movies/{id}/find-and-delete", movieId))
+                .andExpect(status().isNotFound())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("RESOURCE_NOT_FOUND"));
+    }
+}
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
index bf8dabe..0a45520 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
@@ -1,14 +1,479 @@
 package com.mongodb.samplemflix.service;
 
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.mongodb.client.result.DeleteResult;
+import com.mongodb.client.result.InsertManyResult;
+import com.mongodb.client.result.InsertOneResult;
+import com.mongodb.client.result.UpdateResult;
+import com.mongodb.samplemflix.exception.DatabaseOperationException;
+import com.mongodb.samplemflix.exception.ResourceNotFoundException;
+import com.mongodb.samplemflix.exception.ValidationException;
+import com.mongodb.samplemflix.model.Movie;
+import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
+import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
+import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
+import com.mongodb.samplemflix.repository.MovieRepository;
+import org.bson.BsonObjectId;
+import org.bson.Document;
+import org.bson.types.ObjectId;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+
+import java.util.*;
+
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.Mockito.*;
+
 /**
- * Unit tests for MovieService.
- * 
- * TODO: Phase 8 - Implement service unit tests
- * TODO: Phase 8 - Mock repository layer
- * TODO: Phase 8 - Test business logic
+ * Unit tests for MovieServiceImpl.
+ *
+ * These tests verify the business logic of the service layer
+ * by mocking the repository layer dependencies.
  */
-public class MovieServiceTest {
-    
-    // TODO: Phase 8 - Add test methods
-}
+@ExtendWith(MockitoExtension.class)
+@DisplayName("MovieService Unit Tests")
+class MovieServiceTest {
+
+    @Mock
+    private MovieRepository movieRepository;
+
+    @Mock
+    private ObjectMapper objectMapper;
+
+    @InjectMocks
+    private MovieServiceImpl movieService;
+
+    private ObjectId testId;
+    private Movie testMovie;
+    private CreateMovieRequest createRequest;
+    private UpdateMovieRequest updateRequest;
+
+    @BeforeEach
+    void setUp() {
+        testId = new ObjectId();
+
+        testMovie = Movie.builder()
+                .id(testId)
+                .title("Test Movie")
+                .year(2024)
+                .plot("A test plot")
+                .genres(Arrays.asList("Action", "Drama"))
+                .build();
+
+        createRequest = CreateMovieRequest.builder()
+                .title("New Movie")
+                .year(2024)
+                .plot("A new movie plot")
+                .build();
+
+        updateRequest = UpdateMovieRequest.builder()
+                .title("Updated Title")
+                .year(2025)
+                .build();
+    }
+
+    // ==================== GET ALL MOVIES TESTS ====================
+
+    @Test
+    @DisplayName("Should get all movies with default pagination")
+    void testGetAllMovies_WithDefaults() {
+        // Arrange
+        MovieSearchQuery query = MovieSearchQuery.builder().build();
+        List<Movie> expectedMovies = Arrays.asList(testMovie);
+
+        when(movieRepository.find(any(Document.class), any(Document.class), eq(0), eq(20)))
+                .thenReturn(expectedMovies);
+
+        // Act
+        List<Movie> result = movieService.getAllMovies(query);
+
+        // Assert
+        assertNotNull(result);
+        assertEquals(1, result.size());
+        assertEquals(testMovie.getTitle(), result.get(0).getTitle());
+        verify(movieRepository).find(any(Document.class), any(Document.class), eq(0), eq(20));
+    }
+
+    @Test
+    @DisplayName("Should get all movies with custom pagination")
+    void testGetAllMovies_WithCustomPagination() {
+        // Arrange
+        MovieSearchQuery query = MovieSearchQuery.builder()
+                .limit(50)
+                .skip(10)
+                .build();
+        List<Movie> expectedMovies = Arrays.asList(testMovie);
+
+        when(movieRepository.find(any(Document.class), any(Document.class), eq(10), eq(50)))
+                .thenReturn(expectedMovies);
+
+        // Act
+        List<Movie> result = movieService.getAllMovies(query);
+
+        // Assert
+        assertNotNull(result);
+        assertEquals(1, result.size());
+        verify(movieRepository).find(any(Document.class), any(Document.class), eq(10), eq(50));
+    }
+
+    @Test
+    @DisplayName("Should enforce maximum limit of 100")
+    void testGetAllMovies_EnforcesMaxLimit() {
+        // Arrange
+        MovieSearchQuery query = MovieSearchQuery.builder()
+                .limit(200)
+                .build();
+
+        when(movieRepository.find(any(Document.class), any(Document.class), eq(0), eq(100)))
+                .thenReturn(Collections.emptyList());
+
+        // Act
+        movieService.getAllMovies(query);
+
+        // Assert
+        verify(movieRepository).find(any(Document.class), any(Document.class), eq(0), eq(100));
+    }
+
+    @Test
+    @DisplayName("Should enforce minimum limit of 1")
+    void testGetAllMovies_EnforcesMinLimit() {
+        // Arrange
+        MovieSearchQuery query = MovieSearchQuery.builder()
+                .limit(0)
+                .build();
+
+        when(movieRepository.find(any(Document.class), any(Document.class), eq(0), eq(1)))
+                .thenReturn(Collections.emptyList());
+
+        // Act
+        movieService.getAllMovies(query);
+
+        // Assert
+        verify(movieRepository).find(any(Document.class), any(Document.class), eq(0), eq(1));
+    }
+
+    // ==================== GET MOVIE BY ID TESTS ====================
+
+    @Test
+    @DisplayName("Should get movie by valid ID")
+    void testGetMovieById_ValidId() {
+        // Arrange
+        String validId = testId.toHexString();
+        when(movieRepository.findById(testId)).thenReturn(Optional.of(testMovie));
+
+        // Act
+        Movie result = movieService.getMovieById(validId);
+
+        // Assert
+        assertNotNull(result);
+        assertEquals(testMovie.getTitle(), result.getTitle());
+        verify(movieRepository).findById(testId);
+    }
+
+    @Test
+    @DisplayName("Should throw ValidationException for invalid ID format")
+    void testGetMovieById_InvalidIdFormat() {
+        // Arrange
+        String invalidId = "invalid-id";
+
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.getMovieById(invalidId));
+        verify(movieRepository, never()).findById(any());
+    }
+
+    @Test
+    @DisplayName("Should throw ResourceNotFoundException when movie not found")
+    void testGetMovieById_NotFound() {
+        // Arrange
+        String validId = testId.toHexString();
+        when(movieRepository.findById(testId)).thenReturn(Optional.empty());
+
+        // Act & Assert
+        assertThrows(ResourceNotFoundException.class, () -> movieService.getMovieById(validId));
+        verify(movieRepository).findById(testId);
+    }
+
+    // ==================== CREATE MOVIE TESTS ====================
+
+    @Test
+    @DisplayName("Should create movie successfully")
+    void testCreateMovie_Success() {
+        // Arrange
+        InsertOneResult insertResult = mock(InsertOneResult.class);
+        when(insertResult.wasAcknowledged()).thenReturn(true);
+        when(insertResult.getInsertedId()).thenReturn(new BsonObjectId(testId));
+        when(movieRepository.insertOne(any(Movie.class))).thenReturn(insertResult);
+        when(movieRepository.findById(testId)).thenReturn(Optional.of(testMovie));
+
+        // Act
+        Movie result = movieService.createMovie(createRequest);
+
+        // Assert
+        assertNotNull(result);
+        verify(movieRepository).insertOne(any(Movie.class));
+        verify(movieRepository).findById(testId);
+    }
+
+    @Test
+    @DisplayName("Should throw ValidationException when title is null")
+    void testCreateMovie_NullTitle() {
+        // Arrange
+        CreateMovieRequest invalidRequest = CreateMovieRequest.builder()
+                .title(null)
+                .year(2024)
+                .build();
+
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.createMovie(invalidRequest));
+        verify(movieRepository, never()).insertOne(any());
+    }
+
+    @Test
+    @DisplayName("Should throw ValidationException when title is empty")
+    void testCreateMovie_EmptyTitle() {
+        // Arrange
+        CreateMovieRequest invalidRequest = CreateMovieRequest.builder()
+                .title("   ")
+                .year(2024)
+                .build();
 
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.createMovie(invalidRequest));
+        verify(movieRepository, never()).insertOne(any());
+    }
+
+    @Test
+    @DisplayName("Should throw DatabaseOperationException when insert not acknowledged")
+    void testCreateMovie_NotAcknowledged() {
+        // Arrange
+        InsertOneResult insertResult = mock(InsertOneResult.class);
+        when(insertResult.wasAcknowledged()).thenReturn(false);
+        when(movieRepository.insertOne(any(Movie.class))).thenReturn(insertResult);
+
+        // Act & Assert
+        assertThrows(DatabaseOperationException.class, () -> movieService.createMovie(createRequest));
+        verify(movieRepository).insertOne(any(Movie.class));
+        verify(movieRepository, never()).findById(any());
+    }
+
+    @Test
+    @DisplayName("Should throw DatabaseOperationException when created movie not found")
+    void testCreateMovie_CreatedMovieNotFound() {
+        // Arrange
+        InsertOneResult insertResult = mock(InsertOneResult.class);
+        when(insertResult.wasAcknowledged()).thenReturn(true);
+        when(insertResult.getInsertedId()).thenReturn(new BsonObjectId(testId));
+        when(movieRepository.insertOne(any(Movie.class))).thenReturn(insertResult);
+        when(movieRepository.findById(testId)).thenReturn(Optional.empty());
+
+        // Act & Assert
+        assertThrows(DatabaseOperationException.class, () -> movieService.createMovie(createRequest));
+        verify(movieRepository).insertOne(any(Movie.class));
+        verify(movieRepository).findById(testId);
+    }
+
+    // ==================== CREATE MOVIES BATCH TESTS ====================
+
+    @Test
+    @DisplayName("Should create movies batch successfully")
+    void testCreateMoviesBatch_Success() {
+        // Arrange
+        List<CreateMovieRequest> requests = Arrays.asList(createRequest, createRequest);
+        InsertManyResult insertResult = mock(InsertManyResult.class);
+        Map<Integer, org.bson.BsonValue> insertedIds = new HashMap<>();
+        insertedIds.put(0, new BsonObjectId(new ObjectId()));
+        insertedIds.put(1, new BsonObjectId(new ObjectId()));
+
+        when(insertResult.wasAcknowledged()).thenReturn(true);
+        when(insertResult.getInsertedIds()).thenReturn(insertedIds);
+        when(movieRepository.insertMany(anyList())).thenReturn(insertResult);
+
+        // Act
+        Map<String, Object> result = movieService.createMoviesBatch(requests);
+
+        // Assert
+        assertNotNull(result);
+        assertEquals(2, result.get("insertedCount"));
+        assertNotNull(result.get("insertedIds"));
+        verify(movieRepository).insertMany(anyList());
+    }
+
+    @Test
+    @DisplayName("Should throw DatabaseOperationException when batch insert not acknowledged")
+    void testCreateMoviesBatch_NotAcknowledged() {
+        // Arrange
+        List<CreateMovieRequest> requests = Arrays.asList(createRequest);
+        InsertManyResult insertResult = mock(InsertManyResult.class);
+        when(insertResult.wasAcknowledged()).thenReturn(false);
+        when(movieRepository.insertMany(anyList())).thenReturn(insertResult);
+
+        // Act & Assert
+        assertThrows(DatabaseOperationException.class, () -> movieService.createMoviesBatch(requests));
+        verify(movieRepository).insertMany(anyList());
+    }
+
+    // ==================== UPDATE MOVIE TESTS ====================
+
+    @Test
+    @DisplayName("Should update movie successfully")
+    void testUpdateMovie_Success() {
+        // Arrange
+        String validId = testId.toHexString();
+        Map<String, Object> requestMap = new HashMap<>();
+        requestMap.put("title", "Updated Title");
+        requestMap.put("year", 2025);
+
+        when(objectMapper.convertValue(updateRequest, Map.class)).thenReturn(requestMap);
+
+        UpdateResult updateResult = mock(UpdateResult.class);
+        when(updateResult.getMatchedCount()).thenReturn(1L);
+        when(movieRepository.updateOne(eq(testId), any(Document.class))).thenReturn(updateResult);
+        when(movieRepository.findById(testId)).thenReturn(Optional.of(testMovie));
+
+        // Act
+        Movie result = movieService.updateMovie(validId, updateRequest);
+
+        // Assert
+        assertNotNull(result);
+        verify(movieRepository).updateOne(eq(testId), any(Document.class));
+        verify(movieRepository).findById(testId);
+    }
+
+    @Test
+    @DisplayName("Should throw ValidationException for invalid ID in update")
+    void testUpdateMovie_InvalidId() {
+        // Arrange
+        String invalidId = "invalid-id";
+
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.updateMovie(invalidId, updateRequest));
+        verify(movieRepository, never()).updateOne(any(), any());
+    }
+
+    @Test
+    @DisplayName("Should throw ValidationException when update request is empty")
+    void testUpdateMovie_EmptyRequest() {
+        // Arrange
+        String validId = testId.toHexString();
+        UpdateMovieRequest emptyRequest = UpdateMovieRequest.builder().build();
+        Map<String, Object> emptyMap = new HashMap<>();
+
+        when(objectMapper.convertValue(emptyRequest, Map.class)).thenReturn(emptyMap);
+
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.updateMovie(validId, emptyRequest));
+        verify(movieRepository, never()).updateOne(any(), any());
+    }
+
+    @Test
+    @DisplayName("Should throw ResourceNotFoundException when movie to update not found")
+    void testUpdateMovie_NotFound() {
+        // Arrange
+        String validId = testId.toHexString();
+        Map<String, Object> requestMap = new HashMap<>();
+        requestMap.put("title", "Updated Title");
+
+        when(objectMapper.convertValue(updateRequest, Map.class)).thenReturn(requestMap);
+
+        UpdateResult updateResult = mock(UpdateResult.class);
+        when(updateResult.getMatchedCount()).thenReturn(0L);
+        when(movieRepository.updateOne(eq(testId), any(Document.class))).thenReturn(updateResult);
+
+        // Act & Assert
+        assertThrows(ResourceNotFoundException.class, () -> movieService.updateMovie(validId, updateRequest));
+        verify(movieRepository).updateOne(eq(testId), any(Document.class));
+        verify(movieRepository, never()).findById(any());
+    }
+
+    // ==================== DELETE MOVIE TESTS ====================
+
+    @Test
+    @DisplayName("Should delete movie successfully")
+    void testDeleteMovie_Success() {
+        // Arrange
+        String validId = testId.toHexString();
+        DeleteResult deleteResult = mock(DeleteResult.class);
+        when(deleteResult.getDeletedCount()).thenReturn(1L);
+        when(movieRepository.deleteOne(testId)).thenReturn(deleteResult);
+
+        // Act
+        Map<String, Object> result = movieService.deleteMovie(validId);
+
+        // Assert
+        assertNotNull(result);
+        assertEquals(1L, result.get("deletedCount"));
+        verify(movieRepository).deleteOne(testId);
+    }
+
+    @Test
+    @DisplayName("Should throw ValidationException for invalid ID in delete")
+    void testDeleteMovie_InvalidId() {
+        // Arrange
+        String invalidId = "invalid-id";
+
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.deleteMovie(invalidId));
+        verify(movieRepository, never()).deleteOne(any());
+    }
+
+    @Test
+    @DisplayName("Should throw ResourceNotFoundException when movie to delete not found")
+    void testDeleteMovie_NotFound() {
+        // Arrange
+        String validId = testId.toHexString();
+        DeleteResult deleteResult = mock(DeleteResult.class);
+        when(deleteResult.getDeletedCount()).thenReturn(0L);
+        when(movieRepository.deleteOne(testId)).thenReturn(deleteResult);
+
+        // Act & Assert
+        assertThrows(ResourceNotFoundException.class, () -> movieService.deleteMovie(validId));
+        verify(movieRepository).deleteOne(testId);
+    }
+
+    // ==================== FIND AND DELETE MOVIE TESTS ====================
+
+    @Test
+    @DisplayName("Should find and delete movie successfully")
+    void testFindAndDeleteMovie_Success() {
+        // Arrange
+        String validId = testId.toHexString();
+        when(movieRepository.findOneAndDelete(testId)).thenReturn(Optional.of(testMovie));
+
+        // Act
+        Movie result = movieService.findAndDeleteMovie(validId);
+
+        // Assert
+        assertNotNull(result);
+        assertEquals(testMovie.getTitle(), result.getTitle());
+        verify(movieRepository).findOneAndDelete(testId);
+    }
+
+    @Test
+    @DisplayName("Should throw ValidationException for invalid ID in find and delete")
+    void testFindAndDeleteMovie_InvalidId() {
+        // Arrange
+        String invalidId = "invalid-id";
+
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.findAndDeleteMovie(invalidId));
+        verify(movieRepository, never()).findOneAndDelete(any());
+    }
+
+    @Test
+    @DisplayName("Should throw ResourceNotFoundException when movie to find and delete not found")
+    void testFindAndDeleteMovie_NotFound() {
+        // Arrange
+        String validId = testId.toHexString();
+        when(movieRepository.findOneAndDelete(testId)).thenReturn(Optional.empty());
+
+        // Act & Assert
+        assertThrows(ResourceNotFoundException.class, () -> movieService.findAndDeleteMovie(validId));
+        verify(movieRepository).findOneAndDelete(testId);
+    }
+}

From 2d5087bb79c7d100fdf707e695d22cc6231b43c9 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 28 Oct 2025 15:43:31 -0400
Subject: [PATCH 019/110] refactor(DTOs): create missing return types

---
 .../controller/MovieControllerImpl.java       | 43 ++++++++--------
 .../model/dto/BatchInsertResponse.java        | 20 ++++++++
 .../model/dto/BatchUpdateResponse.java        | 17 +++++++
 .../samplemflix/model/dto/DeleteResponse.java | 16 ++++++
 .../samplemflix/service/MovieService.java     | 12 +++--
 .../samplemflix/service/MovieServiceImpl.java | 51 ++++++++++---------
 .../controller/MovieControllerTest.java       | 14 ++---
 .../samplemflix/service/MovieServiceTest.java | 12 +++--
 8 files changed, 125 insertions(+), 60 deletions(-)
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchInsertResponse.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchUpdateResponse.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DeleteResponse.java

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index 643b48e..4a139c0 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -1,7 +1,10 @@
 package com.mongodb.samplemflix.controller;
 
 import com.mongodb.samplemflix.model.Movie;
+import com.mongodb.samplemflix.model.dto.BatchInsertResponse;
+import com.mongodb.samplemflix.model.dto.BatchUpdateResponse;
 import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
+import com.mongodb.samplemflix.model.dto.DeleteResponse;
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.model.response.SuccessResponse;
@@ -125,17 +128,17 @@ public ResponseEntity<SuccessResponse<Movie>> createMovie(@Valid @RequestBody Cr
      * Creates multiple movie documents in a single operation.
      */
     @PostMapping("/batch")
-    public ResponseEntity<SuccessResponse<Map<String, Object>>> createMoviesBatch(
+    public ResponseEntity<SuccessResponse<BatchInsertResponse>> createMoviesBatch(
             @RequestBody List<CreateMovieRequest> requests) {
-        Map<String, Object> result = movieService.createMoviesBatch(requests);
-        
-        SuccessResponse<Map<String, Object>> response = SuccessResponse.<Map<String, Object>>builder()
+        BatchInsertResponse result = movieService.createMoviesBatch(requests);
+
+        SuccessResponse<BatchInsertResponse> response = SuccessResponse.<BatchInsertResponse>builder()
                 .success(true)
-                .message("Successfully created " + result.get("insertedCount") + " movies")
+                .message("Successfully created " + result.getInsertedCount() + " movies")
                 .data(result)
                 .timestamp(Instant.now().toString())
                 .build();
-        
+
         return ResponseEntity.status(HttpStatus.CREATED).body(response);
     }
     
@@ -167,17 +170,17 @@ public ResponseEntity<SuccessResponse<Movie>> updateMovie(
      */
     @SuppressWarnings("unchecked")
     @PatchMapping
-    public ResponseEntity<SuccessResponse<Map<String, Object>>> updateMoviesBatch(
+    public ResponseEntity<SuccessResponse<BatchUpdateResponse>> updateMoviesBatch(
             @RequestBody Map<String, Object> body) {
         Document filter = new Document((Map<String, Object>) body.get("filter"));
         Document update = new Document((Map<String, Object>) body.get("update"));
 
-        Map<String, Object> result = movieService.updateMoviesBatch(filter, update);
+        BatchUpdateResponse result = movieService.updateMoviesBatch(filter, update);
 
-        SuccessResponse<Map<String, Object>> response = SuccessResponse.<Map<String, Object>>builder()
+        SuccessResponse<BatchUpdateResponse> response = SuccessResponse.<BatchUpdateResponse>builder()
                 .success(true)
-                .message("Update operation completed. Matched " + result.get("matchedCount") +
-                        " documents, modified " + result.get("modifiedCount") + " documents.")
+                .message("Update operation completed. Matched " + result.getMatchedCount() +
+                        " documents, modified " + result.getModifiedCount() + " documents.")
                 .data(result)
                 .timestamp(Instant.now().toString())
                 .build();
@@ -210,16 +213,16 @@ public ResponseEntity<SuccessResponse<Movie>> findAndDeleteMovie(@PathVariable S
      * Deletes a single movie document.
      */
     @DeleteMapping("/{id}")
-    public ResponseEntity<SuccessResponse<Map<String, Object>>> deleteMovie(@PathVariable String id) {
-        Map<String, Object> result = movieService.deleteMovie(id);
-        
-        SuccessResponse<Map<String, Object>> response = SuccessResponse.<Map<String, Object>>builder()
+    public ResponseEntity<SuccessResponse<DeleteResponse>> deleteMovie(@PathVariable String id) {
+        DeleteResponse result = movieService.deleteMovie(id);
+
+        SuccessResponse<DeleteResponse> response = SuccessResponse.<DeleteResponse>builder()
                 .success(true)
                 .message("Movie deleted successfully")
                 .data(result)
                 .timestamp(Instant.now().toString())
                 .build();
-        
+
         return ResponseEntity.ok(response);
     }
     
@@ -230,15 +233,15 @@ public ResponseEntity<SuccessResponse<Map<String, Object>>> deleteMovie(@PathVar
      */
     @SuppressWarnings("unchecked")
     @DeleteMapping
-    public ResponseEntity<SuccessResponse<Map<String, Object>>> deleteMoviesBatch(
+    public ResponseEntity<SuccessResponse<DeleteResponse>> deleteMoviesBatch(
             @RequestBody Map<String, Object> body) {
         Document filter = new Document((Map<String, Object>) body.get("filter"));
 
-        Map<String, Object> result = movieService.deleteMoviesBatch(filter);
+        DeleteResponse result = movieService.deleteMoviesBatch(filter);
 
-        SuccessResponse<Map<String, Object>> response = SuccessResponse.<Map<String, Object>>builder()
+        SuccessResponse<DeleteResponse> response = SuccessResponse.<DeleteResponse>builder()
                 .success(true)
-                .message("Delete operation completed. Removed " + result.get("deletedCount") + " documents.")
+                .message("Delete operation completed. Removed " + result.getDeletedCount() + " documents.")
                 .data(result)
                 .timestamp(Instant.now().toString())
                 .build();
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchInsertResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchInsertResponse.java
new file mode 100644
index 0000000..2196533
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchInsertResponse.java
@@ -0,0 +1,20 @@
+package com.mongodb.samplemflix.model.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.bson.BsonValue;
+
+import java.util.Collection;
+
+/**
+ * Response DTO for batch insert operations.
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class BatchInsertResponse {
+    private int insertedCount;
+    private Collection<BsonValue> insertedIds;
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchUpdateResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchUpdateResponse.java
new file mode 100644
index 0000000..354bdbc
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchUpdateResponse.java
@@ -0,0 +1,17 @@
+package com.mongodb.samplemflix.model.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Response DTO for batch update operations.
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class BatchUpdateResponse {
+    private long matchedCount;
+    private long modifiedCount;
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DeleteResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DeleteResponse.java
new file mode 100644
index 0000000..b7ddc85
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DeleteResponse.java
@@ -0,0 +1,16 @@
+package com.mongodb.samplemflix.model.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Response DTO for delete operations.
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class DeleteResponse {
+    private long deletedCount;
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
index 4e44003..7841e65 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
@@ -1,13 +1,15 @@
 package com.mongodb.samplemflix.service;
 
 import com.mongodb.samplemflix.model.Movie;
+import com.mongodb.samplemflix.model.dto.BatchInsertResponse;
+import com.mongodb.samplemflix.model.dto.BatchUpdateResponse;
 import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
+import com.mongodb.samplemflix.model.dto.DeleteResponse;
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import org.bson.Document;
 
 import java.util.List;
-import java.util.Map;
 
 /**
  * Service interface for movie business logic.
@@ -20,15 +22,15 @@ public interface MovieService {
 
     Movie createMovie(CreateMovieRequest request);
 
-    Map<String, Object> createMoviesBatch(List<CreateMovieRequest> requests);
+    BatchInsertResponse createMoviesBatch(List<CreateMovieRequest> requests);
 
     Movie updateMovie(String id, UpdateMovieRequest request);
 
-    Map<String, Object> updateMoviesBatch(Document filter, Document update);
+    BatchUpdateResponse updateMoviesBatch(Document filter, Document update);
 
-    Map<String, Object> deleteMovie(String id);
+    DeleteResponse deleteMovie(String id);
 
-    Map<String, Object> deleteMoviesBatch(Document filter);
+    DeleteResponse deleteMoviesBatch(Document filter);
 
     Movie findAndDeleteMovie(String id);
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 88c35cd..c31db1b 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -9,7 +9,10 @@
 import com.mongodb.samplemflix.exception.ResourceNotFoundException;
 import com.mongodb.samplemflix.exception.ValidationException;
 import com.mongodb.samplemflix.model.Movie;
+import com.mongodb.samplemflix.model.dto.BatchInsertResponse;
+import com.mongodb.samplemflix.model.dto.BatchUpdateResponse;
 import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
+import com.mongodb.samplemflix.model.dto.DeleteResponse;
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.repository.MovieRepository;
@@ -95,18 +98,18 @@ public Movie createMovie(CreateMovieRequest request) {
     }
     
     @Override
-    public Map<String, Object> createMoviesBatch(List<CreateMovieRequest> requests) {
+    public BatchInsertResponse createMoviesBatch(List<CreateMovieRequest> requests) {
         if (requests == null || requests.isEmpty()) {
             throw new ValidationException("Request body must be a non-empty array of movie objects");
         }
-        
+
         for (int i = 0; i < requests.size(); i++) {
             CreateMovieRequest request = requests.get(i);
             if (request.getTitle() == null || request.getTitle().trim().isEmpty()) {
                 throw new ValidationException("Movie at index " + i + ": Title is required");
             }
         }
-        
+
         List<Movie> movies = requests.stream()
                 .map(request -> Movie.builder()
                         .title(request.getTitle())
@@ -124,16 +127,16 @@ public Map<String, Object> createMoviesBatch(List<CreateMovieRequest> requests)
                         .poster(request.getPoster())
                         .build())
                 .toList();
-        
+
         InsertManyResult result = movieRepository.insertMany(movies);
 
         if (!result.wasAcknowledged()) {
             throw new DatabaseOperationException("Batch movie insertion was not acknowledged by the database");
         }
-        
-        return Map.of(
-                "insertedCount", result.getInsertedIds().size(),
-                "insertedIds", result.getInsertedIds().values()
+
+        return new BatchInsertResponse(
+                result.getInsertedIds().size(),
+                result.getInsertedIds().values()
         );
     }
     
@@ -159,48 +162,48 @@ public Movie updateMovie(String id, UpdateMovieRequest request) {
     }
     
     @Override
-    public Map<String, Object> updateMoviesBatch(Document filter, Document update) {
+    public BatchUpdateResponse updateMoviesBatch(Document filter, Document update) {
         if (filter == null || update == null) {
             throw new ValidationException("Both filter and update objects are required");
         }
-        
+
         if (update.isEmpty()) {
             throw new ValidationException("Update object cannot be empty");
         }
-        
+
         Document setUpdate = new Document("$set", update);
         UpdateResult result = movieRepository.updateMany(filter, setUpdate);
-        
-        return Map.of(
-                "matchedCount", result.getMatchedCount(),
-                "modifiedCount", result.getModifiedCount()
+
+        return new BatchUpdateResponse(
+                result.getMatchedCount(),
+                result.getModifiedCount()
         );
     }
     
     @Override
-    public Map<String, Object> deleteMovie(String id) {
+    public DeleteResponse deleteMovie(String id) {
         if (!ObjectId.isValid(id)) {
             throw new ValidationException("Invalid movie ID format");
         }
-        
+
         DeleteResult result = movieRepository.deleteOne(new ObjectId(id));
-        
+
         if (result.getDeletedCount() == 0) {
             throw new ResourceNotFoundException("Movie not found");
         }
-        
-        return Map.of("deletedCount", result.getDeletedCount());
+
+        return new DeleteResponse(result.getDeletedCount());
     }
     
     @Override
-    public Map<String, Object> deleteMoviesBatch(Document filter) {
+    public DeleteResponse deleteMoviesBatch(Document filter) {
         if (filter == null || filter.isEmpty()) {
             throw new ValidationException("Filter object is required and cannot be empty. This prevents accidental deletion of all documents.");
         }
-        
+
         DeleteResult result = movieRepository.deleteMany(filter);
-        
-        return Map.of("deletedCount", result.getDeletedCount());
+
+        return new DeleteResponse(result.getDeletedCount());
     }
     
     @Override
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
index cf8dedd..a180d51 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
@@ -4,10 +4,13 @@
 import com.mongodb.samplemflix.exception.ResourceNotFoundException;
 import com.mongodb.samplemflix.exception.ValidationException;
 import com.mongodb.samplemflix.model.Movie;
+import com.mongodb.samplemflix.model.dto.BatchInsertResponse;
 import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
+import com.mongodb.samplemflix.model.dto.DeleteResponse;
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.service.MovieService;
+import org.bson.BsonObjectId;
 import org.bson.types.ObjectId;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.DisplayName;
@@ -202,9 +205,10 @@ void testCreateMovie_ValidationError() throws Exception {
     void testCreateMoviesBatch_Success() throws Exception {
         // Arrange
         List<CreateMovieRequest> requests = Arrays.asList(createRequest, createRequest);
-        Map<String, Object> response = new HashMap<>();
-        response.put("success", true);
-        response.put("insertedCount", 2);
+        Map<Integer, org.bson.BsonValue> insertedIds = new HashMap<>();
+        insertedIds.put(0, new BsonObjectId(new ObjectId()));
+        insertedIds.put(1, new BsonObjectId(new ObjectId()));
+        BatchInsertResponse response = new BatchInsertResponse(2, insertedIds.values());
 
         when(movieService.createMoviesBatch(anyList())).thenReturn(response);
 
@@ -267,9 +271,7 @@ void testUpdateMovie_NotFound() throws Exception {
     void testDeleteMovie_Success() throws Exception {
         // Arrange
         String movieId = testId.toHexString();
-        Map<String, Object> response = new HashMap<>();
-        response.put("success", true);
-        response.put("deletedCount", 1L);
+        DeleteResponse response = new DeleteResponse(1L);
 
         when(movieService.deleteMovie(movieId)).thenReturn(response);
 
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
index 0a45520..df8a858 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
@@ -9,7 +9,9 @@
 import com.mongodb.samplemflix.exception.ResourceNotFoundException;
 import com.mongodb.samplemflix.exception.ValidationException;
 import com.mongodb.samplemflix.model.Movie;
+import com.mongodb.samplemflix.model.dto.BatchInsertResponse;
 import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
+import com.mongodb.samplemflix.model.dto.DeleteResponse;
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.repository.MovieRepository;
@@ -295,12 +297,12 @@ void testCreateMoviesBatch_Success() {
         when(movieRepository.insertMany(anyList())).thenReturn(insertResult);
 
         // Act
-        Map<String, Object> result = movieService.createMoviesBatch(requests);
+        BatchInsertResponse result = movieService.createMoviesBatch(requests);
 
         // Assert
         assertNotNull(result);
-        assertEquals(2, result.get("insertedCount"));
-        assertNotNull(result.get("insertedIds"));
+        assertEquals(2, result.getInsertedCount());
+        assertNotNull(result.getInsertedIds());
         verify(movieRepository).insertMany(anyList());
     }
 
@@ -403,11 +405,11 @@ void testDeleteMovie_Success() {
         when(movieRepository.deleteOne(testId)).thenReturn(deleteResult);
 
         // Act
-        Map<String, Object> result = movieService.deleteMovie(validId);
+        DeleteResponse result = movieService.deleteMovie(validId);
 
         // Assert
         assertNotNull(result);
-        assertEquals(1L, result.get("deletedCount"));
+        assertEquals(1L, result.getDeletedCount());
         verify(movieRepository).deleteOne(testId);
     }
 

From 7b9029c2ff142ae138c384e79db206b0e18454f6 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 28 Oct 2025 16:01:08 -0400
Subject: [PATCH 020/110] refactor(spring data): implement spring data fully

---
 server/java-spring/README.md                  |  12 +-
 server/java-spring/pom.xml                    |  26 +--
 .../samplemflix/config/MongoConfig.java       | 121 ++++--------
 .../repository/MovieRepository.java           | 124 +++---------
 .../repository/MovieRepositoryImpl.java       |  96 ---------
 .../samplemflix/service/MovieServiceImpl.java | 185 ++++++++++++------
 .../samplemflix/service/MovieServiceTest.java | 135 ++++---------
 7 files changed, 244 insertions(+), 455 deletions(-)
 delete mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java

diff --git a/server/java-spring/README.md b/server/java-spring/README.md
index c0db54c..54f4498 100644
--- a/server/java-spring/README.md
+++ b/server/java-spring/README.md
@@ -1,17 +1,18 @@
 # MongoDB Sample MFlix - Java Spring Boot Backend [DRAFT]
 
-A Spring Boot REST API demonstrating MongoDB CRUD operations using the MongoDB Java Driver with the sample_mflix database.
+A Spring Boot REST API demonstrating MongoDB CRUD operations using Spring Data MongoDB with the sample_mflix database.
 
 ## Overview
 
 This application provides a REST API for managing movie data from MongoDB's sample_mflix database. It demonstrates:
 
-- Direct usage of the MongoDB Java Driver (not Spring Data MongoDB)
+- Spring Data MongoDB for simplified data access
 - CRUD operations (Create, Read, Update, Delete)
 - Text search functionality
 - Filtering, sorting, and pagination
 - Comprehensive error handling
 - API documentation with Swagger/OpenAPI
+- MongoTemplate for complex queries
 
 ## Prerequisites
 
@@ -152,9 +153,9 @@ See `JAVA-SPRING-IMPLEMENTATION-PLAN.md` in the repository root for the complete
 
 ## Technology Stack
 
-- **Framework**: Spring Boot 3.2.0
+- **Framework**: Spring Boot 3.5.7
 - **Java Version**: 17
-- **MongoDB Driver**: MongoDB Java Driver 5.1.4 (Sync)
+- **MongoDB**: Spring Data MongoDB 4.5.5
 - **Build Tool**: Maven
 - **API Documentation**: SpringDoc OpenAPI 2.3.0
 - **Testing**: JUnit 5, Mockito, Spring Boot Test
@@ -163,11 +164,12 @@ See `JAVA-SPRING-IMPLEMENTATION-PLAN.md` in the repository root for the complete
 
 This application is designed as an educational sample to demonstrate:
 
-1. How to use the MongoDB Java Driver directly (without Spring Data MongoDB)
+1. How to use Spring Data MongoDB for simplified data access
 2. Best practices for Spring Boot REST API development
 3. Proper separation of concerns (Controller → Service → Repository)
 4. MongoDB CRUD operations and query patterns
 5. Error handling and validation in Spring Boot
+6. Using MongoTemplate for complex queries alongside Spring Data repositories
 
 ## Troubleshooting
 
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index ed33e67..bd35bdf 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -16,45 +16,31 @@
     <artifactId>sample-mflix-spring</artifactId>
     <version>1.0.0</version>
     <name>MongoDB Sample MFlix Spring API</name>
-    <description>Spring Boot backend for MongoDB sample mflix application demonstrating CRUD operations using MongoDB Java Driver</description>
+    <description>Spring Boot backend for MongoDB sample mflix application demonstrating CRUD operations using Spring Data MongoDB</description>
     
     <properties>
         <java.version>17</java.version>
-        <mongodb.driver.version>5.6.0</mongodb.driver.version>
         <springdoc.version>2.8.13</springdoc.version>
         <dotenv.version>4.0.0</dotenv.version>
     </properties>
-    
+
     <dependencies>
         <!-- Spring Boot Web Starter -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-web</artifactId>
         </dependency>
-        
+
         <!-- Spring Boot Validation Starter -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-validation</artifactId>
         </dependency>
-        
-        <!-- MongoDB Java Driver (Sync) -->
-        <dependency>
-            <groupId>org.mongodb</groupId>
-            <artifactId>mongodb-driver-sync</artifactId>
-            <version>${mongodb.driver.version}</version>
-        </dependency>
 
-        <!-- Force matching versions for MongoDB dependencies -->
+        <!-- Spring Data MongoDB -->
         <dependency>
-            <groupId>org.mongodb</groupId>
-            <artifactId>bson</artifactId>
-            <version>${mongodb.driver.version}</version>
-        </dependency>
-        <dependency>
-            <groupId>org.mongodb</groupId>
-            <artifactId>mongodb-driver-core</artifactId>
-            <version>${mongodb.driver.version}</version>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-mongodb</artifactId>
         </dependency>
 
         <!-- Spring Dotenv - Load .env files -->
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
index ba0c6d6..765989c 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
@@ -2,38 +2,35 @@
 
 import com.mongodb.ConnectionString;
 import com.mongodb.MongoClientSettings;
-import com.mongodb.client.MongoClient;
-import com.mongodb.client.MongoClients;
-import com.mongodb.client.MongoDatabase;
-import org.bson.codecs.configuration.CodecRegistry;
-import org.bson.codecs.pojo.PojoCodecProvider;
 import org.springframework.beans.factory.annotation.Value;
-import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
+import org.springframework.data.mongodb.config.AbstractMongoClientConfiguration;
+import org.springframework.data.mongodb.repository.config.EnableMongoRepositories;
 
 import java.util.concurrent.TimeUnit;
 
-import static org.bson.codecs.configuration.CodecRegistries.fromProviders;
-import static org.bson.codecs.configuration.CodecRegistries.fromRegistries;
-
 /**
- * MongoDB configuration class for the Sample MFlix application.
+ * MongoDB configuration class for the Sample MFlix application using Spring Data MongoDB.
  * <p>
- * This class configures the MongoDB client connection using the MongoDB Java Driver.
- * It creates singleton beans for MongoClient and MongoDatabase that will be injected
- * throughout the application.
+ * This class extends AbstractMongoClientConfiguration to customize MongoDB client settings
+ * while leveraging Spring Data MongoDB's auto-configuration for repositories and templates.
  * <p>
  * Key features:
  * - Connection pooling with configurable settings (max 100 connections, min 10)
  * - Connection timeout configuration (10 seconds for connect and read)
- * - Graceful shutdown handling (managed by Spring's bean lifecycle)
- * - Connection string validation
+ * - Automatic POJO mapping (no manual codec configuration needed)
+ * - Repository scanning and auto-configuration
+ * - MongoTemplate bean creation for complex queries
  * <p>
- * The MongoClient is thread-safe and designed to be shared across the application.
- * Spring automatically manages the lifecycle and closes the client on shutdown.
+ * Spring Data MongoDB automatically:
+ * - Creates MongoClient and MongoTemplate beans
+ * - Handles POJO to BSON conversion
+ * - Manages connection lifecycle
+ * - Provides repository implementations
  */
 @Configuration
-public class MongoConfig {
+@EnableMongoRepositories(basePackages = "com.mongodb.samplemflix.repository")
+public class MongoConfig extends AbstractMongoClientConfiguration {
 
     @Value("${spring.data.mongodb.uri}")
     private String mongoUri;
@@ -41,27 +38,13 @@ public class MongoConfig {
     @Value("${spring.data.mongodb.database}")
     private String databaseName;
 
-    /**
-     * Creates and configures the MongoDB client with connection pooling and timeout settings.
-     * <p>
-     * Connection Pool Settings:
-     * - Max pool size: 100 connections (handles high concurrent load)
-     * - Min pool size: 10 connections (maintains ready connections)
-     * - Max connection idle time: 60 seconds (releases idle connections)
-     * - Max wait time: 10 seconds (time to wait for available connection)
-     * <p>
-     * Socket Settings:
-     * - Connect timeout: 10 seconds (time to establish connection)
-     * - Read timeout: 10 seconds (time to wait for server response)
-     * <p>
-     * The MongoClient is thread-safe and should be shared across the application.
-     * Spring will automatically close this client when the application shuts down.
-     *
-     * @return configured MongoClient instance
-     * @throws IllegalArgumentException if connection string is invalid
-     */
-    @Bean
-    public MongoClient mongoClient() {
+    @Override
+    protected String getDatabaseName() {
+        return databaseName;
+    }
+
+    @Override
+    protected void configureClientSettings(MongoClientSettings.Builder builder) {
         // Validate connection string is not empty
         if (mongoUri == null || mongoUri.trim().isEmpty()) {
             throw new IllegalArgumentException(
@@ -69,60 +52,26 @@ public MongoClient mongoClient() {
             );
         }
 
-        // Create the POJO codec provider, enabling automatic POJO discovery
-        CodecRegistry pojoCodecRegistry = fromProviders(
-                PojoCodecProvider.builder().automatic(true).build()
-        );
-
-        // Combine the default registry with your new POJO registry
-        // IMPORTANT: The default registry must come FIRST.
-        CodecRegistry registry = fromRegistries(
-                MongoClientSettings.getDefaultCodecRegistry(),
-                pojoCodecRegistry
-        );
-
         // Parse and validate the connection string
         ConnectionString connectionString = new ConnectionString(mongoUri);
 
-        // Build client settings with connection pooling and timeouts
-        // These settings optimize for both performance and resource management
-        MongoClientSettings settings = MongoClientSettings.builder()
-                .codecRegistry(registry)
-                .applyConnectionString(connectionString)
+        // Apply connection string and custom settings
+        builder.applyConnectionString(connectionString)
                 // Configure connection pool for optimal performance
-                .applyToConnectionPoolSettings(builder ->
-                    builder.maxSize(100)                                    // Maximum connections in pool
-                           .minSize(10)                                     // Minimum connections to maintain
-                           .maxConnectionIdleTime(60000, TimeUnit.MILLISECONDS)  // Release idle connections after 60s
-                           .maxWaitTime(10000, TimeUnit.MILLISECONDS)       // Wait up to 10s for available connection
+                .applyToConnectionPoolSettings(poolBuilder ->
+                    poolBuilder.maxSize(100)                                    // Maximum connections in pool
+                           .minSize(10)                                         // Minimum connections to maintain
+                           .maxConnectionIdleTime(60000, TimeUnit.MILLISECONDS) // Release idle connections after 60s
+                           .maxWaitTime(10000, TimeUnit.MILLISECONDS)           // Wait up to 10s for available connection
                 )
                 // Configure socket timeouts to prevent hanging connections
-                .applyToSocketSettings(builder ->
-                    builder.connectTimeout(10000, TimeUnit.MILLISECONDS)    // 10s to establish connection
-                           .readTimeout(10000, TimeUnit.MILLISECONDS)       // 10s to wait for server response
+                .applyToSocketSettings(socketBuilder ->
+                    socketBuilder.connectTimeout(10000, TimeUnit.MILLISECONDS)  // 10s to establish connection
+                           .readTimeout(10000, TimeUnit.MILLISECONDS)           // 10s to wait for server response
                 )
                 // Configure server selection timeout
-                .applyToClusterSettings(builder ->
-                    builder.serverSelectionTimeout(10000, TimeUnit.MILLISECONDS)  // 10s to select server
-                )
-                .build();
-
-        return MongoClients.create(settings);
-    }
-
-    /**
-     * Creates a reference to the MongoDB database.
-     * <p>
-     * This bean provides access to the sample_mflix database and can be injected
-     * into repositories and services throughout the application.
-     * <p>
-     * The database name is configured in application.properties and defaults to "sample_mflix".
-     *
-     * @param mongoClient the MongoDB client (injected by Spring)
-     * @return MongoDatabase instance for the configured database
-     */
-    @Bean
-    public MongoDatabase mongoDatabase(MongoClient mongoClient) {
-        return mongoClient.getDatabase(databaseName);
+                .applyToClusterSettings(clusterBuilder ->
+                    clusterBuilder.serverSelectionTimeout(10000, TimeUnit.MILLISECONDS)  // 10s to select server
+                );
     }
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
index b416ba1..77cb013 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
@@ -1,105 +1,37 @@
 package com.mongodb.samplemflix.repository;
 
-import com.mongodb.client.result.DeleteResult;
-import com.mongodb.client.result.InsertManyResult;
-import com.mongodb.client.result.InsertOneResult;
-import com.mongodb.client.result.UpdateResult;
 import com.mongodb.samplemflix.model.Movie;
-import org.bson.Document;
 import org.bson.types.ObjectId;
-
-import java.util.List;
-import java.util.Optional;
+import org.springframework.data.mongodb.repository.MongoRepository;
+import org.springframework.stereotype.Repository;
 
 /**
- * Repository interface for movie data access.
+ * Spring Data MongoDB repository for movie data access.
+ *
+ * This repository extends MongoRepository which provides:
+ * - Basic CRUD operations (save, findById, findAll, delete, etc.)
+ * - Pagination and sorting support
+ * - Query derivation from method names
+ * - Custom query support via @Query annotation
  *
- * This repository provides methods for all CRUD operations using the MongoDB Java Driver directly.
- * The implementation uses MongoCollection<Document> for direct control over BSON documents.
+ * For complex queries not supported by Spring Data, you can inject MongoTemplate
+ * in the service layer.
  */
-public interface MovieRepository {
-
-    /**
-     * Inserts a single movie document.
-     *
-     * @param movie the movie to insert
-     * @return the result of the insert operation
-     */
-    InsertOneResult insertOne(Movie movie);
-
-    /**
-     * Inserts multiple movie documents.
-     *
-     * @param movies the list of movies to insert
-     * @return the result of the insert operation
-     */
-    InsertManyResult insertMany(List<Movie> movies);
-
-    /**
-     * Finds a single movie by its ID.
-     *
-     * @param id the movie ID
-     * @return Optional containing the movie if found, empty otherwise
-     */
-    Optional<Movie> findById(ObjectId id);
-
-    /**
-     * Finds multiple movies with filtering, sorting, and pagination.
-     *
-     * @param filter the filter document
-     * @param sort the sort document
-     * @param skip number of documents to skip
-     * @param limit maximum number of documents to return
-     * @return list of movies matching the criteria
-     */
-    List<Movie> find(Document filter, Document sort, int skip, int limit);
-
-    /**
-     * Updates a single movie by ID.
-     *
-     * @param id the movie ID
-     * @param update the update document
-     * @return the result of the update operation
-     */
-    UpdateResult updateOne(ObjectId id, Document update);
-
-    /**
-     * Updates multiple movies matching the filter.
-     *
-     * @param filter the filter document
-     * @param update the update document
-     * @return the result of the update operation
-     */
-    UpdateResult updateMany(Document filter, Document update);
-
-    /**
-     * Deletes a single movie by ID.
-     *
-     * @param id the movie ID
-     * @return the result of the delete operation
-     */
-    DeleteResult deleteOne(ObjectId id);
-
-    /**
-     * Deletes multiple movies matching the filter.
-     *
-     * @param filter the filter document
-     * @return the result of the delete operation
-     */
-    DeleteResult deleteMany(Document filter);
-
-    /**
-     * Finds and deletes a single movie in one atomic operation.
-     *
-     * @param id the movie ID
-     * @return Optional containing the deleted movie if found, empty otherwise
-     */
-    Optional<Movie> findOneAndDelete(ObjectId id);
-
-    /**
-     * Counts the total number of documents in the movies collection.
-     *
-     * @return the count of documents
-     */
-    long countDocuments();
+@Repository
+public interface MovieRepository extends MongoRepository<Movie, ObjectId> {
+
+    // Spring Data MongoDB provides these methods automatically:
+    // - save(Movie movie) - insert or update
+    // - saveAll(Iterable<Movie> movies) - batch insert/update
+    // - findById(ObjectId id) - find by ID
+    // - findAll() - find all documents
+    // - findAll(Pageable pageable) - find with pagination
+    // - deleteById(ObjectId id) - delete by ID
+    // - delete(Movie movie) - delete entity
+    // - count() - count all documents
+    // - existsById(ObjectId id) - check if exists
+
+    // Custom query methods can be added here using method name conventions:
+    // Example: List<Movie> findByGenresContaining(String genre);
+    // Example: List<Movie> findByYearBetween(Integer startYear, Integer endYear);
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java
deleted file mode 100644
index 95a87c6..0000000
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepositoryImpl.java
+++ /dev/null
@@ -1,96 +0,0 @@
-package com.mongodb.samplemflix.repository;
-
-import com.mongodb.client.MongoCollection;
-import com.mongodb.client.MongoDatabase;
-import com.mongodb.client.model.Filters;
-import com.mongodb.client.result.DeleteResult;
-import com.mongodb.client.result.InsertManyResult;
-import com.mongodb.client.result.InsertOneResult;
-import com.mongodb.client.result.UpdateResult;
-import com.mongodb.samplemflix.model.Movie;
-import org.bson.Document;
-import org.bson.types.ObjectId;
-import org.springframework.stereotype.Repository;
-
-import java.util.ArrayList;
-import java.util.List;
-import java.util.Optional;
-
-/**
- * Implementation of MovieRepository using MongoDB Java Driver directly.
- *
- * This class demonstrates direct usage of MongoCollection<Movie> for CRUD operations.
- * It uses MongoDB's POJO codec to automatically convert between Movie objects and BSON Documents.
- *
- * This approach is used for educational purposes to show how the MongoDB driver works,
- * rather than using Spring Data MongoDB which abstracts these details.
- */
-@Repository
-public class MovieRepositoryImpl implements MovieRepository {
-
-    private final MongoCollection<Movie> moviesCollection;
-
-    public MovieRepositoryImpl(MongoDatabase mongoDatabase) {
-        this.moviesCollection = mongoDatabase.getCollection("movies", Movie.class);
-    }
-    
-    @Override
-    public InsertOneResult insertOne(Movie movie) {
-        return moviesCollection.insertOne(movie);
-    }
-    
-    @Override
-    public InsertManyResult insertMany(List<Movie> movies) {
-        return moviesCollection.insertMany(movies);
-    }
-    
-    @Override
-    public Optional<Movie> findById(ObjectId id) {
-        Movie doc = moviesCollection.find(Filters.eq(Movie.Fields.ID, id)).first();
-        return Optional.ofNullable(doc);
-    }
-    
-    @Override
-    public List<Movie> find(Document filter, Document sort, int skip, int limit) {
-        List<Movie> movies = new ArrayList<>();
-        moviesCollection.find(filter)
-                .sort(sort)
-                .skip(skip)
-                .limit(limit)
-                .into(movies);
-
-        return movies;
-    }
-    
-    @Override
-    public UpdateResult updateOne(ObjectId id, Document update) {
-        return moviesCollection.updateOne(Filters.eq(Movie.Fields.ID, id), update);
-    }
-    
-    @Override
-    public UpdateResult updateMany(Document filter, Document update) {
-        return moviesCollection.updateMany(filter, update);
-    }
-    
-    @Override
-    public DeleteResult deleteOne(ObjectId id) {
-        return moviesCollection.deleteOne(Filters.eq(Movie.Fields.ID, id));
-    }
-    
-    @Override
-    public DeleteResult deleteMany(Document filter) {
-        return moviesCollection.deleteMany(filter);
-    }
-    
-    @Override
-    public Optional<Movie> findOneAndDelete(ObjectId id) {
-        Movie doc = moviesCollection.findOneAndDelete(Filters.eq(Movie.Fields.ID, id));
-        return Optional.ofNullable(doc);
-    }
-    
-    @Override
-    public long countDocuments() {
-        return moviesCollection.countDocuments();
-    }
-
-}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index c31db1b..a2fe24d 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -1,9 +1,7 @@
 package com.mongodb.samplemflix.service;
 
-import com.mongodb.client.result.DeleteResult;
-import com.mongodb.client.result.InsertManyResult;
-import com.mongodb.client.result.InsertOneResult;
 import com.fasterxml.jackson.databind.ObjectMapper;
+import com.mongodb.client.result.DeleteResult;
 import com.mongodb.client.result.UpdateResult;
 import com.mongodb.samplemflix.exception.DatabaseOperationException;
 import com.mongodb.samplemflix.exception.ResourceNotFoundException;
@@ -16,43 +14,63 @@
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.repository.MovieRepository;
+import org.bson.BsonValue;
 import org.bson.Document;
 import org.bson.types.ObjectId;
+import org.springframework.data.domain.PageRequest;
+import org.springframework.data.domain.Sort;
+import org.springframework.data.mongodb.core.FindAndModifyOptions;
+import org.springframework.data.mongodb.core.MongoTemplate;
+import org.springframework.data.mongodb.core.query.Criteria;
+import org.springframework.data.mongodb.core.query.Query;
+import org.springframework.data.mongodb.core.query.TextCriteria;
+import org.springframework.data.mongodb.core.query.Update;
 import org.springframework.stereotype.Service;
 
+import java.util.ArrayList;
+import java.util.Collection;
 import java.util.List;
 import java.util.Map;
 import java.util.regex.Pattern;
+import java.util.stream.Collectors;
 
 /**
- * Service layer for movie business logic.
+ * Service layer for movie business logic using Spring Data MongoDB.
  * <p>
  * This service handles:
  * - Business logic and validation
- * - Query construction (filters, sorts, pagination)
+ * - Query construction using Spring Data MongoDB Query API
  * - Data transformation between DTOs and entities
  * - Error handling and exception throwing
+ * <p>
+ * Uses both:
+ * - MovieRepository (Spring Data) for simple CRUD operations
+ * - MongoTemplate for complex queries and batch operations
  */
 @Service
 public class MovieServiceImpl implements MovieService {
 
     private final MovieRepository movieRepository;
+    private final MongoTemplate mongoTemplate;
     private final ObjectMapper objectMapper;
 
-    public MovieServiceImpl(MovieRepository movieRepository, ObjectMapper objectMapper) {
+    public MovieServiceImpl(MovieRepository movieRepository, MongoTemplate mongoTemplate, ObjectMapper objectMapper) {
         this.movieRepository = movieRepository;
+        this.mongoTemplate = mongoTemplate;
         this.objectMapper = objectMapper;
     }
     
     @Override
     public List<Movie> getAllMovies(MovieSearchQuery query) {
-        Document filter = buildFilter(query);
-        Document sort = buildSort(query.getSortBy(), query.getSortOrder());
-        
+        Query mongoQuery = buildQuery(query);
+
         int limit = Math.min(Math.max(query.getLimit() != null ? query.getLimit() : 20, 1), 100);
         int skip = Math.max(query.getSkip() != null ? query.getSkip() : 0, 0);
-        
-        return movieRepository.find(filter, sort, skip, limit);
+
+        mongoQuery.skip(skip).limit(limit);
+        mongoQuery.with(buildSort(query.getSortBy(), query.getSortOrder()));
+
+        return mongoTemplate.find(mongoQuery, Movie.class);
     }
     
     @Override
@@ -70,7 +88,7 @@ public Movie createMovie(CreateMovieRequest request) {
         if (request.getTitle() == null || request.getTitle().trim().isEmpty()) {
             throw new ValidationException("Title is required");
         }
-        
+
         Movie movie = Movie.builder()
                 .title(request.getTitle())
                 .year(request.getYear())
@@ -86,15 +104,9 @@ public Movie createMovie(CreateMovieRequest request) {
                 .runtime(request.getRuntime())
                 .poster(request.getPoster())
                 .build();
-        
-        InsertOneResult result = movieRepository.insertOne(movie);
 
-        if (!result.wasAcknowledged()) {
-            throw new DatabaseOperationException("Movie insertion was not acknowledged by the database");
-        }
-
-        return movieRepository.findById(result.getInsertedId().asObjectId().getValue())
-                .orElseThrow(() -> new DatabaseOperationException("Failed to retrieve created movie"));
+        // Spring Data MongoDB's save() method inserts or updates
+        return movieRepository.save(movie);
     }
     
     @Override
@@ -128,15 +140,17 @@ public BatchInsertResponse createMoviesBatch(List<CreateMovieRequest> requests)
                         .build())
                 .toList();
 
-        InsertManyResult result = movieRepository.insertMany(movies);
+        // Spring Data MongoDB's saveAll() method for batch insert
+        List<Movie> savedMovies = movieRepository.saveAll(movies);
 
-        if (!result.wasAcknowledged()) {
-            throw new DatabaseOperationException("Batch movie insertion was not acknowledged by the database");
-        }
+        // Extract IDs from saved movies
+        Collection<BsonValue> insertedIds = savedMovies.stream()
+                .map(movie -> new org.bson.BsonObjectId(movie.getId()))
+                .collect(Collectors.toList());
 
         return new BatchInsertResponse(
-                result.getInsertedIds().size(),
-                result.getInsertedIds().values()
+                savedMovies.size(),
+                insertedIds
         );
     }
     
@@ -145,19 +159,25 @@ public Movie updateMovie(String id, UpdateMovieRequest request) {
         if (!ObjectId.isValid(id)) {
             throw new ValidationException("Invalid movie ID format");
         }
-        
+
         if (request == null || isUpdateRequestEmpty(request)) {
             throw new ValidationException("No update data provided");
         }
-        
-        Document update = new Document("$set", buildUpdateDocument(request));
-        UpdateResult result = movieRepository.updateOne(new ObjectId(id), update);
-        
+
+        ObjectId objectId = new ObjectId(id);
+
+        // Build Spring Data MongoDB Update object
+        Update update = buildUpdate(request);
+
+        // Use MongoTemplate for update operation
+        Query query = new Query(Criteria.where("_id").is(objectId));
+        UpdateResult result = mongoTemplate.updateFirst(query, update, Movie.class);
+
         if (result.getMatchedCount() == 0) {
             throw new ResourceNotFoundException("Movie not found");
         }
 
-        return movieRepository.findById(new ObjectId(id))
+        return movieRepository.findById(objectId)
                 .orElseThrow(() -> new DatabaseOperationException("Failed to retrieve updated movie"));
     }
     
@@ -171,8 +191,15 @@ public BatchUpdateResponse updateMoviesBatch(Document filter, Document update) {
             throw new ValidationException("Update object cannot be empty");
         }
 
-        Document setUpdate = new Document("$set", update);
-        UpdateResult result = movieRepository.updateMany(filter, setUpdate);
+        // Convert Document filter to Spring Data Query
+        Query query = new Query();
+        filter.forEach((key, value) -> query.addCriteria(Criteria.where(key).is(value)));
+
+        // Convert Document update to Spring Data Update
+        Update mongoUpdate = new Update();
+        update.forEach(mongoUpdate::set);
+
+        UpdateResult result = mongoTemplate.updateMulti(query, mongoUpdate, Movie.class);
 
         return new BatchUpdateResponse(
                 result.getMatchedCount(),
@@ -186,13 +213,16 @@ public DeleteResponse deleteMovie(String id) {
             throw new ValidationException("Invalid movie ID format");
         }
 
-        DeleteResult result = movieRepository.deleteOne(new ObjectId(id));
+        ObjectId objectId = new ObjectId(id);
 
-        if (result.getDeletedCount() == 0) {
+        // Check if movie exists before deleting
+        if (!movieRepository.existsById(objectId)) {
             throw new ResourceNotFoundException("Movie not found");
         }
 
-        return new DeleteResponse(result.getDeletedCount());
+        movieRepository.deleteById(objectId);
+
+        return new DeleteResponse(1L);
     }
     
     @Override
@@ -201,7 +231,11 @@ public DeleteResponse deleteMoviesBatch(Document filter) {
             throw new ValidationException("Filter object is required and cannot be empty. This prevents accidental deletion of all documents.");
         }
 
-        DeleteResult result = movieRepository.deleteMany(filter);
+        // Convert Document filter to Spring Data Query
+        Query query = new Query();
+        filter.forEach((key, value) -> query.addCriteria(Criteria.where(key).is(value)));
+
+        DeleteResult result = mongoTemplate.remove(query, Movie.class);
 
         return new DeleteResponse(result.getDeletedCount());
     }
@@ -211,56 +245,89 @@ public Movie findAndDeleteMovie(String id) {
         if (!ObjectId.isValid(id)) {
             throw new ValidationException("Invalid movie ID format");
         }
-        
-        return movieRepository.findOneAndDelete(new ObjectId(id))
-                .orElseThrow(() -> new ResourceNotFoundException("Movie not found"));
+
+        ObjectId objectId = new ObjectId(id);
+        Query query = new Query(Criteria.where("_id").is(objectId));
+
+        Movie movie = mongoTemplate.findAndRemove(query, Movie.class);
+
+        if (movie == null) {
+            throw new ResourceNotFoundException("Movie not found");
+        }
+
+        return movie;
     }
     
-    private Document buildFilter(MovieSearchQuery query) {
-        Document filter = new Document();
+    /**
+     * Builds a Spring Data MongoDB Query from the search parameters.
+     */
+    private Query buildQuery(MovieSearchQuery query) {
+        Query mongoQuery = new Query();
 
+        // Text search
         if (query.getQ() != null && !query.getQ().trim().isEmpty()) {
-            filter.append("$text", new Document("$search", query.getQ()));
+            TextCriteria textCriteria = TextCriteria.forDefaultLanguage().matching(query.getQ());
+            mongoQuery.addCriteria(textCriteria);
         }
 
+        // Genre filter (case-insensitive regex)
         if (query.getGenre() != null && !query.getGenre().trim().isEmpty()) {
-            filter.append(Movie.Fields.GENRES, new Document("$regex", Pattern.compile(query.getGenre(), Pattern.CASE_INSENSITIVE)));
+            mongoQuery.addCriteria(Criteria.where(Movie.Fields.GENRES)
+                    .regex(Pattern.compile(query.getGenre(), Pattern.CASE_INSENSITIVE)));
         }
 
+        // Year filter
         if (query.getYear() != null) {
-            filter.append(Movie.Fields.YEAR, query.getYear());
+            mongoQuery.addCriteria(Criteria.where(Movie.Fields.YEAR).is(query.getYear()));
         }
 
+        // Rating range filter
         if (query.getMinRating() != null || query.getMaxRating() != null) {
-            Document ratingFilter = new Document();
+            Criteria ratingCriteria = Criteria.where(Movie.Fields.IMDB_RATING);
             if (query.getMinRating() != null) {
-                ratingFilter.append("$gte", query.getMinRating());
+                ratingCriteria = ratingCriteria.gte(query.getMinRating());
             }
             if (query.getMaxRating() != null) {
-                ratingFilter.append("$lte", query.getMaxRating());
+                ratingCriteria = ratingCriteria.lte(query.getMaxRating());
             }
-            filter.append(Movie.Fields.IMDB_RATING, ratingFilter);
+            mongoQuery.addCriteria(ratingCriteria);
         }
 
-        return filter;
+        return mongoQuery;
     }
-    
-    private Document buildSort(String sortBy, String sortOrder) {
+
+    /**
+     * Builds a Spring Data Sort object from sort parameters.
+     */
+    private Sort buildSort(String sortBy, String sortOrder) {
         String field = sortBy != null && !sortBy.trim().isEmpty() ? sortBy : Movie.Fields.TITLE;
-        int order = "desc".equalsIgnoreCase(sortOrder) ? -1 : 1;
-        return new Document(field, order);
+        Sort.Direction direction = "desc".equalsIgnoreCase(sortOrder) ? Sort.Direction.DESC : Sort.Direction.ASC;
+        return Sort.by(direction, field);
     }
     
+    /**
+     * Checks if the update request has any non-null fields.
+     */
     private boolean isUpdateRequestEmpty(UpdateMovieRequest request) {
         @SuppressWarnings("unchecked")
         Map<String, Object> requestMap = objectMapper.convertValue(request, Map.class);
         return requestMap.values().stream().allMatch(java.util.Objects::isNull);
     }
-    
-    private Document buildUpdateDocument(UpdateMovieRequest request) {
+
+    /**
+     * Builds a Spring Data MongoDB Update object from the update request.
+     */
+    private Update buildUpdate(UpdateMovieRequest request) {
         @SuppressWarnings("unchecked")
         Map<String, Object> requestMap = objectMapper.convertValue(request, Map.class);
-        requestMap.values().removeIf(java.util.Objects::isNull);
-        return new Document(requestMap);
+
+        Update update = new Update();
+        requestMap.forEach((key, value) -> {
+            if (value != null) {
+                update.set(key, value);
+            }
+        });
+
+        return update;
     }
 }
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
index df8a858..cefee5d 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
@@ -2,8 +2,6 @@
 
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.mongodb.client.result.DeleteResult;
-import com.mongodb.client.result.InsertManyResult;
-import com.mongodb.client.result.InsertOneResult;
 import com.mongodb.client.result.UpdateResult;
 import com.mongodb.samplemflix.exception.DatabaseOperationException;
 import com.mongodb.samplemflix.exception.ResourceNotFoundException;
@@ -25,6 +23,8 @@
 import org.mockito.InjectMocks;
 import org.mockito.Mock;
 import org.mockito.junit.jupiter.MockitoExtension;
+import org.springframework.data.mongodb.core.MongoTemplate;
+import org.springframework.data.mongodb.core.query.Query;
 
 import java.util.*;
 
@@ -33,10 +33,10 @@
 import static org.mockito.Mockito.*;
 
 /**
- * Unit tests for MovieServiceImpl.
+ * Unit tests for MovieServiceImpl using Spring Data MongoDB.
  *
  * These tests verify the business logic of the service layer
- * by mocking the repository layer dependencies.
+ * by mocking the repository and MongoTemplate dependencies.
  */
 @ExtendWith(MockitoExtension.class)
 @DisplayName("MovieService Unit Tests")
@@ -45,6 +45,9 @@ class MovieServiceTest {
     @Mock
     private MovieRepository movieRepository;
 
+    @Mock
+    private MongoTemplate mongoTemplate;
+
     @Mock
     private ObjectMapper objectMapper;
 
@@ -89,7 +92,7 @@ void testGetAllMovies_WithDefaults() {
         MovieSearchQuery query = MovieSearchQuery.builder().build();
         List<Movie> expectedMovies = Arrays.asList(testMovie);
 
-        when(movieRepository.find(any(Document.class), any(Document.class), eq(0), eq(20)))
+        when(mongoTemplate.find(any(Query.class), eq(Movie.class)))
                 .thenReturn(expectedMovies);
 
         // Act
@@ -99,7 +102,7 @@ void testGetAllMovies_WithDefaults() {
         assertNotNull(result);
         assertEquals(1, result.size());
         assertEquals(testMovie.getTitle(), result.get(0).getTitle());
-        verify(movieRepository).find(any(Document.class), any(Document.class), eq(0), eq(20));
+        verify(mongoTemplate).find(any(Query.class), eq(Movie.class));
     }
 
     @Test
@@ -112,7 +115,7 @@ void testGetAllMovies_WithCustomPagination() {
                 .build();
         List<Movie> expectedMovies = Arrays.asList(testMovie);
 
-        when(movieRepository.find(any(Document.class), any(Document.class), eq(10), eq(50)))
+        when(mongoTemplate.find(any(Query.class), eq(Movie.class)))
                 .thenReturn(expectedMovies);
 
         // Act
@@ -121,7 +124,7 @@ void testGetAllMovies_WithCustomPagination() {
         // Assert
         assertNotNull(result);
         assertEquals(1, result.size());
-        verify(movieRepository).find(any(Document.class), any(Document.class), eq(10), eq(50));
+        verify(mongoTemplate).find(any(Query.class), eq(Movie.class));
     }
 
     @Test
@@ -132,14 +135,14 @@ void testGetAllMovies_EnforcesMaxLimit() {
                 .limit(200)
                 .build();
 
-        when(movieRepository.find(any(Document.class), any(Document.class), eq(0), eq(100)))
+        when(mongoTemplate.find(any(Query.class), eq(Movie.class)))
                 .thenReturn(Collections.emptyList());
 
         // Act
         movieService.getAllMovies(query);
 
         // Assert
-        verify(movieRepository).find(any(Document.class), any(Document.class), eq(0), eq(100));
+        verify(mongoTemplate).find(any(Query.class), eq(Movie.class));
     }
 
     @Test
@@ -150,14 +153,14 @@ void testGetAllMovies_EnforcesMinLimit() {
                 .limit(0)
                 .build();
 
-        when(movieRepository.find(any(Document.class), any(Document.class), eq(0), eq(1)))
+        when(mongoTemplate.find(any(Query.class), eq(Movie.class)))
                 .thenReturn(Collections.emptyList());
 
         // Act
         movieService.getAllMovies(query);
 
         // Assert
-        verify(movieRepository).find(any(Document.class), any(Document.class), eq(0), eq(1));
+        verify(mongoTemplate).find(any(Query.class), eq(Movie.class));
     }
 
     // ==================== GET MOVIE BY ID TESTS ====================
@@ -207,19 +210,14 @@ void testGetMovieById_NotFound() {
     @DisplayName("Should create movie successfully")
     void testCreateMovie_Success() {
         // Arrange
-        InsertOneResult insertResult = mock(InsertOneResult.class);
-        when(insertResult.wasAcknowledged()).thenReturn(true);
-        when(insertResult.getInsertedId()).thenReturn(new BsonObjectId(testId));
-        when(movieRepository.insertOne(any(Movie.class))).thenReturn(insertResult);
-        when(movieRepository.findById(testId)).thenReturn(Optional.of(testMovie));
+        when(movieRepository.save(any(Movie.class))).thenReturn(testMovie);
 
         // Act
         Movie result = movieService.createMovie(createRequest);
 
         // Assert
         assertNotNull(result);
-        verify(movieRepository).insertOne(any(Movie.class));
-        verify(movieRepository).findById(testId);
+        verify(movieRepository).save(any(Movie.class));
     }
 
     @Test
@@ -233,7 +231,7 @@ void testCreateMovie_NullTitle() {
 
         // Act & Assert
         assertThrows(ValidationException.class, () -> movieService.createMovie(invalidRequest));
-        verify(movieRepository, never()).insertOne(any());
+        verify(movieRepository, never()).save(any());
     }
 
     @Test
@@ -247,37 +245,7 @@ void testCreateMovie_EmptyTitle() {
 
         // Act & Assert
         assertThrows(ValidationException.class, () -> movieService.createMovie(invalidRequest));
-        verify(movieRepository, never()).insertOne(any());
-    }
-
-    @Test
-    @DisplayName("Should throw DatabaseOperationException when insert not acknowledged")
-    void testCreateMovie_NotAcknowledged() {
-        // Arrange
-        InsertOneResult insertResult = mock(InsertOneResult.class);
-        when(insertResult.wasAcknowledged()).thenReturn(false);
-        when(movieRepository.insertOne(any(Movie.class))).thenReturn(insertResult);
-
-        // Act & Assert
-        assertThrows(DatabaseOperationException.class, () -> movieService.createMovie(createRequest));
-        verify(movieRepository).insertOne(any(Movie.class));
-        verify(movieRepository, never()).findById(any());
-    }
-
-    @Test
-    @DisplayName("Should throw DatabaseOperationException when created movie not found")
-    void testCreateMovie_CreatedMovieNotFound() {
-        // Arrange
-        InsertOneResult insertResult = mock(InsertOneResult.class);
-        when(insertResult.wasAcknowledged()).thenReturn(true);
-        when(insertResult.getInsertedId()).thenReturn(new BsonObjectId(testId));
-        when(movieRepository.insertOne(any(Movie.class))).thenReturn(insertResult);
-        when(movieRepository.findById(testId)).thenReturn(Optional.empty());
-
-        // Act & Assert
-        assertThrows(DatabaseOperationException.class, () -> movieService.createMovie(createRequest));
-        verify(movieRepository).insertOne(any(Movie.class));
-        verify(movieRepository).findById(testId);
+        verify(movieRepository, never()).save(any());
     }
 
     // ==================== CREATE MOVIES BATCH TESTS ====================
@@ -287,14 +255,9 @@ void testCreateMovie_CreatedMovieNotFound() {
     void testCreateMoviesBatch_Success() {
         // Arrange
         List<CreateMovieRequest> requests = Arrays.asList(createRequest, createRequest);
-        InsertManyResult insertResult = mock(InsertManyResult.class);
-        Map<Integer, org.bson.BsonValue> insertedIds = new HashMap<>();
-        insertedIds.put(0, new BsonObjectId(new ObjectId()));
-        insertedIds.put(1, new BsonObjectId(new ObjectId()));
+        List<Movie> savedMovies = Arrays.asList(testMovie, testMovie);
 
-        when(insertResult.wasAcknowledged()).thenReturn(true);
-        when(insertResult.getInsertedIds()).thenReturn(insertedIds);
-        when(movieRepository.insertMany(anyList())).thenReturn(insertResult);
+        when(movieRepository.saveAll(anyList())).thenReturn(savedMovies);
 
         // Act
         BatchInsertResponse result = movieService.createMoviesBatch(requests);
@@ -303,21 +266,7 @@ void testCreateMoviesBatch_Success() {
         assertNotNull(result);
         assertEquals(2, result.getInsertedCount());
         assertNotNull(result.getInsertedIds());
-        verify(movieRepository).insertMany(anyList());
-    }
-
-    @Test
-    @DisplayName("Should throw DatabaseOperationException when batch insert not acknowledged")
-    void testCreateMoviesBatch_NotAcknowledged() {
-        // Arrange
-        List<CreateMovieRequest> requests = Arrays.asList(createRequest);
-        InsertManyResult insertResult = mock(InsertManyResult.class);
-        when(insertResult.wasAcknowledged()).thenReturn(false);
-        when(movieRepository.insertMany(anyList())).thenReturn(insertResult);
-
-        // Act & Assert
-        assertThrows(DatabaseOperationException.class, () -> movieService.createMoviesBatch(requests));
-        verify(movieRepository).insertMany(anyList());
+        verify(movieRepository).saveAll(anyList());
     }
 
     // ==================== UPDATE MOVIE TESTS ====================
@@ -335,7 +284,8 @@ void testUpdateMovie_Success() {
 
         UpdateResult updateResult = mock(UpdateResult.class);
         when(updateResult.getMatchedCount()).thenReturn(1L);
-        when(movieRepository.updateOne(eq(testId), any(Document.class))).thenReturn(updateResult);
+        when(mongoTemplate.updateFirst(any(Query.class), any(org.springframework.data.mongodb.core.query.Update.class), any(Class.class)))
+                .thenReturn(updateResult);
         when(movieRepository.findById(testId)).thenReturn(Optional.of(testMovie));
 
         // Act
@@ -343,7 +293,7 @@ void testUpdateMovie_Success() {
 
         // Assert
         assertNotNull(result);
-        verify(movieRepository).updateOne(eq(testId), any(Document.class));
+        verify(mongoTemplate).updateFirst(any(Query.class), any(org.springframework.data.mongodb.core.query.Update.class), any(Class.class));
         verify(movieRepository).findById(testId);
     }
 
@@ -355,7 +305,7 @@ void testUpdateMovie_InvalidId() {
 
         // Act & Assert
         assertThrows(ValidationException.class, () -> movieService.updateMovie(invalidId, updateRequest));
-        verify(movieRepository, never()).updateOne(any(), any());
+        verify(mongoTemplate, never()).updateFirst(any(Query.class), any(org.springframework.data.mongodb.core.query.Update.class), any(Class.class));
     }
 
     @Test
@@ -370,7 +320,7 @@ void testUpdateMovie_EmptyRequest() {
 
         // Act & Assert
         assertThrows(ValidationException.class, () -> movieService.updateMovie(validId, emptyRequest));
-        verify(movieRepository, never()).updateOne(any(), any());
+        verify(mongoTemplate, never()).updateFirst(any(Query.class), any(org.springframework.data.mongodb.core.query.Update.class), any(Class.class));
     }
 
     @Test
@@ -385,11 +335,12 @@ void testUpdateMovie_NotFound() {
 
         UpdateResult updateResult = mock(UpdateResult.class);
         when(updateResult.getMatchedCount()).thenReturn(0L);
-        when(movieRepository.updateOne(eq(testId), any(Document.class))).thenReturn(updateResult);
+        when(mongoTemplate.updateFirst(any(Query.class), any(org.springframework.data.mongodb.core.query.Update.class), any(Class.class)))
+                .thenReturn(updateResult);
 
         // Act & Assert
         assertThrows(ResourceNotFoundException.class, () -> movieService.updateMovie(validId, updateRequest));
-        verify(movieRepository).updateOne(eq(testId), any(Document.class));
+        verify(mongoTemplate).updateFirst(any(Query.class), any(org.springframework.data.mongodb.core.query.Update.class), any(Class.class));
         verify(movieRepository, never()).findById(any());
     }
 
@@ -400,9 +351,7 @@ void testUpdateMovie_NotFound() {
     void testDeleteMovie_Success() {
         // Arrange
         String validId = testId.toHexString();
-        DeleteResult deleteResult = mock(DeleteResult.class);
-        when(deleteResult.getDeletedCount()).thenReturn(1L);
-        when(movieRepository.deleteOne(testId)).thenReturn(deleteResult);
+        when(movieRepository.existsById(testId)).thenReturn(true);
 
         // Act
         DeleteResponse result = movieService.deleteMovie(validId);
@@ -410,7 +359,8 @@ void testDeleteMovie_Success() {
         // Assert
         assertNotNull(result);
         assertEquals(1L, result.getDeletedCount());
-        verify(movieRepository).deleteOne(testId);
+        verify(movieRepository).existsById(testId);
+        verify(movieRepository).deleteById(testId);
     }
 
     @Test
@@ -421,7 +371,7 @@ void testDeleteMovie_InvalidId() {
 
         // Act & Assert
         assertThrows(ValidationException.class, () -> movieService.deleteMovie(invalidId));
-        verify(movieRepository, never()).deleteOne(any());
+        verify(movieRepository, never()).deleteById(any());
     }
 
     @Test
@@ -429,13 +379,12 @@ void testDeleteMovie_InvalidId() {
     void testDeleteMovie_NotFound() {
         // Arrange
         String validId = testId.toHexString();
-        DeleteResult deleteResult = mock(DeleteResult.class);
-        when(deleteResult.getDeletedCount()).thenReturn(0L);
-        when(movieRepository.deleteOne(testId)).thenReturn(deleteResult);
+        when(movieRepository.existsById(testId)).thenReturn(false);
 
         // Act & Assert
         assertThrows(ResourceNotFoundException.class, () -> movieService.deleteMovie(validId));
-        verify(movieRepository).deleteOne(testId);
+        verify(movieRepository).existsById(testId);
+        verify(movieRepository, never()).deleteById(any());
     }
 
     // ==================== FIND AND DELETE MOVIE TESTS ====================
@@ -445,7 +394,7 @@ void testDeleteMovie_NotFound() {
     void testFindAndDeleteMovie_Success() {
         // Arrange
         String validId = testId.toHexString();
-        when(movieRepository.findOneAndDelete(testId)).thenReturn(Optional.of(testMovie));
+        when(mongoTemplate.findAndRemove(any(Query.class), eq(Movie.class))).thenReturn(testMovie);
 
         // Act
         Movie result = movieService.findAndDeleteMovie(validId);
@@ -453,7 +402,7 @@ void testFindAndDeleteMovie_Success() {
         // Assert
         assertNotNull(result);
         assertEquals(testMovie.getTitle(), result.getTitle());
-        verify(movieRepository).findOneAndDelete(testId);
+        verify(mongoTemplate).findAndRemove(any(Query.class), eq(Movie.class));
     }
 
     @Test
@@ -464,7 +413,7 @@ void testFindAndDeleteMovie_InvalidId() {
 
         // Act & Assert
         assertThrows(ValidationException.class, () -> movieService.findAndDeleteMovie(invalidId));
-        verify(movieRepository, never()).findOneAndDelete(any());
+        verify(mongoTemplate, never()).findAndRemove(any(), any());
     }
 
     @Test
@@ -472,10 +421,10 @@ void testFindAndDeleteMovie_InvalidId() {
     void testFindAndDeleteMovie_NotFound() {
         // Arrange
         String validId = testId.toHexString();
-        when(movieRepository.findOneAndDelete(testId)).thenReturn(Optional.empty());
+        when(mongoTemplate.findAndRemove(any(Query.class), eq(Movie.class))).thenReturn(null);
 
         // Act & Assert
         assertThrows(ResourceNotFoundException.class, () -> movieService.findAndDeleteMovie(validId));
-        verify(movieRepository).findOneAndDelete(testId);
+        verify(mongoTemplate).findAndRemove(any(Query.class), eq(Movie.class));
     }
 }

From 360d825c58b4d8674d884f2e15827e4880722b25 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 28 Oct 2025 16:25:10 -0400
Subject: [PATCH 021/110] update TODOs

---
 server/java-spring/README.md                  |  42 +-
 server/java-spring/TODO.md                    | 372 ++++++++++++++++++
 .../mongodb/samplemflix/model/Comment.java    |  43 +-
 .../mongodb/samplemflix/model/Theater.java    |  29 ++
 .../samplemflix/service/MovieServiceImpl.java |   9 +
 .../samplemflix/util/ValidationUtils.java     |  29 +-
 .../integration/MovieIntegrationTest.java     |  42 +-
 7 files changed, 532 insertions(+), 34 deletions(-)
 create mode 100644 server/java-spring/TODO.md

diff --git a/server/java-spring/README.md b/server/java-spring/README.md
index 54f4498..6f4d7ac 100644
--- a/server/java-spring/README.md
+++ b/server/java-spring/README.md
@@ -102,7 +102,7 @@ Once the application is running, you can access:
 
 ## API Endpoints
 
-### Movies
+### Movies (✅ Implemented)
 
 - `GET /api/movies` - Get all movies (with filtering, sorting, pagination)
 - `GET /api/movies/{id}` - Get a single movie by ID
@@ -114,7 +114,14 @@ Once the application is running, you can access:
 - `DELETE /api/movies` - Delete multiple movies
 - `DELETE /api/movies/{id}/find-and-delete` - Find and delete a movie
 
-> **Note**: Full endpoint implementation is planned for later phases. See the implementation plan for details.
+### Planned Endpoints
+
+See [TODO.md](TODO.md) for a complete list of planned features including:
+- Comments API
+- Users API
+- Sessions API (Authentication)
+- Theaters API (with geospatial queries)
+- Advanced movie features (aggregations, recommendations)
 
 ## Development
 
@@ -137,19 +144,28 @@ java -jar target/sample-mflix-spring-1.0.0.jar
 
 ## Implementation Status
 
-This project is being implemented in phases:
+### ✅ Completed Features
+
+- **Movies CRUD API** - Full create, read, update, delete operations
+- **Spring Data MongoDB** - Repository pattern with MongoTemplate for complex queries
+- **Text Search** - Full-text search on movie titles, plots, and genres
+- **Filtering & Pagination** - Query parameters for filtering, sorting, and pagination
+- **Custom Exception Handling** - Global exception handler with proper HTTP status codes
+- **Type-Safe DTOs** - Specific response types instead of generic Maps
+- **Unit Tests** - 35 tests covering service and controller layers
+- **OpenAPI Documentation** - Swagger UI available at `/swagger-ui.html`
+- **Database Verification** - Startup checks for database connectivity and indexes
+
+### 🚧 In Progress / Planned
 
-- ✅ **Phase 1**: Project Setup and Configuration (CURRENT)
-- ⏳ **Phase 2**: Database Configuration and Connection
-- ⏳ **Phase 3**: Model Layer Implementation
-- ⏳ **Phase 4**: Repository Layer
-- ⏳ **Phase 5**: Service Layer
-- ⏳ **Phase 6**: Controller Layer
-- ⏳ **Phase 7**: Error Handling
-- ⏳ **Phase 8**: Testing
-- ⏳ **Phase 9**: Documentation and Polish
+See [TODO.md](TODO.md) for a comprehensive list of planned features and improvements, including:
 
-See `JAVA-SPRING-IMPLEMENTATION-PLAN.md` in the repository root for the complete implementation plan.
+- Additional collections (Comments, Users, Sessions, Theaters)
+- Authentication & Authorization (Spring Security + JWT)
+- Integration tests with Testcontainers
+- Advanced queries (aggregations, geospatial, vector search)
+- Performance optimization and caching
+- Monitoring and observability
 
 ## Technology Stack
 
diff --git a/server/java-spring/TODO.md b/server/java-spring/TODO.md
new file mode 100644
index 0000000..8be6099
--- /dev/null
+++ b/server/java-spring/TODO.md
@@ -0,0 +1,372 @@
+# TODO List - Java Spring Boot MongoDB Sample Application
+
+This document tracks remaining functionality and improvements for the Java Spring Boot backend based on the **Requirements for Sample Repositories for MongoDB Atlas** and **Sample Application Scoping** documents.
+
+## 📋 Scope Alignment
+
+This sample application must demonstrate:
+- ✅ **Basic CRUD** - insertOne(), insertMany(), findOne(), find(), updateOne(), updateMany(), deleteOne(), deleteMany(), findOneAndDelete()
+- 🚧 **Aggregations** - Reporting by comments, year, and director
+- 🚧 **Search** - Full-text search using Search Index on plot
+- 🚧 **Vector Search** - Find similar movies based on plot embeddings
+- 🚧 **Geospatial** - Find theaters near coordinates
+- 🚧 **Recommendations** - Potentially using Vector Search
+
+## ✅ Completed Features (In Scope)
+
+- [x] **Basic CRUD operations for Movies collection**
+  - [x] insertOne() - `POST /api/movies`
+  - [x] insertMany() - `POST /api/movies/batch`
+  - [x] findOne() - `GET /api/movies/{id}`
+  - [x] find() - `GET /api/movies`
+  - [x] updateOne() - `PUT /api/movies/{id}`
+  - [x] updateMany() - `PATCH /api/movies`
+  - [x] deleteOne() - `DELETE /api/movies/{id}`
+  - [x] deleteMany() - `DELETE /api/movies`
+  - [x] findOneAndDelete() - `DELETE /api/movies/{id}/find-and-delete`
+- [x] Spring Data MongoDB migration
+- [x] Filtering, sorting, and pagination
+- [x] Custom exception handling
+- [x] Type-safe response DTOs
+- [x] Unit tests for service and controller layers (35 tests)
+- [x] OpenAPI/Swagger documentation
+- [x] Database verification on startup (checks indexes and data)
+- [x] CORS configuration
+- [x] Field name constants for type safety
+- [x] Environment variable configuration (.env support)
+
+## 🚧 High Priority TODOs (Required by Scope)
+
+### 1. Aggregations (REQUIRED)
+
+**Scope Requirement**: Implement aggregation pipelines for reporting
+
+- [ ] **GET /api/movies/reportingByComments** - Aggregate movies with most comments
+  - [ ] Create aggregation pipeline using `$lookup` to join with comments collection
+  - [ ] Sort by comment count descending
+  - [ ] Add pagination support
+  - [ ] Add unit tests
+
+- [ ] **GET /api/movies/reportingByYear** - Aggregate movies by year with average rating
+  - [ ] Create aggregation pipeline grouping by year
+  - [ ] Calculate average IMDB rating per year
+  - [ ] Sort by year
+  - [ ] Add unit tests
+
+- [ ] **GET /api/movies/reportingByDirector** - Aggregate directors with most movies
+  - [ ] Create aggregation pipeline using `$unwind` on directors array
+  - [ ] Group by director and count movies
+  - [ ] Sort by movie count descending
+  - [ ] Add pagination support
+  - [ ] Add unit tests
+
+### 2. Search (REQUIRED)
+
+**Scope Requirement**: Implement Full-Text Search and Vector Search
+
+- [ ] **GET /api/movies/searchByPlot** - Text Search using Search Index
+  - [ ] Verify text index exists on plot, fullplot, genres, title fields
+  - [ ] Implement text search using Spring Data MongoDB TextCriteria
+  - [ ] Add relevance scoring
+  - [ ] Add pagination support
+  - [ ] Add unit tests
+  - [ ] Document index requirements in README
+
+- [ ] **GET /api/movies/findSimilarMovies** - Vector Search for similar movies
+  - [ ] Implement vector search on `plot_embedding` field
+  - [ ] Use MongoDB Atlas Vector Search
+  - [ ] Add similarity threshold parameter
+  - [ ] Add limit parameter
+  - [ ] Add unit tests
+  - [ ] Document vector search index requirements
+
+### 3. Geospatial (REQUIRED)
+
+**Scope Requirement**: Find theaters near coordinates
+
+- [ ] **GET /api/theaters/findTheatersNearCoordinates** - Geospatial query
+  - [ ] Create `Theater` entity (already exists, needs repository)
+  - [ ] Create `TheaterRepository` with geospatial query methods
+  - [ ] Create `TheaterService` and `TheaterServiceImpl`
+  - [ ] Create `TheaterController` with endpoint
+  - [ ] Implement `$near` or `$geoNear` query
+  - [ ] Add distance parameter (in meters/miles)
+  - [ ] Add limit parameter
+  - [ ] Verify geospatial index exists on `location.geo`
+  - [ ] Add unit tests
+  - [ ] Add integration tests
+
+### 4. Recommendations (OPTIONAL - FUTURE)
+
+**Scope Requirement**: Potentially use Vector Search to power recommendations
+
+- [ ] Design recommendation algorithm
+- [ ] Implement using Vector Search on plot embeddings
+- [ ] Consider user preferences/history
+- [ ] Add endpoint `GET /api/movies/recommendations`
+- [ ] Add tests
+
+### 5. Comments Collection Support (For Aggregations)
+
+**Note**: Required to support "reportingByComments" aggregation
+
+- [ ] Verify `Comment` entity model (already exists)
+- [ ] Create `CommentRepository` interface
+- [ ] Create `CommentService` and `CommentServiceImpl`
+- [ ] Create `CommentController` with basic endpoints:
+  - `GET /api/comments/movie/{movieId}` - Get comments for a specific movie
+  - `POST /api/comments` - Create a new comment
+- [ ] Add tests for Comment functionality
+
+### 6. Testing (REQUIRED)
+
+**Scope Requirement**: Unit tests and E2E tests
+
+- [ ] **Unit Tests** - Test individual features and driver interactions
+  - [x] Service layer unit tests (21 tests completed)
+  - [x] Controller layer unit tests (14 tests completed)
+  - [ ] Add tests for aggregation methods
+  - [ ] Add tests for search methods
+  - [ ] Add tests for geospatial queries
+  - [ ] Add tests for vector search
+
+- [ ] **Integration Tests** - Test complete flows
+  - [ ] Set up Testcontainers for MongoDB
+  - [ ] Create integration tests for all CRUD endpoints
+  - [ ] Create integration tests for aggregations
+  - [ ] Create integration tests for search
+  - [ ] Create integration tests for geospatial queries
+  - [ ] Test error handling and edge cases
+
+### 7. Error Handling & Verification (REQUIRED)
+
+**Scope Requirement**: Pre-flight checks and error handling
+
+- [x] Verify requirements function on app start (DatabaseVerification.java)
+  - [x] Check for indexes
+  - [x] Check for sample data
+  - [x] Create indexes if missing
+- [x] Basic error handling implemented
+  - [x] Connection errors
+  - [x] Invalid input validation
+  - [x] Custom exceptions (ValidationException, ResourceNotFoundException, DatabaseOperationException)
+  - [x] Global exception handler
+- [ ] Enhance error handling for new features:
+  - [ ] Vector search errors
+  - [ ] Geospatial query errors
+  - [ ] Aggregation pipeline errors
+
+### 8. Documentation (REQUIRED)
+
+**Scope Requirement**: Clear README and documentation
+
+- [x] README.md with prerequisites and setup
+- [x] Environment variable configuration (.env.example)
+- [x] OpenAPI/Swagger documentation
+- [ ] Update README with:
+  - [ ] Aggregation endpoint documentation
+  - [ ] Search endpoint documentation
+  - [ ] Vector search setup instructions
+  - [ ] Geospatial query examples
+  - [ ] Index requirements
+- [ ] Add code comments for MongoDB features
+  - [ ] Comment aggregation pipelines
+  - [ ] Comment vector search implementation
+  - [ ] Comment geospatial queries
+  - [ ] Note where readability was prioritized over performance
+
+## 📝 Medium Priority TODOs (Out of Scope - Future Enhancements)
+
+### 9. Additional Collections (Optional)
+
+**Note**: These collections are not required by the current scope but may be useful for future enhancements.
+
+#### Users Collection (`sample_mflix.users`)
+- [ ] Create `UserRepository` interface (model already exists)
+- [ ] Create `UserService` and `UserServiceImpl`
+- [ ] Implement password hashing (BCrypt)
+- [ ] Add email validation
+- [ ] Add tests for User functionality
+
+#### Sessions Collection (`sample_mflix.sessions`)
+- [ ] Create `SessionRepository` interface (model already exists)
+- [ ] Create `SessionService` and `SessionServiceImpl`
+- [ ] Implement JWT token generation and validation
+- [ ] Add tests for Session functionality
+
+#### Embedded Movies Collection (`sample_mflix.embedded_movies`)
+- [ ] Investigate purpose and schema of this collection
+- [ ] Determine if separate endpoints are needed
+- [ ] Document relationship to main `movies` collection
+
+### 10. Authentication & Authorization (Out of Scope)
+
+**Note**: Not required by current scope, but useful for production applications
+
+- [ ] Implement Spring Security
+- [ ] Add JWT authentication filter
+- [ ] Create `@PreAuthorize` annotations for role-based access
+- [ ] Implement user roles (USER, ADMIN)
+- [ ] Add authentication to existing endpoints
+- [ ] Create authentication integration tests
+
+### 11. API Improvements (Out of Scope)
+
+- [ ] Add HATEOAS links to responses
+- [ ] Implement API versioning (e.g., `/api/v1/movies`)
+- [ ] Add request/response compression
+- [ ] Implement rate limiting
+- [ ] Add API key authentication option
+- [ ] Create GraphQL endpoint as alternative to REST
+
+### 12. Data Validation & Quality (Partially Complete)
+
+- [x] Basic Jakarta Validation annotations
+- [ ] Create custom validators for complex business rules
+- [ ] Implement data sanitization for user inputs
+- [ ] Add validation for embedded documents
+- [ ] Create validation tests
+
+### 13. Performance Optimization (Out of Scope)
+
+**Note**: Scope prioritizes readability over performance
+
+- [ ] Implement caching with Spring Cache (Redis/Caffeine)
+- [ ] Add database query optimization
+- [ ] Implement connection pooling tuning
+- [ ] Create performance benchmarks
+- [ ] Implement lazy loading for large collections
+- [ ] Document performance vs readability tradeoffs
+
+### 14. Monitoring & Observability (Out of Scope)
+
+- [ ] Add Spring Boot Actuator endpoints
+- [ ] Implement custom health checks
+- [ ] Add metrics collection (Micrometer)
+- [ ] Integrate with Prometheus/Grafana
+- [ ] Add distributed tracing (Sleuth/Zipkin)
+- [ ] Implement structured logging (JSON format)
+
+### 15. Code Quality (Partially Complete)
+
+- [x] Unit tests for core functionality (35 tests)
+- [ ] Increase test coverage to >80%
+- [ ] Add code coverage reporting (JaCoCo)
+- [ ] Add mutation testing (PIT)
+- [ ] Integrate SonarQube for code quality analysis
+- [ ] Add Checkstyle/PMD for code style enforcement
+
+### 16. Build & Deployment (Out of Scope)
+
+**Note**: Deployment is handled by Growth team per scope document
+
+- [ ] Create Dockerfile for containerization
+- [ ] Add Docker Compose for local development
+- [ ] Create Kubernetes deployment manifests
+- [ ] Set up CI/CD pipeline (GitHub Actions)
+- [x] Automated dependency updates (Dependabot) - handled by DevDocs team
+
+### 17. Security Enhancements (Out of Scope)
+
+**Note**: Basic security implemented, advanced features out of scope
+
+- [x] CORS configuration
+- [x] Input validation
+- [ ] Implement HTTPS/TLS
+- [ ] Add CSRF protection
+- [ ] Implement security headers (HSTS, CSP, etc.)
+- [ ] Add security scanning (OWASP Dependency Check)
+
+### 18. Developer Experience (Partially Complete)
+
+- [x] Environment variable configuration
+- [x] Database verification on startup
+- [x] OpenAPI/Swagger documentation
+- [ ] Add Spring Boot DevTools for hot reload
+- [ ] Create seed data script for development
+- [ ] Add API client examples (Postman collection)
+
+## 🐛 Known Issues
+
+- [ ] Update deprecated `@MockBean` to new Spring Boot 3.5+ alternative (warning in tests)
+
+## 📚 Technical Debt
+
+- None currently - code follows best practices and scope requirements
+
+## 🎯 Next Immediate Steps (Priority Order)
+
+Based on the **Sample Application Scoping** document, the next steps are:
+
+### Phase 1: Complete Required Features (In Scope)
+1. **Aggregations** (REQUIRED)
+   - Implement `GET /api/movies/reportingByComments`
+   - Implement `GET /api/movies/reportingByYear`
+   - Implement `GET /api/movies/reportingByDirector`
+
+2. **Search** (REQUIRED)
+   - Implement `GET /api/movies/searchByPlot` (Full-Text Search)
+   - Implement `GET /api/movies/findSimilarMovies` (Vector Search)
+
+3. **Geospatial** (REQUIRED)
+   - Implement `GET /api/theaters/findTheatersNearCoordinates`
+   - Create Theater repository and service
+
+4. **Comments Collection** (REQUIRED for aggregations)
+   - Create CommentRepository and CommentService
+   - Implement basic endpoints to support aggregations
+
+5. **Testing** (REQUIRED)
+   - Add unit tests for all new features
+   - Create integration tests with Testcontainers
+
+6. **Documentation** (REQUIRED)
+   - Update README with new endpoints
+   - Document index requirements
+   - Add code comments explaining MongoDB features
+   - Note readability vs performance tradeoffs
+
+### Phase 2: Quality Assurance (In Scope)
+7. **Error Handling** - Enhance for new features
+8. **Code Comments** - Add more comments than typical production app
+9. **Readability Review** - Ensure code prioritizes clarity over performance
+
+### Phase 3: Future Enhancements (Out of Scope)
+10. Recommendations using Vector Search
+11. Authentication & Authorization
+12. Additional collections (Users, Sessions)
+13. Performance optimizations
+14. Advanced features
+
+## 📋 Scope Compliance Checklist
+
+### Required Features
+- [x] **Basic CRUD** - All methods implemented ✅
+  - [x] insertOne(), insertMany()
+  - [x] findOne(), find()
+  - [x] updateOne(), updateMany()
+  - [x] deleteOne(), deleteMany(), findOneAndDelete()
+- [ ] **Aggregations** - Not yet implemented ⏳
+  - [ ] Reporting by comments
+  - [ ] Reporting by year
+  - [ ] Reporting by director
+- [ ] **Search** - Not yet implemented ⏳
+  - [ ] Full-text search on plot
+- [ ] **Vector Search** - Not yet implemented ⏳
+  - [ ] Find similar movies
+- [ ] **Geospatial** - Not yet implemented ⏳
+  - [ ] Find theaters near coordinates
+
+### Quality Standards
+- [x] **Error Handling** - Basic implementation complete ✅
+- [x] **Testing** - Unit tests complete (35 tests) ✅
+- [ ] **Integration Tests** - Pending ⏳
+- [x] **Documentation** - README complete ✅
+- [ ] **Documentation Updates** - Needs updates for new features ⏳
+- [x] **Readability** - Code follows best practices ✅
+- [x] **Code Comments** - Good coverage, needs more for complex features ⏳
+- [x] **Minimal Dependencies** - Using only Spring Boot and MongoDB ✅
+- [x] **Environment Variables** - Implemented with .env.example ✅
+- [x] **Apache License** - Applied ✅
+- [x] **Conventional Commits** - Following standard ✅
+- [x] **Clean Commit History** - Maintained ✅
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
index e7a61f4..580921d 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
@@ -5,6 +5,9 @@
 import lombok.Data;
 import lombok.NoArgsConstructor;
 import org.bson.types.ObjectId;
+import org.springframework.data.annotation.Id;
+import org.springframework.data.mongodb.core.mapping.Document;
+import org.springframework.data.mongodb.core.mapping.Field;
 
 import java.util.Date;
 
@@ -13,42 +16,70 @@
  * <p>
  * This class maps to the comments collection in the sample_mflix database.
  * Comments are user reviews/comments associated with movies.
+ *
+ * TODO: Implement Comment functionality:
+ * - Create CommentRepository extending MongoRepository
+ * - Create CommentService and CommentServiceImpl
+ * - Create CommentController with REST endpoints
+ * - Add validation annotations (@NotNull, @Email, etc.)
+ * - Add unit tests for Comment service and controller
+ * - Add integration tests
+ * - Implement query methods (findByMovieId, findByEmail, etc.)
  */
 @Data
 @Builder
 @NoArgsConstructor
 @AllArgsConstructor
+@Document(collection = "comments")
 public class Comment {
-    
+
     /**
      * MongoDB document ID.
      * Maps to the _id field in MongoDB.
      */
+    @Id
     private ObjectId id;
-    
+
     /**
      * Name of the commenter.
      */
     private String name;
-    
+
     /**
      * Email address of the commenter.
      */
     private String email;
-    
+
     /**
      * ID of the movie this comment is associated with.
      * References a document in the movies collection.
      */
+    @Field("movie_id")
     private ObjectId movieId;
-    
+
     /**
      * Comment text content.
      */
     private String text;
-    
+
     /**
      * Date when the comment was posted.
      */
     private Date date;
+
+    /**
+     * Field name constants for type-safe queries.
+     */
+    public static class Fields {
+        public static final String ID = "_id";
+        public static final String NAME = "name";
+        public static final String EMAIL = "email";
+        public static final String MOVIE_ID = "movie_id";
+        public static final String TEXT = "text";
+        public static final String DATE = "date";
+
+        private Fields() {
+            // Private constructor to prevent instantiation
+        }
+    }
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
index 2dc8161..c76511b 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
@@ -5,23 +5,37 @@
 import lombok.Data;
 import lombok.NoArgsConstructor;
 import org.bson.types.ObjectId;
+import org.springframework.data.annotation.Id;
+import org.springframework.data.mongodb.core.mapping.Document;
 
 /**
  * Domain model representing a theater document from the MongoDB theaters collection.
  * <p>
  * This class maps to the theaters collection in the sample_mflix database.
  * It includes location information with address and geospatial coordinates.
+ *
+ * TODO: Implement Theater functionality:
+ * - Create TheaterRepository extending MongoRepository
+ * - Create TheaterService and TheaterServiceImpl
+ * - Create TheaterController with REST endpoints
+ * - Implement geospatial queries (findNear, findWithinRadius)
+ * - Add validation annotations
+ * - Add unit tests for Theater service and controller
+ * - Add integration tests with geospatial queries
+ * - Add GeoJSON support for location queries
  */
 @Data
 @Builder
 @NoArgsConstructor
 @AllArgsConstructor
+@Document(collection = "theaters")
 public class Theater {
     
     /**
      * MongoDB document ID.
      * Maps to the _id field in MongoDB.
      */
+    @Id
     private ObjectId id;
     
     /**
@@ -102,4 +116,19 @@ public static class Geo {
             private double[] coordinates;
         }
     }
+
+    /**
+     * Field name constants for type-safe queries.
+     */
+    public static class Fields {
+        public static final String ID = "_id";
+        public static final String THEATER_ID = "theaterId";
+        public static final String LOCATION = "location";
+        public static final String LOCATION_GEO = "location.geo";
+        public static final String LOCATION_ADDRESS = "location.address";
+
+        private Fields() {
+            // Private constructor to prevent instantiation
+        }
+    }
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index a2fe24d..8cfea02 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -330,4 +330,13 @@ private Update buildUpdate(UpdateMovieRequest request) {
 
         return update;
     }
+
+    // TODO: Add advanced query methods
+    // - getMoviesByGenreStatistics() - Aggregation pipeline for genre statistics
+    // - getTopRatedMovies(int limit) - Movies sorted by rating
+    // - getMoviesByDecade(int decade) - Movies from a specific decade
+    // - getDirectorFilmography(String director) - All movies by a director
+    // - getActorFilmography(String actor) - All movies featuring an actor
+    // - searchSimilarMovies(String movieId) - Vector search on plot_embedding field
+    // - getMovieRecommendations(String userId) - Personalized recommendations
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
index 4c28104..ab46c8d 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
@@ -2,17 +2,32 @@
 
 /**
  * Utility class for validation operations.
- * 
+ *
  * This class provides helper methods for validating request data.
- * 
- * TODO: Phase 5 - Implement validation utility methods
+ *
+ * TODO: Implement validation utility methods:
+ * - Email validation
+ * - Password strength validation
+ * - ObjectId format validation
+ * - Date range validation
+ * - String sanitization
+ * - URL validation
  */
 public class ValidationUtils {
-    
+
     private ValidationUtils() {
         // Private constructor to prevent instantiation
     }
-    
-    // TODO: Phase 5 - Add validation methods
-}
 
+    // TODO: Add email validation method
+    // public static boolean isValidEmail(String email)
+
+    // TODO: Add password strength validation
+    // public static boolean isStrongPassword(String password)
+
+    // TODO: Add ObjectId validation (currently duplicated in service layer)
+    // public static boolean isValidObjectId(String id)
+
+    // TODO: Add string sanitization for XSS prevention
+    // public static String sanitize(String input)
+}
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
index 92d6e2b..200368f 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
@@ -2,15 +2,41 @@
 
 /**
  * Integration tests for the movie API.
- * 
+ *
  * These tests verify the full request/response cycle including database operations.
- * 
- * TODO: Phase 8 - Implement integration tests
- * TODO: Phase 8 - Set up test MongoDB instance (Testcontainers or embedded)
- * TODO: Phase 8 - Test full request/response cycle
+ *
+ * TODO: Set up Testcontainers for MongoDB
+ * - Add testcontainers dependency to pom.xml
+ * - Configure MongoDB test container
+ * - Set up test data initialization
+ *
+ * TODO: Implement integration tests for all endpoints:
+ * - GET /api/movies (with various filters)
+ * - GET /api/movies/{id}
+ * - POST /api/movies
+ * - POST /api/movies/batch
+ * - PUT /api/movies/{id}
+ * - PATCH /api/movies
+ * - DELETE /api/movies/{id}
+ * - DELETE /api/movies
+ * - DELETE /api/movies/{id}/find-and-delete
+ *
+ * TODO: Test error scenarios:
+ * - Invalid ObjectId format
+ * - Resource not found
+ * - Validation errors
+ * - Database connection failures
+ *
+ * TODO: Test performance:
+ * - Large dataset queries
+ * - Pagination performance
+ * - Text search performance
  */
 public class MovieIntegrationTest {
-    
-    // TODO: Phase 8 - Add integration test methods
-}
 
+    // TODO: Add @SpringBootTest annotation
+    // TODO: Add @Testcontainers annotation
+    // TODO: Add MongoDB container configuration
+    // TODO: Add test data setup methods
+    // TODO: Add integration test methods
+}

From 489c950e78a396a161c016c96e11a68181a91b0b Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 28 Oct 2025 16:44:05 -0400
Subject: [PATCH 022/110] rename app

---
 server/java-spring/README.md                                | 2 +-
 server/java-spring/pom.xml                                  | 6 +++---
 .../com/mongodb/samplemflix/SampleMflixApplication.java     | 2 +-
 .../java-spring/src/main/resources/application.properties   | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/server/java-spring/README.md b/server/java-spring/README.md
index 6f4d7ac..f249d24 100644
--- a/server/java-spring/README.md
+++ b/server/java-spring/README.md
@@ -1,4 +1,4 @@
-# MongoDB Sample MFlix - Java Spring Boot Backend [DRAFT]
+# sample-app-java-mflix (INTERNAL)
 
 A Spring Boot REST API demonstrating MongoDB CRUD operations using Spring Data MongoDB with the sample_mflix database.
 
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index bd35bdf..c5b8b90 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -13,10 +13,10 @@
     </parent>
     
     <groupId>com.mongodb</groupId>
-    <artifactId>sample-mflix-spring</artifactId>
+    <artifactId>sample-app-java-mflix</artifactId>
     <version>1.0.0</version>
-    <name>MongoDB Sample MFlix Spring API</name>
-    <description>Spring Boot backend for MongoDB sample mflix application demonstrating CRUD operations using Spring Data MongoDB</description>
+    <name>sample-app-java-mflix</name>
+    <description>Java Spring Boot backend for MongoDB sample_mflix application demonstrating CRUD operations using Spring Data MongoDB</description>
     
     <properties>
         <java.version>17</java.version>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
index 86ea28f..b2e199a 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
@@ -31,7 +31,7 @@ public static void main(String[] args) {
     @GetMapping("/")
     public Map<String, Object> root() {
         return Map.of(
-                "name", "MongoDB Sample MFlix API",
+                "name", "sample-app-java-mflix",
                 "version", "1.0.0",
                 "description", "Java Spring Boot backend demonstrating MongoDB operations with the sample_mflix dataset",
                 "endpoints", Map.of("movies", "/api/movies")
diff --git a/server/java-spring/src/main/resources/application.properties b/server/java-spring/src/main/resources/application.properties
index 46705ba..ff84d9a 100644
--- a/server/java-spring/src/main/resources/application.properties
+++ b/server/java-spring/src/main/resources/application.properties
@@ -12,7 +12,7 @@ server.port=${PORT:3001}
 cors.allowed.origins=${CORS_ORIGIN:http://localhost:3000}
 
 # Application Info
-spring.application.name=MongoDB Sample MFlix API
+spring.application.name=sample-app-java-mflix
 
 # Logging Configuration
 logging.level.com.mongodb.samplemflix=INFO

From 5b6f266b97b37f4b5ba1e5d2556f15736b43061d Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 28 Oct 2025 16:47:34 -0400
Subject: [PATCH 023/110] remove unnecessary file

---
 server/express/src/utils/errorHandler.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/server/express/src/utils/errorHandler.ts b/server/express/src/utils/errorHandler.ts
index 83a2b54..929cf29 100644
--- a/server/express/src/utils/errorHandler.ts
+++ b/server/express/src/utils/errorHandler.ts
@@ -28,13 +28,13 @@ export class ValidationError extends Error {
  * @param err - The error that was thrown
  * @param req - Express request object
  * @param res - Express response object
- * @param _next - Express next function
+ * @param next - Express next function
  */
 export function errorHandler(
   err: Error,
   req: Request,
   res: Response,
-  _next: NextFunction
+  next: NextFunction
 ): void {
   // Log the error for debugging purposes
   // In production, we recommend using a logging service

From 605d8390945103fb1bfa29b4fce63b0121c70fda Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 28 Oct 2025 16:51:37 -0400
Subject: [PATCH 024/110] update README

---
 server/java-spring/README.md | 4 ++--
 server/java-spring/pom.xml   | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/server/java-spring/README.md b/server/java-spring/README.md
index f249d24..c874739 100644
--- a/server/java-spring/README.md
+++ b/server/java-spring/README.md
@@ -170,10 +170,10 @@ See [TODO.md](TODO.md) for a comprehensive list of planned features and improvem
 ## Technology Stack
 
 - **Framework**: Spring Boot 3.5.7
-- **Java Version**: 17
+- **Java Version**: 21
 - **MongoDB**: Spring Data MongoDB 4.5.5
 - **Build Tool**: Maven
-- **API Documentation**: SpringDoc OpenAPI 2.3.0
+- **API Documentation**: SpringDoc OpenAPI 2.8.13
 - **Testing**: JUnit 5, Mockito, Spring Boot Test
 
 ## Educational Purpose
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index c5b8b90..dcd237a 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -19,7 +19,7 @@
     <description>Java Spring Boot backend for MongoDB sample_mflix application demonstrating CRUD operations using Spring Data MongoDB</description>
     
     <properties>
-        <java.version>17</java.version>
+        <java.version>21</java.version>
         <springdoc.version>2.8.13</springdoc.version>
         <dotenv.version>4.0.0</dotenv.version>
     </properties>

From c23c70912a6ffb0ad3413652a60c17922f2c3c20 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Wed, 29 Oct 2025 09:18:08 -0400
Subject: [PATCH 025/110] Apply Vitaliy feedback

---
 server/express/.gitignore                     | 30 ++++++++++++-------
 server/java-spring/.gitignore                 | 14 ++++-----
 server/java-spring/pom.xml                    | 21 +++++++++++++
 .../samplemflix/SampleMflixApplication.java   |  3 +-
 .../samplemflix/config/CorsConfig.java        |  3 +-
 .../config/DatabaseVerification.java          |  3 +-
 .../samplemflix/config/MongoConfig.java       |  3 +-
 .../controller/MovieControllerImpl.java       |  7 ++---
 .../exception/GlobalExceptionHandler.java     |  3 +-
 .../mongodb/samplemflix/model/Comment.java    | 18 +----------
 .../com/mongodb/samplemflix/model/Movie.java  |  5 ++--
 .../model/dto/BatchInsertResponse.java        |  3 +-
 .../model/dto/CreateMovieRequest.java         |  3 +-
 .../model/dto/UpdateMovieRequest.java         |  3 +-
 .../model/response/ErrorResponse.java         |  3 +-
 .../model/response/SuccessResponse.java       |  3 +-
 .../samplemflix/service/MovieService.java     |  3 +-
 .../samplemflix/service/MovieServiceImpl.java | 16 ++++------
 .../controller/MovieControllerTest.java       | 27 ++++++++---------
 .../samplemflix/service/MovieServiceTest.java | 15 ++++------
 20 files changed, 88 insertions(+), 98 deletions(-)

diff --git a/server/express/.gitignore b/server/express/.gitignore
index d0ebe3f..db4c02d 100644
--- a/server/express/.gitignore
+++ b/server/express/.gitignore
@@ -1,16 +1,26 @@
-# =============================================================================
-# Express.js Backend - Specific Ignores
-# =============================================================================
-# Common patterns (node_modules, .env, .DS_Store, etc.) are in root .gitignore
-# This file only contains Express/TypeScript-specific patterns
-# =============================================================================
+# Dependencies
+node_modules/
+npm-debug.log*
+package-lock.json
+
+# Environment variables
+.env
 
-# Build Output
+# Build output
 dist/
-build/
 
 # TypeScript
 *.tsbuildinfo
 
-# Package Lock
-package-lock.json
+# Logs
+logs
+*.log
+
+# Test coverage
+coverage/
+
+# Optional npm cache directory
+.npm
+
+# macOS
+.DS_Store
diff --git a/server/java-spring/.gitignore b/server/java-spring/.gitignore
index 4a4b992..7cf3f4a 100644
--- a/server/java-spring/.gitignore
+++ b/server/java-spring/.gitignore
@@ -1,5 +1,10 @@
 # Java/Spring Boot - Specific Ignores
-# Common patterns (.env, .DS_Store, .idea/, .vscode/, logs) in root .gitignore
+# Common patterns
+.env
+.DS_Store
+
+#Cache
+.cache/
 
 # Compiled Files
 *.class
@@ -28,13 +33,6 @@ buildNumber.properties
 .mvn/timing.properties
 .mvn/wrapper/maven-wrapper.jar
 
-# Gradle
-.gradle/
-build/
-!gradle/wrapper/gradle-wrapper.jar
-!**/src/main/**/build/
-!**/src/test/**/build/
-
 # IntelliJ IDEA
 *.iws
 *.iml
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index dcd237a..77ba7a6 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -22,6 +22,7 @@
         <java.version>21</java.version>
         <springdoc.version>2.8.13</springdoc.version>
         <dotenv.version>4.0.0</dotenv.version>
+        <impsort.plugin.version>1.12.0</impsort.plugin.version>
     </properties>
 
     <dependencies>
@@ -97,6 +98,26 @@
                     </excludes>
                 </configuration>
             </plugin>
+            <!-- Sort and remove unused imports -->
+            <plugin>
+                <groupId>net.revelc.code</groupId>
+                <artifactId>impsort-maven-plugin</artifactId>
+                <version>${impsort.plugin.version}</version>
+                <configuration>
+                    <!-- store outside of target to speed up formatting when mvn clean is used -->
+                    <cachedir>../.cache/impsort-maven-plugin-${impsort.plugin.version}</cachedir>
+                    <staticGroups>*</staticGroups>
+                    <removeUnused>true</removeUnused>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>sort-imports</id>
+                        <goals>
+                            <goal>sort</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
         </plugins>
     </build>
 </project>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
index b2e199a..d7457f7 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
@@ -1,12 +1,11 @@
 package com.mongodb.samplemflix;
 
+import java.util.Map;
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 
-import java.util.Map;
-
 /**
  * Main Spring Boot application class for the MongoDB Sample MFlix API.
  *
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
index 178cdc3..bb75d25 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
@@ -1,5 +1,6 @@
 package com.mongodb.samplemflix.config;
 
+import java.util.Arrays;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
@@ -7,8 +8,6 @@
 import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
 import org.springframework.web.filter.CorsFilter;
 
-import java.util.Arrays;
-
 /**
  * CORS (Cross-Origin Resource Sharing) configuration for the Sample MFlix API.
  * <p>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
index c11a4b6..40a7b3b 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -5,13 +5,12 @@
 import com.mongodb.client.model.IndexOptions;
 import com.mongodb.client.model.Indexes;
 import com.mongodb.samplemflix.model.Movie;
+import jakarta.annotation.PostConstruct;
 import org.bson.Document;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.stereotype.Component;
 
-import jakarta.annotation.PostConstruct;
-
 /**
  * Database verification component that runs on application startup.
  * <p>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
index 765989c..a6a1d1f 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
@@ -2,13 +2,12 @@
 
 import com.mongodb.ConnectionString;
 import com.mongodb.MongoClientSettings;
+import java.util.concurrent.TimeUnit;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.data.mongodb.config.AbstractMongoClientConfiguration;
 import org.springframework.data.mongodb.repository.config.EnableMongoRepositories;
 
-import java.util.concurrent.TimeUnit;
-
 /**
  * MongoDB configuration class for the Sample MFlix application using Spring Data MongoDB.
  * <p>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index 4a139c0..5409494 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -10,15 +10,14 @@
 import com.mongodb.samplemflix.model.response.SuccessResponse;
 import com.mongodb.samplemflix.service.MovieService;
 import jakarta.validation.Valid;
+import java.time.Instant;
+import java.util.List;
+import java.util.Map;
 import org.bson.Document;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.*;
 
-import java.time.Instant;
-import java.util.List;
-import java.util.Map;
-
 /**
  * REST controller for movie-related endpoints.
  * <p>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
index c128981..ef5f11c 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
@@ -2,6 +2,7 @@
 
 import com.mongodb.MongoWriteException;
 import com.mongodb.samplemflix.model.response.ErrorResponse;
+import java.time.Instant;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.http.HttpStatus;
@@ -10,8 +11,6 @@
 import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.context.request.WebRequest;
 
-import java.time.Instant;
-
 /**
  * Global exception handler for the application.
  *
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
index 580921d..98fb66f 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
@@ -1,5 +1,6 @@
 package com.mongodb.samplemflix.model;
 
+import java.util.Date;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
 import lombok.Data;
@@ -9,8 +10,6 @@
 import org.springframework.data.mongodb.core.mapping.Document;
 import org.springframework.data.mongodb.core.mapping.Field;
 
-import java.util.Date;
-
 /**
  * Domain model representing a comment document from the MongoDB comments collection.
  * <p>
@@ -67,19 +66,4 @@ public class Comment {
      */
     private Date date;
 
-    /**
-     * Field name constants for type-safe queries.
-     */
-    public static class Fields {
-        public static final String ID = "_id";
-        public static final String NAME = "name";
-        public static final String EMAIL = "email";
-        public static final String MOVIE_ID = "movie_id";
-        public static final String TEXT = "text";
-        public static final String DATE = "date";
-
-        private Fields() {
-            // Private constructor to prevent instantiation
-        }
-    }
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
index 4efe341..672f131 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
@@ -1,14 +1,13 @@
 package com.mongodb.samplemflix.model;
 
+import java.util.Date;
+import java.util.List;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
 import lombok.Data;
 import lombok.NoArgsConstructor;
 import org.bson.types.ObjectId;
 
-import java.util.Date;
-import java.util.List;
-
 /**
  * Domain model representing a movie document from the MongoDB movies collection.
  * <p>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchInsertResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchInsertResponse.java
index 2196533..94edcd0 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchInsertResponse.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchInsertResponse.java
@@ -1,12 +1,11 @@
 package com.mongodb.samplemflix.model.dto;
 
+import java.util.Collection;
 import lombok.AllArgsConstructor;
 import lombok.Data;
 import lombok.NoArgsConstructor;
 import org.bson.BsonValue;
 
-import java.util.Collection;
-
 /**
  * Response DTO for batch insert operations.
  */
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
index 485f65b..6f4fa61 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
@@ -1,13 +1,12 @@
 package com.mongodb.samplemflix.model.dto;
 
 import jakarta.validation.constraints.NotBlank;
+import java.util.List;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
 import lombok.Data;
 import lombok.NoArgsConstructor;
 
-import java.util.List;
-
 /**
  * Data Transfer Object for creating a new movie.
  * <p>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
index 99d9ab3..192c0f9 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
@@ -1,12 +1,11 @@
 package com.mongodb.samplemflix.model.dto;
 
+import java.util.List;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
 import lombok.Data;
 import lombok.NoArgsConstructor;
 
-import java.util.List;
-
 /**
  * Data Transfer Object for updating an existing movie.
  * <p>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
index 457dd52..9bba8cd 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
@@ -1,13 +1,12 @@
 package com.mongodb.samplemflix.model.response;
 
 import com.fasterxml.jackson.annotation.JsonInclude;
+import java.time.Instant;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
 import lombok.Data;
 import lombok.NoArgsConstructor;
 
-import java.time.Instant;
-
 /**
  * Error response wrapper for API error responses.
  * <p>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
index 251c6f3..5bc305f 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
@@ -1,13 +1,12 @@
 package com.mongodb.samplemflix.model.response;
 
 import com.fasterxml.jackson.annotation.JsonInclude;
+import java.time.Instant;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
 import lombok.Data;
 import lombok.NoArgsConstructor;
 
-import java.time.Instant;
-
 /**
  * Success response wrapper for API responses.
  * <p>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
index 7841e65..7327749 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
@@ -7,9 +7,8 @@
 import com.mongodb.samplemflix.model.dto.DeleteResponse;
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
-import org.bson.Document;
-
 import java.util.List;
+import org.bson.Document;
 
 /**
  * Service interface for movie business logic.
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 8cfea02..2c31c85 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -14,12 +14,15 @@
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.repository.MovieRepository;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+import java.util.regex.Pattern;
+import java.util.stream.Collectors;
 import org.bson.BsonValue;
 import org.bson.Document;
 import org.bson.types.ObjectId;
-import org.springframework.data.domain.PageRequest;
 import org.springframework.data.domain.Sort;
-import org.springframework.data.mongodb.core.FindAndModifyOptions;
 import org.springframework.data.mongodb.core.MongoTemplate;
 import org.springframework.data.mongodb.core.query.Criteria;
 import org.springframework.data.mongodb.core.query.Query;
@@ -27,13 +30,6 @@
 import org.springframework.data.mongodb.core.query.Update;
 import org.springframework.stereotype.Service;
 
-import java.util.ArrayList;
-import java.util.Collection;
-import java.util.List;
-import java.util.Map;
-import java.util.regex.Pattern;
-import java.util.stream.Collectors;
-
 /**
  * Service layer for movie business logic using Spring Data MongoDB.
  * <p>
@@ -64,7 +60,7 @@ public MovieServiceImpl(MovieRepository movieRepository, MongoTemplate mongoTemp
     public List<Movie> getAllMovies(MovieSearchQuery query) {
         Query mongoQuery = buildQuery(query);
 
-        int limit = Math.min(Math.max(query.getLimit() != null ? query.getLimit() : 20, 1), 100);
+        int limit = Math.clamp(query.getLimit() != null ? query.getLimit() : 20, 1, 100);
         int skip = Math.max(query.getSkip() != null ? query.getSkip() : 0, 0);
 
         mongoQuery.skip(skip).limit(limit);
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
index a180d51..b9b5a65 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
@@ -1,5 +1,12 @@
 package com.mongodb.samplemflix.controller;
 
+import static org.hamcrest.Matchers.*;
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.when;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
+
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.mongodb.samplemflix.exception.ResourceNotFoundException;
 import com.mongodb.samplemflix.exception.ValidationException;
@@ -10,6 +17,10 @@
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.service.MovieService;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
 import org.bson.BsonObjectId;
 import org.bson.types.ObjectId;
 import org.junit.jupiter.api.BeforeEach;
@@ -17,22 +28,10 @@
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
-import org.springframework.boot.test.mock.mockito.MockBean;
 import org.springframework.http.MediaType;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
 import org.springframework.test.web.servlet.MockMvc;
 
-import java.util.Arrays;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-
-import static org.hamcrest.Matchers.*;
-import static org.mockito.ArgumentMatchers.any;
-import static org.mockito.ArgumentMatchers.*;
-import static org.mockito.Mockito.when;
-import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
-import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
-
 /**
  * Unit tests for MovieControllerImpl.
  *
@@ -49,7 +48,7 @@ class MovieControllerTest {
     @Autowired
     private ObjectMapper objectMapper;
 
-    @MockBean
+    @MockitoBean
     private MovieService movieService;
 
     private ObjectId testId;
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
index cefee5d..ed57f3b 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
@@ -1,9 +1,11 @@
 package com.mongodb.samplemflix.service;
 
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.Mockito.*;
+
 import com.fasterxml.jackson.databind.ObjectMapper;
-import com.mongodb.client.result.DeleteResult;
 import com.mongodb.client.result.UpdateResult;
-import com.mongodb.samplemflix.exception.DatabaseOperationException;
 import com.mongodb.samplemflix.exception.ResourceNotFoundException;
 import com.mongodb.samplemflix.exception.ValidationException;
 import com.mongodb.samplemflix.model.Movie;
@@ -13,8 +15,7 @@
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.repository.MovieRepository;
-import org.bson.BsonObjectId;
-import org.bson.Document;
+import java.util.*;
 import org.bson.types.ObjectId;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.DisplayName;
@@ -26,12 +27,6 @@
 import org.springframework.data.mongodb.core.MongoTemplate;
 import org.springframework.data.mongodb.core.query.Query;
 
-import java.util.*;
-
-import static org.junit.jupiter.api.Assertions.*;
-import static org.mockito.ArgumentMatchers.*;
-import static org.mockito.Mockito.*;
-
 /**
  * Unit tests for MovieServiceImpl using Spring Data MongoDB.
  *

From 0f3dc54fc7054a8207327991385e4e9461e4fe00 Mon Sep 17 00:00:00 2001
From: cory <115956901+cbullinger@users.noreply.github.com>
Date: Wed, 29 Oct 2025 09:19:43 -0400
Subject: [PATCH 026/110] Apply suggestion from @cbullinger

---
 server/java-spring/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/server/java-spring/README.md b/server/java-spring/README.md
index c874739..05be75b 100644
--- a/server/java-spring/README.md
+++ b/server/java-spring/README.md
@@ -16,7 +16,7 @@ This application provides a REST API for managing movie data from MongoDB's samp
 
 ## Prerequisites
 
-- Java 17 or later
+- Java 21 or later
 - Maven 3.6 or later
 - MongoDB Atlas account or local MongoDB instance with sample_mflix database
 

From 92539734e32746430c06a34786bf06d673c67957 Mon Sep 17 00:00:00 2001
From: cory <115956901+cbullinger@users.noreply.github.com>
Date: Wed, 29 Oct 2025 09:20:53 -0400
Subject: [PATCH 027/110] Apply suggestion from @cbullinger

---
 server/express/.gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/server/express/.gitignore b/server/express/.gitignore
index db4c02d..f9e1d4c 100644
--- a/server/express/.gitignore
+++ b/server/express/.gitignore
@@ -24,3 +24,4 @@ coverage/
 
 # macOS
 .DS_Store
+

From cc13e06f978fe2681d1a4b55f720485871a66419 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Wed, 29 Oct 2025 12:04:57 -0400
Subject: [PATCH 028/110] docs: update comments throughout for consistency

---
 server/java-spring/README.md                  |  7 +---
 server/java-spring/pom.xml                    | 18 ++++++++-
 .../samplemflix/SampleMflixApplication.java   |  2 +-
 .../samplemflix/config/CorsConfig.java        |  8 ++--
 .../config/DatabaseVerification.java          | 32 ++++++++--------
 .../samplemflix/config/MongoConfig.java       | 32 +++++++++++++---
 .../config/ObjectIdSerializer.java            | 13 +++++--
 .../config/ObjectMapperConfig.java            | 10 ++++-
 .../controller/MovieControllerImpl.java       | 38 ++++++++++---------
 .../mongodb/samplemflix/model/Comment.java    |  6 +--
 .../com/mongodb/samplemflix/model/Movie.java  | 16 ++++----
 .../mongodb/samplemflix/model/Theater.java    | 21 ++--------
 .../model/dto/CreateMovieRequest.java         |  4 +-
 .../model/dto/MovieSearchQuery.java           |  4 +-
 .../model/dto/UpdateMovieRequest.java         |  4 +-
 .../model/response/ApiResponse.java           |  8 ++--
 .../model/response/ErrorResponse.java         | 10 ++---
 .../model/response/SuccessResponse.java       | 10 ++---
 .../samplemflix/service/MovieServiceImpl.java |  9 +++--
 .../samplemflix/util/ValidationUtils.java     | 11 ++----
 20 files changed, 148 insertions(+), 115 deletions(-)

diff --git a/server/java-spring/README.md b/server/java-spring/README.md
index 05be75b..4fe120e 100644
--- a/server/java-spring/README.md
+++ b/server/java-spring/README.md
@@ -144,7 +144,7 @@ java -jar target/sample-mflix-spring-1.0.0.jar
 
 ## Implementation Status
 
-### ✅ Completed Features
+### Completed Features
 
 - **Movies CRUD API** - Full create, read, update, delete operations
 - **Spring Data MongoDB** - Repository pattern with MongoTemplate for complex queries
@@ -161,11 +161,8 @@ java -jar target/sample-mflix-spring-1.0.0.jar
 See [TODO.md](TODO.md) for a comprehensive list of planned features and improvements, including:
 
 - Additional collections (Comments, Users, Sessions, Theaters)
-- Authentication & Authorization (Spring Security + JWT)
 - Integration tests with Testcontainers
 - Advanced queries (aggregations, geospatial, vector search)
-- Performance optimization and caching
-- Monitoring and observability
 
 ## Technology Stack
 
@@ -202,7 +199,7 @@ If you encounter connection issues:
 
 If Maven build fails:
 
-1. Ensure you have Java 17 or later installed: `java -version`
+1. Ensure you have Java 21 or later installed: `java -version`
 2. Ensure Maven is installed: `mvn -version`
 3. Clear Maven cache: `mvn clean`
 4. Try rebuilding: `mvn clean install`
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index 77ba7a6..d6bc07b 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -22,7 +22,9 @@
         <java.version>21</java.version>
         <springdoc.version>2.8.13</springdoc.version>
         <dotenv.version>4.0.0</dotenv.version>
+        <commons.lang3.version>3.19.0</commons.lang3.version>
         <impsort.plugin.version>1.12.0</impsort.plugin.version>
+        <byte-buddy.version>1.17.8</byte-buddy.version>
     </properties>
 
     <dependencies>
@@ -57,11 +59,12 @@
             <artifactId>lombok</artifactId>
             <optional>true</optional>
         </dependency>
+
         <!-- Force version for Commons Lang used by SpringDoc (CVE-2025-48924) -->
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-lang3</artifactId>
-            <version>3.19.0</version>
+            <version>${commons.lang3.version}</version>
         </dependency>
         <!-- SpringDoc OpenAPI (Swagger UI) -->
         <dependency>
@@ -86,6 +89,7 @@
     
     <build>
         <plugins>
+            <!-- Spring Boot Maven Plugin -->
             <plugin>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-maven-plugin</artifactId>
@@ -98,6 +102,18 @@
                     </excludes>
                 </configuration>
             </plugin>
+
+            <!-- Maven Surefire Plugin - Configure Mockito agent for Java 21+ -->
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-surefire-plugin</artifactId>
+                <configuration>
+                    <argLine>
+                        -javaagent:${settings.localRepository}/net/bytebuddy/byte-buddy-agent/${byte-buddy.version}/byte-buddy-agent-${byte-buddy.version}.jar
+                        -Xshare:off
+                    </argLine>
+                </configuration>
+            </plugin>
             <!-- Sort and remove unused imports -->
             <plugin>
                 <groupId>net.revelc.code</groupId>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
index d7457f7..b3aff5b 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
@@ -9,7 +9,7 @@
 /**
  * Main Spring Boot application class for the MongoDB Sample MFlix API.
  *
- * This application demonstrates MongoDB CRUD operations using the MongoDB Java Driver
+ * <p>This application demonstrates MongoDB CRUD operations using the MongoDB Java Driver
  * in a Spring Boot environment. It provides a REST API for managing movie data from
  * the sample_mflix database.
  *
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
index bb75d25..8e2a31b 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
@@ -10,11 +10,11 @@
 
 /**
  * CORS (Cross-Origin Resource Sharing) configuration for the Sample MFlix API.
- * <p>
- * This configuration allows the frontend application (typically running on a different port
+ *
+ * <p>This configuration allows the frontend application (typically running on a different port
  * during development) to make requests to this backend API.
- * <p>
- * The allowed origins are configured via the CORS_ORIGIN environment variable.
+ *
+ * <p>The allowed origins are configured via the CORS_ORIGIN environment variable.
  */
 @Configuration
 public class CorsConfig {
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
index 40a7b3b..fef480f 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -13,11 +13,11 @@
 
 /**
  * Database verification component that runs on application startup.
- * <p>
- * This component performs pre-flight checks to ensure the MongoDB database
+ *
+ * <p>This component performs pre-flight checks to ensure the MongoDB database
  * is properly configured and contains the expected data and indexes.
- * <p>
- * Verification steps:
+ *
+ * <p>Verification steps:
  * 1. Check if the movies collection exists
  * 2. Verify the collection contains documents
  * 3. Check for text search indexes on plot, title, and fullplot fields
@@ -43,11 +43,11 @@ public DatabaseVerification(MongoDatabase database) {
 
     /**
      * Runs database verification checks after the bean is constructed.
-     * <p>
-     * This method is called automatically by Spring after dependency injection
+     *
+     * <p>This method is called automatically by Spring after dependency injection
      * is complete. It performs all verification steps and logs the results.
-     * <p>
-     * The method catches all exceptions to prevent application startup failure,
+     *
+     * <p>The method catches all exceptions to prevent application startup failure,
      * but logs errors to help developers identify issues.
      */
     @PostConstruct
@@ -70,12 +70,13 @@ public void verifyDatabase() {
     /**
      * Verifies the movies collection exists, contains data, and has required indexes.
      *
-     * This method:
+     * <p>This method:
+     * <pre>
      * 1. Checks if the movies collection exists (implicitly by accessing it)
      * 2. Counts documents to verify sample data is loaded
      * 3. Creates a text search index on plot, title, and fullplot fields
-     *
-     * The text search index enables full-text search functionality across movie
+     *</pre>
+     * <p>The text search index enables full-text search functionality across movie
      * descriptions and titles, which is used by the search endpoint.
      */
     private void verifyMoviesCollection() {
@@ -101,15 +102,16 @@ private void verifyMoviesCollection() {
     /**
      * Creates a text search index on the movies collection if it doesn't already exist.
      *
-     * The index is created on three fields:
+     * <p>The index is created on three fields:
+     * <pre>
      * - plot: Short movie description
      * - title: Movie title
      * - fullplot: Full movie description
-     *
-     * This enables the $text search operator to perform full-text search across
+     * </pre>
+     * <p>This enables the $text search operator to perform full-text search across
      * these fields, which is used by the search endpoint in the API.
      *
-     * The index is created in the background to avoid blocking other operations.
+     * <p>The index is created in the background to avoid blocking other operations.
      * If the index already exists, MongoDB will ignore the duplicate creation request.
      *
      * @param moviesCollection the movies collection to create the index on
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
index a6a1d1f..b0fcfce 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
@@ -2,30 +2,36 @@
 
 import com.mongodb.ConnectionString;
 import com.mongodb.MongoClientSettings;
+import com.mongodb.client.MongoClient;
+import com.mongodb.client.MongoDatabase;
 import java.util.concurrent.TimeUnit;
 import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.data.mongodb.config.AbstractMongoClientConfiguration;
 import org.springframework.data.mongodb.repository.config.EnableMongoRepositories;
 
 /**
  * MongoDB configuration class for the Sample MFlix application using Spring Data MongoDB.
- * <p>
- * This class extends AbstractMongoClientConfiguration to customize MongoDB client settings
+ *
+ * <p>This class extends AbstractMongoClientConfiguration to customize MongoDB client settings
  * while leveraging Spring Data MongoDB's auto-configuration for repositories and templates.
- * <p>
- * Key features:
+ *
+ * <p>Key features:
+ * <pre>
  * - Connection pooling with configurable settings (max 100 connections, min 10)
  * - Connection timeout configuration (10 seconds for connect and read)
  * - Automatic POJO mapping (no manual codec configuration needed)
  * - Repository scanning and auto-configuration
  * - MongoTemplate bean creation for complex queries
- * <p>
- * Spring Data MongoDB automatically:
+ * </pre>
+ * <p>Spring Data MongoDB automatically:
+ * <pre>
  * - Creates MongoClient and MongoTemplate beans
  * - Handles POJO to BSON conversion
  * - Manages connection lifecycle
  * - Provides repository implementations
+ * </pre>
  */
 @Configuration
 @EnableMongoRepositories(basePackages = "com.mongodb.samplemflix.repository")
@@ -73,4 +79,18 @@ protected void configureClientSettings(MongoClientSettings.Builder builder) {
                     clusterBuilder.serverSelectionTimeout(10000, TimeUnit.MILLISECONDS)  // 10s to select server
                 );
     }
+
+    /**
+     * Provides a MongoDatabase bean for direct MongoDB driver access.
+     *
+     * <p>This bean is needed for components that require direct access to the MongoDB
+     * driver API (like DatabaseVerification), while still using Spring Data MongoDB
+     * for repository operations.
+     *
+     * @return the configured MongoDatabase instance
+     */
+    @Bean
+    public MongoDatabase mongoDatabase() {
+        return mongoClient().getDatabase(databaseName);
+    }
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectIdSerializer.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectIdSerializer.java
index 56c2649..bd50571 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectIdSerializer.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectIdSerializer.java
@@ -6,9 +6,15 @@
 import java.io.IOException;
 import org.bson.types.ObjectId;
 
-// ObjectId is a MognoDB GUID Class, an efficient 12 byte UUID starting with a
-// timestamp for efficnent indexing - we need to teach Jackson how to convert it
-// to JSON nicely
+/**
+ * Custom serializer for MongoDB's ObjectId to convert it to a string representation.
+ *
+ * <p>MongoDB's ObjectId is a 12-byte unique identifier. By default, Jackson will serialize it
+ * as a base64 string, but we want to use the more human-readable hex string representation.
+ *
+ * <p>This custom serializer teaches Jackson to convert ObjectId to a hex string when
+ * writing JSON.
+ */
 
 public class ObjectIdSerializer extends StdSerializer<ObjectId> {
 
@@ -22,4 +28,3 @@ public void serialize(ObjectId value, JsonGenerator gen, SerializerProvider prov
         gen.writeString(value.toHexString());
     }
 }
-
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectMapperConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectMapperConfig.java
index ba55e71..6be474d 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectMapperConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectMapperConfig.java
@@ -11,6 +11,15 @@
 import org.springframework.core.io.buffer.DataBufferFactory;
 import org.springframework.core.io.buffer.DefaultDataBufferFactory;
 
+/**
+ * Configuration for customizing the ObjectMapper used for JSON serialization and deserialization.
+ *
+ * <p>This configuration disables the default timestamp serialization for dates and registers a
+ * custom serializer for MongoDB's ObjectId to convert it to a string representation.
+ *
+ * <p>It also registers a JavaTimeModule to handle Java 8 date and time types.
+ */
+
 @Configuration
 public class ObjectMapperConfig {
 
@@ -36,4 +45,3 @@ public DataBufferFactory dataBufferFactory() {
         return new DefaultDataBufferFactory();
     }
 }
-
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index 5409494..0d243c3 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -22,6 +22,7 @@
  * REST controller for movie-related endpoints.
  * <p>
  * This controller handles all HTTP requests for movie operations including:
+ * <pre>
  * - GET /api/movies - Get all movies with filtering, sorting, and pagination
  * - GET /api/movies/{id} - Get a single movie by ID
  * - POST /api/movies - Create a new movie
@@ -31,6 +32,7 @@
  * - DELETE /api/movies/{id} - Delete a movie
  * - DELETE /api/movies - Delete multiple movies
  * - DELETE /api/movies/{id}/find-and-delete - Find and delete a movie
+ * </pre>
  */
 @RestController
 @RequestMapping("/api/movies")
@@ -44,8 +46,8 @@ public MovieControllerImpl(MovieService movieService) {
     
     /**
      * GET /api/movies
-     * <p>
-     * Retrieves multiple movies with optional filtering, sorting, and pagination.
+     *
+     * <p>Retrieves multiple movies with optional filtering, sorting, and pagination.
      */
     @GetMapping
     public ResponseEntity<SuccessResponse<List<Movie>>> getAllMovies(
@@ -85,8 +87,8 @@ public ResponseEntity<SuccessResponse<List<Movie>>> getAllMovies(
     
     /**
      * GET /api/movies/{id}
-     * <p>
-     * Retrieves a single movie by its ObjectId.
+     *
+     * <p>Retrieves a single movie by its ObjectId.
      */
     @GetMapping("/{id}")
     public ResponseEntity<SuccessResponse<Movie>> getMovieById(@PathVariable String id) {
@@ -104,8 +106,8 @@ public ResponseEntity<SuccessResponse<Movie>> getMovieById(@PathVariable String
     
     /**
      * POST /api/movies
-     * <p>
-     * Creates a single new movie document.
+     *
+     * <p>Creates a single new movie document.
      */
     @PostMapping
     public ResponseEntity<SuccessResponse<Movie>> createMovie(@Valid @RequestBody CreateMovieRequest request) {
@@ -123,8 +125,8 @@ public ResponseEntity<SuccessResponse<Movie>> createMovie(@Valid @RequestBody Cr
     
     /**
      * POST /api/movies/batch
-     * <p>
-     * Creates multiple movie documents in a single operation.
+     *
+     * <p>Creates multiple movie documents in a single operation.
      */
     @PostMapping("/batch")
     public ResponseEntity<SuccessResponse<BatchInsertResponse>> createMoviesBatch(
@@ -143,8 +145,8 @@ public ResponseEntity<SuccessResponse<BatchInsertResponse>> createMoviesBatch(
     
     /**
      * PUT /api/movies/{id}
-     * <p>
-     * Updates a single movie document.
+     *
+     * <p>Updates a single movie document.
      */
     @PutMapping("/{id}")
     public ResponseEntity<SuccessResponse<Movie>> updateMovie(
@@ -164,8 +166,8 @@ public ResponseEntity<SuccessResponse<Movie>> updateMovie(
     
     /**
      * PATCH /api/movies
-     * <p>
-     * Updates multiple movies based on a filter.
+     *
+     * <p>Updates multiple movies based on a filter.
      */
     @SuppressWarnings("unchecked")
     @PatchMapping
@@ -189,8 +191,8 @@ public ResponseEntity<SuccessResponse<BatchUpdateResponse>> updateMoviesBatch(
     
     /**
      * DELETE /api/movies/{id}/find-and-delete
-     * <p>
-     * Finds and deletes a movie in a single atomic operation.
+     *
+     * <p>Finds and deletes a movie in a single atomic operation.
      */
     @DeleteMapping("/{id}/find-and-delete")
     public ResponseEntity<SuccessResponse<Movie>> findAndDeleteMovie(@PathVariable String id) {
@@ -208,8 +210,8 @@ public ResponseEntity<SuccessResponse<Movie>> findAndDeleteMovie(@PathVariable S
     
     /**
      * DELETE /api/movies/{id}
-     * <p>
-     * Deletes a single movie document.
+     *
+     * <p>Deletes a single movie document.
      */
     @DeleteMapping("/{id}")
     public ResponseEntity<SuccessResponse<DeleteResponse>> deleteMovie(@PathVariable String id) {
@@ -227,8 +229,8 @@ public ResponseEntity<SuccessResponse<DeleteResponse>> deleteMovie(@PathVariable
     
     /**
      * DELETE /api/movies
-     * <p>
-     * Deletes multiple movies based on a filter.
+     *
+     * <p>Deletes multiple movies based on a filter.
      */
     @SuppressWarnings("unchecked")
     @DeleteMapping
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
index 98fb66f..15d9c94 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
@@ -12,11 +12,11 @@
 
 /**
  * Domain model representing a comment document from the MongoDB comments collection.
- * <p>
- * This class maps to the comments collection in the sample_mflix database.
+ *
+ * <p>This class maps to the comments collection in the sample_mflix database.
  * Comments are user reviews/comments associated with movies.
  *
- * TODO: Implement Comment functionality:
+ * <p>TODO: Implement Comment functionality:
  * - Create CommentRepository extending MongoRepository
  * - Create CommentService and CommentServiceImpl
  * - Create CommentController with REST endpoints
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
index 672f131..4345b0e 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
@@ -10,12 +10,12 @@
 
 /**
  * Domain model representing a movie document from the MongoDB movies collection.
- * <p>
- * This class maps to the movies collection in the sample_mflix database.
+ *
+ * <p>This class maps to the movies collection in the sample_mflix database.
  * It includes all fields from the movie documents including nested objects
  * for awards, IMDB ratings, and Tomatoes ratings.
- * <p>
- * Note: We use Lombok annotations to reduce boilerplate code:
+ *
+ * <p>Note: We use Lombok annotations to reduce boilerplate code:
  * - @Data: Generates getters, setters, toString, equals, and hashCode
  * - @Builder: Provides a fluent builder pattern for object construction
  * - @NoArgsConstructor: Generates a no-argument constructor (required by MongoDB driver)
@@ -29,12 +29,12 @@ public class Movie {
 
     /**
      * Field name constants for MongoDB operations.
-     * <p>
-     * These constants should be used when referencing field names in queries, filters,
+     *
+     * <p>These constants should be used when referencing field names in queries, filters,
      * indexes, and other MongoDB operations to ensure type safety and enable IDE
      * "Find Usages" functionality.
-     * <p>
-     * Example usage:
+     *
+     * <p>Example usage:
      * <pre>
      * filter.append(Movie.Fields.TITLE, "The Matrix");
      * Indexes.text(Movie.Fields.PLOT);
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
index c76511b..c0d2045 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
@@ -10,11 +10,11 @@
 
 /**
  * Domain model representing a theater document from the MongoDB theaters collection.
- * <p>
- * This class maps to the theaters collection in the sample_mflix database.
+ *
+ * <p>This class maps to the theaters collection in the sample_mflix database.
  * It includes location information with address and geospatial coordinates.
  *
- * TODO: Implement Theater functionality:
+ * <p>TODO: Implement Theater functionality:
  * - Create TheaterRepository extending MongoRepository
  * - Create TheaterService and TheaterServiceImpl
  * - Create TheaterController with REST endpoints
@@ -116,19 +116,4 @@ public static class Geo {
             private double[] coordinates;
         }
     }
-
-    /**
-     * Field name constants for type-safe queries.
-     */
-    public static class Fields {
-        public static final String ID = "_id";
-        public static final String THEATER_ID = "theaterId";
-        public static final String LOCATION = "location";
-        public static final String LOCATION_GEO = "location.geo";
-        public static final String LOCATION_ADDRESS = "location.address";
-
-        private Fields() {
-            // Private constructor to prevent instantiation
-        }
-    }
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
index 6f4fa61..c333064 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
@@ -9,8 +9,8 @@
 
 /**
  * Data Transfer Object for creating a new movie.
- * <p>
- * This DTO is used for POST /api/movies requests.
+ *
+ * <p>This DTO is used for POST /api/movies requests.
  * It includes validation annotations to ensure required fields are present.
  * Only the title field is required; all other fields are optional.
  */
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java
index 20d6833..dc0ea46 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java
@@ -7,8 +7,8 @@
 
 /**
  * Data Transfer Object for movie search query parameters.
- * <p>
- * This DTO is used to parse and validate query parameters for GET /api/movies requests.
+ *
+ * <p>This DTO is used to parse and validate query parameters for GET /api/movies requests.
  * It supports full-text search, filtering by genre/year/rating, sorting, and pagination.
  */
 @Data
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
index 192c0f9..f855276 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
@@ -8,8 +8,8 @@
 
 /**
  * Data Transfer Object for updating an existing movie.
- * <p>
- * This DTO is used for PUT /api/movies/{id} requests.
+ *
+ * <p>This DTO is used for PUT /api/movies/{id} requests.
  * All fields are optional since partial updates are allowed.
  * Any field that is null will not be updated in the database.
  */
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
index b76fa3d..1374efb 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
@@ -2,11 +2,11 @@
 
 /**
  * Generic API response interface.
- * <p>
- * This interface is implemented by both SuccessResponse and ErrorResponse
+ *
+ * <p>This interface is implemented by both SuccessResponse and ErrorResponse
  * to provide a consistent response structure across all API endpoints.
- * <p>
- * All API responses include:
+ *
+ * <p>All API responses include:
  * - success: boolean indicating if the request was successful
  * - timestamp: ISO 8601 timestamp of when the response was generated
  */
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
index 9bba8cd..6fab419 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
@@ -9,10 +9,10 @@
 
 /**
  * Error response wrapper for API error responses.
- * <p>
- * This class wraps error responses with error codes, messages, and metadata.
- * <p>
- * {
+ *
+ * <p>This class wraps error responses with error codes, messages, and metadata.
+ *
+ * <pre> {
  *   success: false,
  *   message: string,
  *   error: {
@@ -21,7 +21,7 @@
  *     details?: any
  *   },
  *   timestamp: string
- * }
+ * }</pre>
  */
 @Data
 @Builder
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
index 5bc305f..69550ee 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
@@ -9,17 +9,17 @@
 
 /**
  * Success response wrapper for API responses.
- * <p>
- * This class wraps successful API responses with metadata like timestamp and pagination.
+ *
+ * <p>This class wraps successful API responses with metadata like timestamp and pagination.
  * It uses a generic type parameter T to hold the response data.
- * <p>
- * {
+ *
+ * <pre>  {
  *   success: true,
  *   message?: string,
  *   data: T,
  *   timestamp: string,
  *   pagination?: { page, limit, total, pages }
- * }
+ * }</pre>
  */
 @Data
 @Builder
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 2c31c85..571cd07 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -32,16 +32,19 @@
 
 /**
  * Service layer for movie business logic using Spring Data MongoDB.
- * <p>
- * This service handles:
+ *
+ * <p>This service handles:
+ * <pre>
  * - Business logic and validation
  * - Query construction using Spring Data MongoDB Query API
  * - Data transformation between DTOs and entities
  * - Error handling and exception throwing
- * <p>
+ * </pre>
  * Uses both:
+ * <pre>
  * - MovieRepository (Spring Data) for simple CRUD operations
  * - MongoTemplate for complex queries and batch operations
+ * </pre>
  */
 @Service
 public class MovieServiceImpl implements MovieService {
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
index ab46c8d..a496b14 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
@@ -6,8 +6,6 @@
  * This class provides helper methods for validating request data.
  *
  * TODO: Implement validation utility methods:
- * - Email validation
- * - Password strength validation
  * - ObjectId format validation
  * - Date range validation
  * - String sanitization
@@ -19,15 +17,12 @@ private ValidationUtils() {
         // Private constructor to prevent instantiation
     }
 
-    // TODO: Add email validation method
-    // public static boolean isValidEmail(String email)
-
-    // TODO: Add password strength validation
-    // public static boolean isStrongPassword(String password)
-
     // TODO: Add ObjectId validation (currently duplicated in service layer)
     // public static boolean isValidObjectId(String id)
 
     // TODO: Add string sanitization for XSS prevention
     // public static String sanitize(String input)
+
+    // TODO: Add URL validation for poster and trailer fields
+    // public static boolean isValidUrl(String url)
 }

From 61559063426910e190c7b56686b20d7d99b8297a Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Thu, 30 Oct 2025 07:59:49 -0400
Subject: [PATCH 029/110] docs: update readme and remove internal todo doc

---
 server/java-spring/README.md |  16 --
 server/java-spring/TODO.md   | 372 -----------------------------------
 2 files changed, 388 deletions(-)
 delete mode 100644 server/java-spring/TODO.md

diff --git a/server/java-spring/README.md b/server/java-spring/README.md
index 4fe120e..90b020f 100644
--- a/server/java-spring/README.md
+++ b/server/java-spring/README.md
@@ -114,15 +114,6 @@ Once the application is running, you can access:
 - `DELETE /api/movies` - Delete multiple movies
 - `DELETE /api/movies/{id}/find-and-delete` - Find and delete a movie
 
-### Planned Endpoints
-
-See [TODO.md](TODO.md) for a complete list of planned features including:
-- Comments API
-- Users API
-- Sessions API (Authentication)
-- Theaters API (with geospatial queries)
-- Advanced movie features (aggregations, recommendations)
-
 ## Development
 
 ### Running Tests
@@ -156,13 +147,6 @@ java -jar target/sample-mflix-spring-1.0.0.jar
 - **OpenAPI Documentation** - Swagger UI available at `/swagger-ui.html`
 - **Database Verification** - Startup checks for database connectivity and indexes
 
-### 🚧 In Progress / Planned
-
-See [TODO.md](TODO.md) for a comprehensive list of planned features and improvements, including:
-
-- Additional collections (Comments, Users, Sessions, Theaters)
-- Integration tests with Testcontainers
-- Advanced queries (aggregations, geospatial, vector search)
 
 ## Technology Stack
 
diff --git a/server/java-spring/TODO.md b/server/java-spring/TODO.md
deleted file mode 100644
index 8be6099..0000000
--- a/server/java-spring/TODO.md
+++ /dev/null
@@ -1,372 +0,0 @@
-# TODO List - Java Spring Boot MongoDB Sample Application
-
-This document tracks remaining functionality and improvements for the Java Spring Boot backend based on the **Requirements for Sample Repositories for MongoDB Atlas** and **Sample Application Scoping** documents.
-
-## 📋 Scope Alignment
-
-This sample application must demonstrate:
-- ✅ **Basic CRUD** - insertOne(), insertMany(), findOne(), find(), updateOne(), updateMany(), deleteOne(), deleteMany(), findOneAndDelete()
-- 🚧 **Aggregations** - Reporting by comments, year, and director
-- 🚧 **Search** - Full-text search using Search Index on plot
-- 🚧 **Vector Search** - Find similar movies based on plot embeddings
-- 🚧 **Geospatial** - Find theaters near coordinates
-- 🚧 **Recommendations** - Potentially using Vector Search
-
-## ✅ Completed Features (In Scope)
-
-- [x] **Basic CRUD operations for Movies collection**
-  - [x] insertOne() - `POST /api/movies`
-  - [x] insertMany() - `POST /api/movies/batch`
-  - [x] findOne() - `GET /api/movies/{id}`
-  - [x] find() - `GET /api/movies`
-  - [x] updateOne() - `PUT /api/movies/{id}`
-  - [x] updateMany() - `PATCH /api/movies`
-  - [x] deleteOne() - `DELETE /api/movies/{id}`
-  - [x] deleteMany() - `DELETE /api/movies`
-  - [x] findOneAndDelete() - `DELETE /api/movies/{id}/find-and-delete`
-- [x] Spring Data MongoDB migration
-- [x] Filtering, sorting, and pagination
-- [x] Custom exception handling
-- [x] Type-safe response DTOs
-- [x] Unit tests for service and controller layers (35 tests)
-- [x] OpenAPI/Swagger documentation
-- [x] Database verification on startup (checks indexes and data)
-- [x] CORS configuration
-- [x] Field name constants for type safety
-- [x] Environment variable configuration (.env support)
-
-## 🚧 High Priority TODOs (Required by Scope)
-
-### 1. Aggregations (REQUIRED)
-
-**Scope Requirement**: Implement aggregation pipelines for reporting
-
-- [ ] **GET /api/movies/reportingByComments** - Aggregate movies with most comments
-  - [ ] Create aggregation pipeline using `$lookup` to join with comments collection
-  - [ ] Sort by comment count descending
-  - [ ] Add pagination support
-  - [ ] Add unit tests
-
-- [ ] **GET /api/movies/reportingByYear** - Aggregate movies by year with average rating
-  - [ ] Create aggregation pipeline grouping by year
-  - [ ] Calculate average IMDB rating per year
-  - [ ] Sort by year
-  - [ ] Add unit tests
-
-- [ ] **GET /api/movies/reportingByDirector** - Aggregate directors with most movies
-  - [ ] Create aggregation pipeline using `$unwind` on directors array
-  - [ ] Group by director and count movies
-  - [ ] Sort by movie count descending
-  - [ ] Add pagination support
-  - [ ] Add unit tests
-
-### 2. Search (REQUIRED)
-
-**Scope Requirement**: Implement Full-Text Search and Vector Search
-
-- [ ] **GET /api/movies/searchByPlot** - Text Search using Search Index
-  - [ ] Verify text index exists on plot, fullplot, genres, title fields
-  - [ ] Implement text search using Spring Data MongoDB TextCriteria
-  - [ ] Add relevance scoring
-  - [ ] Add pagination support
-  - [ ] Add unit tests
-  - [ ] Document index requirements in README
-
-- [ ] **GET /api/movies/findSimilarMovies** - Vector Search for similar movies
-  - [ ] Implement vector search on `plot_embedding` field
-  - [ ] Use MongoDB Atlas Vector Search
-  - [ ] Add similarity threshold parameter
-  - [ ] Add limit parameter
-  - [ ] Add unit tests
-  - [ ] Document vector search index requirements
-
-### 3. Geospatial (REQUIRED)
-
-**Scope Requirement**: Find theaters near coordinates
-
-- [ ] **GET /api/theaters/findTheatersNearCoordinates** - Geospatial query
-  - [ ] Create `Theater` entity (already exists, needs repository)
-  - [ ] Create `TheaterRepository` with geospatial query methods
-  - [ ] Create `TheaterService` and `TheaterServiceImpl`
-  - [ ] Create `TheaterController` with endpoint
-  - [ ] Implement `$near` or `$geoNear` query
-  - [ ] Add distance parameter (in meters/miles)
-  - [ ] Add limit parameter
-  - [ ] Verify geospatial index exists on `location.geo`
-  - [ ] Add unit tests
-  - [ ] Add integration tests
-
-### 4. Recommendations (OPTIONAL - FUTURE)
-
-**Scope Requirement**: Potentially use Vector Search to power recommendations
-
-- [ ] Design recommendation algorithm
-- [ ] Implement using Vector Search on plot embeddings
-- [ ] Consider user preferences/history
-- [ ] Add endpoint `GET /api/movies/recommendations`
-- [ ] Add tests
-
-### 5. Comments Collection Support (For Aggregations)
-
-**Note**: Required to support "reportingByComments" aggregation
-
-- [ ] Verify `Comment` entity model (already exists)
-- [ ] Create `CommentRepository` interface
-- [ ] Create `CommentService` and `CommentServiceImpl`
-- [ ] Create `CommentController` with basic endpoints:
-  - `GET /api/comments/movie/{movieId}` - Get comments for a specific movie
-  - `POST /api/comments` - Create a new comment
-- [ ] Add tests for Comment functionality
-
-### 6. Testing (REQUIRED)
-
-**Scope Requirement**: Unit tests and E2E tests
-
-- [ ] **Unit Tests** - Test individual features and driver interactions
-  - [x] Service layer unit tests (21 tests completed)
-  - [x] Controller layer unit tests (14 tests completed)
-  - [ ] Add tests for aggregation methods
-  - [ ] Add tests for search methods
-  - [ ] Add tests for geospatial queries
-  - [ ] Add tests for vector search
-
-- [ ] **Integration Tests** - Test complete flows
-  - [ ] Set up Testcontainers for MongoDB
-  - [ ] Create integration tests for all CRUD endpoints
-  - [ ] Create integration tests for aggregations
-  - [ ] Create integration tests for search
-  - [ ] Create integration tests for geospatial queries
-  - [ ] Test error handling and edge cases
-
-### 7. Error Handling & Verification (REQUIRED)
-
-**Scope Requirement**: Pre-flight checks and error handling
-
-- [x] Verify requirements function on app start (DatabaseVerification.java)
-  - [x] Check for indexes
-  - [x] Check for sample data
-  - [x] Create indexes if missing
-- [x] Basic error handling implemented
-  - [x] Connection errors
-  - [x] Invalid input validation
-  - [x] Custom exceptions (ValidationException, ResourceNotFoundException, DatabaseOperationException)
-  - [x] Global exception handler
-- [ ] Enhance error handling for new features:
-  - [ ] Vector search errors
-  - [ ] Geospatial query errors
-  - [ ] Aggregation pipeline errors
-
-### 8. Documentation (REQUIRED)
-
-**Scope Requirement**: Clear README and documentation
-
-- [x] README.md with prerequisites and setup
-- [x] Environment variable configuration (.env.example)
-- [x] OpenAPI/Swagger documentation
-- [ ] Update README with:
-  - [ ] Aggregation endpoint documentation
-  - [ ] Search endpoint documentation
-  - [ ] Vector search setup instructions
-  - [ ] Geospatial query examples
-  - [ ] Index requirements
-- [ ] Add code comments for MongoDB features
-  - [ ] Comment aggregation pipelines
-  - [ ] Comment vector search implementation
-  - [ ] Comment geospatial queries
-  - [ ] Note where readability was prioritized over performance
-
-## 📝 Medium Priority TODOs (Out of Scope - Future Enhancements)
-
-### 9. Additional Collections (Optional)
-
-**Note**: These collections are not required by the current scope but may be useful for future enhancements.
-
-#### Users Collection (`sample_mflix.users`)
-- [ ] Create `UserRepository` interface (model already exists)
-- [ ] Create `UserService` and `UserServiceImpl`
-- [ ] Implement password hashing (BCrypt)
-- [ ] Add email validation
-- [ ] Add tests for User functionality
-
-#### Sessions Collection (`sample_mflix.sessions`)
-- [ ] Create `SessionRepository` interface (model already exists)
-- [ ] Create `SessionService` and `SessionServiceImpl`
-- [ ] Implement JWT token generation and validation
-- [ ] Add tests for Session functionality
-
-#### Embedded Movies Collection (`sample_mflix.embedded_movies`)
-- [ ] Investigate purpose and schema of this collection
-- [ ] Determine if separate endpoints are needed
-- [ ] Document relationship to main `movies` collection
-
-### 10. Authentication & Authorization (Out of Scope)
-
-**Note**: Not required by current scope, but useful for production applications
-
-- [ ] Implement Spring Security
-- [ ] Add JWT authentication filter
-- [ ] Create `@PreAuthorize` annotations for role-based access
-- [ ] Implement user roles (USER, ADMIN)
-- [ ] Add authentication to existing endpoints
-- [ ] Create authentication integration tests
-
-### 11. API Improvements (Out of Scope)
-
-- [ ] Add HATEOAS links to responses
-- [ ] Implement API versioning (e.g., `/api/v1/movies`)
-- [ ] Add request/response compression
-- [ ] Implement rate limiting
-- [ ] Add API key authentication option
-- [ ] Create GraphQL endpoint as alternative to REST
-
-### 12. Data Validation & Quality (Partially Complete)
-
-- [x] Basic Jakarta Validation annotations
-- [ ] Create custom validators for complex business rules
-- [ ] Implement data sanitization for user inputs
-- [ ] Add validation for embedded documents
-- [ ] Create validation tests
-
-### 13. Performance Optimization (Out of Scope)
-
-**Note**: Scope prioritizes readability over performance
-
-- [ ] Implement caching with Spring Cache (Redis/Caffeine)
-- [ ] Add database query optimization
-- [ ] Implement connection pooling tuning
-- [ ] Create performance benchmarks
-- [ ] Implement lazy loading for large collections
-- [ ] Document performance vs readability tradeoffs
-
-### 14. Monitoring & Observability (Out of Scope)
-
-- [ ] Add Spring Boot Actuator endpoints
-- [ ] Implement custom health checks
-- [ ] Add metrics collection (Micrometer)
-- [ ] Integrate with Prometheus/Grafana
-- [ ] Add distributed tracing (Sleuth/Zipkin)
-- [ ] Implement structured logging (JSON format)
-
-### 15. Code Quality (Partially Complete)
-
-- [x] Unit tests for core functionality (35 tests)
-- [ ] Increase test coverage to >80%
-- [ ] Add code coverage reporting (JaCoCo)
-- [ ] Add mutation testing (PIT)
-- [ ] Integrate SonarQube for code quality analysis
-- [ ] Add Checkstyle/PMD for code style enforcement
-
-### 16. Build & Deployment (Out of Scope)
-
-**Note**: Deployment is handled by Growth team per scope document
-
-- [ ] Create Dockerfile for containerization
-- [ ] Add Docker Compose for local development
-- [ ] Create Kubernetes deployment manifests
-- [ ] Set up CI/CD pipeline (GitHub Actions)
-- [x] Automated dependency updates (Dependabot) - handled by DevDocs team
-
-### 17. Security Enhancements (Out of Scope)
-
-**Note**: Basic security implemented, advanced features out of scope
-
-- [x] CORS configuration
-- [x] Input validation
-- [ ] Implement HTTPS/TLS
-- [ ] Add CSRF protection
-- [ ] Implement security headers (HSTS, CSP, etc.)
-- [ ] Add security scanning (OWASP Dependency Check)
-
-### 18. Developer Experience (Partially Complete)
-
-- [x] Environment variable configuration
-- [x] Database verification on startup
-- [x] OpenAPI/Swagger documentation
-- [ ] Add Spring Boot DevTools for hot reload
-- [ ] Create seed data script for development
-- [ ] Add API client examples (Postman collection)
-
-## 🐛 Known Issues
-
-- [ ] Update deprecated `@MockBean` to new Spring Boot 3.5+ alternative (warning in tests)
-
-## 📚 Technical Debt
-
-- None currently - code follows best practices and scope requirements
-
-## 🎯 Next Immediate Steps (Priority Order)
-
-Based on the **Sample Application Scoping** document, the next steps are:
-
-### Phase 1: Complete Required Features (In Scope)
-1. **Aggregations** (REQUIRED)
-   - Implement `GET /api/movies/reportingByComments`
-   - Implement `GET /api/movies/reportingByYear`
-   - Implement `GET /api/movies/reportingByDirector`
-
-2. **Search** (REQUIRED)
-   - Implement `GET /api/movies/searchByPlot` (Full-Text Search)
-   - Implement `GET /api/movies/findSimilarMovies` (Vector Search)
-
-3. **Geospatial** (REQUIRED)
-   - Implement `GET /api/theaters/findTheatersNearCoordinates`
-   - Create Theater repository and service
-
-4. **Comments Collection** (REQUIRED for aggregations)
-   - Create CommentRepository and CommentService
-   - Implement basic endpoints to support aggregations
-
-5. **Testing** (REQUIRED)
-   - Add unit tests for all new features
-   - Create integration tests with Testcontainers
-
-6. **Documentation** (REQUIRED)
-   - Update README with new endpoints
-   - Document index requirements
-   - Add code comments explaining MongoDB features
-   - Note readability vs performance tradeoffs
-
-### Phase 2: Quality Assurance (In Scope)
-7. **Error Handling** - Enhance for new features
-8. **Code Comments** - Add more comments than typical production app
-9. **Readability Review** - Ensure code prioritizes clarity over performance
-
-### Phase 3: Future Enhancements (Out of Scope)
-10. Recommendations using Vector Search
-11. Authentication & Authorization
-12. Additional collections (Users, Sessions)
-13. Performance optimizations
-14. Advanced features
-
-## 📋 Scope Compliance Checklist
-
-### Required Features
-- [x] **Basic CRUD** - All methods implemented ✅
-  - [x] insertOne(), insertMany()
-  - [x] findOne(), find()
-  - [x] updateOne(), updateMany()
-  - [x] deleteOne(), deleteMany(), findOneAndDelete()
-- [ ] **Aggregations** - Not yet implemented ⏳
-  - [ ] Reporting by comments
-  - [ ] Reporting by year
-  - [ ] Reporting by director
-- [ ] **Search** - Not yet implemented ⏳
-  - [ ] Full-text search on plot
-- [ ] **Vector Search** - Not yet implemented ⏳
-  - [ ] Find similar movies
-- [ ] **Geospatial** - Not yet implemented ⏳
-  - [ ] Find theaters near coordinates
-
-### Quality Standards
-- [x] **Error Handling** - Basic implementation complete ✅
-- [x] **Testing** - Unit tests complete (35 tests) ✅
-- [ ] **Integration Tests** - Pending ⏳
-- [x] **Documentation** - README complete ✅
-- [ ] **Documentation Updates** - Needs updates for new features ⏳
-- [x] **Readability** - Code follows best practices ✅
-- [x] **Code Comments** - Good coverage, needs more for complex features ⏳
-- [x] **Minimal Dependencies** - Using only Spring Boot and MongoDB ✅
-- [x] **Environment Variables** - Implemented with .env.example ✅
-- [x] **Apache License** - Applied ✅
-- [x] **Conventional Commits** - Following standard ✅
-- [x] **Clean Commit History** - Maintained ✅

From b10f743568bcd8eec7205398a049b95fee636656 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Thu, 30 Oct 2025 13:38:06 -0400
Subject: [PATCH 030/110] fix(movies): add back missing @Document tag

---
 .../src/main/java/com/mongodb/samplemflix/model/Movie.java      | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
index 4345b0e..eb2fb83 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
@@ -7,6 +7,7 @@
 import lombok.Data;
 import lombok.NoArgsConstructor;
 import org.bson.types.ObjectId;
+import org.springframework.data.mongodb.core.mapping.Document;
 
 /**
  * Domain model representing a movie document from the MongoDB movies collection.
@@ -25,6 +26,7 @@
 @Builder
 @NoArgsConstructor
 @AllArgsConstructor
+@Document(collection = "movies")
 public class Movie {
 
     /**

From 5d1b7d90bc30b3743ed94d12b8ed56fd6886c2ad Mon Sep 17 00:00:00 2001
From: tmcneil-mdb <taylor.mcneil@mongodb.com>
Date: Thu, 30 Oct 2025 15:49:03 -0400
Subject: [PATCH 031/110] Feat finishing python crud - merging python backends
 together (#10)

* feat(api): implement batch create, update, and delete endpoints for movies

* feat(api): implement /search/atlas endpoint using MongoDB Atlas Search

* feat(api): implement batch create, update, and delete endpoints for movies

* feat(api): implement /search/atlas endpoint using MongoDB Atlas Search

* merge changes

* chore - removing gremlins, adding documentation.

* chore- address feedback, fixing dependency bug

* chore - cleaning up api endpoints
---
 server/python/main.py               |   58 +-
 server/python/requirements.in       |    4 +-
 server/python/requirements.txt      |    4 +-
 server/python/src/models/models.py  |   54 +-
 server/python/src/routers/movies.py | 1161 ++++++++++++++++++---------
 5 files changed, 867 insertions(+), 414 deletions(-)

diff --git a/server/python/main.py b/server/python/main.py
index a1a67e9..a782508 100644
--- a/server/python/main.py
+++ b/server/python/main.py
@@ -1,34 +1,50 @@
 from fastapi import FastAPI
 from src.routers import movies
 from src.utils.errorHandler import register_error_handlers
+from src.database.mongo_client import db
+import traceback
 
 app = FastAPI()
 register_error_handlers(app)
 app.include_router(movies.router, prefix="/api/movies", tags=["movies"])
 
 
+@app.on_event("startup")
+async def ensure_search_index():
+    try:
+        movies_collection = db.get_collection("movies")
+        result = await movies_collection.list_search_indexes()
+        indexes = [idx async for idx in result]
+        index_names = [index["name"] for index in indexes]
+        if "movieSearchIndex" in index_names:
+            print("MongoDB Search index already exists.")
+            return
+
+        # Create a mapping if the movieSearchIndex does not exist
+        index_definition = {
+            "mappings": {
+                "dynamic": False,
+                "fields": {
+                    "plot": {"type": "string", "analyzer": "lucene.standard"},
+                    "fullplot": {"type": "string", "analyzer": "lucene.standard"},
+                    "directors": {"type": "string", "analyzer": "lucene.standard"},
+                    "writers": {"type": "string", "analyzer": "lucene.standard"},
+                    "cast": {"type": "string", "analyzer": "lucene.standard"}
+                }
+            }
+        }
+        # Creates movieSearchIndex on the movies collection
+        await db.command({
+            "createSearchIndexes": "movies",
+            "indexes": [{
+                "name": "movieSearchIndex",
+                "definition": index_definition
+            }]
+        })
+        print("MongoDB Search index created.")
+    except Exception as e:
+        print(f"Error creating the search index: {e}")
 
 
 
 
-
-
-#------------------------------------
-# Testing error endpoints. Will be removed later
-#------------------------------------
-
-'''
-@app.get("/")
-async def root():
-    return {"message": "Backend is running!"}
-
-@app.get("/test-duplicate")
-async def test_duplicate():
-    from pymongo.errors import DuplicateKeyError
-    raise DuplicateKeyError("This is a test duplicate key error.")
-
-@app.get("/test-generic")
-async def test_generic():
-    from pymongo.errors import PyMongoError
-    raise PyMongoError("This is a test generic pymongo error.")
-'''
\ No newline at end of file
diff --git a/server/python/requirements.in b/server/python/requirements.in
index e8ee7b7..835786d 100644
--- a/server/python/requirements.in
+++ b/server/python/requirements.in
@@ -2,8 +2,8 @@
 # 1. CORE WEB FRAMEWORK & ASGI SERVER
 # FastAPI and its main components.
 # ------------------------------------------------------------------------------
-fastapi~=0.120.0        # The main web framework
-starlette~=0.48.0       # FastAPI's underlying ASGI toolkit
+fastapi~=0.120.1        # The main web framework
+starlette~=0.49.1       # FastAPI's underlying ASGI toolkit
 uvicorn~=0.38.0         # Production-ready ASGI server
 uvloop~=0.22.0          # Optional: High-performance event loop for uvicorn
 websockets~=15.0.0      # For WebSocket support
diff --git a/server/python/requirements.txt b/server/python/requirements.txt
index 3beb0d8..504c289 100644
--- a/server/python/requirements.txt
+++ b/server/python/requirements.txt
@@ -32,7 +32,7 @@ email-validator==2.3.0
     # via
     #   -r requirements.in
     #   pydantic
-fastapi==0.120.0
+fastapi==0.120.2
     # via -r requirements.in
 fastapi-cli==0.0.14
     # via -r requirements.in
@@ -114,7 +114,7 @@ shellingham==1.5.4
     # via typer
 sniffio==1.3.1
     # via anyio
-starlette==0.48.0
+starlette==0.49.1
     # via
     #   -r requirements.in
     #   fastapi
diff --git a/server/python/src/models/models.py b/server/python/src/models/models.py
index e027116..c044ce9 100644
--- a/server/python/src/models/models.py
+++ b/server/python/src/models/models.py
@@ -60,24 +60,12 @@ class RatingFilter(BaseModel):
     gte: Optional[float] = Field(None, alias="$gte")
     lte: Optional[float] = Field(None, alias="$lte")    
 
-class MovieFilter(BaseModel):
-    text: Optional[TextFilter] = Field(None, alias="$text")    
-    genres: Optional[RegexFilter] = None
-    year: Optional[int] = None
-    imdb_rating: Optional[RatingFilter] = Field(None, alias="imdb.rating")
-
-    model_config = {
-        "populate_by_name" : True
-    }
-
-
 class Pagination(BaseModel):
     page: int
     limit: int
     total: int
     pages: int
 
-
 class CreateMovieRequest(BaseModel):
     title: str
     year: Optional[int] = None
@@ -92,18 +80,37 @@ class CreateMovieRequest(BaseModel):
     rated: Optional[str]  = None
     runtime: Optional[int]  = None
     poster: Optional[str]  = None    
-    
-class Comment(BaseModel):
-    id: Optional[str] = Field(alias="_id")
-    name: str
-    email: str
-    movie_id: str
-    text: str
-    date: datetime
 
-    model_config = {
-        "populate_by_name": True
-    }
+class UpdateMovieRequest(BaseModel):
+    title: Optional[str] = None
+    year: Optional[int] = None
+    plot: Optional[str]  = None
+    fullplot: Optional[str] = None
+    genres: Optional[list[str]]  = None
+    directors: Optional[list[str]]  = None
+    writers: Optional[list[str]]  = None
+    cast: Optional[list[str]]  = None
+    countries: Optional[list[str]]  = None
+    languages: Optional[list[str]]  = None
+    rated: Optional[str]  = None
+    runtime: Optional[int]  = None
+    poster: Optional[str]  = None  
+
+class MovieFilter(BaseModel):
+    title: Optional[str] = None
+    year: Optional[int] = None
+    plot: Optional[str]  = None
+    fullplot: Optional[str] = None
+    genres: Optional[list[str]]  = None
+    directors: Optional[list[str]]  = None
+    writers: Optional[list[str]]  = None
+    cast: Optional[list[str]]  = None
+    countries: Optional[list[str]]  = None
+    languages: Optional[list[str]]  = None
+    rated: Optional[str]  = None
+    runtime: Optional[int]  = None
+    poster: Optional[str]  = None   
+
 class SuccessResponse(BaseModel, Generic[T]):
     success: bool = True
     message: Optional[str]
@@ -122,3 +129,4 @@ class ErrorResponse(BaseModel):
     message: str
     error: ErrorDetails
     timestamp: str
+    
\ No newline at end of file
diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 6e8d959..76579ee 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -1,11 +1,11 @@
-from fastapi import APIRouter, Query
-from src.database.mongo_client import get_collection
-from src.models.models import CreateMovieRequest, Movie, SuccessResponse
+from fastapi import APIRouter, Query, Path
+from src.database.mongo_client import db, get_collection
+from src.models.models import CreateMovieRequest, Movie, MovieFilter, SuccessResponse, UpdateMovieRequest
 from typing import List
 from datetime import datetime
 from src.utils.errorHandler import create_success_response, create_error_response
-import re
 from bson import ObjectId
+import re
 from bson.errors import InvalidId
 
 '''
@@ -13,391 +13,244 @@
 Each method demonstrates different MongoDB operations using the PyMongo driver.
 
 Implemented Endpoints:
-- GET /api/movies/ : Retrieve a list of movies with optional filter, sorting,
-    and pagination.
-- POST /api/movies/batch : Create multiple movies in a single request.
-
-
-'''
-router = APIRouter()
-#------------------------------------
-# Place get_movie_by_id endpoint here
-#------------------------------------
+- GET /api/movies/ :
+    Retrieve a list of movies with optional filtering, sorting, and pagination.
+    Supports text search, genre, year, rating filters, and customizable sorting.
 
-"""
-    GET /api/movies/{id}
+- GET /api/movies/{id} :
     Retrieve a single movie by its ID.
-    Path Parameters:
-        id (str): The ObjectId of the movie to retrieve.
-    Returns:
-        SuccessResponse[Movie]: A response object containing the movie data.
-"""
 
-@router.get("/{id}", response_model=SuccessResponse[Movie])
-async def get_movie_by_id(id: str):
-    # Validate ObjectId format
-    try:
-        object_id = ObjectId(id)
-    except InvalidId:
-        return create_error_response(
-            message="Invalid movie ID format",
-            code="INTERNAL_SERVER_ERROR",
-            details=f"The provided ID '{id}' is not a valid ObjectId"
-        )
+- POST /api/movies/ :
+    Create a new movie.
 
-    movies_collection = get_collection("movies")
-    try:
-        movie = await movies_collection.find_one({"_id": object_id})
-    except Exception as e:
-        return create_error_response(
-            message="Database error occurred",
-            code="INTERNAL_SERVER_ERROR",
-            details=str(e)
-        )
+- POST /api/movies/batch :
+    Create multiple movies in a single request.
 
-    if movie is None:
-        return create_error_response(
-            message="Movie not found",
-            code="INTERNAL_SERVER_ERROR",
-            details=f"No movie found with ID: {id}"
-        )
+- PATCH /api/movies/{movie_id} :
+    Update a single movie by its ID.
 
-    movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
-    
-    return create_success_response(movie, "Movie retrieved successfully")
+- PATCH /api/movies/ :
+    Batch update movies matching the given filter.
 
-"""
-    GET /api/movies/
+- DELETE /api/movies/{id} :
+    Delete a single movie by its ID.
 
-    Retrieve a list of movies with optional filtering, sorting, and pagination.
+- DELETE /api/movies/ :
+    Delete multiple movies matching the given filter.
 
-    Query Parameters:
-        q (str, optional): Text search query (searches title, plot, fullplot).
-        genre (str, optional): Filter by genre.
-        year (int, optional): Filter by year.
-        min_rating (float, optional): Minimum IMDB rating.
-        max_rating (float, optional): Maximum IMDB rating.
-        limitNum (int, optional): Number of results to return (default: 20, max: 100).
-        skipNum (int, optional): Number of documents to skip for pagination (default: 0).
-        sortBy (str, optional): Field to sort by (default: "title").
-        sort_order (str, optional): Sort direction, "asc" or "desc" (default: "asc").
+- DELETE /api/movies/{id}/find-and-delete :
+    Find and delete a movie in a single atomic operation.
 
-    Returns:
-        SuccessResponse[List[Movie]]: A response object containing the list of movies and metadata.
-"""
+- GET /api/movies/aggregations/reportingByComments :
+    Aggregate movies with their most recent comments using MongoDB $lookup aggregation.
 
-@router.get("/", response_model=SuccessResponse[List[Movie]])
-# Validate the query parameters using FastAPI's Query functionality.
-async def get_all_movies(
-    q:str = Query(default=None),
-    title: str = Query(default=None),
-    genre:str = Query(default=None),
-    year:int = Query(default=None),
-    min_rating:float = Query(default=None),
-    max_rating:float = Query(default=None),
-    limit:int = Query(default=20, ge=1, le=100),
-    skip:int = Query(default=0, ge=0),
-    sort_by:str = Query(default="title"),
-    sort_order:str = Query(default="asc")
-):
-    movies_collection = get_collection("movies")
-    filter_dict = {}
-    if q:
-        filter_dict["$text"] = {"$search": q} 
-    if title:
-        filter_dict["title"] = {"$regex": title, "$options": "i"}       
-    if genre:
-        filter_dict["genres"] = {"$regex": genre, "$options": "i"}
-    if year:
-        filter_dict["year"] = year
-    if min_rating is not None or max_rating is not None:
-        rating_filter = {}
-        if min_rating is not None:
-            rating_filter["$gte"] = min_rating
-        if max_rating is not None:
-            rating_filter["$lte"] = max_rating
-        filter_dict["imdb.rating"] = rating_filter
-        
-    # Building the sort object based on user input
-    sort_order = -1 if sort_order == "desc" else 1
-    sort = [(sort_by, sort_order)]
+- GET /api/movies/aggregations/reportingByYear :
+    Aggregate movies by year with average rating and movie count.
 
-    # Query the database with the constructed filter, sort, skip, and limit.
-    try:
-        cursor = movies_collection.find(filter_dict).sort(sort).skip(skip).limit(limit)    
-        movies = []
-        async for movie in cursor:
-            if movie is None:
-                continue  # Skip null movies instead of raising exception
-            movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
-
-            # Ensure that the year field contains int value.
-            if "year" in movie and not isinstance(movie["year"], int):
-                cleaned_year = re.sub(r"\D", "", str(movie["year"]))
-                try:
-                    movie["year"] = int(cleaned_year) if cleaned_year else None
-                except ValueError:
-                    movie["year"] = None
-            movies.append(movie)
-    except Exception as e:
-        return create_error_response(
-            message="Database error occurred",
-            code="INTERNAL_SERVER_ERROR",
-            details=str(e)
-        )
+- GET /api/movies/aggregations/reportingByDirectors :
+    Aggregate directors with the most movies and their statistics.
 
-    # Return the results wrapped in a SuccessResponse    
-    return create_success_response(movies, f"Found {len(movies)} movies.")
+- GET /api/movies/search :
+    Search movies using MongoDB Search across the plot, fullplot, directors, writers, and cast fields.
+    Supports compound search operators and fuzzy matching.
 
-#------------------------------------
-# Place create_movie endpoint here
-#------------------------------------
+Helper Functions:
+- execute_aggregation(pipeline): Executes a MongoDB aggregation pipeline and returns the results.
+'''
+
+router = APIRouter()
 
+#----------------------------------------------------------------------------------------------------------
+# MongoDB Search
+#
+# MongoDB Search based on searching the plot, fullplot, directors, writers, and cast fields.
+# This function was made with the assumption that the UI will have fields for plot,fullplot, 
+# directors, writers, and cast to search on. Or some sort of combined search field.
+# Also this fuzzy operator is being used to allow for some misspellings in the search terms
+# but that allows for very generous matching. This can be adjusted as needed.
+#----------------------------------------------------------------------------------------------------------
 """
-    POST /api/movies/
-    Create a new movie.
-    Request Body:
-        movie (CreateMovieRequest): A movie object containing the movie data.
-            See CreateMovieRequest model for available fields.
+
+    GET /api/movies/search
+
+    Search movies using MongoDB Search across the plot, fullplot, directors, writers, and cast fields.
+    You can combine multiple fields in a single query, and control how they are combined using the `search_operator` parameter.
+
+    Query Parameters:
+        plot (str, optional): Text to search against the plot field.
+        fullplot (str, optional): Text to search against the fullplot field.
+        directors (str, optional): Text to search against the directors field.
+        writers (str, optional): Text to search against the writers field.
+        cast (str, optional): Text to search against the cast field.
+        limit (int, optional): Number of results to return (default: 20)
+        skip (int, optional): Number of results to skip for pagination (default: 0)
+        search_operator (str, optional): How to combine multiple search fields. 
+            Must be one of "must", "should", "mustNot", or "filter". Default is "must".
+
     Returns:
-        SuccessResponse[Movie]: A response object containing the created movie data.
+        SuccessResponse[List[Movie]]: A response object containing the list of matching movies.
 """
-
-@router.post("/", response_model=SuccessResponse[Movie], status_code=201)
-async def create_movie(movie: CreateMovieRequest):
-    # Pydantic automatically validates the structure
-    movie_data = movie.model_dump(by_alias=True, exclude_none=True)
-    
-    movies_collection = get_collection("movies")
-    try:
-        result = await movies_collection.insert_one(movie_data)
-    except Exception as e:
-        return create_error_response(
-            message="Database error occurred",
-            code="INTERNAL_SERVER_ERROR",
-            details=str(e)
-        )
-    
-    # Verify that the document was created before querying it
-    if not result.acknowledged:
-        return create_error_response(
-            message="Failed to create movie",
-            code="INTERNAL_SERVER_ERROR",
-            details="The database did not acknowledge the insert operation"
-        )
-    
-    try:
-        # Retrieve the created document to return complete data
-        created_movie = await movies_collection.find_one({"_id": result.inserted_id})
-    except Exception as e:
-        return create_error_response(
-            message="Database error occurred",
-            code="INTERNAL_SERVER_ERROR",
-            details=str(e)
-        )
+@router.get(
+    "/search",
+    response_model=SuccessResponse[List[Movie]],
+    status_code=200,
+    summary="Search movies using MongoDB Search."
+)
+async def search_movies(
+    plot: str = Query(default=None),
+    fullplot: str = Query(default=None),
+    directors: str = Query(default=None),
+    writers: str = Query(default=None),
+    cast: str = Query(default=None),
+    limit:int = Query(default=20, ge=1, le=100),
+    skip:int = Query(default=0, ge=0),
+    search_operator: str = Query(default="must")
+) -> SuccessResponse[List[Movie]]:
     
-    if created_movie is None:
+    search_phrases = []
+
+    # Validate the search_operator parameter to ensure it's a valid compound operator
+    valid_operators = {"must", "should", "mustNot", "filter"}
+    if search_operator not in valid_operators:
         return create_error_response(
-            message="Movie creation verification failed",
-            code="INTERNAL_SERVER_ERROR",
-            details="Movie was created but could not be retrieved for verification"
-        )
+        message=f"Invalid search_operator '{search_operator}'. The search_operator must be one of {valid_operators}.",
+        code="INVALID_SEARCH_OPERATOR",
+        details=None
+    )
 
-    created_movie["_id"] = str(created_movie["_id"]) # Convert ObjectId to string
-    
-    return create_success_response(created_movie, f"Movie '{movie_data['title']}' created successfully")
+    # Build the search_phrases list based on which fields were provided by the user.
+    # Each phrase becomes a separate clause in the MongoDB Search compound query.
 
-#------------------------------------
-# Place create_movies_batch endpoint here
-#------------------------------------
+    if plot:
+        search_phrases.append({
+            # The phrase operator performs an exact phrase match on the specified field. This is useful for searching for specific phrases within text fields.
+            # The text operator is more flexible and allows for fuzzy matching, making it suitable for fields like names where typos may occur.
+            "phrase": {
+                "query": plot,
+                "path": "plot",
+            }
+        })
+    if fullplot:
+        search_phrases.append({
+            "phrase": {
+                "query": fullplot,
+                "path": "fullplot",
+            }
+        })
+    if directors:
+        # The "fuzzy" option enables typo-tolerant (fuzzy) search within MongoDB Search.
+        # - maxEdits: The maximum number of single-character edits (insertions, deletions, or substitutions)
+        #             allowed when matching the search term to indexed terms. (Range: 1-2; higher = more tolerant)
+        # - prefixLength: The number of initial characters that must exactly match before fuzzy matching is applied.
+        #             (Higher values make the search stricter and faster.)
+        # For more details, see: https://www.mongodb.com/docs/atlas/atlas-search/operators-collectors/text/
 
-'''
-POST /api/movies/batch
+        search_phrases.append({
+            "text": {
+                "query": directors,
+                "path": "directors",
+                "fuzzy":{"maxEdits":1, "prefixLength":5}
 
-Create multiple movies in a single request. 
+            }
+        })
+    if writers:
+        # See comments above regarding fuzzy search options.
+        search_phrases.append({
+            "text": {
+                "query": writers,
+                "path": "writers",
+                "fuzzy":{"maxEdits":1, "prefixLength":5}
+            }
+        })
+    if cast:
+        # See comments above regarding fuzzy search options.
+        search_phrases.append({
+            "text": {
+                "query": cast,
+                "path": "cast",
+                "fuzzy":{"maxEdits":1, "prefixLength":5}
+            }
+        })
 
-Request Body:
-        movies (List[CreateMovieRequest]): A list of movie objects to insert. Each object should include:
-            - title (str): The movie title.
-            - year (int, optional): The release year.
-            - plot (str, optional): Short plot summary.
-            - fullplot (str, optional): Full plot summary.
-            - genres (List[str], optional): List of genres.
-            - directors (List[str], optional): List of directors.
-            - writers (List[str], optional): List of writers.
-            - cast (List[str], optional): List of cast members.
-            - countries (List[str], optional): List of countries.
-            - languages (List[str], optional): List of languages.
-            - rated (str, optional): Movie rating.
-            - runtime (int, optional): Runtime in minutes.
-            - poster (str, optional): Poster URL.
+    if not search_phrases:
+        return create_error_response(
+            message="At least one search parameter must be provided.",
+            code="NO_SEARCH_PARAMETERS",
+            details=None
+        )
 
-    Returns:
-        SuccessResponse: A response object containing the number of inserted movies and their IDs.
+    # Build the aggregation pipeline for MongoDB Search.
+    # The $search stage uses the specified compound operator (must, should, etc.)
+    aggregation_pipeline = [
+        {
+            "$search": {
+                "index": "movieSearchIndex",
+                "compound": {
+                    search_operator: search_phrases
+                }
+            }
+        },
+        {"$skip": skip},
+        {"$limit": limit},
 
-'''
+        # Project only the fields needed in the response
+        {
+            "$project": {
+                "_id": 1,
+                "title": 1,
+                "year": 1,
+                "plot": 1,
+                "fullplot": 1,
+                "released":1,
+                "runtime": 1,
+                "poster": 1,
+                "genres": 1,
+                "directors": 1,
+                "writers": 1,
+                "cast": 1,
+                "countries": 1,
+                "languages": 1,
+                "rated": 1,
+                "awards": 1,
+                "imdb": 1,
+            }
+        }
+    ]
 
-@router.post("/batch")
-async def create_movies_batch(movies: List[CreateMovieRequest]):
-    movies_collection = get_collection("movies")
-    movies_dicts = []
-    for movie in movies:
-        movies_dicts.append(movie.model_dump(exclude_unset=True, exclude_none=True))
-    
+    # Execute the aggregation pipeline using the helper function
     try:
-        result = await movies_collection.insert_many(movies_dicts)
+        results = await execute_aggregation(aggregation_pipeline)
     except Exception as e:
         return create_error_response(
-            message="Database error occurred during batch creation",
-            code="INTERNAL_SERVER_ERROR",
+            message="An error occurred while performing the search.",
+            code="DATABASE_ERROR",
             details=str(e)
-        )
-    
-    return create_success_response({
-        "insertedCount": len(result.inserted_ids),
-        "insertedIds": [str(_id) for _id in result.inserted_ids]
-    },
-        f"Successfully created {len(result.inserted_ids)} movies."
-    )
-
-
-
-#------------------------------------
-# Place update_movie endpoint here
-#------------------------------------
-
-#------------------------------------
-# Place update_movies_by_batch endpoint here
-#------------------------------------
-
-#------------------------------------
-# Place delete_movie endpoint here
-#------------------------------------
+        )    
 
+    
+    # Convert ObjectId to string for each movie in the results
+    movies = []
+    for movie in results:
+        movie["_id"] = str(movie["_id"])
+        movies.append(movie)
 
+    return create_success_response(movies, f"Found {len(movies)} movies matching the search criteria.")
+    
 """
-    DELETE /api/movies/{id}
-    Delete a single movie by its ID.
-    Path Parameters:
-        id (str): The ObjectId of the movie to delete.
-    Returns:
-        SuccessResponse[dict]: A response object containing deletion details.
-"""
-
-@router.delete("/{id}", response_model=SuccessResponse[dict])
-async def delete_movie_by_id(id: str):
-    try:
-        object_id = ObjectId(id)
-    except InvalidId:
-        return create_error_response(
-            message="Invalid movie ID format",
-            code="INTERNAL_SERVER_ERROR",
-            details=f"The provided ID '{id}' is not a valid ObjectId"
-        )
-
-    movies_collection = get_collection("movies")
-    try:
-        # Use deleteOne() to remove a single document
-        result = await movies_collection.delete_one({"_id": object_id})
-    except Exception as e:
-        return create_error_response(
-            message="Database error occurred",
-            code="INTERNAL_SERVER_ERROR",
-            details=str(e)
-        )
-
-    if result.deleted_count == 0:
-        return create_error_response(
-            message="Movie not found",
-            code="INTERNAL_SERVER_ERROR", 
-            details=f"No movie found with ID: {id}"
-        )
-    
-    return create_success_response(
-        {"deletedCount": result.deleted_count}, 
-        "Movie deleted successfully"
-    )
-
-#------------------------------------
-# Place delete_movies_by_batch endpoint here
-#------------------------------------
-
-#------------------------------------
-# Place find_and_delete_movie endpoint here
-#------------------------------------
-
-"""
-    DELETE /api/movies/{id}/find-and-delete
-    Finds and deletes a movie in a single atomic operation.
-    Demonstrates the findOneAndDelete() operation.
-    Path Parameters:
-        id (str): The ObjectId of the movie to find and delete.
-    Returns:
-        SuccessResponse[Movie]: A response object containing the deleted movie data.
-"""
-
-@router.delete("/{id}/find-and-delete", response_model=SuccessResponse[Movie])
-async def find_and_delete_movie(id: str):
-    try:
-        object_id = ObjectId(id)
-    except InvalidId:
-        return create_error_response(
-            message="Invalid movie ID format",
-            code="INTERNAL_SERVER_ERROR",
-            details=f"The provided ID '{id}' is not a valid ObjectId"
-        )
-
-    movies_collection = get_collection("movies")
-    # Use find_one_and_delete() to find and delete in a single atomic operation
-    # This is useful when you need to return the deleted document
-    # or ensure the document exists before deletion
-    try:
-        deleted_movie = await movies_collection.find_one_and_delete({"_id": object_id})
-    except Exception as e:
-        return create_error_response(
-            message="Database error occurred",
-            code="INTERNAL_SERVER_ERROR",
-            details=str(e)
-        )
-
-    if deleted_movie is None:
-        return create_error_response(
-            message="Movie not found",
-            code="INTERNAL_SERVER_ERROR", 
-            details=f"No movie found with ID: {id}"
-        )
-    deleted_movie["_id"] = str(deleted_movie["_id"]) # Convert ObjectId to string
-    
-    return create_success_response(deleted_movie, "Movie found and deleted successfully")
-
-async def execute_aggregation(pipeline: list) -> list:
-    """Helper function to execute aggregation pipeline and return results"""
-    print(f"Executing pipeline: {pipeline}")  # Debug logging
-    
-    movies_collection = get_collection("movies")
-    # For the async Pymongo driver, we need to await the aggregate call
-    cursor = await movies_collection.aggregate(pipeline)
-    results = await cursor.to_list(length=None)  # Convert cursor to list to collect all data at once rather than processing data per document
-    
-    print(f"Aggregation returned {len(results)} results")  # Debug logging
-    if len(results) <= 3:  # Log first few results for debugging
-        for i, doc in enumerate(results):
-            print(f"Result {i+1}: {doc}")
-    
-    return results
-
-"""
-    GET /api/movies/reportingByComments
-    Aggregate movies with their most recent comments using MongoDB $lookup aggregation.
-    Joins movies with comments collection to show recent comment activity.
-    Query Parameters:
-        limit (int, optional): Number of results to return (default: 10, max: 50).
-        movie_id (str, optional): Filter by specific movie ObjectId.
+    GET /api/movies/aggregations/reportingByComments
+    Aggregate movies with their most recent comments using MongoDB $lookup aggregation.
+    Joins movies with comments collection to show recent comment activity.
+    Query Parameters:
+        limit (int, optional): Number of results to return (default: 10, max: 50).
+        movie_id (str, optional): Filter by specific movie ObjectId.
     Returns:
         SuccessResponse[List[dict]]: A response object containing movies with their most recent comments.
 """
 
-@router.get("/api/movies/reportingByComments", response_model=SuccessResponse[List[dict]])
+@router.get("/aggregations/reportingByComments",
+            response_model=SuccessResponse[List[dict]],
+            status_code=200,
+            summary="Aggregate movies with their most recent comments.")
 async def aggregate_movies_recent_commented(
     limit: int = Query(default=10, ge=1, le=50),
     movie_id: str = Query(default=None)
@@ -539,14 +392,17 @@ async def aggregate_movies_recent_commented(
 
 
 """
-    GET /api/movies/reportingByYear
+    GET /api/movies/aggregations/reportingByYear
     Aggregate movies by year with average rating and movie count.
     Reports yearly statistics including average rating and total movies per year.
     Returns:
         SuccessResponse[List[dict]]: A response object containing yearly movie statistics.
 """
 
-@router.get("/api/movies/reportingByYear", response_model=SuccessResponse[List[dict]])
+@router.get("/aggregations/reportingByYear",
+            response_model=SuccessResponse[List[dict]],
+            status_code=200,
+            summary="Aggregate movies by year with average rating and movie count.")
 async def aggregate_movies_by_year():
     # Define aggregation pipeline to group movies by year with statistics
     # This pipeline demonstrates grouping, statistical calculations, and data cleaning
@@ -660,7 +516,7 @@ async def aggregate_movies_by_year():
 
 
 """
-    GET /api/movies/reportingByDirectors
+    GET /api/movies/aggregations/reportingByDirectors
     Aggregate directors with the most movies and their statistics.
     Reports directors sorted by number of movies directed.
     Query Parameters:
@@ -669,7 +525,10 @@ async def aggregate_movies_by_year():
         SuccessResponse[List[dict]]: A response object containing director statistics.
 """
 
-@router.get("/api/movies/reportingByDirectors", response_model=SuccessResponse[List[dict]])
+@router.get("/aggregations/reportingByDirectors",
+            response_model=SuccessResponse[List[dict]],
+            status_code=200,
+            summary="Aggregate directors with the most movies and their statistics.")
 async def aggregate_directors_most_movies(
     limit: int = Query(default=20, ge=1, le=100)
 ):
@@ -755,20 +614,590 @@ async def aggregate_directors_most_movies(
         f"Found {len(results)} directors with most movies"
     )
 
-# ---- Old testing endpoint, will be removed later ----
-'''
-# Testing the ErrorReponse Model
-@router.get("/error")
-async def test_error():
+
+
+#------------------------------------
+# Place get_movie_by_id endpoint here
+#------------------------------------
+
+"""
+    GET /api/movies/{id}
+    Retrieve a single movie by its ID.
+    Path Parameters:
+        id (str): The ObjectId of the movie to retrieve.
+    Returns:
+        SuccessResponse[Movie]: A response object containing the movie data.
+"""
+
+@router.get("/{id}",
+            response_model=SuccessResponse[Movie],
+            status_code=200,
+            summary="Retrieve a single movie by its ID.")
+async def get_movie_by_id(id: str):
+    # Validate ObjectId format
     try:
-        raise ValueError("This is a test error.")
-    except ValueError as e:
+        object_id = ObjectId(id)
+    except InvalidId:
         return create_error_response(
-                message="A test error occurred.",
-                code="TEST_ERROR",
-                details=str(e)
-            )
-'''
+            message="Invalid movie ID format",
+            code="INTERNAL_SERVER_ERROR",
+            details=f"The provided ID '{id}' is not a valid ObjectId"
+        )
+
+    movies_collection = get_collection("movies")
+    try:
+        movie = await movies_collection.find_one({"_id": object_id})
+    except Exception as e:
+        return create_error_response(
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
+
+    if movie is None:
+        return create_error_response(
+            message="Movie not found",
+            code="INTERNAL_SERVER_ERROR",
+            details=f"No movie found with ID: {id}"
+        )
+
+    movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
+    
+    return create_success_response(movie, "Movie retrieved successfully")
+
+"""
+    GET /api/movies/
+
+    Retrieve a list of movies with optional filtering, sorting, and pagination.
+
+    Query Parameters:
+        q (str, optional): Text search query (searches title, plot, fullplot).
+        genre (str, optional): Filter by genre.
+        year (int, optional): Filter by year.
+        min_rating (float, optional): Minimum IMDB rating.
+        max_rating (float, optional): Maximum IMDB rating.
+        limitNum (int, optional): Number of results to return (default: 20, max: 100).
+        skipNum (int, optional): Number of documents to skip for pagination (default: 0).
+        sortBy (str, optional): Field to sort by (default: "title").
+        sort_order (str, optional): Sort direction, "asc" or "desc" (default: "asc").
+
+    Returns:
+        SuccessResponse[List[Movie]]: A response object containing the list of movies and metadata.
+"""
+
+@router.get("/",
+            response_model=SuccessResponse[List[Movie]],
+            status_code=200,
+            summary="Retrieve a list of movies with optional filtering, sorting, and pagination.")
+# Validate the query parameters using FastAPI's Query functionality.
+async def get_all_movies(
+    q:str = Query(default=None),
+    title: str = Query(default=None),
+    genre:str = Query(default=None),
+    year:int = Query(default=None),
+    min_rating:float = Query(default=None),
+    max_rating:float = Query(default=None),
+    limit:int = Query(default=20, ge=1, le=100),
+    skip:int = Query(default=0, ge=0),
+    sort_by:str = Query(default="title"),
+    sort_order:str = Query(default="asc")
+):
+    movies_collection = get_collection("movies")
+    filter_dict = {}
+    if q:
+        filter_dict["$text"] = {"$search": q} 
+    if title:
+        filter_dict["title"] = {"$regex": title, "$options": "i"}       
+    if genre:
+        filter_dict["genres"] = {"$regex": genre, "$options": "i"}
+    if year:
+        filter_dict["year"] = year
+    if min_rating is not None or max_rating is not None:
+        rating_filter = {}
+        if min_rating is not None:
+            rating_filter["$gte"] = min_rating
+        if max_rating is not None:
+            rating_filter["$lte"] = max_rating
+        filter_dict["imdb.rating"] = rating_filter
+        
+    # Building the sort object based on user input
+    sort_order = -1 if sort_order == "desc" else 1
+
+    sort = [(sort_by, sort_order)]
+
+    # Query the database with the constructed filter, sort, skip, and limit.
+
+    try:
+        result = movies_collection.find(filter_dict).sort(sort).skip(skip).limit(limit)  
+    except Exception as e:
+        return create_error_response(
+            message="An error occurred while fetching movies.",
+            code="DATABASE_ERROR",
+            details=str(e)
+        )   
+
+    movies = []
+
+    async for movie in result:
+        movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
+        # Ensure that the year field contains int value.
+        if "year" in movie and not isinstance(movie["year"], int):
+            cleaned_year = re.sub(r"\D", "", str(movie["year"]))
+            try:
+                movie["year"] = int(cleaned_year) if cleaned_year else None
+            except ValueError:
+                movie["year"] = None
+
+        movies.append(movie)            
+    # Return the results wrapped in a SuccessResponse    
+    return create_success_response(movies, f"Found {len(movies)} movies.")
+
+#------------------------------------
+# Place create_movie endpoint here
+#------------------------------------
+
+"""
+    POST /api/movies/
+    Create a new movie.
+    Request Body:
+        movie (CreateMovieRequest): A movie object containing the movie data.
+            See CreateMovieRequest model for available fields.
+    Returns:
+        SuccessResponse[Movie]: A response object containing the created movie data.
+"""
+
+@router.post("/", 
+            response_model=SuccessResponse[Movie],
+            status_code=201,
+            summary="Creates a new movie in the database.")
+async def create_movie(movie: CreateMovieRequest):
+    # Pydantic automatically validates the structure
+    movie_data = movie.model_dump(by_alias=True, exclude_none=True)
+    
+    movies_collection = get_collection("movies")
+    try:
+        result = await movies_collection.insert_one(movie_data)
+    except Exception as e:
+        return create_error_response(
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
+    
+    # Verify that the document was created before querying it
+    if not result.acknowledged:
+        return create_error_response(
+            message="Failed to create movie",
+            code="INTERNAL_SERVER_ERROR",
+            details="The database did not acknowledge the insert operation"
+        )
+    
+    try:
+        # Retrieve the created document to return complete data
+        created_movie = await movies_collection.find_one({"_id": result.inserted_id})
+    except Exception as e:
+        return create_error_response(
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
+    
+    if created_movie is None:
+        return create_error_response(
+            message="Movie creation verification failed",
+            code="INTERNAL_SERVER_ERROR",
+            details="Movie was created but could not be retrieved for verification"
+        )
+
+    created_movie["_id"] = str(created_movie["_id"]) # Convert ObjectId to string
+    
+    return create_success_response(created_movie, f"Movie '{movie_data['title']}' created successfully")
+
+#------------------------------------
+# Place create_movies_batch endpoint here
+#------------------------------------
+
+"""
+POST /api/movies/batch
+
+Create multiple movies in a single request. 
+
+Request Body:
+        movies (List[CreateMovieRequest]): A list of movie objects to insert. Each object should include:
+            - title (str): The movie title.
+            - year (int, optional): The release year.
+            - plot (str, optional): Short plot summary.
+            - fullplot (str, optional): Full plot summary.
+            - genres (List[str], optional): List of genres.
+            - directors (List[str], optional): List of directors.
+            - writers (List[str], optional): List of writers.
+            - cast (List[str], optional): List of cast members.
+            - countries (List[str], optional): List of countries.
+            - languages (List[str], optional): List of languages.
+            - rated (str, optional): Movie rating.
+            - runtime (int, optional): Runtime in minutes.
+            - poster (str, optional): Poster URL.
+
+    Returns:
+        SuccessResponse: A response object containing the number of inserted movies and their IDs.
+
+"""
+
+@router.post(
+        "/batch",
+        response_model=SuccessResponse[dict],
+        status_code = 201,
+        summary = "Create multiple movies in a single request."
+        )
+async def create_movies_batch(movies: List[CreateMovieRequest]) ->SuccessResponse[dict]:
+    movies_collection = get_collection("movies")
+
+    #Verify that the movies list is not empty
+    if not movies:
+        return create_error_response(
+            message="Request body must be a non-empty list of movies.",
+            code="INVALID_INPUT",
+            details=None
+        )
+    
+    movies_dicts = []
+
+    for movie in movies:
+        movies_dicts.append(movie.model_dump(exclude_unset=True, exclude_none=True))
+
+    try:
+        result = await movies_collection.insert_many(movies_dicts)
+    except Exception as e:
+        return create_error_response(
+            message="An error occurred while creating movies.",
+            code="DATABASE_ERROR",
+            details=str(e)
+        )    
+    
+    try:
+        result = await movies_collection.insert_many(movies_dicts)
+    except Exception as e:
+        return create_error_response(
+            message="Database error occurred during batch creation",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
+    
+    return create_success_response({
+        "insertedCount": len(result.inserted_ids),
+        "insertedIds": [str(_id) for _id in result.inserted_ids]
+        },
+        f"Successfully created {len(result.inserted_ids)} movies."
+    )
+
+#------------------------------------
+# Place update_movie endpoint here
+#------------------------------------
+
+"""    
+    PATCH /api/movies/{id}
+
+    Update a single movie by its ID.
+
+    Path Parameters:
+        id (str): The ObjectId of the movie to update
+
+    Request Body:
+        move_data (UpdateMovieRequest): Fields and values to update. Only provided fields will be updated.
+
+    Returns:
+        SuccessResponse: The updated movie document, the number of fields modified and a success message.
+"""
+@router.patch(
+        "/{id}",
+        response_model=SuccessResponse[Movie],
+        status_code=200,
+        summary="Update a single movie by its ID.")
+async def update_movie(
+    movie_data: UpdateMovieRequest,
+    movie_id: str = Path(..., alias="id")
+) -> SuccessResponse[Movie]:
+
+    movies_collection = get_collection("movies")
+    
+    # Validate the ObjectId
+    try:
+        movie_id = ObjectId(movie_id)
+    except Exception :
+        return create_error_response(
+            message="Invalid movie_id format.",
+            code="INVALID_OBJECT_ID",
+            details=str(movie_id)
+        )    
+    
+    update_dict = movie_data.model_dump(exclude_unset=True, exclude_none=True)
+
+    # Validate that the dict is not empty
+    if not update_dict:
+        return create_error_response(
+            message="No valid fields provided for update.",
+            code="NO_UPDATE_DATA",
+            details=None
+        )
+
+    try:
+        result = await movies_collection.update_one(
+            {"_id": movie_id},
+            {"$set":update_dict}
+        )
+    except Exception as e:
+        return create_error_response(
+            message="An error occurred while updating the movie.",
+            code="DATABASE_ERROR",
+            details=str(e)
+        )    
+
+    if result.matched_count == 0:
+        return create_error_response(
+            message="No movie with that _id was found.",
+            code="MOVIE_NOT_FOUND",
+            details=str(movie_id)
+        )
+    
+    updatedMovie = await movies_collection.find_one({"_id": movie_id})
+    print(updatedMovie)
+    updatedMovie["_id"] = str(updatedMovie["_id"])
+
+    return create_success_response(updatedMovie, f"Movie updated successfully. Modified {len(update_dict)} fields.")
+
+#------------------------------------
+# Place update_movies_by_batch endpoint here
+#------------------------------------
+
+"""
+    PATCH /api/movies
+
+    Batch update movies matching the given filter
+
+    Request Body:
+        filter (MoviesUpdateFilter): Criteria to select which movies to update. Only movies matching this filter will be updated.
+        update (UpdateMovieRequest): Fields and values to update for the matched movies. Only provided fields will be updated.
+    Returns:
+        SuccessResponse: A response object containing the number of matched and modified movies and a success message.
+"""
+
+@router.patch("/",
+        response_model=SuccessResponse[dict],
+        status_code=200,
+        summary="Batch update movies matching the given filter."
+        )
+async def update_movies_batch(
+    filter: MovieFilter,
+    update: UpdateMovieRequest   
+) -> SuccessResponse[dict]:
+    movies_collection = get_collection("movies")
+
+    filter_dict = filter.model_dump(exclude_unset=True, exclude_none=True)
+    update_dict = update.model_dump(exclude_unset=True, exclude_none=True)
+
+    #Verify the filter and the update dicts are not empty
+    if not filter_dict or not update_dict:
+        return create_error_response(
+            message="Both filter and update objects are required",
+            code="MISSING_REQUIRED_FIELDS",
+            details=None
+        )
+
+    try:
+        result = await movies_collection.update_many(filter_dict,{"$set": update_dict})
+    except Exception as e:
+        return create_error_response(
+            message="An error occurred while updating movies.",
+            code="DATABASE_ERROR",
+            details=str(e)
+        )
+    
+    return create_success_response({
+        "matchedCount": result.matched_count,
+        "modifiedCount": result.modified_count
+        },
+        f"Update operation completed. Matched {result.matched_count} movie(s), modified {result.modified_count} movie(s)."
+)
+
+#------------------------------------
+# Place delete_movie endpoint here
+#------------------------------------
+
+"""
+    DELETE /api/movies/{id}
+    Delete a single movie by its ID.
+    Path Parameters:
+        id (str): The ObjectId of the movie to delete.
+    Returns:
+        SuccessResponse[dict]: A response object containing deletion details.
+"""
+
+@router.delete("/{id}",
+                response_model=SuccessResponse[dict],
+                status_code=200,
+                summary="Delete a single movie by its ID.")
+async def delete_movie_by_id(id: str):
+    try:
+        object_id = ObjectId(id)
+    except InvalidId:
+        return create_error_response(
+            message="Invalid movie ID format",
+            code="INTERNAL_SERVER_ERROR",
+            details=f"The provided ID '{id}' is not a valid ObjectId"
+        )
+
+    movies_collection = get_collection("movies")
+    try:
+        # Use deleteOne() to remove a single document
+        result = await movies_collection.delete_one({"_id": object_id})
+    except Exception as e:
+        return create_error_response(
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
+
+    if result.deleted_count == 0:
+        return create_error_response(
+            message="Movie not found",
+            code="INTERNAL_SERVER_ERROR", 
+            details=f"No movie found with ID: {id}"
+        )
+    
+    return create_success_response(
+        {"deletedCount": result.deleted_count}, 
+        "Movie deleted successfully"
+    )
+
+#------------------------------------
+# Place delete_movies_by_batch endpoint here
+#------------------------------------
+"""
+    DELETE /api/movies/
+
+    Delete multiple movies matching the given filter.
+
+    Request Body:
+        movie_filter (MovieFilter): Criteria to select which movies to delete. Only movies matching this filter will be removed.
+
+        Returns:
+        SuccessResponse: An object containing the number of deleted movies and a success message.
+"""
+
+@router.delete(
+        "/",
+        response_model=SuccessResponse[dict],
+        status_code=200,
+        summary="Delete multiple movies matching the given filter."
+)
+async def delete_movies_batch(movie_filter:MovieFilter) -> SuccessResponse[dict]:
+
+    movies_collection = get_collection("movies")
+    movie_filter_dict = movie_filter.model_dump(exclude_unset=True,exclude_none=True)
+
+    if not movie_filter_dict:
+        return create_error_response(
+            message="Filter object is required and cannot be empty.",
+            code="MISSING_FILTER",
+            details=None
+        )
+
+    try:
+        result = await movies_collection.delete_many(movie_filter_dict)
+    except Exception as e:
+        return create_error_response(
+            message="An error occurred while deleting movies.",
+            code="DATABASE_ERROR",
+            details=str(e)
+        )
+
+    return create_success_response(
+        {"deletedCount":result.deleted_count},
+        f'Delete operation completed. Removed {result.deleted_count} movies.'
+    )
+
+
+
+#------------------------------------
+# Place find_and_delete_movie endpoint here
+#------------------------------------
+
+"""
+    DELETE /api/movies/{id}/find-and-delete
+    Finds and deletes a movie in a single atomic operation.
+    Demonstrates the findOneAndDelete() operation.
+    Path Parameters:
+        id (str): The ObjectId of the movie to find and delete.
+    Returns:
+        SuccessResponse[Movie]: A response object containing the deleted movie data.
+"""
+
+@router.delete("/{id}/find-and-delete",
+                response_model=SuccessResponse[Movie],
+                status_code=200,
+                summary="Find and delete a movie in a single operation.")
+async def find_and_delete_movie(id: str):
+    try:
+        object_id = ObjectId(id)
+    except InvalidId:
+        return create_error_response(
+            message="Invalid movie ID format",
+            code="INTERNAL_SERVER_ERROR",
+            details=f"The provided ID '{id}' is not a valid ObjectId"
+        )
+
+    movies_collection = get_collection("movies")
+    # Use find_one_and_delete() to find and delete in a single atomic operation
+    # This is useful when you need to return the deleted document
+    # or ensure the document exists before deletion
+    try:
+        deleted_movie = await movies_collection.find_one_and_delete({"_id": object_id})
+    except Exception as e:
+        return create_error_response(
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
+
+    if deleted_movie is None:
+        return create_error_response(
+            message="Movie not found",
+            code="INTERNAL_SERVER_ERROR", 
+            details=f"No movie found with ID: {id}"
+        )
+    deleted_movie["_id"] = str(deleted_movie["_id"]) # Convert ObjectId to string
+    
+    return create_success_response(deleted_movie, "Movie found and deleted successfully")
+
+#------------------------------------
+#Helper Functions
+#------------------------------------
+
+"""  
+    Helper function to execute aggregation pipeline and return results.  
+
+    Args:  
+        pipeline: MongoDB aggregation pipeline stages  
+
+    Returns:  
+        List of documents from aggregation result  
+"""  
+
+async def execute_aggregation(pipeline: list) -> list:
+    """Helper function to execute aggregation pipeline and return results"""
+    print(f"Executing pipeline: {pipeline}")  # Debug logging
+    
+    movies_collection = get_collection("movies")
+    # For the async Pymongo driver, we need to await the aggregate call
+    cursor = await movies_collection.aggregate(pipeline)
+    results = await cursor.to_list(length=None)  # Convert cursor to list to collect all data at once rather than processing data per document
+    
+    print(f"Aggregation returned {len(results)} results")  # Debug logging
+    if len(results) <= 3:  # Log first few results for debugging
+        for i, doc in enumerate(results):
+            print(f"Result {i+1}: {doc}")
+    
+    return results
 
 # ---- Place Vector Search Here ----
 

From d79ce30cd1c0cdbc6ba4b681a81ad1afd81012dd Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Thu, 30 Oct 2025 16:19:45 -0400
Subject: [PATCH 032/110] feat(java): add aggregation endpoints

---
 .../controller/MovieControllerImpl.java       | 100 +++++++-
 .../model/dto/DirectorStatisticsResult.java   |  37 +++
 .../model/dto/MovieWithCommentsResult.java    | 127 ++++++++++
 .../model/dto/MoviesByYearResult.java         |  52 ++++
 .../samplemflix/service/MovieService.java     |  29 +++
 .../samplemflix/service/MovieServiceImpl.java | 227 ++++++++++++++++++
 .../controller/MovieControllerTest.java       | 178 ++++++++++++++
 .../integration/MovieIntegrationTest.java     |   9 +-
 .../samplemflix/service/MovieServiceTest.java | 186 ++++++++++++++
 9 files changed, 942 insertions(+), 3 deletions(-)
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DirectorStatisticsResult.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieWithCommentsResult.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MoviesByYearResult.java

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index 0d243c3..130635b 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -5,7 +5,10 @@
 import com.mongodb.samplemflix.model.dto.BatchUpdateResponse;
 import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
 import com.mongodb.samplemflix.model.dto.DeleteResponse;
+import com.mongodb.samplemflix.model.dto.DirectorStatisticsResult;
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
+import com.mongodb.samplemflix.model.dto.MovieWithCommentsResult;
+import com.mongodb.samplemflix.model.dto.MoviesByYearResult;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.model.response.SuccessResponse;
 import com.mongodb.samplemflix.service.MovieService;
@@ -20,8 +23,8 @@
 
 /**
  * REST controller for movie-related endpoints.
- * <p>
- * This controller handles all HTTP requests for movie operations including:
+ * 
+ * <p>This controller handles all HTTP requests for movie operations including:
  * <pre>
  * - GET /api/movies - Get all movies with filtering, sorting, and pagination
  * - GET /api/movies/{id} - Get a single movie by ID
@@ -32,6 +35,9 @@
  * - DELETE /api/movies/{id} - Delete a movie
  * - DELETE /api/movies - Delete multiple movies
  * - DELETE /api/movies/{id}/find-and-delete - Find and delete a movie
+ * - GET /api/movies/reportingByComments - Aggregate movies with most comments
+ * - GET /api/movies/reportingByYear - Aggregate movies by year with statistics
+ * - GET /api/movies/reportingByDirectors - Aggregate directors with most movies
  * </pre>
  */
 @RestController
@@ -249,4 +255,94 @@ public ResponseEntity<SuccessResponse<DeleteResponse>> deleteMoviesBatch(
 
         return ResponseEntity.ok(response);
     }
+
+    // Aggregation endpoints for reporting
+
+    /**
+     * GET /api/movies/aggregations/comments
+     *
+     * <p>Aggregates movies with their most recent comments.
+     * Demonstrates MongoDB $lookup (join) operation to combine movies with comments.
+     *
+     * @param limit Maximum number of movies to return (default: 10, max: 50)
+     * @param movieId Optional movie ID to filter by specific movie
+     * @return List of movies with their recent comments
+     */
+    @GetMapping("/aggregations/comments")
+    public ResponseEntity<SuccessResponse<List<MovieWithCommentsResult>>> getMoviesWithMostComments(
+            @RequestParam(defaultValue = "10") Integer limit,
+            @RequestParam(required = false) String movieId) {
+
+        List<MovieWithCommentsResult> results = movieService.getMoviesWithMostComments(limit, movieId);
+
+        // Calculate total comments across all movies
+        int totalComments = results.stream()
+                .mapToInt(result -> result.getTotalComments() != null ? result.getTotalComments() : 0)
+                .sum();
+
+        String message = movieId != null
+                ? String.format("Found %d comments from movie", totalComments)
+                : String.format("Found %d comments from %d movie%s",
+                        totalComments, results.size(), results.size() != 1 ? "s" : "");
+
+        SuccessResponse<List<MovieWithCommentsResult>> response =
+                SuccessResponse.<List<MovieWithCommentsResult>>builder()
+                        .success(true)
+                        .message(message)
+                        .data(results)
+                        .timestamp(Instant.now().toString())
+                        .build();
+
+        return ResponseEntity.ok(response);
+    }
+
+    /**
+     * GET /api/movies/aggregations/years
+     *
+     * <p>Aggregates movies by year with statistics.
+     * Demonstrates MongoDB $group operation for statistical aggregation.
+     *
+     * @return List of yearly statistics including movie count and average rating
+     */
+    @GetMapping("/aggregations/years")
+    public ResponseEntity<SuccessResponse<List<MoviesByYearResult>>> getMoviesByYearWithStats() {
+
+        List<MoviesByYearResult> results = movieService.getMoviesByYearWithStats();
+
+        SuccessResponse<List<MoviesByYearResult>> response =
+                SuccessResponse.<List<MoviesByYearResult>>builder()
+                        .success(true)
+                        .message(String.format("Aggregated statistics for %d years", results.size()))
+                        .data(results)
+                        .timestamp(Instant.now().toString())
+                        .build();
+
+        return ResponseEntity.ok(response);
+    }
+
+    /**
+     * GET /api/movies/aggregations/directors
+     *
+     * <p>Aggregates directors with the most movies.
+     * Demonstrates MongoDB $unwind operation for array flattening and aggregation.
+     *
+     * @param limit Maximum number of directors to return (default: 20, max: 100)
+     * @return List of directors with their movie count and average rating
+     */
+    @GetMapping("/aggregations/directors")
+    public ResponseEntity<SuccessResponse<List<DirectorStatisticsResult>>> getDirectorsWithMostMovies(
+            @RequestParam(defaultValue = "20") Integer limit) {
+
+        List<DirectorStatisticsResult> results = movieService.getDirectorsWithMostMovies(limit);
+
+        SuccessResponse<List<DirectorStatisticsResult>> response =
+                SuccessResponse.<List<DirectorStatisticsResult>>builder()
+                        .success(true)
+                        .message(String.format("Found %d directors with most movies", results.size()))
+                        .data(results)
+                        .timestamp(Instant.now().toString())
+                        .build();
+
+        return ResponseEntity.ok(response);
+    }
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DirectorStatisticsResult.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DirectorStatisticsResult.java
new file mode 100644
index 0000000..6bf04dc
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DirectorStatisticsResult.java
@@ -0,0 +1,37 @@
+package com.mongodb.samplemflix.model.dto;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * DTO for director statistics aggregation result.
+ *
+ * <p>This class represents the result of the reportingByDirectors aggregation
+ * which finds directors with the most movies and their statistics.
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class DirectorStatisticsResult {
+
+    /**
+     * Director name.
+     */
+    private String director;
+
+    /**
+     * Number of movies directed by this director.
+     */
+    private Integer movieCount;
+
+    /**
+     * Average IMDB rating of this director's movies.
+     */
+    private Double averageRating;
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieWithCommentsResult.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieWithCommentsResult.java
new file mode 100644
index 0000000..ede0b30
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieWithCommentsResult.java
@@ -0,0 +1,127 @@
+package com.mongodb.samplemflix.model.dto;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import java.util.Date;
+import java.util.List;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * DTO for movies with their most recent comments aggregation result.
+ *
+ * <p>This class represents the result of the reportingByComments aggregation
+ * which joins movies with their comments and returns movies with the most comments.
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class MovieWithCommentsResult {
+
+    /**
+     * Movie ID as string.
+     */
+    private String id;
+
+    /**
+     * Movie title.
+     */
+    private String title;
+
+    /**
+     * Release year.
+     */
+    private Integer year;
+
+    /**
+     * Short plot summary.
+     */
+    private String plot;
+
+    /**
+     * Poster image URL.
+     */
+    private String poster;
+
+    /**
+     * List of genres.
+     */
+    private List<String> genres;
+
+    /**
+     * IMDB rating information.
+     */
+    private ImdbInfo imdb;
+
+    /**
+     * Most recent comments for this movie.
+     */
+    private List<CommentInfo> recentComments;
+
+    /**
+     * Total number of comments for this movie.
+     */
+    private Integer totalComments;
+
+    /**
+     * Date of the most recent comment.
+     */
+    private Date mostRecentCommentDate;
+
+    /**
+     * Nested class for IMDB information.
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class ImdbInfo {
+        /**
+         * IMDB rating (0.0 to 10.0).
+         */
+        private Double rating;
+
+        /**
+         * Number of votes.
+         */
+        private Integer votes;
+    }
+
+    /**
+     * Nested class for comment information.
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class CommentInfo {
+        /**
+         * Comment ID as string.
+         */
+        private String id;
+
+        /**
+         * Commenter name.
+         */
+        private String name;
+
+        /**
+         * Commenter email.
+         */
+        private String email;
+
+        /**
+         * Comment text.
+         */
+        private String text;
+
+        /**
+         * Comment date.
+         */
+        private Date date;
+    }
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MoviesByYearResult.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MoviesByYearResult.java
new file mode 100644
index 0000000..1ab4da2
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MoviesByYearResult.java
@@ -0,0 +1,52 @@
+package com.mongodb.samplemflix.model.dto;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * DTO for movies aggregated by year with statistics.
+ *
+ * <p>This class represents the result of the reportingByYear aggregation
+ * which groups movies by release year and calculates statistics per year.
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class MoviesByYearResult {
+
+    /**
+     * Release year.
+     */
+    private Integer year;
+
+    /**
+     * Number of movies released in this year.
+     */
+    private Integer movieCount;
+
+    /**
+     * Average IMDB rating for movies in this year.
+     */
+    private Double averageRating;
+
+    /**
+     * Highest IMDB rating for movies in this year.
+     */
+    private Double highestRating;
+
+    /**
+     * Lowest IMDB rating for movies in this year.
+     */
+    private Double lowestRating;
+
+    /**
+     * Total number of IMDB votes for all movies in this year.
+     */
+    private Long totalVotes;
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
index 7327749..5f97db8 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
@@ -5,7 +5,10 @@
 import com.mongodb.samplemflix.model.dto.BatchUpdateResponse;
 import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
 import com.mongodb.samplemflix.model.dto.DeleteResponse;
+import com.mongodb.samplemflix.model.dto.DirectorStatisticsResult;
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
+import com.mongodb.samplemflix.model.dto.MovieWithCommentsResult;
+import com.mongodb.samplemflix.model.dto.MoviesByYearResult;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import java.util.List;
 import org.bson.Document;
@@ -32,4 +35,30 @@ public interface MovieService {
     DeleteResponse deleteMoviesBatch(Document filter);
 
     Movie findAndDeleteMovie(String id);
+
+    // Aggregation endpoints for reporting
+
+    /**
+     * Aggregates movies with their most recent comments.
+     *
+     * @param limit Maximum number of movies to return
+     * @param movieId Optional movie ID to filter by specific movie
+     * @return List of movies with their recent comments
+     */
+    List<MovieWithCommentsResult> getMoviesWithMostComments(Integer limit, String movieId);
+
+    /**
+     * Aggregates movies by year with statistics.
+     *
+     * @return List of yearly statistics including movie count and average rating
+     */
+    List<MoviesByYearResult> getMoviesByYearWithStats();
+
+    /**
+     * Aggregates directors with the most movies.
+     *
+     * @param limit Maximum number of directors to return
+     * @return List of directors with their movie count and average rating
+     */
+    List<DirectorStatisticsResult> getDirectorsWithMostMovies(Integer limit);
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 571cd07..1955ccb 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -11,7 +11,10 @@
 import com.mongodb.samplemflix.model.dto.BatchUpdateResponse;
 import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
 import com.mongodb.samplemflix.model.dto.DeleteResponse;
+import com.mongodb.samplemflix.model.dto.DirectorStatisticsResult;
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
+import com.mongodb.samplemflix.model.dto.MovieWithCommentsResult;
+import com.mongodb.samplemflix.model.dto.MoviesByYearResult;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.repository.MovieRepository;
 import java.util.Collection;
@@ -24,6 +27,10 @@
 import org.bson.types.ObjectId;
 import org.springframework.data.domain.Sort;
 import org.springframework.data.mongodb.core.MongoTemplate;
+import org.springframework.data.mongodb.core.aggregation.Aggregation;
+import org.springframework.data.mongodb.core.aggregation.AggregationResults;
+import org.springframework.data.mongodb.core.aggregation.ArrayOperators;
+import org.springframework.data.mongodb.core.aggregation.ConditionalOperators;
 import org.springframework.data.mongodb.core.query.Criteria;
 import org.springframework.data.mongodb.core.query.Query;
 import org.springframework.data.mongodb.core.query.TextCriteria;
@@ -330,6 +337,226 @@ private Update buildUpdate(UpdateMovieRequest request) {
         return update;
     }
 
+    // Aggregation methods for reporting
+
+    @Override
+    public List<MovieWithCommentsResult> getMoviesWithMostComments(Integer limit, String movieId) {
+        // Validate and set default limit
+        int resultLimit = Math.clamp(limit != null ? limit : 10, 1, 50);
+
+        // Build match criteria
+        Criteria matchCriteria = Criteria.where(Movie.Fields.YEAR).type(16).gte(1800).lte(2030);
+
+        // Add movie ID filter if provided
+        if (movieId != null && !movieId.trim().isEmpty()) {
+            if (!ObjectId.isValid(movieId)) {
+                throw new ValidationException("Invalid movie ID format");
+            }
+            matchCriteria = matchCriteria.and(Movie.Fields.ID).is(new ObjectId(movieId));
+        }
+
+        // Build aggregation pipeline
+        // This demonstrates $lookup (join), $unwind, $sort, $group, and $project operations
+        Aggregation aggregation = Aggregation.newAggregation(
+                // STAGE 1: Match movies with valid year data
+                Aggregation.match(matchCriteria),
+
+                // STAGE 2: Lookup (join) with comments collection
+                Aggregation.lookup("comments", "_id", "movie_id", "comments"),
+
+                // STAGE 3: Filter to only movies with comments
+                Aggregation.match(Criteria.where("comments").ne(List.of())),
+
+                // STAGE 4: Add computed fields
+                Aggregation.project()
+                        .and(Movie.Fields.ID).as("_id")
+                        .and(Movie.Fields.TITLE).as("title")
+                        .and(Movie.Fields.YEAR).as("year")
+                        .and(Movie.Fields.PLOT).as("plot")
+                        .and(Movie.Fields.POSTER).as("poster")
+                        .and(Movie.Fields.GENRES).as("genres")
+                        .and(Movie.Fields.IMDB).as("imdb")
+                        .and("comments").as("comments")
+                        .and(ArrayOperators.Size.lengthOfArray("comments")).as("totalComments")
+                        .and(ArrayOperators.ArrayElemAt.arrayOf("comments.date").elementAt(0)).as("mostRecentCommentDate"),
+
+                // STAGE 5: Sort by most recent comment date (descending)
+                Aggregation.sort(Sort.Direction.DESC, "mostRecentCommentDate"),
+
+                // STAGE 6: Limit results
+                Aggregation.limit(resultLimit),
+
+                // STAGE 7: Project final output with recent comments slice
+                Aggregation.project()
+                        .and(ConditionalOperators.ifNull("_id").then("")).as("id")
+                        .and("title").as("title")
+                        .and("year").as("year")
+                        .and("plot").as("plot")
+                        .and("poster").as("poster")
+                        .and("genres").as("genres")
+                        .and("imdb").as("imdb")
+                        .and(ArrayOperators.Slice.sliceArrayOf("comments").itemCount(5)).as("recentComments")
+                        .and("totalComments").as("totalComments")
+                        .and("mostRecentCommentDate").as("mostRecentCommentDate")
+        );
+
+        AggregationResults<Document> results = mongoTemplate.aggregate(
+                aggregation, "movies", Document.class);
+
+        // Convert Document results to DTOs
+        return results.getMappedResults().stream()
+                .map(this::mapToMovieWithCommentsResult)
+                .collect(Collectors.toList());
+    }
+
+    @Override
+    public List<MoviesByYearResult> getMoviesByYearWithStats() {
+        // Build aggregation pipeline
+        // This demonstrates $group with statistical operators and $project for data shaping
+        Aggregation aggregation = Aggregation.newAggregation(
+                // STAGE 1: Match movies with valid year data
+                Aggregation.match(
+                        Criteria.where(Movie.Fields.YEAR).type(16).gte(1800).lte(2030)
+                ),
+
+                // STAGE 2: Group by year and calculate statistics
+                Aggregation.group(Movie.Fields.YEAR)
+                        .count().as("movieCount")
+                        .avg(Movie.Fields.IMDB_RATING).as("averageRating")
+                        .max(Movie.Fields.IMDB_RATING).as("highestRating")
+                        .min(Movie.Fields.IMDB_RATING).as("lowestRating")
+                        .sum("imdb.votes").as("totalVotes"),
+
+                // STAGE 3: Project final output with renamed fields
+                Aggregation.project()
+                        .and("_id").as("year")
+                        .and("movieCount").as("movieCount")
+                        .and("averageRating").as("averageRating")
+                        .and("highestRating").as("highestRating")
+                        .and("lowestRating").as("lowestRating")
+                        .and("totalVotes").as("totalVotes")
+                        .andExclude("_id"),
+
+                // STAGE 4: Sort by year (descending)
+                Aggregation.sort(Sort.Direction.DESC, "year")
+        );
+
+        AggregationResults<MoviesByYearResult> results = mongoTemplate.aggregate(
+                aggregation, "movies", MoviesByYearResult.class);
+
+        // Round average rating to 2 decimal places
+        return results.getMappedResults().stream()
+                .peek(result -> {
+                    if (result.getAverageRating() != null) {
+                        result.setAverageRating(
+                                Math.round(result.getAverageRating() * 100.0) / 100.0
+                        );
+                    }
+                })
+                .collect(Collectors.toList());
+    }
+
+    @Override
+    public List<DirectorStatisticsResult> getDirectorsWithMostMovies(Integer limit) {
+        // Validate and set default limit
+        int resultLimit = Math.clamp(limit != null ? limit : 20, 1, 100);
+
+        // Build aggregation pipeline
+        // This demonstrates $unwind for array flattening and $group for aggregation
+        Aggregation aggregation = Aggregation.newAggregation(
+                // STAGE 1: Match movies with directors and valid year
+                Aggregation.match(
+                        Criteria.where(Movie.Fields.DIRECTORS).exists(true).ne(null).ne(List.of())
+                                .and(Movie.Fields.YEAR).type(16).gte(1800).lte(2030)
+                ),
+
+                // STAGE 2: Unwind directors array
+                Aggregation.unwind(Movie.Fields.DIRECTORS),
+
+                // STAGE 3: Filter out null/empty director names
+                Aggregation.match(
+                        Criteria.where(Movie.Fields.DIRECTORS).ne(null).ne("")
+                ),
+
+                // STAGE 4: Group by director and calculate statistics
+                Aggregation.group(Movie.Fields.DIRECTORS)
+                        .count().as("movieCount")
+                        .avg(Movie.Fields.IMDB_RATING).as("averageRating"),
+
+                // STAGE 5: Sort by movie count (descending)
+                Aggregation.sort(Sort.Direction.DESC, "movieCount"),
+
+                // STAGE 6: Limit results
+                Aggregation.limit(resultLimit),
+
+                // STAGE 7: Project final output
+                Aggregation.project()
+                        .and("_id").as("director")
+                        .and("movieCount").as("movieCount")
+                        .and("averageRating").as("averageRating")
+                        .andExclude("_id")
+        );
+
+        AggregationResults<DirectorStatisticsResult> results = mongoTemplate.aggregate(
+                aggregation, "movies", DirectorStatisticsResult.class);
+
+        // Round average rating to 2 decimal places
+        return results.getMappedResults().stream()
+                .peek(result -> {
+                    if (result.getAverageRating() != null) {
+                        result.setAverageRating(
+                                Math.round(result.getAverageRating() * 100.0) / 100.0
+                        );
+                    }
+                })
+                .collect(Collectors.toList());
+    }
+
+    /**
+     * Helper method to map Document to MovieWithCommentsResult.
+     */
+    private MovieWithCommentsResult mapToMovieWithCommentsResult(Document doc) {
+        // Extract IMDB info
+        MovieWithCommentsResult.ImdbInfo imdbInfo = null;
+        Document imdbDoc = doc.get("imdb", Document.class);
+        if (imdbDoc != null) {
+            imdbInfo = MovieWithCommentsResult.ImdbInfo.builder()
+                    .rating(imdbDoc.getDouble("rating"))
+                    .votes(imdbDoc.getInteger("votes"))
+                    .build();
+        }
+
+        // Extract recent comments
+        List<MovieWithCommentsResult.CommentInfo> recentComments = null;
+        @SuppressWarnings("unchecked")
+        List<Document> commentsDoc = (List<Document>) doc.get("recentComments");
+        if (commentsDoc != null) {
+            recentComments = commentsDoc.stream()
+                    .map(commentDoc -> MovieWithCommentsResult.CommentInfo.builder()
+                            .id(commentDoc.getObjectId("_id") != null ?
+                                    commentDoc.getObjectId("_id").toHexString() : null)
+                            .name(commentDoc.getString("name"))
+                            .email(commentDoc.getString("email"))
+                            .text(commentDoc.getString("text"))
+                            .date(commentDoc.getDate("date"))
+                            .build())
+                    .collect(Collectors.toList());
+        }
+
+        return MovieWithCommentsResult.builder()
+                .id(doc.getString("id"))
+                .title(doc.getString("title"))
+                .year(doc.getInteger("year"))
+                .plot(doc.getString("plot"))
+                .poster(doc.getString("poster"))
+                .genres((List<String>) doc.get("genres"))
+                .imdb(imdbInfo)
+                .recentComments(recentComments)
+                .totalComments(doc.getInteger("totalComments"))
+                .mostRecentCommentDate(doc.getDate("mostRecentCommentDate"))
+                .build();
+    }
+
     // TODO: Add advanced query methods
     // - getMoviesByGenreStatistics() - Aggregation pipeline for genre statistics
     // - getTopRatedMovies(int limit) - Movies sorted by rating
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
index b9b5a65..2ac237f 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
@@ -14,10 +14,14 @@
 import com.mongodb.samplemflix.model.dto.BatchInsertResponse;
 import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
 import com.mongodb.samplemflix.model.dto.DeleteResponse;
+import com.mongodb.samplemflix.model.dto.DirectorStatisticsResult;
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
+import com.mongodb.samplemflix.model.dto.MovieWithCommentsResult;
+import com.mongodb.samplemflix.model.dto.MoviesByYearResult;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.service.MovieService;
 import java.util.Arrays;
+import java.util.Date;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
@@ -324,4 +328,178 @@ void testFindAndDeleteMovie_NotFound() throws Exception {
                 .andExpect(jsonPath("$.success").value(false))
                 .andExpect(jsonPath("$.error.code").value("RESOURCE_NOT_FOUND"));
     }
+
+    // ==================== AGGREGATION ENDPOINT TESTS ====================
+
+    @Test
+    @DisplayName("GET /api/movies/aggregations/comments - Should return movies with most comments")
+    void testGetMoviesWithMostComments_Success() throws Exception {
+        // Arrange
+        MovieWithCommentsResult.CommentInfo comment = MovieWithCommentsResult.CommentInfo.builder()
+                .id(new ObjectId().toHexString())
+                .name("John Doe")
+                .email("john@example.com")
+                .text("Great movie!")
+                .date(new Date())
+                .build();
+
+        MovieWithCommentsResult.ImdbInfo imdb = MovieWithCommentsResult.ImdbInfo.builder()
+                .rating(8.5)
+                .votes(1000)
+                .build();
+
+        MovieWithCommentsResult result = MovieWithCommentsResult.builder()
+                .id(testId.toHexString())
+                .title("Test Movie")
+                .year(2024)
+                .plot("Test plot")
+                .poster("http://example.com/poster.jpg")
+                .genres(Arrays.asList("Action", "Drama"))
+                .imdb(imdb)
+                .recentComments(Arrays.asList(comment))
+                .totalComments(5)
+                .mostRecentCommentDate(new Date())
+                .build();
+
+        when(movieService.getMoviesWithMostComments(anyInt(), isNull())).thenReturn(Arrays.asList(result));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/aggregations/comments"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray())
+                .andExpect(jsonPath("$.data", hasSize(1)))
+                .andExpect(jsonPath("$.data[0].title").value("Test Movie"))
+                .andExpect(jsonPath("$.data[0].year").value(2024))
+                .andExpect(jsonPath("$.data[0].totalComments").value(5))
+                .andExpect(jsonPath("$.data[0].recentComments", hasSize(1)))
+                .andExpect(jsonPath("$.data[0].recentComments[0].name").value("John Doe"));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/aggregations/comments - Should accept limit parameter")
+    void testGetMoviesWithMostComments_WithLimit() throws Exception {
+        // Arrange
+        when(movieService.getMoviesWithMostComments(eq(5), isNull())).thenReturn(Arrays.asList());
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/aggregations/comments")
+                        .param("limit", "5"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray());
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/aggregations/comments - Should accept movieId parameter")
+    void testGetMoviesWithMostComments_WithMovieId() throws Exception {
+        // Arrange
+        String movieId = testId.toHexString();
+        when(movieService.getMoviesWithMostComments(anyInt(), eq(movieId))).thenReturn(Arrays.asList());
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/aggregations/comments")
+                        .param("movieId", movieId))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray());
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/aggregations/comments - Should return 400 for invalid movieId")
+    void testGetMoviesWithMostComments_InvalidMovieId() throws Exception {
+        // Arrange
+        String invalidMovieId = "invalid-id";
+        when(movieService.getMoviesWithMostComments(anyInt(), eq(invalidMovieId)))
+                .thenThrow(new ValidationException("Invalid movie ID format"));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/aggregations/comments")
+                        .param("movieId", invalidMovieId))
+                .andExpect(status().isBadRequest())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("VALIDATION_ERROR"));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/aggregations/years - Should return movies by year with statistics")
+    void testGetMoviesByYearWithStats_Success() throws Exception {
+        // Arrange
+        MoviesByYearResult result1 = MoviesByYearResult.builder()
+                .year(2024)
+                .movieCount(10)
+                .averageRating(7.5)
+                .highestRating(9.0)
+                .lowestRating(6.0)
+                .totalVotes(5000L)
+                .build();
+
+        MoviesByYearResult result2 = MoviesByYearResult.builder()
+                .year(2023)
+                .movieCount(15)
+                .averageRating(7.8)
+                .highestRating(9.5)
+                .lowestRating(6.5)
+                .totalVotes(7500L)
+                .build();
+
+        when(movieService.getMoviesByYearWithStats()).thenReturn(Arrays.asList(result1, result2));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/aggregations/years"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray())
+                .andExpect(jsonPath("$.data", hasSize(2)))
+                .andExpect(jsonPath("$.data[0].year").value(2024))
+                .andExpect(jsonPath("$.data[0].movieCount").value(10))
+                .andExpect(jsonPath("$.data[0].averageRating").value(7.5))
+                .andExpect(jsonPath("$.data[1].year").value(2023))
+                .andExpect(jsonPath("$.data[1].movieCount").value(15));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/aggregations/directors - Should return directors with most movies")
+    void testGetDirectorsWithMostMovies_Success() throws Exception {
+        // Arrange
+        DirectorStatisticsResult result1 = DirectorStatisticsResult.builder()
+                .director("Christopher Nolan")
+                .movieCount(10)
+                .averageRating(8.5)
+                .build();
+
+        DirectorStatisticsResult result2 = DirectorStatisticsResult.builder()
+                .director("Steven Spielberg")
+                .movieCount(25)
+                .averageRating(8.2)
+                .build();
+
+        when(movieService.getDirectorsWithMostMovies(anyInt())).thenReturn(Arrays.asList(result1, result2));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/aggregations/directors"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray())
+                .andExpect(jsonPath("$.data", hasSize(2)))
+                .andExpect(jsonPath("$.data[0].director").value("Christopher Nolan"))
+                .andExpect(jsonPath("$.data[0].movieCount").value(10))
+                .andExpect(jsonPath("$.data[0].averageRating").value(8.5))
+                .andExpect(jsonPath("$.data[1].director").value("Steven Spielberg"))
+                .andExpect(jsonPath("$.data[1].movieCount").value(25));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/aggregations/directors - Should accept limit parameter")
+    void testGetDirectorsWithMostMovies_WithLimit() throws Exception {
+        // Arrange
+        when(movieService.getDirectorsWithMostMovies(eq(10))).thenReturn(Arrays.asList());
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/aggregations/directors")
+                        .param("limit", "10"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray());
+    }
 }
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
index 200368f..c734d7a 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
@@ -21,6 +21,11 @@
  * - DELETE /api/movies
  * - DELETE /api/movies/{id}/find-and-delete
  *
+ * TODO: Implement integration tests for aggregation endpoints:
+ * - GET /api/movies/aggregations/comments (with and without limit/movieId)
+ * - GET /api/movies/aggregations/years
+ * - GET /api/movies/aggregations/directors (with and without limit)
+ *
  * TODO: Test error scenarios:
  * - Invalid ObjectId format
  * - Resource not found
@@ -31,6 +36,7 @@
  * - Large dataset queries
  * - Pagination performance
  * - Text search performance
+ * - Aggregation pipeline performance
  */
 public class MovieIntegrationTest {
 
@@ -38,5 +44,6 @@ public class MovieIntegrationTest {
     // TODO: Add @Testcontainers annotation
     // TODO: Add MongoDB container configuration
     // TODO: Add test data setup methods
-    // TODO: Add integration test methods
+    // TODO: Add integration test methods for CRUD operations
+    // TODO: Add integration test methods for aggregation endpoints
 }
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
index ed57f3b..4af804c 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
@@ -12,10 +12,14 @@
 import com.mongodb.samplemflix.model.dto.BatchInsertResponse;
 import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
 import com.mongodb.samplemflix.model.dto.DeleteResponse;
+import com.mongodb.samplemflix.model.dto.DirectorStatisticsResult;
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
+import com.mongodb.samplemflix.model.dto.MovieWithCommentsResult;
+import com.mongodb.samplemflix.model.dto.MoviesByYearResult;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.repository.MovieRepository;
 import java.util.*;
+import org.bson.Document;
 import org.bson.types.ObjectId;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.DisplayName;
@@ -25,6 +29,8 @@
 import org.mockito.Mock;
 import org.mockito.junit.jupiter.MockitoExtension;
 import org.springframework.data.mongodb.core.MongoTemplate;
+import org.springframework.data.mongodb.core.aggregation.Aggregation;
+import org.springframework.data.mongodb.core.aggregation.AggregationResults;
 import org.springframework.data.mongodb.core.query.Query;
 
 /**
@@ -422,4 +428,184 @@ void testFindAndDeleteMovie_NotFound() {
         assertThrows(ResourceNotFoundException.class, () -> movieService.findAndDeleteMovie(validId));
         verify(mongoTemplate).findAndRemove(any(Query.class), eq(Movie.class));
     }
+
+    // ==================== AGGREGATION TESTS ====================
+
+    @Test
+    @DisplayName("Should get movies with most comments")
+    void testGetMoviesWithMostComments_Success() {
+        // Arrange
+        Integer limit = 10;
+        String movieId = null;
+
+        Document doc1 = new Document()
+                .append("id", testId.toHexString())
+                .append("title", "Test Movie")
+                .append("year", 2024)
+                .append("plot", "Test plot")
+                .append("poster", "http://example.com/poster.jpg")
+                .append("genres", Arrays.asList("Action", "Drama"))
+                .append("imdb", new Document("rating", 8.5).append("votes", 1000))
+                .append("recentComments", Arrays.asList(
+                        new Document()
+                                .append("_id", new ObjectId())
+                                .append("name", "John Doe")
+                                .append("email", "john@example.com")
+                                .append("text", "Great movie!")
+                                .append("date", new Date())
+                ))
+                .append("totalComments", 5)
+                .append("mostRecentCommentDate", new Date());
+
+        @SuppressWarnings("unchecked")
+        AggregationResults<Document> mockResults = mock(AggregationResults.class);
+        when(mockResults.getMappedResults()).thenReturn(Arrays.asList(doc1));
+        when(mongoTemplate.aggregate(any(Aggregation.class), eq("movies"), eq(Document.class)))
+                .thenReturn(mockResults);
+
+        // Act
+        List<MovieWithCommentsResult> results = movieService.getMoviesWithMostComments(limit, movieId);
+
+        // Assert
+        assertNotNull(results);
+        assertEquals(1, results.size());
+        assertEquals("Test Movie", results.get(0).getTitle());
+        assertEquals(2024, results.get(0).getYear());
+        assertEquals(5, results.get(0).getTotalComments());
+        assertNotNull(results.get(0).getRecentComments());
+        assertEquals(1, results.get(0).getRecentComments().size());
+        verify(mongoTemplate).aggregate(any(Aggregation.class), eq("movies"), eq(Document.class));
+    }
+
+    @Test
+    @DisplayName("Should get movies with most comments filtered by movie ID")
+    void testGetMoviesWithMostComments_WithMovieId() {
+        // Arrange
+        Integer limit = 10;
+        String movieId = testId.toHexString();
+
+        @SuppressWarnings("unchecked")
+        AggregationResults<Document> mockResults = mock(AggregationResults.class);
+        when(mockResults.getMappedResults()).thenReturn(Arrays.asList());
+        when(mongoTemplate.aggregate(any(Aggregation.class), eq("movies"), eq(Document.class)))
+                .thenReturn(mockResults);
+
+        // Act
+        List<MovieWithCommentsResult> results = movieService.getMoviesWithMostComments(limit, movieId);
+
+        // Assert
+        assertNotNull(results);
+        verify(mongoTemplate).aggregate(any(Aggregation.class), eq("movies"), eq(Document.class));
+    }
+
+    @Test
+    @DisplayName("Should throw ValidationException for invalid movie ID in getMoviesWithMostComments")
+    void testGetMoviesWithMostComments_InvalidMovieId() {
+        // Arrange
+        Integer limit = 10;
+        String invalidMovieId = "invalid-id";
+
+        // Act & Assert
+        assertThrows(ValidationException.class,
+                () -> movieService.getMoviesWithMostComments(limit, invalidMovieId));
+        verify(mongoTemplate, never()).aggregate(any(Aggregation.class), anyString(), any());
+    }
+
+    @Test
+    @DisplayName("Should get movies by year with statistics")
+    void testGetMoviesByYearWithStats_Success() {
+        // Arrange
+        MoviesByYearResult result1 = MoviesByYearResult.builder()
+                .year(2024)
+                .movieCount(10)
+                .averageRating(7.5)
+                .highestRating(9.0)
+                .lowestRating(6.0)
+                .totalVotes(5000L)
+                .build();
+
+        MoviesByYearResult result2 = MoviesByYearResult.builder()
+                .year(2023)
+                .movieCount(15)
+                .averageRating(7.8)
+                .highestRating(9.5)
+                .lowestRating(6.5)
+                .totalVotes(7500L)
+                .build();
+
+        @SuppressWarnings("unchecked")
+        AggregationResults<MoviesByYearResult> mockResults = mock(AggregationResults.class);
+        when(mockResults.getMappedResults()).thenReturn(Arrays.asList(result1, result2));
+        when(mongoTemplate.aggregate(any(Aggregation.class), eq("movies"), eq(MoviesByYearResult.class)))
+                .thenReturn(mockResults);
+
+        // Act
+        List<MoviesByYearResult> results = movieService.getMoviesByYearWithStats();
+
+        // Assert
+        assertNotNull(results);
+        assertEquals(2, results.size());
+        assertEquals(2024, results.get(0).getYear());
+        assertEquals(10, results.get(0).getMovieCount());
+        assertEquals(7.5, results.get(0).getAverageRating());
+        assertEquals(2023, results.get(1).getYear());
+        verify(mongoTemplate).aggregate(any(Aggregation.class), eq("movies"), eq(MoviesByYearResult.class));
+    }
+
+    @Test
+    @DisplayName("Should get directors with most movies")
+    void testGetDirectorsWithMostMovies_Success() {
+        // Arrange
+        Integer limit = 20;
+
+        DirectorStatisticsResult result1 = DirectorStatisticsResult.builder()
+                .director("Christopher Nolan")
+                .movieCount(10)
+                .averageRating(8.5)
+                .build();
+
+        DirectorStatisticsResult result2 = DirectorStatisticsResult.builder()
+                .director("Steven Spielberg")
+                .movieCount(25)
+                .averageRating(8.2)
+                .build();
+
+        @SuppressWarnings("unchecked")
+        AggregationResults<DirectorStatisticsResult> mockResults = mock(AggregationResults.class);
+        when(mockResults.getMappedResults()).thenReturn(Arrays.asList(result1, result2));
+        when(mongoTemplate.aggregate(any(Aggregation.class), eq("movies"), eq(DirectorStatisticsResult.class)))
+                .thenReturn(mockResults);
+
+        // Act
+        List<DirectorStatisticsResult> results = movieService.getDirectorsWithMostMovies(limit);
+
+        // Assert
+        assertNotNull(results);
+        assertEquals(2, results.size());
+        assertEquals("Christopher Nolan", results.get(0).getDirector());
+        assertEquals(10, results.get(0).getMovieCount());
+        assertEquals(8.5, results.get(0).getAverageRating());
+        assertEquals("Steven Spielberg", results.get(1).getDirector());
+        verify(mongoTemplate).aggregate(any(Aggregation.class), eq("movies"), eq(DirectorStatisticsResult.class));
+    }
+
+    @Test
+    @DisplayName("Should use default limit when null in getDirectorsWithMostMovies")
+    void testGetDirectorsWithMostMovies_DefaultLimit() {
+        // Arrange
+        Integer limit = null;
+
+        @SuppressWarnings("unchecked")
+        AggregationResults<DirectorStatisticsResult> mockResults = mock(AggregationResults.class);
+        when(mockResults.getMappedResults()).thenReturn(Arrays.asList());
+        when(mongoTemplate.aggregate(any(Aggregation.class), eq("movies"), eq(DirectorStatisticsResult.class)))
+                .thenReturn(mockResults);
+
+        // Act
+        List<DirectorStatisticsResult> results = movieService.getDirectorsWithMostMovies(limit);
+
+        // Assert
+        assertNotNull(results);
+        verify(mongoTemplate).aggregate(any(Aggregation.class), eq("movies"), eq(DirectorStatisticsResult.class));
+    }
 }

From caf7755756c9809493073960c132ecc454bfbb3c Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Thu, 30 Oct 2025 16:52:37 -0400
Subject: [PATCH 033/110] add new info

---
 server/python/main.py                      |  45 ++++++-
 server/python/src/database/mongo_client.py |   2 +
 server/python/src/routers/movies.py        | 144 ++++++++++++++++++++-
 3 files changed, 187 insertions(+), 4 deletions(-)

diff --git a/server/python/main.py b/server/python/main.py
index a782508..5af7052 100644
--- a/server/python/main.py
+++ b/server/python/main.py
@@ -1,7 +1,7 @@
 from fastapi import FastAPI
 from src.routers import movies
 from src.utils.errorHandler import register_error_handlers
-from src.database.mongo_client import db
+from src.database.mongo_client import db, get_collection
 import traceback
 
 app = FastAPI()
@@ -45,6 +45,45 @@ async def ensure_search_index():
     except Exception as e:
         print(f"Error creating the search index: {e}")
 
-
-
+@app.on_event("startup")
+async def vector_search_index():
+    """
+    Creates vector search index on application startup if it doesn't already exist.
+    This ensures the index is ready before any vector search requests are made.
+    """
+    try:
+        
+        embedded_movies_collection = get_collection("embedded_movies")
+        
+        # Get list of existing indexes - convert AsyncCommandCursor to list
+        existing_indexes_cursor = await embedded_movies_collection.list_search_indexes()
+        existing_indexes = await existing_indexes_cursor.to_list(length=None)
+        index_names = [index.get("name") for index in existing_indexes]
+        
+        # Check if our vector_index already exists
+        if "vector_index" not in index_names:
+            
+            # Define the vector search index specification
+            index_definition = {
+                "name": "vector_index",
+                "type": "vectorSearch",
+                "definition": {
+                    "fields": [
+                        {
+                            "type": "vector",
+                            "path": "plot_embedding_voyage_3_large",
+                            "numDimensions": 2048, #Set this to 2048 to match the embedding dimensions on the path
+                            "similarity": "cosine"
+                        }
+                    ]
+                }
+            }
+            
+            # Create the index
+            result = await embedded_movies_collection.create_search_index(index_definition)
+            print("Vector search index 'vector_index' ready to query.")
+            
+    except Exception as e:
+        print(f"Error during vector search index setup: {str(e)}")
+        print(f"Error type: {type(e).__name__}")
 
diff --git a/server/python/src/database/mongo_client.py b/server/python/src/database/mongo_client.py
index a608530..3f2f768 100644
--- a/server/python/src/database/mongo_client.py
+++ b/server/python/src/database/mongo_client.py
@@ -1,11 +1,13 @@
 from pymongo import AsyncMongoClient
 from dotenv import load_dotenv
 import os
+import voyageai
 
 load_dotenv()
 
 client = AsyncMongoClient(os.getenv("MONGO_URI"))
 db = client[os.getenv("MONGO_DB")]
+voyageai.api_key = os.getenv("VOYAGE_API_KEY")
 
 def get_collection(name:str):
     return db[name]
\ No newline at end of file
diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 76579ee..e608013 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -7,6 +7,7 @@
 from bson import ObjectId
 import re
 from bson.errors import InvalidId
+import voyageai
 
 '''
 This file contains all the business logic for movie operations.
@@ -235,6 +236,107 @@ async def search_movies(
         movies.append(movie)
 
     return create_success_response(movies, f"Found {len(movies)} movies matching the search criteria.")
+
+#----------------------------------------------------------------------------------------------------------
+# MongoDB Vector Search
+#
+# MongoDB Vector Search based on searching the plot_embedding_voyage_3_large field.
+#----------------------------------------------------------------------------------------------------------
+"""
+
+    GET /api/movies/vector-search
+
+    Search movies using MongoDB Vector Search to find movies with similar plots.
+    Uses embeddings generated by the Voyage AI model to perform semantic similarity search.
+
+    Query Parameters:
+        q (str, required): Search query text to find movies with similar plots.
+        limit (int, optional): Number of results to return (default: 10, max: 50).
+
+    Returns:
+        SuccessResponse[List[VectorSearchResult]]: A response object containing movies with similarity scores.
+        Each result includes:
+            - _id: Movie ObjectId
+            - title: Movie title  
+            - plot: Movie plot text
+            - score: Vector search similarity score (0.0 to 1.0, higher = more similar)
+"""
+# Specify your Voyage API key and embedding model
+model = "voyage-3-large"
+outputDimension = 2048 #Set to 2048 to match the dimensions of the collection's embeddings
+vo = voyageai.Client()
+
+# Vector Search Endpoint
+@router.get("/vector-search", response_model=SuccessResponse[List[VectorSearchResult]])
+async def vector_search_movies(
+    q: str = Query(..., description="Search query to find similar movies by plot"),
+    limit: int = Query(default=10, ge=1, le=50, description="Number of results to return")
+):
+    """
+    Vector search endpoint for finding movies with similar plots.
+    
+    Args:
+        q: The search query string
+        limit: Maximum number of results to return
+    
+    Returns:
+        SuccessResponse containing a list of movies with similarity scores
+    """
+    try:
+        # The vector search index was already created at startup time
+        # Generate embedding for the search query
+        query_embedding = get_embedding(q, input_type="query")
+        
+        # Get the embedded movies collection
+        embedded_movies_collection = get_collection("embedded_movies")
+        
+        # Define vector search pipeline
+        pipeline = [
+            {
+                "$vectorSearch": {
+                    "index": "vector_index",
+                    "path": "plot_embedding_voyage_3_large",
+                    "queryVector": query_embedding, #2048
+                    "numCandidates": limit * 15,  # Search more candidates for better results
+                    "limit": limit
+                }
+            },
+            {
+                "$project": {
+                    "_id": 1,
+                    "title": 1,
+                    "plot": 1,
+                    "score": {
+                        "$meta": "vectorSearchScore"
+                    }
+                }
+            }
+        ]
+
+        raw_results = await execute_aggregation_on_collection(embedded_movies_collection, pipeline)
+        
+        # Convert ObjectId to string and create VectorSearchResult objects
+        for result in raw_results:
+            if "_id" in result and result["_id"]:
+                try:
+                    result["_id"] = str(result["_id"])
+                except (InvalidId, TypeError):
+                    # Handle invalid ObjectId conversion
+                    result["_id"] = str(result["_id"]) if result["_id"] else None
+        
+        results = [VectorSearchResult(**doc) for doc in raw_results]
+        
+        return create_success_response(
+            results, 
+            f"Found {len(results)} similar movies for query: '{q}'"
+        )
+        
+    except Exception as e:
+        return create_error_response(
+            message="Vector search failed",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
     
 """
     GET /api/movies/aggregations/reportingByComments
@@ -1199,5 +1301,45 @@ async def execute_aggregation(pipeline: list) -> list:
     
     return results
 
-# ---- Place Vector Search Here ----
+"""  
+    Helper function to execute aggregation pipeline and return results from a specified collection. 
+
+    Args:  
+        collection: The MongoDB collection to run the aggregation on
+        pipeline: MongoDB aggregation pipeline stages  
+
+    Returns:  
+        List of documents from aggregation result  
+"""  
+
+async def execute_aggregation_on_collection(collection, pipeline: list) -> list:
+    """Helper function to execute aggregation pipeline on a specified collection and return results"""
+    print(f"Executing pipeline: {pipeline}")  # Debug logging
+    print(f"Collection: {collection.name if hasattr(collection, 'name') else 'embedded_movies'}")
+
+    cursor = await collection.aggregate(pipeline)
+    results = await cursor.to_list(length=None)  # Convert cursor to list
+
+    print(f"Aggregation returned {len(results)} results")  # Debug logging
+    if len(results) <= 3:  # Log first few results for debugging
+        for i, doc in enumerate(results):
+            print(f"Result {i+1}: {doc}")
+
+    return results
+
+"""  
+    Helper function to generate vector embeddings from an input.
+
+    Args:  
+        data: Input data to generate embeddings for
+        input_type: Type of input data
+
+    Returns:  
+        Vector embeddings for the given input
+"""
 
+def get_embedding(data, input_type = "document"):
+  embeddings = vo.embed(
+      data, model = model, output_dimension = outputDimension, input_type = input_type
+  ).embeddings
+  return embeddings[0]

From efd31b883744934964c2e86fb20b04e08f1fc79f Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Thu, 30 Oct 2025 17:00:59 -0400
Subject: [PATCH 034/110] test vs

---
 server/python/src/models/models.py  | 10 ++++++++++
 server/python/src/routers/movies.py |  2 +-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/server/python/src/models/models.py b/server/python/src/models/models.py
index c044ce9..ce94bca 100644
--- a/server/python/src/models/models.py
+++ b/server/python/src/models/models.py
@@ -111,6 +111,16 @@ class MovieFilter(BaseModel):
     runtime: Optional[int]  = None
     poster: Optional[str]  = None   
 
+class VectorSearchResult(BaseModel):
+    id: Optional[str] = Field(alias="_id")
+    title: str
+    plot: Optional[str] = None
+    score: float
+
+    model_config = {
+        "populate_by_name": True
+    }
+
 class SuccessResponse(BaseModel, Generic[T]):
     success: bool = True
     message: Optional[str]
diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index e608013..817c933 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -1,6 +1,6 @@
 from fastapi import APIRouter, Query, Path
 from src.database.mongo_client import db, get_collection
-from src.models.models import CreateMovieRequest, Movie, MovieFilter, SuccessResponse, UpdateMovieRequest
+from src.models.models import CreateMovieRequest, Movie, MovieFilter, SuccessResponse, UpdateMovieRequest, VectorSearchResult
 from typing import List
 from datetime import datetime
 from src.utils.errorHandler import create_success_response, create_error_response

From 497605927f1895c48cb353a90222c47487fdce79 Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Thu, 30 Oct 2025 17:07:53 -0400
Subject: [PATCH 035/110] add new comments

---
 server/python/src/routers/movies.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 817c933..851de45 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -55,8 +55,15 @@
     Search movies using MongoDB Search across the plot, fullplot, directors, writers, and cast fields.
     Supports compound search operators and fuzzy matching.
 
+- GET /api/movies/vector-search :
+    Search movies using MongoDB Vector Search to enable semantic search capabilities over
+    the plot field.
+
 Helper Functions:
-- execute_aggregation(pipeline): Executes a MongoDB aggregation pipeline and returns the results.
+- execute_aggregation(pipeline): Executes a MongoDB aggregation pipeline and returns the
+results.
+- execute_aggregation_on_collection(collection, pipeline): Executes a MongoDB aggregation pipeline on a specific collection and returns the results.
+- get_embedding(data, input_type): Creates the vector embedding for a given input using the specified input type.
 '''
 
 router = APIRouter()

From 748af9f454fe0dc4413c5d3dc6e86b6b1fa6205d Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Thu, 30 Oct 2025 17:28:11 -0400
Subject: [PATCH 036/110] add error handling

---
 server/python/src/database/mongo_client.py | 13 +++++--
 server/python/src/routers/movies.py        | 40 +++++++++++++++++-----
 2 files changed, 43 insertions(+), 10 deletions(-)

diff --git a/server/python/src/database/mongo_client.py b/server/python/src/database/mongo_client.py
index 3f2f768..da2d2b9 100644
--- a/server/python/src/database/mongo_client.py
+++ b/server/python/src/database/mongo_client.py
@@ -7,7 +7,16 @@
 
 client = AsyncMongoClient(os.getenv("MONGO_URI"))
 db = client[os.getenv("MONGO_DB")]
-voyageai.api_key = os.getenv("VOYAGE_API_KEY")
+
+# Set the API key but don't instantiate the client here
+voyage_api_key = os.getenv("VOYAGE_API_KEY")
+if voyage_api_key:
+    voyageai.api_key = voyage_api_key
 
 def get_collection(name:str):
-    return db[name]
\ No newline at end of file
+    return db[name]
+
+def voyage_ai_available():
+    """Check if Voyage API Key is available and valid."""
+    api_key = os.getenv("VOYAGE_API_KEY")
+    return api_key is not None and api_key.strip() != ""
\ No newline at end of file
diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 851de45..10981c8 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -1,5 +1,5 @@
 from fastapi import APIRouter, Query, Path
-from src.database.mongo_client import db, get_collection
+from src.database.mongo_client import db, get_collection, voyage_ai_available
 from src.models.models import CreateMovieRequest, Movie, MovieFilter, SuccessResponse, UpdateMovieRequest, VectorSearchResult
 from typing import List
 from datetime import datetime
@@ -271,7 +271,6 @@ async def search_movies(
 # Specify your Voyage API key and embedding model
 model = "voyage-3-large"
 outputDimension = 2048 #Set to 2048 to match the dimensions of the collection's embeddings
-vo = voyageai.Client()
 
 # Vector Search Endpoint
 @router.get("/vector-search", response_model=SuccessResponse[List[VectorSearchResult]])
@@ -289,10 +288,20 @@ async def vector_search_movies(
     Returns:
         SuccessResponse containing a list of movies with similarity scores
     """
+    if not voyage_ai_available():
+        return create_error_response(
+            message="Vector search unavailable",
+            code="SERVICE_UNAVAILABLE",
+            details="VOYAGE_API_KEY not configured. Please add your API key to your .env file."
+        )
+    
     try:
+        # Initialize the client here to avoid import-time errors
+        vo = voyageai.Client()
+        
         # The vector search index was already created at startup time
         # Generate embedding for the search query
-        query_embedding = get_embedding(q, input_type="query")
+        query_embedding = get_embedding(q, input_type="query", client=vo)
         
         # Get the embedded movies collection
         embedded_movies_collection = get_collection("embedded_movies")
@@ -1340,13 +1349,28 @@ async def execute_aggregation_on_collection(collection, pipeline: list) -> list:
     Args:  
         data: Input data to generate embeddings for
         input_type: Type of input data
+        client: Voyage AI client instance
 
     Returns:  
         Vector embeddings for the given input
 """
 
-def get_embedding(data, input_type = "document"):
-  embeddings = vo.embed(
-      data, model = model, output_dimension = outputDimension, input_type = input_type
-  ).embeddings
-  return embeddings[0]
+def get_embedding(data, input_type = "document", client=None):
+    """
+    Helper function to generate vector embeddings from an input.
+
+    Args:  
+        data: Input data to generate embeddings for
+        input_type: Type of input data
+        client: Voyage AI client instance
+
+    Returns:  
+        Vector embeddings for the given input
+    """
+    if client is None:
+        client = voyageai.Client()
+    
+    embeddings = client.embed(
+        data, model = model, output_dimension = outputDimension, input_type = input_type
+    ).embeddings
+    return embeddings[0]

From 238d734ec552bd29855811ff8cff7c0851fb2fdb Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Fri, 31 Oct 2025 12:26:31 -0400
Subject: [PATCH 037/110] tests(java): add tests for atlas search

---
 server/java-spring/pom.xml                    |   8 +
 .../controller/MovieControllerImpl.java       |  68 +++-
 .../exception/GlobalExceptionHandler.java     |  21 ++
 .../samplemflix/service/MovieService.java     |  23 ++
 .../samplemflix/service/MovieServiceImpl.java | 150 ++++++++-
 .../controller/MovieControllerTest.java       |  93 ++++++
 .../AtlasSearchIntegrationTest.java           | 316 ++++++++++++++++++
 .../mongodb/samplemflix/integration/README.md | 134 ++++++++
 .../resources/application-test.properties     |  23 ++
 9 files changed, 831 insertions(+), 5 deletions(-)
 create mode 100644 server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java
 create mode 100644 server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
 create mode 100644 server/java-spring/src/test/resources/application-test.properties

diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index d6bc07b..4e2f946 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -66,6 +66,7 @@
             <artifactId>commons-lang3</artifactId>
             <version>${commons.lang3.version}</version>
         </dependency>
+
         <!-- SpringDoc OpenAPI (Swagger UI) -->
         <dependency>
             <groupId>org.springdoc</groupId>
@@ -85,6 +86,12 @@
             <artifactId>spring-boot-starter-test</artifactId>
             <scope>test</scope>
         </dependency>
+
+        <!-- Jackson Databind for JSON serialization/deserialization -->
+        <dependency>
+            <groupId>com.fasterxml.jackson.core</groupId>
+            <artifactId>jackson-databind</artifactId>
+        </dependency>
     </dependencies>
     
     <build>
@@ -114,6 +121,7 @@
                     </argLine>
                 </configuration>
             </plugin>
+
             <!-- Sort and remove unused imports -->
             <plugin>
                 <groupId>net.revelc.code</groupId>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index 130635b..2b5d42c 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -23,7 +23,7 @@
 
 /**
  * REST controller for movie-related endpoints.
- * 
+ *
  * <p>This controller handles all HTTP requests for movie operations including:
  * <pre>
  * - GET /api/movies - Get all movies with filtering, sorting, and pagination
@@ -35,9 +35,11 @@
  * - DELETE /api/movies/{id} - Delete a movie
  * - DELETE /api/movies - Delete multiple movies
  * - DELETE /api/movies/{id}/find-and-delete - Find and delete a movie
- * - GET /api/movies/reportingByComments - Aggregate movies with most comments
- * - GET /api/movies/reportingByYear - Aggregate movies by year with statistics
- * - GET /api/movies/reportingByDirectors - Aggregate directors with most movies
+ * - GET /api/movies/aggregations/comments - Aggregate movies with most comments
+ * - GET /api/movies/aggregations/years - Aggregate movies by year with statistics
+ * - GET /api/movies/aggregations/directors - Aggregate directors with most movies
+ * - GET /api/movies/searchByPlot - Text search using Atlas Search Index based on plot
+ * - GET /api/movies/findSimilarMovies - Vector search to find similar movies based on plot embeddings
  * </pre>
  */
 @RestController
@@ -345,4 +347,62 @@ public ResponseEntity<SuccessResponse<List<DirectorStatisticsResult>>> getDirect
 
         return ResponseEntity.ok(response);
     }
+
+    // Atlas Search endpoints
+
+    /**
+     * GET /api/movies/searchByPlot
+     *
+     * <p>Searches movies by plot using MongoDB Atlas Search.
+     * Demonstrates text search using Atlas Search Index based on plot field.
+     *
+     * @param plot Text to search in the plot field (required)
+     * @param limit Maximum number of movies to return (default: 20, max: 100)
+     * @param skip Number of results to skip for pagination (default: 0)
+     * @return List of movies matching the search criteria
+     */
+    @GetMapping("/searchByPlot")
+    public ResponseEntity<SuccessResponse<List<Movie>>> searchMoviesByPlot(
+            @RequestParam String plot,
+            @RequestParam(defaultValue = "20") Integer limit,
+            @RequestParam(defaultValue = "0") Integer skip) {
+
+        List<Movie> movies = movieService.searchMoviesByPlot(plot, limit, skip);
+
+        SuccessResponse<List<Movie>> response = SuccessResponse.<List<Movie>>builder()
+                .success(true)
+                .message(String.format("Found %d movies matching the search criteria", movies.size()))
+                .data(movies)
+                .timestamp(Instant.now().toString())
+                .build();
+
+        return ResponseEntity.ok(response);
+    }
+
+    /**
+     * GET /api/movies/findSimilarMovies
+     *
+     * <p>Finds similar movies using vector search on plot embeddings.
+     * Demonstrates MongoDB Atlas Vector Search to find movies with similar plots.
+     *
+     * @param movieId ID of the movie to find similar movies for (required)
+     * @param limit Maximum number of similar movies to return (default: 10, max: 50)
+     * @return List of similar movies based on plot embeddings
+     */
+    @GetMapping("/findSimilarMovies")
+    public ResponseEntity<SuccessResponse<List<Movie>>> findSimilarMovies(
+            @RequestParam String movieId,
+            @RequestParam(defaultValue = "10") Integer limit) {
+
+        List<Movie> movies = movieService.findSimilarMovies(movieId, limit);
+
+        SuccessResponse<List<Movie>> response = SuccessResponse.<List<Movie>>builder()
+                .success(true)
+                .message(String.format("Found %d similar movies", movies.size()))
+                .data(movies)
+                .timestamp(Instant.now().toString())
+                .build();
+
+        return ResponseEntity.ok(response);
+    }
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
index ef5f11c..aa6e544 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
@@ -7,6 +7,7 @@
 import org.slf4j.LoggerFactory;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.MissingServletRequestParameterException;
 import org.springframework.web.bind.annotation.ControllerAdvice;
 import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.context.request.WebRequest;
@@ -58,6 +59,26 @@ public ResponseEntity<ErrorResponse> handleValidationException(
         return new ResponseEntity<>(errorResponse, HttpStatus.BAD_REQUEST);
     }
 
+    @ExceptionHandler(MissingServletRequestParameterException.class)
+    public ResponseEntity<ErrorResponse> handleMissingServletRequestParameter(
+            MissingServletRequestParameterException ex, WebRequest request) {
+        logger.error("Missing request parameter: {}", ex.getMessage());
+
+        String message = String.format("Required parameter '%s' is missing", ex.getParameterName());
+
+        ErrorResponse errorResponse = ErrorResponse.builder()
+                .success(false)
+                .message(message)
+                .error(ErrorResponse.ErrorDetails.builder()
+                        .message(message)
+                        .code("VALIDATION_ERROR")
+                        .build())
+                .timestamp(Instant.now().toString())
+                .build();
+
+        return new ResponseEntity<>(errorResponse, HttpStatus.BAD_REQUEST);
+    }
+
     @ExceptionHandler(DatabaseOperationException.class)
     public ResponseEntity<ErrorResponse> handleDatabaseOperationException(
             DatabaseOperationException ex, WebRequest request) {
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
index 5f97db8..9d3ca30 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
@@ -61,4 +61,27 @@ public interface MovieService {
      * @return List of directors with their movie count and average rating
      */
     List<DirectorStatisticsResult> getDirectorsWithMostMovies(Integer limit);
+
+    // Atlas Search endpoints
+
+    /**
+     * Searches movies by plot using MongoDB Atlas Search.
+     * Demonstrates text search using Atlas Search Index.
+     *
+     * @param plotQuery Text to search in the plot field
+     * @param limit Maximum number of movies to return (default: 20, max: 100)
+     * @param skip Number of results to skip for pagination (default: 0)
+     * @return List of movies matching the search criteria
+     */
+    List<Movie> searchMoviesByPlot(String plotQuery, Integer limit, Integer skip);
+
+    /**
+     * Finds similar movies using vector search on plot embeddings.
+     * Demonstrates MongoDB Atlas Vector Search.
+     *
+     * @param movieId ID of the movie to find similar movies for
+     * @param limit Maximum number of similar movies to return (default: 10, max: 50)
+     * @return List of similar movies based on plot embeddings
+     */
+    List<Movie> findSimilarMovies(String movieId, Integer limit);
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 1955ccb..e37b38f 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -557,12 +557,160 @@ private MovieWithCommentsResult mapToMovieWithCommentsResult(Document doc) {
                 .build();
     }
 
+    // Atlas Search methods
+
+    @Override
+    public List<Movie> searchMoviesByPlot(String plotQuery, Integer limit, Integer skip) {
+        // Validate input
+        if (plotQuery == null || plotQuery.trim().isEmpty()) {
+            throw new ValidationException("Plot search query is required");
+        }
+
+        // Validate and set defaults for pagination
+        int resultLimit = Math.clamp(limit != null ? limit : 20, 1, 100);
+        int resultSkip = Math.max(skip != null ? skip : 0, 0);
+
+        // Build the $search aggregation stage using Document
+        // Spring Data MongoDB doesn't have native support for $search, so we use Document
+        Document searchStage = new Document("$search", new Document()
+                .append("index", "movieSearchIndex")
+                .append("phrase", new Document()
+                        .append("query", plotQuery.trim())
+                        .append("path", Movie.Fields.PLOT)
+                )
+        );
+
+        Document skipStage = new Document("$skip", resultSkip);
+        Document limitStage = new Document("$limit", resultLimit);
+
+        // Project only the fields needed in the response
+        Document projectStage = new Document("$project", new Document()
+                .append(Movie.Fields.ID, 1)
+                .append(Movie.Fields.TITLE, 1)
+                .append(Movie.Fields.YEAR, 1)
+                .append(Movie.Fields.PLOT, 1)
+                .append(Movie.Fields.FULLPLOT, 1)
+                .append(Movie.Fields.RELEASED, 1)
+                .append(Movie.Fields.RUNTIME, 1)
+                .append(Movie.Fields.POSTER, 1)
+                .append(Movie.Fields.GENRES, 1)
+                .append(Movie.Fields.DIRECTORS, 1)
+                .append(Movie.Fields.WRITERS, 1)
+                .append(Movie.Fields.CAST, 1)
+                .append(Movie.Fields.COUNTRIES, 1)
+                .append(Movie.Fields.LANGUAGES, 1)
+                .append(Movie.Fields.RATED, 1)
+                .append(Movie.Fields.AWARDS, 1)
+                .append(Movie.Fields.IMDB, 1)
+        );
+
+        // Execute the aggregation pipeline
+        // Use MongoTemplate's getCollection to run raw aggregation
+        // Spring Data MongoDB doesn't have native support for $search, so we use the MongoDB driver directly
+        try {
+            List<Document> aggregationPipeline = List.of(searchStage, skipStage, limitStage, projectStage);
+
+            return mongoTemplate.getCollection("movies")
+                    .aggregate(aggregationPipeline)
+                    .map(doc -> mongoTemplate.getConverter().read(Movie.class, doc))
+                    .into(new java.util.ArrayList<>());
+        } catch (Exception e) {
+            throw new DatabaseOperationException("Error performing Atlas Search: " + e.getMessage());
+        }
+    }
+
+    @Override
+    public List<Movie> findSimilarMovies(String movieId, Integer limit) {
+        // Validate movie ID
+        if (movieId == null || movieId.trim().isEmpty()) {
+            throw new ValidationException("Movie ID is required");
+        }
+
+        if (!ObjectId.isValid(movieId)) {
+            throw new ValidationException("Invalid movie ID format");
+        }
+
+        // Validate and set default limit
+        int resultLimit = Math.clamp(limit != null ? limit : 10, 1, 50);
+
+        // First, get the movie to retrieve its plot_embedding
+        ObjectId objectId = new ObjectId(movieId);
+        Document movie = mongoTemplate.getCollection("movies")
+                .find(new Document(Movie.Fields.ID, objectId))
+                .first();
+
+        if (movie == null) {
+            throw new ResourceNotFoundException("Movie not found");
+        }
+
+        // Check if plot_embedding exists
+        if (!movie.containsKey("plot_embedding")) {
+            throw new ValidationException("Movie does not have plot embeddings for vector search");
+        }
+
+        @SuppressWarnings("unchecked")
+        List<Double> plotEmbedding = (List<Double>) movie.get("plot_embedding");
+
+        // Build the $vectorSearch aggregation stage
+        // Note: This requires MongoDB Atlas with a vector search index configured
+        Document vectorSearchStage = new Document("$vectorSearch", new Document()
+                .append("index", "plotEmbeddingIndex")
+                .append("path", "plot_embedding")
+                .append("queryVector", plotEmbedding)
+                .append("numCandidates", resultLimit * 10)
+                .append("limit", resultLimit + 1) // +1 to exclude the source movie
+        );
+
+        // Filter out the source movie
+        Document matchStage = new Document("$match",
+                new Document(Movie.Fields.ID, new Document("$ne", objectId))
+        );
+
+        // Limit to final result count
+        Document limitStage = new Document("$limit", resultLimit);
+
+        // Project only the fields needed in the response
+        Document projectStage = new Document("$project", new Document()
+                .append(Movie.Fields.ID, 1)
+                .append(Movie.Fields.TITLE, 1)
+                .append(Movie.Fields.YEAR, 1)
+                .append(Movie.Fields.PLOT, 1)
+                .append(Movie.Fields.FULLPLOT, 1)
+                .append(Movie.Fields.RELEASED, 1)
+                .append(Movie.Fields.RUNTIME, 1)
+                .append(Movie.Fields.POSTER, 1)
+                .append(Movie.Fields.GENRES, 1)
+                .append(Movie.Fields.DIRECTORS, 1)
+                .append(Movie.Fields.WRITERS, 1)
+                .append(Movie.Fields.CAST, 1)
+                .append(Movie.Fields.COUNTRIES, 1)
+                .append(Movie.Fields.LANGUAGES, 1)
+                .append(Movie.Fields.RATED, 1)
+                .append(Movie.Fields.AWARDS, 1)
+                .append(Movie.Fields.IMDB, 1)
+                .append("score", new Document("$meta", "vectorSearchScore"))
+        );
+
+        // Execute the aggregation pipeline
+        try {
+            List<Document> aggregationPipeline = List.of(
+                    vectorSearchStage, matchStage, limitStage, projectStage
+            );
+
+            return mongoTemplate.getCollection("movies")
+                    .aggregate(aggregationPipeline)
+                    .map(doc -> mongoTemplate.getConverter().read(Movie.class, doc))
+                    .into(new java.util.ArrayList<>());
+        } catch (Exception e) {
+            throw new DatabaseOperationException("Error performing vector search: " + e.getMessage());
+        }
+    }
+
     // TODO: Add advanced query methods
     // - getMoviesByGenreStatistics() - Aggregation pipeline for genre statistics
     // - getTopRatedMovies(int limit) - Movies sorted by rating
     // - getMoviesByDecade(int decade) - Movies from a specific decade
     // - getDirectorFilmography(String director) - All movies by a director
     // - getActorFilmography(String actor) - All movies featuring an actor
-    // - searchSimilarMovies(String movieId) - Vector search on plot_embedding field
     // - getMovieRecommendations(String userId) - Personalized recommendations
 }
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
index 2ac237f..ae3c3cd 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
@@ -502,4 +502,97 @@ void testGetDirectorsWithMostMovies_WithLimit() throws Exception {
                 .andExpect(jsonPath("$.success").value(true))
                 .andExpect(jsonPath("$.data").isArray());
     }
+
+    // ==================== ATLAS SEARCH ENDPOINT TESTS ====================
+
+    @Test
+    @DisplayName("GET /api/movies/searchByPlot - Should search movies by plot successfully")
+    void testSearchMoviesByPlot_Success() throws Exception {
+        // Arrange
+        Movie movie1 = Movie.builder()
+                .id(new ObjectId())
+                .title("Space Adventure")
+                .year(2024)
+                .plot("An epic space adventure across the galaxy")
+                .genres(Arrays.asList("Sci-Fi", "Adventure"))
+                .build();
+
+        Movie movie2 = Movie.builder()
+                .id(new ObjectId())
+                .title("Space Quest")
+                .year(2023)
+                .plot("A thrilling space adventure to save humanity")
+                .genres(Arrays.asList("Sci-Fi", "Action"))
+                .build();
+
+        when(movieService.searchMoviesByPlot(eq("space adventure"), eq(20), eq(0)))
+                .thenReturn(Arrays.asList(movie1, movie2));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/searchByPlot")
+                        .param("plot", "space adventure"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray())
+                .andExpect(jsonPath("$.data", hasSize(2)))
+                .andExpect(jsonPath("$.data[0].title").value("Space Adventure"))
+                .andExpect(jsonPath("$.data[0].plot").value(containsString("space adventure")))
+                .andExpect(jsonPath("$.data[1].title").value("Space Quest"));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/searchByPlot - Should accept limit and skip parameters")
+    void testSearchMoviesByPlot_WithPagination() throws Exception {
+        // Arrange
+        when(movieService.searchMoviesByPlot(eq("adventure"), eq(10), eq(5)))
+                .thenReturn(Arrays.asList());
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/searchByPlot")
+                        .param("plot", "adventure")
+                        .param("limit", "10")
+                        .param("skip", "5"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray());
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/searchByPlot - Should return 400 when plot parameter is missing")
+    void testSearchMoviesByPlot_MissingPlotParameter() throws Exception {
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/searchByPlot"))
+                .andExpect(status().isBadRequest());
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/searchByPlot - Should return 400 for validation error")
+    void testSearchMoviesByPlot_ValidationError() throws Exception {
+        // Arrange
+        when(movieService.searchMoviesByPlot(anyString(), anyInt(), anyInt()))
+                .thenThrow(new ValidationException("Plot query cannot be empty"));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/searchByPlot")
+                        .param("plot", ""))
+                .andExpect(status().isBadRequest())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("VALIDATION_ERROR"));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/searchByPlot - Should return empty list when no matches found")
+    void testSearchMoviesByPlot_NoResults() throws Exception {
+        // Arrange
+        when(movieService.searchMoviesByPlot(eq("nonexistent"), eq(20), eq(0)))
+                .thenReturn(Arrays.asList());
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/searchByPlot")
+                        .param("plot", "nonexistent"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray())
+                .andExpect(jsonPath("$.data", hasSize(0)));
+    }
 }
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java
new file mode 100644
index 0000000..aea2155
--- /dev/null
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java
@@ -0,0 +1,316 @@
+package com.mongodb.samplemflix.integration;
+
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import com.mongodb.client.MongoCollection;
+import com.mongodb.samplemflix.model.Movie;
+import com.mongodb.samplemflix.service.MovieService;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import org.bson.Document;
+import org.junit.jupiter.api.AfterAll;
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.TestInstance;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.data.mongodb.core.MongoTemplate;
+import org.springframework.test.context.ActiveProfiles;
+
+/**
+ * Integration tests for Atlas Search functionality.
+ *
+ * <p>These tests verify the Atlas Search endpoints work correctly with a real MongoDB Atlas instance.
+ * The tests require:
+ * <ul>
+ *   <li>A MongoDB Atlas cluster (not local MongoDB)</li>
+ *   <li>MONGODB_URI environment variable pointing to Atlas</li>
+ *   <li>Atlas Search index creation and polling for readiness</li>
+ * </ul>
+ *
+ * <p>Note: These tests are disabled by default and should only be run against a test Atlas cluster.
+ * To enable, set the environment variable ENABLE_ATLAS_SEARCH_TESTS=true
+ */
+@SpringBootTest
+@TestInstance(TestInstance.Lifecycle.PER_CLASS)
+@ActiveProfiles("test")
+@DisplayName("Atlas Search Integration Tests")
+class AtlasSearchIntegrationTest {
+
+    @Autowired
+    private MovieService movieService;
+
+    @Autowired
+    private MongoTemplate mongoTemplate;
+
+    private static final String TEST_COLLECTION = "movies_search_test";
+    private static final String SEARCH_INDEX_NAME = "movieSearchIndex";
+    private static final int MAX_INDEX_WAIT_SECONDS = 120;
+    private static final int POLL_INTERVAL_SECONDS = 5;
+
+    private List<String> testMovieIds = new ArrayList<>();
+
+    @BeforeAll
+    void setUp() throws Exception {
+        // Skip tests if not running against Atlas
+        if (!isAtlasSearchEnabled()) {
+            System.out.println("Skipping Atlas Search tests - ENABLE_ATLAS_SEARCH_TESTS not set");
+            return;
+        }
+
+        System.out.println("Setting up Atlas Search integration tests...");
+
+        // Create test data
+        createTestMovies();
+
+        // Create Atlas Search index
+        createSearchIndex();
+
+        // Wait for index to be ready
+        waitForSearchIndexReady();
+
+        // Wait a bit for the newly created documents to be indexed
+        // Atlas Search indexes documents asynchronously
+        System.out.println("Waiting for test documents to be indexed...");
+        try {
+            Thread.sleep(5000); // Wait 5 seconds for indexing
+        } catch (InterruptedException e) {
+            Thread.currentThread().interrupt();
+        }
+
+        System.out.println("Atlas Search index is ready for testing");
+    }
+
+    @AfterAll
+    void tearDown() {
+        if (!isAtlasSearchEnabled()) {
+            return;
+        }
+
+        System.out.println("Cleaning up Atlas Search test data...");
+
+        // Clean up test movies
+        if (!testMovieIds.isEmpty()) {
+            MongoCollection<Document> collection = mongoTemplate.getCollection("movies");
+            testMovieIds.forEach(id -> {
+                collection.deleteOne(new Document("_id", new org.bson.types.ObjectId(id)));
+            });
+        }
+
+        // Note: We don't delete the search index as it may be used by other tests
+        // and takes time to recreate
+    }
+
+    @Test
+    @DisplayName("Should search movies by plot using Atlas Search")
+    void testSearchMoviesByPlot_Success() {
+        if (!isAtlasSearchEnabled()) {
+            System.out.println("Skipping test - Atlas Search not enabled");
+            return;
+        }
+
+        // Act
+        List<Movie> results = movieService.searchMoviesByPlot("space adventure", 10, 0);
+
+        // Assert
+        assertNotNull(results, "Search results should not be null");
+        assertFalse(results.isEmpty(), "Should find at least one movie with 'space adventure' in plot");
+
+        // Verify the results contain our test movie
+        boolean foundTestMovie = results.stream()
+                .anyMatch(movie -> movie.getPlot() != null &&
+                         movie.getPlot().contains("space adventure"));
+        assertTrue(foundTestMovie, "Results should contain movie with 'space adventure' in plot");
+    }
+
+    @Test
+    @DisplayName("Should return empty list when no movies match search query")
+    void testSearchMoviesByPlot_NoResults() {
+        if (!isAtlasSearchEnabled()) {
+            System.out.println("Skipping test - Atlas Search not enabled");
+            return;
+        }
+
+        // Act - search for something that definitely doesn't exist
+        List<Movie> results = movieService.searchMoviesByPlot("xyzabc123nonexistent", 10, 0);
+
+        // Assert
+        assertNotNull(results, "Search results should not be null");
+        assertTrue(results.isEmpty(), "Should return empty list when no matches found");
+    }
+
+    @Test
+    @DisplayName("Should respect limit parameter in search")
+    void testSearchMoviesByPlot_WithLimit() {
+        if (!isAtlasSearchEnabled()) {
+            System.out.println("Skipping test - Atlas Search not enabled");
+            return;
+        }
+
+        // Act
+        List<Movie> results = movieService.searchMoviesByPlot("adventure", 2, 0);
+
+        // Assert
+        assertNotNull(results, "Search results should not be null");
+        assertTrue(results.size() <= 2, "Should respect limit parameter");
+    }
+
+    @Test
+    @DisplayName("Should support pagination with skip parameter")
+    void testSearchMoviesByPlot_WithPagination() {
+        if (!isAtlasSearchEnabled()) {
+            System.out.println("Skipping test - Atlas Search not enabled");
+            return;
+        }
+
+        // Act - Get first page
+        List<Movie> firstPage = movieService.searchMoviesByPlot("adventure", 2, 0);
+        
+        // Act - Get second page
+        List<Movie> secondPage = movieService.searchMoviesByPlot("adventure", 2, 2);
+
+        // Assert
+        assertNotNull(firstPage, "First page should not be null");
+        assertNotNull(secondPage, "Second page should not be null");
+
+        // If we have enough results, verify pagination works
+        if (firstPage.size() == 2 && !secondPage.isEmpty()) {
+            // Verify different results on different pages
+            String firstPageFirstId = firstPage.get(0).getId().toHexString();
+            boolean isDifferent = secondPage.stream()
+                    .noneMatch(movie -> movie.getId().toHexString().equals(firstPageFirstId));
+            assertTrue(isDifferent, "Second page should contain different results");
+        }
+    }
+
+    // ==================== HELPER METHODS ====================
+
+    private boolean isAtlasSearchEnabled() {
+        String enabled = System.getenv("ENABLE_ATLAS_SEARCH_TESTS");
+        return "true".equalsIgnoreCase(enabled);
+    }
+
+    private void createTestMovies() {
+        System.out.println("Creating test movies...");
+
+        MongoCollection<Document> collection = mongoTemplate.getCollection("movies");
+
+        List<Document> testMovies = Arrays.asList(
+                new Document()
+                        .append("title", "Test Space Adventure")
+                        .append("year", 2024)
+                        .append("plot", "An epic space adventure across the galaxy")
+                        .append("genres", Arrays.asList("Sci-Fi", "Adventure")),
+                new Document()
+                        .append("title", "Test Mystery Movie")
+                        .append("year", 2024)
+                        .append("plot", "A detective solves a mysterious crime")
+                        .append("genres", Arrays.asList("Mystery", "Thriller")),
+                new Document()
+                        .append("title", "Test Adventure Quest")
+                        .append("year", 2024)
+                        .append("plot", "Heroes embark on a dangerous adventure")
+                        .append("genres", Arrays.asList("Adventure", "Fantasy"))
+        );
+
+        testMovies.forEach(movie -> {
+            collection.insertOne(movie);
+            testMovieIds.add(movie.getObjectId("_id").toHexString());
+        });
+
+        System.out.println("Created " + testMovieIds.size() + " test movies");
+    }
+
+    private void createSearchIndex() throws Exception {
+        System.out.println("Creating Atlas Search index...");
+
+        MongoCollection<Document> collection = mongoTemplate.getCollection("movies");
+
+        // Check if index already exists
+        List<Document> existingIndexes = new ArrayList<>();
+        collection.listSearchIndexes().into(existingIndexes);
+
+        boolean indexExists = existingIndexes.stream()
+                .anyMatch(idx -> SEARCH_INDEX_NAME.equals(idx.getString("name")));
+
+        if (indexExists) {
+            System.out.println("Search index already exists");
+            return;
+        }
+
+        // Create the search index definition
+        Document indexDefinition = new Document("mappings", new Document()
+                .append("dynamic", false)
+                .append("fields", new Document()
+                        .append("plot", new Document()
+                                .append("type", "string")
+                                .append("analyzer", "lucene.standard"))
+                        .append("fullplot", new Document()
+                                .append("type", "string")
+                                .append("analyzer", "lucene.standard"))
+                        .append("directors", new Document()
+                                .append("type", "string")
+                                .append("analyzer", "lucene.standard"))
+                        .append("writers", new Document()
+                                .append("type", "string")
+                                .append("analyzer", "lucene.standard"))
+                        .append("cast", new Document()
+                                .append("type", "string")
+                                .append("analyzer", "lucene.standard"))
+                )
+        );
+
+        // Create the index using the createSearchIndexes command
+        Document createIndexCommand = new Document("createSearchIndexes", "movies")
+                .append("indexes", Arrays.asList(
+                        new Document("name", SEARCH_INDEX_NAME)
+                                .append("definition", indexDefinition)
+                ));
+
+        try {
+            mongoTemplate.getDb().runCommand(createIndexCommand);
+            System.out.println("Search index creation initiated");
+        } catch (Exception e) {
+            System.err.println("Error creating search index: " + e.getMessage());
+            throw e;
+        }
+    }
+
+    private void waitForSearchIndexReady() throws Exception {
+        System.out.println("Waiting for search index to be ready...");
+
+        MongoCollection<Document> collection = mongoTemplate.getCollection("movies");
+        long startTime = System.currentTimeMillis();
+        long maxWaitMillis = MAX_INDEX_WAIT_SECONDS * 1000L;
+
+        while (System.currentTimeMillis() - startTime < maxWaitMillis) {
+            List<Document> indexes = new ArrayList<>();
+            collection.listSearchIndexes().into(indexes);
+
+            Document searchIndex = indexes.stream()
+                    .filter(idx -> SEARCH_INDEX_NAME.equals(idx.getString("name")))
+                    .findFirst()
+                    .orElse(null);
+
+            if (searchIndex != null) {
+                String status = searchIndex.getString("status");
+                System.out.println("Index status: " + status);
+
+                if ("READY".equals(status)) {
+                    System.out.println("Search index is ready!");
+                    return;
+                }
+            }
+
+            // Wait before polling again
+            Thread.sleep(POLL_INTERVAL_SECONDS * 1000L);
+        }
+
+        throw new RuntimeException("Search index did not become ready within " + 
+                                   MAX_INDEX_WAIT_SECONDS + " seconds");
+    }
+}
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
new file mode 100644
index 0000000..333f67a
--- /dev/null
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
@@ -0,0 +1,134 @@
+# Atlas Search Integration Tests
+
+This directory contains integration tests for MongoDB Atlas Search functionality.
+
+## Overview
+
+The `AtlasSearchIntegrationTest` class tests the Atlas Search endpoints with a real MongoDB Atlas instance. These tests verify that:
+
+1. The Atlas Search index is created correctly
+2. The index becomes ready for use (using polling)
+3. The `searchByPlot` endpoint returns correct results
+4. Pagination works correctly
+5. Empty results are handled properly
+
+## Requirements
+
+These tests require:
+
+- **MongoDB Atlas cluster** (not local MongoDB or Testcontainers)
+- **Atlas Search capability** enabled on the cluster
+- **MONGODB_URI** environment variable pointing to your Atlas cluster
+- **ENABLE_ATLAS_SEARCH_TESTS=true** environment variable to enable the tests
+
+## Running the Tests
+
+### Enable the Tests
+
+By default, these tests are **disabled** to prevent accidental runs against production databases. To enable them:
+
+```bash
+export ENABLE_ATLAS_SEARCH_TESTS=true
+```
+
+### Set MongoDB URI
+
+Make sure your `MONGODB_URI` environment variable points to a MongoDB Atlas cluster:
+
+```bash
+export MONGODB_URI="mongodb+srv://username:password@cluster.mongodb.net/sample_mflix?retryWrites=true&w=majority"
+```
+
+Or use a `.env` file in the `server/java-spring` directory:
+
+```
+MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/sample_mflix?retryWrites=true&w=majority
+```
+
+### Run the Tests
+
+```bash
+# Run all integration tests
+./mvnw test -Dtest=AtlasSearchIntegrationTest
+
+# Run a specific test
+./mvnw test -Dtest=AtlasSearchIntegrationTest#testSearchMoviesByPlot_Success
+```
+
+## How the Tests Work
+
+### 1. Index Creation and Polling
+
+The tests use a `@BeforeAll` method to:
+
+1. Check if the `movieSearchIndex` already exists
+2. If not, create it with the proper field mappings
+3. Poll the index status every 5 seconds until it's "READY"
+4. Wait up to 120 seconds (2 minutes) for the index to be ready
+5. Throw an exception if the index doesn't become ready in time
+
+### 2. Test Data Setup
+
+The tests create temporary test movies with known plot content:
+
+- "An epic space adventure across the galaxy"
+- "A detective solves a mysterious crime"
+- "Heroes embark on a dangerous adventure"
+
+These movies are used to verify search functionality.
+
+### 3. Test Cleanup
+
+The `@AfterAll` method removes the test movies after all tests complete. The search index is **not** deleted because:
+
+- It may be used by other tests
+- It takes time to recreate
+- It's safe to leave in the database
+
+## Test Cases
+
+### testSearchMoviesByPlot_Success
+Verifies that searching for "space adventure" returns movies with that phrase in the plot.
+
+### testSearchMoviesByPlot_NoResults
+Verifies that searching for a non-existent phrase returns an empty list.
+
+### testSearchMoviesByPlot_WithLimit
+Verifies that the `limit` parameter correctly limits the number of results.
+
+### testSearchMoviesByPlot_WithPagination
+Verifies that the `skip` parameter works for pagination and returns different results on different pages.
+
+## Troubleshooting
+
+### Tests are Skipped
+
+If you see "Skipping Atlas Search tests - ENABLE_ATLAS_SEARCH_TESTS not set", make sure you've set the environment variable:
+
+```bash
+export ENABLE_ATLAS_SEARCH_TESTS=true
+```
+
+### Index Creation Timeout
+
+If the tests fail with "Search index did not become ready within 120 seconds":
+
+1. Check that your cluster has Atlas Search enabled
+2. Verify you're using a MongoDB Atlas cluster (not local MongoDB)
+3. Check the Atlas UI to see if the index is being created
+4. Increase `MAX_INDEX_WAIT_SECONDS` if needed
+
+### Connection Errors
+
+If you get connection errors:
+
+1. Verify your `MONGODB_URI` is correct
+2. Check that your IP address is whitelisted in Atlas
+3. Verify your database user credentials are correct
+
+## Notes
+
+- These tests use `@TestInstance(TestInstance.Lifecycle.PER_CLASS)` to allow `@BeforeAll` and `@AfterAll` methods to be non-static
+- The tests use `@ActiveProfiles("test")` to load test-specific configuration from `application-test.properties`
+- The search index is shared across all tests in the class
+- Test movies are created once and cleaned up after all tests complete
diff --git a/server/java-spring/src/test/resources/application-test.properties b/server/java-spring/src/test/resources/application-test.properties
new file mode 100644
index 0000000..1b2669c
--- /dev/null
+++ b/server/java-spring/src/test/resources/application-test.properties
@@ -0,0 +1,23 @@
+# Test Configuration for MongoDB Atlas Search Integration Tests
+# This configuration is used when running integration tests with @ActiveProfiles("test")
+
+# MongoDB Configuration
+# For Atlas Search tests, use the same MONGODB_URI as the main application
+# This should point to a MongoDB Atlas cluster (not local MongoDB)
+spring.data.mongodb.uri=${MONGODB_URI}
+spring.data.mongodb.database=sample_mflix
+
+# Server Configuration
+# Use a different port for tests to avoid conflicts
+server.port=0
+
+# Logging Configuration
+# More verbose logging for tests
+logging.level.com.mongodb.samplemflix=DEBUG
+logging.level.org.mongodb.driver=INFO
+logging.level.org.springframework.data.mongodb=DEBUG
+
+# Test-specific settings
+# Disable some startup checks that may not be needed in tests
+spring.main.lazy-initialization=false
+

From d6672d3c828d2935644b7bbc19d1491c3407410a Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Fri, 31 Oct 2025 12:52:56 -0400
Subject: [PATCH 038/110] update search to cover all query parameters

---
 server/java-spring/README.md                  |  72 +++++++++--
 .../controller/MovieControllerImpl.java       |  66 ++++++++---
 .../model/dto/MovieSearchRequest.java         |  89 ++++++++++++++
 .../model/dto/UpdateMovieRequest.java         |   2 +-
 .../samplemflix/service/MovieService.java     |  20 ++++
 .../samplemflix/service/MovieServiceImpl.java | 112 +++++++++++++++---
 .../controller/MovieControllerTest.java       | 103 +++++++++++++---
 .../AtlasSearchIntegrationTest.java           |   3 +-
 .../integration/MovieIntegrationTest.java     |   2 +-
 .../mongodb/samplemflix/integration/README.md |   2 +-
 10 files changed, 410 insertions(+), 61 deletions(-)
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchRequest.java

diff --git a/server/java-spring/README.md b/server/java-spring/README.md
index 90b020f..3bd4345 100644
--- a/server/java-spring/README.md
+++ b/server/java-spring/README.md
@@ -8,11 +8,11 @@ This application provides a REST API for managing movie data from MongoDB's samp
 
 - Spring Data MongoDB for simplified data access
 - CRUD operations (Create, Read, Update, Delete)
-- Text search functionality
+- MongoDB Atlas Search with multi-field search and compound operators
 - Filtering, sorting, and pagination
 - Comprehensive error handling
 - API documentation with Swagger/OpenAPI
-- MongoTemplate for complex queries
+- MongoTemplate for complex queries and aggregation pipelines
 
 ## Prerequisites
 
@@ -104,16 +104,59 @@ Once the application is running, you can access:
 
 ### Movies (✅ Implemented)
 
+#### CRUD Operations
 - `GET /api/movies` - Get all movies (with filtering, sorting, pagination)
 - `GET /api/movies/{id}` - Get a single movie by ID
 - `POST /api/movies` - Create a new movie
 - `POST /api/movies/batch` - Create multiple movies
-- `PUT /api/movies/{id}` - Update a movie
+- `PATCH /api/movies/{id}` - Update a movie (partial update)
 - `PATCH /api/movies` - Update multiple movies
 - `DELETE /api/movies/{id}` - Delete a movie
 - `DELETE /api/movies` - Delete multiple movies
 - `DELETE /api/movies/{id}/find-and-delete` - Find and delete a movie
 
+#### Aggregations
+- `GET /api/movies/aggregations/comments` - Get movies with most comments
+- `GET /api/movies/aggregations/years` - Aggregate movies by year with statistics
+- `GET /api/movies/aggregations/directors` - Aggregate directors with most movies
+
+#### Atlas Search
+- `GET /api/movies/search` - Search movies using MongoDB Atlas Search
+
+  **Query Parameters:**
+  - `plot` (optional) - Search in plot field using phrase matching
+  - `fullplot` (optional) - Search in fullplot field using phrase matching
+  - `directors` (optional) - Search in directors field with fuzzy matching
+  - `writers` (optional) - Search in writers field with fuzzy matching
+  - `cast` (optional) - Search in cast field with fuzzy matching
+  - `searchOperator` (optional) - Compound operator: `must` (default), `should`, `mustNot`, `filter`
+  - `limit` (optional) - Maximum results to return (default: 20, max: 100)
+  - `skip` (optional) - Number of results to skip for pagination (default: 0)
+
+  **Examples:**
+  ```bash
+  # Search by plot
+  GET /api/movies/search?plot=space+adventure
+
+  # Search by multiple fields with AND logic
+  GET /api/movies/search?directors=Coppola&cast=Pacino&searchOperator=must
+
+  # Search by multiple fields with OR logic
+  GET /api/movies/search?plot=crime&directors=Scorsese&searchOperator=should
+
+  # Search with pagination
+  GET /api/movies/search?cast=Tom+Hanks&limit=10&skip=20
+  ```
+
+  **Note:** At least one search field must be provided. The `searchOperator` determines how multiple search criteria are combined:
+  - `must` - All criteria must match (AND logic)
+  - `should` - At least one criterion should match (OR logic)
+  - `mustNot` - Criteria must not match (NOT logic)
+  - `filter` - Criteria must match but don't affect scoring
+
+#### Vector Search
+- `GET /api/movies/findSimilarMovies` - Find similar movies using vector search on plot embeddings
+
 ## Development
 
 ### Running Tests
@@ -139,11 +182,19 @@ java -jar target/sample-mflix-spring-1.0.0.jar
 
 - **Movies CRUD API** - Full create, read, update, delete operations
 - **Spring Data MongoDB** - Repository pattern with MongoTemplate for complex queries
-- **Text Search** - Full-text search on movie titles, plots, and genres
+- **MongoDB Atlas Search** - Multi-field search with compound operators (must, should, mustNot, filter)
+  - Phrase matching on plot and fullplot fields
+  - Fuzzy text matching on directors, writers, and cast fields
+  - Support for complex search queries with multiple criteria
+- **MongoDB Aggregations** - Statistical aggregations by year, directors, and comments
+- **Vector Search** - Find similar movies using plot embeddings (requires Atlas Vector Search)
 - **Filtering & Pagination** - Query parameters for filtering, sorting, and pagination
 - **Custom Exception Handling** - Global exception handler with proper HTTP status codes
 - **Type-Safe DTOs** - Specific response types instead of generic Maps
-- **Unit Tests** - 35 tests covering service and controller layers
+- **Comprehensive Testing** - 60 tests covering service, controller, and integration layers
+  - 29 controller unit tests
+  - 27 service unit tests
+  - 4 Atlas Search integration tests (requires Atlas cluster)
 - **OpenAPI Documentation** - Swagger UI available at `/swagger-ui.html`
 - **Database Verification** - Startup checks for database connectivity and indexes
 
@@ -165,8 +216,15 @@ This application is designed as an educational sample to demonstrate:
 2. Best practices for Spring Boot REST API development
 3. Proper separation of concerns (Controller → Service → Repository)
 4. MongoDB CRUD operations and query patterns
-5. Error handling and validation in Spring Boot
-6. Using MongoTemplate for complex queries alongside Spring Data repositories
+5. **MongoDB Atlas Search** - Multi-field text search with compound operators
+   - Phrase matching for exact phrase searches
+   - Fuzzy text matching for typo-tolerant searches
+   - Compound operators (must, should, mustNot, filter) for complex queries
+6. **MongoDB Aggregation Pipelines** - Statistical aggregations and data transformations
+7. **Vector Search** - Semantic similarity search using embeddings
+8. Error handling and validation in Spring Boot
+9. Using MongoTemplate for complex queries alongside Spring Data repositories
+10. Comprehensive testing strategies (unit tests, integration tests)
 
 ## Troubleshooting
 
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index 2b5d42c..736e096 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -30,7 +30,7 @@
  * - GET /api/movies/{id} - Get a single movie by ID
  * - POST /api/movies - Create a new movie
  * - POST /api/movies/batch - Create multiple movies
- * - PUT /api/movies/{id} - Update a movie
+ * - PATCH /api/movies/{id} - Update a movie
  * - PATCH /api/movies - Update multiple movies
  * - DELETE /api/movies/{id} - Delete a movie
  * - DELETE /api/movies - Delete multiple movies
@@ -38,7 +38,7 @@
  * - GET /api/movies/aggregations/comments - Aggregate movies with most comments
  * - GET /api/movies/aggregations/years - Aggregate movies by year with statistics
  * - GET /api/movies/aggregations/directors - Aggregate directors with most movies
- * - GET /api/movies/searchByPlot - Text search using Atlas Search Index based on plot
+ * - GET /api/movies/search - Text search using Atlas Search Index across multiple fields (plot, fullplot, directors, writers, cast)
  * - GET /api/movies/findSimilarMovies - Vector search to find similar movies based on plot embeddings
  * </pre>
  */
@@ -152,23 +152,24 @@ public ResponseEntity<SuccessResponse<BatchInsertResponse>> createMoviesBatch(
     }
     
     /**
-     * PUT /api/movies/{id}
+     * PATCH /api/movies/{id}
      *
-     * <p>Updates a single movie document.
+     * <p>Updates a single movie document with partial updates.
+     * Only the fields provided in the request will be updated.
      */
-    @PutMapping("/{id}")
+    @PatchMapping("/{id}")
     public ResponseEntity<SuccessResponse<Movie>> updateMovie(
             @PathVariable String id,
             @RequestBody UpdateMovieRequest request) {
         Movie movie = movieService.updateMovie(id, request);
-        
+
         SuccessResponse<Movie> response = SuccessResponse.<Movie>builder()
                 .success(true)
                 .message("Movie updated successfully")
                 .data(movie)
                 .timestamp(Instant.now().toString())
                 .build();
-        
+
         return ResponseEntity.ok(response);
     }
     
@@ -351,23 +352,56 @@ public ResponseEntity<SuccessResponse<List<DirectorStatisticsResult>>> getDirect
     // Atlas Search endpoints
 
     /**
-     * GET /api/movies/searchByPlot
+     * GET /api/movies/search
+     *
+     * <p>Searches movies using MongoDB Atlas Search across multiple fields.
+     * Demonstrates text search using Atlas Search Index with compound operators.
      *
-     * <p>Searches movies by plot using MongoDB Atlas Search.
-     * Demonstrates text search using Atlas Search Index based on plot field.
+     * <p>Supports searching across:
+     * <ul>
+     * <li>plot - using phrase operator for exact phrase matching</li>
+     * <li>fullplot - using phrase operator for exact phrase matching</li>
+     * <li>directors - using text operator with fuzzy matching</li>
+     * <li>writers - using text operator with fuzzy matching</li>
+     * <li>cast - using text operator with fuzzy matching</li>
+     * </ul>
      *
-     * @param plot Text to search in the plot field (required)
+     * <p>At least one search field must be provided.
+     *
+     * @param plot Text to search in the plot field (optional)
+     * @param fullplot Text to search in the fullplot field (optional)
+     * @param directors Text to search in the directors field (optional)
+     * @param writers Text to search in the writers field (optional)
+     * @param cast Text to search in the cast field (optional)
      * @param limit Maximum number of movies to return (default: 20, max: 100)
      * @param skip Number of results to skip for pagination (default: 0)
+     * @param searchOperator Compound operator: must, should, mustNot, filter (default: must)
      * @return List of movies matching the search criteria
      */
-    @GetMapping("/searchByPlot")
-    public ResponseEntity<SuccessResponse<List<Movie>>> searchMoviesByPlot(
-            @RequestParam String plot,
+    @GetMapping("/search")
+    public ResponseEntity<SuccessResponse<List<Movie>>> searchMovies(
+            @RequestParam(required = false) String plot,
+            @RequestParam(required = false) String fullplot,
+            @RequestParam(required = false) String directors,
+            @RequestParam(required = false) String writers,
+            @RequestParam(required = false) String cast,
             @RequestParam(defaultValue = "20") Integer limit,
-            @RequestParam(defaultValue = "0") Integer skip) {
+            @RequestParam(defaultValue = "0") Integer skip,
+            @RequestParam(defaultValue = "must") String searchOperator) {
+
+        com.mongodb.samplemflix.model.dto.MovieSearchRequest searchRequest =
+            com.mongodb.samplemflix.model.dto.MovieSearchRequest.builder()
+                .plot(plot)
+                .fullplot(fullplot)
+                .directors(directors)
+                .writers(writers)
+                .cast(cast)
+                .limit(limit)
+                .skip(skip)
+                .searchOperator(searchOperator)
+                .build();
 
-        List<Movie> movies = movieService.searchMoviesByPlot(plot, limit, skip);
+        List<Movie> movies = movieService.searchMovies(searchRequest);
 
         SuccessResponse<List<Movie>> response = SuccessResponse.<List<Movie>>builder()
                 .success(true)
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchRequest.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchRequest.java
new file mode 100644
index 0000000..4d4c56f
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchRequest.java
@@ -0,0 +1,89 @@
+package com.mongodb.samplemflix.model.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Data Transfer Object for Atlas Search query parameters.
+ *
+ * <p>This DTO is used to parse and validate query parameters for GET /api/movies/search requests.
+ * It supports searching across multiple fields using MongoDB Atlas Search with compound operators.
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MovieSearchRequest {
+    
+    /**
+     * Search query for the plot field.
+     * Uses phrase operator for exact phrase matching.
+     */
+    private String plot;
+    
+    /**
+     * Search query for the fullplot field.
+     * Uses phrase operator for exact phrase matching.
+     */
+    private String fullplot;
+    
+    /**
+     * Search query for the directors field.
+     * Uses text operator with fuzzy matching (maxEdits=1, prefixLength=5).
+     */
+    private String directors;
+    
+    /**
+     * Search query for the writers field.
+     * Uses text operator with fuzzy matching (maxEdits=1, prefixLength=5).
+     */
+    private String writers;
+    
+    /**
+     * Search query for the cast field.
+     * Uses text operator with fuzzy matching (maxEdits=1, prefixLength=5).
+     */
+    private String cast;
+    
+    /**
+     * Maximum number of results to return.
+     * Default: 20, Range: 1-100
+     */
+    private Integer limit;
+    
+    /**
+     * Number of results to skip for pagination.
+     * Default: 0, Minimum: 0
+     */
+    private Integer skip;
+    
+    /**
+     * Compound search operator to use.
+     * Valid values: "must", "should", "mustNot", "filter"
+     * Default: "must"
+     * 
+     * <ul>
+     * <li><b>must</b> - All clauses must match (AND logic)</li>
+     * <li><b>should</b> - At least one clause should match (OR logic)</li>
+     * <li><b>mustNot</b> - Clauses must not match (NOT logic)</li>
+     * <li><b>filter</b> - Clauses must match but don't affect scoring</li>
+     * </ul>
+     */
+    private String searchOperator;
+    
+    /**
+     * Checks if at least one search field is provided.
+     * 
+     * @return true if at least one search field has a value
+     */
+    public boolean hasSearchFields() {
+        return (plot != null && !plot.trim().isEmpty()) ||
+               (fullplot != null && !fullplot.trim().isEmpty()) ||
+               (directors != null && !directors.trim().isEmpty()) ||
+               (writers != null && !writers.trim().isEmpty()) ||
+               (cast != null && !cast.trim().isEmpty());
+    }
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
index f855276..f3a674f 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
@@ -9,7 +9,7 @@
 /**
  * Data Transfer Object for updating an existing movie.
  *
- * <p>This DTO is used for PUT /api/movies/{id} requests.
+ * <p>This DTO is used for PATCH /api/movies/{id} requests.
  * All fields are optional since partial updates are allowed.
  * Any field that is null will not be updated in the database.
  */
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
index 9d3ca30..69fd882 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
@@ -64,15 +64,35 @@ public interface MovieService {
 
     // Atlas Search endpoints
 
+    /**
+     * Searches movies using MongoDB Atlas Search across multiple fields.
+     * Demonstrates text search using Atlas Search Index with compound operators.
+     *
+     * <p>Supports searching across:
+     * <ul>
+     * <li>plot - using phrase operator for exact phrase matching</li>
+     * <li>fullplot - using phrase operator for exact phrase matching</li>
+     * <li>directors - using text operator with fuzzy matching</li>
+     * <li>writers - using text operator with fuzzy matching</li>
+     * <li>cast - using text operator with fuzzy matching</li>
+     * </ul>
+     *
+     * @param searchRequest Search parameters including fields to search and compound operator
+     * @return List of movies matching the search criteria
+     */
+    List<Movie> searchMovies(com.mongodb.samplemflix.model.dto.MovieSearchRequest searchRequest);
+
     /**
      * Searches movies by plot using MongoDB Atlas Search.
      * Demonstrates text search using Atlas Search Index.
      *
+     * @deprecated Use {@link #searchMovies(com.mongodb.samplemflix.model.dto.MovieSearchRequest)} instead
      * @param plotQuery Text to search in the plot field
      * @param limit Maximum number of movies to return (default: 20, max: 100)
      * @param skip Number of results to skip for pagination (default: 0)
      * @return List of movies matching the search criteria
      */
+    @Deprecated
     List<Movie> searchMoviesByPlot(String plotQuery, Integer limit, Integer skip);
 
     /**
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index e37b38f..046e269 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -560,24 +560,91 @@ private MovieWithCommentsResult mapToMovieWithCommentsResult(Document doc) {
     // Atlas Search methods
 
     @Override
-    public List<Movie> searchMoviesByPlot(String plotQuery, Integer limit, Integer skip) {
-        // Validate input
-        if (plotQuery == null || plotQuery.trim().isEmpty()) {
-            throw new ValidationException("Plot search query is required");
+    public List<Movie> searchMovies(com.mongodb.samplemflix.model.dto.MovieSearchRequest searchRequest) {
+        // Validate that at least one search field is provided
+        if (!searchRequest.hasSearchFields()) {
+            throw new ValidationException("At least one search parameter must be provided");
+        }
+
+        // Validate search operator
+        String operator = searchRequest.getSearchOperator() != null ?
+                searchRequest.getSearchOperator() : "must";
+
+        if (!operator.equals("must") && !operator.equals("should") &&
+            !operator.equals("mustNot") && !operator.equals("filter")) {
+            throw new ValidationException(
+                "Invalid search_operator '" + operator + "'. " +
+                "The search_operator must be one of: must, should, mustNot, filter"
+            );
         }
 
         // Validate and set defaults for pagination
-        int resultLimit = Math.clamp(limit != null ? limit : 20, 1, 100);
-        int resultSkip = Math.max(skip != null ? skip : 0, 0);
+        int resultLimit = Math.clamp(
+            searchRequest.getLimit() != null ? searchRequest.getLimit() : 20, 1, 100
+        );
+        int resultSkip = Math.max(
+            searchRequest.getSkip() != null ? searchRequest.getSkip() : 0, 0
+        );
+
+        // Build search phrases list
+        java.util.List<Document> searchPhrases = new java.util.ArrayList<>();
+
+        // Add plot search if provided (using phrase operator)
+        if (searchRequest.getPlot() != null && !searchRequest.getPlot().trim().isEmpty()) {
+            searchPhrases.add(new Document("phrase", new Document()
+                    .append("query", searchRequest.getPlot().trim())
+                    .append("path", Movie.Fields.PLOT)
+            ));
+        }
+
+        // Add fullplot search if provided (using phrase operator)
+        if (searchRequest.getFullplot() != null && !searchRequest.getFullplot().trim().isEmpty()) {
+            searchPhrases.add(new Document("phrase", new Document()
+                    .append("query", searchRequest.getFullplot().trim())
+                    .append("path", Movie.Fields.FULLPLOT)
+            ));
+        }
 
-        // Build the $search aggregation stage using Document
-        // Spring Data MongoDB doesn't have native support for $search, so we use Document
+        // Add directors search if provided (using text operator with fuzzy matching)
+        if (searchRequest.getDirectors() != null && !searchRequest.getDirectors().trim().isEmpty()) {
+            searchPhrases.add(new Document("text", new Document()
+                    .append("query", searchRequest.getDirectors().trim())
+                    .append("path", Movie.Fields.DIRECTORS)
+                    .append("fuzzy", new Document()
+                            .append("maxEdits", 1)
+                            .append("prefixLength", 5)
+                    )
+            ));
+        }
+
+        // Add writers search if provided (using text operator with fuzzy matching)
+        if (searchRequest.getWriters() != null && !searchRequest.getWriters().trim().isEmpty()) {
+            searchPhrases.add(new Document("text", new Document()
+                    .append("query", searchRequest.getWriters().trim())
+                    .append("path", Movie.Fields.WRITERS)
+                    .append("fuzzy", new Document()
+                            .append("maxEdits", 1)
+                            .append("prefixLength", 5)
+                    )
+            ));
+        }
+
+        // Add cast search if provided (using text operator with fuzzy matching)
+        if (searchRequest.getCast() != null && !searchRequest.getCast().trim().isEmpty()) {
+            searchPhrases.add(new Document("text", new Document()
+                    .append("query", searchRequest.getCast().trim())
+                    .append("path", Movie.Fields.CAST)
+                    .append("fuzzy", new Document()
+                            .append("maxEdits", 1)
+                            .append("prefixLength", 5)
+                    )
+            ));
+        }
+
+        // Build the $search aggregation stage with compound operator
         Document searchStage = new Document("$search", new Document()
                 .append("index", "movieSearchIndex")
-                .append("phrase", new Document()
-                        .append("query", plotQuery.trim())
-                        .append("path", Movie.Fields.PLOT)
-                )
+                .append("compound", new Document(operator, searchPhrases))
         );
 
         Document skipStage = new Document("$skip", resultSkip);
@@ -605,10 +672,10 @@ public List<Movie> searchMoviesByPlot(String plotQuery, Integer limit, Integer s
         );
 
         // Execute the aggregation pipeline
-        // Use MongoTemplate's getCollection to run raw aggregation
-        // Spring Data MongoDB doesn't have native support for $search, so we use the MongoDB driver directly
         try {
-            List<Document> aggregationPipeline = List.of(searchStage, skipStage, limitStage, projectStage);
+            java.util.List<Document> aggregationPipeline = java.util.List.of(
+                searchStage, skipStage, limitStage, projectStage
+            );
 
             return mongoTemplate.getCollection("movies")
                     .aggregate(aggregationPipeline)
@@ -619,6 +686,21 @@ public List<Movie> searchMoviesByPlot(String plotQuery, Integer limit, Integer s
         }
     }
 
+    @Override
+    @Deprecated
+    public List<Movie> searchMoviesByPlot(String plotQuery, Integer limit, Integer skip) {
+        // Delegate to the new searchMovies method
+        com.mongodb.samplemflix.model.dto.MovieSearchRequest request =
+            com.mongodb.samplemflix.model.dto.MovieSearchRequest.builder()
+                .plot(plotQuery)
+                .limit(limit)
+                .skip(skip)
+                .searchOperator("must")
+                .build();
+
+        return searchMovies(request);
+    }
+
     @Override
     public List<Movie> findSimilarMovies(String movieId, Integer limit) {
         // Validate movie ID
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
index ae3c3cd..66f82d5 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
@@ -227,7 +227,7 @@ void testCreateMoviesBatch_Success() throws Exception {
     // ==================== UPDATE MOVIE TESTS ====================
 
     @Test
-    @DisplayName("PUT /api/movies/{id} - Should update movie successfully")
+    @DisplayName("PATCH /api/movies/{id} - Should update movie successfully")
     void testUpdateMovie_Success() throws Exception {
         // Arrange
         String movieId = testId.toHexString();
@@ -241,7 +241,7 @@ void testUpdateMovie_Success() throws Exception {
                 .thenReturn(updatedMovie);
 
         // Act & Assert
-        mockMvc.perform(put("/api/movies/{id}", movieId)
+        mockMvc.perform(patch("/api/movies/{id}", movieId)
                         .contentType(MediaType.APPLICATION_JSON)
                         .content(objectMapper.writeValueAsString(updateRequest)))
                 .andExpect(status().isOk())
@@ -251,7 +251,7 @@ void testUpdateMovie_Success() throws Exception {
     }
 
     @Test
-    @DisplayName("PUT /api/movies/{id} - Should return 404 when movie not found")
+    @DisplayName("PATCH /api/movies/{id} - Should return 404 when movie not found")
     void testUpdateMovie_NotFound() throws Exception {
         // Arrange
         String movieId = testId.toHexString();
@@ -259,7 +259,7 @@ void testUpdateMovie_NotFound() throws Exception {
                 .thenThrow(new ResourceNotFoundException("Movie not found"));
 
         // Act & Assert
-        mockMvc.perform(put("/api/movies/{id}", movieId)
+        mockMvc.perform(patch("/api/movies/{id}", movieId)
                         .contentType(MediaType.APPLICATION_JSON)
                         .content(objectMapper.writeValueAsString(updateRequest)))
                 .andExpect(status().isNotFound())
@@ -506,7 +506,7 @@ void testGetDirectorsWithMostMovies_WithLimit() throws Exception {
     // ==================== ATLAS SEARCH ENDPOINT TESTS ====================
 
     @Test
-    @DisplayName("GET /api/movies/searchByPlot - Should search movies by plot successfully")
+    @DisplayName("GET /api/movies/search - Should search movies by plot successfully")
     void testSearchMoviesByPlot_Success() throws Exception {
         // Arrange
         Movie movie1 = Movie.builder()
@@ -525,11 +525,11 @@ void testSearchMoviesByPlot_Success() throws Exception {
                 .genres(Arrays.asList("Sci-Fi", "Action"))
                 .build();
 
-        when(movieService.searchMoviesByPlot(eq("space adventure"), eq(20), eq(0)))
+        when(movieService.searchMovies(any(com.mongodb.samplemflix.model.dto.MovieSearchRequest.class)))
                 .thenReturn(Arrays.asList(movie1, movie2));
 
         // Act & Assert
-        mockMvc.perform(get("/api/movies/searchByPlot")
+        mockMvc.perform(get("/api/movies/search")
                         .param("plot", "space adventure"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.success").value(true))
@@ -541,14 +541,14 @@ void testSearchMoviesByPlot_Success() throws Exception {
     }
 
     @Test
-    @DisplayName("GET /api/movies/searchByPlot - Should accept limit and skip parameters")
+    @DisplayName("GET /api/movies/search - Should accept limit and skip parameters")
     void testSearchMoviesByPlot_WithPagination() throws Exception {
         // Arrange
-        when(movieService.searchMoviesByPlot(eq("adventure"), eq(10), eq(5)))
+        when(movieService.searchMovies(any(com.mongodb.samplemflix.model.dto.MovieSearchRequest.class)))
                 .thenReturn(Arrays.asList());
 
         // Act & Assert
-        mockMvc.perform(get("/api/movies/searchByPlot")
+        mockMvc.perform(get("/api/movies/search")
                         .param("plot", "adventure")
                         .param("limit", "10")
                         .param("skip", "5"))
@@ -558,22 +558,28 @@ void testSearchMoviesByPlot_WithPagination() throws Exception {
     }
 
     @Test
-    @DisplayName("GET /api/movies/searchByPlot - Should return 400 when plot parameter is missing")
+    @DisplayName("GET /api/movies/search - Should return 400 when no search parameters provided")
     void testSearchMoviesByPlot_MissingPlotParameter() throws Exception {
+        // Arrange
+        when(movieService.searchMovies(any(com.mongodb.samplemflix.model.dto.MovieSearchRequest.class)))
+                .thenThrow(new ValidationException("At least one search parameter must be provided"));
+
         // Act & Assert
-        mockMvc.perform(get("/api/movies/searchByPlot"))
-                .andExpect(status().isBadRequest());
+        mockMvc.perform(get("/api/movies/search"))
+                .andExpect(status().isBadRequest())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("VALIDATION_ERROR"));
     }
 
     @Test
-    @DisplayName("GET /api/movies/searchByPlot - Should return 400 for validation error")
+    @DisplayName("GET /api/movies/search - Should return 400 for validation error")
     void testSearchMoviesByPlot_ValidationError() throws Exception {
         // Arrange
-        when(movieService.searchMoviesByPlot(anyString(), anyInt(), anyInt()))
+        when(movieService.searchMovies(any(com.mongodb.samplemflix.model.dto.MovieSearchRequest.class)))
                 .thenThrow(new ValidationException("Plot query cannot be empty"));
 
         // Act & Assert
-        mockMvc.perform(get("/api/movies/searchByPlot")
+        mockMvc.perform(get("/api/movies/search")
                         .param("plot", ""))
                 .andExpect(status().isBadRequest())
                 .andExpect(jsonPath("$.success").value(false))
@@ -581,18 +587,77 @@ void testSearchMoviesByPlot_ValidationError() throws Exception {
     }
 
     @Test
-    @DisplayName("GET /api/movies/searchByPlot - Should return empty list when no matches found")
+    @DisplayName("GET /api/movies/search - Should return empty list when no matches found")
     void testSearchMoviesByPlot_NoResults() throws Exception {
         // Arrange
-        when(movieService.searchMoviesByPlot(eq("nonexistent"), eq(20), eq(0)))
+        when(movieService.searchMovies(any(com.mongodb.samplemflix.model.dto.MovieSearchRequest.class)))
                 .thenReturn(Arrays.asList());
 
         // Act & Assert
-        mockMvc.perform(get("/api/movies/searchByPlot")
+        mockMvc.perform(get("/api/movies/search")
                         .param("plot", "nonexistent"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.success").value(true))
                 .andExpect(jsonPath("$.data").isArray())
                 .andExpect(jsonPath("$.data", hasSize(0)));
     }
+
+    @Test
+    @DisplayName("GET /api/movies/search - Should search by multiple fields")
+    void testSearchMovies_MultipleFields() throws Exception {
+        // Arrange
+        Movie movie = Movie.builder()
+                .id(new ObjectId())
+                .title("The Godfather")
+                .year(1972)
+                .plot("The aging patriarch of an organized crime dynasty transfers control to his son")
+                .directors(Arrays.asList("Francis Ford Coppola"))
+                .cast(Arrays.asList("Marlon Brando", "Al Pacino"))
+                .build();
+
+        when(movieService.searchMovies(any(com.mongodb.samplemflix.model.dto.MovieSearchRequest.class)))
+                .thenReturn(Arrays.asList(movie));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/search")
+                        .param("directors", "Coppola")
+                        .param("cast", "Pacino"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray())
+                .andExpect(jsonPath("$.data", hasSize(1)))
+                .andExpect(jsonPath("$.data[0].title").value("The Godfather"));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/search - Should accept searchOperator parameter")
+    void testSearchMovies_WithSearchOperator() throws Exception {
+        // Arrange
+        when(movieService.searchMovies(any(com.mongodb.samplemflix.model.dto.MovieSearchRequest.class)))
+                .thenReturn(Arrays.asList());
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/search")
+                        .param("plot", "adventure")
+                        .param("searchOperator", "should"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray());
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/search - Should return 400 for invalid searchOperator")
+    void testSearchMovies_InvalidSearchOperator() throws Exception {
+        // Arrange
+        when(movieService.searchMovies(any(com.mongodb.samplemflix.model.dto.MovieSearchRequest.class)))
+                .thenThrow(new ValidationException("Invalid search_operator 'invalid'. The search_operator must be one of: must, should, mustNot, filter"));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/search")
+                        .param("plot", "adventure")
+                        .param("searchOperator", "invalid"))
+                .andExpect(status().isBadRequest())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("VALIDATION_ERROR"));
+    }
 }
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java
index aea2155..fdc161d 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java
@@ -9,6 +9,7 @@
 import com.mongodb.samplemflix.service.MovieService;
 import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.Collections;
 import java.util.List;
 import org.bson.Document;
 import org.junit.jupiter.api.AfterAll;
@@ -266,7 +267,7 @@ private void createSearchIndex() throws Exception {
 
         // Create the index using the createSearchIndexes command
         Document createIndexCommand = new Document("createSearchIndexes", "movies")
-                .append("indexes", Arrays.asList(
+                .append("indexes", Collections.singletonList(
                         new Document("name", SEARCH_INDEX_NAME)
                                 .append("definition", indexDefinition)
                 ));
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
index c734d7a..91f86fe 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
@@ -15,7 +15,7 @@
  * - GET /api/movies/{id}
  * - POST /api/movies
  * - POST /api/movies/batch
- * - PUT /api/movies/{id}
+ * - PATCH /api/movies/{id}
  * - PATCH /api/movies
  * - DELETE /api/movies/{id}
  * - DELETE /api/movies
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
index 333f67a..d57ed7e 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
@@ -8,7 +8,7 @@ The `AtlasSearchIntegrationTest` class tests the Atlas Search endpoints with a r
 
 1. The Atlas Search index is created correctly
 2. The index becomes ready for use (using polling)
-3. The `searchByPlot` endpoint returns correct results
+3. The `/search` endpoint returns correct results
 4. Pagination works correctly
 5. Empty results are handled properly
 

From d02258e42b8119b3bde4111e16e2c8c87aab3f78 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Fri, 31 Oct 2025 13:20:17 -0400
Subject: [PATCH 039/110] small fixes

---
 server/java-spring/README.md                  |  2 +-
 .../controller/MovieControllerImpl.java       |  6 +--
 .../repository/MovieRepository.java           |  4 +-
 .../samplemflix/service/MovieService.java     | 13 -----
 .../samplemflix/service/MovieServiceImpl.java | 37 ++------------
 .../AtlasSearchIntegrationTest.java           | 49 ++++++++++++++++---
 6 files changed, 52 insertions(+), 59 deletions(-)

diff --git a/server/java-spring/README.md b/server/java-spring/README.md
index 3bd4345..cc5d69c 100644
--- a/server/java-spring/README.md
+++ b/server/java-spring/README.md
@@ -155,7 +155,7 @@ Once the application is running, you can access:
   - `filter` - Criteria must match but don't affect scoring
 
 #### Vector Search
-- `GET /api/movies/findSimilarMovies` - Find similar movies using vector search on plot embeddings
+- `GET /api/movies/find-similar-movies` - Find similar movies using vector search on plot embeddings
 
 ## Development
 
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index 736e096..2a05597 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -39,7 +39,7 @@
  * - GET /api/movies/aggregations/years - Aggregate movies by year with statistics
  * - GET /api/movies/aggregations/directors - Aggregate directors with most movies
  * - GET /api/movies/search - Text search using Atlas Search Index across multiple fields (plot, fullplot, directors, writers, cast)
- * - GET /api/movies/findSimilarMovies - Vector search to find similar movies based on plot embeddings
+ * - GET /api/movies/find-similar-movies - Vector search to find similar movies based on plot embeddings
  * </pre>
  */
 @RestController
@@ -414,7 +414,7 @@ public ResponseEntity<SuccessResponse<List<Movie>>> searchMovies(
     }
 
     /**
-     * GET /api/movies/findSimilarMovies
+     * GET /api/movies/find-similar-movies
      *
      * <p>Finds similar movies using vector search on plot embeddings.
      * Demonstrates MongoDB Atlas Vector Search to find movies with similar plots.
@@ -423,7 +423,7 @@ public ResponseEntity<SuccessResponse<List<Movie>>> searchMovies(
      * @param limit Maximum number of similar movies to return (default: 10, max: 50)
      * @return List of similar movies based on plot embeddings
      */
-    @GetMapping("/findSimilarMovies")
+    @GetMapping("/find-similar-movies")
     public ResponseEntity<SuccessResponse<List<Movie>>> findSimilarMovies(
             @RequestParam String movieId,
             @RequestParam(defaultValue = "10") Integer limit) {
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
index 77cb013..35c85ab 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
@@ -8,13 +8,13 @@
 /**
  * Spring Data MongoDB repository for movie data access.
  *
- * This repository extends MongoRepository which provides:
+ * <p>This repository extends MongoRepository which provides:
  * - Basic CRUD operations (save, findById, findAll, delete, etc.)
  * - Pagination and sorting support
  * - Query derivation from method names
  * - Custom query support via @Query annotation
  *
- * For complex queries not supported by Spring Data, you can inject MongoTemplate
+ * <p>For complex queries not supported by Spring Data, you can inject MongoTemplate
  * in the service layer.
  */
 @Repository
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
index 69fd882..b4ac462 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
@@ -82,19 +82,6 @@ public interface MovieService {
      */
     List<Movie> searchMovies(com.mongodb.samplemflix.model.dto.MovieSearchRequest searchRequest);
 
-    /**
-     * Searches movies by plot using MongoDB Atlas Search.
-     * Demonstrates text search using Atlas Search Index.
-     *
-     * @deprecated Use {@link #searchMovies(com.mongodb.samplemflix.model.dto.MovieSearchRequest)} instead
-     * @param plotQuery Text to search in the plot field
-     * @param limit Maximum number of movies to return (default: 20, max: 100)
-     * @param skip Number of results to skip for pagination (default: 0)
-     * @return List of movies matching the search criteria
-     */
-    @Deprecated
-    List<Movie> searchMoviesByPlot(String plotQuery, Integer limit, Integer skip);
-
     /**
      * Finds similar movies using vector search on plot embeddings.
      * Demonstrates MongoDB Atlas Vector Search.
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 046e269..0176b7e 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -7,15 +7,7 @@
 import com.mongodb.samplemflix.exception.ResourceNotFoundException;
 import com.mongodb.samplemflix.exception.ValidationException;
 import com.mongodb.samplemflix.model.Movie;
-import com.mongodb.samplemflix.model.dto.BatchInsertResponse;
-import com.mongodb.samplemflix.model.dto.BatchUpdateResponse;
-import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
-import com.mongodb.samplemflix.model.dto.DeleteResponse;
-import com.mongodb.samplemflix.model.dto.DirectorStatisticsResult;
-import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
-import com.mongodb.samplemflix.model.dto.MovieWithCommentsResult;
-import com.mongodb.samplemflix.model.dto.MoviesByYearResult;
-import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
+import com.mongodb.samplemflix.model.dto.*;
 import com.mongodb.samplemflix.repository.MovieRepository;
 import java.util.Collection;
 import java.util.List;
@@ -549,7 +541,7 @@ private MovieWithCommentsResult mapToMovieWithCommentsResult(Document doc) {
                 .year(doc.getInteger("year"))
                 .plot(doc.getString("plot"))
                 .poster(doc.getString("poster"))
-                .genres((List<String>) doc.get("genres"))
+                .genres(doc.getList("genres", String.class))
                 .imdb(imdbInfo)
                 .recentComments(recentComments)
                 .totalComments(doc.getInteger("totalComments"))
@@ -560,7 +552,7 @@ private MovieWithCommentsResult mapToMovieWithCommentsResult(Document doc) {
     // Atlas Search methods
 
     @Override
-    public List<Movie> searchMovies(com.mongodb.samplemflix.model.dto.MovieSearchRequest searchRequest) {
+    public List<Movie> searchMovies(MovieSearchRequest searchRequest) {
         // Validate that at least one search field is provided
         if (!searchRequest.hasSearchFields()) {
             throw new ValidationException("At least one search parameter must be provided");
@@ -686,21 +678,8 @@ public List<Movie> searchMovies(com.mongodb.samplemflix.model.dto.MovieSearchReq
         }
     }
 
-    @Override
-    @Deprecated
-    public List<Movie> searchMoviesByPlot(String plotQuery, Integer limit, Integer skip) {
-        // Delegate to the new searchMovies method
-        com.mongodb.samplemflix.model.dto.MovieSearchRequest request =
-            com.mongodb.samplemflix.model.dto.MovieSearchRequest.builder()
-                .plot(plotQuery)
-                .limit(limit)
-                .skip(skip)
-                .searchOperator("must")
-                .build();
-
-        return searchMovies(request);
-    }
 
+    // TODO: Implement vector search
     @Override
     public List<Movie> findSimilarMovies(String movieId, Integer limit) {
         // Validate movie ID
@@ -787,12 +766,4 @@ public List<Movie> findSimilarMovies(String movieId, Integer limit) {
             throw new DatabaseOperationException("Error performing vector search: " + e.getMessage());
         }
     }
-
-    // TODO: Add advanced query methods
-    // - getMoviesByGenreStatistics() - Aggregation pipeline for genre statistics
-    // - getTopRatedMovies(int limit) - Movies sorted by rating
-    // - getMoviesByDecade(int decade) - Movies from a specific decade
-    // - getDirectorFilmography(String director) - All movies by a director
-    // - getActorFilmography(String actor) - All movies featuring an actor
-    // - getMovieRecommendations(String userId) - Personalized recommendations
 }
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java
index fdc161d..dfd2e14 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java
@@ -78,7 +78,7 @@ void setUp() throws Exception {
         // Atlas Search indexes documents asynchronously
         System.out.println("Waiting for test documents to be indexed...");
         try {
-            Thread.sleep(5000); // Wait 5 seconds for indexing
+            Thread.sleep(10000); // Wait 10 seconds for indexing
         } catch (InterruptedException e) {
             Thread.currentThread().interrupt();
         }
@@ -115,7 +115,14 @@ void testSearchMoviesByPlot_Success() {
         }
 
         // Act
-        List<Movie> results = movieService.searchMoviesByPlot("space adventure", 10, 0);
+        com.mongodb.samplemflix.model.dto.MovieSearchRequest searchRequest =
+            com.mongodb.samplemflix.model.dto.MovieSearchRequest.builder()
+                .plot("space adventure")
+                .limit(10)
+                .skip(0)
+                .searchOperator("must")
+                .build();
+        List<Movie> results = movieService.searchMovies(searchRequest);
 
         // Assert
         assertNotNull(results, "Search results should not be null");
@@ -137,7 +144,14 @@ void testSearchMoviesByPlot_NoResults() {
         }
 
         // Act - search for something that definitely doesn't exist
-        List<Movie> results = movieService.searchMoviesByPlot("xyzabc123nonexistent", 10, 0);
+        com.mongodb.samplemflix.model.dto.MovieSearchRequest searchRequest =
+            com.mongodb.samplemflix.model.dto.MovieSearchRequest.builder()
+                .plot("xyzabc123nonexistent")
+                .limit(10)
+                .skip(0)
+                .searchOperator("must")
+                .build();
+        List<Movie> results = movieService.searchMovies(searchRequest);
 
         // Assert
         assertNotNull(results, "Search results should not be null");
@@ -153,7 +167,14 @@ void testSearchMoviesByPlot_WithLimit() {
         }
 
         // Act
-        List<Movie> results = movieService.searchMoviesByPlot("adventure", 2, 0);
+        com.mongodb.samplemflix.model.dto.MovieSearchRequest searchRequest =
+            com.mongodb.samplemflix.model.dto.MovieSearchRequest.builder()
+                .plot("adventure")
+                .limit(2)
+                .skip(0)
+                .searchOperator("must")
+                .build();
+        List<Movie> results = movieService.searchMovies(searchRequest);
 
         // Assert
         assertNotNull(results, "Search results should not be null");
@@ -169,10 +190,24 @@ void testSearchMoviesByPlot_WithPagination() {
         }
 
         // Act - Get first page
-        List<Movie> firstPage = movieService.searchMoviesByPlot("adventure", 2, 0);
-        
+        com.mongodb.samplemflix.model.dto.MovieSearchRequest firstPageRequest =
+            com.mongodb.samplemflix.model.dto.MovieSearchRequest.builder()
+                .plot("adventure")
+                .limit(2)
+                .skip(0)
+                .searchOperator("must")
+                .build();
+        List<Movie> firstPage = movieService.searchMovies(firstPageRequest);
+
         // Act - Get second page
-        List<Movie> secondPage = movieService.searchMoviesByPlot("adventure", 2, 2);
+        com.mongodb.samplemflix.model.dto.MovieSearchRequest secondPageRequest =
+            com.mongodb.samplemflix.model.dto.MovieSearchRequest.builder()
+                .plot("adventure")
+                .limit(2)
+                .skip(2)
+                .searchOperator("must")
+                .build();
+        List<Movie> secondPage = movieService.searchMovies(secondPageRequest);
 
         // Assert
         assertNotNull(firstPage, "First page should not be null");

From 246e795cab4c2fe52270e364d26fca1d4c5166ef Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Fri, 31 Oct 2025 17:35:53 -0400
Subject: [PATCH 040/110] docs(java): update details for swagger docs

---
 .../samplemflix/SampleMflixApplication.java   |   3 +
 .../samplemflix/config/CorsConfig.java        |  28 ++-
 .../samplemflix/config/MongoConfig.java       |   2 +-
 .../samplemflix/config/OpenApiConfig.java     |  49 ++++
 .../controller/MovieControllerImpl.java       | 227 +++++++++---------
 .../samplemflix/service/MovieServiceImpl.java |  28 ++-
 .../src/main/resources/application.properties |   9 +
 7 files changed, 212 insertions(+), 134 deletions(-)
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/config/OpenApiConfig.java

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
index b3aff5b..72ba6a9 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
@@ -1,5 +1,6 @@
 package com.mongodb.samplemflix;
 
+import io.swagger.v3.oas.annotations.Hidden;
 import java.util.Map;
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
@@ -26,7 +27,9 @@ public static void main(String[] args) {
 
     /**
      * Root endpoint providing basic information about the API.
+     * Hidden from Swagger UI documentation.
      */
+    @Hidden
     @GetMapping("/")
     public Map<String, Object> root() {
         return Map.of(
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
index 8e2a31b..300b939 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
@@ -1,6 +1,5 @@
 package com.mongodb.samplemflix.config;
 
-import java.util.Arrays;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
@@ -30,22 +29,29 @@ public class CorsConfig {
     @Bean
     public CorsFilter corsFilter() {
         CorsConfiguration config = new CorsConfiguration();
-        
-        // Allow credentials (cookies, authorization headers)
-        config.setAllowCredentials(true);
-        
-        // Set allowed origins from environment variable
-        config.setAllowedOrigins(Arrays.asList(allowedOrigins.split(",")));
-        
+
+        // Allow wildcard origins for Swagger UI
+        config.setAllowCredentials(false);
+
+        // Set allowed origins - include localhost for Swagger UI
+        // Parse the configured origins and add localhost variations for Swagger UI
+        String[] origins = allowedOrigins.split(",");
+        for (String origin : origins) {
+            config.addAllowedOrigin(origin.trim());
+        }
+        // Add localhost origins for Swagger UI (on any port)
+        config.addAllowedOriginPattern("http://localhost:*");
+        config.addAllowedOriginPattern("http://127.0.0.1:*");
+
         // Allow all headers
         config.addAllowedHeader("*");
-        
+
         // Allow all HTTP methods
         config.addAllowedMethod("*");
-        
+
         UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
         source.registerCorsConfiguration("/**", config);
-        
+
         return new CorsFilter(source);
     }
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
index b0fcfce..df4395c 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
@@ -72,7 +72,7 @@ protected void configureClientSettings(MongoClientSettings.Builder builder) {
                 // Configure socket timeouts to prevent hanging connections
                 .applyToSocketSettings(socketBuilder ->
                     socketBuilder.connectTimeout(10000, TimeUnit.MILLISECONDS)  // 10s to establish connection
-                           .readTimeout(10000, TimeUnit.MILLISECONDS)           // 10s to wait for server response
+                           .readTimeout(60000, TimeUnit.MILLISECONDS)           // 60s to wait for server response (increased for aggregations)
                 )
                 // Configure server selection timeout
                 .applyToClusterSettings(clusterBuilder ->
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/OpenApiConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/OpenApiConfig.java
new file mode 100644
index 0000000..a085010
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/OpenApiConfig.java
@@ -0,0 +1,49 @@
+package com.mongodb.samplemflix.config;
+
+import io.swagger.v3.oas.models.OpenAPI;
+import io.swagger.v3.oas.models.info.Contact;
+import io.swagger.v3.oas.models.info.Info;
+import io.swagger.v3.oas.models.info.License;
+import io.swagger.v3.oas.models.servers.Server;
+import java.util.List;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * OpenAPI/Swagger configuration for the Sample MFlix API.
+ * 
+ * This configuration provides metadata for the API documentation
+ * and ensures the "Try it out" functionality works correctly.
+ */
+@Configuration
+public class OpenApiConfig {
+
+    @Value("${server.port:3001}")
+    private String serverPort;
+
+    @Bean
+    public OpenAPI customOpenAPI() {
+        return new OpenAPI()
+                .info(new Info()
+                        .title("Sample MFlix API")
+                        .version("1.0.0")
+                        .description("Java Spring Boot backend demonstrating MongoDB operations with the sample_mflix dataset. " +
+                                "This API provides CRUD operations for movies, text search, filtering, and pagination.")
+                        .contact(new Contact()
+                                .name("MongoDB Documentation Team")
+                                .url("https://www.mongodb.com/docs"))
+                        .license(new License()
+                                .name("Apache 2.0")
+                                .url("https://www.apache.org/licenses/LICENSE-2.0.html")))
+                .servers(List.of(
+                        new Server()
+                                .url("http://localhost:" + serverPort)
+                                .description("Local development server"),
+                        new Server()
+                                .url("http://localhost:3001")
+                                .description("Default local server")
+                ));
+    }
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index 2a05597..15b7dfd 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -12,6 +12,9 @@
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.model.response.SuccessResponse;
 import com.mongodb.samplemflix.service.MovieService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
 import java.time.Instant;
 import java.util.List;
@@ -44,6 +47,7 @@
  */
 @RestController
 @RequestMapping("/api/movies")
+@Tag(name = "Movies", description = "Movie management endpoints for CRUD operations, search, and aggregations")
 public class MovieControllerImpl {
     
     private final MovieService movieService;
@@ -52,21 +56,31 @@ public MovieControllerImpl(MovieService movieService) {
         this.movieService = movieService;
     }
     
-    /**
-     * GET /api/movies
-     *
-     * <p>Retrieves multiple movies with optional filtering, sorting, and pagination.
-     */
+    @Operation(
+        summary = "Get all movies with optional filtering, sorting, and pagination",
+        description = "Retrieve a list of movies with optional filtering by text search, genre, year, and rating. " +
+                     "Supports sorting and pagination. Text search (q parameter) uses MongoDB text index to search " +
+                     "across plot, title, and fullplot fields."
+    )
     @GetMapping
     public ResponseEntity<SuccessResponse<List<Movie>>> getAllMovies(
+            @Parameter(description = "Text search query (searches plot, title, fullplot)")
             @RequestParam(required = false) String q,
+            @Parameter(description = "Filter by genre (case-insensitive partial match)")
             @RequestParam(required = false) String genre,
+            @Parameter(description = "Filter by exact year")
             @RequestParam(required = false) Integer year,
+            @Parameter(description = "Minimum IMDB rating (inclusive)")
             @RequestParam(required = false) Double minRating,
+            @Parameter(description = "Maximum IMDB rating (inclusive)")
             @RequestParam(required = false) Double maxRating,
+            @Parameter(description = "Number of results to return (default: 20)")
             @RequestParam(defaultValue = "20") Integer limit,
+            @Parameter(description = "Number of results to skip for pagination (default: 0)")
             @RequestParam(defaultValue = "0") Integer skip,
+            @Parameter(description = "Field to sort by (default: title)")
             @RequestParam(defaultValue = "title") String sortBy,
+            @Parameter(description = "Sort order: 'asc' or 'desc' (default: asc)")
             @RequestParam(defaultValue = "asc") String sortOrder) {
         
         MovieSearchQuery query = MovieSearchQuery.builder()
@@ -93,13 +107,14 @@ public ResponseEntity<SuccessResponse<List<Movie>>> getAllMovies(
         return ResponseEntity.ok(response);
     }
     
-    /**
-     * GET /api/movies/{id}
-     *
-     * <p>Retrieves a single movie by its ObjectId.
-     */
+    @Operation(
+        summary = "Get a single movie by ID",
+        description = "Retrieve a single movie by its MongoDB ObjectId."
+    )
     @GetMapping("/{id}")
-    public ResponseEntity<SuccessResponse<Movie>> getMovieById(@PathVariable String id) {
+    public ResponseEntity<SuccessResponse<Movie>> getMovieById(
+            @Parameter(description = "Movie ObjectId (24-character hex string)", required = true)
+            @PathVariable String id) {
         Movie movie = movieService.getMovieById(id);
         
         SuccessResponse<Movie> response = SuccessResponse.<Movie>builder()
@@ -112,13 +127,14 @@ public ResponseEntity<SuccessResponse<Movie>> getMovieById(@PathVariable String
         return ResponseEntity.ok(response);
     }
     
-    /**
-     * POST /api/movies
-     *
-     * <p>Creates a single new movie document.
-     */
+    @Operation(
+        summary = "Create a new movie",
+        description = "Create a single new movie document. Only the title field is required; all other fields are optional."
+    )
     @PostMapping
-    public ResponseEntity<SuccessResponse<Movie>> createMovie(@Valid @RequestBody CreateMovieRequest request) {
+    public ResponseEntity<SuccessResponse<Movie>> createMovie(
+            @Parameter(description = "Movie data to create", required = true)
+            @Valid @RequestBody CreateMovieRequest request) {
         Movie movie = movieService.createMovie(request);
         
         SuccessResponse<Movie> response = SuccessResponse.<Movie>builder()
@@ -131,13 +147,13 @@ public ResponseEntity<SuccessResponse<Movie>> createMovie(@Valid @RequestBody Cr
         return ResponseEntity.status(HttpStatus.CREATED).body(response);
     }
     
-    /**
-     * POST /api/movies/batch
-     *
-     * <p>Creates multiple movie documents in a single operation.
-     */
+    @Operation(
+        summary = "Create multiple movies in batch",
+        description = "Create multiple movie documents in a single operation using insertMany."
+    )
     @PostMapping("/batch")
     public ResponseEntity<SuccessResponse<BatchInsertResponse>> createMoviesBatch(
+            @Parameter(description = "List of movies to create", required = true)
             @RequestBody List<CreateMovieRequest> requests) {
         BatchInsertResponse result = movieService.createMoviesBatch(requests);
 
@@ -150,16 +166,16 @@ public ResponseEntity<SuccessResponse<BatchInsertResponse>> createMoviesBatch(
 
         return ResponseEntity.status(HttpStatus.CREATED).body(response);
     }
-    
-    /**
-     * PATCH /api/movies/{id}
-     *
-     * <p>Updates a single movie document with partial updates.
-     * Only the fields provided in the request will be updated.
-     */
+
+    @Operation(
+        summary = "Update a movie by ID",
+        description = "Update a single movie document by its ObjectId using updateOne with $set operator."
+    )
     @PatchMapping("/{id}")
     public ResponseEntity<SuccessResponse<Movie>> updateMovie(
+            @Parameter(description = "Movie ObjectId to update", required = true)
             @PathVariable String id,
+            @Parameter(description = "Updated movie data (only provided fields will be updated)", required = true)
             @RequestBody UpdateMovieRequest request) {
         Movie movie = movieService.updateMovie(id, request);
 
@@ -173,14 +189,15 @@ public ResponseEntity<SuccessResponse<Movie>> updateMovie(
         return ResponseEntity.ok(response);
     }
     
-    /**
-     * PATCH /api/movies
-     *
-     * <p>Updates multiple movies based on a filter.
-     */
+    @Operation(
+        summary = "Update multiple movies in batch",
+        description = "Update multiple movies matching the given filter using updateMany. " +
+                     "Request body should contain 'filter' and 'update' objects."
+    )
     @SuppressWarnings("unchecked")
     @PatchMapping
     public ResponseEntity<SuccessResponse<BatchUpdateResponse>> updateMoviesBatch(
+            @Parameter(description = "Request body with 'filter' and 'update' objects", required = true)
             @RequestBody Map<String, Object> body) {
         Document filter = new Document((Map<String, Object>) body.get("filter"));
         Document update = new Document((Map<String, Object>) body.get("update"));
@@ -198,13 +215,15 @@ public ResponseEntity<SuccessResponse<BatchUpdateResponse>> updateMoviesBatch(
         return ResponseEntity.ok(response);
     }
     
-    /**
-     * DELETE /api/movies/{id}/find-and-delete
-     *
-     * <p>Finds and deletes a movie in a single atomic operation.
-     */
+    @Operation(
+        summary = "Find and delete a movie atomically",
+        description = "Find and delete a movie in a single atomic operation using findOneAndDelete. " +
+                     "Returns the deleted movie document."
+    )
     @DeleteMapping("/{id}/find-and-delete")
-    public ResponseEntity<SuccessResponse<Movie>> findAndDeleteMovie(@PathVariable String id) {
+    public ResponseEntity<SuccessResponse<Movie>> findAndDeleteMovie(
+            @Parameter(description = "Movie ObjectId to find and delete", required = true)
+            @PathVariable String id) {
         Movie movie = movieService.findAndDeleteMovie(id);
         
         SuccessResponse<Movie> response = SuccessResponse.<Movie>builder()
@@ -217,13 +236,14 @@ public ResponseEntity<SuccessResponse<Movie>> findAndDeleteMovie(@PathVariable S
         return ResponseEntity.ok(response);
     }
     
-    /**
-     * DELETE /api/movies/{id}
-     *
-     * <p>Deletes a single movie document.
-     */
+    @Operation(
+        summary = "Delete a movie by ID",
+        description = "Delete a single movie document by its ObjectId using deleteOne."
+    )
     @DeleteMapping("/{id}")
-    public ResponseEntity<SuccessResponse<DeleteResponse>> deleteMovie(@PathVariable String id) {
+    public ResponseEntity<SuccessResponse<DeleteResponse>> deleteMovie(
+            @Parameter(description = "Movie ObjectId to delete", required = true)
+            @PathVariable String id) {
         DeleteResponse result = movieService.deleteMovie(id);
 
         SuccessResponse<DeleteResponse> response = SuccessResponse.<DeleteResponse>builder()
@@ -236,14 +256,15 @@ public ResponseEntity<SuccessResponse<DeleteResponse>> deleteMovie(@PathVariable
         return ResponseEntity.ok(response);
     }
     
-    /**
-     * DELETE /api/movies
-     *
-     * <p>Deletes multiple movies based on a filter.
-     */
+    @Operation(
+        summary = "Delete multiple movies in batch",
+        description = "Delete multiple movies matching the given filter using deleteMany. " +
+                     "Request body should contain a 'filter' object."
+    )
     @SuppressWarnings("unchecked")
     @DeleteMapping
     public ResponseEntity<SuccessResponse<DeleteResponse>> deleteMoviesBatch(
+            @Parameter(description = "Request body with 'filter' object", required = true)
             @RequestBody Map<String, Object> body) {
         Document filter = new Document((Map<String, Object>) body.get("filter"));
 
@@ -261,19 +282,16 @@ public ResponseEntity<SuccessResponse<DeleteResponse>> deleteMoviesBatch(
 
     // Aggregation endpoints for reporting
 
-    /**
-     * GET /api/movies/aggregations/comments
-     *
-     * <p>Aggregates movies with their most recent comments.
-     * Demonstrates MongoDB $lookup (join) operation to combine movies with comments.
-     *
-     * @param limit Maximum number of movies to return (default: 10, max: 50)
-     * @param movieId Optional movie ID to filter by specific movie
-     * @return List of movies with their recent comments
-     */
+    @Operation(
+        summary = "Aggregate movies with their most recent comments",
+        description = "Aggregates movies with their most recent comments using MongoDB $lookup (join) operation. " +
+                     "Demonstrates how to combine data from the movies and comments collections."
+    )
     @GetMapping("/aggregations/comments")
     public ResponseEntity<SuccessResponse<List<MovieWithCommentsResult>>> getMoviesWithMostComments(
+            @Parameter(description = "Maximum number of movies to return (default: 10, max: 50)")
             @RequestParam(defaultValue = "10") Integer limit,
+            @Parameter(description = "Optional movie ID to filter by specific movie")
             @RequestParam(required = false) String movieId) {
 
         List<MovieWithCommentsResult> results = movieService.getMoviesWithMostComments(limit, movieId);
@@ -299,14 +317,11 @@ public ResponseEntity<SuccessResponse<List<MovieWithCommentsResult>>> getMoviesW
         return ResponseEntity.ok(response);
     }
 
-    /**
-     * GET /api/movies/aggregations/years
-     *
-     * <p>Aggregates movies by year with statistics.
-     * Demonstrates MongoDB $group operation for statistical aggregation.
-     *
-     * @return List of yearly statistics including movie count and average rating
-     */
+    @Operation(
+        summary = "Aggregate movies by year with statistics",
+        description = "Aggregates movies by year with statistics including movie count and average rating. " +
+                     "Demonstrates MongoDB $group operation for statistical aggregation."
+    )
     @GetMapping("/aggregations/years")
     public ResponseEntity<SuccessResponse<List<MoviesByYearResult>>> getMoviesByYearWithStats() {
 
@@ -323,17 +338,14 @@ public ResponseEntity<SuccessResponse<List<MoviesByYearResult>>> getMoviesByYear
         return ResponseEntity.ok(response);
     }
 
-    /**
-     * GET /api/movies/aggregations/directors
-     *
-     * <p>Aggregates directors with the most movies.
-     * Demonstrates MongoDB $unwind operation for array flattening and aggregation.
-     *
-     * @param limit Maximum number of directors to return (default: 20, max: 100)
-     * @return List of directors with their movie count and average rating
-     */
+    @Operation(
+        summary = "Aggregate directors with the most movies",
+        description = "Aggregates directors with the most movies and their statistics. " +
+                     "Demonstrates MongoDB $unwind operation for array flattening and aggregation."
+    )
     @GetMapping("/aggregations/directors")
     public ResponseEntity<SuccessResponse<List<DirectorStatisticsResult>>> getDirectorsWithMostMovies(
+            @Parameter(description = "Maximum number of directors to return (default: 20, max: 100)")
             @RequestParam(defaultValue = "20") Integer limit) {
 
         List<DirectorStatisticsResult> results = movieService.getDirectorsWithMostMovies(limit);
@@ -351,42 +363,30 @@ public ResponseEntity<SuccessResponse<List<DirectorStatisticsResult>>> getDirect
 
     // Atlas Search endpoints
 
-    /**
-     * GET /api/movies/search
-     *
-     * <p>Searches movies using MongoDB Atlas Search across multiple fields.
-     * Demonstrates text search using Atlas Search Index with compound operators.
-     *
-     * <p>Supports searching across:
-     * <ul>
-     * <li>plot - using phrase operator for exact phrase matching</li>
-     * <li>fullplot - using phrase operator for exact phrase matching</li>
-     * <li>directors - using text operator with fuzzy matching</li>
-     * <li>writers - using text operator with fuzzy matching</li>
-     * <li>cast - using text operator with fuzzy matching</li>
-     * </ul>
-     *
-     * <p>At least one search field must be provided.
-     *
-     * @param plot Text to search in the plot field (optional)
-     * @param fullplot Text to search in the fullplot field (optional)
-     * @param directors Text to search in the directors field (optional)
-     * @param writers Text to search in the writers field (optional)
-     * @param cast Text to search in the cast field (optional)
-     * @param limit Maximum number of movies to return (default: 20, max: 100)
-     * @param skip Number of results to skip for pagination (default: 0)
-     * @param searchOperator Compound operator: must, should, mustNot, filter (default: must)
-     * @return List of movies matching the search criteria
-     */
+    @Operation(
+        summary = "Search movies using MongoDB Atlas Search",
+        description = "Search movies using MongoDB Atlas Search across multiple fields (plot, fullplot, directors, writers, cast). " +
+                     "You can combine multiple fields in a single query and control how they are combined using the searchOperator parameter. " +
+                     "At least one search field must be provided. " +
+                     "Plot and fullplot use phrase operator for exact matching, while directors, writers, and cast use text operator with fuzzy matching."
+    )
     @GetMapping("/search")
     public ResponseEntity<SuccessResponse<List<Movie>>> searchMovies(
+            @Parameter(description = "Text to search in the plot field (phrase matching)")
             @RequestParam(required = false) String plot,
+            @Parameter(description = "Text to search in the fullplot field (phrase matching)")
             @RequestParam(required = false) String fullplot,
+            @Parameter(description = "Text to search in the directors field (fuzzy matching)")
             @RequestParam(required = false) String directors,
+            @Parameter(description = "Text to search in the writers field (fuzzy matching)")
             @RequestParam(required = false) String writers,
+            @Parameter(description = "Text to search in the cast field (fuzzy matching)")
             @RequestParam(required = false) String cast,
+            @Parameter(description = "Maximum number of movies to return (default: 20, max: 100)")
             @RequestParam(defaultValue = "20") Integer limit,
+            @Parameter(description = "Number of results to skip for pagination (default: 0)")
             @RequestParam(defaultValue = "0") Integer skip,
+            @Parameter(description = "Compound operator: must, should, mustNot, or filter (default: must)")
             @RequestParam(defaultValue = "must") String searchOperator) {
 
         com.mongodb.samplemflix.model.dto.MovieSearchRequest searchRequest =
@@ -413,19 +413,16 @@ public ResponseEntity<SuccessResponse<List<Movie>>> searchMovies(
         return ResponseEntity.ok(response);
     }
 
-    /**
-     * GET /api/movies/find-similar-movies
-     *
-     * <p>Finds similar movies using vector search on plot embeddings.
-     * Demonstrates MongoDB Atlas Vector Search to find movies with similar plots.
-     *
-     * @param movieId ID of the movie to find similar movies for (required)
-     * @param limit Maximum number of similar movies to return (default: 10, max: 50)
-     * @return List of similar movies based on plot embeddings
-     */
+    @Operation(
+        summary = "Find similar movies using vector search",
+        description = "Find similar movies using MongoDB Atlas Vector Search on plot embeddings. " +
+                     "Demonstrates how to use vector search to find movies with similar plots based on semantic similarity."
+    )
     @GetMapping("/find-similar-movies")
     public ResponseEntity<SuccessResponse<List<Movie>>> findSimilarMovies(
+            @Parameter(description = "ID of the movie to find similar movies for", required = true)
             @RequestParam String movieId,
+            @Parameter(description = "Maximum number of similar movies to return (default: 10, max: 50)")
             @RequestParam(defaultValue = "10") Integer limit) {
 
         List<Movie> movies = movieService.findSimilarMovies(movieId, limit);
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 0176b7e..f49b05d 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -349,17 +349,22 @@ public List<MovieWithCommentsResult> getMoviesWithMostComments(Integer limit, St
 
         // Build aggregation pipeline
         // This demonstrates $lookup (join), $unwind, $sort, $group, and $project operations
+        // Optimized to limit movies before $lookup to reduce processing time
         Aggregation aggregation = Aggregation.newAggregation(
                 // STAGE 1: Match movies with valid year data
                 Aggregation.match(matchCriteria),
 
-                // STAGE 2: Lookup (join) with comments collection
+                // STAGE 2: Limit movies before lookup (optimization: process fewer documents)
+                // We'll get more results than needed, then filter and re-limit after lookup
+                Aggregation.limit(resultLimit * 10),
+
+                // STAGE 3: Lookup (join) with comments collection
                 Aggregation.lookup("comments", "_id", "movie_id", "comments"),
 
-                // STAGE 3: Filter to only movies with comments
+                // STAGE 4: Filter to only movies with comments
                 Aggregation.match(Criteria.where("comments").ne(List.of())),
 
-                // STAGE 4: Add computed fields
+                // STAGE 5: Add computed fields
                 Aggregation.project()
                         .and(Movie.Fields.ID).as("_id")
                         .and(Movie.Fields.TITLE).as("title")
@@ -372,13 +377,13 @@ public List<MovieWithCommentsResult> getMoviesWithMostComments(Integer limit, St
                         .and(ArrayOperators.Size.lengthOfArray("comments")).as("totalComments")
                         .and(ArrayOperators.ArrayElemAt.arrayOf("comments.date").elementAt(0)).as("mostRecentCommentDate"),
 
-                // STAGE 5: Sort by most recent comment date (descending)
+                // STAGE 6: Sort by most recent comment date (descending)
                 Aggregation.sort(Sort.Direction.DESC, "mostRecentCommentDate"),
 
-                // STAGE 6: Limit results
+                // STAGE 7: Limit results to requested amount
                 Aggregation.limit(resultLimit),
 
-                // STAGE 7: Project final output with recent comments slice
+                // STAGE 8: Project final output with recent comments slice
                 Aggregation.project()
                         .and(ConditionalOperators.ifNull("_id").then("")).as("id")
                         .and("title").as("title")
@@ -535,8 +540,17 @@ private MovieWithCommentsResult mapToMovieWithCommentsResult(Document doc) {
                     .collect(Collectors.toList());
         }
 
+        // Extract movie ID - handle both String and ObjectId types
+        String movieId = null;
+        Object idObj = doc.get("id");
+        if (idObj instanceof String) {
+            movieId = (String) idObj;
+        } else if (idObj instanceof ObjectId) {
+            movieId = ((ObjectId) idObj).toHexString();
+        }
+
         return MovieWithCommentsResult.builder()
-                .id(doc.getString("id"))
+                .id(movieId)
                 .title(doc.getString("title"))
                 .year(doc.getInteger("year"))
                 .plot(doc.getString("plot"))
diff --git a/server/java-spring/src/main/resources/application.properties b/server/java-spring/src/main/resources/application.properties
index ff84d9a..57c86f9 100644
--- a/server/java-spring/src/main/resources/application.properties
+++ b/server/java-spring/src/main/resources/application.properties
@@ -26,3 +26,12 @@ spring.jackson.serialization.write-dates-as-timestamps=false
 springdoc.api-docs.path=/api-docs
 springdoc.swagger-ui.path=/swagger-ui.html
 springdoc.swagger-ui.operationsSorter=method
+# Disable "Try it out" by default (user must click to enable)
+springdoc.swagger-ui.tryItOutEnabled=false
+# Display request duration in Swagger UI
+springdoc.swagger-ui.displayRequestDuration=true
+# Enable deep linking for direct access to operations
+springdoc.swagger-ui.deepLinking=true
+# Show request/response examples
+springdoc.swagger-ui.defaultModelsExpandDepth=1
+springdoc.swagger-ui.defaultModelExpandDepth=1

From 09927990b13aa4d85fa8c0156f169ebbac524cf4 Mon Sep 17 00:00:00 2001
From: Jordan Smith <45415425+jordan-smith721@users.noreply.github.com>
Date: Mon, 3 Nov 2025 12:02:38 -0500
Subject: [PATCH 041/110] feat: implement movie details page and optimize
 components (#9)

---
 .../ActionButtons/ActionButtons.module.css    |  84 ++++
 .../ActionButtons/ActionButtons.tsx           |  45 ++
 client/app/components/ActionButtons/index.ts  |   1 +
 .../components/AddMovieForm/AddMovieForm.tsx  | 427 ++++++++++++++++++
 client/app/components/AddMovieForm/index.ts   |   1 +
 .../BatchEditMovieForm/BatchEditMovieForm.tsx | 363 +++++++++++++++
 .../components/BatchEditMovieForm/index.ts    |   1 +
 .../EditMovieForm/EditMovieForm.module.css    | 308 +++++++++++++
 .../EditMovieForm/EditMovieForm.tsx           | 329 ++++++++++++++
 client/app/components/EditMovieForm/index.ts  |   1 +
 .../LoadingSkeleton.module.css                | 215 +++++++++
 .../LoadingSkeleton/LoadingSkeleton.tsx       | 113 +++++
 .../app/components/LoadingSkeleton/index.ts   |   8 +
 .../components/MovieCard/MovieCard.module.css |  36 +-
 client/app/components/MovieCard/MovieCard.tsx |  41 +-
 .../PageSizeSelector.module.css               |  56 +++
 .../PageSizeSelector/PageSizeSelector.tsx     |  42 ++
 .../app/components/PageSizeSelector/index.ts  |   1 +
 .../Pagination/Pagination.module.css          | 113 +++++
 .../app/components/Pagination/Pagination.tsx  |  81 ++++
 client/app/components/Pagination/index.ts     |   1 +
 client/app/components/index.ts                |  16 +-
 client/app/globals.css                        |  12 +
 client/app/layout.module.css                  |  79 ++++
 client/app/layout.tsx                         |  29 ++
 client/app/lib/api.ts                         | 317 ++++++++++++-
 client/app/lib/constants.ts                   |   3 +-
 client/app/movie/[id]/error.module.css        |  91 ++++
 client/app/movie/[id]/error.tsx               |  53 +++
 client/app/movie/[id]/loading.tsx             |  22 +
 client/app/movie/[id]/not-found.module.css    |  50 ++
 client/app/movie/[id]/not-found.tsx           |  16 +
 client/app/movie/[id]/page.module.css         | 317 +++++++++++++
 client/app/movie/[id]/page.tsx                | 385 ++++++++++++++++
 client/app/movies/loading.module.css          |  45 --
 client/app/movies/loading.tsx                 |  24 +-
 client/app/movies/movies.module.css           | 302 ++++++++++++-
 client/app/movies/page.tsx                    | 358 ++++++++++++++-
 client/app/types/movie.ts                     |  48 +-
 .../src/controllers/movieController.ts        |  32 +-
 40 files changed, 4362 insertions(+), 104 deletions(-)
 create mode 100644 client/app/components/ActionButtons/ActionButtons.module.css
 create mode 100644 client/app/components/ActionButtons/ActionButtons.tsx
 create mode 100644 client/app/components/ActionButtons/index.ts
 create mode 100644 client/app/components/AddMovieForm/AddMovieForm.tsx
 create mode 100644 client/app/components/AddMovieForm/index.ts
 create mode 100644 client/app/components/BatchEditMovieForm/BatchEditMovieForm.tsx
 create mode 100644 client/app/components/BatchEditMovieForm/index.ts
 create mode 100644 client/app/components/EditMovieForm/EditMovieForm.module.css
 create mode 100644 client/app/components/EditMovieForm/EditMovieForm.tsx
 create mode 100644 client/app/components/EditMovieForm/index.ts
 create mode 100644 client/app/components/LoadingSkeleton/LoadingSkeleton.module.css
 create mode 100644 client/app/components/LoadingSkeleton/LoadingSkeleton.tsx
 create mode 100644 client/app/components/LoadingSkeleton/index.ts
 create mode 100644 client/app/components/PageSizeSelector/PageSizeSelector.module.css
 create mode 100644 client/app/components/PageSizeSelector/PageSizeSelector.tsx
 create mode 100644 client/app/components/PageSizeSelector/index.ts
 create mode 100644 client/app/components/Pagination/Pagination.module.css
 create mode 100644 client/app/components/Pagination/Pagination.tsx
 create mode 100644 client/app/components/Pagination/index.ts
 create mode 100644 client/app/layout.module.css
 create mode 100644 client/app/movie/[id]/error.module.css
 create mode 100644 client/app/movie/[id]/error.tsx
 create mode 100644 client/app/movie/[id]/loading.tsx
 create mode 100644 client/app/movie/[id]/not-found.module.css
 create mode 100644 client/app/movie/[id]/not-found.tsx
 create mode 100644 client/app/movie/[id]/page.module.css
 create mode 100644 client/app/movie/[id]/page.tsx
 delete mode 100644 client/app/movies/loading.module.css

diff --git a/client/app/components/ActionButtons/ActionButtons.module.css b/client/app/components/ActionButtons/ActionButtons.module.css
new file mode 100644
index 0000000..7372279
--- /dev/null
+++ b/client/app/components/ActionButtons/ActionButtons.module.css
@@ -0,0 +1,84 @@
+/**
+ * Action Buttons Styles
+ * 
+ * CSS Module for the action buttons component.
+ * Provides consistent styling with the rest of the application.
+ */
+
+.actionButtons {
+  display: flex;
+  gap: 1rem;
+  margin-bottom: 2rem;
+  justify-content: flex-start;
+}
+
+.button {
+  padding: 0.75rem 1.5rem;
+  border: none;
+  border-radius: 8px;
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  text-decoration: none;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 120px;
+}
+
+.button:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  transform: none;
+}
+
+.editButton {
+  background: #0070f3;
+  color: white;
+  border: 1px solid #0070f3;
+}
+
+.editButton:hover:not(:disabled) {
+  background: #0051cc;
+  border-color: #0051cc;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(0, 112, 243, 0.3);
+}
+
+.deleteButton {
+  background: #dc2626;
+  color: white;
+  border: 1px solid #dc2626;
+}
+
+.deleteButton:hover:not(:disabled) {
+  background: #b91c1c;
+  border-color: #b91c1c;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(220, 38, 38, 0.3);
+}
+
+/* Responsive Design */
+@media (max-width: 768px) {
+  .actionButtons {
+    flex-direction: column;
+    gap: 0.75rem;
+  }
+
+  .button {
+    width: 100%;
+    padding: 0.875rem 1rem;
+  }
+}
+
+@media (max-width: 480px) {
+  .actionButtons {
+    gap: 0.5rem;
+  }
+
+  .button {
+    padding: 0.75rem 1rem;
+    font-size: 0.9rem;
+  }
+}
\ No newline at end of file
diff --git a/client/app/components/ActionButtons/ActionButtons.tsx b/client/app/components/ActionButtons/ActionButtons.tsx
new file mode 100644
index 0000000..eae57b1
--- /dev/null
+++ b/client/app/components/ActionButtons/ActionButtons.tsx
@@ -0,0 +1,45 @@
+'use client';
+
+/**
+ * Action Buttons Component
+ * 
+ * Provides Edit and Delete actions for movie details page
+ */
+
+import styles from './ActionButtons.module.css';
+
+interface ActionButtonsProps {
+  onEdit: () => void;
+  onDelete: () => void;
+  isLoading?: boolean;
+  disabled?: boolean;
+}
+
+export default function ActionButtons({ 
+  onEdit, 
+  onDelete, 
+  isLoading = false, 
+  disabled = false 
+}: ActionButtonsProps) {
+  return (
+    <div className={styles.actionButtons}>
+      <button
+        onClick={onEdit}
+        disabled={disabled || isLoading}
+        className={`${styles.button} ${styles.editButton}`}
+        type="button"
+      >
+        {isLoading ? 'Loading...' : 'Edit Movie'}
+      </button>
+      
+      <button
+        onClick={onDelete}
+        disabled={disabled || isLoading}
+        className={`${styles.button} ${styles.deleteButton}`}
+        type="button"
+      >
+        {isLoading ? 'Loading...' : 'Delete Movie'}
+      </button>
+    </div>
+  );
+}
\ No newline at end of file
diff --git a/client/app/components/ActionButtons/index.ts b/client/app/components/ActionButtons/index.ts
new file mode 100644
index 0000000..eaca7eb
--- /dev/null
+++ b/client/app/components/ActionButtons/index.ts
@@ -0,0 +1 @@
+export { default } from './ActionButtons';
\ No newline at end of file
diff --git a/client/app/components/AddMovieForm/AddMovieForm.tsx b/client/app/components/AddMovieForm/AddMovieForm.tsx
new file mode 100644
index 0000000..d040adf
--- /dev/null
+++ b/client/app/components/AddMovieForm/AddMovieForm.tsx
@@ -0,0 +1,427 @@
+'use client';
+
+/**
+ * Add Movie Form Component
+ * 
+ * Form for creating new movies with validation.
+ * Supports both single movie creation and batch creation.
+ */
+
+import { useState } from 'react';
+import { Movie } from '../../types/movie';
+import styles from '../EditMovieForm/EditMovieForm.module.css';
+
+interface AddMovieFormProps {
+  onSave: (movieData: Omit<Movie, '_id'>[]) => void;
+  onCancel: () => void;
+  isLoading?: boolean;
+}
+
+interface MovieFormData {
+  title: string;
+  year: string;
+  plot: string;
+  runtime: string;
+  rated: string;
+  genres: string;
+  directors: string;
+  writers: string;
+  cast: string;
+  countries: string;
+  languages: string;
+  poster: string;
+}
+
+const getInitialFormData = (): MovieFormData => ({
+  title: '',
+  year: '',
+  plot: '',
+  runtime: '',
+  rated: '',
+  genres: '',
+  directors: '',
+  writers: '',
+  cast: '',
+  countries: '',
+  languages: '',
+  poster: '',
+});
+
+export default function AddMovieForm({ 
+  onSave, 
+  onCancel, 
+  isLoading = false 
+}: AddMovieFormProps) {
+  const [movieForms, setMovieForms] = useState<MovieFormData[]>([getInitialFormData()]);
+  const [errors, setErrors] = useState<Record<number, Record<string, string>>>({});
+
+  const validateForm = (formData: MovieFormData, index: number) => {
+    const newErrors: Record<string, string> = {};
+
+    if (!formData.title.trim()) {
+      newErrors.title = 'Title is required';
+    }
+
+    if (formData.year && (parseInt(formData.year) < 1800 || parseInt(formData.year) > new Date().getFullYear() + 5)) {
+      newErrors.year = 'Please enter a valid year';
+    }
+
+    if (formData.runtime && (parseInt(formData.runtime) < 1 || parseInt(formData.runtime) > 1000)) {
+      newErrors.runtime = 'Please enter a valid runtime in minutes';
+    }
+
+    return newErrors;
+  };
+
+  const validateAllForms = () => {
+    const allErrors: Record<number, Record<string, string>> = {};
+    let hasErrors = false;
+
+    movieForms.forEach((formData, index) => {
+      const formErrors = validateForm(formData, index);
+      if (Object.keys(formErrors).length > 0) {
+        allErrors[index] = formErrors;
+        hasErrors = true;
+      }
+    });
+
+    setErrors(allErrors);
+    return !hasErrors;
+  };
+
+  const convertFormDataToMovie = (formData: MovieFormData): Omit<Movie, '_id'> => {
+    const movieData: Omit<Movie, '_id'> = {
+      title: formData.title.trim(),
+      year: formData.year ? parseInt(formData.year) : undefined,
+      plot: formData.plot.trim() || undefined,
+      runtime: formData.runtime ? parseInt(formData.runtime) : undefined,
+      rated: formData.rated.trim() || undefined,
+      genres: formData.genres ? formData.genres.split(',').map(g => g.trim()).filter(g => g) : undefined,
+      directors: formData.directors ? formData.directors.split(',').map(d => d.trim()).filter(d => d) : undefined,
+      writers: formData.writers ? formData.writers.split(',').map(w => w.trim()).filter(w => w) : undefined,
+      cast: formData.cast ? formData.cast.split(',').map(c => c.trim()).filter(c => c) : undefined,
+      countries: formData.countries ? formData.countries.split(',').map(c => c.trim()).filter(c => c) : undefined,
+      languages: formData.languages ? formData.languages.split(',').map(l => l.trim()).filter(l => l) : undefined,
+      poster: formData.poster.trim() || undefined,
+    };
+
+    // Remove undefined values
+    return Object.fromEntries(
+      Object.entries(movieData).filter(([_, value]) => value !== undefined)
+    ) as Omit<Movie, '_id'>;
+  };
+
+  const handleSubmit = (e: React.FormEvent) => {
+    e.preventDefault();
+    
+    if (!validateAllForms()) {
+      return;
+    }
+
+    // Convert all form data to movie objects
+    const moviesData = movieForms.map(convertFormDataToMovie);
+    onSave(moviesData);
+  };
+
+  const handleInputChange = (index: number, field: string, value: string) => {
+    setMovieForms(prev => prev.map((form, i) => 
+      i === index ? { ...form, [field]: value } : form
+    ));
+
+    // Clear error when user starts typing
+    if (errors[index]?.[field]) {
+      setErrors(prev => ({
+        ...prev,
+        [index]: { ...prev[index], [field]: '' }
+      }));
+    }
+  };
+
+  const handleAddMore = () => {
+    setMovieForms(prev => [...prev, getInitialFormData()]);
+  };
+
+  const handleRemoveForm = (index: number) => {
+    if (movieForms.length > 1) {
+      setMovieForms(prev => prev.filter((_, i) => i !== index));
+      setErrors(prev => {
+        const newErrors = { ...prev };
+        delete newErrors[index];
+        // Reindex errors for forms after the removed one
+        Object.keys(newErrors).forEach(key => {
+          const keyNum = parseInt(key);
+          if (keyNum > index) {
+            newErrors[keyNum - 1] = newErrors[keyNum];
+            delete newErrors[keyNum];
+          }
+        });
+        return newErrors;
+      });
+    }
+  };
+
+  const renderMovieForm = (formData: MovieFormData, index: number) => {
+    const formErrors = errors[index] || {};
+
+    return (
+      <div key={index} className={styles.movieFormWrapper}>
+        {movieForms.length > 1 && (
+          <div className={styles.formHeader}>
+            <h3 className={styles.formSubtitle}>Movie {index + 1}</h3>
+            <button
+              type="button"
+              onClick={() => handleRemoveForm(index)}
+              className={styles.removeButton}
+              disabled={isLoading}
+              aria-label="Remove this movie form"
+            >
+              ✕
+            </button>
+          </div>
+        )}
+
+        <div className={styles.formGrid}>
+          {/* Title */}
+          <div className={styles.formGroup}>
+            <label htmlFor={`title-${index}`} className={styles.label}>
+              Title *
+            </label>
+            <input
+              type="text"
+              id={`title-${index}`}
+              value={formData.title}
+              onChange={(e) => handleInputChange(index, 'title', e.target.value)}
+              className={`${styles.input} ${formErrors.title ? styles.inputError : ''}`}
+              disabled={isLoading}
+              required
+            />
+            {formErrors.title && <span className={styles.error}>{formErrors.title}</span>}
+          </div>
+
+          {/* Year */}
+          <div className={styles.formGroup}>
+            <label htmlFor={`year-${index}`} className={styles.label}>
+              Year
+            </label>
+            <input
+              type="number"
+              id={`year-${index}`}
+              value={formData.year}
+              onChange={(e) => handleInputChange(index, 'year', e.target.value)}
+              className={`${styles.input} ${formErrors.year ? styles.inputError : ''}`}
+              disabled={isLoading}
+              min="1800"
+              max={new Date().getFullYear() + 5}
+            />
+            {formErrors.year && <span className={styles.error}>{formErrors.year}</span>}
+          </div>
+
+          {/* Runtime */}
+          <div className={styles.formGroup}>
+            <label htmlFor={`runtime-${index}`} className={styles.label}>
+              Runtime (minutes)
+            </label>
+            <input
+              type="number"
+              id={`runtime-${index}`}
+              value={formData.runtime}
+              onChange={(e) => handleInputChange(index, 'runtime', e.target.value)}
+              className={`${styles.input} ${formErrors.runtime ? styles.inputError : ''}`}
+              disabled={isLoading}
+              min="1"
+              max="1000"
+            />
+            {formErrors.runtime && <span className={styles.error}>{formErrors.runtime}</span>}
+          </div>
+
+          {/* Rated */}
+          <div className={styles.formGroup}>
+            <label htmlFor={`rated-${index}`} className={styles.label}>
+              Rating
+            </label>
+            <input
+              type="text"
+              id={`rated-${index}`}
+              value={formData.rated}
+              onChange={(e) => handleInputChange(index, 'rated', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="e.g., PG-13, R, G"
+            />
+          </div>
+
+          {/* Poster URL */}
+          <div className={styles.formGroup}>
+            <label htmlFor={`poster-${index}`} className={styles.label}>
+              Poster URL
+            </label>
+            <input
+              type="url"
+              id={`poster-${index}`}
+              value={formData.poster}
+              onChange={(e) => handleInputChange(index, 'poster', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="https://..."
+            />
+          </div>
+        </div>
+
+        {/* Plot */}
+        <div className={styles.formGroup}>
+          <label htmlFor={`plot-${index}`} className={styles.label}>
+            Plot
+          </label>
+          <textarea
+            id={`plot-${index}`}
+            value={formData.plot}
+            onChange={(e) => handleInputChange(index, 'plot', e.target.value)}
+            className={styles.textarea}
+            disabled={isLoading}
+            rows={4}
+            placeholder="Brief plot summary..."
+          />
+        </div>
+
+        {/* Lists (comma-separated) */}
+        <div className={styles.listFields}>
+          <div className={styles.formGroup}>
+            <label htmlFor={`genres-${index}`} className={styles.label}>
+              Genres (comma-separated)
+            </label>
+            <input
+              type="text"
+              id={`genres-${index}`}
+              value={formData.genres}
+              onChange={(e) => handleInputChange(index, 'genres', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="Action, Drama, Comedy"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor={`directors-${index}`} className={styles.label}>
+              Directors (comma-separated)
+            </label>
+            <input
+              type="text"
+              id={`directors-${index}`}
+              value={formData.directors}
+              onChange={(e) => handleInputChange(index, 'directors', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="Director 1, Director 2"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor={`writers-${index}`} className={styles.label}>
+              Writers (comma-separated)
+            </label>
+            <input
+              type="text"
+              id={`writers-${index}`}
+              value={formData.writers}
+              onChange={(e) => handleInputChange(index, 'writers', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="Writer 1, Writer 2"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor={`cast-${index}`} className={styles.label}>
+              Cast (comma-separated)
+            </label>
+            <input
+              type="text"
+              id={`cast-${index}`}
+              value={formData.cast}
+              onChange={(e) => handleInputChange(index, 'cast', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="Actor 1, Actor 2, Actor 3"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor={`countries-${index}`} className={styles.label}>
+              Countries (comma-separated)
+            </label>
+            <input
+              type="text"
+              id={`countries-${index}`}
+              value={formData.countries}
+              onChange={(e) => handleInputChange(index, 'countries', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="USA, UK, France"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor={`languages-${index}`} className={styles.label}>
+              Languages (comma-separated)
+            </label>
+            <input
+              type="text"
+              id={`languages-${index}`}
+              value={formData.languages}
+              onChange={(e) => handleInputChange(index, 'languages', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="English, Spanish, French"
+            />
+          </div>
+        </div>
+      </div>
+    );
+  };
+
+  return (
+    <div className={styles.formContainer}>
+      <h2 className={styles.formTitle}>
+        Add {movieForms.length === 1 ? 'New Movie' : `${movieForms.length} Movies`}
+      </h2>
+      
+      <form onSubmit={handleSubmit} className={styles.form}>
+        {movieForms.map((formData, index) => renderMovieForm(formData, index))}
+
+        {/* Add More Button */}
+        <div className={styles.addMoreSection}>
+          <button
+            type="button"
+            onClick={handleAddMore}
+            className={styles.addMoreButton}
+            disabled={isLoading}
+          >
+            + Add Another Movie
+          </button>
+        </div>
+
+        {/* Form Actions */}
+        <div className={styles.formActions}>
+          <button
+            type="button"
+            onClick={onCancel}
+            className={`${styles.button} ${styles.cancelButton}`}
+            disabled={isLoading}
+          >
+            Cancel
+          </button>
+          <button
+            type="submit"
+            className={`${styles.button} ${styles.saveButton}`}
+            disabled={isLoading}
+          >
+            {isLoading 
+              ? (movieForms.length === 1 ? 'Creating...' : 'Creating Movies...') 
+              : (movieForms.length === 1 ? 'Create Movie' : `Create ${movieForms.length} Movies`)
+            }
+          </button>
+        </div>
+      </form>
+    </div>
+  );
+}
\ No newline at end of file
diff --git a/client/app/components/AddMovieForm/index.ts b/client/app/components/AddMovieForm/index.ts
new file mode 100644
index 0000000..6b43b73
--- /dev/null
+++ b/client/app/components/AddMovieForm/index.ts
@@ -0,0 +1 @@
+export { default } from './AddMovieForm';
\ No newline at end of file
diff --git a/client/app/components/BatchEditMovieForm/BatchEditMovieForm.tsx b/client/app/components/BatchEditMovieForm/BatchEditMovieForm.tsx
new file mode 100644
index 0000000..10e55d5
--- /dev/null
+++ b/client/app/components/BatchEditMovieForm/BatchEditMovieForm.tsx
@@ -0,0 +1,363 @@
+'use client';
+
+/**
+ * Batch Edit Movie Form Component
+ * 
+ * Form for editing multiple movies at once with validation
+ */
+
+import { useState } from 'react';
+import { Movie } from '../../types/movie';
+import styles from '../EditMovieForm/EditMovieForm.module.css';
+
+interface BatchEditMovieFormProps {
+  selectedCount: number;
+  onSave: (updateData: Partial<Movie>) => void;
+  onCancel: () => void;
+  isLoading?: boolean;
+}
+
+export default function BatchEditMovieForm({ 
+  selectedCount,
+  onSave, 
+  onCancel, 
+  isLoading = false 
+}: BatchEditMovieFormProps) {
+  const [formData, setFormData] = useState({
+    title: '',
+    year: '',
+    plot: '',
+    runtime: '',
+    rated: '',
+    genres: '',
+    directors: '',
+    writers: '',
+    cast: '',
+    countries: '',
+    languages: '',
+    poster: '',
+  });
+
+  const [errors, setErrors] = useState<Record<string, string>>({});
+
+  const validateForm = () => {
+    const newErrors: Record<string, string> = {};
+
+    // For batch updates, we only validate if a field has a value and if
+    // that value must meet certain criteria.
+    // Empty fields will be ignored in the update
+
+    if (formData.year && (parseInt(formData.year) < 1800 || parseInt(formData.year) > new Date().getFullYear() + 5)) {
+      newErrors.year = 'Please enter a valid year';
+    }
+
+    if (formData.runtime && (parseInt(formData.runtime) < 1 || parseInt(formData.runtime) > 1000)) {
+      newErrors.runtime = 'Please enter a valid runtime in minutes';
+    }
+
+    setErrors(newErrors);
+    return Object.keys(newErrors).length === 0;
+  };
+
+  const handleSubmit = (e: React.FormEvent) => {
+    e.preventDefault();
+    
+    if (!validateForm()) {
+      return;
+    }
+
+    // Only include fields that have values
+    const updateData: Partial<Movie> = {};
+
+    if (formData.title.trim()) {
+      updateData.title = formData.title.trim();
+    }
+    if (formData.year) {
+      updateData.year = parseInt(formData.year);
+    }
+    if (formData.plot.trim()) {
+      updateData.plot = formData.plot.trim();
+    }
+    if (formData.runtime) {
+      updateData.runtime = parseInt(formData.runtime);
+    }
+    if (formData.rated.trim()) {
+      updateData.rated = formData.rated.trim();
+    }
+    if (formData.genres.trim()) {
+      updateData.genres = formData.genres.split(',').map(g => g.trim()).filter(g => g);
+    }
+    if (formData.directors.trim()) {
+      updateData.directors = formData.directors.split(',').map(d => d.trim()).filter(d => d);
+    }
+    if (formData.writers.trim()) {
+      updateData.writers = formData.writers.split(',').map(w => w.trim()).filter(w => w);
+    }
+    if (formData.cast.trim()) {
+      updateData.cast = formData.cast.split(',').map(c => c.trim()).filter(c => c);
+    }
+    if (formData.countries.trim()) {
+      updateData.countries = formData.countries.split(',').map(c => c.trim()).filter(c => c);
+    }
+    if (formData.languages.trim()) {
+      updateData.languages = formData.languages.split(',').map(l => l.trim()).filter(l => l);
+    }
+    if (formData.poster.trim()) {
+      updateData.poster = formData.poster.trim();
+    }
+
+    // Check if user entered anything for the batch update
+    if (Object.keys(updateData).length === 0) {
+      setErrors({ general: 'Please fill in at least one field to update' });
+      return;
+    }
+
+    onSave(updateData);
+  };
+
+  const handleInputChange = (field: string, value: string) => {
+    setFormData(prev => ({ ...prev, [field]: value }));
+    // Clear error when user starts typing
+    if (errors[field]) {
+      setErrors(prev => ({ ...prev, [field]: '' }));
+    }
+    // Clear general error
+    if (errors.general) {
+      setErrors(prev => ({ ...prev, general: '' }));
+    }
+  };
+
+  return (
+    <div className={styles.formContainer}>
+      <h2 className={styles.formTitle}>Batch Edit {selectedCount} Movies</h2>
+      <p className={styles.batchDescription}>
+        Only fill in the fields you want to update. Empty fields will be left unchanged on all selected movies.
+      </p>
+      
+      {errors.general && (
+        <div className={styles.generalError}>
+          {errors.general}
+        </div>
+      )}
+
+      <form onSubmit={handleSubmit} className={styles.form}>
+        <div className={styles.formGrid}>
+          {/* Title */}
+          <div className={styles.formGroup}>
+            <label htmlFor="title" className={styles.label}>
+              Title
+            </label>
+            <input
+              type="text"
+              id="title"
+              value={formData.title}
+              onChange={(e) => handleInputChange('title', e.target.value)}
+              className={`${styles.input} ${errors.title ? styles.inputError : ''}`}
+              disabled={isLoading}
+              placeholder="Leave empty to keep existing titles"
+            />
+            {errors.title && <span className={styles.error}>{errors.title}</span>}
+          </div>
+
+          {/* Year */}
+          <div className={styles.formGroup}>
+            <label htmlFor="year" className={styles.label}>
+              Year
+            </label>
+            <input
+              type="number"
+              id="year"
+              value={formData.year}
+              onChange={(e) => handleInputChange('year', e.target.value)}
+              className={`${styles.input} ${errors.year ? styles.inputError : ''}`}
+              disabled={isLoading}
+              min="1800"
+              max={new Date().getFullYear() + 5}
+              placeholder="Leave empty to keep existing years"
+            />
+            {errors.year && <span className={styles.error}>{errors.year}</span>}
+          </div>
+
+          {/* Runtime */}
+          <div className={styles.formGroup}>
+            <label htmlFor="runtime" className={styles.label}>
+              Runtime (minutes)
+            </label>
+            <input
+              type="number"
+              id="runtime"
+              value={formData.runtime}
+              onChange={(e) => handleInputChange('runtime', e.target.value)}
+              className={`${styles.input} ${errors.runtime ? styles.inputError : ''}`}
+              disabled={isLoading}
+              min="1"
+              max="1000"
+              placeholder="Leave empty to keep existing runtimes"
+            />
+            {errors.runtime && <span className={styles.error}>{errors.runtime}</span>}
+          </div>
+
+          {/* Rated */}
+          <div className={styles.formGroup}>
+            <label htmlFor="rated" className={styles.label}>
+              Rating
+            </label>
+            <input
+              type="text"
+              id="rated"
+              value={formData.rated}
+              onChange={(e) => handleInputChange('rated', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="PG-13"
+            />
+          </div>
+
+          {/* Poster URL */}
+          <div className={styles.formGroup}>
+            <label htmlFor="poster" className={styles.label}>
+              Poster URL
+            </label>
+            <input
+              type="url"
+              id="poster"
+              value={formData.poster}
+              onChange={(e) => handleInputChange('poster', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="https://..."
+            />
+          </div>
+        </div>
+
+        {/* Plot */}
+        <div className={styles.formGroup}>
+          <label htmlFor="plot" className={styles.label}>
+            Plot
+          </label>
+          <textarea
+            id="plot"
+            value={formData.plot}
+            onChange={(e) => handleInputChange('plot', e.target.value)}
+            className={styles.textarea}
+            disabled={isLoading}
+            rows={4}
+            placeholder="Leave empty to keep existing plots"
+          />
+        </div>
+
+        {/* Lists (comma-separated) */}
+        <div className={styles.listFields}>
+          <div className={styles.formGroup}>
+            <label htmlFor="genres" className={styles.label}>
+              Genres (comma-separated)
+            </label>
+            <input
+              type="text"
+              id="genres"
+              value={formData.genres}
+              onChange={(e) => handleInputChange('genres', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="e.g. Action, Drama, Comedy"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor="directors" className={styles.label}>
+              Directors (comma-separated)
+            </label>
+            <input
+              type="text"
+              id="directors"
+              value={formData.directors}
+              onChange={(e) => handleInputChange('directors', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="e.g. Director 1, Director 2"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor="writers" className={styles.label}>
+              Writers (comma-separated)
+            </label>
+            <input
+              type="text"
+              id="writers"
+              value={formData.writers}
+              onChange={(e) => handleInputChange('writers', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="e.g. Writer 1, Writer 2"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor="cast" className={styles.label}>
+              Cast (comma-separated)
+            </label>
+            <input
+              type="text"
+              id="cast"
+              value={formData.cast}
+              onChange={(e) => handleInputChange('cast', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="e.g. Actor 1, Actor 2, Actor 3"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor="countries" className={styles.label}>
+              Countries (comma-separated)
+            </label>
+            <input
+              type="text"
+              id="countries"
+              value={formData.countries}
+              onChange={(e) => handleInputChange('countries', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="e.g. USA, UK, France"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor="languages" className={styles.label}>
+              Languages (comma-separated)
+            </label>
+            <input
+              type="text"
+              id="languages"
+              value={formData.languages}
+              onChange={(e) => handleInputChange('languages', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="e.g. English, Spanish, French"
+            />
+          </div>
+        </div>
+
+        {/* Form Actions */}
+        <div className={styles.formActions}>
+          <button
+            type="button"
+            onClick={onCancel}
+            className={`${styles.button} ${styles.cancelButton}`}
+            disabled={isLoading}
+          >
+            Cancel
+          </button>
+          <button
+            type="submit"
+            className={`${styles.button} ${styles.saveButton}`}
+            disabled={isLoading}
+          >
+            {isLoading ? 'Updating...' : `Update ${selectedCount} Movies`}
+          </button>
+        </div>
+      </form>
+    </div>
+  );
+}
\ No newline at end of file
diff --git a/client/app/components/BatchEditMovieForm/index.ts b/client/app/components/BatchEditMovieForm/index.ts
new file mode 100644
index 0000000..cc221ef
--- /dev/null
+++ b/client/app/components/BatchEditMovieForm/index.ts
@@ -0,0 +1 @@
+export { default } from './BatchEditMovieForm';
\ No newline at end of file
diff --git a/client/app/components/EditMovieForm/EditMovieForm.module.css b/client/app/components/EditMovieForm/EditMovieForm.module.css
new file mode 100644
index 0000000..c5887d8
--- /dev/null
+++ b/client/app/components/EditMovieForm/EditMovieForm.module.css
@@ -0,0 +1,308 @@
+/**
+ * Edit Movie Form Styles
+ * 
+ * CSS Module for the edit movie form component.
+ * Provides consistent styling with the rest of the application.
+ */
+
+.formContainer {
+  background: white;
+  border-radius: 12px;
+  padding: 2rem;
+  box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
+  margin-bottom: 2rem;
+}
+
+.formTitle {
+  font-size: 1.75rem;
+  font-weight: bold;
+  color: #333;
+  margin: 0 0 1.5rem 0;
+  text-align: center;
+}
+
+.batchDescription {
+  background-color: #f8f9fa;
+  border: 1px solid #e9ecef;
+  border-radius: 8px;
+  padding: 1rem;
+  margin-bottom: 1.5rem;
+  color: #495057;
+  font-size: 0.9rem;
+  line-height: 1.4;
+  text-align: center;
+}
+
+.generalError {
+  background-color: #f8d7da;
+  border: 1px solid #f5c6cb;
+  color: #721c24;
+  padding: 0.75rem 1rem;
+  border-radius: 8px;
+  margin-bottom: 1rem;
+  font-size: 0.9rem;
+  text-align: center;
+}
+
+.form {
+  width: 100%;
+}
+
+.formGrid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+  gap: 1.5rem;
+  margin-bottom: 1.5rem;
+}
+
+.formGroup {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.label {
+  font-weight: 500;
+  color: #333;
+  font-size: 0.9rem;
+}
+
+.input,
+.textarea {
+  padding: 0.75rem;
+  border: 2px solid #e1e5e9;
+  border-radius: 8px;
+  font-size: 1rem;
+  transition: border-color 0.2s ease, box-shadow 0.2s ease;
+  background: white;
+}
+
+.input:focus,
+.textarea:focus {
+  outline: none;
+  border-color: #0070f3;
+  box-shadow: 0 0 0 3px rgba(0, 112, 243, 0.1);
+}
+
+.input:disabled,
+.textarea:disabled {
+  background: #f8f9fa;
+  color: #6c757d;
+  cursor: not-allowed;
+}
+
+.inputError {
+  border-color: #dc2626 !important;
+}
+
+.inputError:focus {
+  box-shadow: 0 0 0 3px rgba(220, 38, 38, 0.1) !important;
+}
+
+.textarea {
+  resize: vertical;
+  min-height: 100px;
+  font-family: inherit;
+}
+
+.error {
+  color: #dc2626;
+  font-size: 0.875rem;
+  margin-top: 0.25rem;
+}
+
+.listFields {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+  gap: 1.5rem;
+  margin-bottom: 1.5rem;
+}
+
+.formActions {
+  display: flex;
+  gap: 1rem;
+  justify-content: flex-end;
+  padding-top: 1.5rem;
+  border-top: 1px solid #e1e5e9;
+}
+
+.button {
+  padding: 0.75rem 1.5rem;
+  border: none;
+  border-radius: 8px;
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  min-width: 120px;
+}
+
+.button:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  transform: none;
+}
+
+.saveButton {
+  background: #0070f3;
+  color: white;
+  border: 1px solid #0070f3;
+}
+
+.saveButton:hover:not(:disabled) {
+  background: #0051cc;
+  border-color: #0051cc;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(0, 112, 243, 0.3);
+}
+
+.cancelButton {
+  background: #6c757d;
+  color: white;
+  border: 1px solid #6c757d;
+}
+
+.cancelButton:hover:not(:disabled) {
+  background: #5a6268;
+  border-color: #5a6268;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(108, 117, 125, 0.3);
+}
+
+/* Multi-movie form styles */
+.movieFormWrapper {
+  border: 1px solid #e1e5e9;
+  border-radius: 8px;
+  padding: 1.5rem;
+  margin-bottom: 1.5rem;
+  background: #fafbfc;
+  position: relative;
+}
+
+.formHeader {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: 1rem;
+  padding-bottom: 0.5rem;
+  border-bottom: 1px solid #e1e5e9;
+}
+
+.formSubtitle {
+  font-size: 1.25rem;
+  font-weight: 600;
+  color: #333;
+  margin: 0;
+}
+
+.removeButton {
+  background: #dc2626;
+  color: white;
+  border: none;
+  border-radius: 50%;
+  width: 28px;
+  height: 28px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  font-size: 14px;
+  font-weight: bold;
+  transition: all 0.2s ease;
+}
+
+.removeButton:hover:not(:disabled) {
+  background: #b91c1c;
+  transform: scale(1.1);
+}
+
+.removeButton:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  transform: none;
+}
+
+.addMoreSection {
+  display: flex;
+  justify-content: center;
+  margin-bottom: 1.5rem;
+  padding: 1rem 0;
+}
+
+.addMoreButton {
+  background: #059669;
+  color: white;
+  border: none;
+  border-radius: 8px;
+  padding: 0.75rem 1.5rem;
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  border: 1px solid #059669;
+}
+
+.addMoreButton:hover:not(:disabled) {
+  background: #047857;
+  border-color: #047857;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(5, 150, 105, 0.3);
+}
+
+.addMoreButton:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  transform: none;
+}
+
+/* Responsive Design */
+@media (max-width: 768px) {
+  .formContainer {
+    padding: 1.5rem;
+  }
+
+  .formGrid {
+    grid-template-columns: 1fr;
+    gap: 1rem;
+  }
+
+  .listFields {
+    grid-template-columns: 1fr;
+    gap: 1rem;
+  }
+
+  .formActions {
+    flex-direction: column-reverse;
+    gap: 0.75rem;
+  }
+
+  .button {
+    width: 100%;
+  }
+}
+
+@media (max-width: 480px) {
+  .formContainer {
+    padding: 1rem;
+  }
+
+  .formTitle {
+    font-size: 1.5rem;
+  }
+
+  .formGrid,
+  .listFields {
+    gap: 0.75rem;
+  }
+
+  .input,
+  .textarea {
+    padding: 0.625rem;
+    font-size: 0.9rem;
+  }
+
+  .button {
+    padding: 0.75rem 1rem;
+    font-size: 0.9rem;
+  }
+}
\ No newline at end of file
diff --git a/client/app/components/EditMovieForm/EditMovieForm.tsx b/client/app/components/EditMovieForm/EditMovieForm.tsx
new file mode 100644
index 0000000..398b0b6
--- /dev/null
+++ b/client/app/components/EditMovieForm/EditMovieForm.tsx
@@ -0,0 +1,329 @@
+'use client';
+
+/**
+ * Edit Movie Form Component
+ * 
+ * Form for editing movie details with validation
+ */
+
+import { useState, useEffect } from 'react';
+import { Movie } from '../../types/movie';
+import styles from './EditMovieForm.module.css';
+
+interface EditMovieFormProps {
+  movie: Movie;
+  onSave: (updateData: Partial<Movie>) => void;
+  onCancel: () => void;
+  isLoading?: boolean;
+}
+
+export default function EditMovieForm({ 
+  movie, 
+  onSave, 
+  onCancel, 
+  isLoading = false 
+}: EditMovieFormProps) {
+  const [formData, setFormData] = useState({
+    title: movie.title || '',
+    year: movie.year ? movie.year.toString() : '',
+    plot: movie.plot || '',
+    runtime: movie.runtime ? movie.runtime.toString() : '',
+    rated: movie.rated || '',
+    genres: movie.genres?.join(', ') || '',
+    directors: movie.directors?.join(', ') || '',
+    writers: movie.writers?.join(', ') || '',
+    cast: movie.cast?.join(', ') || '',
+    countries: movie.countries?.join(', ') || '',
+    languages: movie.languages?.join(', ') || '',
+    poster: movie.poster || '',
+  });
+
+  const [errors, setErrors] = useState<Record<string, string>>({});
+
+  const validateForm = () => {
+    const newErrors: Record<string, string> = {};
+
+    if (!formData.title.trim()) {
+      newErrors.title = 'Title is required';
+    }
+
+    if (formData.year && (parseInt(formData.year) < 1800 || parseInt(formData.year) > new Date().getFullYear() + 5)) {
+      newErrors.year = 'Please enter a valid year';
+    }
+
+    if (formData.runtime && (parseInt(formData.runtime) < 1 || parseInt(formData.runtime) > 1000)) {
+      newErrors.runtime = 'Please enter a valid runtime in minutes';
+    }
+
+    setErrors(newErrors);
+    return Object.keys(newErrors).length === 0;
+  };
+
+  const handleSubmit = (e: React.FormEvent) => {
+    e.preventDefault();
+    
+    if (!validateForm()) {
+      return;
+    }
+
+    // Convert form data back to movie structure
+    const updateData: Partial<Movie> = {
+      title: formData.title.trim(),
+      year: formData.year ? parseInt(formData.year) : undefined,
+      plot: formData.plot.trim() || undefined,
+      runtime: formData.runtime ? parseInt(formData.runtime) : undefined,
+      rated: formData.rated.trim() || undefined,
+      genres: formData.genres ? formData.genres.split(',').map(g => g.trim()).filter(g => g) : undefined,
+      directors: formData.directors ? formData.directors.split(',').map(d => d.trim()).filter(d => d) : undefined,
+      writers: formData.writers ? formData.writers.split(',').map(w => w.trim()).filter(w => w) : undefined,
+      cast: formData.cast ? formData.cast.split(',').map(c => c.trim()).filter(c => c) : undefined,
+      countries: formData.countries ? formData.countries.split(',').map(c => c.trim()).filter(c => c) : undefined,
+      languages: formData.languages ? formData.languages.split(',').map(l => l.trim()).filter(l => l) : undefined,
+      poster: formData.poster.trim() || undefined,
+    };
+
+    // Remove undefined values
+    const cleanedData = Object.fromEntries(
+      Object.entries(updateData).filter(([_, value]) => value !== undefined)
+    );
+
+    // Check if user entered anything for the batch update
+    if (Object.keys(updateData).length === 0) {
+      setErrors({ general: 'Please fill in at least one field to update' });
+      return;
+    }
+
+    onSave(cleanedData);
+  };
+
+  const handleInputChange = (field: string, value: string) => {
+    setFormData(prev => ({ ...prev, [field]: value }));
+    // Clear error when user starts typing
+    if (errors[field]) {
+      setErrors(prev => ({ ...prev, [field]: '' }));
+    }
+  };
+
+  return (
+    <div className={styles.formContainer}>
+      <h2 className={styles.formTitle}>Edit Movie</h2>
+      
+      <form onSubmit={handleSubmit} className={styles.form}>
+        <div className={styles.formGrid}>
+          {/* Title */}
+          <div className={styles.formGroup}>
+            <label htmlFor="title" className={styles.label}>
+              Title *
+            </label>
+            <input
+              type="text"
+              id="title"
+              value={formData.title}
+              onChange={(e) => handleInputChange('title', e.target.value)}
+              className={`${styles.input} ${errors.title ? styles.inputError : ''}`}
+              disabled={isLoading}
+              required
+            />
+            {errors.title && <span className={styles.error}>{errors.title}</span>}
+          </div>
+
+          {/* Year */}
+          <div className={styles.formGroup}>
+            <label htmlFor="year" className={styles.label}>
+              Year
+            </label>
+            <input
+              type="number"
+              id="year"
+              value={formData.year}
+              onChange={(e) => handleInputChange('year', e.target.value)}
+              className={`${styles.input} ${errors.year ? styles.inputError : ''}`}
+              disabled={isLoading}
+              min="1800"
+              max={new Date().getFullYear() + 5}
+            />
+            {errors.year && <span className={styles.error}>{errors.year}</span>}
+          </div>
+
+          {/* Runtime */}
+          <div className={styles.formGroup}>
+            <label htmlFor="runtime" className={styles.label}>
+              Runtime (minutes)
+            </label>
+            <input
+              type="number"
+              id="runtime"
+              value={formData.runtime}
+              onChange={(e) => handleInputChange('runtime', e.target.value)}
+              className={`${styles.input} ${errors.runtime ? styles.inputError : ''}`}
+              disabled={isLoading}
+              min="1"
+              max="1000"
+            />
+            {errors.runtime && <span className={styles.error}>{errors.runtime}</span>}
+          </div>
+
+          {/* Rated */}
+          <div className={styles.formGroup}>
+            <label htmlFor="rated" className={styles.label}>
+              Rating
+            </label>
+            <input
+              type="text"
+              id="rated"
+              value={formData.rated}
+              onChange={(e) => handleInputChange('rated', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="PG-13"
+            />
+          </div>
+
+          {/* Poster URL */}
+          <div className={styles.formGroup}>
+            <label htmlFor="poster" className={styles.label}>
+              Poster URL
+            </label>
+            <input
+              type="url"
+              id="poster"
+              value={formData.poster}
+              onChange={(e) => handleInputChange('poster', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="https://..."
+            />
+          </div>
+        </div>
+
+        {/* Plot */}
+        <div className={styles.formGroup}>
+          <label htmlFor="plot" className={styles.label}>
+            Plot
+          </label>
+          <textarea
+            id="plot"
+            value={formData.plot}
+            onChange={(e) => handleInputChange('plot', e.target.value)}
+            className={styles.textarea}
+            disabled={isLoading}
+            rows={4}
+            placeholder="Brief plot summary..."
+          />
+        </div>
+
+        {/* Lists (comma-separated) */}
+        <div className={styles.listFields}>
+          <div className={styles.formGroup}>
+            <label htmlFor="genres" className={styles.label}>
+              Genres (comma-separated)
+            </label>
+            <input
+              type="text"
+              id="genres"
+              value={formData.genres}
+              onChange={(e) => handleInputChange('genres', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="e.g. Action, Drama, Comedy"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor="directors" className={styles.label}>
+              Directors (comma-separated)
+            </label>
+            <input
+              type="text"
+              id="directors"
+              value={formData.directors}
+              onChange={(e) => handleInputChange('directors', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="e.g. Director 1, Director 2"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor="writers" className={styles.label}>
+              Writers (comma-separated)
+            </label>
+            <input
+              type="text"
+              id="writers"
+              value={formData.writers}
+              onChange={(e) => handleInputChange('writers', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="e.g. Writer 1, Writer 2"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor="cast" className={styles.label}>
+              Cast (comma-separated)
+            </label>
+            <input
+              type="text"
+              id="cast"
+              value={formData.cast}
+              onChange={(e) => handleInputChange('cast', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="e.g. Actor 1, Actor 2, Actor 3"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor="countries" className={styles.label}>
+              Countries (comma-separated)
+            </label>
+            <input
+              type="text"
+              id="countries"
+              value={formData.countries}
+              onChange={(e) => handleInputChange('countries', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="e.g. USA, UK, France"
+            />
+          </div>
+
+          <div className={styles.formGroup}>
+            <label htmlFor="languages" className={styles.label}>
+              Languages (comma-separated)
+            </label>
+            <input
+              type="text"
+              id="languages"
+              value={formData.languages}
+              onChange={(e) => handleInputChange('languages', e.target.value)}
+              className={styles.input}
+              disabled={isLoading}
+              placeholder="e.g. English, Spanish, French"
+            />
+          </div>
+        </div>
+
+        {/* Form Actions */}
+        <div className={styles.formActions}>
+          <button
+            type="button"
+            onClick={onCancel}
+            className={`${styles.button} ${styles.cancelButton}`}
+            disabled={isLoading}
+          >
+            Cancel
+          </button>
+          <button
+            type="submit"
+            className={`${styles.button} ${styles.saveButton}`}
+            disabled={isLoading}
+          >
+            {isLoading ? 'Saving...' : 'Save Changes'}
+          </button>
+        </div>
+      </form>
+    </div>
+  );
+}
\ No newline at end of file
diff --git a/client/app/components/EditMovieForm/index.ts b/client/app/components/EditMovieForm/index.ts
new file mode 100644
index 0000000..9441584
--- /dev/null
+++ b/client/app/components/EditMovieForm/index.ts
@@ -0,0 +1 @@
+export { default } from './EditMovieForm';
\ No newline at end of file
diff --git a/client/app/components/LoadingSkeleton/LoadingSkeleton.module.css b/client/app/components/LoadingSkeleton/LoadingSkeleton.module.css
new file mode 100644
index 0000000..9fd700e
--- /dev/null
+++ b/client/app/components/LoadingSkeleton/LoadingSkeleton.module.css
@@ -0,0 +1,215 @@
+/**
+ * Loading Skeleton Styles
+ * 
+ * Reusable skeleton loading animations and styles
+ */
+
+/* Base skeleton element */
+.skeleton {
+  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+  background-size: 200% 100%;
+  animation: loading 1.5s infinite;
+  border-radius: 4px;
+}
+
+/* Loading animation */
+@keyframes loading {
+  0% {
+    background-position: 200% 0;
+  }
+  100% {
+    background-position: -200% 0;
+  }
+}
+
+/* Skeleton variants */
+.skeletonText {
+  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+  background-size: 200% 100%;
+  animation: loading 1.5s infinite;
+  border-radius: 4px;
+  height: 16px;
+  margin-bottom: 0.5rem;
+}
+
+.skeletonTitle {
+  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+  background-size: 200% 100%;
+  animation: loading 1.5s infinite;
+  border-radius: 4px;
+  height: 24px;
+  margin-bottom: 1rem;
+}
+
+.skeletonLargeTitle {
+  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+  background-size: 200% 100%;
+  animation: loading 1.5s infinite;
+  border-radius: 4px;
+  height: 40px;
+  margin-bottom: 1rem;
+}
+
+.skeletonButton {
+  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+  background-size: 200% 100%;
+  animation: loading 1.5s infinite;
+  border-radius: 6px;
+  height: 40px;
+}
+
+.skeletonCard {
+  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+  background-size: 200% 100%;
+  animation: loading 1.5s infinite;
+  border-radius: 8px;
+  height: 300px;
+}
+
+.skeletonAvatar {
+  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+  background-size: 200% 100%;
+  animation: loading 1.5s infinite;
+  border-radius: 50%;
+  width: 40px;
+  height: 40px;
+}
+
+.skeletonInput {
+  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+  background-size: 200% 100%;
+  animation: loading 1.5s infinite;
+  border-radius: 6px;
+  height: 38px;
+}
+
+/* Size variants */
+.skeletonSmall {
+  width: 60px;
+}
+
+.skeletonMedium {
+  width: 120px;
+}
+
+.skeletonLarge {
+  width: 80%;
+}
+
+.skeletonFull {
+  width: 100%;
+}
+
+.skeletonHalf {
+  width: 50%;
+}
+
+/* Container styles */
+.skeletonContainer {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.skeletonRow {
+  display: flex;
+  gap: 1rem;
+  align-items: center;
+}
+
+.skeletonGrid {
+  display: grid;
+  gap: 1rem;
+}
+
+.ratingsGrid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
+  gap: 1rem;
+}
+
+/* Movie-specific skeletons */
+.movieCardSkeleton {
+  border: 1px solid #eee;
+  border-radius: 8px;
+  padding: 16px;
+  background: white;
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+}
+
+.posterSkeleton {
+  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+  background-size: 200% 100%;
+  animation: loading 1.5s infinite;
+  border-radius: 4px;
+  width: 100%;
+  height: 300px;
+}
+
+.movieInfoSkeleton {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+/* Page selector skeleton */
+.pageSelectorSkeleton {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin-bottom: 2rem;
+  justify-content: center;
+}
+
+/* Pagination skeleton */
+.paginationSkeleton {
+  margin: 3rem 0;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 1rem;
+}
+
+.paginationButtonsSkeleton {
+  display: flex;
+  align-items: center;
+  gap: 2rem;
+}
+
+/* Rating card skeleton */
+.ratingCardSkeleton {
+  background: linear-gradient(90deg, #f8f8f8 25%, #e9ecef 50%, #f8f8f8 75%);
+  background-size: 200% 100%;
+  animation: loading 1.5s infinite;
+  border-radius: 8px;
+  padding: 1rem;
+  text-align: center;
+  border: 1px solid #e9ecef;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  align-items: center;
+}
+
+/* Responsive adjustments */
+@media (max-width: 768px) {
+  .movieCardSkeleton {
+    padding: 12px;
+  }
+  
+  .posterSkeleton {
+    height: 240px;
+  }
+}
+
+@media (max-width: 480px) {
+  .posterSkeleton {
+    height: 200px;
+  }
+  
+  .paginationButtonsSkeleton {
+    gap: 0.5rem;
+  }
+}
\ No newline at end of file
diff --git a/client/app/components/LoadingSkeleton/LoadingSkeleton.tsx b/client/app/components/LoadingSkeleton/LoadingSkeleton.tsx
new file mode 100644
index 0000000..5a36b64
--- /dev/null
+++ b/client/app/components/LoadingSkeleton/LoadingSkeleton.tsx
@@ -0,0 +1,113 @@
+import styles from './LoadingSkeleton.module.css';
+
+interface SkeletonProps {
+  variant?: 'text' | 'title' | 'largeTitle' | 'button' | 'card' | 'avatar' | 'input';
+  size?: 'small' | 'medium' | 'large' | 'full' | 'half';
+  width?: string;
+  height?: string;
+  className?: string;
+}
+
+export function Skeleton({ 
+  variant = 'text', 
+  size,
+  width, 
+  height, 
+  className = '' 
+}: SkeletonProps) {
+  const baseClass = styles[`skeleton${variant.charAt(0).toUpperCase() + variant.slice(1)}`];
+  const sizeClass = size ? styles[`skeleton${size.charAt(0).toUpperCase() + size.slice(1)}`] : '';
+  
+  const style: React.CSSProperties = {};
+  if (width) style.width = width;
+  if (height) style.height = height;
+
+  return (
+    <div 
+      className={`${baseClass} ${sizeClass} ${className}`.trim()}
+      style={style}
+    />
+  );
+}
+
+export function MovieCardSkeleton() {
+  return (
+    <div className={styles.movieCardSkeleton}>
+      <Skeleton variant="card" className={styles.posterSkeleton} />
+      <div className={styles.movieInfoSkeleton}>
+        <Skeleton variant="title" size="large" />
+        <Skeleton variant="text" size="medium" />
+        <Skeleton variant="text" size="small" />
+        <Skeleton variant="button" />
+      </div>
+    </div>
+  );
+}
+
+export function PageSelectorSkeleton() {
+  return (
+    <div className={styles.pageSelectorSkeleton}>
+      <Skeleton variant="text" width="120px" />
+      <Skeleton variant="input" width="60px" />
+    </div>
+  );
+}
+
+export function PaginationSkeleton() {
+  return (
+    <div className={styles.paginationSkeleton}>
+      <div className={styles.paginationButtonsSkeleton}>
+        <Skeleton variant="button" width="80px" />
+        <Skeleton variant="text" width="60px" />
+        <Skeleton variant="button" width="80px" />
+      </div>
+    </div>
+  );
+}
+
+export function RatingCardSkeleton() {
+  return (
+    <div className={styles.ratingCardSkeleton}>
+      <Skeleton variant="text" width="60px" height="14px" />
+      <Skeleton variant="text" width="40px" height="20px" />
+      <Skeleton variant="text" width="80px" height="12px" />
+    </div>
+  );
+}
+
+export function MovieDetailsSkeleton() {
+  return (
+    <>
+      {/* Back link skeleton */}
+      <Skeleton variant="text" width="100px" height="20px" />
+      
+      {/* Title skeleton */}
+      <Skeleton variant="largeTitle" size="half" />
+      
+      {/* Basic info skeleton */}
+      <div className={styles.skeletonContainer}>
+        {[...Array(4)].map((_, i) => (
+          <div key={i} className={styles.skeletonRow}>
+            <Skeleton variant="text" size="small" />
+            <Skeleton variant="text" size="medium" />
+          </div>
+        ))}
+      </div>
+      
+      {/* Ratings skeleton */}
+      <div className={styles.ratingsGrid}>
+        {[...Array(3)].map((_, i) => (
+          <RatingCardSkeleton key={i} />
+        ))}
+      </div>
+      
+      {/* Plot skeleton */}
+      <div className={styles.skeletonContainer}>
+        <Skeleton variant="title" width="60px" />
+        <Skeleton variant="text" size="full" />
+        <Skeleton variant="text" size="large" />
+        <Skeleton variant="text" size="large" />
+      </div>
+    </>
+  );
+}
\ No newline at end of file
diff --git a/client/app/components/LoadingSkeleton/index.ts b/client/app/components/LoadingSkeleton/index.ts
new file mode 100644
index 0000000..46b83f3
--- /dev/null
+++ b/client/app/components/LoadingSkeleton/index.ts
@@ -0,0 +1,8 @@
+export { 
+  Skeleton, 
+  MovieCardSkeleton, 
+  PageSelectorSkeleton, 
+  PaginationSkeleton, 
+  RatingCardSkeleton, 
+  MovieDetailsSkeleton 
+} from './LoadingSkeleton';
\ No newline at end of file
diff --git a/client/app/components/MovieCard/MovieCard.module.css b/client/app/components/MovieCard/MovieCard.module.css
index 770da86..bfce2e7 100644
--- a/client/app/components/MovieCard/MovieCard.module.css
+++ b/client/app/components/MovieCard/MovieCard.module.css
@@ -1,7 +1,7 @@
 /**
- * Movies Page Styles
+ * Movies Card Styles
  * 
- * CSS Module for the movies page component.
+ * CSS Module for the movies card component.
  * Provides responsive grid layout and movie card styling.
  */
 
@@ -19,7 +19,8 @@
   padding: 16px;
   background: white;
   box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
-  transition: transform 0.2s ease, box-shadow 0.2s ease;
+  transition: transform 0.2s ease, box-shadow 0.2s ease, border-color 0.2s ease;
+  position: relative;
 }
 
 .movieCard:hover {
@@ -27,6 +28,31 @@
   box-shadow: 0 4px 8px rgba(0, 0, 0, 0.15);
 }
 
+.movieCard.selected {
+  border-color: #0070f3;
+  box-shadow: 0 2px 4px rgba(0, 112, 243, 0.2);
+}
+
+.selectionCheckbox {
+  position: absolute;
+  top: 12px;
+  right: 12px;
+  z-index: 2;
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  background: rgba(255, 255, 255, 0.9);
+  padding: 4px 8px;
+  border-radius: 4px;
+  font-size: 12px;
+}
+
+.checkbox {
+  width: 16px;
+  height: 16px;
+  cursor: pointer;
+}
+
 .moviePoster {
   position: relative;
   width: 100%;
@@ -39,6 +65,7 @@
 
 .moviePoster img {
   border-radius: 4px;
+  object-fit: cover;
 }
 
 .posterPlaceholder {
@@ -86,6 +113,7 @@
 }
 
 .detailsButton {
+  display: block;
   width: 100%;
   background: #0066cc;
   color: white;
@@ -95,6 +123,8 @@
   font-size: 14px;
   font-weight: 500;
   cursor: pointer;
+  text-decoration: none;
+  text-align: center;
   transition: background-color 0.2s ease;
 }
 
diff --git a/client/app/components/MovieCard/MovieCard.tsx b/client/app/components/MovieCard/MovieCard.tsx
index 28551ff..7d9ceaf 100644
--- a/client/app/components/MovieCard/MovieCard.tsx
+++ b/client/app/components/MovieCard/MovieCard.tsx
@@ -1,23 +1,51 @@
 'use client';
 
 import Image from 'next/image';
+import Link from 'next/link';
 import movieStyles from "./MovieCard.module.css";
-import { MovieCardProps } from "../../types/movie";
+import { Movie } from "../../types/movie";
+import { ROUTES } from "../../lib/constants";
 
 /**
  * Movie Card Client Component
  * 
  * This component handles the interactive parts of the movie card,
- * such as image error handling, while the parent remains a Server Component.
+ * such as image error handling and selection checkbox.
  */
-export default function MovieCard({ movie }: MovieCardProps) {
+
+interface MovieCardProps {
+  movie: Movie;
+  isSelected?: boolean;
+  onSelectionChange?: (movieId: string, isSelected: boolean) => void;
+  showCheckbox?: boolean;
+}
+
+export default function MovieCard({ movie, isSelected = false, onSelectionChange, showCheckbox = false }: MovieCardProps) {
   const handleImageError = () => {
     // This will be handled by the Image component's onError prop
     console.warn(`Failed to load poster for: ${movie.title}`);
   };
 
+  const handleCheckboxChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+    if (onSelectionChange) {
+      onSelectionChange(movie._id, e.target.checked);
+    }
+  };
+
   return (
-    <div className={movieStyles.movieCard}>
+    <div className={`${movieStyles.movieCard} ${isSelected ? movieStyles.selected : ''}`}>
+      {showCheckbox && (
+        <div className={movieStyles.selectionCheckbox}>
+          <input
+            type="checkbox"
+            id={`select-${movie._id}`}
+            checked={isSelected}
+            onChange={handleCheckboxChange}
+            className={movieStyles.checkbox}
+          />
+        </div>
+      )}
+      
       <div className={movieStyles.moviePoster}>
         {movie.poster ? (
           <Image
@@ -25,7 +53,6 @@ export default function MovieCard({ movie }: MovieCardProps) {
             alt={`${movie.title} poster`}
             fill
             sizes="(max-width: 480px) 100vw, (max-width: 768px) 50vw, 280px"
-            style={{ objectFit: 'cover' }}
             onError={handleImageError}
             placeholder="blur"
             blurDataURL="data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAABAAEDASIAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAv/xAAhEAACAQMDBQAAAAAAAAAAAAABAgMABAUGIWGRkqGx0f/EABUBAQEAAAAAAAAAAAAAAAAAAAMF/8QAGhEAAgIDAAAAAAAAAAAAAAAAAAECEgMRkf/aAAwDAQACEQMRAD8AltJagyeH0AthI5xdrLcNM91BF5pX2HaH9bcfaSXWGaRmknyJckliyjqTzSlT54b6bk+h0R7Dh5zq6esmOk2cWkgaWKJZoSGEa5qKUlPP45++P//Z"
@@ -52,9 +79,9 @@ export default function MovieCard({ movie }: MovieCardProps) {
         )}
       </div>
       
-      <button className={movieStyles.detailsButton} type="button">
+      <Link href={ROUTES.movie(movie._id)} className={movieStyles.detailsButton}>
         Get Details
-      </button>
+      </Link>
     </div>
   );
 }
\ No newline at end of file
diff --git a/client/app/components/PageSizeSelector/PageSizeSelector.module.css b/client/app/components/PageSizeSelector/PageSizeSelector.module.css
new file mode 100644
index 0000000..254793f
--- /dev/null
+++ b/client/app/components/PageSizeSelector/PageSizeSelector.module.css
@@ -0,0 +1,56 @@
+/**
+ * Page Size Selector Component Styles
+ * 
+ * CSS Module for the page size selector component.
+ */
+
+.pageSizeSelector {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin-bottom: 2rem;
+  justify-content: center;
+}
+
+.label {
+  font-size: 0.9rem;
+  color: #666;
+  font-weight: 500;
+}
+
+.select {
+  padding: 0.5rem 0.75rem;
+  border: 1px solid #ddd;
+  border-radius: 6px;
+  background: white;
+  color: #333;
+  font-size: 0.9rem;
+  cursor: pointer;
+  transition: border-color 0.2s ease;
+}
+
+.select:hover {
+  border-color: #0070f3;
+}
+
+.select:focus {
+  outline: none;
+  border-color: #0070f3;
+  box-shadow: 0 0 0 2px rgba(0, 112, 243, 0.2);
+}
+
+/* Responsive Design */
+@media (max-width: 480px) {
+  .pageSizeSelector {
+    margin-bottom: 1.5rem;
+  }
+
+  .label {
+    font-size: 0.85rem;
+  }
+
+  .select {
+    font-size: 0.85rem;
+    padding: 0.4rem 0.6rem;
+  }
+}
\ No newline at end of file
diff --git a/client/app/components/PageSizeSelector/PageSizeSelector.tsx b/client/app/components/PageSizeSelector/PageSizeSelector.tsx
new file mode 100644
index 0000000..286d542
--- /dev/null
+++ b/client/app/components/PageSizeSelector/PageSizeSelector.tsx
@@ -0,0 +1,42 @@
+'use client';
+
+import { useRouter, useSearchParams } from 'next/navigation';
+import pageSizeStyles from './PageSizeSelector.module.css';
+
+interface PageSizeSelectorProps {
+  currentLimit: number;
+}
+
+export default function PageSizeSelector({ currentLimit }: PageSizeSelectorProps) {
+  const router = useRouter();
+  const searchParams = useSearchParams();
+  
+  const pageSizeOptions = [10, 20, 50];
+
+  const handlePageSizeChange = (newLimit: number) => {
+    const params = new URLSearchParams(searchParams);
+    params.set('limit', newLimit.toString());
+    params.set('page', '1'); // Reset to first page when changing page size
+    router.push(`/movies?${params.toString()}`);
+  };
+
+  return (
+    <div className={pageSizeStyles.pageSizeSelector}>
+      <label htmlFor="pageSize" className={pageSizeStyles.label}>
+        Movies per page:
+      </label>
+      <select
+        id="pageSize"
+        value={currentLimit}
+        onChange={(e) => handlePageSizeChange(parseInt(e.target.value))}
+        className={pageSizeStyles.select}
+      >
+        {pageSizeOptions.map((size) => (
+          <option key={size} value={size}>
+            {size}
+          </option>
+        ))}
+      </select>
+    </div>
+  );
+}
\ No newline at end of file
diff --git a/client/app/components/PageSizeSelector/index.ts b/client/app/components/PageSizeSelector/index.ts
new file mode 100644
index 0000000..c89159a
--- /dev/null
+++ b/client/app/components/PageSizeSelector/index.ts
@@ -0,0 +1 @@
+export { default } from './PageSizeSelector';
\ No newline at end of file
diff --git a/client/app/components/Pagination/Pagination.module.css b/client/app/components/Pagination/Pagination.module.css
new file mode 100644
index 0000000..6ef714c
--- /dev/null
+++ b/client/app/components/Pagination/Pagination.module.css
@@ -0,0 +1,113 @@
+/**
+ * Pagination Component Styles
+ * 
+ * CSS Module for the pagination component.
+ * Provides previous/next navigation.
+ */
+
+.pagination {
+  margin: 3rem 0;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 1rem;
+}
+
+.paginationContainer {
+  display: flex;
+  align-items: center;
+  gap: 2rem;
+  flex-wrap: wrap;
+  justify-content: center;
+}
+
+.pageButton {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.75rem 1.5rem;
+  background: #fff;
+  color: #0070f3;
+  border: 1px solid #ddd;
+  border-radius: 6px;
+  text-decoration: none;
+  font-weight: 500;
+  font-size: 0.9rem;
+  transition: all 0.2s ease;
+  min-width: fit-content;
+}
+
+.pageButton:hover:not(.disabled) {
+  background: #0070f3;
+  color: white;
+  border-color: #0070f3;
+  transform: translateY(-1px);
+  box-shadow: 0 2px 4px rgba(0, 112, 243, 0.2);
+}
+
+.pageButton.disabled {
+  background: #f5f5f5;
+  color: #999;
+  border-color: #eee;
+  cursor: not-allowed;
+}
+
+.pageInfo {
+  font-size: 1rem;
+  font-weight: 600;
+  color: #333;
+  padding: 0.75rem 1rem;
+  background: #f8f9fa;
+  border-radius: 6px;
+  border: 1px solid #e9ecef;
+}
+
+.additionalInfo {
+  font-size: 0.85rem;
+  color: #666;
+  text-align: center;
+}
+
+/* Responsive Design */
+@media (max-width: 768px) {
+  .pagination {
+    margin: 2rem 0;
+  }
+
+  .paginationContainer {
+    gap: 1rem;
+  }
+
+  .pageButton {
+    padding: 0.6rem 1.2rem;
+    font-size: 0.85rem;
+  }
+
+  .pageInfo {
+    font-size: 0.9rem;
+    padding: 0.6rem 0.8rem;
+  }
+}
+
+@media (max-width: 480px) {
+  .paginationContainer {
+    gap: 0.5rem;
+    width: 100%;
+  }
+
+  .pageButton {
+    flex: 1;
+    max-width: 120px;
+    padding: 0.6rem 0.8rem;
+    font-size: 0.8rem;
+  }
+
+  .pageInfo {
+    font-size: 0.8rem;
+    padding: 0.5rem 0.7rem;
+  }
+
+  .additionalInfo {
+    font-size: 0.8rem;
+  }
+}
\ No newline at end of file
diff --git a/client/app/components/Pagination/Pagination.tsx b/client/app/components/Pagination/Pagination.tsx
new file mode 100644
index 0000000..dbdbd63
--- /dev/null
+++ b/client/app/components/Pagination/Pagination.tsx
@@ -0,0 +1,81 @@
+'use client';
+
+import Link from 'next/link';
+import { useSearchParams } from 'next/navigation';
+import paginationStyles from './Pagination.module.css';
+
+interface PaginationProps {
+  currentPage: number;
+  hasNextPage: boolean;
+  hasPrevPage: boolean;
+  limit: number;
+}
+
+export default function Pagination({ 
+  currentPage, 
+  hasNextPage, 
+  hasPrevPage, 
+  limit 
+}: PaginationProps) {
+  const searchParams = useSearchParams();
+  
+  const createPageURL = (page: number) => {
+    const params = new URLSearchParams(searchParams);
+    params.set('page', page.toString());
+    if (limit !== 20) { // Only include limit if it's not the default
+      params.set('limit', limit.toString());
+    }
+    return `/movies?${params.toString()}`;
+  };
+
+  // Don't show pagination if there's no navigation possible
+  if (!hasNextPage && !hasPrevPage) {
+    return null;
+  }
+
+  return (
+    <nav className={paginationStyles.pagination} aria-label="Movies pagination">
+      <div className={paginationStyles.paginationContainer}>
+        {/* Previous Button */}
+        {hasPrevPage ? (
+          <Link
+            href={createPageURL(currentPage - 1)}
+            className={paginationStyles.pageButton}
+            aria-label="Go to previous page"
+          >
+            ← Previous
+          </Link>
+        ) : (
+          <span className={`${paginationStyles.pageButton} ${paginationStyles.disabled}`}>
+            ← Previous
+          </span>
+        )}
+
+        {/* Current Page Info */}
+        <div className={paginationStyles.pageInfo}>
+          Page {currentPage}
+        </div>
+
+        {/* Next Button */}
+        {hasNextPage ? (
+          <Link
+            href={createPageURL(currentPage + 1)}
+            className={paginationStyles.pageButton}
+            aria-label="Go to next page"
+          >
+            Next →
+          </Link>
+        ) : (
+          <span className={`${paginationStyles.pageButton} ${paginationStyles.disabled}`}>
+            Next →
+          </span>
+        )}
+      </div>
+
+      {/* Additional Info */}
+      <div className={paginationStyles.additionalInfo}>
+        {limit} movies per page
+      </div>
+    </nav>
+  );
+}
\ No newline at end of file
diff --git a/client/app/components/Pagination/index.ts b/client/app/components/Pagination/index.ts
new file mode 100644
index 0000000..29c341d
--- /dev/null
+++ b/client/app/components/Pagination/index.ts
@@ -0,0 +1 @@
+export { default } from './Pagination';
\ No newline at end of file
diff --git a/client/app/components/index.ts b/client/app/components/index.ts
index 596d313..8e9ff75 100644
--- a/client/app/components/index.ts
+++ b/client/app/components/index.ts
@@ -1,2 +1,16 @@
 // Components
-export { default as MovieCard } from './MovieCard';
\ No newline at end of file
+export { default as MovieCard } from './MovieCard';
+export { default as Pagination } from './Pagination';
+export { default as PageSizeSelector } from './PageSizeSelector';
+export { default as ActionButtons } from './ActionButtons';
+export { default as EditMovieForm } from './EditMovieForm';
+export { default as AddMovieForm } from './AddMovieForm';
+export { default as BatchEditMovieForm } from './BatchEditMovieForm';
+export { 
+  Skeleton, 
+  MovieCardSkeleton, 
+  PageSelectorSkeleton, 
+  PaginationSkeleton, 
+  RatingCardSkeleton, 
+  MovieDetailsSkeleton 
+} from './LoadingSkeleton';
\ No newline at end of file
diff --git a/client/app/globals.css b/client/app/globals.css
index 1d8a143..6f2cb59 100644
--- a/client/app/globals.css
+++ b/client/app/globals.css
@@ -2,10 +2,22 @@ html,
 body {
   max-width: 100vw;
   overflow-x: hidden;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu', 'Cantarell', sans-serif;
+  line-height: 1.6;
+  color: #333;
 }
 
 * {
   box-sizing: border-box;
   padding: 0;
   margin: 0;
+}
+
+body {
+  background: #fafafa;
+}
+
+/* Link hover effects for navigation */
+a:hover {
+  color: #0070f3 !important;
 }
\ No newline at end of file
diff --git a/client/app/layout.module.css b/client/app/layout.module.css
new file mode 100644
index 0000000..ff60632
--- /dev/null
+++ b/client/app/layout.module.css
@@ -0,0 +1,79 @@
+.navigation {
+  background: #fff;
+  border-bottom: 1px solid #eee;
+  padding: 1rem 2rem;
+  position: sticky;
+  top: 0;
+  z-index: 50;
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+}
+
+.navContainer {
+  max-width: 1200px;
+  margin: 0 auto;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+
+.logo {
+  font-size: 1.5rem;
+  font-weight: bold;
+  color: #333;
+  text-decoration: none;
+  transition: color 0.2s ease;
+}
+
+.logo:hover {
+  color: #0070f3;
+}
+
+.logo:focus {
+  outline: 2px solid #0070f3;
+  outline-offset: 2px;
+  border-radius: 4px;
+}
+
+.navLinks {
+  display: flex;
+  gap: 2rem;
+}
+
+.navLink {
+  color: #666;
+  text-decoration: none;
+  font-weight: 500;
+  transition: color 0.2s ease;
+  padding: 0.25rem 0.5rem;
+  border-radius: 4px;
+}
+
+.navLink:hover {
+  color: #0070f3;
+}
+
+.navLink:focus {
+  outline: 2px solid #0070f3;
+  outline-offset: 2px;
+  border-radius: 4px;
+}
+
+/* Responsive design */
+@media (max-width: 768px) {
+  .navigation {
+    padding: 1rem;
+  }
+  
+  .navContainer {
+    flex-direction: column;
+    gap: 1rem;
+  }
+  
+  .logo {
+    font-size: 1.25rem;
+  }
+  
+  .navLinks {
+    gap: 1.5rem;
+  }
+}
\ No newline at end of file
diff --git a/client/app/layout.tsx b/client/app/layout.tsx
index 2bea842..acabb89 100644
--- a/client/app/layout.tsx
+++ b/client/app/layout.tsx
@@ -1,9 +1,14 @@
+import Link from 'next/link';
 import type { Metadata } from 'next';
 import "./globals.css";
+import styles from './layout.module.css';
+import { ROUTES, APP_CONFIG } from './lib/constants';
+
 export const metadata: Metadata = {
   title: 'Sample MFlix - MongoDB Movie Database',
   description: 'Explore movies from the MongoDB sample_mflix database',
 };
+
 export default function RootLayout({
   children,
 }: Readonly<{
@@ -12,6 +17,30 @@ export default function RootLayout({
   return (
     <html lang="en">
       <body>
+        <nav className={styles.navigation}>
+          <div className={styles.navContainer}>
+            <Link 
+              href={ROUTES.home}
+              className={styles.logo}
+            >
+              {APP_CONFIG.name}
+            </Link>
+            <div className={styles.navLinks}>
+              <Link 
+                href={ROUTES.home}
+                className={styles.navLink}
+              >
+                Home
+              </Link>
+              <Link 
+                href={ROUTES.movies}
+                className={styles.navLink}
+              >
+                Movies
+              </Link>
+            </div>
+          </div>
+        </nav>
         {children}
       </body>
     </html>
diff --git a/client/app/lib/api.ts b/client/app/lib/api.ts
index 7235435..895ba95 100644
--- a/client/app/lib/api.ts
+++ b/client/app/lib/api.ts
@@ -7,12 +7,17 @@ import { Movie, MoviesApiResponse } from '../types/movie';
 const API_BASE_URL = process.env.API_URL || 'http://localhost:3001';
 
 /**
- * Fetches all movies from the Express API
+ * Fetches movies from the Express API with pagination support
  * This function runs on the server during SSR
  */
-export async function fetchMovies(limit: number = 50): Promise<Movie[]> {
+export async function fetchMovies(
+  limit: number = 20, 
+  skip: number = 0
+): Promise<{ movies: Movie[]; hasNextPage: boolean; hasPrevPage: boolean }> {
   try {
-    const response = await fetch(`${API_BASE_URL}/api/movies?limit=${limit}`, {
+    // Request one extra movie to check if there's a next page
+    const requestLimit = Math.min(limit + 1, 100);
+    const response = await fetch(`${API_BASE_URL}/api/movies?limit=${requestLimit}&skip=${skip}`, {
       next: { revalidate: 300 }, // Revalidate every 5 minutes
     });
 
@@ -26,7 +31,15 @@ export async function fetchMovies(limit: number = 50): Promise<Movie[]> {
       throw new Error('API returned error response');
     }
 
-    return result.data;
+    const hasNextPage = result.data.length > limit;
+    const movies = hasNextPage ? result.data.slice(0, limit) : result.data;
+    const hasPrevPage = skip > 0;
+
+    return {
+      movies,
+      hasNextPage,
+      hasPrevPage
+    };
   } catch (error) {
     console.error('Error fetching movies:', error);
     
@@ -35,8 +48,12 @@ export async function fetchMovies(limit: number = 50): Promise<Movie[]> {
       throw error;
     }
     
-    // In production, return empty array with logged error to prevent page crash
-    return [];
+    // In production, return empty result with logged error to prevent page crash
+    return {
+      movies: [],
+      hasNextPage: false,
+      hasPrevPage: false
+    };
   }
 }
 
@@ -45,18 +62,304 @@ export async function fetchMovies(limit: number = 50): Promise<Movie[]> {
  */
 export async function fetchMovieById(id: string): Promise<Movie | null> {
   try {
+    // Validate the ID format (basic validation)
+    if (!id || id.length !== 24) {
+      console.warn('Invalid movie ID format:', id);
+      return null;
+    }
+
     const response = await fetch(`${API_BASE_URL}/api/movies/${id}`, {
       next: { revalidate: 300 },
     });
 
     if (!response.ok) {
+      console.warn(`Failed to fetch movie ${id}: ${response.status}`);
       return null;
     }
 
     const result = await response.json();
-    return result.success ? result.data : null;
+    
+    if (!result.success) {
+      console.warn('API returned error response for movie:', id);
+      return null;
+    }
+
+    return result.data;
   } catch (error) {
     console.error('Error fetching movie:', error);
     return null;
   }
+}
+
+/**
+ * Update a movie by ID
+ */
+export async function updateMovie(id: string, updateData: Partial<Movie>): Promise<{ success: boolean; error?: string }> {
+  try {
+    // Validate the ID format
+    if (!id || id.length !== 24) {
+      return { success: false, error: 'Invalid movie ID format' };
+    }
+
+    // Remove the _id field from update data if present
+    const { _id, ...dataToUpdate } = updateData;
+
+    const response = await fetch(`${API_BASE_URL}/api/movies/${id}`, {
+      method: 'PUT',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify(dataToUpdate),
+    });
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      return { 
+        success: false, 
+        error: result.error || `Failed to update movie: ${response.status}` 
+      };
+    }
+
+    if (!result.success) {
+      return { 
+        success: false, 
+        error: result.error || 'API returned error response' 
+      };
+    }
+
+    return { success: true };
+  } catch (error) {
+    console.error('Error updating movie:', error);
+    return { 
+      success: false, 
+      error: 'Network error occurred while updating movie' 
+    };
+  }
+}
+
+/**
+ * Delete a movie by ID
+ */
+export async function deleteMovie(id: string): Promise<{ success: boolean; error?: string }> {
+  try {
+    // Validate the ID format
+    if (!id || id.length !== 24) {
+      return { success: false, error: 'Invalid movie ID format' };
+    }
+
+    const response = await fetch(`${API_BASE_URL}/api/movies/${id}`, {
+      method: 'DELETE',
+    });
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      return { 
+        success: false, 
+        error: result.error || `Failed to delete movie: ${response.status}` 
+      };
+    }
+
+    if (!result.success) {
+      return { 
+        success: false, 
+        error: result.error || 'API returned error response' 
+      };
+    }
+
+    return { success: true };
+  } catch (error) {
+    console.error('Error deleting movie:', error);
+    return { 
+      success: false, 
+      error: 'Network error occurred while deleting movie' 
+    };
+  }
+}
+
+/**
+ * Create a new movie
+ */
+export async function createMovie(movieData: Omit<Movie, '_id'>): Promise<{ success: boolean; error?: string; movieId?: string }> {
+  try {
+    const response = await fetch(`${API_BASE_URL}/api/movies`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify(movieData),
+    });
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      return { 
+        success: false, 
+        error: result.error || `Failed to create movie: ${response.status}` 
+      };
+    }
+
+    if (!result.success) {
+      return { 
+        success: false, 
+        error: result.error || 'API returned error response' 
+      };
+    }
+
+    return { 
+      success: true, 
+      movieId: result.data._id || result.data.insertedId 
+    };
+  } catch (error) {
+    console.error('Error creating movie:', error);
+    return { 
+      success: false, 
+      error: 'Network error occurred while creating movie' 
+    };
+  }
+}
+
+/**
+ * Create multiple movies in a batch operation
+ */
+export async function createMoviesBatch(moviesData: Omit<Movie, '_id'>[]): Promise<{ success: boolean; error?: string; insertedCount?: number; insertedIds?: string[] }> {
+  try {
+    const response = await fetch(`${API_BASE_URL}/api/movies/batch`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify(moviesData),
+    });
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      return { 
+        success: false, 
+        error: result.error || `Failed to create movies: ${response.status}` 
+      };
+    }
+
+    if (!result.success) {
+      return { 
+        success: false, 
+        error: result.error || 'API returned error response' 
+      };
+    }
+
+    return { 
+      success: true, 
+      insertedCount: result.data.insertedCount,
+      insertedIds: result.data.insertedIds ? Object.values(result.data.insertedIds) : []
+    };
+  } catch (error) {
+    console.error('Error creating movies batch:', error);
+    return { 
+      success: false, 
+      error: 'Network error occurred while creating movies' 
+    };
+  }
+}
+
+/**
+ * Delete multiple movies in a batch operation
+ */
+export async function deleteMoviesBatch(movieIds: string[]): Promise<{ success: boolean; error?: string; deletedCount?: number }> {
+  try {
+    // Create filter to match the movie IDs
+    // Note: The server will handle ObjectId conversion
+    const filter = {
+      _id: {
+        $in: movieIds
+      }
+    };
+
+    const response = await fetch(`${API_BASE_URL}/api/movies`, {
+      method: 'DELETE',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({ filter }),
+    });
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      return { 
+        success: false, 
+        error: result.error || `Failed to delete movies: ${response.status}` 
+      };
+    }
+
+    if (!result.success) {
+      return { 
+        success: false, 
+        error: result.error || 'API returned error response' 
+      };
+    }
+
+    return { 
+      success: true, 
+      deletedCount: result.data.deletedCount
+    };
+  } catch (error) {
+    console.error('Error deleting movies batch:', error);
+    return { 
+      success: false, 
+      error: 'Network error occurred while deleting movies' 
+    };
+  }
+}
+
+/**
+ * Update multiple movies in a batch operation
+ */
+export async function updateMoviesBatch(movieIds: string[], updateData: Partial<Movie>): Promise<{ success: boolean; error?: string; matchedCount?: number; modifiedCount?: number }> {
+  try {
+    // Create filter to match the movie IDs
+    // Note: The server will handle ObjectId conversion
+    const filter = {
+      _id: {
+        $in: movieIds
+      }
+    };
+
+    const response = await fetch(`${API_BASE_URL}/api/movies`, {
+      method: 'PATCH',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({ filter, update: updateData }),
+    });
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      return { 
+        success: false, 
+        error: result.error || `Failed to update movies: ${response.status}` 
+      };
+    }
+
+    if (!result.success) {
+      return { 
+        success: false, 
+        error: result.error || 'API returned error response' 
+      };
+    }
+
+    return { 
+      success: true, 
+      matchedCount: result.data.matchedCount,
+      modifiedCount: result.data.modifiedCount
+    };
+  } catch (error) {
+    console.error('Error updating movies batch:', error);
+    return { 
+      success: false, 
+      error: 'Network error occurred while updating movies' 
+    };
+  }
 }
\ No newline at end of file
diff --git a/client/app/lib/constants.ts b/client/app/lib/constants.ts
index 961d8b2..a0308bb 100644
--- a/client/app/lib/constants.ts
+++ b/client/app/lib/constants.ts
@@ -5,7 +5,8 @@
 export const APP_CONFIG = {
   name: 'MFlix',
   description: 'Browse movies from the sample MFlix database',
-  defaultMovieLimit: 50,
+  defaultMovieLimit: 20,
+  maxMovieLimit: 100,
   imageFormats: ['image/avif', 'image/webp'],
 } as const;
 
diff --git a/client/app/movie/[id]/error.module.css b/client/app/movie/[id]/error.module.css
new file mode 100644
index 0000000..0b6c43e
--- /dev/null
+++ b/client/app/movie/[id]/error.module.css
@@ -0,0 +1,91 @@
+.container {
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  padding: 2rem;
+  text-align: center;
+  background: #fafafa;
+}
+
+.errorCard {
+  background: white;
+  padding: 3rem;
+  border-radius: 12px;
+  box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
+  max-width: 500px;
+  width: 100%;
+}
+
+.title {
+  font-size: 2rem;
+  margin: 0 0 1rem 0;
+  color: #dc3545;
+  font-weight: 600;
+}
+
+.description {
+  font-size: 1.1rem;
+  color: #666;
+  margin-bottom: 2rem;
+  line-height: 1.5;
+}
+
+.buttonContainer {
+  display: flex;
+  gap: 1rem;
+  justify-content: center;
+  flex-wrap: wrap;
+}
+
+.retryButton {
+  background: #0070f3;
+  color: white;
+  border: none;
+  padding: 12px 24px;
+  border-radius: 6px;
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  text-decoration: none;
+  transition: background-color 0.2s ease;
+}
+
+.retryButton:hover {
+  background: #0051cc;
+}
+
+.retryButton:focus {
+  outline: 2px solid #0070f3;
+  outline-offset: 2px;
+}
+
+.backLink {
+  background: #6c757d;
+  color: white;
+  border: none;
+  padding: 12px 24px;
+  border-radius: 6px;
+  font-size: 1rem;
+  font-weight: 500;
+  text-decoration: none;
+  transition: background-color 0.2s ease;
+  display: inline-block;
+}
+
+.backLink:hover {
+  background: #545b62;
+}
+
+.backLink:focus {
+  outline: 2px solid #6c757d;
+  outline-offset: 2px;
+}
+
+.errorId {
+  font-size: 0.8rem;
+  color: #999;
+  margin-top: 2rem;
+  font-family: 'Courier New', monospace;
+}
\ No newline at end of file
diff --git a/client/app/movie/[id]/error.tsx b/client/app/movie/[id]/error.tsx
new file mode 100644
index 0000000..2e76a32
--- /dev/null
+++ b/client/app/movie/[id]/error.tsx
@@ -0,0 +1,53 @@
+'use client';
+
+import { useEffect } from 'react';
+import Link from 'next/link';
+import { ROUTES } from '../../lib/constants';
+import styles from './error.module.css';
+
+export default function MovieDetailsError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}) {
+  useEffect(() => {
+    console.error('Movie details error:', error);
+  }, [error]);
+
+  return (
+    <div className={styles.container}>
+      <div className={styles.errorCard}>
+        <h1 className={styles.title}>
+          Something went wrong!
+        </h1>
+        <p className={styles.description}>
+          We encountered an error while loading the movie details.
+        </p>
+        
+        <div className={styles.buttonContainer}>
+          <button
+            onClick={reset}
+            className={styles.retryButton}
+          >
+            Try Again
+          </button>
+          
+          <Link 
+            href={ROUTES.movies}
+            className={styles.backLink}
+          >
+            Back to Movies
+          </Link>
+        </div>
+        
+        {process.env.NODE_ENV === 'development' && error.digest && (
+          <p className={styles.errorId}>
+            Error ID: {error.digest}
+          </p>
+        )}
+      </div>
+    </div>
+  );
+}
\ No newline at end of file
diff --git a/client/app/movie/[id]/loading.tsx b/client/app/movie/[id]/loading.tsx
new file mode 100644
index 0000000..dace3cf
--- /dev/null
+++ b/client/app/movie/[id]/loading.tsx
@@ -0,0 +1,22 @@
+import pageStyles from './page.module.css';
+import { MovieDetailsSkeleton } from '../../components/LoadingSkeleton';
+
+export default function MovieDetailsLoading() {
+  return (
+    <div className={pageStyles.page}>
+      <main className={pageStyles.main}>
+        <div className={pageStyles.movieDetails}>
+          <div className={pageStyles.posterSection}>
+            <div className={pageStyles.posterPlaceholder}>
+              Loading...
+            </div>
+          </div>
+
+          <div className={pageStyles.movieInfo}>
+            <MovieDetailsSkeleton />
+          </div>
+        </div>
+      </main>
+    </div>
+  );
+}
\ No newline at end of file
diff --git a/client/app/movie/[id]/not-found.module.css b/client/app/movie/[id]/not-found.module.css
new file mode 100644
index 0000000..b295429
--- /dev/null
+++ b/client/app/movie/[id]/not-found.module.css
@@ -0,0 +1,50 @@
+.container {
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  padding: 2rem;
+  text-align: center;
+}
+
+.errorCode {
+  font-size: 4rem;
+  margin: 0 0 1rem 0;
+  color: #333;
+  font-weight: bold;
+}
+
+.title {
+  font-size: 1.5rem;
+  margin: 0 0 1rem 0;
+  color: #666;
+  font-weight: 600;
+}
+
+.description {
+  font-size: 1.1rem;
+  color: #888;
+  margin-bottom: 2rem;
+  max-width: 500px;
+  line-height: 1.5;
+}
+
+.backLink {
+  color: #0070f3;
+  text-decoration: none;
+  font-size: 1.1rem;
+  font-weight: 500;
+  transition: color 0.2s ease;
+}
+
+.backLink:hover {
+  color: #0051cc;
+  text-decoration: underline;
+}
+
+.backLink:focus {
+  outline: 2px solid #0070f3;
+  outline-offset: 2px;
+  border-radius: 4px;
+}
\ No newline at end of file
diff --git a/client/app/movie/[id]/not-found.tsx b/client/app/movie/[id]/not-found.tsx
new file mode 100644
index 0000000..f2c0bf7
--- /dev/null
+++ b/client/app/movie/[id]/not-found.tsx
@@ -0,0 +1,16 @@
+import styles from './not-found.module.css';
+
+export default function NotFound() {
+  return (
+    <div className={styles.container}>
+      <h1 className={styles.errorCode}>404</h1>
+      <h2 className={styles.title}>Movie Not Found</h2>
+      <p className={styles.description}>
+        The movie you're looking for doesn't exist or may have been removed.
+      </p>
+      <a href="/movies" className={styles.backLink}>
+        ← Back to Movies
+      </a>
+    </div>
+  );
+}
\ No newline at end of file
diff --git a/client/app/movie/[id]/page.module.css b/client/app/movie/[id]/page.module.css
new file mode 100644
index 0000000..ba5866b
--- /dev/null
+++ b/client/app/movie/[id]/page.module.css
@@ -0,0 +1,317 @@
+/**
+ * Movie Details Page Styles
+ * 
+ * CSS Module for the movie details page component.
+ * Provides responsive layout for displaying detailed movie information.
+ */
+
+.page {
+  min-height: 100vh;
+  padding: 2rem;
+  background-color: #fafafa;
+}
+
+.main {
+  max-width: 1000px;
+  margin: 0 auto;
+  width: 100%;
+}
+
+.backLink {
+  margin-bottom: 2rem;
+}
+
+.backLink a {
+  color: #0070f3;
+  text-decoration: none;
+  font-weight: 500;
+  transition: color 0.2s ease;
+}
+
+.backLink a:hover {
+  color: #0051cc;
+  text-decoration: underline;
+}
+
+.successMessage {
+  background-color: #d1edff;
+  border: 1px solid #b8e6ff;
+  color: #0c5aa6;
+  padding: 1rem;
+  border-radius: 8px;
+  margin-bottom: 1rem;
+  text-align: center;
+  font-weight: 500;
+}
+
+.errorMessage {
+  background-color: #fef2f2;
+  border: 1px solid #fee2e2;
+  color: #991b1b;
+  padding: 1rem;
+  border-radius: 8px;
+  margin-bottom: 1rem;
+  text-align: center;
+  font-weight: 500;
+}
+
+.movieDetails {
+  display: grid;
+  grid-template-columns: 400px 1fr;
+  gap: 3rem;
+  background: white;
+  border-radius: 12px;
+  padding: 2rem;
+  box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
+}
+
+.posterSection {
+  display: flex;
+  flex-direction: column;
+}
+
+.posterContainer {
+  position: relative;
+  width: 100%;
+  aspect-ratio: 2/3;
+  border-radius: 8px;
+  overflow: hidden;
+  background: #f5f5f5;
+}
+
+.posterContainer img {
+  object-fit: cover;
+}
+
+.posterPlaceholder {
+  width: 100%;
+  aspect-ratio: 2/3;
+  background: linear-gradient(135deg, #f5f5f5 0%, #e0e0e0 100%);
+  border-radius: 8px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: #666;
+  font-weight: 500;
+  text-align: center;
+  border: 2px dashed #ddd;
+}
+
+.movieInfo {
+  display: flex;
+  flex-direction: column;
+  gap: 2rem;
+}
+
+.title {
+  font-size: 2.5rem;
+  font-weight: bold;
+  color: #333;
+  margin: 0;
+  line-height: 1.2;
+}
+
+.basicInfo {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+  gap: 1rem;
+  padding: 1rem;
+  background: #f8f9fa;
+  border-radius: 8px;
+}
+
+.infoItem {
+  font-size: 1rem;
+  color: #555;
+}
+
+.infoItem strong {
+  color: #333;
+  display: block;
+  margin-bottom: 0.25rem;
+}
+
+.ratingsSection {
+  border-top: 1px solid #eee;
+  padding-top: 1.5rem;
+}
+
+.ratingsSection h3 {
+  font-size: 1.3rem;
+  color: #333;
+  margin: 0 0 1rem 0;
+}
+
+.ratingsGrid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
+  gap: 1rem;
+}
+
+.ratingCard {
+  background: #f8f9fa;
+  padding: 1rem;
+  border-radius: 8px;
+  text-align: center;
+  border: 1px solid #e9ecef;
+}
+
+.ratingCard strong {
+  display: block;
+  font-size: 0.9rem;
+  color: #666;
+  margin-bottom: 0.5rem;
+}
+
+.ratingValue {
+  font-size: 1.25rem;
+  font-weight: bold;
+  color: #333;
+  margin-bottom: 0.25rem;
+}
+
+.ratingMeta {
+  font-size: 0.8rem;
+  color: #888;
+}
+
+.genres {
+  font-size: 1.1rem;
+  color: #555;
+}
+
+.genres strong {
+  color: #333;
+  display: block;
+  margin-bottom: 0.5rem;
+}
+
+.genreList {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+}
+
+.genreTag {
+  background: #e3f2fd;
+  color: #1976d2;
+  padding: 0.25rem 0.75rem;
+  border-radius: 16px;
+  font-size: 0.9rem;
+  font-weight: 500;
+}
+
+.plot,
+.fullplot {
+  border-top: 1px solid #eee;
+  padding-top: 1.5rem;
+}
+
+.plot h2,
+.fullplot h2 {
+  font-size: 1.5rem;
+  color: #333;
+  margin: 0 0 1rem 0;
+}
+
+.plot p,
+.fullplot p {
+  font-size: 1.1rem;
+  line-height: 1.6;
+  color: #555;
+  margin: 0;
+}
+
+.castCrew {
+  border-top: 1px solid #eee;
+  padding-top: 1.5rem;
+  display: grid;
+  gap: 1.5rem;
+}
+
+.crewSection h3 {
+  font-size: 1.2rem;
+  color: #333;
+  margin: 0 0 0.5rem 0;
+}
+
+.crewSection p {
+  font-size: 1rem;
+  line-height: 1.5;
+  color: #555;
+  margin: 0;
+}
+
+.additionalInfo {
+  border-top: 1px solid #eee;
+  padding-top: 1.5rem;
+}
+
+.additionalInfo h3 {
+  font-size: 1.3rem;
+  color: #333;
+  margin: 0 0 1rem 0;
+}
+
+.infoGrid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+  gap: 1rem;
+}
+
+/* Responsive Design */
+@media (max-width: 768px) {
+  .page {
+    padding: 1rem;
+  }
+
+  .movieDetails {
+    grid-template-columns: 1fr;
+    gap: 2rem;
+    padding: 1.5rem;
+  }
+
+  .posterContainer {
+    max-width: 300px;
+    margin: 0 auto;
+  }
+
+  .title {
+    font-size: 2rem;
+  }
+
+  .basicInfo {
+    grid-template-columns: 1fr;
+  }
+
+  .ratingsGrid {
+    grid-template-columns: repeat(auto-fit, minmax(120px, 1fr));
+  }
+
+  .infoGrid {
+    grid-template-columns: 1fr;
+  }
+}
+
+@media (max-width: 480px) {
+  .page {
+    padding: 0.5rem;
+  }
+
+  .movieDetails {
+    padding: 1rem;
+    gap: 1.5rem;
+  }
+
+  .title {
+    font-size: 1.75rem;
+  }
+
+  .posterContainer {
+    max-width: 250px;
+  }
+
+  .ratingsGrid {
+    grid-template-columns: 1fr;
+  }
+}
\ No newline at end of file
diff --git a/client/app/movie/[id]/page.tsx b/client/app/movie/[id]/page.tsx
new file mode 100644
index 0000000..42dade2
--- /dev/null
+++ b/client/app/movie/[id]/page.tsx
@@ -0,0 +1,385 @@
+'use client';
+
+import { useState, useEffect } from 'react';
+import Image from 'next/image';
+import Link from 'next/link';
+import { useRouter } from 'next/navigation';
+import { fetchMovieById, updateMovie, deleteMovie } from '../../lib/api';
+import { ActionButtons, EditMovieForm } from '../../components';
+import { ErrorDisplay, LoadingSpinner } from '../../components/ui';
+import { Movie } from '../../types/movie';
+import { ROUTES } from '../../lib/constants';
+import pageStyles from './page.module.css';
+
+interface MovieDetailsPageProps {
+  params: Promise<{
+    id: string;
+  }>;
+}
+
+export default function MovieDetailsPage({ params }: MovieDetailsPageProps) {
+  const router = useRouter();
+  const [movieId, setMovieId] = useState<string>('');
+  const [movie, setMovie] = useState<Movie | null>(null);
+  const [isLoading, setIsLoading] = useState(true);
+  const [isUpdating, setIsUpdating] = useState(false);
+  const [isEditMode, setIsEditMode] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const [successMessage, setSuccessMessage] = useState<string | null>(null);
+
+  // Initialize params
+  useEffect(() => {
+    params.then(({ id }) => {
+      setMovieId(id);
+    });
+  }, [params]);
+
+  // Fetch movie data
+  useEffect(() => {
+    if (!movieId) return;
+
+    const loadMovie = async () => {
+      setIsLoading(true);
+      setError(null);
+      
+      const movieData = await fetchMovieById(movieId);
+      
+      if (movieData) {
+        setMovie(movieData);
+      } else {
+        setError('Movie not found');
+      }
+      
+      setIsLoading(false);
+    };
+
+    loadMovie();
+  }, [movieId]);
+
+  const handleEdit = () => {
+    setIsEditMode(true);
+    setError(null);
+    setSuccessMessage(null);
+  };
+
+  const handleCancelEdit = () => {
+    setIsEditMode(false);
+    setError(null);
+    setSuccessMessage(null);
+  };
+
+  const handleSave = async (updateData: Partial<Movie>) => {
+    if (!movie) return;
+
+    setIsUpdating(true);
+    setError(null);
+    setSuccessMessage(null);
+
+    const result = await updateMovie(movie._id, updateData);
+
+    if (result.success) {
+      // Refresh movie data
+      const updatedMovie = await fetchMovieById(movie._id);
+      if (updatedMovie) {
+        setMovie(updatedMovie);
+        setSuccessMessage('Movie updated successfully!');
+        setIsEditMode(false);
+      }
+    } else {
+      setError(result.error || 'Failed to update movie');
+    }
+
+    setIsUpdating(false);
+  };
+
+  const handleDelete = async () => {
+    if (!movie) return;
+
+    if (!confirm(`Are you sure you want to delete "${movie.title}"? This action cannot be undone.`)) {
+      return;
+    }
+
+    setIsUpdating(true);
+    setError(null);
+    setSuccessMessage(null);
+
+    const result = await deleteMovie(movie._id);
+
+    if (result.success) {
+      setSuccessMessage('Movie deleted successfully! Redirecting...');
+      setTimeout(() => {
+        router.push(ROUTES.movies);
+      }, 2000);
+    } else {
+      setError(result.error || 'Failed to delete movie');
+      setIsUpdating(false);
+    }
+  };
+
+  // Loading state
+  if (isLoading) {
+    return (
+      <div className={pageStyles.page}>
+        <main className={pageStyles.main}>
+          <div style={{ textAlign: 'center', padding: '2rem' }}>
+            <LoadingSpinner />
+            <p>Loading movie details...</p>
+          </div>
+        </main>
+      </div>
+    );
+  }
+
+  // Error state
+  if (error && !movie) {
+    return (
+      <div className={pageStyles.page}>
+        <main className={pageStyles.main}>
+          <div className={pageStyles.backLink}>
+            <Link href={ROUTES.movies}>← Back to Movies</Link>
+          </div>
+          <ErrorDisplay 
+            message={error} 
+            onRetry={() => window.location.reload()} 
+          />
+        </main>
+      </div>
+    );
+  }
+
+  // No movie found
+  if (!movie) {
+    return (
+      <div className={pageStyles.page}>
+        <main className={pageStyles.main}>
+          <div className={pageStyles.backLink}>
+            <Link href={ROUTES.movies}>← Back to Movies</Link>
+          </div>
+          <ErrorDisplay 
+            message="Movie not found" 
+          />
+        </main>
+      </div>
+    );
+  }
+
+  return (
+    <div className={pageStyles.page}>
+      <main className={pageStyles.main}>
+        <div className={pageStyles.backLink}>
+          <Link href={ROUTES.movies}>← Back to Movies</Link>
+        </div>
+
+        {/* Success/Error Messages */}
+        {successMessage && (
+          <div className={pageStyles.successMessage}>
+            {successMessage}
+          </div>
+        )}
+        
+        {error && (
+          <div className={pageStyles.errorMessage}>
+            {error}
+          </div>
+        )}
+
+        {/* Action Buttons */}
+        <ActionButtons
+          onEdit={handleEdit}
+          onDelete={handleDelete}
+          isLoading={isUpdating}
+          disabled={isEditMode}
+        />
+
+        {/* Edit Form or Movie Details */}
+        {isEditMode ? (
+          <EditMovieForm
+            movie={movie}
+            onSave={handleSave}
+            onCancel={handleCancelEdit}
+            isLoading={isUpdating}
+          />
+        ) : (
+          <div className={pageStyles.movieDetails}>
+            <div className={pageStyles.posterSection}>
+              {movie.poster ? (
+                <div className={pageStyles.posterContainer}>
+                  <Image
+                    src={movie.poster}
+                    alt={`${movie.title} poster`}
+                    fill
+                    sizes="(max-width: 768px) 100vw, 400px"
+                    placeholder="blur"
+                    blurDataURL="data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAABAAEDASIAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAv/xAAhEAACAQMDBQAAAAAAAAAAAAABAgMABAUGIWGRkqGx0f/EABUBAQEAAAAAAAAAAAAAAAAAAAMF/8QAGhEAAgIDAAAAAAAAAAAAAAAAAAECEgMRkf/aAAwDAQACEQMRAD8AltJagyeH0AthI5xdrLcNM91BF5pX2HaH9bcfaSXWGaRmknyJckliyjqTzSlT54b6bk+h0R7Dh5zq6esmOk2cWkgaWKJZoSGEa5qKUlPP45++P//Z"
+                  />
+                </div>
+              ) : (
+                <div className={pageStyles.posterPlaceholder}>
+                  No Poster Available
+                </div>
+              )}
+            </div>
+
+            <div className={pageStyles.movieInfo}>
+              <h1 className={pageStyles.title}>{movie.title}</h1>
+              
+              <div className={pageStyles.basicInfo}>
+                {movie.year && (
+                  <div className={pageStyles.infoItem}>
+                    <strong>Year:</strong> {movie.year}
+                  </div>
+                )}
+
+                {movie.rated && (
+                  <div className={pageStyles.infoItem}>
+                    <strong>Rated:</strong> {movie.rated}
+                  </div>
+                )}
+
+                {movie.runtime && (
+                  <div className={pageStyles.infoItem}>
+                    <strong>Runtime:</strong> {movie.runtime} minutes
+                  </div>
+                )}
+
+                {movie.type && (
+                  <div className={pageStyles.infoItem}>
+                    <strong>Type:</strong> {movie.type}
+                  </div>
+                )}
+              </div>
+
+              {/* Ratings Section */}
+              <div className={pageStyles.ratingsSection}>
+                <h3>Ratings</h3>
+                <div className={pageStyles.ratingsGrid}>
+                  {movie.imdb?.rating && (
+                    <div className={pageStyles.ratingCard}>
+                      <strong>IMDB</strong>
+                      <div className={pageStyles.ratingValue}>
+                        ⭐ {movie.imdb.rating}/10
+                      </div>
+                      {movie.imdb.votes && (
+                        <div className={pageStyles.ratingMeta}>
+                          {movie.imdb.votes.toLocaleString()} votes
+                        </div>
+                      )}
+                    </div>
+                  )}
+
+                  {movie.metacritic && (
+                    <div className={pageStyles.ratingCard}>
+                      <strong>Metacritic</strong>
+                      <div className={pageStyles.ratingValue}>
+                        {movie.metacritic}/100
+                      </div>
+                    </div>
+                  )}
+
+                  {movie.tomatoes?.viewer?.rating && (
+                    <div className={pageStyles.ratingCard}>
+                      <strong>Rotten Tomatoes</strong>
+                      <div className={pageStyles.ratingValue}>
+                        🍅 {movie.tomatoes.viewer.rating}/5
+                      </div>
+                      {movie.tomatoes.viewer.numReviews && (
+                        <div className={pageStyles.ratingMeta}>
+                          {movie.tomatoes.viewer.numReviews} reviews
+                        </div>
+                      )}
+                    </div>
+                  )}
+                </div>
+              </div>
+
+              {movie.genres && movie.genres.length > 0 && (
+                <div className={pageStyles.genres}>
+                  <strong>Genres:</strong>
+                  <div className={pageStyles.genreList}>
+                    {movie.genres.map((genre, index) => (
+                      <span key={index} className={pageStyles.genreTag}>
+                        {genre}
+                      </span>
+                    ))}
+                  </div>
+                </div>
+              )}
+
+              {movie.plot && (
+                <div className={pageStyles.plot}>
+                  <h2>Plot</h2>
+                  <p>{movie.plot}</p>
+                </div>
+              )}
+
+              {movie.fullplot && movie.fullplot !== movie.plot && (
+                <div className={pageStyles.fullplot}>
+                  <h2>Full Plot</h2>
+                  <p>{movie.fullplot}</p>
+                </div>
+              )}
+
+              {/* Cast and Crew */}
+              <div className={pageStyles.castCrew}>
+                {movie.directors && movie.directors.length > 0 && (
+                  <div className={pageStyles.crewSection}>
+                    <h3>Directors</h3>
+                    <p>{movie.directors.join(', ')}</p>
+                  </div>
+                )}
+
+                {movie.writers && movie.writers.length > 0 && (
+                  <div className={pageStyles.crewSection}>
+                    <h3>Writers</h3>
+                    <p>{movie.writers.join(', ')}</p>
+                  </div>
+                )}
+
+                {movie.cast && movie.cast.length > 0 && (
+                  <div className={pageStyles.crewSection}>
+                    <h3>Cast</h3>
+                    <p>{movie.cast.slice(0, 10).join(', ')}{movie.cast.length > 10 ? '...' : ''}</p>
+                  </div>
+                )}
+              </div>
+
+              {/* Additional Information */}
+              <div className={pageStyles.additionalInfo}>
+                <h3>Additional Information</h3>
+                <div className={pageStyles.infoGrid}>
+                  {movie.countries && movie.countries.length > 0 && (
+                    <div className={pageStyles.infoItem}>
+                      <strong>Countries:</strong> {movie.countries.join(', ')}
+                    </div>
+                  )}
+
+                  {movie.languages && movie.languages.length > 0 && (
+                    <div className={pageStyles.infoItem}>
+                      <strong>Languages:</strong> {movie.languages.join(', ')}
+                    </div>
+                  )}
+
+                  {movie.released && (
+                    <div className={pageStyles.infoItem}>
+                      <strong>Released:</strong> {new Date(movie.released).toLocaleDateString()}
+                    </div>
+                  )}
+
+                  {movie.awards?.text && (
+                    <div className={pageStyles.infoItem}>
+                      <strong>Awards:</strong> {movie.awards.text}
+                    </div>
+                  )}
+
+                  <div className={pageStyles.infoItem}>
+                    <strong>Movie ID:</strong> {movie._id}
+                  </div>
+                </div>
+              </div>
+            </div>
+          </div>
+        )}
+      </main>
+    </div>
+  );
+}
\ No newline at end of file
diff --git a/client/app/movies/loading.module.css b/client/app/movies/loading.module.css
deleted file mode 100644
index 8f2d1d2..0000000
--- a/client/app/movies/loading.module.css
+++ /dev/null
@@ -1,45 +0,0 @@
-/**
- * Loading Component Styles
- * 
- * CSS Module for the movies loading component.
- */
-
-.loadingContainer {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  justify-content: center;
-  padding: 60px 20px;
-  text-align: center;
-}
-
-.loadingSpinner {
-  width: 40px;
-  height: 40px;
-  border: 4px solid #f3f3f3;
-  border-top: 4px solid #0066cc;
-  border-radius: 50%;
-  animation: spin 1s linear infinite;
-  margin-bottom: 16px;
-}
-
-@keyframes spin {
-  0% { 
-    transform: rotate(0deg); 
-  }
-  100% { 
-    transform: rotate(360deg); 
-  }
-}
-
-.pageTitle {
-  margin: 0 0 32px 0;
-  font-size: 32px;
-  color: #333;
-}
-
-.loadingMessage {
-  color: #666;
-  font-size: 16px;
-  margin: 0;
-}
\ No newline at end of file
diff --git a/client/app/movies/loading.tsx b/client/app/movies/loading.tsx
index 7d6c498..9c20251 100644
--- a/client/app/movies/loading.tsx
+++ b/client/app/movies/loading.tsx
@@ -1,5 +1,7 @@
 
-import loadingStyles from "./loading.module.css";
+import pageStyles from "./page.module.css";
+import movieStyles from "./movies.module.css";
+import { MovieCardSkeleton, PageSelectorSkeleton, PaginationSkeleton } from "../components/LoadingSkeleton";
 
 /**
  * Loading Component for Movies Page
@@ -9,13 +11,21 @@ import loadingStyles from "./loading.module.css";
  */
 export default function Loading() {
   return (
-    <div>
-      <main>
-        <h1 className={loadingStyles.pageTitle}>Movies</h1>
-        <div className={loadingStyles.loadingContainer}>
-          <div className={loadingStyles.loadingSpinner}></div>
-          <p className={loadingStyles.loadingMessage}>Loading movies from the database...</p>
+    <div className={pageStyles.page}>
+      <main className={pageStyles.main}>
+        <h1 className={movieStyles.pageTitle}>Movies</h1>
+        <p className={movieStyles.movieCount}>Loading movies from the sample_mflix database...</p>
+        
+        <PageSelectorSkeleton />
+        
+        {/* Movies Grid Skeleton */}
+        <div className={movieStyles.moviesGrid}>
+          {[...Array(20)].map((_, i) => (
+            <MovieCardSkeleton key={i} />
+          ))}
         </div>
+        
+        <PaginationSkeleton />
       </main>
     </div>
   );
diff --git a/client/app/movies/movies.module.css b/client/app/movies/movies.module.css
index 37ec2c2..ae927d8 100644
--- a/client/app/movies/movies.module.css
+++ b/client/app/movies/movies.module.css
@@ -5,6 +5,238 @@
  * Provides responsive grid layout for the movies listing page.
  */
 
+.pageHeader {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: 24px;
+  flex-wrap: wrap;
+  gap: 16px;
+}
+
+.headerActions {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+  flex-wrap: wrap;
+}
+
+.selectionControls {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+
+.selectAllButton {
+  padding: 0.5rem 1rem;
+  background: #6c757d;
+  color: white;
+  border: none;
+  border-radius: 6px;
+  font-size: 0.875rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.selectAllButton:hover {
+  background: #5a6268;
+  transform: translateY(-1px);
+}
+
+.batchDeleteButton {
+  padding: 0.5rem 1rem;
+  background: #dc3545;
+  color: white;
+  border: none;
+  border-radius: 6px;
+  font-size: 0.875rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.batchDeleteButton:hover:not(:disabled) {
+  background: #c82333;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(220, 53, 69, 0.3);
+}
+
+.batchDeleteButton:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  transform: none;
+}
+
+.batchUpdateButton {
+  padding: 0.5rem 1rem;
+  background: #28a745;
+  color: white;
+  border: none;
+  border-radius: 6px;
+  font-size: 0.875rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.batchUpdateButton:hover:not(:disabled) {
+  background: #218838;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(40, 167, 69, 0.3);
+}
+
+.batchUpdateButton:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  transform: none;
+}
+
+.confirmationOverlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0, 0, 0, 0.5);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 1000;
+  padding: 20px;
+}
+
+.confirmationDialog {
+  background: white;
+  border-radius: 12px;
+  padding: 2rem;
+  max-width: 400px;
+  width: 100%;
+  box-shadow: 0 10px 25px rgba(0, 0, 0, 0.3);
+}
+
+.confirmationTitle {
+  margin: 0 0 1rem 0;
+  font-size: 1.25rem;
+  font-weight: 600;
+  color: #333;
+  text-align: center;
+}
+
+.confirmationMessage {
+  margin: 0 0 1.5rem 0;
+  color: #666;
+  text-align: center;
+  line-height: 1.5;
+}
+
+.confirmationActions {
+  display: flex;
+  gap: 12px;
+  justify-content: center;
+}
+
+.cancelButton {
+  padding: 0.75rem 1.5rem;
+  background: #6c757d;
+  color: white;
+  border: none;
+  border-radius: 8px;
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  min-width: 100px;
+}
+
+.cancelButton:hover {
+  background: #5a6268;
+  transform: translateY(-1px);
+}
+
+.confirmDeleteButton {
+  padding: 0.75rem 1.5rem;
+  background: #dc3545;
+  color: white;
+  border: none;
+  border-radius: 8px;
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  min-width: 100px;
+}
+
+.confirmDeleteButton:hover:not(:disabled) {
+  background: #c82333;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(220, 53, 69, 0.3);
+}
+
+.confirmDeleteButton:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  transform: none;
+}
+
+.pageTitle {
+  margin: 0;
+  font-size: 32px;
+  color: #333;
+}
+
+.addButton {
+  padding: 0.75rem 1.5rem;
+  background: #0070f3;
+  color: white;
+  border: none;
+  border-radius: 8px;
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  text-decoration: none;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 140px;
+}
+
+.addButton:hover:not(:disabled) {
+  background: #0051cc;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(0, 112, 243, 0.3);
+}
+
+.addButton:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  transform: none;
+}
+
+.successMessage {
+  background-color: #d1edff;
+  border: 1px solid #b8e6ff;
+  color: #0c5aa6;
+  padding: 1rem;
+  border-radius: 8px;
+  margin-bottom: 1rem;
+  text-align: center;
+  font-weight: 500;
+}
+
+.errorMessage {
+  background-color: #fef2f2;
+  border: 1px solid #fee2e2;
+  color: #991b1b;
+  padding: 1rem;
+  border-radius: 8px;
+  margin-bottom: 1rem;
+  text-align: center;
+  font-weight: 500;
+}
+
 .moviesGrid {
   display: grid;
   grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
@@ -19,15 +251,67 @@
   color: #666;
 }
 
-.pageTitle {
-  margin: 0 0 16px 0;
-  font-size: 32px;
-  color: #333;
-}
+/* Responsive Design */
+@media (max-width: 768px) {
+  .pageHeader {
+    flex-direction: column;
+    align-items: stretch;
+    gap: 12px;
+  }
 
-.movieCount {
-  margin: 0 0 32px 0;
-  color: #666;
-  font-size: 16px;
+  .headerActions {
+    flex-direction: column;
+    gap: 12px;
+  }
+
+  .selectionControls {
+    justify-content: center;
+  }
+
+  .pageTitle {
+    font-size: 28px;
+    text-align: center;
+  }
+
+  .addButton {
+    width: 100%;
+    padding: 0.875rem 1rem;
+  }
+
+  .confirmationDialog {
+    margin: 20px;
+    padding: 1.5rem;
+  }
+
+  .confirmationActions {
+    flex-direction: column;
+  }
+
+  .cancelButton,
+  .confirmDeleteButton {
+    width: 100%;
+  }
 }
 
+@media (max-width: 480px) {
+  .pageTitle {
+    font-size: 24px;
+  }
+
+  .addButton {
+    padding: 0.75rem 1rem;
+    font-size: 0.9rem;
+  }
+
+  .selectionControls {
+    flex-direction: column;
+    width: 100%;
+  }
+
+  .selectAllButton,
+  .batchDeleteButton,
+  .batchUpdateButton {
+    width: 100%;
+    padding: 0.75rem 1rem;
+  }
+}
diff --git a/client/app/movies/page.tsx b/client/app/movies/page.tsx
index 4cb2db3..c34e968 100644
--- a/client/app/movies/page.tsx
+++ b/client/app/movies/page.tsx
@@ -1,27 +1,355 @@
+'use client';
+
+import { useState, useEffect } from 'react';
+import { useSearchParams, useRouter } from 'next/navigation';
 import pageStyles from "./page.module.css";
 import movieStyles from "./movies.module.css";
-import MovieCard from "../components/MovieCard";
-import { fetchMovies } from "../lib/api";
-import { APP_CONFIG } from "../lib/constants";
+import { MovieCard, Pagination, PageSizeSelector, AddMovieForm, BatchEditMovieForm } from "../components";
+import { ErrorDisplay, LoadingSpinner } from "../components/ui";
+import { fetchMovies, createMovie, createMoviesBatch, deleteMoviesBatch, updateMoviesBatch } from "../lib/api";
+import { Movie } from "../types/movie";
+import { APP_CONFIG, ROUTES } from "../lib/constants";
+
+export default function Movies() {
+  const searchParams = useSearchParams();
+  const router = useRouter();
+  
+  const [movies, setMovies] = useState<Movie[]>([]);
+  const [hasNextPage, setHasNextPage] = useState(false);
+  const [hasPrevPage, setHasPrevPage] = useState(false);
+  const [isLoading, setIsLoading] = useState(true);
+  const [isCreating, setIsCreating] = useState(false);
+  const [isDeleting, setIsDeleting] = useState(false);
+  const [isUpdating, setIsUpdating] = useState(false);
+  const [showAddForm, setShowAddForm] = useState(false);
+  const [showBatchEditForm, setShowBatchEditForm] = useState(false);
+  const [selectedMovies, setSelectedMovies] = useState<Set<string>>(new Set());
+  const [showDeleteConfirmation, setShowDeleteConfirmation] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const [successMessage, setSuccessMessage] = useState<string | null>(null);
+  
+  const page = parseInt(searchParams.get('page') || '1');
+  const limit = Math.min(
+    parseInt(searchParams.get('limit') || APP_CONFIG.defaultMovieLimit.toString()), 
+    APP_CONFIG.maxMovieLimit
+  );
+  const skip = (page - 1) * limit;
+
+  const loadMovies = async () => {
+    setIsLoading(true);
+    setError(null);
+    
+    try {
+      const result = await fetchMovies(limit, skip);
+      setMovies(result.movies);
+      setHasNextPage(result.hasNextPage);
+      setHasPrevPage(result.hasPrevPage);
+    } catch (err) {
+      setError('Failed to load movies. Make sure the Express server is running on port 3001.');
+      setMovies([]);
+    }
+    
+    setIsLoading(false);
+  };
+
+  useEffect(() => {
+    loadMovies();
+  }, [page, limit]);
+
+  const handleAddMovie = () => {
+    setShowAddForm(true);
+    setError(null);
+    setSuccessMessage(null);
+  };
+
+  const handleCancelAdd = () => {
+    setShowAddForm(false);
+    setError(null);
+    setSuccessMessage(null);
+  };
+
+  const handleSaveMovie = async (moviesData: Omit<Movie, '_id'>[]) => {
+    setIsCreating(true);
+    setError(null);
+    setSuccessMessage(null);
+
+    // Choose between single and batch creation based on number of movies
+    if (moviesData.length === 1) {
+      // Single movie creation
+      const result = await createMovie(moviesData[0]);
+
+      if (result.success) {
+        setSuccessMessage('Movie created successfully!');
+        setShowAddForm(false);
+        
+        // Redirect to the new movie's page after a brief delay
+        setTimeout(() => {
+          router.push(ROUTES.movie(result.movieId!));
+        }, 2000);
+      } else {
+        setError(result.error || 'Failed to create movie');
+      }
+    } else {
+      // Batch movie creation
+      const result = await createMoviesBatch(moviesData);
+
+      if (result.success) {
+        setSuccessMessage(`Successfully created ${result.insertedCount} movies!`);
+        setShowAddForm(false);
+        
+        // Refresh the movies list after batch creation
+        setTimeout(() => {
+          loadMovies();
+        }, 2000);
+      } else {
+        setError(result.error || 'Failed to create movies');
+      }
+    }
+
+    setIsCreating(false);
+  };
+
+  const handleMovieSelection = (movieId: string, isSelected: boolean) => {
+    setSelectedMovies(prev => {
+      const newSelection = new Set(prev);
+      if (isSelected) {
+        newSelection.add(movieId);
+      } else {
+        newSelection.delete(movieId);
+      }
+      return newSelection;
+    });
+  };
+
+  const handleBatchDelete = () => {
+    if (selectedMovies.size > 0) {
+      setShowDeleteConfirmation(true);
+    }
+  };
+
+  const handleBatchUpdate = () => {
+    if (selectedMovies.size > 0) {
+      setShowBatchEditForm(true);
+      setError(null);
+      setSuccessMessage(null);
+    }
+  };
+
+  const handleCancelBatchEdit = () => {
+    setShowBatchEditForm(false);
+    setError(null);
+    setSuccessMessage(null);
+  };
+
+  const handleSaveBatchEdit = async (updateData: Partial<Movie>) => {
+    setIsUpdating(true);
+    setError(null);
+    setSuccessMessage(null);
+
+    const movieIds = Array.from(selectedMovies);
+    const result = await updateMoviesBatch(movieIds, updateData);
+
+    if (result.success) {
+      setSuccessMessage(`Successfully updated ${result.modifiedCount} out of ${result.matchedCount} movies!`);
+      setShowBatchEditForm(false);
+      setSelectedMovies(new Set()); // Clear selection
+      
+      // Refresh the movies list
+      setTimeout(() => {
+        loadMovies();
+      }, 1500);
+    } else {
+      setError(result.error || 'Failed to update movies');
+    }
 
-export default async function Movies() {
-  const movies = await fetchMovies(APP_CONFIG.defaultMovieLimit);
+    setIsUpdating(false);
+  };
+
+  const confirmBatchDelete = async () => {
+    setIsDeleting(true);
+    setError(null);
+    setSuccessMessage(null);
+    setShowDeleteConfirmation(false);
+
+    const movieIds = Array.from(selectedMovies);
+    const result = await deleteMoviesBatch(movieIds);
+
+    if (result.success) {
+      setSuccessMessage(`Successfully deleted ${result.deletedCount} movies!`);
+      setSelectedMovies(new Set()); // Clear selection
+      
+      // Refresh the movies list
+      setTimeout(() => {
+        loadMovies();
+      }, 1500);
+    } else {
+      setError(result.error || 'Failed to delete movies');
+    }
+
+    setIsDeleting(false);
+  };
+
+  const cancelBatchDelete = () => {
+    setShowDeleteConfirmation(false);
+  };
+
+  if (isLoading && !showAddForm) {
+    return (
+      <div className={pageStyles.page}>
+        <main className={pageStyles.main}>
+          <div style={{ textAlign: 'center', padding: '2rem' }}>
+            <LoadingSpinner />
+            <p>Loading movies...</p>
+          </div>
+        </main>
+      </div>
+    );
+  }
 
   return (
     <div className={pageStyles.page}>
       <main className={pageStyles.main}>
-        <h1 className={movieStyles.pageTitle}>Movies</h1>
-        <p className={movieStyles.movieCount}>Displaying {movies.length} movies from the sample_mflix database</p>
+        <div className={movieStyles.pageHeader}>
+          <h1 className={movieStyles.pageTitle}>Movies</h1>
+          
+          <div className={movieStyles.headerActions}>
+            {/* Batch Selection Controls */}
+            {!showAddForm && !showBatchEditForm && movies.length > 0 && (
+              <div className={movieStyles.selectionControls}>
+                {selectedMovies.size > 0 && (
+                  <>
+                    <button
+                      onClick={handleBatchUpdate}
+                      disabled={isUpdating}
+                      className={movieStyles.batchUpdateButton}
+                      type="button"
+                    >
+                      {isUpdating ? 'Updating...' : `Update ${selectedMovies.size} Selected`}
+                    </button>
+                    
+                    <button
+                      onClick={handleBatchDelete}
+                      disabled={isDeleting}
+                      className={movieStyles.batchDeleteButton}
+                      type="button"
+                    >
+                      {isDeleting ? 'Deleting...' : `Delete ${selectedMovies.size} Selected`}
+                    </button>
+                  </>
+                )}
+              </div>
+            )}
+
+            <button
+              onClick={handleAddMovie}
+              disabled={showAddForm || showBatchEditForm || isCreating}
+              className={movieStyles.addButton}
+              type="button"
+            >
+              {isCreating ? 'Creating...' : '+ Add Movie'}
+            </button>
+          </div>
+        </div>
+
+        {/* Success/Error Messages */}
+        {successMessage && (
+          <div className={movieStyles.successMessage}>
+            {successMessage}
+          </div>
+        )}
         
-        {movies.length === 0 ? (
-          <div className={movieStyles.noMovies}>
-            <p>No movies found. Make sure the Express server is running on port 3001.</p>
+        {error && (
+          <div className={movieStyles.errorMessage}>
+            {error}
           </div>
-        ) : (
-          <div className={movieStyles.moviesGrid}>
-            {movies.map((movie) => (
-              <MovieCard key={movie._id} movie={movie} />
-            ))}
+        )}
+
+        {/* Add Movie Form */}
+        {showAddForm && (
+          <AddMovieForm
+            onSave={handleSaveMovie}
+            onCancel={handleCancelAdd}
+            isLoading={isCreating}
+          />
+        )}
+
+        {/* Batch Edit Movie Form */}
+        {showBatchEditForm && (
+          <BatchEditMovieForm
+            selectedCount={selectedMovies.size}
+            onSave={handleSaveBatchEdit}
+            onCancel={handleCancelBatchEdit}
+            isLoading={isUpdating}
+          />
+        )}
+
+        {/* Page Size Selector */}
+        {!showAddForm && !showBatchEditForm && <PageSizeSelector currentLimit={limit} />}
+        
+        {/* Movies Content */}
+        {!showAddForm && !showBatchEditForm && (
+          <>
+            {error && movies.length === 0 ? (
+              <ErrorDisplay 
+                message={error} 
+                onRetry={loadMovies}
+              />
+            ) : movies.length === 0 ? (
+              <div className={movieStyles.noMovies}>
+                <p>No movies found. Make sure the Express server is running on port 3001.</p>
+              </div>
+            ) : (
+              <>
+                <div className={movieStyles.moviesGrid}>
+                  {movies.map((movie) => (
+                    <MovieCard 
+                      key={movie._id} 
+                      movie={movie} 
+                      isSelected={selectedMovies.has(movie._id)}
+                      onSelectionChange={handleMovieSelection}
+                      showCheckbox={!showAddForm && !showBatchEditForm}
+                    />
+                  ))}
+                </div>
+                
+                <Pagination
+                  currentPage={page}
+                  hasNextPage={hasNextPage}
+                  hasPrevPage={hasPrevPage}
+                  limit={limit}
+                />
+              </>
+            )}
+          </>
+        )}
+
+        {/* Batch Delete Confirmation Dialog */}
+        {showDeleteConfirmation && (
+          <div className={movieStyles.confirmationOverlay}>
+            <div className={movieStyles.confirmationDialog}>
+              <h3 className={movieStyles.confirmationTitle}>Confirm Batch Delete</h3>
+              <p className={movieStyles.confirmationMessage}>
+                Are you sure you want to delete {selectedMovies.size} selected movie{selectedMovies.size !== 1 ? 's' : ''}? 
+                This action cannot be undone.
+              </p>
+              <div className={movieStyles.confirmationActions}>
+                <button
+                  onClick={cancelBatchDelete}
+                  className={movieStyles.cancelButton}
+                  type="button"
+                >
+                  Cancel
+                </button>
+                <button
+                  onClick={confirmBatchDelete}
+                  className={movieStyles.confirmDeleteButton}
+                  type="button"
+                  disabled={isDeleting}
+                >
+                  {isDeleting ? 'Deleting...' : 'Delete'}
+                </button>
+              </div>
+            </div>
           </div>
         )}
       </main>
diff --git a/client/app/types/movie.ts b/client/app/types/movie.ts
index ea5b8d8..360a87b 100644
--- a/client/app/types/movie.ts
+++ b/client/app/types/movie.ts
@@ -12,11 +12,45 @@ export interface Movie {
   title: string;
   year?: number;
   plot?: string;
+  fullplot?: string;
+  released?: string;
+  runtime?: number;
   poster?: string;
   genres?: string[];
+  directors?: string[];
+  writers?: string[];
+  cast?: string[];
+  countries?: string[];
+  languages?: string[];
+  rated?: string;
+  awards?: {
+    wins?: number;
+    nominations?: number;
+    text?: string;
+  };
   imdb?: {
     rating?: number;
+    votes?: number;
+    id?: number;
+  };
+  tomatoes?: {
+    viewer?: {
+      rating?: number;
+      numReviews?: number;
+      meter?: number;
+    };
+    critic?: {
+      rating?: number;
+      numReviews?: number;
+      meter?: number;
+    };
+    fresh?: number;
+    rotten?: number;
+    production?: string;
+    lastUpdated?: string;
   };
+  metacritic?: number;
+  type?: string;
 }
 
 /**
@@ -27,11 +61,11 @@ export interface MoviesApiResponse {
   success: boolean;
   data: Movie[];
   message?: string;
-}
-
-/**
- * Props interface for MovieCard component
- */
-export interface MovieCardProps {
-  movie: Movie;
+  timestamp: string;
+  pagination?: {
+    page: number;
+    limit: number;
+    total: number;
+    pages: number;
+  };
 }
\ No newline at end of file
diff --git a/server/express/src/controllers/movieController.ts b/server/express/src/controllers/movieController.ts
index d1ef1f5..3e3dd59 100644
--- a/server/express/src/controllers/movieController.ts
+++ b/server/express/src/controllers/movieController.ts
@@ -353,9 +353,23 @@ export async function updateMoviesBatch(
 
   const moviesCollection = getCollection("movies");
 
+  // Handle ObjectId conversion for _id fields in $in queries
+  let processedFilter = { ...filter };
+  if (filter._id && filter._id.$in && Array.isArray(filter._id.$in)) {
+    // Convert string IDs to ObjectId instances
+    processedFilter._id = {
+      $in: filter._id.$in.map((id: string) => {
+        if (ObjectId.isValid(id)) {
+          return new ObjectId(id);
+        }
+        throw new Error(`Invalid ObjectId: ${id}`);
+      })
+    };
+  }
+
   // Use updateMany() to update multiple documents
   // This is useful for bulk operations like updating all movies from a certain year
-  const result = await moviesCollection.updateMany(filter, { $set: update });
+  const result = await moviesCollection.updateMany(processedFilter, { $set: update });
 
   res.json(
     createSuccessResponse(
@@ -434,9 +448,23 @@ export async function deleteMoviesBatch(
 
   const moviesCollection = getCollection("movies");
 
+  // Handle ObjectId conversion for _id fields in $in queries
+  let processedFilter = { ...filter };
+  if (filter._id && filter._id.$in && Array.isArray(filter._id.$in)) {
+    // Convert string IDs to ObjectId instances
+    processedFilter._id = {
+      $in: filter._id.$in.map((id: string) => {
+        if (ObjectId.isValid(id)) {
+          return new ObjectId(id);
+        }
+        throw new Error(`Invalid ObjectId: ${id}`);
+      })
+    };
+  }
+
   // Use deleteMany() to remove multiple documents
   // This operation is useful for cleanup tasks like removing all movies from a certain year
-  const result = await moviesCollection.deleteMany(filter);
+  const result = await moviesCollection.deleteMany(processedFilter);
 
   res.json(
     createSuccessResponse(

From 180959fa747699cada665835b24e2ada714eeafb Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Mon, 3 Nov 2025 16:58:40 -0500
Subject: [PATCH 042/110] Apply Jordan feedback

---
 server/java-spring/pom.xml                    | 11 +++
 .../config/DatabaseVerification.java          | 88 +++++++++++++++++++
 .../samplemflix/config/MongoConfig.java       | 49 +++++++----
 .../controller/MovieControllerImpl.java       | 14 +--
 .../model/dto/MovieSearchRequest.java         |  5 +-
 .../samplemflix/service/MovieService.java     |  8 +-
 .../samplemflix/service/MovieServiceImpl.java | 44 ++++++----
 .../controller/MovieControllerTest.java       | 10 +--
 ...java => MongoDBSearchIntegrationTest.java} | 52 +++++------
 .../mongodb/samplemflix/integration/README.md |  8 +-
 .../samplemflix/service/MovieServiceTest.java | 12 +--
 11 files changed, 214 insertions(+), 87 deletions(-)
 rename server/java-spring/src/test/java/com/mongodb/samplemflix/integration/{AtlasSearchIntegrationTest.java => MongoDBSearchIntegrationTest.java} (88%)

diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index 4e2f946..a4e5d8a 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -110,6 +110,17 @@
                 </configuration>
             </plugin>
 
+            <!-- Maven Compiler Plugin - Suppress annotation processing warnings -->
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <configuration>
+                    <compilerArgs>
+                        <arg>-Xlint:-options</arg>
+                    </compilerArgs>
+                </configuration>
+            </plugin>
+
             <!-- Maven Surefire Plugin - Configure Mockito agent for Java 21+ -->
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
index fef480f..ea5d950 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -33,7 +33,10 @@ public class DatabaseVerification {
     private static final Logger logger = LoggerFactory.getLogger(DatabaseVerification.class);
 
     private static final String MOVIES_COLLECTION = "movies";
+    private static final String COMMENTS_COLLECTION = "comments";
     private static final String TEXT_INDEX_NAME = "text_search_index";
+    private static final String YEAR_INDEX_NAME = "year_index";
+    private static final String MOVIE_ID_INDEX_NAME = "movie_id_index";
 
     private final MongoDatabase database;
 
@@ -58,6 +61,9 @@ public void verifyDatabase() {
             // Verify movies collection exists and has data
             verifyMoviesCollection();
 
+            // Verify comments collection and create indexes for aggregation performance
+            verifyCommentsCollection();
+
             logger.info("Database verification completed successfully");
 
         } catch (Exception e) {
@@ -97,6 +103,9 @@ private void verifyMoviesCollection() {
 
         // Create text search index for full-text search functionality
         createTextSearchIndex(moviesCollection);
+
+        // Create year index for aggregation performance
+        createYearIndex(moviesCollection);
     }
 
     /**
@@ -146,4 +155,83 @@ private void createTextSearchIndex(MongoCollection<Document> moviesCollection) {
             logger.warn("Text search functionality may not work without the index");
         }
     }
+
+    /**
+     * Creates an index on the year field for the movies collection.
+     *
+     * <p>This index improves performance for aggregation queries that filter by year,
+     * such as the movies with comments aggregation.
+     *
+     * @param moviesCollection the movies collection to create the index on
+     */
+    private void createYearIndex(MongoCollection<Document> moviesCollection) {
+        try {
+            IndexOptions indexOptions = new IndexOptions()
+                    .name(YEAR_INDEX_NAME)
+                    .background(true);
+
+            moviesCollection.createIndex(
+                Indexes.ascending(Movie.Fields.YEAR),
+                indexOptions
+            );
+
+            logger.info("Year index '{}' created/verified for movies collection", YEAR_INDEX_NAME);
+
+        } catch (Exception e) {
+            logger.error("Could not create year index: {}", e.getMessage());
+            logger.warn("Aggregation queries filtering by year may be slower without the index");
+        }
+    }
+
+    /**
+     * Verifies the comments collection and creates necessary indexes.
+     *
+     * <p>This method creates an index on the movie_id field to improve $lookup performance
+     * when joining movies with comments in aggregation pipelines.
+     */
+    private void verifyCommentsCollection() {
+        MongoCollection<Document> commentsCollection = database.getCollection(COMMENTS_COLLECTION);
+
+        // Check if collection has documents
+        long count = commentsCollection.estimatedDocumentCount();
+
+        logger.info("Comments collection found with {} documents", count);
+
+        if (count == 0) {
+            logger.warn(
+                "Comments collection is empty. Please ensure sample_mflix data is loaded."
+            );
+        }
+
+        // Create movie_id index for $lookup performance
+        createMovieIdIndex(commentsCollection);
+    }
+
+    /**
+     * Creates an index on the movie_id field for the comments collection.
+     *
+     * <p>This index is critical for $lookup performance when joining movies with comments.
+     * Without this index, the $lookup operation will perform a collection scan for each movie,
+     * which can cause timeouts on large datasets.
+     *
+     * @param commentsCollection the comments collection to create the index on
+     */
+    private void createMovieIdIndex(MongoCollection<Document> commentsCollection) {
+        try {
+            IndexOptions indexOptions = new IndexOptions()
+                    .name(MOVIE_ID_INDEX_NAME)
+                    .background(true);
+
+            commentsCollection.createIndex(
+                Indexes.ascending("movie_id"),
+                indexOptions
+            );
+
+            logger.info("Movie ID index '{}' created/verified for comments collection", MOVIE_ID_INDEX_NAME);
+
+        } catch (Exception e) {
+            logger.error("Could not create movie_id index: {}", e.getMessage());
+            logger.warn("$lookup aggregations joining movies with comments may timeout without the index");
+        }
+    }
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
index df4395c..32b3e16 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
@@ -10,28 +10,29 @@
 import org.springframework.context.annotation.Configuration;
 import org.springframework.data.mongodb.config.AbstractMongoClientConfiguration;
 import org.springframework.data.mongodb.repository.config.EnableMongoRepositories;
+import org.springframework.lang.NonNull;
 
 /**
  * MongoDB configuration class for the Sample MFlix application using Spring Data MongoDB.
  *
  * <p>This class extends AbstractMongoClientConfiguration to customize MongoDB client settings
- * while leveraging Spring Data MongoDB's auto-configuration for repositories and templates.
+ * while leveraging Spring Data MongoDB's autoconfiguration for repositories and templates.
  *
  * <p>Key features:
- * <pre>
- * - Connection pooling with configurable settings (max 100 connections, min 10)
- * - Connection timeout configuration (10 seconds for connect and read)
- * - Automatic POJO mapping (no manual codec configuration needed)
- * - Repository scanning and auto-configuration
- * - MongoTemplate bean creation for complex queries
- * </pre>
+* <ul>
+*   <li>Connection pooling with configurable settings (max 100 connections, min 10)</li>
+*   <li>Connection timeout configuration (10 seconds for connect and read)</li>
+*   <li>Automatic POJO mapping (no manual codec configuration needed)</li>
+*   <li>Repository scanning and auto-configuration</li>
+*   <li>MongoTemplate bean creation for complex queries</li>
+* </ul>
  * <p>Spring Data MongoDB automatically:
- * <pre>
- * - Creates MongoClient and MongoTemplate beans
- * - Handles POJO to BSON conversion
- * - Manages connection lifecycle
- * - Provides repository implementations
- * </pre>
+* <ul>
+*   <li>Creates MongoClient and MongoTemplate beans</li>
+*   <li>Handles POJO to BSON conversion</li>
+*   <li>Manages connection lifecycle</li>
+*   <li>Provides repository implementations</li>
+* </ul>
  */
 @Configuration
 @EnableMongoRepositories(basePackages = "com.mongodb.samplemflix.repository")
@@ -87,10 +88,28 @@ protected void configureClientSettings(MongoClientSettings.Builder builder) {
      * driver API (like DatabaseVerification), while still using Spring Data MongoDB
      * for repository operations.
      *
+     * <p><strong>Note on null safety:</strong> The {@code mongoClient()} method is provided by
+     * {@link AbstractMongoClientConfiguration} and is guaranteed to return a non-null instance
+     * by Spring's bean lifecycle management. The MongoClient bean is created before this method
+     * is called during application context initialization.
+     *
      * @return the configured MongoDatabase instance
+     * @throws IllegalStateException if MongoClient is not properly initialized (should never happen
+     *         in normal Spring context lifecycle)
      */
     @Bean
+    @NonNull
     public MongoDatabase mongoDatabase() {
-        return mongoClient().getDatabase(databaseName);
+        MongoClient client = mongoClient();
+
+        // Defensive check - should never be null due to Spring's bean lifecycle guarantees,
+        // but we check anyway to fail fast with a clear error message if something is wrong
+        if (client == null) {
+            throw new IllegalStateException(
+                "MongoClient is not initialized. This indicates a problem with Spring context initialization."
+            );
+        }
+
+        return client.getDatabase(databaseName);
     }
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index 15b7dfd..2cac95c 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -41,7 +41,7 @@
  * - GET /api/movies/aggregations/comments - Aggregate movies with most comments
  * - GET /api/movies/aggregations/years - Aggregate movies by year with statistics
  * - GET /api/movies/aggregations/directors - Aggregate directors with most movies
- * - GET /api/movies/search - Text search using Atlas Search Index across multiple fields (plot, fullplot, directors, writers, cast)
+ * - GET /api/movies/search - Text search using MongoDB Search Index across multiple fields (plot, fullplot, directors, writers, cast)
  * - GET /api/movies/find-similar-movies - Vector search to find similar movies based on plot embeddings
  * </pre>
  */
@@ -288,13 +288,13 @@ public ResponseEntity<SuccessResponse<DeleteResponse>> deleteMoviesBatch(
                      "Demonstrates how to combine data from the movies and comments collections."
     )
     @GetMapping("/aggregations/comments")
-    public ResponseEntity<SuccessResponse<List<MovieWithCommentsResult>>> getMoviesWithMostComments(
+    public ResponseEntity<SuccessResponse<List<MovieWithCommentsResult>>> getMoviesWithMostRecentComments(
             @Parameter(description = "Maximum number of movies to return (default: 10, max: 50)")
             @RequestParam(defaultValue = "10") Integer limit,
             @Parameter(description = "Optional movie ID to filter by specific movie")
             @RequestParam(required = false) String movieId) {
 
-        List<MovieWithCommentsResult> results = movieService.getMoviesWithMostComments(limit, movieId);
+        List<MovieWithCommentsResult> results = movieService.getMoviesWithMostRecentComments(limit, movieId);
 
         // Calculate total comments across all movies
         int totalComments = results.stream()
@@ -361,11 +361,11 @@ public ResponseEntity<SuccessResponse<List<DirectorStatisticsResult>>> getDirect
         return ResponseEntity.ok(response);
     }
 
-    // Atlas Search endpoints
+    // MongoDB Search endpoints
 
     @Operation(
-        summary = "Search movies using MongoDB Atlas Search",
-        description = "Search movies using MongoDB Atlas Search across multiple fields (plot, fullplot, directors, writers, cast). " +
+        summary = "Search movies using MongoDB Search",
+        description = "Search movies using MongoDB Search across multiple fields (plot, fullplot, directors, writers, cast). " +
                      "You can combine multiple fields in a single query and control how they are combined using the searchOperator parameter. " +
                      "At least one search field must be provided. " +
                      "Plot and fullplot use phrase operator for exact matching, while directors, writers, and cast use text operator with fuzzy matching."
@@ -415,7 +415,7 @@ public ResponseEntity<SuccessResponse<List<Movie>>> searchMovies(
 
     @Operation(
         summary = "Find similar movies using vector search",
-        description = "Find similar movies using MongoDB Atlas Vector Search on plot embeddings. " +
+        description = "Find similar movies using MongoDB Vector Search on plot embeddings. " +
                      "Demonstrates how to use vector search to find movies with similar plots based on semantic similarity."
     )
     @GetMapping("/find-similar-movies")
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchRequest.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchRequest.java
index 4d4c56f..f309079 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchRequest.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchRequest.java
@@ -6,10 +6,10 @@
 import lombok.NoArgsConstructor;
 
 /**
- * Data Transfer Object for Atlas Search query parameters.
+ * Data Transfer Object for MongoDB Search query parameters.
  *
  * <p>This DTO is used to parse and validate query parameters for GET /api/movies/search requests.
- * It supports searching across multiple fields using MongoDB Atlas Search with compound operators.
+ * It supports searching across multiple fields using MongoDB Search with compound operators.
  */
 @Data
 @Builder
@@ -86,4 +86,3 @@ public boolean hasSearchFields() {
                (cast != null && !cast.trim().isEmpty());
     }
 }
-
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
index b4ac462..bded6df 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
@@ -45,7 +45,7 @@ public interface MovieService {
      * @param movieId Optional movie ID to filter by specific movie
      * @return List of movies with their recent comments
      */
-    List<MovieWithCommentsResult> getMoviesWithMostComments(Integer limit, String movieId);
+    List<MovieWithCommentsResult> getMoviesWithMostRecentComments(Integer limit, String movieId);
 
     /**
      * Aggregates movies by year with statistics.
@@ -62,11 +62,11 @@ public interface MovieService {
      */
     List<DirectorStatisticsResult> getDirectorsWithMostMovies(Integer limit);
 
-    // Atlas Search endpoints
+    // MongoDB Search endpoints
 
     /**
-     * Searches movies using MongoDB Atlas Search across multiple fields.
-     * Demonstrates text search using Atlas Search Index with compound operators.
+     * Searches movies using MongoDB Search across multiple fields.
+     * Demonstrates text search using a Search Index with compound operators.
      *
      * <p>Supports searching across:
      * <ul>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index f49b05d..a157d4f 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -332,7 +332,7 @@ private Update buildUpdate(UpdateMovieRequest request) {
     // Aggregation methods for reporting
 
     @Override
-    public List<MovieWithCommentsResult> getMoviesWithMostComments(Integer limit, String movieId) {
+    public List<MovieWithCommentsResult> getMoviesWithMostRecentComments(Integer limit, String movieId) {
         // Validate and set default limit
         int resultLimit = Math.clamp(limit != null ? limit : 10, 1, 50);
 
@@ -347,24 +347,30 @@ public List<MovieWithCommentsResult> getMoviesWithMostComments(Integer limit, St
             matchCriteria = matchCriteria.and(Movie.Fields.ID).is(new ObjectId(movieId));
         }
 
+        // Determine final result limit based on query type
+        // When querying a specific movie, allow more results (50)
+        // When querying all movies, use a smaller limit (20) to reduce server load
+        int finalLimit = (movieId != null && !movieId.trim().isEmpty()) ? 50 : 20;
+
         // Build aggregation pipeline
-        // This demonstrates $lookup (join), $unwind, $sort, $group, and $project operations
-        // Optimized to limit movies before $lookup to reduce processing time
+        // This demonstrates $lookup (join), $addFields, $sort, and $project operations
+        // Note: We perform $lookup on all matching movies, then sort and limit
+        // This ensures we get the movies with the MOST RECENT comments, not just the first N movies
         Aggregation aggregation = Aggregation.newAggregation(
-                // STAGE 1: Match movies with valid year data
+                // STAGE 1: Match movies with valid year data (and optional movie ID filter)
+                // Tip: Use $match early in the pipeline to reduce the dataset size
                 Aggregation.match(matchCriteria),
 
-                // STAGE 2: Limit movies before lookup (optimization: process fewer documents)
-                // We'll get more results than needed, then filter and re-limit after lookup
-                Aggregation.limit(resultLimit * 10),
-
-                // STAGE 3: Lookup (join) with comments collection
+                // STAGE 2: Lookup (join) with comments collection
+                // This performs a left outer join, giving each movie a 'comments' array
                 Aggregation.lookup("comments", "_id", "movie_id", "comments"),
 
-                // STAGE 4: Filter to only movies with comments
+                // STAGE 3: Filter to only movies that have comments
+                // This converts the left join to an inner join
                 Aggregation.match(Criteria.where("comments").ne(List.of())),
 
-                // STAGE 5: Add computed fields
+                // STAGE 4: Add computed fields
+                // Calculate totalComments and mostRecentCommentDate for sorting
                 Aggregation.project()
                         .and(Movie.Fields.ID).as("_id")
                         .and(Movie.Fields.TITLE).as("title")
@@ -377,13 +383,17 @@ public List<MovieWithCommentsResult> getMoviesWithMostComments(Integer limit, St
                         .and(ArrayOperators.Size.lengthOfArray("comments")).as("totalComments")
                         .and(ArrayOperators.ArrayElemAt.arrayOf("comments.date").elementAt(0)).as("mostRecentCommentDate"),
 
-                // STAGE 6: Sort by most recent comment date (descending)
+                // STAGE 5: Sort by most recent comment date (descending)
+                // This ensures we get movies with the MOST RECENT comment activity
                 Aggregation.sort(Sort.Direction.DESC, "mostRecentCommentDate"),
 
-                // STAGE 7: Limit results to requested amount
-                Aggregation.limit(resultLimit),
+                // STAGE 6: Limit results
+                // Apply limit AFTER sorting to get the correct top N movies by recent comment activity
+                // Limit is conditional: 50 for single movie queries, 20 for all movies
+                Aggregation.limit(finalLimit),
 
-                // STAGE 8: Project final output with recent comments slice
+                // STAGE 7: Project final output with recent comments slice
+                // Shape the response and include only the 5 most recent comments per movie
                 Aggregation.project()
                         .and(ConditionalOperators.ifNull("_id").then("")).as("id")
                         .and("title").as("title")
@@ -563,7 +573,7 @@ private MovieWithCommentsResult mapToMovieWithCommentsResult(Document doc) {
                 .build();
     }
 
-    // Atlas Search methods
+    // MongoDB Search methods
 
     @Override
     public List<Movie> searchMovies(MovieSearchRequest searchRequest) {
@@ -688,7 +698,7 @@ public List<Movie> searchMovies(MovieSearchRequest searchRequest) {
                     .map(doc -> mongoTemplate.getConverter().read(Movie.class, doc))
                     .into(new java.util.ArrayList<>());
         } catch (Exception e) {
-            throw new DatabaseOperationException("Error performing Atlas Search: " + e.getMessage());
+            throw new DatabaseOperationException("Error performing MongoDB Search: " + e.getMessage());
         }
     }
 
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
index 66f82d5..9239042 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
@@ -361,7 +361,7 @@ void testGetMoviesWithMostComments_Success() throws Exception {
                 .mostRecentCommentDate(new Date())
                 .build();
 
-        when(movieService.getMoviesWithMostComments(anyInt(), isNull())).thenReturn(Arrays.asList(result));
+        when(movieService.getMoviesWithMostRecentComments(anyInt(), isNull())).thenReturn(Arrays.asList(result));
 
         // Act & Assert
         mockMvc.perform(get("/api/movies/aggregations/comments"))
@@ -380,7 +380,7 @@ void testGetMoviesWithMostComments_Success() throws Exception {
     @DisplayName("GET /api/movies/aggregations/comments - Should accept limit parameter")
     void testGetMoviesWithMostComments_WithLimit() throws Exception {
         // Arrange
-        when(movieService.getMoviesWithMostComments(eq(5), isNull())).thenReturn(Arrays.asList());
+        when(movieService.getMoviesWithMostRecentComments(eq(5), isNull())).thenReturn(Arrays.asList());
 
         // Act & Assert
         mockMvc.perform(get("/api/movies/aggregations/comments")
@@ -395,7 +395,7 @@ void testGetMoviesWithMostComments_WithLimit() throws Exception {
     void testGetMoviesWithMostComments_WithMovieId() throws Exception {
         // Arrange
         String movieId = testId.toHexString();
-        when(movieService.getMoviesWithMostComments(anyInt(), eq(movieId))).thenReturn(Arrays.asList());
+        when(movieService.getMoviesWithMostRecentComments(anyInt(), eq(movieId))).thenReturn(Arrays.asList());
 
         // Act & Assert
         mockMvc.perform(get("/api/movies/aggregations/comments")
@@ -410,7 +410,7 @@ void testGetMoviesWithMostComments_WithMovieId() throws Exception {
     void testGetMoviesWithMostComments_InvalidMovieId() throws Exception {
         // Arrange
         String invalidMovieId = "invalid-id";
-        when(movieService.getMoviesWithMostComments(anyInt(), eq(invalidMovieId)))
+        when(movieService.getMoviesWithMostRecentComments(anyInt(), eq(invalidMovieId)))
                 .thenThrow(new ValidationException("Invalid movie ID format"));
 
         // Act & Assert
@@ -503,7 +503,7 @@ void testGetDirectorsWithMostMovies_WithLimit() throws Exception {
                 .andExpect(jsonPath("$.data").isArray());
     }
 
-    // ==================== ATLAS SEARCH ENDPOINT TESTS ====================
+    // ==================== MongoDB SEARCH ENDPOINT TESTS ====================
 
     @Test
     @DisplayName("GET /api/movies/search - Should search movies by plot successfully")
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MongoDBSearchIntegrationTest.java
similarity index 88%
rename from server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java
rename to server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MongoDBSearchIntegrationTest.java
index dfd2e14..d1b65cb 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/AtlasSearchIntegrationTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MongoDBSearchIntegrationTest.java
@@ -23,24 +23,24 @@
 import org.springframework.test.context.ActiveProfiles;
 
 /**
- * Integration tests for Atlas Search functionality.
+ * Integration tests for MongoDB Search functionality.
  *
- * <p>These tests verify the Atlas Search endpoints work correctly with a real MongoDB Atlas instance.
+ * <p>These tests verify the MongoDB Search endpoints work correctly with a real MongoDB Atlas instance.
  * The tests require:
  * <ul>
  *   <li>A MongoDB Atlas cluster (not local MongoDB)</li>
  *   <li>MONGODB_URI environment variable pointing to Atlas</li>
- *   <li>Atlas Search index creation and polling for readiness</li>
+ *   <li>MongoDB Search index creation and polling for readiness</li>
  * </ul>
  *
  * <p>Note: These tests are disabled by default and should only be run against a test Atlas cluster.
- * To enable, set the environment variable ENABLE_ATLAS_SEARCH_TESTS=true
+ * To enable, set the environment variable ENABLE_SEARCH_TESTS=true
  */
 @SpringBootTest
 @TestInstance(TestInstance.Lifecycle.PER_CLASS)
 @ActiveProfiles("test")
-@DisplayName("Atlas Search Integration Tests")
-class AtlasSearchIntegrationTest {
+@DisplayName("MongoDB Search Integration Tests")
+class MongoDBSearchIntegrationTest {
 
     @Autowired
     private MovieService movieService;
@@ -58,24 +58,24 @@ class AtlasSearchIntegrationTest {
     @BeforeAll
     void setUp() throws Exception {
         // Skip tests if not running against Atlas
-        if (!isAtlasSearchEnabled()) {
-            System.out.println("Skipping Atlas Search tests - ENABLE_ATLAS_SEARCH_TESTS not set");
+        if (!isSearchEnabled()) {
+            System.out.println("Skipping MongoDB Search tests - ENABLE_SEARCH_TESTS not set");
             return;
         }
 
-        System.out.println("Setting up Atlas Search integration tests...");
+        System.out.println("Setting up MongoDB Search integration tests...");
 
         // Create test data
         createTestMovies();
 
-        // Create Atlas Search index
+        // Create Search index
         createSearchIndex();
 
         // Wait for index to be ready
         waitForSearchIndexReady();
 
         // Wait a bit for the newly created documents to be indexed
-        // Atlas Search indexes documents asynchronously
+        // MongoDB Search indexes documents asynchronously
         System.out.println("Waiting for test documents to be indexed...");
         try {
             Thread.sleep(10000); // Wait 10 seconds for indexing
@@ -83,16 +83,16 @@ void setUp() throws Exception {
             Thread.currentThread().interrupt();
         }
 
-        System.out.println("Atlas Search index is ready for testing");
+        System.out.println("MongoDB Search index is ready for testing");
     }
 
     @AfterAll
     void tearDown() {
-        if (!isAtlasSearchEnabled()) {
+        if (!isSearchEnabled()) {
             return;
         }
 
-        System.out.println("Cleaning up Atlas Search test data...");
+        System.out.println("Cleaning up MongoDB Search test data...");
 
         // Clean up test movies
         if (!testMovieIds.isEmpty()) {
@@ -107,10 +107,10 @@ void tearDown() {
     }
 
     @Test
-    @DisplayName("Should search movies by plot using Atlas Search")
+    @DisplayName("Should search movies by plot using MongoDB Search")
     void testSearchMoviesByPlot_Success() {
-        if (!isAtlasSearchEnabled()) {
-            System.out.println("Skipping test - Atlas Search not enabled");
+        if (!isSearchEnabled()) {
+            System.out.println("Skipping test - Search not enabled");
             return;
         }
 
@@ -138,8 +138,8 @@ void testSearchMoviesByPlot_Success() {
     @Test
     @DisplayName("Should return empty list when no movies match search query")
     void testSearchMoviesByPlot_NoResults() {
-        if (!isAtlasSearchEnabled()) {
-            System.out.println("Skipping test - Atlas Search not enabled");
+        if (!isSearchEnabled()) {
+            System.out.println("Skipping test - Search not enabled");
             return;
         }
 
@@ -161,8 +161,8 @@ void testSearchMoviesByPlot_NoResults() {
     @Test
     @DisplayName("Should respect limit parameter in search")
     void testSearchMoviesByPlot_WithLimit() {
-        if (!isAtlasSearchEnabled()) {
-            System.out.println("Skipping test - Atlas Search not enabled");
+        if (!isSearchEnabled()) {
+            System.out.println("Skipping test - Search not enabled");
             return;
         }
 
@@ -184,8 +184,8 @@ void testSearchMoviesByPlot_WithLimit() {
     @Test
     @DisplayName("Should support pagination with skip parameter")
     void testSearchMoviesByPlot_WithPagination() {
-        if (!isAtlasSearchEnabled()) {
-            System.out.println("Skipping test - Atlas Search not enabled");
+        if (!isSearchEnabled()) {
+            System.out.println("Skipping test - Search not enabled");
             return;
         }
 
@@ -225,8 +225,8 @@ void testSearchMoviesByPlot_WithPagination() {
 
     // ==================== HELPER METHODS ====================
 
-    private boolean isAtlasSearchEnabled() {
-        String enabled = System.getenv("ENABLE_ATLAS_SEARCH_TESTS");
+    private boolean isSearchEnabled() {
+        String enabled = System.getenv("ENABLE_SEARCH_TESTS");
         return "true".equalsIgnoreCase(enabled);
     }
 
@@ -262,7 +262,7 @@ private void createTestMovies() {
     }
 
     private void createSearchIndex() throws Exception {
-        System.out.println("Creating Atlas Search index...");
+        System.out.println("Creating Search index...");
 
         MongoCollection<Document> collection = mongoTemplate.getCollection("movies");
 
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
index d57ed7e..f2083be 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
@@ -19,7 +19,7 @@ These tests require:
 - **MongoDB Atlas cluster** (not local MongoDB or Testcontainers)
 - **Atlas Search capability** enabled on the cluster
 - **MONGODB_URI** environment variable pointing to your Atlas cluster
-- **ENABLE_ATLAS_SEARCH_TESTS=true** environment variable to enable the tests
+- **ENABLE_SEARCH_TESTS=true** environment variable to enable the tests
 
 ## Running the Tests
 
@@ -28,7 +28,7 @@ These tests require:
 By default, these tests are **disabled** to prevent accidental runs against production databases. To enable them:
 
 ```bash
-export ENABLE_ATLAS_SEARCH_TESTS=true
+export ENABLE_SEARCH_TESTS=true
 ```
 
 ### Set MongoDB URI
@@ -103,10 +103,10 @@ Verifies that the `skip` parameter works for pagination and returns different re
 
 ### Tests are Skipped
 
-If you see "Skipping Atlas Search tests - ENABLE_ATLAS_SEARCH_TESTS not set", make sure you've set the environment variable:
+If you see "Skipping Search tests - ENABLE_SEARCH_TESTS not set", make sure you've set the environment variable:
 
 ```bash
-export ENABLE_ATLAS_SEARCH_TESTS=true
+export ENABLE_SEARCH_TESTS=true
 ```
 
 ### Index Creation Timeout
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
index 4af804c..c6e8561 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
@@ -433,7 +433,7 @@ void testFindAndDeleteMovie_NotFound() {
 
     @Test
     @DisplayName("Should get movies with most comments")
-    void testGetMoviesWithMostComments_Success() {
+    void testGetMoviesWithMostRecentComments_Success() {
         // Arrange
         Integer limit = 10;
         String movieId = null;
@@ -464,7 +464,7 @@ void testGetMoviesWithMostComments_Success() {
                 .thenReturn(mockResults);
 
         // Act
-        List<MovieWithCommentsResult> results = movieService.getMoviesWithMostComments(limit, movieId);
+        List<MovieWithCommentsResult> results = movieService.getMoviesWithMostRecentComments(limit, movieId);
 
         // Assert
         assertNotNull(results);
@@ -479,7 +479,7 @@ void testGetMoviesWithMostComments_Success() {
 
     @Test
     @DisplayName("Should get movies with most comments filtered by movie ID")
-    void testGetMoviesWithMostComments_WithMovieId() {
+    void testGetMoviesWithMostComments_WithMovieIdRecent() {
         // Arrange
         Integer limit = 10;
         String movieId = testId.toHexString();
@@ -491,7 +491,7 @@ void testGetMoviesWithMostComments_WithMovieId() {
                 .thenReturn(mockResults);
 
         // Act
-        List<MovieWithCommentsResult> results = movieService.getMoviesWithMostComments(limit, movieId);
+        List<MovieWithCommentsResult> results = movieService.getMoviesWithMostRecentComments(limit, movieId);
 
         // Assert
         assertNotNull(results);
@@ -500,14 +500,14 @@ void testGetMoviesWithMostComments_WithMovieId() {
 
     @Test
     @DisplayName("Should throw ValidationException for invalid movie ID in getMoviesWithMostComments")
-    void testGetMoviesWithMostComments_InvalidMovieId() {
+    void testGetMoviesWithMostRecentComments_InvalidMovieId() {
         // Arrange
         Integer limit = 10;
         String invalidMovieId = "invalid-id";
 
         // Act & Assert
         assertThrows(ValidationException.class,
-                () -> movieService.getMoviesWithMostComments(limit, invalidMovieId));
+                () -> movieService.getMoviesWithMostRecentComments(limit, invalidMovieId));
         verify(mongoTemplate, never()).aggregate(any(Aggregation.class), anyString(), any());
     }
 

From 3879ae314125a1f049fd94b826fd2520d447eddc Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Mon, 3 Nov 2025 17:17:59 -0500
Subject: [PATCH 043/110] fix: use validated limit from the request parameter
 for the comments endpoint

---
 .../mongodb/samplemflix/service/MovieServiceImpl.java    | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index a157d4f..4e6b670 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -347,10 +347,9 @@ public List<MovieWithCommentsResult> getMoviesWithMostRecentComments(Integer lim
             matchCriteria = matchCriteria.and(Movie.Fields.ID).is(new ObjectId(movieId));
         }
 
-        // Determine final result limit based on query type
-        // When querying a specific movie, allow more results (50)
-        // When querying all movies, use a smaller limit (20) to reduce server load
-        int finalLimit = (movieId != null && !movieId.trim().isEmpty()) ? 50 : 20;
+        // Use the validated limit from the request parameter
+        // The limit has already been validated and clamped to 1-50 range
+        int finalLimit = resultLimit;
 
         // Build aggregation pipeline
         // This demonstrates $lookup (join), $addFields, $sort, and $project operations
@@ -389,7 +388,7 @@ public List<MovieWithCommentsResult> getMoviesWithMostRecentComments(Integer lim
 
                 // STAGE 6: Limit results
                 // Apply limit AFTER sorting to get the correct top N movies by recent comment activity
-                // Limit is conditional: 50 for single movie queries, 20 for all movies
+                // Uses the limit from the request parameter (default: 10, max: 50)
                 Aggregation.limit(finalLimit),
 
                 // STAGE 7: Project final output with recent comments slice

From 14340a102dbf0ea2da36100cb9e1be62310b6fc2 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Mon, 3 Nov 2025 18:06:04 -0500
Subject: [PATCH 044/110] feat(java): add vector search

---
 server/java-spring/pom.xml                    |   8 ++
 .../config/DatabaseVerification.java          |  57 ++++++++
 .../controller/MovieControllerImpl.java       |  27 ++++
 .../model/dto/VectorSearchResult.java         |  40 ++++++
 .../samplemflix/service/MovieService.java     |  18 +++
 .../samplemflix/service/MovieServiceImpl.java | 124 ++++++++++++++++++
 .../src/main/resources/application.properties |   4 +
 7 files changed, 278 insertions(+)
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/VectorSearchResult.java

diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index a4e5d8a..d1a45d3 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -25,6 +25,7 @@
         <commons.lang3.version>3.19.0</commons.lang3.version>
         <impsort.plugin.version>1.12.0</impsort.plugin.version>
         <byte-buddy.version>1.17.8</byte-buddy.version>
+        <langchain4j.version>1.0.0-beta3</langchain4j.version>
     </properties>
 
     <dependencies>
@@ -92,6 +93,13 @@
             <groupId>com.fasterxml.jackson.core</groupId>
             <artifactId>jackson-databind</artifactId>
         </dependency>
+
+        <!-- LangChain4j Voyage AI for vector embeddings -->
+        <dependency>
+            <groupId>dev.langchain4j</groupId>
+            <artifactId>langchain4j-voyage-ai</artifactId>
+            <version>${langchain4j.version}</version>
+        </dependency>
     </dependencies>
     
     <build>
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
index ea5d950..c9442d2 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -22,6 +22,8 @@
  * 2. Verify the collection contains documents
  * 3. Check for text search indexes on plot, title, and fullplot fields
  * 4. Create text search index if missing
+ * 5. Verify embedded_movies collection for vector search
+ * 6. Create vector search index if missing
  * <p>
  * This matches the behavior of the Express.js backend's verifyRequirements() function.
  * The verification is non-blocking - the application will start even if verification fails,
@@ -34,9 +36,11 @@ public class DatabaseVerification {
 
     private static final String MOVIES_COLLECTION = "movies";
     private static final String COMMENTS_COLLECTION = "comments";
+    private static final String EMBEDDED_MOVIES_COLLECTION = "embedded_movies";
     private static final String TEXT_INDEX_NAME = "text_search_index";
     private static final String YEAR_INDEX_NAME = "year_index";
     private static final String MOVIE_ID_INDEX_NAME = "movie_id_index";
+    private static final String VECTOR_INDEX_NAME = "vector_index";
 
     private final MongoDatabase database;
 
@@ -64,6 +68,9 @@ public void verifyDatabase() {
             // Verify comments collection and create indexes for aggregation performance
             verifyCommentsCollection();
 
+            // Verify embedded_movies collection and create vector search index
+            verifyEmbeddedMoviesCollection();
+
             logger.info("Database verification completed successfully");
 
         } catch (Exception e) {
@@ -234,4 +241,54 @@ private void createMovieIdIndex(MongoCollection<Document> commentsCollection) {
             logger.warn("$lookup aggregations joining movies with comments may timeout without the index");
         }
     }
+
+    /**
+     * Verifies the embedded_movies collection and creates the vector search index.
+     *
+     * <p>The embedded_movies collection contains movie documents with plot embeddings
+     * generated by the Voyage AI model. This method checks if the collection exists
+     * and creates a vector search index for semantic similarity search.
+     *
+     * <p>Note: Vector search indexes can only be created through the Atlas UI or API,
+     * not through the MongoDB driver. This method logs instructions for manual creation.
+     */
+    private void verifyEmbeddedMoviesCollection() {
+        MongoCollection<Document> embeddedMoviesCollection = database.getCollection(EMBEDDED_MOVIES_COLLECTION);
+
+        // Check if collection has documents
+        long count = embeddedMoviesCollection.estimatedDocumentCount();
+
+        if (count == 0) {
+            logger.warn(
+                "Embedded movies collection is empty. Vector search functionality will not work. " +
+                "Please ensure the embedded_movies collection is populated with plot embeddings."
+            );
+            return;
+        }
+
+        logger.info("Embedded movies collection found with {} documents", count);
+
+        // Check if documents have the required embedding field
+        Document sampleDoc = embeddedMoviesCollection.find().first();
+        if (sampleDoc != null && !sampleDoc.containsKey("plot_embedding_voyage_3_large")) {
+            logger.warn(
+                "Documents in embedded_movies collection do not have 'plot_embedding_voyage_3_large' field. " +
+                "Vector search functionality will not work."
+            );
+            return;
+        }
+
+        // Log instructions for creating vector search index
+        // Note: Vector search indexes must be created through Atlas UI or API
+        logger.info(
+            "To enable vector search, create a vector search index named '{}' on the '{}' collection " +
+            "with the following specification:\n" +
+            "  - Field: plot_embedding_voyage_3_large\n" +
+            "  - Dimensions: 2048\n" +
+            "  - Similarity: cosine\n" +
+            "Visit: https://www.mongodb.com/docs/atlas/atlas-vector-search/create-index/",
+            VECTOR_INDEX_NAME,
+            EMBEDDED_MOVIES_COLLECTION
+        );
+    }
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index 2cac95c..223be3c 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -10,6 +10,7 @@
 import com.mongodb.samplemflix.model.dto.MovieWithCommentsResult;
 import com.mongodb.samplemflix.model.dto.MoviesByYearResult;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
+import com.mongodb.samplemflix.model.dto.VectorSearchResult;
 import com.mongodb.samplemflix.model.response.SuccessResponse;
 import com.mongodb.samplemflix.service.MovieService;
 import io.swagger.v3.oas.annotations.Operation;
@@ -42,6 +43,7 @@
  * - GET /api/movies/aggregations/years - Aggregate movies by year with statistics
  * - GET /api/movies/aggregations/directors - Aggregate directors with most movies
  * - GET /api/movies/search - Text search using MongoDB Search Index across multiple fields (plot, fullplot, directors, writers, cast)
+ * - GET /api/movies/vector-search - Vector search using Voyage AI embeddings to find movies with similar plots
  * - GET /api/movies/find-similar-movies - Vector search to find similar movies based on plot embeddings
  * </pre>
  */
@@ -413,6 +415,31 @@ public ResponseEntity<SuccessResponse<List<Movie>>> searchMovies(
         return ResponseEntity.ok(response);
     }
 
+    @Operation(
+        summary = "Search movies using vector search with Voyage AI embeddings",
+        description = "Search movies using MongoDB Vector Search to find movies with similar plots. " +
+                     "Uses embeddings generated by the Voyage AI model to perform semantic similarity search. " +
+                     "This endpoint generates an embedding for the search query and finds movies with similar plot embeddings."
+    )
+    @GetMapping("/vector-search")
+    public ResponseEntity<SuccessResponse<List<VectorSearchResult>>> vectorSearchMovies(
+            @Parameter(description = "Search query text to find movies with similar plots", required = true)
+            @RequestParam String q,
+            @Parameter(description = "Maximum number of results to return (default: 10, max: 50)")
+            @RequestParam(defaultValue = "10") Integer limit) {
+
+        List<VectorSearchResult> results = movieService.vectorSearchMovies(q, limit);
+
+        SuccessResponse<List<VectorSearchResult>> response = SuccessResponse.<List<VectorSearchResult>>builder()
+                .success(true)
+                .message(String.format("Found %d similar movies for query: '%s'", results.size(), q))
+                .data(results)
+                .timestamp(Instant.now().toString())
+                .build();
+
+        return ResponseEntity.ok(response);
+    }
+
     @Operation(
         summary = "Find similar movies using vector search",
         description = "Find similar movies using MongoDB Vector Search on plot embeddings. " +
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/VectorSearchResult.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/VectorSearchResult.java
new file mode 100644
index 0000000..edcdf45
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/VectorSearchResult.java
@@ -0,0 +1,40 @@
+package com.mongodb.samplemflix.model.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Data Transfer Object for vector search results.
+ *
+ * <p>This DTO represents the result of a MongoDB Vector Search query,
+ * containing the movie information and similarity score.
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class VectorSearchResult {
+    
+    /**
+     * Movie ObjectId as a string.
+     */
+    private String id;
+    
+    /**
+     * Movie title.
+     */
+    private String title;
+    
+    /**
+     * Movie plot summary.
+     */
+    private String plot;
+    
+    /**
+     * Vector search similarity score (0.0 to 1.0, higher = more similar).
+     */
+    private Double score;
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
index bded6df..159bf54 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
@@ -10,6 +10,7 @@
 import com.mongodb.samplemflix.model.dto.MovieWithCommentsResult;
 import com.mongodb.samplemflix.model.dto.MoviesByYearResult;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
+import com.mongodb.samplemflix.model.dto.VectorSearchResult;
 import java.util.List;
 import org.bson.Document;
 
@@ -91,4 +92,21 @@ public interface MovieService {
      * @return List of similar movies based on plot embeddings
      */
     List<Movie> findSimilarMovies(String movieId, Integer limit);
+
+    /**
+     * Searches movies using MongoDB Vector Search to find movies with similar plots.
+     * Uses embeddings generated by the Voyage AI model to perform semantic similarity search.
+     *
+     * <p>This method:
+     * <ul>
+     * <li>Generates an embedding for the search query using Voyage AI</li>
+     * <li>Performs vector search on the embedded_movies collection</li>
+     * <li>Returns movies with similarity scores</li>
+     * </ul>
+     *
+     * @param query Search query text to find movies with similar plots
+     * @param limit Maximum number of results to return (default: 10, max: 50)
+     * @return List of vector search results with movie information and similarity scores
+     */
+    List<VectorSearchResult> vectorSearchMovies(String query, Integer limit);
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 4e6b670..2db3ef7 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -1,5 +1,6 @@
 package com.mongodb.samplemflix.service;
 
+import com.fasterxml.jackson.databind.JsonNode;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.mongodb.client.result.DeleteResult;
 import com.mongodb.client.result.UpdateResult;
@@ -9,6 +10,12 @@
 import com.mongodb.samplemflix.model.Movie;
 import com.mongodb.samplemflix.model.dto.*;
 import com.mongodb.samplemflix.repository.MovieRepository;
+import java.io.IOException;
+import java.net.URI;
+import java.net.http.HttpClient;
+import java.net.http.HttpRequest;
+import java.net.http.HttpResponse;
+import java.util.ArrayList;
 import java.util.Collection;
 import java.util.List;
 import java.util.Map;
@@ -17,6 +24,7 @@
 import org.bson.BsonValue;
 import org.bson.Document;
 import org.bson.types.ObjectId;
+import org.springframework.beans.factory.annotation.Value;
 import org.springframework.data.domain.Sort;
 import org.springframework.data.mongodb.core.MongoTemplate;
 import org.springframework.data.mongodb.core.aggregation.Aggregation;
@@ -52,6 +60,9 @@ public class MovieServiceImpl implements MovieService {
     private final MongoTemplate mongoTemplate;
     private final ObjectMapper objectMapper;
 
+    @Value("${voyage.api.key:#{null}}")
+    private String voyageApiKey;
+
     public MovieServiceImpl(MovieRepository movieRepository, MongoTemplate mongoTemplate, ObjectMapper objectMapper) {
         this.movieRepository = movieRepository;
         this.mongoTemplate = mongoTemplate;
@@ -789,4 +800,117 @@ public List<Movie> findSimilarMovies(String movieId, Integer limit) {
             throw new DatabaseOperationException("Error performing vector search: " + e.getMessage());
         }
     }
+
+    @Override
+    public List<VectorSearchResult> vectorSearchMovies(String query, Integer limit) {
+        // Validate query parameter
+        if (query == null || query.trim().isEmpty()) {
+            throw new ValidationException("Search query is required");
+        }
+
+        // Check if Voyage API key is configured
+        if (voyageApiKey == null || voyageApiKey.trim().isEmpty()) {
+            throw new ValidationException(
+                "Vector search unavailable: VOYAGE_API_KEY not configured. Please add your API key to application.properties"
+            );
+        }
+
+        // Validate and set default limit
+        int resultLimit = Math.clamp(limit != null ? limit : 10, 1, 50);
+
+        try {
+            // Generate embedding using Voyage AI REST API
+            // We use the REST API directly to specify output_dimension=2048
+            List<Double> queryVector = generateVoyageEmbedding(query, voyageApiKey);
+
+            // Build the $vectorSearch aggregation stage
+            Document vectorSearchStage = new Document("$vectorSearch", new Document()
+                    .append("index", "vector_index")
+                    .append("path", "plot_embedding_voyage_3_large")
+                    .append("queryVector", queryVector)
+                    .append("numCandidates", resultLimit * 15)  // Search more candidates for better results
+                    .append("limit", resultLimit)
+            );
+
+            // Project the fields we need in the response
+            Document projectStage = new Document("$project", new Document()
+                    .append("_id", 1)
+                    .append("title", 1)
+                    .append("plot", 1)
+                    .append("score", new Document("$meta", "vectorSearchScore"))
+            );
+
+            // Execute the aggregation pipeline on the embedded_movies collection
+            List<Document> aggregationPipeline = List.of(vectorSearchStage, projectStage);
+
+            List<VectorSearchResult> results = new ArrayList<>();
+            mongoTemplate.getCollection("embedded_movies")
+                    .aggregate(aggregationPipeline)
+                    .forEach(doc -> {
+                        VectorSearchResult result = VectorSearchResult.builder()
+                                .id(doc.getObjectId("_id").toString())
+                                .title(doc.getString("title"))
+                                .plot(doc.getString("plot"))
+                                .score(doc.getDouble("score"))
+                                .build();
+                        results.add(result);
+                    });
+
+            return results;
+
+        } catch (Exception e) {
+            throw new DatabaseOperationException("Error performing vector search: " + e.getMessage());
+        }
+    }
+
+    /**
+     * Generates a vector embedding using the Voyage AI REST API.
+     *
+     * <p>This method calls the Voyage AI API directly to generate embeddings with
+     * the specified output dimension (2048) to match the collection's embeddings.
+     *
+     * @param text The text to generate an embedding for
+     * @param apiKey The Voyage AI API key
+     * @return List of doubles representing the embedding vector
+     * @throws IOException If there's an error calling the API
+     * @throws InterruptedException If the HTTP request is interrupted
+     */
+    private List<Double> generateVoyageEmbedding(String text, String apiKey)
+            throws IOException, InterruptedException {
+        HttpClient client = HttpClient.newHttpClient();
+
+        // Build the request body
+        String requestBody = String.format(
+            "{\"input\":[\"%s\"],\"model\":\"voyage-3-large\",\"output_dimension\":2048,\"input_type\":\"query\"}",
+            text.replace("\"", "\\\"")
+        );
+
+        // Create the HTTP request
+        HttpRequest request = HttpRequest.newBuilder()
+                .uri(URI.create("https://api.voyageai.com/v1/embeddings"))
+                .header("Content-Type", "application/json")
+                .header("Authorization", "Bearer " + apiKey)
+                .POST(HttpRequest.BodyPublishers.ofString(requestBody))
+                .build();
+
+        // Send the request and get the response
+        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
+
+        if (response.statusCode() != 200) {
+            throw new DatabaseOperationException(
+                "Voyage AI API error: " + response.statusCode() + " - " + response.body()
+            );
+        }
+
+        // Parse the response to extract the embedding
+        JsonNode jsonResponse = objectMapper.readTree(response.body());
+        JsonNode embeddingNode = jsonResponse.get("data").get(0).get("embedding");
+
+        List<Double> embedding = new ArrayList<>();
+        for (JsonNode value : embeddingNode) {
+            embedding.add(value.asDouble());
+        }
+
+        return embedding;
+    }
 }
diff --git a/server/java-spring/src/main/resources/application.properties b/server/java-spring/src/main/resources/application.properties
index 57c86f9..d226e25 100644
--- a/server/java-spring/src/main/resources/application.properties
+++ b/server/java-spring/src/main/resources/application.properties
@@ -11,6 +11,10 @@ server.port=${PORT:3001}
 # Allowed origins for cross-origin requests (typically the frontend URL)
 cors.allowed.origins=${CORS_ORIGIN:http://localhost:3000}
 
+# Voyage AI Configuration
+# API key for Voyage AI embedding model (required for vector search)
+voyage.api.key=${VOYAGE_API_KEY:}
+
 # Application Info
 spring.application.name=sample-app-java-mflix
 

From f820a052fe479894eff1cd25411617c1f472af0a Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 4 Nov 2025 09:06:37 -0500
Subject: [PATCH 045/110] Add unit tests

---
 .../controller/MovieControllerTest.java       | 276 ++++++++++++++++++
 .../samplemflix/service/MovieServiceTest.java | 182 ++++++++++++
 2 files changed, 458 insertions(+)

diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
index 9239042..2ee4b3a 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
@@ -12,6 +12,7 @@
 import com.mongodb.samplemflix.exception.ValidationException;
 import com.mongodb.samplemflix.model.Movie;
 import com.mongodb.samplemflix.model.dto.BatchInsertResponse;
+import com.mongodb.samplemflix.model.dto.BatchUpdateResponse;
 import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
 import com.mongodb.samplemflix.model.dto.DeleteResponse;
 import com.mongodb.samplemflix.model.dto.DirectorStatisticsResult;
@@ -19,6 +20,7 @@
 import com.mongodb.samplemflix.model.dto.MovieWithCommentsResult;
 import com.mongodb.samplemflix.model.dto.MoviesByYearResult;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
+import com.mongodb.samplemflix.model.dto.VectorSearchResult;
 import com.mongodb.samplemflix.service.MovieService;
 import java.util.Arrays;
 import java.util.Date;
@@ -26,6 +28,7 @@
 import java.util.List;
 import java.util.Map;
 import org.bson.BsonObjectId;
+import org.bson.Document;
 import org.bson.types.ObjectId;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.DisplayName;
@@ -660,4 +663,277 @@ void testSearchMovies_InvalidSearchOperator() throws Exception {
                 .andExpect(jsonPath("$.success").value(false))
                 .andExpect(jsonPath("$.error.code").value("VALIDATION_ERROR"));
     }
+
+    // ==================== VECTOR SEARCH ENDPOINT TESTS ====================
+
+    @Test
+    @DisplayName("GET /api/movies/vector-search - Should perform vector search successfully")
+    void testVectorSearchMovies_Success() throws Exception {
+        // Arrange
+        VectorSearchResult result1 = VectorSearchResult.builder()
+                .id(testId.toHexString())
+                .title("Space Raiders")
+                .plot("A futuristic space adventure")
+                .score(0.85)
+                .build();
+
+        VectorSearchResult result2 = VectorSearchResult.builder()
+                .id(new ObjectId().toHexString())
+                .title("Galaxy Quest")
+                .plot("An epic space journey")
+                .score(0.78)
+                .build();
+
+        when(movieService.vectorSearchMovies(eq("space adventure"), eq(3)))
+                .thenReturn(Arrays.asList(result1, result2));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/vector-search")
+                        .param("q", "space adventure")
+                        .param("limit", "3"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray())
+                .andExpect(jsonPath("$.data", hasSize(2)))
+                .andExpect(jsonPath("$.data[0].title").value("Space Raiders"))
+                .andExpect(jsonPath("$.data[0].plot").value("A futuristic space adventure"))
+                .andExpect(jsonPath("$.data[0].score").value(0.85))
+                .andExpect(jsonPath("$.data[1].title").value("Galaxy Quest"))
+                .andExpect(jsonPath("$.data[1].score").value(0.78));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/vector-search - Should use default limit")
+    void testVectorSearchMovies_DefaultLimit() throws Exception {
+        // Arrange
+        when(movieService.vectorSearchMovies(eq("adventure"), eq(10)))
+                .thenReturn(Arrays.asList());
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/vector-search")
+                        .param("q", "adventure"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray());
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/vector-search - Should return 400 when query is missing")
+    void testVectorSearchMovies_MissingQuery() throws Exception {
+        // Arrange
+        when(movieService.vectorSearchMovies(isNull(), anyInt()))
+                .thenThrow(new ValidationException("Search query is required"));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/vector-search"))
+                .andExpect(status().isBadRequest())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("VALIDATION_ERROR"));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/vector-search - Should return 400 when API key is missing")
+    void testVectorSearchMovies_MissingApiKey() throws Exception {
+        // Arrange
+        when(movieService.vectorSearchMovies(eq("test"), anyInt()))
+                .thenThrow(new ValidationException("Vector search unavailable: VOYAGE_API_KEY not configured"));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/vector-search")
+                        .param("q", "test"))
+                .andExpect(status().isBadRequest())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("VALIDATION_ERROR"))
+                .andExpect(jsonPath("$.error.message").value(containsString("VOYAGE_API_KEY")));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/vector-search - Should return empty list when no results")
+    void testVectorSearchMovies_NoResults() throws Exception {
+        // Arrange
+        when(movieService.vectorSearchMovies(eq("nonexistent"), anyInt()))
+                .thenReturn(Arrays.asList());
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/vector-search")
+                        .param("q", "nonexistent"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray())
+                .andExpect(jsonPath("$.data", hasSize(0)));
+    }
+
+    // ==================== FIND SIMILAR MOVIES ENDPOINT TESTS ====================
+
+    @Test
+    @DisplayName("GET /api/movies/find-similar-movies - Should find similar movies successfully")
+    void testFindSimilarMovies_Success() throws Exception {
+        // Arrange
+        String movieId = testId.toHexString();
+
+        Movie similarMovie1 = Movie.builder()
+                .id(new ObjectId())
+                .title("Similar Movie 1")
+                .year(2024)
+                .plot("A similar plot")
+                .build();
+
+        Movie similarMovie2 = Movie.builder()
+                .id(new ObjectId())
+                .title("Similar Movie 2")
+                .year(2023)
+                .plot("Another similar plot")
+                .build();
+
+        when(movieService.findSimilarMovies(eq(movieId), eq(5)))
+                .thenReturn(Arrays.asList(similarMovie1, similarMovie2));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/find-similar-movies")
+                        .param("movieId", movieId)
+                        .param("limit", "5"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray())
+                .andExpect(jsonPath("$.data", hasSize(2)))
+                .andExpect(jsonPath("$.data[0].title").value("Similar Movie 1"))
+                .andExpect(jsonPath("$.data[1].title").value("Similar Movie 2"));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/find-similar-movies - Should use default limit")
+    void testFindSimilarMovies_DefaultLimit() throws Exception {
+        // Arrange
+        String movieId = testId.toHexString();
+        when(movieService.findSimilarMovies(eq(movieId), eq(10)))
+                .thenReturn(Arrays.asList());
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/find-similar-movies")
+                        .param("movieId", movieId))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data").isArray());
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/find-similar-movies - Should return 400 for invalid movie ID")
+    void testFindSimilarMovies_InvalidId() throws Exception {
+        // Arrange
+        String invalidId = "invalid-id";
+        when(movieService.findSimilarMovies(eq(invalidId), anyInt()))
+                .thenThrow(new ValidationException("Invalid movie ID format"));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/find-similar-movies")
+                        .param("movieId", invalidId))
+                .andExpect(status().isBadRequest())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("VALIDATION_ERROR"));
+    }
+
+    @Test
+    @DisplayName("GET /api/movies/find-similar-movies - Should return 404 when movie not found")
+    void testFindSimilarMovies_MovieNotFound() throws Exception {
+        // Arrange
+        String movieId = testId.toHexString();
+        when(movieService.findSimilarMovies(eq(movieId), anyInt()))
+                .thenThrow(new ResourceNotFoundException("Movie not found"));
+
+        // Act & Assert
+        mockMvc.perform(get("/api/movies/find-similar-movies")
+                        .param("movieId", movieId))
+                .andExpect(status().isNotFound())
+                .andExpect(jsonPath("$.success").value(false))
+                .andExpect(jsonPath("$.error.code").value("RESOURCE_NOT_FOUND"));
+    }
+
+    // ==================== BATCH UPDATE ENDPOINT TESTS ====================
+
+    @Test
+    @DisplayName("PATCH /api/movies/batch - Should update movies batch successfully")
+    void testUpdateMoviesBatch_Success() throws Exception {
+        // Arrange
+        Map<String, Object> requestBody = new HashMap<>();
+        requestBody.put("filter", Map.of("year", 2024));
+        requestBody.put("update", Map.of("$set", Map.of("rating", "PG-13")));
+
+        BatchUpdateResponse response = new BatchUpdateResponse(5L, 5L);
+        when(movieService.updateMoviesBatch(any(Document.class), any(Document.class)))
+                .thenReturn(response);
+
+        // Act & Assert
+        mockMvc.perform(patch("/api/movies")
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content(objectMapper.writeValueAsString(requestBody)))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data.matchedCount").value(5))
+                .andExpect(jsonPath("$.data.modifiedCount").value(5));
+    }
+
+    @Test
+    @DisplayName("PATCH /api/movies - Should handle empty filter")
+    void testUpdateMoviesBatch_EmptyFilter() throws Exception {
+        // Arrange
+        BatchUpdateResponse updateResponse = new BatchUpdateResponse(0L, 0L);
+
+        when(movieService.updateMoviesBatch(any(Document.class), any(Document.class)))
+                .thenReturn(updateResponse);
+
+        Map<String, Object> requestBody = new HashMap<>();
+        requestBody.put("filter", Map.of());
+        requestBody.put("update", Map.of("$set", Map.of("rating", "PG-13")));
+
+        // Act & Assert
+        mockMvc.perform(patch("/api/movies")
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content(objectMapper.writeValueAsString(requestBody)))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data.matchedCount").value(0))
+                .andExpect(jsonPath("$.data.modifiedCount").value(0));
+    }
+
+    // ==================== BATCH DELETE ENDPOINT TESTS ====================
+
+    @Test
+    @DisplayName("DELETE /api/movies/batch - Should delete movies batch successfully")
+    void testDeleteMoviesBatch_Success() throws Exception {
+        // Arrange
+        Map<String, Object> requestBody = Map.of("filter", Map.of("year", Map.of("$lt", 1950)));
+
+        DeleteResponse response = new DeleteResponse(10L);
+        when(movieService.deleteMoviesBatch(any(Document.class)))
+                .thenReturn(response);
+
+        // Act & Assert
+        mockMvc.perform(delete("/api/movies")
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content(objectMapper.writeValueAsString(requestBody)))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data.deletedCount").value(10));
+    }
+
+    @Test
+    @DisplayName("DELETE /api/movies - Should handle empty filter")
+    void testDeleteMoviesBatch_EmptyFilter() throws Exception {
+        // Arrange
+        DeleteResponse deleteResponse = new DeleteResponse(0L);
+
+        when(movieService.deleteMoviesBatch(any(Document.class)))
+                .thenReturn(deleteResponse);
+
+        Map<String, Object> requestBody = new HashMap<>();
+        requestBody.put("filter", Map.of());
+
+        // Act & Assert
+        mockMvc.perform(delete("/api/movies")
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content(objectMapper.writeValueAsString(requestBody)))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data.deletedCount").value(0));
+    }
 }
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
index c6e8561..4371dbf 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
@@ -5,15 +5,18 @@
 import static org.mockito.Mockito.*;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
+import com.mongodb.client.MongoCollection;
 import com.mongodb.client.result.UpdateResult;
 import com.mongodb.samplemflix.exception.ResourceNotFoundException;
 import com.mongodb.samplemflix.exception.ValidationException;
 import com.mongodb.samplemflix.model.Movie;
 import com.mongodb.samplemflix.model.dto.BatchInsertResponse;
+import com.mongodb.samplemflix.model.dto.BatchUpdateResponse;
 import com.mongodb.samplemflix.model.dto.CreateMovieRequest;
 import com.mongodb.samplemflix.model.dto.DeleteResponse;
 import com.mongodb.samplemflix.model.dto.DirectorStatisticsResult;
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
+import com.mongodb.samplemflix.model.dto.MovieSearchRequest;
 import com.mongodb.samplemflix.model.dto.MovieWithCommentsResult;
 import com.mongodb.samplemflix.model.dto.MoviesByYearResult;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
@@ -32,6 +35,7 @@
 import org.springframework.data.mongodb.core.aggregation.Aggregation;
 import org.springframework.data.mongodb.core.aggregation.AggregationResults;
 import org.springframework.data.mongodb.core.query.Query;
+import org.springframework.test.util.ReflectionTestUtils;
 
 /**
  * Unit tests for MovieServiceImpl using Spring Data MongoDB.
@@ -608,4 +612,182 @@ void testGetDirectorsWithMostMovies_DefaultLimit() {
         assertNotNull(results);
         verify(mongoTemplate).aggregate(any(Aggregation.class), eq("movies"), eq(DirectorStatisticsResult.class));
     }
+
+    // ==================== BATCH UPDATE TESTS ====================
+
+    @Test
+    @DisplayName("Should update movies batch successfully")
+    void testUpdateMoviesBatch_Success() {
+        // Arrange
+        Document filter = new Document("year", 2024);
+        Document update = new Document("$set", new Document("rating", "PG-13"));
+
+        UpdateResult updateResult = mock(UpdateResult.class);
+        when(updateResult.getMatchedCount()).thenReturn(5L);
+        when(updateResult.getModifiedCount()).thenReturn(5L);
+        when(mongoTemplate.updateMulti(any(Query.class), any(org.springframework.data.mongodb.core.query.Update.class), (Class<Movie>) eq(Movie.class)))
+                .thenReturn(updateResult);
+
+        // Act
+        BatchUpdateResponse result = movieService.updateMoviesBatch(filter, update);
+
+        // Assert
+        assertNotNull(result);
+        assertEquals(5L, result.getMatchedCount());
+        assertEquals(5L, result.getModifiedCount());
+        verify(mongoTemplate).updateMulti(any(Query.class), any(org.springframework.data.mongodb.core.query.Update.class), eq(Movie.class));
+    }
+
+    @Test
+    @DisplayName("Should throw ValidationException when filter is null in batch update")
+    void testUpdateMoviesBatch_NullFilter() {
+        // Arrange
+        Document update = new Document("$set", new Document("rating", "PG-13"));
+
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.updateMoviesBatch(null, update));
+        verify(mongoTemplate, never()).updateMulti(any(Query.class), any(org.springframework.data.mongodb.core.query.Update.class), (Class<?>) any());
+    }
+
+    @Test
+    @DisplayName("Should throw ValidationException when update is null in batch update")
+    void testUpdateMoviesBatch_NullUpdate() {
+        // Arrange
+        Document filter = new Document("year", 2024);
+
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.updateMoviesBatch(filter, null));
+        verify(mongoTemplate, never()).updateMulti(any(Query.class), any(org.springframework.data.mongodb.core.query.Update.class), (Class<?>) any());
+    }
+
+    // ==================== BATCH DELETE TESTS ====================
+
+    @Test
+    @DisplayName("Should delete movies batch successfully")
+    void testDeleteMoviesBatch_Success() {
+        // Arrange
+        Document filter = new Document("year", new Document("$lt", 1950));
+
+        com.mongodb.client.result.DeleteResult deleteResult = mock(com.mongodb.client.result.DeleteResult.class);
+        when(deleteResult.getDeletedCount()).thenReturn(10L);
+        when(mongoTemplate.remove(any(Query.class), (Class<Movie>) eq(Movie.class)))
+                .thenReturn(deleteResult);
+
+        // Act
+        DeleteResponse result = movieService.deleteMoviesBatch(filter);
+
+        // Assert
+        assertNotNull(result);
+        assertEquals(10L, result.getDeletedCount());
+        verify(mongoTemplate).remove(any(Query.class), eq(Movie.class));
+    }
+
+    @Test
+    @DisplayName("Should throw ValidationException when filter is null in batch delete")
+    void testDeleteMoviesBatch_NullFilter() {
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.deleteMoviesBatch(null));
+        verify(mongoTemplate, never()).remove(any(Query.class), (Class<?>) any());
+    }
+
+    // ==================== TEXT SEARCH TESTS ====================
+
+    // Note: Search success tests are covered by integration tests due to complexity of mocking MongoDB aggregation
+
+    @Test
+    @DisplayName("Should throw ValidationException when all search fields are null")
+    void testSearchMovies_NoSearchFields() {
+        // Arrange
+        MovieSearchRequest searchRequest = MovieSearchRequest.builder()
+                .limit(10)
+                .build();
+
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.searchMovies(searchRequest));
+        verify(mongoTemplate, never()).find(any(), any());
+    }
+
+
+
+    // ==================== VECTOR SEARCH TESTS ====================
+
+    // Note: Vector search success tests are covered by integration tests due to complexity of mocking HTTP calls and MongoDB aggregation
+
+    @Test
+    @DisplayName("Should throw ValidationException when query is null in vector search")
+    void testVectorSearchMovies_NullQuery() {
+        // Arrange
+        String apiKey = "test-api-key";
+        ReflectionTestUtils.setField(movieService, "voyageApiKey", apiKey);
+
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.vectorSearchMovies(null, 10));
+    }
+
+    @Test
+    @DisplayName("Should throw ValidationException when query is empty in vector search")
+    void testVectorSearchMovies_EmptyQuery() {
+        // Arrange
+        String apiKey = "test-api-key";
+        ReflectionTestUtils.setField(movieService, "voyageApiKey", apiKey);
+
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.vectorSearchMovies("   ", 10));
+    }
+
+    @Test
+    @DisplayName("Should throw ValidationException when API key is missing in vector search")
+    void testVectorSearchMovies_MissingApiKey() {
+        // Arrange
+        ReflectionTestUtils.setField(movieService, "voyageApiKey", null);
+
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.vectorSearchMovies("test query", 10));
+    }
+
+    @Test
+    @DisplayName("Should enforce limit constraints in vector search")
+    void testVectorSearchMovies_LimitConstraints() {
+        // Arrange
+        String apiKey = "test-api-key";
+        ReflectionTestUtils.setField(movieService, "voyageApiKey", apiKey);
+
+        // The limit should be clamped between 1 and 50
+        // We can't easily test this without mocking the HTTP call
+        // This would be better as an integration test
+    }
+
+    // ==================== FIND SIMILAR MOVIES TESTS ====================
+    // Note: Find similar movies success tests are covered by integration tests due to complexity of mocking MongoDB aggregation
+
+    @Test
+    @DisplayName("Should throw ValidationException for invalid movie ID in find similar")
+    void testFindSimilarMovies_InvalidId() {
+        // Arrange
+        String invalidId = "invalid-id";
+
+        // Act & Assert
+        assertThrows(ValidationException.class, () -> movieService.findSimilarMovies(invalidId, 10));
+        verify(movieRepository, never()).findById(any());
+    }
+
+    @Test
+    @DisplayName("Should throw ResourceNotFoundException when source movie not found")
+    void testFindSimilarMovies_MovieNotFound() {
+        // Arrange
+        String movieId = testId.toHexString();
+
+        // Mock the movies collection to return null (movie not found)
+        @SuppressWarnings("unchecked")
+        MongoCollection<Document> mockMoviesCollection = mock(MongoCollection.class);
+        @SuppressWarnings("unchecked")
+        com.mongodb.client.FindIterable<Document> mockFindIterable = mock(com.mongodb.client.FindIterable.class);
+
+        when(mongoTemplate.getCollection("movies")).thenReturn(mockMoviesCollection);
+        when(mockMoviesCollection.find(any(Document.class))).thenReturn(mockFindIterable);
+        when(mockFindIterable.first()).thenReturn(null);
+
+        // Act & Assert
+        assertThrows(ResourceNotFoundException.class, () -> movieService.findSimilarMovies(movieId, 10));
+    }
 }

From ad95b2b3107c7594f4e0505ea9606551a27f8d8c Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 4 Nov 2025 10:39:33 -0500
Subject: [PATCH 046/110] update the vector search index creation

---
 .../config/DatabaseVerification.java          | 70 +++++++++++++++----
 1 file changed, 58 insertions(+), 12 deletions(-)

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
index c9442d2..1a13ccd 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -278,17 +278,63 @@ private void verifyEmbeddedMoviesCollection() {
             return;
         }
 
-        // Log instructions for creating vector search index
-        // Note: Vector search indexes must be created through Atlas UI or API
-        logger.info(
-            "To enable vector search, create a vector search index named '{}' on the '{}' collection " +
-            "with the following specification:\n" +
-            "  - Field: plot_embedding_voyage_3_large\n" +
-            "  - Dimensions: 2048\n" +
-            "  - Similarity: cosine\n" +
-            "Visit: https://www.mongodb.com/docs/atlas/atlas-vector-search/create-index/",
-            VECTOR_INDEX_NAME,
-            EMBEDDED_MOVIES_COLLECTION
-        );
+        // Create vector search index programmatically
+        createVectorSearchIndex(embeddedMoviesCollection);
+    }
+
+    /**
+     * Creates a vector search index on the embedded_movies collection if it doesn't already exist.
+     *
+     * <p>This method creates a vector search index named 'vector_index' for the
+     * plot_embedding_voyage_3_large field with 2048 dimensions and cosine similarity.
+     *
+     * @param embeddedMoviesCollection the embedded_movies collection to create the index on
+     */
+    private void createVectorSearchIndex(MongoCollection<Document> embeddedMoviesCollection) {
+        try {
+            // Check if the vector search index already exists
+            boolean indexExists = false;
+            for (Document index : embeddedMoviesCollection.listSearchIndexes()) {
+                if (VECTOR_INDEX_NAME.equals(index.getString("name"))) {
+                    indexExists = true;
+                    logger.info("Vector search index '{}' already exists", VECTOR_INDEX_NAME);
+                    break;
+                }
+            }
+
+            if (!indexExists) {
+                // Define the vector search index specification
+                Document vectorField = new Document()
+                        .append("type", "vector")
+                        .append("path", "plot_embedding_voyage_3_large")
+                        .append("numDimensions", 2048)
+                        .append("similarity", "cosine");
+
+                Document indexDefinition = new Document()
+                        .append("fields", java.util.Arrays.asList(vectorField));
+
+                Document searchIndexModel = new Document()
+                        .append("name", VECTOR_INDEX_NAME)
+                        .append("type", "vectorSearch")
+                        .append("definition", indexDefinition);
+
+                // Create the index using the createSearchIndex command
+                String indexName = embeddedMoviesCollection.createSearchIndex(searchIndexModel);
+
+                logger.info("Vector search index '{}' created successfully. Index may take a few moments to build.", indexName);
+                logger.info("Vector search is now ready to use on the '{}' collection", EMBEDDED_MOVIES_COLLECTION);
+            }
+
+        } catch (Exception e) {
+            logger.error("Failed to create vector search index: {}", e.getMessage());
+            logger.warn(
+                "To manually create the vector search index, visit the Atlas UI and create an index named '{}' with:\n" +
+                "  - Field: plot_embedding_voyage_3_large\n" +
+                "  - Dimensions: 2048\n" +
+                "  - Similarity: cosine\n" +
+                "Visit: https://www.mongodb.com/docs/atlas/atlas-vector-search/create-index/",
+                VECTOR_INDEX_NAME
+            );
+        }
     }
 }

From cfd0e8d67fe5cb3d07714faf00e4a8bc8522614b Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 4 Nov 2025 10:55:34 -0500
Subject: [PATCH 047/110] update comments in verification

---
 .../config/DatabaseVerification.java          | 23 ++++++++-----------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
index 1a13ccd..a4b9a9b 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -84,11 +84,11 @@ public void verifyDatabase() {
      * Verifies the movies collection exists, contains data, and has required indexes.
      *
      * <p>This method:
-     * <pre>
-     * 1. Checks if the movies collection exists (implicitly by accessing it)
-     * 2. Counts documents to verify sample data is loaded
-     * 3. Creates a text search index on plot, title, and fullplot fields
-     *</pre>
+* <ol>
+*   <li>Checks if the movies collection exists (implicitly by accessing it)</li>
+*   <li>Counts documents to verify sample data is loaded</li>
+*   <li>Creates a text search index on plot, title, and fullplot fields</li>
+* </ol>
      * <p>The text search index enables full-text search functionality across movie
      * descriptions and titles, which is used by the search endpoint.
      */
@@ -119,11 +119,11 @@ private void verifyMoviesCollection() {
      * Creates a text search index on the movies collection if it doesn't already exist.
      *
      * <p>The index is created on three fields:
-     * <pre>
-     * - plot: Short movie description
-     * - title: Movie title
-     * - fullplot: Full movie description
-     * </pre>
+* <ul>
+*   <li>plot: Short movie description</li>
+*   <li>title: Movie title</li>
+*   <li>fullplot: Full movie description</li>
+* </ul>
      * <p>This enables the $text search operator to perform full-text search across
      * these fields, which is used by the search endpoint in the API.
      *
@@ -248,9 +248,6 @@ private void createMovieIdIndex(MongoCollection<Document> commentsCollection) {
      * <p>The embedded_movies collection contains movie documents with plot embeddings
      * generated by the Voyage AI model. This method checks if the collection exists
      * and creates a vector search index for semantic similarity search.
-     *
-     * <p>Note: Vector search indexes can only be created through the Atlas UI or API,
-     * not through the MongoDB driver. This method logs instructions for manual creation.
      */
     private void verifyEmbeddedMoviesCollection() {
         MongoCollection<Document> embeddedMoviesCollection = database.getCollection(EMBEDDED_MOVIES_COLLECTION);

From 2d79bde680d010f27279e0e46faf73b225a2c66b Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Tue, 4 Nov 2025 12:10:09 -0500
Subject: [PATCH 048/110] feedback changes

---
 server/python/requirements.in       |  1 +
 server/python/requirements.txt      | 99 ++++++++++++++++++++++++++++-
 server/python/src/routers/movies.py |  1 +
 3 files changed, 98 insertions(+), 3 deletions(-)

diff --git a/server/python/requirements.in b/server/python/requirements.in
index 835786d..b6000a1 100644
--- a/server/python/requirements.in
+++ b/server/python/requirements.in
@@ -31,6 +31,7 @@ dnspython~=2.8.0        # Required for SRV record lookups by pymongo (e.g., Mong
 # ------------------------------------------------------------------------------
 httpx~=0.28.0           # Asynchronous HTTP client for requests to external APIs
 email-validator~=2.3.0  # Utility for validating email addresses
+voyageai~=0.3.5         # Vector embeddings API client
 
 # ==============================================================================
 # 5. CLI & DEVELOPMENT TOOLS
diff --git a/server/python/requirements.txt b/server/python/requirements.txt
index 504c289..682f33f 100644
--- a/server/python/requirements.txt
+++ b/server/python/requirements.txt
@@ -4,6 +4,14 @@
 #
 #    pip-compile requirements.in
 #
+aiohappyeyeballs==2.6.1
+    # via aiohttp
+aiohttp==3.13.2
+    # via voyageai
+aiolimiter==1.2.1
+    # via voyageai
+aiosignal==1.4.0
+    # via aiohttp
 annotated-doc==0.0.3
     # via fastapi
 annotated-types==0.7.0
@@ -13,15 +21,21 @@ anyio==4.11.0
     #   httpx
     #   starlette
     #   watchfiles
+attrs==25.4.0
+    # via aiohttp
 certifi==2025.10.5
     # via
     #   httpcore
     #   httpx
+    #   requests
     #   sentry-sdk
+charset-normalizer==3.4.4
+    # via requests
 click==8.3.0
     # via
     #   rich-toolkit
     #   typer
+    #   typer-slim
     #   uvicorn
 dnspython==2.8.0
     # via
@@ -38,10 +52,20 @@ fastapi-cli==0.0.14
     # via -r requirements.in
 fastapi-cloud-cli==0.3.1
     # via -r requirements.in
+filelock==3.20.0
+    # via huggingface-hub
+frozenlist==1.8.0
+    # via
+    #   aiohttp
+    #   aiosignal
+fsspec==2025.10.0
+    # via huggingface-hub
 h11==0.16.0
     # via
     #   httpcore
     #   uvicorn
+hf-xet==1.2.0
+    # via huggingface-hub
 httpcore==1.0.9
     # via httpx
 httptools==0.7.1
@@ -50,26 +74,63 @@ httpx==0.28.1
     # via
     #   -r requirements.in
     #   fastapi-cloud-cli
+    #   huggingface-hub
+    #   langsmith
+huggingface-hub==1.0.1
+    # via tokenizers
 idna==3.11
     # via
     #   anyio
     #   email-validator
     #   httpx
+    #   requests
+    #   yarl
 iniconfig==2.3.0
     # via pytest
+jsonpatch==1.33
+    # via langchain-core
+jsonpointer==3.0.0
+    # via jsonpatch
+langchain-core==1.0.3
+    # via langchain-text-splitters
+langchain-text-splitters==1.0.0
+    # via voyageai
+langsmith==0.4.40
+    # via langchain-core
 markdown-it-py==4.0.0
     # via rich
 mdurl==0.1.2
     # via markdown-it-py
+multidict==6.7.0
+    # via
+    #   aiohttp
+    #   yarl
+numpy==2.3.4
+    # via voyageai
+orjson==3.11.4
+    # via langsmith
 packaging==25.0
-    # via pytest
+    # via
+    #   huggingface-hub
+    #   langchain-core
+    #   langsmith
+    #   pytest
+pillow==12.0.0
+    # via voyageai
 pluggy==1.6.0
     # via pytest
+propcache==0.4.1
+    # via
+    #   aiohttp
+    #   yarl
 pydantic[email]==2.12.3
     # via
     #   -r requirements.in
     #   fastapi
     #   fastapi-cloud-cli
+    #   langchain-core
+    #   langsmith
+    #   voyageai
 pydantic-core==2.41.4
     # via pydantic
 pygments==2.19.2
@@ -93,7 +154,16 @@ python-multipart==0.0.20
 pyyaml==6.0.3
     # via
     #   -r requirements.in
+    #   huggingface-hub
+    #   langchain-core
     #   uvicorn
+requests==2.32.5
+    # via
+    #   langsmith
+    #   requests-toolbelt
+    #   voyageai
+requests-toolbelt==1.0.0
+    # via langsmith
 rich==14.2.0
     # via
     #   -r requirements.in
@@ -111,30 +181,47 @@ sentry-sdk==2.42.1
     #   -r requirements.in
     #   fastapi-cloud-cli
 shellingham==1.5.4
-    # via typer
+    # via
+    #   huggingface-hub
+    #   typer
 sniffio==1.3.1
     # via anyio
 starlette==0.49.1
     # via
     #   -r requirements.in
     #   fastapi
+tenacity==9.1.2
+    # via
+    #   langchain-core
+    #   voyageai
+tokenizers==0.22.1
+    # via voyageai
+tqdm==4.67.1
+    # via huggingface-hub
 typer==0.20.0
     # via
     #   -r requirements.in
     #   fastapi-cli
     #   fastapi-cloud-cli
+typer-slim==0.20.0
+    # via huggingface-hub
 typing-extensions==4.15.0
     # via
     #   fastapi
+    #   huggingface-hub
+    #   langchain-core
     #   pydantic
     #   pydantic-core
     #   rich-toolkit
     #   typer
+    #   typer-slim
     #   typing-inspection
 typing-inspection==0.4.2
     # via pydantic
 urllib3==2.5.0
-    # via sentry-sdk
+    # via
+    #   requests
+    #   sentry-sdk
 uvicorn[standard]==0.38.0
     # via
     #   -r requirements.in
@@ -144,6 +231,8 @@ uvloop==0.22.1
     # via
     #   -r requirements.in
     #   uvicorn
+voyageai==0.3.5
+    # via -r requirements.in
 watchfiles==1.1.1
     # via
     #   -r requirements.in
@@ -152,3 +241,7 @@ websockets==15.0.1
     # via
     #   -r requirements.in
     #   uvicorn
+yarl==1.22.0
+    # via aiohttp
+zstandard==0.25.0
+    # via langsmith
diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 10981c8..4a7fa2a 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -340,6 +340,7 @@ async def vector_search_movies(
                     # Handle invalid ObjectId conversion
                     result["_id"] = str(result["_id"]) if result["_id"] else None
         
+        # This code converts the raw results into VectorSearchResult objects
         results = [VectorSearchResult(**doc) for doc in raw_results]
         
         return create_success_response(

From 9f99a282d86238a1d1e0007d98bfdf9971f135c0 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Tue, 4 Nov 2025 14:37:45 -0500
Subject: [PATCH 049/110] Add READMEs to development

---
 mflix/README-JAVA-SPRING.md        | 26 ++++++++++++++++++++++++++
 mflix/README-JAVASCRIPT-EXPRESS.md | 26 ++++++++++++++++++++++++++
 mflix/README-PYTHON-FASTAPI.md     | 26 ++++++++++++++++++++++++++
 3 files changed, 78 insertions(+)
 create mode 100644 mflix/README-JAVA-SPRING.md
 create mode 100644 mflix/README-JAVASCRIPT-EXPRESS.md
 create mode 100644 mflix/README-PYTHON-FASTAPI.md

diff --git a/mflix/README-JAVA-SPRING.md b/mflix/README-JAVA-SPRING.md
new file mode 100644
index 0000000..19db73d
--- /dev/null
+++ b/mflix/README-JAVA-SPRING.md
@@ -0,0 +1,26 @@
+# Java Spring Boot MongoDB Sample MFlix Application
+
+[TODO: Add intro]
+
+```
+├── README.md
+├── client/     # Next.js frontend
+└── server/     # Java Spring backend
+```
+
+## Getting Started
+
+[TODO: Add getting started instructions explaining how to set connection string, start server, start client, etc.]
+
+## Issues
+
+If you have problems running the sample app, please check the following:
+
+- [ ] Verify that you have set your MongoDB connection string in the `.env` file.
+- [ ] Verify that you have started the Java Spring server.
+- [ ] Verify that you have started the Next.js client.
+- [ ] Verify that you have no firewalls blocking access to the server or client ports.
+
+If you have verified the above and still have issues, please
+[open an issue](https://github.com/mongodb/docs-sample-apps/issues/new/choose)
+on the source repository `mongodb/docs-sample-apps`.
diff --git a/mflix/README-JAVASCRIPT-EXPRESS.md b/mflix/README-JAVASCRIPT-EXPRESS.md
new file mode 100644
index 0000000..fa79f86
--- /dev/null
+++ b/mflix/README-JAVASCRIPT-EXPRESS.md
@@ -0,0 +1,26 @@
+# JavaScript Express.js MongoDB Sample MFlix Application
+
+[TODO: Add intro]
+
+```
+├── README.md
+├── client/     # Next.js frontend
+└── server/     # Express.js backend
+```
+
+## Getting Started
+
+[TODO: Add getting started instructions explaining how to set connection string, start server, start client, etc.]
+
+## Issues
+
+If you have problems running the sample app, please check the following:
+
+- [ ] Verify that you have set your MongoDB connection string in the `.env` file.
+- [ ] Verify that you have started the Express server.
+- [ ] Verify that you have started the Next.js client.
+- [ ] Verify that you have no firewalls blocking access to the server or client ports.
+
+If you have verified the above and still have issues, please
+[open an issue](https://github.com/mongodb/docs-sample-apps/issues/new/choose)
+on the source repository `mongodb/docs-sample-apps`.
diff --git a/mflix/README-PYTHON-FASTAPI.md b/mflix/README-PYTHON-FASTAPI.md
new file mode 100644
index 0000000..229462f
--- /dev/null
+++ b/mflix/README-PYTHON-FASTAPI.md
@@ -0,0 +1,26 @@
+# Python FastAPI MongoDB Sample MFlix Application
+
+[TODO: Add intro]
+
+```
+├── README.md
+├── client/     # Next.js frontend
+└── server/     # Python FastAPI backend
+```
+
+## Getting Started
+
+[TODO: Add getting started instructions explaining how to set connection string, start server, start client, etc.]
+
+## Issues
+
+If you have problems running the sample app, please check the following:
+
+- [ ] Verify that you have set your MongoDB connection string in the `.env` file.
+- [ ] Verify that you have started the Python FastAPI server.
+- [ ] Verify that you have started the Next.js client.
+- [ ] Verify that you have no firewalls blocking access to the server or client ports.
+
+If you have verified the above and still have issues, please
+[open an issue](https://github.com/mongodb/docs-sample-apps/issues/new/choose)
+on the source repository `mongodb/docs-sample-apps`.

From b755575089771bf77d6d846d8d0fb2825457aa80 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 4 Nov 2025 15:00:02 -0500
Subject: [PATCH 050/110] fix: add id annotation to movie

---
 .../src/main/java/com/mongodb/samplemflix/model/Movie.java      | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
index eb2fb83..b896b4e 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
@@ -1,5 +1,6 @@
 package com.mongodb.samplemflix.model;
 
+import com.fasterxml.jackson.annotation.JsonProperty;
 import java.util.Date;
 import java.util.List;
 import lombok.AllArgsConstructor;
@@ -75,6 +76,7 @@ private Fields() {
      * Maps to the _id field in MongoDB.
      * Can be null for new documents (MongoDB will generate it).
      */
+    @JsonProperty("_id")
     private ObjectId id;
 
     /**

From 252d59bc067eb0999bb023a2510e4b1cf7afec04 Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Tue, 4 Nov 2025 15:21:35 -0500
Subject: [PATCH 051/110] reorder order of endpoints in function

---
 server/python/src/routers/movies.py | 41 +++++++++++++++--------------
 1 file changed, 21 insertions(+), 20 deletions(-)

diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 4a7fa2a..53730b4 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -14,13 +14,31 @@
 Each method demonstrates different MongoDB operations using the PyMongo driver.
 
 Implemented Endpoints:
-- GET /api/movies/ :
-    Retrieve a list of movies with optional filtering, sorting, and pagination.
-    Supports text search, genre, year, rating filters, and customizable sorting.
+
+- GET /api/movies/search :
+    Search movies using MongoDB Search across the plot, fullplot, directors, writers, and cast fields.
+    Supports compound search operators and fuzzy matching.
+
+- GET /api/movies/vector-search :
+    Search movies using MongoDB Vector Search to enable semantic search capabilities over
+    the plot field.
+
+- GET /api/movies/aggregations/reportingByComments :
+    Aggregate movies with their most recent comments using MongoDB $lookup aggregation.
+
+- GET /api/movies/aggregations/reportingByYear :
+    Aggregate movies by year with average rating and movie count.
+
+- GET /api/movies/aggregations/reportingByDirectors :
+    Aggregate directors with the most movies and their statistics.
 
 - GET /api/movies/{id} :
     Retrieve a single movie by its ID.
 
+- GET /api/movies/ :
+    Retrieve a list of movies with optional filtering, sorting, and pagination.
+    Supports text search, genre, year, rating filters, and customizable sorting.
+
 - POST /api/movies/ :
     Create a new movie.
 
@@ -42,23 +60,6 @@
 - DELETE /api/movies/{id}/find-and-delete :
     Find and delete a movie in a single atomic operation.
 
-- GET /api/movies/aggregations/reportingByComments :
-    Aggregate movies with their most recent comments using MongoDB $lookup aggregation.
-
-- GET /api/movies/aggregations/reportingByYear :
-    Aggregate movies by year with average rating and movie count.
-
-- GET /api/movies/aggregations/reportingByDirectors :
-    Aggregate directors with the most movies and their statistics.
-
-- GET /api/movies/search :
-    Search movies using MongoDB Search across the plot, fullplot, directors, writers, and cast fields.
-    Supports compound search operators and fuzzy matching.
-
-- GET /api/movies/vector-search :
-    Search movies using MongoDB Vector Search to enable semantic search capabilities over
-    the plot field.
-
 Helper Functions:
 - execute_aggregation(pipeline): Executes a MongoDB aggregation pipeline and returns the
 results.

From 4516e99007c97f7d70889dc3fe7b12078f2236e8 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 4 Nov 2025 20:04:09 -0500
Subject: [PATCH 052/110] refactor: use driver instead of http request

---
 .../config/DatabaseVerification.java          | 22 +++++++-----
 .../samplemflix/service/MovieServiceImpl.java | 34 ++++++++++---------
 2 files changed, 31 insertions(+), 25 deletions(-)

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
index a4b9a9b..9a4ba4f 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -301,24 +301,28 @@ private void createVectorSearchIndex(MongoCollection<Document> embeddedMoviesCol
 
             if (!indexExists) {
                 // Define the vector search index specification
-                Document vectorField = new Document()
+                // For vectorSearch type, use fields as an array with path, type, numDimensions, and similarity
+                Document vectorFieldDefinition = new Document()
                         .append("type", "vector")
                         .append("path", "plot_embedding_voyage_3_large")
                         .append("numDimensions", 2048)
                         .append("similarity", "cosine");
 
                 Document indexDefinition = new Document()
-                        .append("fields", java.util.Arrays.asList(vectorField));
+                        .append("fields", java.util.Collections.singletonList(vectorFieldDefinition));
 
-                Document searchIndexModel = new Document()
-                        .append("name", VECTOR_INDEX_NAME)
-                        .append("type", "vectorSearch")
-                        .append("definition", indexDefinition);
+                // Use the createSearchIndexes command
+                Document createIndexCommand = new Document("createSearchIndexes", EMBEDDED_MOVIES_COLLECTION)
+                        .append("indexes", java.util.Collections.singletonList(
+                                new Document("name", VECTOR_INDEX_NAME)
+                                        .append("type", "vectorSearch")
+                                        .append("definition", indexDefinition)
+                        ));
 
-                // Create the index using the createSearchIndex command
-                String indexName = embeddedMoviesCollection.createSearchIndex(searchIndexModel);
+                // Execute the command
+                database.runCommand(createIndexCommand);
 
-                logger.info("Vector search index '{}' created successfully. Index may take a few moments to build.", indexName);
+                logger.info("Vector search index '{}' created successfully. Index may take a few moments to build.", VECTOR_INDEX_NAME);
                 logger.info("Vector search is now ready to use on the '{}' collection", EMBEDDED_MOVIES_COLLECTION);
             }
 
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 2db3ef7..3da1646 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -820,7 +820,7 @@ public List<VectorSearchResult> vectorSearchMovies(String query, Integer limit)
 
         try {
             // Generate embedding using Voyage AI REST API
-            // We use the REST API directly to specify output_dimension=2048
+            // We call the API directly to specify output_dimension=2048
             List<Double> queryVector = generateVoyageEmbedding(query, voyageApiKey);
 
             // Build the $vectorSearch aggregation stage
@@ -866,23 +866,24 @@ public List<VectorSearchResult> vectorSearchMovies(String query, Integer limit)
     /**
      * Generates a vector embedding using the Voyage AI REST API.
      *
-     * <p>This method calls the Voyage AI API directly to generate embeddings with
-     * the specified output dimension (2048) to match the collection's embeddings.
+     * <p>This method calls the Voyage AI API directly to generate embeddings with 2048 dimensions.
+     * The voyage-3-large model supports multiple dimensions (256, 512, 1024, 2048), and we explicitly
+     * request 2048 to match the vector search index configuration.
      *
      * @param text The text to generate an embedding for
      * @param apiKey The Voyage AI API key
      * @return List of doubles representing the embedding vector
-     * @throws IOException If there's an error calling the API
-     * @throws InterruptedException If the HTTP request is interrupted
+     * @throws IOException if the HTTP request fails
+     * @throws InterruptedException if the HTTP request is interrupted
      */
-    private List<Double> generateVoyageEmbedding(String text, String apiKey)
-            throws IOException, InterruptedException {
+    private List<Double> generateVoyageEmbedding(String text, String apiKey) throws IOException, InterruptedException {
+        // Create HTTP client
         HttpClient client = HttpClient.newHttpClient();
 
-        // Build the request body
+        // Build the request body with output_dimension set to 2048
         String requestBody = String.format(
-            "{\"input\":[\"%s\"],\"model\":\"voyage-3-large\",\"output_dimension\":2048,\"input_type\":\"query\"}",
-            text.replace("\"", "\\\"")
+                "{\"input\": [\"%s\"], \"model\": \"voyage-3-large\", \"output_dimension\": 2048, \"input_type\": \"query\"}",
+                text.replace("\"", "\\\"").replace("\n", "\\n")
         );
 
         // Create the HTTP request
@@ -896,16 +897,17 @@ private List<Double> generateVoyageEmbedding(String text, String apiKey)
         // Send the request and get the response
         HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
 
+        // Check for successful response
         if (response.statusCode() != 200) {
-            throw new DatabaseOperationException(
-                "Voyage AI API error: " + response.statusCode() + " - " + response.body()
-            );
+            throw new IOException("Voyage AI API returned status code " + response.statusCode() + ": " + response.body());
         }
 
-        // Parse the response to extract the embedding
-        JsonNode jsonResponse = objectMapper.readTree(response.body());
-        JsonNode embeddingNode = jsonResponse.get("data").get(0).get("embedding");
+        // Parse the JSON response to extract the embedding
+        ObjectMapper mapper = new ObjectMapper();
+        JsonNode root = mapper.readTree(response.body());
+        JsonNode embeddingNode = root.path("data").get(0).path("embedding");
 
+        // Convert the embedding to a List<Double>
         List<Double> embedding = new ArrayList<>();
         for (JsonNode value : embeddingNode) {
             embedding.add(value.asDouble());

From 259aaae18625f81022f0b7fb7c3c02b0ca7fd9ef Mon Sep 17 00:00:00 2001
From: Jordan Smith <45415425+jordan-smith721@users.noreply.github.com>
Date: Tue, 4 Nov 2025 20:04:20 -0500
Subject: [PATCH 053/110] feat: implement Mongodb search front end (#15)

---
 .../SearchMovieModal.module.css               | 223 +++++++++++++
 .../SearchMovieModal/SearchMovieModal.tsx     | 311 ++++++++++++++++++
 .../app/components/SearchMovieModal/index.ts  |   2 +
 client/app/components/index.ts                |   1 +
 client/app/lib/api.ts                         |  82 ++++-
 client/app/movies/movies.module.css           | 168 +++++++++-
 client/app/movies/page.tsx                    | 258 +++++++++++++--
 .../src/controllers/movieController.ts        |   2 +-
 server/express/src/routes/movies.ts           |   4 +-
 server/java-spring/README.md                  |   2 +-
 .../controller/MovieControllerImpl.java       |   6 +
 server/python/.env.example                    |   7 +
 server/python/main.py                         |  17 +
 server/python/src/models/models.py            |  12 +
 server/python/src/routers/movies.py           | 125 ++++---
 15 files changed, 1143 insertions(+), 77 deletions(-)
 create mode 100644 client/app/components/SearchMovieModal/SearchMovieModal.module.css
 create mode 100644 client/app/components/SearchMovieModal/SearchMovieModal.tsx
 create mode 100644 client/app/components/SearchMovieModal/index.ts
 create mode 100644 server/python/.env.example

diff --git a/client/app/components/SearchMovieModal/SearchMovieModal.module.css b/client/app/components/SearchMovieModal/SearchMovieModal.module.css
new file mode 100644
index 0000000..6805e8c
--- /dev/null
+++ b/client/app/components/SearchMovieModal/SearchMovieModal.module.css
@@ -0,0 +1,223 @@
+/**
+ * Search Movie Modal Styles
+ * 
+ * CSS Module for the search movie modal component.
+ * Provides consistent styling with the rest of the application.
+ */
+
+.formContainer {
+  background: white;
+  border-radius: 12px;
+  padding: 2rem;
+  box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
+  margin-bottom: 2rem;
+}
+
+.formTitle {
+  font-size: 1.75rem;
+  font-weight: bold;
+  color: #333;
+  margin: 0 0 1.5rem 0;
+  text-align: center;
+}
+
+.batchDescription {
+  background-color: #f8f9fa;
+  border: 1px solid #e9ecef;
+  border-radius: 8px;
+  padding: 1rem;
+  margin-bottom: 1.5rem;
+  color: #495057;
+  font-size: 0.9rem;
+  line-height: 1.4;
+  text-align: center;
+}
+
+.generalError {
+  background-color: #f8d7da;
+  border: 1px solid #f5c6cb;
+  color: #721c24;
+  padding: 0.75rem 1rem;
+  border-radius: 8px;
+  margin-bottom: 1rem;
+  font-size: 0.9rem;
+  text-align: center;
+}
+
+.form {
+  width: 100%;
+}
+
+.formGrid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+  gap: 1.5rem;
+  margin-bottom: 1.5rem;
+}
+
+.formGroup {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.label {
+  font-weight: 500;
+  color: #333;
+  font-size: 0.9rem;
+}
+
+.input,
+.textarea {
+  padding: 0.75rem;
+  border: 2px solid #e1e5e9;
+  border-radius: 8px;
+  font-size: 1rem;
+  transition: border-color 0.2s ease, box-shadow 0.2s ease;
+  background: white;
+}
+
+.input:focus,
+.textarea:focus {
+  outline: none;
+  border-color: #0070f3;
+  box-shadow: 0 0 0 3px rgba(0, 112, 243, 0.1);
+}
+
+.input:disabled,
+.textarea:disabled {
+  background: #f8f9fa;
+  color: #6c757d;
+  cursor: not-allowed;
+}
+
+.inputError {
+  border-color: #dc2626 !important;
+}
+
+.inputError:focus {
+  box-shadow: 0 0 0 3px rgba(220, 38, 38, 0.1) !important;
+}
+
+.error {
+  color: #dc2626;
+  font-size: 0.875rem;
+  margin-top: 0.25rem;
+}
+
+.searchOperatorDescription {
+  color: #6c757d;
+  font-size: 0.875rem;
+  margin-top: 0.25rem;
+  display: block;
+}
+
+.formActions {
+  display: flex;
+  gap: 1rem;
+  justify-content: flex-end;
+  padding-top: 1.5rem;
+  border-top: 1px solid #e1e5e9;
+}
+
+.button {
+  padding: 0.75rem 1.5rem;
+  border: none;
+  border-radius: 8px;
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  min-width: 120px;
+}
+
+.button:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  transform: none;
+}
+
+.saveButton {
+  background: #0070f3;
+  color: white;
+  border: 1px solid #0070f3;
+}
+
+.saveButton:hover:not(:disabled) {
+  background: #0051cc;
+  border-color: #0051cc;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(0, 112, 243, 0.3);
+}
+
+.cancelButton {
+  background: #6c757d;
+  color: white;
+  border: 1px solid #6c757d;
+}
+
+.cancelButton:hover:not(:disabled) {
+  background: #5a6268;
+  border-color: #5a6268;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(108, 117, 125, 0.3);
+}
+
+.clearButton {
+  background: #6c757d;
+  color: white;
+  border: 1px solid #6c757d;
+}
+
+.clearButton:hover:not(:disabled) {
+  background: #5a6268;
+  border-color: #5a6268;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(108, 117, 125, 0.3);
+}
+
+/* Responsive Design */
+@media (max-width: 768px) {
+  .formContainer {
+    padding: 1.5rem;
+  }
+
+  .formGrid {
+    grid-template-columns: 1fr;
+    gap: 1rem;
+  }
+
+  .formActions {
+    flex-direction: column-reverse;
+    gap: 0.75rem;
+  }
+
+  .button {
+    width: 100%;
+  }
+}
+
+@media (max-width: 480px) {
+  .formContainer {
+    padding: 1rem;
+  }
+
+  .formTitle {
+    font-size: 1.5rem;
+  }
+
+  .formGrid {
+    gap: 0.75rem;
+  }
+
+  .input,
+  .textarea {
+    padding: 0.625rem;
+    font-size: 0.9rem;
+  }
+
+  .button {
+    padding: 0.75rem 1rem;
+    font-size: 0.9rem;
+  }
+}
\ No newline at end of file
diff --git a/client/app/components/SearchMovieModal/SearchMovieModal.tsx b/client/app/components/SearchMovieModal/SearchMovieModal.tsx
new file mode 100644
index 0000000..0466819
--- /dev/null
+++ b/client/app/components/SearchMovieModal/SearchMovieModal.tsx
@@ -0,0 +1,311 @@
+'use client';
+
+/**
+ * Search Movie Modal Component
+ * 
+ * Modal for searching movies across multiple fields using MongoDB Search.
+ * Supports plot, fullplot, directors, writers, cast fields with search operator options.
+ */
+
+import { useState } from 'react';
+import styles from './SearchMovieModal.module.css';
+
+interface SearchMovieModalProps {
+  onSearch: (searchParams: SearchParams) => void;
+  onCancel: () => void;
+  isLoading?: boolean;
+}
+
+export interface SearchParams {
+  plot?: string;
+  fullplot?: string;
+  directors?: string;
+  writers?: string;
+  cast?: string;
+  limit?: number;
+  skip?: number;
+  search_operator?: 'must' | 'should' | 'mustNot' | 'filter';
+}
+
+interface SearchFormData {
+  plot: string;
+  fullplot: string;
+  directors: string;
+  writers: string;
+  cast: string;
+  limit: string;
+  search_operator: 'must' | 'should' | 'mustNot' | 'filter';
+}
+
+const getInitialFormData = (): SearchFormData => ({
+  plot: '',
+  fullplot: '',
+  directors: '',
+  writers: '',
+  cast: '',
+  limit: '20',
+  search_operator: 'must',
+});
+
+export default function SearchMovieModal({ 
+  onSearch, 
+  onCancel, 
+  isLoading = false
+}: SearchMovieModalProps) {
+  const [formData, setFormData] = useState<SearchFormData>(getInitialFormData());
+  const [errors, setErrors] = useState<Record<string, string>>({});
+
+  const validateForm = () => {
+    const newErrors: Record<string, string> = {};
+
+    // Check if at least one search field has a value
+    const hasSearchInput = formData.plot.trim() || 
+                          formData.fullplot.trim() || 
+                          formData.directors.trim() || 
+                          formData.writers.trim() || 
+                          formData.cast.trim();
+
+    if (!hasSearchInput) {
+      newErrors.general = 'Please enter search terms in at least one field';
+    }
+
+    // Validate limit
+    const limitNum = parseInt(formData.limit);
+    if (!limitNum || limitNum < 1 || limitNum > 100) {
+      newErrors.limit = 'Limit must be between 1 and 100';
+    }
+
+    setErrors(newErrors);
+    return Object.keys(newErrors).length === 0;
+  };
+
+  const handleSubmit = (e: React.FormEvent) => {
+    e.preventDefault();
+    
+    if (!validateForm()) {
+      return;
+    }
+
+    // Build search parameters, only including non-empty fields
+    const searchParams: SearchParams = {
+      search_operator: formData.search_operator,
+      limit: parseInt(formData.limit),
+      skip: 0, // Always start from beginning for new search
+    };
+
+    if (formData.plot.trim()) {
+      searchParams.plot = formData.plot.trim();
+    }
+    if (formData.fullplot.trim()) {
+      searchParams.fullplot = formData.fullplot.trim();
+    }
+    if (formData.directors.trim()) {
+      searchParams.directors = formData.directors.trim();
+    }
+    if (formData.writers.trim()) {
+      searchParams.writers = formData.writers.trim();
+    }
+    if (formData.cast.trim()) {
+      searchParams.cast = formData.cast.trim();
+    }
+
+    onSearch(searchParams);
+  };
+
+  const handleInputChange = (field: string, value: string) => {
+    setFormData(prev => ({ ...prev, [field]: value }));
+    
+    // Clear errors when user starts typing
+    if (errors[field]) {
+      setErrors(prev => ({ ...prev, [field]: '' }));
+    }
+    if (errors.general) {
+      setErrors(prev => ({ ...prev, general: '' }));
+    }
+  };
+
+  const handleClear = () => {
+    setFormData(getInitialFormData());
+    setErrors({});
+  };
+
+  const searchOperatorOptions = [
+    { value: 'must', label: 'Must match all fields (AND)', description: 'All specified fields must match' },
+    { value: 'should', label: 'Should match any field (OR)', description: 'At least one field should match' },
+    { value: 'mustNot', label: 'Must not match', description: 'Results must NOT contain these terms' },
+    { value: 'filter', label: 'Filter results', description: 'Filter results by these criteria' },
+  ];
+
+  return (
+    <div className={styles.formContainer}>
+      <h2 className={styles.formTitle}>Search Movies</h2>
+      <p className={styles.batchDescription}>
+        Search across movie plots, directors, writers, and cast.
+      </p>
+      
+      {errors.general && (
+        <div className={styles.generalError}>
+          {errors.general}
+        </div>
+      )}
+
+      <form onSubmit={handleSubmit} className={styles.form}>
+        {/* Search Fields */}
+        <div className={styles.formGrid}>
+          {/* Plot Search */}
+          <div className={styles.formGroup}>
+            <label htmlFor="plot" className={styles.label}>
+              Plot Keywords
+            </label>
+            <input
+              type="text"
+              id="plot"
+              value={formData.plot}
+              onChange={(e) => handleInputChange('plot', e.target.value)}
+              className={`${styles.input} ${errors.plot ? styles.inputError : ''}`}
+              disabled={isLoading}
+                            placeholder="Exact phrase search in plot summaries"
+            />
+            {errors.plot && <span className={styles.error}>{errors.plot}</span>}
+          </div>
+
+          {/* Full Plot Search */}
+          <div className={styles.formGroup}>
+            <label htmlFor="fullplot" className={styles.label}>
+              Full Plot Keywords
+            </label>
+            <input
+              type="text"
+              id="fullplot"
+              value={formData.fullplot}
+              onChange={(e) => handleInputChange('fullplot', e.target.value)}
+              className={`${styles.input} ${errors.fullplot ? styles.inputError : ''}`}
+              disabled={isLoading}
+              placeholder="Search in full plot descriptions"
+            />
+            {errors.fullplot && <span className={styles.error}>{errors.fullplot}</span>}
+          </div>
+
+          {/* Directors Search */}
+          <div className={styles.formGroup}>
+            <label htmlFor="directors" className={styles.label}>
+              Directors
+            </label>
+            <input
+              type="text"
+              id="directors"
+              value={formData.directors}
+              onChange={(e) => handleInputChange('directors', e.target.value)}
+              className={`${styles.input} ${errors.directors ? styles.inputError : ''}`}
+              disabled={isLoading}
+              placeholder="Director names"
+            />
+            {errors.directors && <span className={styles.error}>{errors.directors}</span>}
+          </div>
+
+          {/* Writers Search */}
+          <div className={styles.formGroup}>
+            <label htmlFor="writers" className={styles.label}>
+              Writers
+            </label>
+            <input
+              type="text"
+              id="writers"
+              value={formData.writers}
+              onChange={(e) => handleInputChange('writers', e.target.value)}
+              className={`${styles.input} ${errors.writers ? styles.inputError : ''}`}
+              disabled={isLoading}
+              placeholder="Writer names"
+            />
+            {errors.writers && <span className={styles.error}>{errors.writers}</span>}
+          </div>
+
+          {/* Cast Search */}
+          <div className={styles.formGroup}>
+            <label htmlFor="cast" className={styles.label}>
+              Cast
+            </label>
+            <input
+              type="text"
+              id="cast"
+              value={formData.cast}
+              onChange={(e) => handleInputChange('cast', e.target.value)}
+              className={`${styles.input} ${errors.cast ? styles.inputError : ''}`}
+              disabled={isLoading}
+              placeholder="Actor names"
+            />
+            {errors.cast && <span className={styles.error}>{errors.cast}</span>}
+          </div>
+
+          {/* Limit */}
+          <div className={styles.formGroup}>
+            <label htmlFor="limit" className={styles.label}>
+              Max Results
+            </label>
+            <input
+              type="number"
+              id="limit"
+              value={formData.limit}
+              onChange={(e) => handleInputChange('limit', e.target.value)}
+              className={`${styles.input} ${errors.limit ? styles.inputError : ''}`}
+              disabled={isLoading}
+              min="1"
+              max="100"
+            />
+            {errors.limit && <span className={styles.error}>{errors.limit}</span>}
+          </div>
+        </div>
+
+        {/* Search Operator */}
+        <div className={styles.formGroup}>
+          <label htmlFor="search_operator" className={styles.label}>
+            Search Logic
+          </label>
+          <select
+            id="search_operator"
+            value={formData.search_operator}
+            onChange={(e) => handleInputChange('search_operator', e.target.value)}
+            className={styles.input}
+            disabled={isLoading}
+          >
+            {searchOperatorOptions.map((option) => (
+              <option key={option.value} value={option.value}>
+                {option.label}
+              </option>
+            ))}
+          </select>
+          <small className={styles.searchOperatorDescription}>
+            {searchOperatorOptions.find(opt => opt.value === formData.search_operator)?.description}
+          </small>
+        </div>
+
+        {/* Form Actions */}
+        <div className={styles.formActions}>
+          <button
+            type="button"
+            onClick={handleClear}
+            className={`${styles.button} ${styles.clearButton}`}
+            disabled={isLoading}
+          >
+            Clear
+          </button>
+          <button
+            type="button"
+            onClick={onCancel}
+            className={`${styles.button} ${styles.cancelButton}`}
+            disabled={isLoading}
+          >
+            Close
+          </button>
+          <button
+            type="submit"
+            className={`${styles.button} ${styles.saveButton}`}
+            disabled={isLoading}
+          >
+            {isLoading ? 'Searching...' : 'Search Movies'}
+          </button>
+        </div>
+      </form>
+    </div>
+  );
+}
\ No newline at end of file
diff --git a/client/app/components/SearchMovieModal/index.ts b/client/app/components/SearchMovieModal/index.ts
new file mode 100644
index 0000000..06150bc
--- /dev/null
+++ b/client/app/components/SearchMovieModal/index.ts
@@ -0,0 +1,2 @@
+export { default } from './SearchMovieModal';
+export type { SearchParams } from './SearchMovieModal';
\ No newline at end of file
diff --git a/client/app/components/index.ts b/client/app/components/index.ts
index 8e9ff75..03c422b 100644
--- a/client/app/components/index.ts
+++ b/client/app/components/index.ts
@@ -6,6 +6,7 @@ export { default as ActionButtons } from './ActionButtons';
 export { default as EditMovieForm } from './EditMovieForm';
 export { default as AddMovieForm } from './AddMovieForm';
 export { default as BatchEditMovieForm } from './BatchEditMovieForm';
+export { default as SearchMovieModal } from './SearchMovieModal';
 export { 
   Skeleton, 
   MovieCardSkeleton, 
diff --git a/client/app/lib/api.ts b/client/app/lib/api.ts
index 895ba95..37bc7ff 100644
--- a/client/app/lib/api.ts
+++ b/client/app/lib/api.ts
@@ -105,7 +105,7 @@ export async function updateMovie(id: string, updateData: Partial<Movie>): Promi
     const { _id, ...dataToUpdate } = updateData;
 
     const response = await fetch(`${API_BASE_URL}/api/movies/${id}`, {
-      method: 'PUT',
+      method: 'PATCH',
       headers: {
         'Content-Type': 'application/json',
       },
@@ -183,7 +183,7 @@ export async function deleteMovie(id: string): Promise<{ success: boolean; error
  */
 export async function createMovie(movieData: Omit<Movie, '_id'>): Promise<{ success: boolean; error?: string; movieId?: string }> {
   try {
-    const response = await fetch(`${API_BASE_URL}/api/movies`, {
+    const response = await fetch(`${API_BASE_URL}/api/movies/`, {
       method: 'POST',
       headers: {
         'Content-Type': 'application/json',
@@ -276,7 +276,7 @@ export async function deleteMoviesBatch(movieIds: string[]): Promise<{ success:
       }
     };
 
-    const response = await fetch(`${API_BASE_URL}/api/movies`, {
+    const response = await fetch(`${API_BASE_URL}/api/movies/`, {
       method: 'DELETE',
       headers: {
         'Content-Type': 'application/json',
@@ -326,7 +326,7 @@ export async function updateMoviesBatch(movieIds: string[], updateData: Partial<
       }
     };
 
-    const response = await fetch(`${API_BASE_URL}/api/movies`, {
+    const response = await fetch(`${API_BASE_URL}/api/movies/`, {
       method: 'PATCH',
       headers: {
         'Content-Type': 'application/json',
@@ -362,4 +362,78 @@ export async function updateMoviesBatch(movieIds: string[], updateData: Partial<
       error: 'Network error occurred while updating movies' 
     };
   }
+}
+
+/**
+ * Search movies using MongoDB Search across multiple fields with pagination support
+ */
+export async function searchMovies(searchParams: {
+  plot?: string;
+  fullplot?: string;
+  directors?: string;
+  writers?: string;
+  cast?: string;
+  limit?: number;
+  skip?: number;
+  search_operator?: 'must' | 'should' | 'mustNot' | 'filter';
+}): Promise<{ success: boolean; error?: string; movies?: Movie[]; hasNextPage?: boolean; hasPrevPage?: boolean; totalCount?: number }> {
+  try {
+    // Build query parameters
+    const limit = searchParams.limit || 20;
+    const skip = searchParams.skip || 0;
+    
+    const queryParams = new URLSearchParams();
+    
+    if (searchParams.plot) queryParams.append('plot', searchParams.plot);
+    if (searchParams.fullplot) queryParams.append('fullplot', searchParams.fullplot);
+    if (searchParams.directors) queryParams.append('directors', searchParams.directors);
+    if (searchParams.writers) queryParams.append('writers', searchParams.writers);
+    if (searchParams.cast) queryParams.append('cast', searchParams.cast);
+    queryParams.append('limit', limit.toString());
+    queryParams.append('skip', skip.toString());
+    if (searchParams.search_operator) queryParams.append('search_operator', searchParams.search_operator);
+
+    const response = await fetch(`${API_BASE_URL}/api/movies/search?${queryParams}`, {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+    });
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      return { 
+        success: false, 
+        error: result.error || `Failed to search movies: ${response.status}` 
+      };
+    }
+
+    if (!result.success) {
+      return { 
+        success: false, 
+        error: result.error || 'API returned error response' 
+      };
+    }
+
+    const responseData = result.data || {};
+    const movies = responseData.movies || [];
+    const totalCount = responseData.totalCount || 0;
+    const hasNextPage = skip + limit < totalCount;
+    const hasPrevPage = skip > 0;
+
+    return { 
+      success: true, 
+      movies,
+      hasNextPage,
+      hasPrevPage,
+      totalCount
+    };
+  } catch (error) {
+    console.error('Error searching movies:', error);
+    return { 
+      success: false, 
+      error: 'Network error occurred while searching movies' 
+    };
+  }
 }
\ No newline at end of file
diff --git a/client/app/movies/movies.module.css b/client/app/movies/movies.module.css
index ae927d8..477547f 100644
--- a/client/app/movies/movies.module.css
+++ b/client/app/movies/movies.module.css
@@ -28,6 +28,126 @@
   flex-wrap: wrap;
 }
 
+.searchControls {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+
+.searchButton {
+  padding: 0.75rem 1.5rem;
+  background: #0070f3;
+  color: white;
+  border: none;
+  border-radius: 8px;
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 160px;
+}
+
+.searchButton:hover:not(:disabled) {
+  background: #0051cc;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(0, 112, 243, 0.3);
+}
+
+.searchButton:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  transform: none;
+}
+
+.clearSearchButton {
+  padding: 0.5rem 1rem;
+  background: #6c757d;
+  color: white;
+  border: none;
+  border-radius: 6px;
+  font-size: 0.875rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.clearSearchButton:hover:not(:disabled) {
+  background: #5a6268;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 8px rgba(108, 117, 125, 0.3);
+}
+
+/* Search Pagination Styles */
+.pagination {
+  margin: 3rem 0;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 1rem;
+}
+
+.paginationContainer {
+  display: flex;
+  align-items: center;
+  gap: 2rem;
+  flex-wrap: wrap;
+  justify-content: center;
+}
+
+.pageButton {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.75rem 1.5rem;
+  background: #fff;
+  color: #0070f3;
+  border: 1px solid #ddd;
+  border-radius: 6px;
+  text-decoration: none;
+  font-weight: 500;
+  font-size: 0.9rem;
+  transition: all 0.2s ease;
+  min-width: fit-content;
+  cursor: pointer;
+}
+
+.pageButton:hover:not(.disabled):not(:disabled) {
+  background: #0070f3;
+  color: white;
+  border-color: #0070f3;
+  transform: translateY(-1px);
+  box-shadow: 0 2px 4px rgba(0, 112, 243, 0.2);
+}
+
+.pageButton.disabled,
+.pageButton:disabled {
+  background: #f5f5f5;
+  color: #999;
+  border-color: #eee;
+  cursor: not-allowed;
+  opacity: 0.6;
+}
+
+.pageInfo {
+  font-size: 1rem;
+  font-weight: 600;
+  color: #333;
+  padding: 0.75rem 1rem;
+  background: #f8f9fa;
+  border-radius: 6px;
+  border: 1px solid #e9ecef;
+}
+
+.additionalInfo {
+  font-size: 0.85rem;
+  color: #666;
+  text-align: center;
+}
+
 .selectAllButton {
   padding: 0.5rem 1rem;
   background: #6c757d;
@@ -268,6 +388,29 @@
     justify-content: center;
   }
 
+  .searchControls {
+    justify-content: center;
+    width: 100%;
+  }
+
+  .pagination {
+    margin: 2rem 0;
+  }
+
+  .paginationContainer {
+    gap: 1rem;
+  }
+
+  .pageButton {
+    padding: 0.6rem 1.2rem;
+    font-size: 0.85rem;
+  }
+
+  .pageInfo {
+    font-size: 0.9rem;
+    padding: 0.6rem 0.8rem;
+  }
+
   .pageTitle {
     font-size: 28px;
     text-align: center;
@@ -310,8 +453,31 @@
 
   .selectAllButton,
   .batchDeleteButton,
-  .batchUpdateButton {
+  .batchUpdateButton,
+  .searchButton,
+  .clearSearchButton {
     width: 100%;
     padding: 0.75rem 1rem;
   }
+
+  .paginationContainer {
+    gap: 0.5rem;
+    width: 100%;
+  }
+
+  .pageButton {
+    flex: 1;
+    max-width: 120px;
+    padding: 0.6rem 0.8rem;
+    font-size: 0.8rem;
+  }
+
+  .pageInfo {
+    font-size: 0.8rem;
+    padding: 0.5rem 0.7rem;
+  }
+
+  .additionalInfo {
+    font-size: 0.8rem;
+  }
 }
diff --git a/client/app/movies/page.tsx b/client/app/movies/page.tsx
index c34e968..421478e 100644
--- a/client/app/movies/page.tsx
+++ b/client/app/movies/page.tsx
@@ -4,11 +4,12 @@ import { useState, useEffect } from 'react';
 import { useSearchParams, useRouter } from 'next/navigation';
 import pageStyles from "./page.module.css";
 import movieStyles from "./movies.module.css";
-import { MovieCard, Pagination, PageSizeSelector, AddMovieForm, BatchEditMovieForm } from "../components";
+import { MovieCard, Pagination, PageSizeSelector, AddMovieForm, BatchEditMovieForm, SearchMovieModal } from "../components";
 import { ErrorDisplay, LoadingSpinner } from "../components/ui";
-import { fetchMovies, createMovie, createMoviesBatch, deleteMoviesBatch, updateMoviesBatch } from "../lib/api";
+import { fetchMovies, createMovie, createMoviesBatch, deleteMoviesBatch, updateMoviesBatch, searchMovies } from "../lib/api";
 import { Movie } from "../types/movie";
 import { APP_CONFIG, ROUTES } from "../lib/constants";
+import type { SearchParams } from "../components/SearchMovieModal";
 
 export default function Movies() {
   const searchParams = useSearchParams();
@@ -21,12 +22,22 @@ export default function Movies() {
   const [isCreating, setIsCreating] = useState(false);
   const [isDeleting, setIsDeleting] = useState(false);
   const [isUpdating, setIsUpdating] = useState(false);
+  const [isSearching, setIsSearching] = useState(false);
   const [showAddForm, setShowAddForm] = useState(false);
   const [showBatchEditForm, setShowBatchEditForm] = useState(false);
+  const [showSearchModal, setShowSearchModal] = useState(false);
   const [selectedMovies, setSelectedMovies] = useState<Set<string>>(new Set());
   const [showDeleteConfirmation, setShowDeleteConfirmation] = useState(false);
   const [error, setError] = useState<string | null>(null);
   const [successMessage, setSuccessMessage] = useState<string | null>(null);
+  const [searchResults, setSearchResults] = useState<Movie[]>([]);
+  const [searchHasNextPage, setSearchHasNextPage] = useState(false);
+  const [searchHasPrevPage, setSearchHasPrevPage] = useState(false);
+  const [searchTotalCount, setSearchTotalCount] = useState(0);
+  const [isSearchMode, setIsSearchMode] = useState(false);
+  const [searchPage, setSearchPage] = useState(1);
+  const [searchLimit, setSearchLimit] = useState(20);
+  const [currentSearchParams, setCurrentSearchParams] = useState<SearchParams | null>(null);
   
   const page = parseInt(searchParams.get('page') || '1');
   const limit = Math.min(
@@ -193,6 +204,109 @@ export default function Movies() {
     setShowDeleteConfirmation(false);
   };
 
+  const handleSearch = () => {
+    setShowSearchModal(true);
+    setError(null);
+    setSuccessMessage(null);
+  };
+
+  const handleCancelSearch = () => {
+    setShowSearchModal(false);
+    setError(null);
+    setSuccessMessage(null);
+  };
+
+  const handleSearchSubmit = async (searchParams: SearchParams) => {
+    setIsSearching(true);
+    setError(null);
+    setSuccessMessage(null);
+
+    // For new searches, start from page 1
+    const searchSkip = 0;
+    const searchLimitToUse = searchParams.limit || 20;
+    
+    const searchParamsWithPagination = {
+      ...searchParams,
+      limit: searchLimitToUse,
+      skip: searchSkip,
+    };
+
+    const result = await searchMovies(searchParamsWithPagination);
+
+    if (result.success) {
+      setSearchResults(result.movies || []);
+      setSearchHasNextPage(result.hasNextPage || false);
+      setSearchHasPrevPage(result.hasPrevPage || false);
+      setSearchTotalCount(result.totalCount || 0);
+      setIsSearchMode(true);
+      setSearchPage(1);
+      setSearchLimit(searchLimitToUse);
+      setCurrentSearchParams(searchParams);
+      setShowSearchModal(false);
+      setSelectedMovies(new Set()); // Clear selection when switching to search mode
+      
+      const totalCount = result.totalCount || 0;
+      if (totalCount === 0) {
+        setSuccessMessage('Search completed, but no movies matched your criteria. Try different search terms.');
+      } else {
+        setSuccessMessage(`Found ${totalCount} total movies matching your search criteria.`);
+      }
+    } else {
+      setError(result.error || 'Failed to search movies');
+    }
+
+    setIsSearching(false);
+  };
+
+  const handleClearSearch = () => {
+    setIsSearchMode(false);
+    setSearchResults([]);
+    setSearchHasNextPage(false);
+    setSearchHasPrevPage(false);
+    setSearchTotalCount(0);
+    setSearchPage(1);
+    setCurrentSearchParams(null);
+    setSelectedMovies(new Set());
+    setError(null);
+    setSuccessMessage(null);
+    // The current movies will show the regular paginated results
+  };
+
+  // Get the movies to display based on current mode
+  const displayMovies = isSearchMode ? searchResults : movies;
+
+  const handleSearchPageChange = async (newPage: number) => {
+    if (!currentSearchParams) return;
+    
+    setIsSearching(true);
+    setError(null);
+    
+    const searchSkip = (newPage - 1) * searchLimit;
+    const searchParamsWithPagination = {
+      ...currentSearchParams,
+      limit: searchLimit,
+      skip: searchSkip,
+    };
+
+    try {
+      const result = await searchMovies(searchParamsWithPagination);
+      
+      if (result.success) {
+        setSearchResults(result.movies || []);
+        setSearchHasNextPage(result.hasNextPage || false);
+        setSearchHasPrevPage(result.hasPrevPage || false);
+        setSearchTotalCount(result.totalCount || 0);
+        setSearchPage(newPage);
+      } else {
+        setError(result.error || 'Failed to load search results');
+      }
+    } catch (error) {
+      setError('Failed to load search results');
+    }
+    
+    setIsSearching(false);
+  };
+
   if (isLoading && !showAddForm) {
     return (
       <div className={pageStyles.page}>
@@ -210,11 +324,36 @@ export default function Movies() {
     <div className={pageStyles.page}>
       <main className={pageStyles.main}>
         <div className={movieStyles.pageHeader}>
-          <h1 className={movieStyles.pageTitle}>Movies</h1>
+          <h1 className={movieStyles.pageTitle}>
+            {isSearchMode ? `Search Results` : 'Movies'}
+          </h1>
           
           <div className={movieStyles.headerActions}>
+            {/* Search and Clear Search Controls */}
+            {!showAddForm && !showBatchEditForm && !showSearchModal && (
+              <div className={movieStyles.searchControls}>
+                {isSearchMode && (
+                  <button
+                    onClick={handleClearSearch}
+                    className={movieStyles.clearSearchButton}
+                    type="button"
+                  >
+                    ← Back to All Movies
+                  </button>
+                )}
+                <button
+                  onClick={handleSearch}
+                  disabled={isSearching}
+                  className={movieStyles.searchButton}
+                  type="button"
+                >
+                  {isSearching ? 'Searching...' : 'Search Movies'}
+                </button>
+              </div>
+            )}
+
             {/* Batch Selection Controls */}
-            {!showAddForm && !showBatchEditForm && movies.length > 0 && (
+            {!showAddForm && !showBatchEditForm && !showSearchModal && displayMovies.length > 0 && (
               <div className={movieStyles.selectionControls}>
                 {selectedMovies.size > 0 && (
                   <>
@@ -240,14 +379,16 @@ export default function Movies() {
               </div>
             )}
 
-            <button
-              onClick={handleAddMovie}
-              disabled={showAddForm || showBatchEditForm || isCreating}
-              className={movieStyles.addButton}
-              type="button"
-            >
-              {isCreating ? 'Creating...' : '+ Add Movie'}
-            </button>
+            {!isSearchMode && (
+              <button
+                onClick={handleAddMovie}
+                disabled={showAddForm || showBatchEditForm || showSearchModal || isCreating}
+                className={movieStyles.addButton}
+                type="button"
+              >
+                {isCreating ? 'Creating...' : '+ Add Movie'}
+              </button>
+            )}
           </div>
         </div>
 
@@ -273,6 +414,15 @@ export default function Movies() {
           />
         )}
 
+        {/* Search Movie Modal */}
+        {showSearchModal && (
+          <SearchMovieModal
+            onSearch={handleSearchSubmit}
+            onCancel={handleCancelSearch}
+            isLoading={isSearching}
+          />
+        )}
+
         {/* Batch Edit Movie Form */}
         {showBatchEditForm && (
           <BatchEditMovieForm
@@ -283,41 +433,95 @@ export default function Movies() {
           />
         )}
 
-        {/* Page Size Selector */}
-        {!showAddForm && !showBatchEditForm && <PageSizeSelector currentLimit={limit} />}
+        {/* Page Size Selector - only show for regular mode */}
+        {!showAddForm && !showBatchEditForm && !showSearchModal && !isSearchMode && <PageSizeSelector currentLimit={limit} />}
         
         {/* Movies Content */}
-        {!showAddForm && !showBatchEditForm && (
+        {!showAddForm && !showBatchEditForm && !showSearchModal && (
           <>
-            {error && movies.length === 0 ? (
+            {error && displayMovies.length === 0 ? (
               <ErrorDisplay 
                 message={error} 
-                onRetry={loadMovies}
+                onRetry={isSearchMode ? () => handleSearchSubmit(currentSearchParams!) : loadMovies}
               />
-            ) : movies.length === 0 ? (
+            ) : displayMovies.length === 0 ? (
               <div className={movieStyles.noMovies}>
-                <p>No movies found. Make sure the Express server is running on port 3001.</p>
+                <p>
+                  {isSearchMode 
+                    ? 'No movies found matching your search criteria. Try different search terms.'
+                    : 'No movies found. Make sure the Express server is running on port 3001.'
+                  }
+                </p>
               </div>
             ) : (
               <>
                 <div className={movieStyles.moviesGrid}>
-                  {movies.map((movie) => (
+                  {displayMovies.map((movie) => (
                     <MovieCard 
                       key={movie._id} 
                       movie={movie} 
                       isSelected={selectedMovies.has(movie._id)}
                       onSelectionChange={handleMovieSelection}
-                      showCheckbox={!showAddForm && !showBatchEditForm}
+                      showCheckbox={!showAddForm && !showBatchEditForm && !showSearchModal}
                     />
                   ))}
                 </div>
                 
-                <Pagination
-                  currentPage={page}
-                  hasNextPage={hasNextPage}
-                  hasPrevPage={hasPrevPage}
-                  limit={limit}
-                />
+                {/* Show pagination based on current mode */}
+                {isSearchMode ? (
+                  <nav className={movieStyles.pagination} aria-label="Search results pagination">
+                    <div className={movieStyles.paginationContainer}>
+                      {/* Previous Button */}
+                      {searchHasPrevPage ? (
+                        <button
+                          onClick={() => handleSearchPageChange(searchPage - 1)}
+                          className={movieStyles.pageButton}
+                          disabled={isSearching}
+                          aria-label="Go to previous page"
+                        >
+                          ← Previous
+                        </button>
+                      ) : (
+                        <span className={`${movieStyles.pageButton} ${movieStyles.disabled}`}>
+                          ← Previous
+                        </span>
+                      )}
+
+                      {/* Current Page Info */}
+                      <div className={movieStyles.pageInfo}>
+                        Page {searchPage}
+                      </div>
+
+                      {/* Next Button */}
+                      {searchHasNextPage ? (
+                        <button
+                          onClick={() => handleSearchPageChange(searchPage + 1)}
+                          className={movieStyles.pageButton}
+                          disabled={isSearching}
+                          aria-label="Go to next page"
+                        >
+                          Next →
+                        </button>
+                      ) : (
+                        <span className={`${movieStyles.pageButton} ${movieStyles.disabled}`}>
+                          Next →
+                        </span>
+                      )}
+                    </div>
+
+                    {/* Additional Info */}
+                    <div className={movieStyles.additionalInfo}>
+                      {searchLimit} movies per page
+                    </div>
+                  </nav>
+                ) : (
+                  <Pagination
+                    currentPage={page}
+                    hasNextPage={hasNextPage}
+                    hasPrevPage={hasPrevPage}
+                    limit={limit}
+                  />
+                )}
               </>
             )}
           </>
diff --git a/server/express/src/controllers/movieController.ts b/server/express/src/controllers/movieController.ts
index 3e3dd59..13021b4 100644
--- a/server/express/src/controllers/movieController.ts
+++ b/server/express/src/controllers/movieController.ts
@@ -261,7 +261,7 @@ export async function createMoviesBatch(
 }
 
 /**
- * PUT /api/movies/:id
+ * PATCH /api/movies/:id
  *
  * Updates a single movie document.
  * Demonstrates the updateOne() operation.
diff --git a/server/express/src/routes/movies.ts b/server/express/src/routes/movies.ts
index c8b214c..2bb9cbf 100644
--- a/server/express/src/routes/movies.ts
+++ b/server/express/src/routes/movies.ts
@@ -54,12 +54,12 @@ router.post("/", asyncHandler(movieController.createMovie));
 router.post("/batch", asyncHandler(movieController.createMoviesBatch));
 
 /**
- * PUT /api/movies/:id
+ * PATCH /api/movies/:id
  *
  * Updates a single movie document.
  * Demonstrates the updateOne() operation.
  */
-router.put("/:id", asyncHandler(movieController.updateMovie));
+router.patch("/:id", asyncHandler(movieController.updateMovie));
 
 /**
  * PATCH /api/movies
diff --git a/server/java-spring/README.md b/server/java-spring/README.md
index cc5d69c..14cab5b 100644
--- a/server/java-spring/README.md
+++ b/server/java-spring/README.md
@@ -109,7 +109,7 @@ Once the application is running, you can access:
 - `GET /api/movies/{id}` - Get a single movie by ID
 - `POST /api/movies` - Create a new movie
 - `POST /api/movies/batch` - Create multiple movies
-- `PATCH /api/movies/{id}` - Update a movie (partial update)
+- `PATCH /api/movies/{id}` - Update a movie
 - `PATCH /api/movies` - Update multiple movies
 - `DELETE /api/movies/{id}` - Delete a movie
 - `DELETE /api/movies` - Delete multiple movies
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index 2cac95c..1ca97a9 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -166,6 +166,12 @@ public ResponseEntity<SuccessResponse<BatchInsertResponse>> createMoviesBatch(
 
         return ResponseEntity.status(HttpStatus.CREATED).body(response);
     }
+    
+    /**
+     * PATCH /api/movies/{id}
+     *
+     * <p>Updates a single movie document.
+     */
 
     @Operation(
         summary = "Update a movie by ID",
diff --git a/server/python/.env.example b/server/python/.env.example
new file mode 100644
index 0000000..363a620
--- /dev/null
+++ b/server/python/.env.example
@@ -0,0 +1,7 @@
+# MongoDB Configuration
+MONGO_URI="mongodb://localhost:27017"
+MONGO_DB="sample_mflix"
+
+# CORS Configuration
+# Comma-separated list of allowed origins for CORS
+CORS_ORIGINS="http://localhost:3000,http://localhost:3001"
\ No newline at end of file
diff --git a/server/python/main.py b/server/python/main.py
index 5af7052..c8bcdb9 100644
--- a/server/python/main.py
+++ b/server/python/main.py
@@ -1,10 +1,27 @@
 from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
 from src.routers import movies
 from src.utils.errorHandler import register_error_handlers
 from src.database.mongo_client import db, get_collection
 import traceback
+import os
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
 
 app = FastAPI()
+
+# Add CORS middleware
+cors_origins = os.getenv("CORS_ORIGINS", "http://localhost:3000,http://localhost:3001").split(",")
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=[origin.strip() for origin in cors_origins],  # Load from environment variable
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
 register_error_handlers(app)
 app.include_router(movies.router, prefix="/api/movies", tags=["movies"])
 
diff --git a/server/python/src/models/models.py b/server/python/src/models/models.py
index ce94bca..f6d5dda 100644
--- a/server/python/src/models/models.py
+++ b/server/python/src/models/models.py
@@ -97,6 +97,7 @@ class UpdateMovieRequest(BaseModel):
     poster: Optional[str]  = None  
 
 class MovieFilter(BaseModel):
+    _id: Optional[Any] = None  # Support for MongoDB ID queries like { $in: [...] }
     title: Optional[str] = None
     year: Optional[int] = None
     plot: Optional[str]  = None
@@ -111,6 +112,10 @@ class MovieFilter(BaseModel):
     runtime: Optional[int]  = None
     poster: Optional[str]  = None   
 
+class SearchMoviesResponse(BaseModel):
+    movies: list[Movie]
+    totalCount: int
+      
 class VectorSearchResult(BaseModel):
     id: Optional[str] = Field(alias="_id")
     title: str
@@ -134,6 +139,13 @@ class ErrorDetails(BaseModel):
     code: Optional[str]
     details: Optional[Any] = None
 
+class BatchUpdateRequest(BaseModel):
+    filter: MovieFilter
+    update: UpdateMovieRequest
+
+class BatchDeleteRequest(BaseModel):
+    filter: MovieFilter
+
 class ErrorResponse(BaseModel):
     success: bool = False
     message: str
diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 53730b4..021a3a7 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -1,6 +1,7 @@
-from fastapi import APIRouter, Query, Path
-from src.database.mongo_client import db, get_collection, voyage_ai_available
-from src.models.models import CreateMovieRequest, Movie, MovieFilter, SuccessResponse, UpdateMovieRequest, VectorSearchResult
+from fastapi import APIRouter, Query, Path, Body
+from src.database.mongo_client import db, get_collection
+from src.models.models import CreateMovieRequest, Movie, MovieFilter, SuccessResponse, UpdateMovieRequest, SearchMoviesResponse, BatchUpdateRequest, BatchDeleteRequest
+
 from typing import List
 from datetime import datetime
 from src.utils.errorHandler import create_success_response, create_error_response
@@ -97,11 +98,11 @@
             Must be one of "must", "should", "mustNot", or "filter". Default is "must".
 
     Returns:
-        SuccessResponse[List[Movie]]: A response object containing the list of matching movies.
+        SuccessResponse[SearchMoviesResponse]: A response object containing the list of matching movies and total count.
 """
 @router.get(
     "/search",
-    response_model=SuccessResponse[List[Movie]],
+    response_model=SuccessResponse[SearchMoviesResponse],
     status_code=200,
     summary="Search movies using MongoDB Search."
 )
@@ -114,7 +115,7 @@ async def search_movies(
     limit:int = Query(default=20, ge=1, le=100),
     skip:int = Query(default=0, ge=0),
     search_operator: str = Query(default="must")
-) -> SuccessResponse[List[Movie]]:
+) -> SuccessResponse[SearchMoviesResponse]:
     
     search_phrases = []
 
@@ -199,29 +200,37 @@ async def search_movies(
                 }
             }
         },
-        {"$skip": skip},
-        {"$limit": limit},
-
-        # Project only the fields needed in the response
         {
-            "$project": {
-                "_id": 1,
-                "title": 1,
-                "year": 1,
-                "plot": 1,
-                "fullplot": 1,
-                "released":1,
-                "runtime": 1,
-                "poster": 1,
-                "genres": 1,
-                "directors": 1,
-                "writers": 1,
-                "cast": 1,
-                "countries": 1,
-                "languages": 1,
-                "rated": 1,
-                "awards": 1,
-                "imdb": 1,
+            "$facet": {
+                "totalCount": [
+                    {"$count": "count"}
+                ],
+                "results": [
+                    {"$skip": skip},
+                    {"$limit": limit},
+                    # Project only the fields needed in the response
+                    {
+                        "$project": {
+                            "_id": 1,
+                            "title": 1,
+                            "year": 1,
+                            "plot": 1,
+                            "fullplot": 1,
+                            "released":1,
+                            "runtime": 1,
+                            "poster": 1,
+                            "genres": 1,
+                            "directors": 1,
+                            "writers": 1,
+                            "cast": 1,
+                            "countries": 1,
+                            "languages": 1,
+                            "rated": 1,
+                            "awards": 1,
+                            "imdb": 1,
+                        }
+                    }
+                ]
             }
         }
     ]
@@ -236,14 +245,21 @@ async def search_movies(
             details=str(e)
         )    
 
+    # Extract total count and movies from facet results
+    facet_result = results[0] if results else {}
+    total_count = facet_result.get("totalCount", [{}])[0].get("count", 0)
+    movies_data = facet_result.get("results", [])
     
     # Convert ObjectId to string for each movie in the results
     movies = []
-    for movie in results:
+    for movie in movies_data:
         movie["_id"] = str(movie["_id"])
         movies.append(movie)
 
-    return create_success_response(movies, f"Found {len(movies)} movies matching the search criteria.")
+    return create_success_response(
+        SearchMoviesResponse(movies=movies, totalCount=total_count), 
+        f"Found {total_count} movies matching the search criteria."
+      )
 
 #----------------------------------------------------------------------------------------------------------
 # MongoDB Vector Search
@@ -1107,24 +1123,36 @@ async def update_movie(
         summary="Batch update movies matching the given filter."
         )
 async def update_movies_batch(
-    filter: MovieFilter,
-    update: UpdateMovieRequest   
+    request_body: dict = Body(...)
 ) -> SuccessResponse[dict]:
     movies_collection = get_collection("movies")
 
-    filter_dict = filter.model_dump(exclude_unset=True, exclude_none=True)
-    update_dict = update.model_dump(exclude_unset=True, exclude_none=True)
+    # Extract filter and update from the request body
+    filter_data = request_body.get("filter", {})
+    update_data = request_body.get("update", {})
 
-    #Verify the filter and the update dicts are not empty
-    if not filter_dict or not update_dict:
+    if not filter_data or not update_data:
         return create_error_response(
             message="Both filter and update objects are required",
             code="MISSING_REQUIRED_FIELDS",
             details=None
         )
 
+    # Convert string IDs to ObjectIds if _id filter is present
+    if "_id" in filter_data and isinstance(filter_data["_id"], dict):
+        if "$in" in filter_data["_id"]:
+            # Convert list of string IDs to ObjectIds
+            try:
+                filter_data["_id"]["$in"] = [ObjectId(id_str) for id_str in filter_data["_id"]["$in"]]
+            except Exception:
+                return create_error_response(
+                    message="Invalid ObjectId format in filter",
+                    code="INVALID_OBJECT_ID",
+                    details=None
+                )
+
     try:
-        result = await movies_collection.update_many(filter_dict,{"$set": update_dict})
+        result = await movies_collection.update_many(filter_data, {"$set": update_data})
     except Exception as e:
         return create_error_response(
             message="An error occurred while updating movies.",
@@ -1210,20 +1238,35 @@ async def delete_movie_by_id(id: str):
         status_code=200,
         summary="Delete multiple movies matching the given filter."
 )
-async def delete_movies_batch(movie_filter:MovieFilter) -> SuccessResponse[dict]:
+async def delete_movies_batch(request_body: dict = Body(...)) -> SuccessResponse[dict]:
 
     movies_collection = get_collection("movies")
-    movie_filter_dict = movie_filter.model_dump(exclude_unset=True,exclude_none=True)
+    
+    # Extract filter from the request body
+    filter_data = request_body.get("filter", {})
 
-    if not movie_filter_dict:
+    if not filter_data:
         return create_error_response(
             message="Filter object is required and cannot be empty.",
             code="MISSING_FILTER",
             details=None
         )
 
+    # Convert string IDs to ObjectIds if _id filter is present
+    if "_id" in filter_data and isinstance(filter_data["_id"], dict):
+        if "$in" in filter_data["_id"]:
+            # Convert list of string IDs to ObjectIds
+            try:
+                filter_data["_id"]["$in"] = [ObjectId(id_str) for id_str in filter_data["_id"]["$in"]]
+            except Exception:
+                return create_error_response(
+                    message="Invalid ObjectId format in filter",
+                    code="INVALID_OBJECT_ID",
+                    details=None
+                )
+
     try:
-        result = await movies_collection.delete_many(movie_filter_dict)
+        result = await movies_collection.delete_many(filter_data)
     except Exception as e:
         return create_error_response(
             message="An error occurred while deleting movies.",

From f881557122b07ce3f48e2a541fe78bdc0f226a53 Mon Sep 17 00:00:00 2001
From: cory <115956901+cbullinger@users.noreply.github.com>
Date: Tue, 4 Nov 2025 20:06:24 -0500
Subject: [PATCH 054/110] Apply suggestions from code review

Co-authored-by: shuangela <angela.shu@mongodb.com>
---
 .../com/mongodb/samplemflix/config/DatabaseVerification.java    | 2 +-
 .../java/com/mongodb/samplemflix/service/MovieServiceImpl.java  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
index 9a4ba4f..26a50a7 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -270,7 +270,7 @@ private void verifyEmbeddedMoviesCollection() {
         if (sampleDoc != null && !sampleDoc.containsKey("plot_embedding_voyage_3_large")) {
             logger.warn(
                 "Documents in embedded_movies collection do not have 'plot_embedding_voyage_3_large' field. " +
-                "Vector search functionality will not work."
+                "Vector search functionality will not work. Please ensure the embedded_movies collection is populated with plot embeddings in the 'plot_embedding_voyage_3_large' field."
             );
             return;
         }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 3da1646..222b73a 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -811,7 +811,7 @@ public List<VectorSearchResult> vectorSearchMovies(String query, Integer limit)
         // Check if Voyage API key is configured
         if (voyageApiKey == null || voyageApiKey.trim().isEmpty()) {
             throw new ValidationException(
-                "Vector search unavailable: VOYAGE_API_KEY not configured. Please add your API key to application.properties"
+                "Vector search unavailable: VOYAGE_API_KEY not configured. Please add your API key to the application.properties file"
             );
         }
 

From c83ea42093e1fae34eb6cfe79487a96974558fd4 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 4 Nov 2025 21:17:57 -0500
Subject: [PATCH 055/110] fix(java): get batch and search working properly with
 frontend

---
 client/app/lib/api.ts                         | 90 +++++++++----------
 client/tsconfig.json                          | 28 ++++--
 .../config/DatabaseVerification.java          | 82 +++++++++++++++++
 .../samplemflix/config/MongoConfig.java       |  9 +-
 .../samplemflix/config/WebMvcConfig.java      | 67 ++++++++++++++
 .../controller/MovieControllerImpl.java       | 13 ++-
 .../model/dto/SearchMoviesResponse.java       | 32 +++++++
 .../samplemflix/service/MovieServiceImpl.java | 87 +++++++++++++++++-
 .../src/main/resources/application.properties |  2 +
 .../controller/MovieControllerTest.java       | 29 +++---
 10 files changed, 369 insertions(+), 70 deletions(-)
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/config/WebMvcConfig.java
 create mode 100644 server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/SearchMoviesResponse.java

diff --git a/client/app/lib/api.ts b/client/app/lib/api.ts
index 37bc7ff..02f4cb5 100644
--- a/client/app/lib/api.ts
+++ b/client/app/lib/api.ts
@@ -115,16 +115,16 @@ export async function updateMovie(id: string, updateData: Partial<Movie>): Promi
     const result = await response.json();
 
     if (!response.ok) {
-      return { 
-        success: false, 
-        error: result.error || `Failed to update movie: ${response.status}` 
+      return {
+        success: false,
+        error: result.message || result.error?.message || `Failed to update movie: ${response.status}`
       };
     }
 
     if (!result.success) {
-      return { 
-        success: false, 
-        error: result.error || 'API returned error response' 
+      return {
+        success: false,
+        error: result.message || result.error?.message || 'API returned error response'
       };
     }
 
@@ -155,16 +155,16 @@ export async function deleteMovie(id: string): Promise<{ success: boolean; error
     const result = await response.json();
 
     if (!response.ok) {
-      return { 
-        success: false, 
-        error: result.error || `Failed to delete movie: ${response.status}` 
+      return {
+        success: false,
+        error: result.message || result.error?.message || `Failed to delete movie: ${response.status}`
       };
     }
 
     if (!result.success) {
-      return { 
-        success: false, 
-        error: result.error || 'API returned error response' 
+      return {
+        success: false,
+        error: result.message || result.error?.message || 'API returned error response'
       };
     }
 
@@ -194,16 +194,16 @@ export async function createMovie(movieData: Omit<Movie, '_id'>): Promise<{ succ
     const result = await response.json();
 
     if (!response.ok) {
-      return { 
-        success: false, 
-        error: result.error || `Failed to create movie: ${response.status}` 
+      return {
+        success: false,
+        error: result.message || result.error?.message || `Failed to create movie: ${response.status}`
       };
     }
 
     if (!result.success) {
-      return { 
-        success: false, 
-        error: result.error || 'API returned error response' 
+      return {
+        success: false,
+        error: result.message || result.error?.message || 'API returned error response'
       };
     }
 
@@ -236,16 +236,16 @@ export async function createMoviesBatch(moviesData: Omit<Movie, '_id'>[]): Promi
     const result = await response.json();
 
     if (!response.ok) {
-      return { 
-        success: false, 
-        error: result.error || `Failed to create movies: ${response.status}` 
+      return {
+        success: false,
+        error: result.message || result.error?.message || `Failed to create movies: ${response.status}`
       };
     }
 
     if (!result.success) {
-      return { 
-        success: false, 
-        error: result.error || 'API returned error response' 
+      return {
+        success: false,
+        error: result.message || result.error?.message || 'API returned error response'
       };
     }
 
@@ -287,16 +287,16 @@ export async function deleteMoviesBatch(movieIds: string[]): Promise<{ success:
     const result = await response.json();
 
     if (!response.ok) {
-      return { 
-        success: false, 
-        error: result.error || `Failed to delete movies: ${response.status}` 
+      return {
+        success: false,
+        error: result.message || result.error?.message || `Failed to delete movies: ${response.status}`
       };
     }
 
     if (!result.success) {
-      return { 
-        success: false, 
-        error: result.error || 'API returned error response' 
+      return {
+        success: false,
+        error: result.message || result.error?.message || 'API returned error response'
       };
     }
 
@@ -337,16 +337,16 @@ export async function updateMoviesBatch(movieIds: string[], updateData: Partial<
     const result = await response.json();
 
     if (!response.ok) {
-      return { 
-        success: false, 
-        error: result.error || `Failed to update movies: ${response.status}` 
+      return {
+        success: false,
+        error: result.message || result.error?.message || `Failed to update movies: ${response.status}`
       };
     }
 
     if (!result.success) {
-      return { 
-        success: false, 
-        error: result.error || 'API returned error response' 
+      return {
+        success: false,
+        error: result.message || result.error?.message || 'API returned error response'
       };
     }
 
@@ -403,16 +403,16 @@ export async function searchMovies(searchParams: {
     const result = await response.json();
 
     if (!response.ok) {
-      return { 
-        success: false, 
-        error: result.error || `Failed to search movies: ${response.status}` 
+      return {
+        success: false,
+        error: result.message || result.error?.message || `Failed to search movies: ${response.status}`
       };
     }
 
     if (!result.success) {
-      return { 
-        success: false, 
-        error: result.error || 'API returned error response' 
+      return {
+        success: false,
+        error: result.message || result.error?.message || 'API returned error response'
       };
     }
 
@@ -422,8 +422,8 @@ export async function searchMovies(searchParams: {
     const hasNextPage = skip + limit < totalCount;
     const hasPrevPage = skip > 0;
 
-    return { 
-      success: true, 
+    return {
+      success: true,
       movies,
       hasNextPage,
       hasPrevPage,
@@ -436,4 +436,4 @@ export async function searchMovies(searchParams: {
       error: 'Network error occurred while searching movies' 
     };
   }
-}
\ No newline at end of file
+}
diff --git a/client/tsconfig.json b/client/tsconfig.json
index fec0bb6..ddba9b4 100644
--- a/client/tsconfig.json
+++ b/client/tsconfig.json
@@ -1,7 +1,11 @@
 {
   "compilerOptions": {
     "target": "ES2017",
-    "lib": ["dom", "dom.iterable", "esnext"],
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
     "allowJs": true,
     "skipLibCheck": true,
     "strict": true,
@@ -11,7 +15,7 @@
     "moduleResolution": "bundler",
     "resolveJsonModule": true,
     "isolatedModules": true,
-    "jsx": "preserve",
+    "jsx": "react-jsx",
     "incremental": true,
     "plugins": [
       {
@@ -19,10 +23,22 @@
       }
     ],
     "paths": {
-      "@/*": ["./app/*"],
-      "@/types/*": ["./app/types/*"]
+      "@/*": [
+        "./app/*"
+      ],
+      "@/types/*": [
+        "./app/types/*"
+      ]
     }
   },
-  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
-  "exclude": ["node_modules"]
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
 }
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
index 26a50a7..7a12310 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -41,6 +41,7 @@ public class DatabaseVerification {
     private static final String YEAR_INDEX_NAME = "year_index";
     private static final String MOVIE_ID_INDEX_NAME = "movie_id_index";
     private static final String VECTOR_INDEX_NAME = "vector_index";
+    private static final String ATLAS_SEARCH_INDEX_NAME = "movieSearchIndex";
 
     private final MongoDatabase database;
 
@@ -111,6 +112,9 @@ private void verifyMoviesCollection() {
         // Create text search index for full-text search functionality
         createTextSearchIndex(moviesCollection);
 
+        // Create Atlas Search index for advanced search functionality
+        createAtlasSearchIndex(moviesCollection);
+
         // Create year index for aggregation performance
         createYearIndex(moviesCollection);
     }
@@ -163,6 +167,84 @@ private void createTextSearchIndex(MongoCollection<Document> moviesCollection) {
         }
     }
 
+    /**
+     * Creates an Atlas Search index on the movies collection if it doesn't already exist.
+     *
+     * <p>This index enables MongoDB Atlas Search functionality across multiple fields:
+     * <ul>
+     *   <li>plot: Short movie description (phrase matching)</li>
+     *   <li>fullplot: Full movie description (phrase matching)</li>
+     *   <li>directors: Director names (fuzzy text matching)</li>
+     *   <li>writers: Writer names (fuzzy text matching)</li>
+     *   <li>cast: Actor names (fuzzy text matching)</li>
+     * </ul>
+     *
+     * <p>This is different from the text search index - Atlas Search provides more advanced
+     * search capabilities including fuzzy matching, phrase search, and compound queries.
+     *
+     * <p>Note: This index can only be created on MongoDB Atlas clusters. If running on a
+     * local MongoDB instance, this will fail gracefully with a warning.
+     *
+     * @param moviesCollection the movies collection to create the index on
+     */
+    private void createAtlasSearchIndex(MongoCollection<Document> moviesCollection) {
+        try {
+            // Check if the Atlas Search index already exists
+            boolean indexExists = false;
+            for (Document index : moviesCollection.listSearchIndexes()) {
+                if (ATLAS_SEARCH_INDEX_NAME.equals(index.getString("name"))) {
+                    indexExists = true;
+                    logger.info("Atlas Search index '{}' already exists", ATLAS_SEARCH_INDEX_NAME);
+                    break;
+                }
+            }
+
+            if (!indexExists) {
+                // Define the Atlas Search index specification
+                // This matches the Python backend's index definition
+                Document indexDefinition = new Document("mappings", new Document()
+                        .append("dynamic", false)
+                        .append("fields", new Document()
+                                .append("plot", new Document()
+                                        .append("type", "string")
+                                        .append("analyzer", "lucene.standard"))
+                                .append("fullplot", new Document()
+                                        .append("type", "string")
+                                        .append("analyzer", "lucene.standard"))
+                                .append("directors", new Document()
+                                        .append("type", "string")
+                                        .append("analyzer", "lucene.standard"))
+                                .append("writers", new Document()
+                                        .append("type", "string")
+                                        .append("analyzer", "lucene.standard"))
+                                .append("cast", new Document()
+                                        .append("type", "string")
+                                        .append("analyzer", "lucene.standard"))
+                        )
+                );
+
+                // Create the index using the createSearchIndexes command
+                Document createIndexCommand = new Document("createSearchIndexes", MOVIES_COLLECTION)
+                        .append("indexes", java.util.Collections.singletonList(
+                                new Document("name", ATLAS_SEARCH_INDEX_NAME)
+                                        .append("definition", indexDefinition)
+                        ));
+
+                database.runCommand(createIndexCommand);
+
+                logger.info("Atlas Search index '{}' created successfully. Index may take a few moments to build.", ATLAS_SEARCH_INDEX_NAME);
+                logger.info("MongoDB Atlas Search is now ready to use on the '{}' collection", MOVIES_COLLECTION);
+            }
+
+        } catch (Exception e) {
+            // This is expected to fail on non-Atlas deployments (local MongoDB, etc.)
+            logger.warn("Could not create Atlas Search index: {}", e.getMessage());
+            logger.warn("Atlas Search functionality requires a MongoDB Atlas cluster.");
+            logger.warn("If you're using Atlas, the index may already exist or there may be a permissions issue.");
+            logger.warn("Search endpoint (/api/movies/search) will not work without this index.");
+        }
+    }
+
     /**
      * Creates an index on the year field for the movies collection.
      *
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
index 32b3e16..cea4b0b 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
@@ -66,9 +66,11 @@ protected void configureClientSettings(MongoClientSettings.Builder builder) {
                 // Configure connection pool for optimal performance
                 .applyToConnectionPoolSettings(poolBuilder ->
                     poolBuilder.maxSize(100)                                    // Maximum connections in pool
-                           .minSize(10)                                         // Minimum connections to maintain
+                           .minSize(5)                                          // Minimum connections to maintain (reduced from 10)
                            .maxConnectionIdleTime(60000, TimeUnit.MILLISECONDS) // Release idle connections after 60s
                            .maxWaitTime(10000, TimeUnit.MILLISECONDS)           // Wait up to 10s for available connection
+                           .maintenanceInitialDelay(0, TimeUnit.MILLISECONDS)   // Start maintenance immediately
+                           .maintenanceFrequency(60000, TimeUnit.MILLISECONDS)  // Run maintenance every 60s
                 )
                 // Configure socket timeouts to prevent hanging connections
                 .applyToSocketSettings(socketBuilder ->
@@ -78,7 +80,10 @@ protected void configureClientSettings(MongoClientSettings.Builder builder) {
                 // Configure server selection timeout
                 .applyToClusterSettings(clusterBuilder ->
                     clusterBuilder.serverSelectionTimeout(10000, TimeUnit.MILLISECONDS)  // 10s to select server
-                );
+                )
+                // Retry writes for better reliability
+                .retryWrites(true)
+                .retryReads(true);
     }
 
     /**
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/WebMvcConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/WebMvcConfig.java
new file mode 100644
index 0000000..44d4c5d
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/WebMvcConfig.java
@@ -0,0 +1,67 @@
+package com.mongodb.samplemflix.config;
+
+import jakarta.servlet.FilterChain;
+import jakarta.servlet.ServletException;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletResponse;
+import java.io.IOException;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.http.HttpStatus;
+import org.springframework.lang.NonNull;
+import org.springframework.web.filter.OncePerRequestFilter;
+import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
+
+/**
+ * Web MVC configuration for the Sample MFlix API.
+ *
+ * <p>This configuration customizes Spring MVC behavior, including:
+ * <ul>
+ *   <li>Trailing slash handling via custom filter</li>
+ * </ul>
+ */
+@Configuration
+public class WebMvcConfig implements WebMvcConfigurer {
+
+    /**
+     * Filter to handle trailing slashes in URLs.
+     *
+     * <p>This filter redirects URLs with trailing slashes to their non-trailing slash equivalents
+     * using HTTP 308 (Permanent Redirect) to maintain the HTTP method.
+     *
+     * <p>For example:
+     * <ul>
+     *   <li>POST /api/movies/ → redirects to POST /api/movies</li>
+     *   <li>GET /api/movies/ → redirects to GET /api/movies</li>
+     * </ul>
+     */
+    @org.springframework.stereotype.Component
+    public static class TrailingSlashRedirectFilter extends OncePerRequestFilter {
+
+        @Override
+        protected void doFilterInternal(
+                @NonNull HttpServletRequest request,
+                @NonNull HttpServletResponse response,
+                @NonNull FilterChain filterChain
+        ) throws ServletException, IOException {
+            String requestUri = request.getRequestURI();
+
+            // If URL ends with trailing slash (but not root "/"), redirect to URL without it
+            if (requestUri.length() > 1 && requestUri.endsWith("/")) {
+                String newUrl = requestUri.substring(0, requestUri.length() - 1);
+
+                // Preserve query string if present
+                String queryString = request.getQueryString();
+                if (queryString != null) {
+                    newUrl += "?" + queryString;
+                }
+
+                // Use 308 Permanent Redirect to preserve the HTTP method (POST, PATCH, DELETE, etc.)
+                response.setStatus(HttpStatus.PERMANENT_REDIRECT.value());
+                response.setHeader("Location", newUrl);
+                return;
+            }
+
+            filterChain.doFilter(request, response);
+        }
+    }
+}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index d0495e4..19ea26b 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -9,6 +9,7 @@
 import com.mongodb.samplemflix.model.dto.MovieSearchQuery;
 import com.mongodb.samplemflix.model.dto.MovieWithCommentsResult;
 import com.mongodb.samplemflix.model.dto.MoviesByYearResult;
+import com.mongodb.samplemflix.model.dto.SearchMoviesResponse;
 import com.mongodb.samplemflix.model.dto.UpdateMovieRequest;
 import com.mongodb.samplemflix.model.dto.VectorSearchResult;
 import com.mongodb.samplemflix.model.response.SuccessResponse;
@@ -379,7 +380,7 @@ public ResponseEntity<SuccessResponse<List<DirectorStatisticsResult>>> getDirect
                      "Plot and fullplot use phrase operator for exact matching, while directors, writers, and cast use text operator with fuzzy matching."
     )
     @GetMapping("/search")
-    public ResponseEntity<SuccessResponse<List<Movie>>> searchMovies(
+    public ResponseEntity<SuccessResponse<SearchMoviesResponse>> searchMovies(
             @Parameter(description = "Text to search in the plot field (phrase matching)")
             @RequestParam(required = false) String plot,
             @Parameter(description = "Text to search in the fullplot field (phrase matching)")
@@ -411,10 +412,16 @@ public ResponseEntity<SuccessResponse<List<Movie>>> searchMovies(
 
         List<Movie> movies = movieService.searchMovies(searchRequest);
 
-        SuccessResponse<List<Movie>> response = SuccessResponse.<List<Movie>>builder()
+        // Wrap results in SearchMoviesResponse to match Python backend structure
+        SearchMoviesResponse searchResponse = SearchMoviesResponse.builder()
+                .movies(movies)
+                .totalCount(movies.size())
+                .build();
+
+        SuccessResponse<SearchMoviesResponse> response = SuccessResponse.<SearchMoviesResponse>builder()
                 .success(true)
                 .message(String.format("Found %d movies matching the search criteria", movies.size()))
-                .data(movies)
+                .data(searchResponse)
                 .timestamp(Instant.now().toString())
                 .build();
 
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/SearchMoviesResponse.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/SearchMoviesResponse.java
new file mode 100644
index 0000000..8dd2343
--- /dev/null
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/SearchMoviesResponse.java
@@ -0,0 +1,32 @@
+package com.mongodb.samplemflix.model.dto;
+
+import com.mongodb.samplemflix.model.Movie;
+import java.util.List;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Response wrapper for movie search results.
+ *
+ * <p>This DTO wraps the search results with pagination metadata,
+ * matching the structure returned by the Python backend.
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class SearchMoviesResponse {
+    
+    /**
+     * List of movies matching the search criteria.
+     */
+    private List<Movie> movies;
+    
+    /**
+     * Total count of movies matching the search criteria.
+     */
+    private Integer totalCount;
+}
+
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 222b73a..6248fa9 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -202,7 +202,10 @@ public BatchUpdateResponse updateMoviesBatch(Document filter, Document update) {
 
         // Convert Document filter to Spring Data Query
         Query query = new Query();
-        filter.forEach((key, value) -> query.addCriteria(Criteria.where(key).is(value)));
+        filter.forEach((key, value) -> {
+            Criteria criteria = buildCriteriaFromValue(key, value);
+            query.addCriteria(criteria);
+        });
 
         // Convert Document update to Spring Data Update
         Update mongoUpdate = new Update();
@@ -242,7 +245,10 @@ public DeleteResponse deleteMoviesBatch(Document filter) {
 
         // Convert Document filter to Spring Data Query
         Query query = new Query();
-        filter.forEach((key, value) -> query.addCriteria(Criteria.where(key).is(value)));
+        filter.forEach((key, value) -> {
+            Criteria criteria = buildCriteriaFromValue(key, value);
+            query.addCriteria(criteria);
+        });
 
         DeleteResult result = mongoTemplate.remove(query, Movie.class);
 
@@ -915,4 +921,81 @@ private List<Double> generateVoyageEmbedding(String text, String apiKey) throws
 
         return embedding;
     }
+
+    /**
+     * Builds a Spring Data Criteria from a filter key-value pair.
+     * Handles MongoDB query operators like $in, $gt, $lt, etc.
+     *
+     * @param key The field name (e.g., "_id")
+     * @param value The filter value (can be a simple value or a Document with operators)
+     * @return Criteria object for the query
+     */
+    @SuppressWarnings("unchecked")
+    private Criteria buildCriteriaFromValue(String key, Object value) {
+        Criteria criteria = Criteria.where(key);
+
+        // If value is a Document (Map), it might contain MongoDB operators
+        if (value instanceof Map) {
+            Map<String, Object> operatorMap = (Map<String, Object>) value;
+
+            // Handle each MongoDB operator
+            for (Map.Entry<String, Object> entry : operatorMap.entrySet()) {
+                String operator = entry.getKey();
+                Object operatorValue = entry.getValue();
+
+                switch (operator) {
+                    case "$in":
+                        // Convert string IDs to ObjectIds if the field is _id
+                        if ("_id".equals(key) && operatorValue instanceof List) {
+                            List<?> values = (List<?>) operatorValue;
+                            List<ObjectId> objectIds = values.stream()
+                                    .map(id -> new ObjectId(id.toString()))
+                                    .collect(Collectors.toList());
+                            criteria = criteria.in(objectIds);
+                        } else {
+                            criteria = criteria.in((List<?>) operatorValue);
+                        }
+                        break;
+                    case "$nin":
+                        criteria = criteria.nin((List<?>) operatorValue);
+                        break;
+                    case "$gt":
+                        criteria = criteria.gt(operatorValue);
+                        break;
+                    case "$gte":
+                        criteria = criteria.gte(operatorValue);
+                        break;
+                    case "$lt":
+                        criteria = criteria.lt(operatorValue);
+                        break;
+                    case "$lte":
+                        criteria = criteria.lte(operatorValue);
+                        break;
+                    case "$ne":
+                        criteria = criteria.ne(operatorValue);
+                        break;
+                    case "$regex":
+                        criteria = criteria.regex(operatorValue.toString());
+                        break;
+                    case "$exists":
+                        criteria = criteria.exists((Boolean) operatorValue);
+                        break;
+                    default:
+                        // For unknown operators, use the value as-is
+                        criteria = criteria.is(value);
+                        break;
+                }
+            }
+        } else {
+            // Simple equality check
+            // Convert string ID to ObjectId if the field is _id
+            if ("_id".equals(key) && value instanceof String) {
+                criteria = criteria.is(new ObjectId(value.toString()));
+            } else {
+                criteria = criteria.is(value);
+            }
+        }
+
+        return criteria;
+    }
 }
diff --git a/server/java-spring/src/main/resources/application.properties b/server/java-spring/src/main/resources/application.properties
index d226e25..58b8785 100644
--- a/server/java-spring/src/main/resources/application.properties
+++ b/server/java-spring/src/main/resources/application.properties
@@ -21,6 +21,8 @@ spring.application.name=sample-app-java-mflix
 # Logging Configuration
 logging.level.com.mongodb.samplemflix=INFO
 logging.level.org.mongodb.driver=WARN
+# Suppress connection pool maintenance warnings (these are usually harmless)
+logging.level.org.mongodb.driver.connection=ERROR
 
 # Jackson Configuration (JSON serialization)
 spring.jackson.default-property-inclusion=non_null
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
index 2ee4b3a..acc1542 100644
--- a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
+++ b/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
@@ -536,11 +536,12 @@ void testSearchMoviesByPlot_Success() throws Exception {
                         .param("plot", "space adventure"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.success").value(true))
-                .andExpect(jsonPath("$.data").isArray())
-                .andExpect(jsonPath("$.data", hasSize(2)))
-                .andExpect(jsonPath("$.data[0].title").value("Space Adventure"))
-                .andExpect(jsonPath("$.data[0].plot").value(containsString("space adventure")))
-                .andExpect(jsonPath("$.data[1].title").value("Space Quest"));
+                .andExpect(jsonPath("$.data.movies").isArray())
+                .andExpect(jsonPath("$.data.movies", hasSize(2)))
+                .andExpect(jsonPath("$.data.totalCount").value(2))
+                .andExpect(jsonPath("$.data.movies[0].title").value("Space Adventure"))
+                .andExpect(jsonPath("$.data.movies[0].plot").value(containsString("space adventure")))
+                .andExpect(jsonPath("$.data.movies[1].title").value("Space Quest"));
     }
 
     @Test
@@ -557,7 +558,8 @@ void testSearchMoviesByPlot_WithPagination() throws Exception {
                         .param("skip", "5"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.success").value(true))
-                .andExpect(jsonPath("$.data").isArray());
+                .andExpect(jsonPath("$.data.movies").isArray())
+                .andExpect(jsonPath("$.data.totalCount").value(0));
     }
 
     @Test
@@ -601,8 +603,9 @@ void testSearchMoviesByPlot_NoResults() throws Exception {
                         .param("plot", "nonexistent"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.success").value(true))
-                .andExpect(jsonPath("$.data").isArray())
-                .andExpect(jsonPath("$.data", hasSize(0)));
+                .andExpect(jsonPath("$.data.movies").isArray())
+                .andExpect(jsonPath("$.data.movies", hasSize(0)))
+                .andExpect(jsonPath("$.data.totalCount").value(0));
     }
 
     @Test
@@ -627,9 +630,10 @@ void testSearchMovies_MultipleFields() throws Exception {
                         .param("cast", "Pacino"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.success").value(true))
-                .andExpect(jsonPath("$.data").isArray())
-                .andExpect(jsonPath("$.data", hasSize(1)))
-                .andExpect(jsonPath("$.data[0].title").value("The Godfather"));
+                .andExpect(jsonPath("$.data.movies").isArray())
+                .andExpect(jsonPath("$.data.movies", hasSize(1)))
+                .andExpect(jsonPath("$.data.totalCount").value(1))
+                .andExpect(jsonPath("$.data.movies[0].title").value("The Godfather"));
     }
 
     @Test
@@ -645,7 +649,8 @@ void testSearchMovies_WithSearchOperator() throws Exception {
                         .param("searchOperator", "should"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.success").value(true))
-                .andExpect(jsonPath("$.data").isArray());
+                .andExpect(jsonPath("$.data.movies").isArray())
+                .andExpect(jsonPath("$.data.totalCount").value(0));
     }
 
     @Test

From 7567f4262af2be05fc91af027a703d73878b594a Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Tue, 4 Nov 2025 21:33:24 -0500
Subject: [PATCH 056/110] docs: clean up TODOs in README

---
 mflix/README-JAVA-SPRING.md                   | 136 ++++++++-
 server/java-spring/README.md                  | 259 ------------------
 .../config/DatabaseVerification.java          |  36 +--
 .../resources/application-test.properties     |   6 +-
 4 files changed, 148 insertions(+), 289 deletions(-)
 delete mode 100644 server/java-spring/README.md

diff --git a/mflix/README-JAVA-SPRING.md b/mflix/README-JAVA-SPRING.md
index 19db73d..17bf602 100644
--- a/mflix/README-JAVA-SPRING.md
+++ b/mflix/README-JAVA-SPRING.md
@@ -1,16 +1,142 @@
 # Java Spring Boot MongoDB Sample MFlix Application
 
-[TODO: Add intro]
+This is a full-stack movie browsing application built with Java Spring Boot and Next.js, demonstrating MongoDB operations using the `sample_mflix` dataset. The application showcases CRUD operations, aggregations, and MongoDB Search using Spring Data MongoDB.
+
+## Project Structure
 
 ```
-├── README.md
-├── client/     # Next.js frontend
-└── server/     # Java Spring backend
+├── README-JAVA-SPRING.md
+├── client/                 # Next.js frontend (TypeScript)
+└── server/java-spring/     # Java Spring Boot backend
+    ├── src/
+    ├── pom.xml
+    ├── .env.example
+    └── mvnw
 ```
 
+## Prerequisites
+
+- **Java 21** or higher
+- **Node.js 20** or higher
+- **MongoDB Atlas account** with the `sample_mflix` dataset loaded
+  - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/) in your Atlas cluster
+- **Maven** (included via Maven Wrapper)
+
 ## Getting Started
 
-[TODO: Add getting started instructions explaining how to set connection string, start server, start client, etc.]
+### 1. Configure the Backend
+
+Navigate to the Java Spring server directory:
+
+```bash
+cd server/java-spring
+```
+
+Create a `.env` file from the example:
+
+```bash
+cp .env.example .env
+```
+
+Edit the `.env` file and set your MongoDB connection string:
+
+```env
+# MongoDB Connection
+MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/?retryWrites=true&w=majority
+
+# Server Configuration
+PORT=3001
+
+# CORS Configuration
+CORS_ORIGIN=http://localhost:3000
+```
+
+**Note:** Replace `username`, `password`, and `cluster` with your actual MongoDB Atlas credentials.
+
+### 2. Start the Backend Server
+
+From the `server/java-spring` directory, run:
+
+```bash
+# Using Maven Wrapper (recommended)
+./mvnw spring-boot:run
+
+# Or on Windows
+mvnw.cmd spring-boot:run
+```
+
+The server will start on `http://localhost:3001`. You can verify it's running by visiting:
+- API root: http://localhost:3001/
+- API documentation (Swagger UI): http://localhost:3001/swagger-ui.html
+
+### 3. Configure and Start the Frontend
+
+Open a new terminal and navigate to the client directory:
+
+```bash
+cd client
+```
+
+Install dependencies:
+
+```bash
+npm install
+```
+
+Start the development server:
+
+```bash
+npm run dev
+```
+
+The Next.js application will start on `http://localhost:3000`.
+
+### 4. Access the Application
+
+Open your browser and navigate to:
+- **Frontend:** http://localhost:3000
+- **Backend API:** http://localhost:3001
+- **API Documentation:** http://localhost:3001/swagger-ui.html
+
+## Features
+
+- **Browse Movies:** View a paginated list of movies from the sample_mflix dataset
+- **Search:** Full-text search using MongoDB Search
+- **Filter:** Filter movies by genre, year, rating, and more
+- **Movie Details:** View detailed information about each movie
+- **Aggregations:** Complex data aggregations and analytics
+
+## Development
+
+### Backend Development
+
+The Java Spring Boot backend uses:
+- **Spring Data MongoDB** for database operations
+- **Spring Boot Web** for REST API
+- **SpringDoc OpenAPI** for API documentation
+- **Maven** for dependency management
+
+To run tests:
+
+```bash
+cd server/java-spring
+./mvnw test
+```
+
+### Frontend Development
+
+The Next.js frontend uses:
+- **React 19** with TypeScript
+- **Next.js 16** with App Router
+- **Turbopack** for fast development builds
+
+To build for production:
+
+```bash
+cd client
+npm run build
+npm start
+```
 
 ## Issues
 
diff --git a/server/java-spring/README.md b/server/java-spring/README.md
deleted file mode 100644
index 14cab5b..0000000
--- a/server/java-spring/README.md
+++ /dev/null
@@ -1,259 +0,0 @@
-# sample-app-java-mflix (INTERNAL)
-
-A Spring Boot REST API demonstrating MongoDB CRUD operations using Spring Data MongoDB with the sample_mflix database.
-
-## Overview
-
-This application provides a REST API for managing movie data from MongoDB's sample_mflix database. It demonstrates:
-
-- Spring Data MongoDB for simplified data access
-- CRUD operations (Create, Read, Update, Delete)
-- MongoDB Atlas Search with multi-field search and compound operators
-- Filtering, sorting, and pagination
-- Comprehensive error handling
-- API documentation with Swagger/OpenAPI
-- MongoTemplate for complex queries and aggregation pipelines
-
-## Prerequisites
-
-- Java 21 or later
-- Maven 3.6 or later
-- MongoDB Atlas account or local MongoDB instance with sample_mflix database
-
-## Project Structure
-
-```
-server/java-spring/
-├── src/
-│   ├── main/
-│   │   ├── java/com/mongodb/samplemflix/
-│   │   │   ├── SampleMflixApplication.java    # Main application class
-│   │   │   ├── config/                         # Configuration classes
-│   │   │   │   ├── MongoConfig.java           # MongoDB client configuration
-│   │   │   │   ├── CorsConfig.java            # CORS configuration
-│   │   │   │   └── DatabaseVerification.java  # Startup database verification
-│   │   │   ├── controller/                     # REST controllers
-│   │   │   ├── service/                        # Business logic layer
-│   │   │   ├── repository/                     # Data access layer
-│   │   │   ├── model/                          # Domain models and DTOs
-│   │   │   ├── exception/                      # Custom exceptions
-│   │   │   └── util/                           # Utility classes
-│   │   └── resources/
-│   │       └── application.properties          # Application configuration
-│   └── test/                                   # Test classes
-├── pom.xml                                     # Maven dependencies
-└── README.md
-```
-
-## Setup Instructions
-
-### 1. Clone the Repository
-
-```bash
-git clone <repository-url>
-cd server/java-spring
-```
-
-### 2. Configure Environment Variables
-
-Copy the example environment file and update with your MongoDB connection details:
-
-```bash
-cp .env.example .env
-```
-
-Edit `.env` and set your MongoDB connection string:
-
-```properties
-MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/?retryWrites=true&w=majority
-PORT=3001
-CORS_ORIGIN=http://localhost:3000
-```
-
-> **Note**: This project uses [spring-dotenv](https://github.com/paulschwarz/spring-dotenv) to automatically load `.env` files, similar to Node.js applications. The `.env` file will be loaded automatically when you run the application.
-
-### 3. Load Sample Data
-
-If you haven't already, load the `sample_mflix` database into your MongoDB instance:
-
-- **MongoDB Atlas**: Use the "Load Sample Dataset" option in your cluster
-- **Local MongoDB**: Follow the [MongoDB sample data documentation](https://www.mongodb.com/docs/atlas/sample-data/)
-
-### 4. Build the Project
-
-```bash
-mvn clean install
-```
-
-### 5. Run the Application
-
-```bash
-mvn spring-boot:run
-```
-
-The application will start on `http://localhost:3001` (or the port specified in your `.env` file).
-
-## API Documentation
-
-Once the application is running, you can access:
-
-- **Swagger UI**: http://localhost:3001/swagger-ui.html
-- **OpenAPI JSON**: http://localhost:3001/api-docs
-
-## API Endpoints
-
-### Movies (✅ Implemented)
-
-#### CRUD Operations
-- `GET /api/movies` - Get all movies (with filtering, sorting, pagination)
-- `GET /api/movies/{id}` - Get a single movie by ID
-- `POST /api/movies` - Create a new movie
-- `POST /api/movies/batch` - Create multiple movies
-- `PATCH /api/movies/{id}` - Update a movie
-- `PATCH /api/movies` - Update multiple movies
-- `DELETE /api/movies/{id}` - Delete a movie
-- `DELETE /api/movies` - Delete multiple movies
-- `DELETE /api/movies/{id}/find-and-delete` - Find and delete a movie
-
-#### Aggregations
-- `GET /api/movies/aggregations/comments` - Get movies with most comments
-- `GET /api/movies/aggregations/years` - Aggregate movies by year with statistics
-- `GET /api/movies/aggregations/directors` - Aggregate directors with most movies
-
-#### Atlas Search
-- `GET /api/movies/search` - Search movies using MongoDB Atlas Search
-
-  **Query Parameters:**
-  - `plot` (optional) - Search in plot field using phrase matching
-  - `fullplot` (optional) - Search in fullplot field using phrase matching
-  - `directors` (optional) - Search in directors field with fuzzy matching
-  - `writers` (optional) - Search in writers field with fuzzy matching
-  - `cast` (optional) - Search in cast field with fuzzy matching
-  - `searchOperator` (optional) - Compound operator: `must` (default), `should`, `mustNot`, `filter`
-  - `limit` (optional) - Maximum results to return (default: 20, max: 100)
-  - `skip` (optional) - Number of results to skip for pagination (default: 0)
-
-  **Examples:**
-  ```bash
-  # Search by plot
-  GET /api/movies/search?plot=space+adventure
-
-  # Search by multiple fields with AND logic
-  GET /api/movies/search?directors=Coppola&cast=Pacino&searchOperator=must
-
-  # Search by multiple fields with OR logic
-  GET /api/movies/search?plot=crime&directors=Scorsese&searchOperator=should
-
-  # Search with pagination
-  GET /api/movies/search?cast=Tom+Hanks&limit=10&skip=20
-  ```
-
-  **Note:** At least one search field must be provided. The `searchOperator` determines how multiple search criteria are combined:
-  - `must` - All criteria must match (AND logic)
-  - `should` - At least one criterion should match (OR logic)
-  - `mustNot` - Criteria must not match (NOT logic)
-  - `filter` - Criteria must match but don't affect scoring
-
-#### Vector Search
-- `GET /api/movies/find-similar-movies` - Find similar movies using vector search on plot embeddings
-
-## Development
-
-### Running Tests
-
-```bash
-# Run all tests
-mvn test
-
-# Run tests with coverage
-mvn test jacoco:report
-```
-
-### Building for Production
-
-```bash
-mvn clean package
-java -jar target/sample-mflix-spring-1.0.0.jar
-```
-
-## Implementation Status
-
-### Completed Features
-
-- **Movies CRUD API** - Full create, read, update, delete operations
-- **Spring Data MongoDB** - Repository pattern with MongoTemplate for complex queries
-- **MongoDB Atlas Search** - Multi-field search with compound operators (must, should, mustNot, filter)
-  - Phrase matching on plot and fullplot fields
-  - Fuzzy text matching on directors, writers, and cast fields
-  - Support for complex search queries with multiple criteria
-- **MongoDB Aggregations** - Statistical aggregations by year, directors, and comments
-- **Vector Search** - Find similar movies using plot embeddings (requires Atlas Vector Search)
-- **Filtering & Pagination** - Query parameters for filtering, sorting, and pagination
-- **Custom Exception Handling** - Global exception handler with proper HTTP status codes
-- **Type-Safe DTOs** - Specific response types instead of generic Maps
-- **Comprehensive Testing** - 60 tests covering service, controller, and integration layers
-  - 29 controller unit tests
-  - 27 service unit tests
-  - 4 Atlas Search integration tests (requires Atlas cluster)
-- **OpenAPI Documentation** - Swagger UI available at `/swagger-ui.html`
-- **Database Verification** - Startup checks for database connectivity and indexes
-
-
-## Technology Stack
-
-- **Framework**: Spring Boot 3.5.7
-- **Java Version**: 21
-- **MongoDB**: Spring Data MongoDB 4.5.5
-- **Build Tool**: Maven
-- **API Documentation**: SpringDoc OpenAPI 2.8.13
-- **Testing**: JUnit 5, Mockito, Spring Boot Test
-
-## Educational Purpose
-
-This application is designed as an educational sample to demonstrate:
-
-1. How to use Spring Data MongoDB for simplified data access
-2. Best practices for Spring Boot REST API development
-3. Proper separation of concerns (Controller → Service → Repository)
-4. MongoDB CRUD operations and query patterns
-5. **MongoDB Atlas Search** - Multi-field text search with compound operators
-   - Phrase matching for exact phrase searches
-   - Fuzzy text matching for typo-tolerant searches
-   - Compound operators (must, should, mustNot, filter) for complex queries
-6. **MongoDB Aggregation Pipelines** - Statistical aggregations and data transformations
-7. **Vector Search** - Semantic similarity search using embeddings
-8. Error handling and validation in Spring Boot
-9. Using MongoTemplate for complex queries alongside Spring Data repositories
-10. Comprehensive testing strategies (unit tests, integration tests)
-
-## Troubleshooting
-
-### Connection Issues
-
-If you encounter connection issues:
-
-1. Verify your `MONGODB_URI` is correct
-2. Check that your IP address is whitelisted in MongoDB Atlas
-3. Ensure the sample_mflix database exists and contains data
-4. Check the application logs for detailed error messages
-
-### Build Issues
-
-If Maven build fails:
-
-1. Ensure you have Java 21 or later installed: `java -version`
-2. Ensure Maven is installed: `mvn -version`
-3. Clear Maven cache: `mvn clean`
-4. Try rebuilding: `mvn clean install`
-
-## License
-
-[TBD]
-
-## Contributing
-
-[TBD]
-
-## Issues
-
-[TBD]
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
index 7a12310..cb3368f 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -41,7 +41,7 @@ public class DatabaseVerification {
     private static final String YEAR_INDEX_NAME = "year_index";
     private static final String MOVIE_ID_INDEX_NAME = "movie_id_index";
     private static final String VECTOR_INDEX_NAME = "vector_index";
-    private static final String ATLAS_SEARCH_INDEX_NAME = "movieSearchIndex";
+    private static final String MONGODB_SEARCH_INDEX_NAME = "movieSearchIndex";
 
     private final MongoDatabase database;
 
@@ -112,8 +112,8 @@ private void verifyMoviesCollection() {
         // Create text search index for full-text search functionality
         createTextSearchIndex(moviesCollection);
 
-        // Create Atlas Search index for advanced search functionality
-        createAtlasSearchIndex(moviesCollection);
+        // Create MongoDB Search index for advanced search functionality
+        createMongoDBSearchIndex(moviesCollection);
 
         // Create year index for aggregation performance
         createYearIndex(moviesCollection);
@@ -168,9 +168,9 @@ private void createTextSearchIndex(MongoCollection<Document> moviesCollection) {
     }
 
     /**
-     * Creates an Atlas Search index on the movies collection if it doesn't already exist.
+     * Creates a MongoDB Search index on the movies collection if it doesn't already exist.
      *
-     * <p>This index enables MongoDB Atlas Search functionality across multiple fields:
+     * <p>This index enables MongoDB Search functionality across multiple fields:
      * <ul>
      *   <li>plot: Short movie description (phrase matching)</li>
      *   <li>fullplot: Full movie description (phrase matching)</li>
@@ -179,29 +179,25 @@ private void createTextSearchIndex(MongoCollection<Document> moviesCollection) {
      *   <li>cast: Actor names (fuzzy text matching)</li>
      * </ul>
      *
-     * <p>This is different from the text search index - Atlas Search provides more advanced
+     * <p>This is different from the text search index - MongoDB Search provides more advanced
      * search capabilities including fuzzy matching, phrase search, and compound queries.
      *
-     * <p>Note: This index can only be created on MongoDB Atlas clusters. If running on a
-     * local MongoDB instance, this will fail gracefully with a warning.
-     *
      * @param moviesCollection the movies collection to create the index on
      */
-    private void createAtlasSearchIndex(MongoCollection<Document> moviesCollection) {
+    private void createMongoDBSearchIndex(MongoCollection<Document> moviesCollection) {
         try {
-            // Check if the Atlas Search index already exists
+            // Check if the Search index already exists
             boolean indexExists = false;
             for (Document index : moviesCollection.listSearchIndexes()) {
-                if (ATLAS_SEARCH_INDEX_NAME.equals(index.getString("name"))) {
+                if (MONGODB_SEARCH_INDEX_NAME.equals(index.getString("name"))) {
                     indexExists = true;
-                    logger.info("Atlas Search index '{}' already exists", ATLAS_SEARCH_INDEX_NAME);
+                    logger.info("MongoDB Search index '{}' already exists", MONGODB_SEARCH_INDEX_NAME);
                     break;
                 }
             }
 
             if (!indexExists) {
-                // Define the Atlas Search index specification
-                // This matches the Python backend's index definition
+                // Define the MongoDB Search index specification
                 Document indexDefinition = new Document("mappings", new Document()
                         .append("dynamic", false)
                         .append("fields", new Document()
@@ -226,20 +222,18 @@ private void createAtlasSearchIndex(MongoCollection<Document> moviesCollection)
                 // Create the index using the createSearchIndexes command
                 Document createIndexCommand = new Document("createSearchIndexes", MOVIES_COLLECTION)
                         .append("indexes", java.util.Collections.singletonList(
-                                new Document("name", ATLAS_SEARCH_INDEX_NAME)
+                                new Document("name", MONGODB_SEARCH_INDEX_NAME)
                                         .append("definition", indexDefinition)
                         ));
 
                 database.runCommand(createIndexCommand);
 
-                logger.info("Atlas Search index '{}' created successfully. Index may take a few moments to build.", ATLAS_SEARCH_INDEX_NAME);
-                logger.info("MongoDB Atlas Search is now ready to use on the '{}' collection", MOVIES_COLLECTION);
+                logger.info("MongoDB Search index '{}' created successfully. Index may take a few moments to build.", MONGODB_SEARCH_INDEX_NAME);
+                logger.info("MongoDB Search is now ready to use on the '{}' collection", MOVIES_COLLECTION);
             }
 
         } catch (Exception e) {
-            // This is expected to fail on non-Atlas deployments (local MongoDB, etc.)
-            logger.warn("Could not create Atlas Search index: {}", e.getMessage());
-            logger.warn("Atlas Search functionality requires a MongoDB Atlas cluster.");
+            logger.warn("Could not create MongoDB Search index: {}", e.getMessage());
             logger.warn("If you're using Atlas, the index may already exist or there may be a permissions issue.");
             logger.warn("Search endpoint (/api/movies/search) will not work without this index.");
         }
diff --git a/server/java-spring/src/test/resources/application-test.properties b/server/java-spring/src/test/resources/application-test.properties
index 1b2669c..bb3103e 100644
--- a/server/java-spring/src/test/resources/application-test.properties
+++ b/server/java-spring/src/test/resources/application-test.properties
@@ -1,9 +1,8 @@
-# Test Configuration for MongoDB Atlas Search Integration Tests
+# Test Configuration for MongoDB Search Integration Tests
 # This configuration is used when running integration tests with @ActiveProfiles("test")
 
 # MongoDB Configuration
-# For Atlas Search tests, use the same MONGODB_URI as the main application
-# This should point to a MongoDB Atlas cluster (not local MongoDB)
+# For MongoDB Search tests, use the same MONGODB_URI as the main application
 spring.data.mongodb.uri=${MONGODB_URI}
 spring.data.mongodb.database=sample_mflix
 
@@ -20,4 +19,3 @@ logging.level.org.springframework.data.mongodb=DEBUG
 # Test-specific settings
 # Disable some startup checks that may not be needed in tests
 spring.main.lazy-initialization=false
-

From eff6b99781f05dce2fcad76028b47bf221bea89f Mon Sep 17 00:00:00 2001
From: cory <115956901+cbullinger@users.noreply.github.com>
Date: Wed, 5 Nov 2025 08:35:51 -0500
Subject: [PATCH 057/110] Update
 server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java

Co-authored-by: Jordan Smith <45415425+jordan-smith721@users.noreply.github.com>
---
 .../main/java/com/mongodb/samplemflix/config/MongoConfig.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
index cea4b0b..97ae854 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
@@ -66,7 +66,7 @@ protected void configureClientSettings(MongoClientSettings.Builder builder) {
                 // Configure connection pool for optimal performance
                 .applyToConnectionPoolSettings(poolBuilder ->
                     poolBuilder.maxSize(100)                                    // Maximum connections in pool
-                           .minSize(5)                                          // Minimum connections to maintain (reduced from 10)
+                           .minSize(5)                                          // Minimum connections to maintain
                            .maxConnectionIdleTime(60000, TimeUnit.MILLISECONDS) // Release idle connections after 60s
                            .maxWaitTime(10000, TimeUnit.MILLISECONDS)           // Wait up to 10s for available connection
                            .maintenanceInitialDelay(0, TimeUnit.MILLISECONDS)   // Start maintenance immediately

From 452b5fd0ab692c1c2251c2c6818bbbf8d69e87e0 Mon Sep 17 00:00:00 2001
From: cory <115956901+cbullinger@users.noreply.github.com>
Date: Wed, 5 Nov 2025 08:35:56 -0500
Subject: [PATCH 058/110] Update
 server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java

Co-authored-by: Jordan Smith <45415425+jordan-smith721@users.noreply.github.com>
---
 .../com/mongodb/samplemflix/controller/MovieControllerImpl.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index 19ea26b..5a9c638 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -412,7 +412,7 @@ public ResponseEntity<SuccessResponse<SearchMoviesResponse>> searchMovies(
 
         List<Movie> movies = movieService.searchMovies(searchRequest);
 
-        // Wrap results in SearchMoviesResponse to match Python backend structure
+        // Wrap results in SearchMoviesResponse
         SearchMoviesResponse searchResponse = SearchMoviesResponse.builder()
                 .movies(movies)
                 .totalCount(movies.size())

From 7ec583fb36fb6b1721da596f477b5190344346e7 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Wed, 5 Nov 2025 09:58:40 -0500
Subject: [PATCH 059/110] fix(python): add missing import

---
 server/python/src/routers/movies.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 021a3a7..6538f96 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -1,6 +1,6 @@
 from fastapi import APIRouter, Query, Path, Body
 from src.database.mongo_client import db, get_collection
-from src.models.models import CreateMovieRequest, Movie, MovieFilter, SuccessResponse, UpdateMovieRequest, SearchMoviesResponse, BatchUpdateRequest, BatchDeleteRequest
+from src.models.models import VectorSearchResult, CreateMovieRequest, Movie, MovieFilter, SuccessResponse, UpdateMovieRequest, SearchMoviesResponse, BatchUpdateRequest, BatchDeleteRequest
 
 from typing import List
 from datetime import datetime
@@ -10,6 +10,7 @@
 from bson.errors import InvalidId
 import voyageai
 
+
 '''
 This file contains all the business logic for movie operations.
 Each method demonstrates different MongoDB operations using the PyMongo driver.

From b28fd743a87bb6c5bd3051d98b8b0b48283a1d64 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 11:15:25 -0500
Subject: [PATCH 060/110] Add CI workflows for Java and Express

---
 .github/workflows/run-express-tests.yml       | 43 ++++++++++++++
 .../workflows/run-java-spring-boot-tests.yml  | 58 +++++++++++++++++++
 2 files changed, 101 insertions(+)
 create mode 100644 .github/workflows/run-express-tests.yml
 create mode 100644 .github/workflows/run-java-spring-boot-tests.yml

diff --git a/.github/workflows/run-express-tests.yml b/.github/workflows/run-express-tests.yml
new file mode 100644
index 0000000..c83b23f
--- /dev/null
+++ b/.github/workflows/run-express-tests.yml
@@ -0,0 +1,43 @@
+name: Run Express Tests
+
+on:
+  pull_request:
+    branches:
+      - development
+  push:
+    branches:
+      - development
+
+jobs:
+  test:
+    name: Run Express Tests
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: server/express
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Run tests
+        run: npm test
+        env:
+          MONGODB_URI: ${{ secrets.MFLIX_URI }}
+
+      - name: Upload test results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: test-results
+          path: server/express/coverage/
+          retention-days: 30
diff --git a/.github/workflows/run-java-spring-boot-tests.yml b/.github/workflows/run-java-spring-boot-tests.yml
new file mode 100644
index 0000000..001cfba
--- /dev/null
+++ b/.github/workflows/run-java-spring-boot-tests.yml
@@ -0,0 +1,58 @@
+name: Run Java Spring Boot Tests
+
+on:
+  pull_request:
+    branches:
+      - development
+  push:
+    branches:
+      - development
+
+jobs:
+  test:
+    name: Run Java Spring Boot Tests
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: server/java-spring
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v5
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: 'maven'
+
+      - name: Make mvnw executable
+        run: chmod +x mvnw
+
+      - name: Run unit tests
+        run: ./mvnw test
+        env:
+          MONGODB_URI: ${{ secrets.MFLIX_URI }}
+
+      - name: Run integration tests
+        run: ./mvnw test -Dtest=MongoDBSearchIntegrationTest
+        env:
+          MONGODB_URI: ${{ secrets.MFLIX_URI }}
+          ENABLE_SEARCH_TESTS: true
+        continue-on-error: true
+
+      - name: Upload test results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: test-results
+          path: server/java-spring/target/surefire-reports/
+          retention-days: 30
+
+      - name: Test Summary
+        uses: test-summary/action@v2
+        if: always()
+        with:
+          paths: server/java-spring/target/surefire-reports/TEST-*.xml

From 0ddb4a1a179faedc2e4c70ed32b356eadb3317cf Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Wed, 5 Nov 2025 11:17:27 -0500
Subject: [PATCH 061/110] fix(java): index creation logic

---
 .../config/DatabaseVerification.java          | 111 ++++++++++++------
 1 file changed, 73 insertions(+), 38 deletions(-)

diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
index cb3368f..752168f 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
@@ -132,32 +132,43 @@ private void verifyMoviesCollection() {
      * these fields, which is used by the search endpoint in the API.
      *
      * <p>The index is created in the background to avoid blocking other operations.
-     * If the index already exists, MongoDB will ignore the duplicate creation request.
+     * If the index already exists, this method will detect it and skip creation.
      *
      * @param moviesCollection the movies collection to create the index on
      */
     private void createTextSearchIndex(MongoCollection<Document> moviesCollection) {
         try {
-            // Create compound text index on plot, title, and fullplot fields
-            // The background option allows the index to be built without blocking other operations
-            IndexOptions indexOptions = new IndexOptions()
-                    .name(TEXT_INDEX_NAME)
-                    .background(true);
-
-            // Create the text index using field name constants from Movie.Fields
-            // This makes the coupling between Movie class and index creation explicit
-            // and allows IDE "Find Usages" to track dependencies
-            // MongoDB will automatically ignore this if the index already exists
-            moviesCollection.createIndex(
-                Indexes.compoundIndex(
-                    Indexes.text(Movie.Fields.PLOT),
-                    Indexes.text(Movie.Fields.TITLE),
-                    Indexes.text(Movie.Fields.FULLPLOT)
-                ),
-                indexOptions
-            );
+            // Check if the text search index already exists
+            boolean indexExists = false;
+            for (Document index : moviesCollection.listIndexes()) {
+                if (TEXT_INDEX_NAME.equals(index.getString("name"))) {
+                    indexExists = true;
+                    logger.info("Text search index '{}' already exists", TEXT_INDEX_NAME);
+                    break;
+                }
+            }
 
-            logger.info("Text search index '{}' created/verified for movies collection", TEXT_INDEX_NAME);
+            if (!indexExists) {
+                // Create compound text index on plot, title, and fullplot fields
+                // The background option allows the index to be built without blocking other operations
+                IndexOptions indexOptions = new IndexOptions()
+                        .name(TEXT_INDEX_NAME)
+                        .background(true);
+
+                // Create the text index using field name constants from Movie.Fields
+                // This makes the coupling between Movie class and index creation explicit
+                // and allows IDE "Find Usages" to track dependencies
+                moviesCollection.createIndex(
+                    Indexes.compoundIndex(
+                        Indexes.text(Movie.Fields.PLOT),
+                        Indexes.text(Movie.Fields.TITLE),
+                        Indexes.text(Movie.Fields.FULLPLOT)
+                    ),
+                    indexOptions
+                );
+
+                logger.info("Text search index '{}' created successfully for movies collection", TEXT_INDEX_NAME);
+            }
 
         } catch (Exception e) {
             // Log error but don't fail - the application can still function without the index
@@ -240,7 +251,7 @@ private void createMongoDBSearchIndex(MongoCollection<Document> moviesCollection
     }
 
     /**
-     * Creates an index on the year field for the movies collection.
+     * Creates an index on the year field for the movies collection if it doesn't already exist.
      *
      * <p>This index improves performance for aggregation queries that filter by year,
      * such as the movies with comments aggregation.
@@ -249,16 +260,28 @@ private void createMongoDBSearchIndex(MongoCollection<Document> moviesCollection
      */
     private void createYearIndex(MongoCollection<Document> moviesCollection) {
         try {
-            IndexOptions indexOptions = new IndexOptions()
-                    .name(YEAR_INDEX_NAME)
-                    .background(true);
+            // Check if the year index already exists
+            boolean indexExists = false;
+            for (Document index : moviesCollection.listIndexes()) {
+                if (YEAR_INDEX_NAME.equals(index.getString("name"))) {
+                    indexExists = true;
+                    logger.info("Year index '{}' already exists", YEAR_INDEX_NAME);
+                    break;
+                }
+            }
 
-            moviesCollection.createIndex(
-                Indexes.ascending(Movie.Fields.YEAR),
-                indexOptions
-            );
+            if (!indexExists) {
+                IndexOptions indexOptions = new IndexOptions()
+                        .name(YEAR_INDEX_NAME)
+                        .background(true);
+
+                moviesCollection.createIndex(
+                    Indexes.ascending(Movie.Fields.YEAR),
+                    indexOptions
+                );
 
-            logger.info("Year index '{}' created/verified for movies collection", YEAR_INDEX_NAME);
+                logger.info("Year index '{}' created successfully for movies collection", YEAR_INDEX_NAME);
+            }
 
         } catch (Exception e) {
             logger.error("Could not create year index: {}", e.getMessage());
@@ -291,7 +314,7 @@ private void verifyCommentsCollection() {
     }
 
     /**
-     * Creates an index on the movie_id field for the comments collection.
+     * Creates an index on the movie_id field for the comments collection if it doesn't already exist.
      *
      * <p>This index is critical for $lookup performance when joining movies with comments.
      * Without this index, the $lookup operation will perform a collection scan for each movie,
@@ -301,16 +324,28 @@ private void verifyCommentsCollection() {
      */
     private void createMovieIdIndex(MongoCollection<Document> commentsCollection) {
         try {
-            IndexOptions indexOptions = new IndexOptions()
-                    .name(MOVIE_ID_INDEX_NAME)
-                    .background(true);
+            // Check if the movie_id index already exists
+            boolean indexExists = false;
+            for (Document index : commentsCollection.listIndexes()) {
+                if (MOVIE_ID_INDEX_NAME.equals(index.getString("name"))) {
+                    indexExists = true;
+                    logger.info("Movie ID index '{}' already exists", MOVIE_ID_INDEX_NAME);
+                    break;
+                }
+            }
 
-            commentsCollection.createIndex(
-                Indexes.ascending("movie_id"),
-                indexOptions
-            );
+            if (!indexExists) {
+                IndexOptions indexOptions = new IndexOptions()
+                        .name(MOVIE_ID_INDEX_NAME)
+                        .background(true);
 
-            logger.info("Movie ID index '{}' created/verified for comments collection", MOVIE_ID_INDEX_NAME);
+                commentsCollection.createIndex(
+                    Indexes.ascending("movie_id"),
+                    indexOptions
+                );
+
+                logger.info("Movie ID index '{}' created successfully for comments collection", MOVIE_ID_INDEX_NAME);
+            }
 
         } catch (Exception e) {
             logger.error("Could not create movie_id index: {}", e.getMessage());

From 54eab015e14166afae5afa8072791a7333e8c687 Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Wed, 5 Nov 2025 11:25:35 -0500
Subject: [PATCH 062/110] docs(java): update README

---
 mflix/README-JAVA-SPRING.md | 38 ++++++++++++++++++++++++++++++++-----
 1 file changed, 33 insertions(+), 5 deletions(-)

diff --git a/mflix/README-JAVA-SPRING.md b/mflix/README-JAVA-SPRING.md
index 17bf602..988fc49 100644
--- a/mflix/README-JAVA-SPRING.md
+++ b/mflix/README-JAVA-SPRING.md
@@ -18,8 +18,8 @@ This is a full-stack movie browsing application built with Java Spring Boot and
 
 - **Java 21** or higher
 - **Node.js 20** or higher
-- **MongoDB Atlas account** with the `sample_mflix` dataset loaded
-  - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/) in your Atlas cluster
+- **MongoDB Atlas cluster or local deployment** with the `sample_mflix` dataset loaded
+  - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/) 
 - **Maven** (included via Maven Wrapper)
 
 ## Getting Started
@@ -130,12 +130,40 @@ The Next.js frontend uses:
 - **Next.js 16** with App Router
 - **Turbopack** for fast development builds
 
-To build for production:
+#### Development Mode
+
+For active development with hot reloading and fast refresh:
+
+```bash
+cd client
+npm run dev
+```
+
+This starts the development server on `http://localhost:3000` with Turbopack for fast rebuilds.
+
+#### Production Build
+
+To create an optimized production build and run it:
+
+```bash
+cd client
+npm run build  # Creates optimized production build
+npm start      # Starts production server
+```
+
+The production build:
+- Minifies and optimizes JavaScript and CSS
+- Optimizes images and assets
+- Generates static pages where possible
+- Provides better performance for end users
+
+#### Linting
+
+To check code quality:
 
 ```bash
 cd client
-npm run build
-npm start
+npm run lint
 ```
 
 ## Issues

From a29569f9bbf24ad7c3e7a0f307a39b3c4127674f Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Wed, 5 Nov 2025 15:56:52 -0500
Subject: [PATCH 063/110] clean up sample app

---
 server/python/main.py               |   20 +-
 server/python/src/routers/movies.py | 2130 +++++++++++++--------------
 2 files changed, 1069 insertions(+), 1081 deletions(-)

diff --git a/server/python/main.py b/server/python/main.py
index c8bcdb9..0b75cf2 100644
--- a/server/python/main.py
+++ b/server/python/main.py
@@ -1,7 +1,7 @@
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
 from src.routers import movies
-from src.utils.errorHandler import register_error_handlers
+from src.utils.errorHandler import register_error_handlers, create_error_response
 from src.database.mongo_client import db, get_collection
 import traceback
 import os
@@ -34,7 +34,6 @@ async def ensure_search_index():
         indexes = [idx async for idx in result]
         index_names = [index["name"] for index in indexes]
         if "movieSearchIndex" in index_names:
-            print("MongoDB Search index already exists.")
             return
 
         # Create a mapping if the movieSearchIndex does not exist
@@ -58,9 +57,12 @@ async def ensure_search_index():
                 "definition": index_definition
             }]
         })
-        print("MongoDB Search index created.")
     except Exception as e:
-        print(f"Error creating the search index: {e}")
+        raise RuntimeError(
+            f"Failed to create search index 'movieSearchIndex': {str(e)}. "
+            f"Search functionality may not work properly. "
+            f"Please check your MongoDB Atlas configuration and ensure the cluster supports search indexes."
+        )
 
 @app.on_event("startup")
 async def vector_search_index():
@@ -69,7 +71,6 @@ async def vector_search_index():
     This ensures the index is ready before any vector search requests are made.
     """
     try:
-        
         embedded_movies_collection = get_collection("embedded_movies")
         
         # Get list of existing indexes - convert AsyncCommandCursor to list
@@ -98,9 +99,12 @@ async def vector_search_index():
             
             # Create the index
             result = await embedded_movies_collection.create_search_index(index_definition)
-            print("Vector search index 'vector_index' ready to query.")
             
     except Exception as e:
-        print(f"Error during vector search index setup: {str(e)}")
-        print(f"Error type: {type(e).__name__}")
+        raise RuntimeError(
+            f"Failed to create vector search index 'vector_index': {str(e)}. "
+            f"Vector search functionality will not be available. "
+            f"Please check your MongoDB Atlas configuration, ensure the cluster supports vector search, "
+            f"and verify the 'embedded_movies' collection exists with the required embedding field."
+        )
 
diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 6538f96..cbc2e56 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -1,5 +1,5 @@
 from fastapi import APIRouter, Query, Path, Body
-from src.database.mongo_client import db, get_collection
+from src.database.mongo_client import db, get_collection, voyage_ai_available
 from src.models.models import VectorSearchResult, CreateMovieRequest, Movie, MovieFilter, SuccessResponse, UpdateMovieRequest, SearchMoviesResponse, BatchUpdateRequest, BatchDeleteRequest
 
 from typing import List
@@ -17,23 +17,6 @@
 
 Implemented Endpoints:
 
-- GET /api/movies/search :
-    Search movies using MongoDB Search across the plot, fullplot, directors, writers, and cast fields.
-    Supports compound search operators and fuzzy matching.
-
-- GET /api/movies/vector-search :
-    Search movies using MongoDB Vector Search to enable semantic search capabilities over
-    the plot field.
-
-- GET /api/movies/aggregations/reportingByComments :
-    Aggregate movies with their most recent comments using MongoDB $lookup aggregation.
-
-- GET /api/movies/aggregations/reportingByYear :
-    Aggregate movies by year with average rating and movie count.
-
-- GET /api/movies/aggregations/reportingByDirectors :
-    Aggregate directors with the most movies and their statistics.
-
 - GET /api/movies/{id} :
     Retrieve a single movie by its ID.
 
@@ -62,6 +45,24 @@
 - DELETE /api/movies/{id}/find-and-delete :
     Find and delete a movie in a single atomic operation.
 
+- GET /api/movies/aggregations/reportingByComments :
+    Aggregate movies with their most recent comments using MongoDB $lookup aggregation.
+
+- GET /api/movies/aggregations/reportingByYear :
+    Aggregate movies by year with average rating and movie count.
+
+- GET /api/movies/aggregations/reportingByDirectors :
+    Aggregate directors with the most movies and their statistics.
+
+- GET /api/movies/search :
+    Search movies using MongoDB Search across the plot, fullplot, directors, writers, and cast fields.
+    Supports compound search operators and fuzzy matching.
+
+- GET /api/movies/vector-search :
+    Search movies using MongoDB Vector Search to enable semantic search capabilities over
+    the plot field.
+
+
 Helper Functions:
 - execute_aggregation(pipeline): Executes a MongoDB aggregation pipeline and returns the
 results.
@@ -71,707 +72,431 @@
 
 router = APIRouter()
 
-#----------------------------------------------------------------------------------------------------------
-# MongoDB Search
-#
-# MongoDB Search based on searching the plot, fullplot, directors, writers, and cast fields.
-# This function was made with the assumption that the UI will have fields for plot,fullplot, 
-# directors, writers, and cast to search on. Or some sort of combined search field.
-# Also this fuzzy operator is being used to allow for some misspellings in the search terms
-# but that allows for very generous matching. This can be adjusted as needed.
-#----------------------------------------------------------------------------------------------------------
-"""
-
-    GET /api/movies/search
-
-    Search movies using MongoDB Search across the plot, fullplot, directors, writers, and cast fields.
-    You can combine multiple fields in a single query, and control how they are combined using the `search_operator` parameter.
-
-    Query Parameters:
-        plot (str, optional): Text to search against the plot field.
-        fullplot (str, optional): Text to search against the fullplot field.
-        directors (str, optional): Text to search against the directors field.
-        writers (str, optional): Text to search against the writers field.
-        cast (str, optional): Text to search against the cast field.
-        limit (int, optional): Number of results to return (default: 20)
-        skip (int, optional): Number of results to skip for pagination (default: 0)
-        search_operator (str, optional): How to combine multiple search fields. 
-            Must be one of "must", "should", "mustNot", or "filter". Default is "must".
+#------------------------------------
+# Place get_movie_by_id endpoint here
+#------------------------------------
 
+"""
+    GET /api/movies/{id}
+    Retrieve a single movie by its ID.
+    Path Parameters:
+        id (str): The ObjectId of the movie to retrieve.
     Returns:
-        SuccessResponse[SearchMoviesResponse]: A response object containing the list of matching movies and total count.
+        SuccessResponse[Movie]: A response object containing the movie data.
 """
-@router.get(
-    "/search",
-    response_model=SuccessResponse[SearchMoviesResponse],
-    status_code=200,
-    summary="Search movies using MongoDB Search."
-)
-async def search_movies(
-    plot: str = Query(default=None),
-    fullplot: str = Query(default=None),
-    directors: str = Query(default=None),
-    writers: str = Query(default=None),
-    cast: str = Query(default=None),
-    limit:int = Query(default=20, ge=1, le=100),
-    skip:int = Query(default=0, ge=0),
-    search_operator: str = Query(default="must")
-) -> SuccessResponse[SearchMoviesResponse]:
-    
-    search_phrases = []
-
-    # Validate the search_operator parameter to ensure it's a valid compound operator
-    valid_operators = {"must", "should", "mustNot", "filter"}
-    if search_operator not in valid_operators:
-        return create_error_response(
-        message=f"Invalid search_operator '{search_operator}'. The search_operator must be one of {valid_operators}.",
-        code="INVALID_SEARCH_OPERATOR",
-        details=None
-    )
-
-    # Build the search_phrases list based on which fields were provided by the user.
-    # Each phrase becomes a separate clause in the MongoDB Search compound query.
-
-    if plot:
-        search_phrases.append({
-            # The phrase operator performs an exact phrase match on the specified field. This is useful for searching for specific phrases within text fields.
-            # The text operator is more flexible and allows for fuzzy matching, making it suitable for fields like names where typos may occur.
-            "phrase": {
-                "query": plot,
-                "path": "plot",
-            }
-        })
-    if fullplot:
-        search_phrases.append({
-            "phrase": {
-                "query": fullplot,
-                "path": "fullplot",
-            }
-        })
-    if directors:
-        # The "fuzzy" option enables typo-tolerant (fuzzy) search within MongoDB Search.
-        # - maxEdits: The maximum number of single-character edits (insertions, deletions, or substitutions)
-        #             allowed when matching the search term to indexed terms. (Range: 1-2; higher = more tolerant)
-        # - prefixLength: The number of initial characters that must exactly match before fuzzy matching is applied.
-        #             (Higher values make the search stricter and faster.)
-        # For more details, see: https://www.mongodb.com/docs/atlas/atlas-search/operators-collectors/text/
-
-        search_phrases.append({
-            "text": {
-                "query": directors,
-                "path": "directors",
-                "fuzzy":{"maxEdits":1, "prefixLength":5}
-
-            }
-        })
-    if writers:
-        # See comments above regarding fuzzy search options.
-        search_phrases.append({
-            "text": {
-                "query": writers,
-                "path": "writers",
-                "fuzzy":{"maxEdits":1, "prefixLength":5}
-            }
-        })
-    if cast:
-        # See comments above regarding fuzzy search options.
-        search_phrases.append({
-            "text": {
-                "query": cast,
-                "path": "cast",
-                "fuzzy":{"maxEdits":1, "prefixLength":5}
-            }
-        })
 
-    if not search_phrases:
+@router.get("/{id}",
+            response_model=SuccessResponse[Movie],
+            status_code=200,
+            summary="Retrieve a single movie by its ID.")
+async def get_movie_by_id(id: str):
+    # Validate ObjectId format
+    try:
+        object_id = ObjectId(id)
+    except InvalidId:
         return create_error_response(
-            message="At least one search parameter must be provided.",
-            code="NO_SEARCH_PARAMETERS",
-            details=None
+            message="Invalid movie ID format",
+            code="INTERNAL_SERVER_ERROR",
+            details=f"The provided ID '{id}' is not a valid ObjectId"
         )
 
-    # Build the aggregation pipeline for MongoDB Search.
-    # The $search stage uses the specified compound operator (must, should, etc.)
-    aggregation_pipeline = [
-        {
-            "$search": {
-                "index": "movieSearchIndex",
-                "compound": {
-                    search_operator: search_phrases
-                }
-            }
-        },
-        {
-            "$facet": {
-                "totalCount": [
-                    {"$count": "count"}
-                ],
-                "results": [
-                    {"$skip": skip},
-                    {"$limit": limit},
-                    # Project only the fields needed in the response
-                    {
-                        "$project": {
-                            "_id": 1,
-                            "title": 1,
-                            "year": 1,
-                            "plot": 1,
-                            "fullplot": 1,
-                            "released":1,
-                            "runtime": 1,
-                            "poster": 1,
-                            "genres": 1,
-                            "directors": 1,
-                            "writers": 1,
-                            "cast": 1,
-                            "countries": 1,
-                            "languages": 1,
-                            "rated": 1,
-                            "awards": 1,
-                            "imdb": 1,
-                        }
-                    }
-                ]
-            }
-        }
-    ]
-
-    # Execute the aggregation pipeline using the helper function
+    movies_collection = get_collection("movies")
     try:
-        results = await execute_aggregation(aggregation_pipeline)
+        movie = await movies_collection.find_one({"_id": object_id})
     except Exception as e:
         return create_error_response(
-            message="An error occurred while performing the search.",
-            code="DATABASE_ERROR",
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
             details=str(e)
-        )    
+        )
 
-    # Extract total count and movies from facet results
-    facet_result = results[0] if results else {}
-    total_count = facet_result.get("totalCount", [{}])[0].get("count", 0)
-    movies_data = facet_result.get("results", [])
-    
-    # Convert ObjectId to string for each movie in the results
-    movies = []
-    for movie in movies_data:
-        movie["_id"] = str(movie["_id"])
-        movies.append(movie)
+    if movie is None:
+        return create_error_response(
+            message="Movie not found",
+            code="INTERNAL_SERVER_ERROR",
+            details=f"No movie found with ID: {id}"
+        )
 
-    return create_success_response(
-        SearchMoviesResponse(movies=movies, totalCount=total_count), 
-        f"Found {total_count} movies matching the search criteria."
-      )
+    movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
+    
+    return create_success_response(movie, "Movie retrieved successfully")
 
-#----------------------------------------------------------------------------------------------------------
-# MongoDB Vector Search
-#
-# MongoDB Vector Search based on searching the plot_embedding_voyage_3_large field.
-#----------------------------------------------------------------------------------------------------------
 """
+    GET /api/movies/
 
-    GET /api/movies/vector-search
-
-    Search movies using MongoDB Vector Search to find movies with similar plots.
-    Uses embeddings generated by the Voyage AI model to perform semantic similarity search.
+    Retrieve a list of movies with optional filtering, sorting, and pagination.
 
     Query Parameters:
-        q (str, required): Search query text to find movies with similar plots.
-        limit (int, optional): Number of results to return (default: 10, max: 50).
+        q (str, optional): Text search query (searches title, plot, fullplot).
+        genre (str, optional): Filter by genre.
+        year (int, optional): Filter by year.
+        min_rating (float, optional): Minimum IMDB rating.
+        max_rating (float, optional): Maximum IMDB rating.
+        limitNum (int, optional): Number of results to return (default: 20, max: 100).
+        skipNum (int, optional): Number of documents to skip for pagination (default: 0).
+        sortBy (str, optional): Field to sort by (default: "title").
+        sort_order (str, optional): Sort direction, "asc" or "desc" (default: "asc").
 
     Returns:
-        SuccessResponse[List[VectorSearchResult]]: A response object containing movies with similarity scores.
-        Each result includes:
-            - _id: Movie ObjectId
-            - title: Movie title  
-            - plot: Movie plot text
-            - score: Vector search similarity score (0.0 to 1.0, higher = more similar)
+        SuccessResponse[List[Movie]]: A response object containing the list of movies and metadata.
 """
-# Specify your Voyage API key and embedding model
-model = "voyage-3-large"
-outputDimension = 2048 #Set to 2048 to match the dimensions of the collection's embeddings
 
-# Vector Search Endpoint
-@router.get("/vector-search", response_model=SuccessResponse[List[VectorSearchResult]])
-async def vector_search_movies(
-    q: str = Query(..., description="Search query to find similar movies by plot"),
-    limit: int = Query(default=10, ge=1, le=50, description="Number of results to return")
+@router.get("/",
+            response_model=SuccessResponse[List[Movie]],
+            status_code=200,
+            summary="Retrieve a list of movies with optional filtering, sorting, and pagination.")
+# Validate the query parameters using FastAPI's Query functionality.
+async def get_all_movies(
+    q:str = Query(default=None),
+    title: str = Query(default=None),
+    genre:str = Query(default=None),
+    year:int = Query(default=None),
+    min_rating:float = Query(default=None),
+    max_rating:float = Query(default=None),
+    limit:int = Query(default=20, ge=1, le=100),
+    skip:int = Query(default=0, ge=0),
+    sort_by:str = Query(default="title"),
+    sort_order:str = Query(default="asc")
 ):
-    """
-    Vector search endpoint for finding movies with similar plots.
+    movies_collection = get_collection("movies")
+    filter_dict = {}
+    if q:
+        filter_dict["$text"] = {"$search": q} 
+    if title:
+        filter_dict["title"] = {"$regex": title, "$options": "i"}       
+    if genre:
+        filter_dict["genres"] = {"$regex": genre, "$options": "i"}
+    if year:
+        filter_dict["year"] = year
+    if min_rating is not None or max_rating is not None:
+        rating_filter = {}
+        if min_rating is not None:
+            rating_filter["$gte"] = min_rating
+        if max_rating is not None:
+            rating_filter["$lte"] = max_rating
+        filter_dict["imdb.rating"] = rating_filter
+        
+    # Building the sort object based on user input
+    sort_order = -1 if sort_order == "desc" else 1
+
+    sort = [(sort_by, sort_order)]
+
+    # Query the database with the constructed filter, sort, skip, and limit.
+
+    try:
+        result = movies_collection.find(filter_dict).sort(sort).skip(skip).limit(limit)  
+    except Exception as e:
+        return create_error_response(
+            message="An error occurred while fetching movies.",
+            code="DATABASE_ERROR",
+            details=str(e)
+        )   
+
+    movies = []
+
+    async for movie in result:
+        movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
+        # Ensure that the year field contains int value.
+        if "year" in movie and not isinstance(movie["year"], int):
+            cleaned_year = re.sub(r"\D", "", str(movie["year"]))
+            try:
+                movie["year"] = int(cleaned_year) if cleaned_year else None
+            except ValueError:
+                movie["year"] = None
+
+        movies.append(movie)            
+    # Return the results wrapped in a SuccessResponse    
+    return create_success_response(movies, f"Found {len(movies)} movies.")
+
+#------------------------------------
+# Place create_movie endpoint here
+#------------------------------------
+
+"""
+    POST /api/movies/
+    Create a new movie.
+    Request Body:
+        movie (CreateMovieRequest): A movie object containing the movie data.
+            See CreateMovieRequest model for available fields.
+    Returns:
+        SuccessResponse[Movie]: A response object containing the created movie data.
+"""
+
+@router.post("/", 
+            response_model=SuccessResponse[Movie],
+            status_code=201,
+            summary="Creates a new movie in the database.")
+async def create_movie(movie: CreateMovieRequest):
+    # Pydantic automatically validates the structure
+    movie_data = movie.model_dump(by_alias=True, exclude_none=True)
     
-    Args:
-        q: The search query string
-        limit: Maximum number of results to return
+    movies_collection = get_collection("movies")
+    try:
+        result = await movies_collection.insert_one(movie_data)
+    except Exception as e:
+        return create_error_response(
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
     
-    Returns:
-        SuccessResponse containing a list of movies with similarity scores
-    """
-    if not voyage_ai_available():
+    # Verify that the document was created before querying it
+    if not result.acknowledged:
         return create_error_response(
-            message="Vector search unavailable",
-            code="SERVICE_UNAVAILABLE",
-            details="VOYAGE_API_KEY not configured. Please add your API key to your .env file."
+            message="Failed to create movie",
+            code="INTERNAL_SERVER_ERROR",
+            details="The database did not acknowledge the insert operation"
         )
     
     try:
-        # Initialize the client here to avoid import-time errors
-        vo = voyageai.Client()
-        
-        # The vector search index was already created at startup time
-        # Generate embedding for the search query
-        query_embedding = get_embedding(q, input_type="query", client=vo)
-        
-        # Get the embedded movies collection
-        embedded_movies_collection = get_collection("embedded_movies")
-        
-        # Define vector search pipeline
-        pipeline = [
-            {
-                "$vectorSearch": {
-                    "index": "vector_index",
-                    "path": "plot_embedding_voyage_3_large",
-                    "queryVector": query_embedding, #2048
-                    "numCandidates": limit * 15,  # Search more candidates for better results
-                    "limit": limit
-                }
-            },
-            {
-                "$project": {
-                    "_id": 1,
-                    "title": 1,
-                    "plot": 1,
-                    "score": {
-                        "$meta": "vectorSearchScore"
-                    }
-                }
-            }
-        ]
-
-        raw_results = await execute_aggregation_on_collection(embedded_movies_collection, pipeline)
-        
-        # Convert ObjectId to string and create VectorSearchResult objects
-        for result in raw_results:
-            if "_id" in result and result["_id"]:
-                try:
-                    result["_id"] = str(result["_id"])
-                except (InvalidId, TypeError):
-                    # Handle invalid ObjectId conversion
-                    result["_id"] = str(result["_id"]) if result["_id"] else None
-        
-        # This code converts the raw results into VectorSearchResult objects
-        results = [VectorSearchResult(**doc) for doc in raw_results]
-        
-        return create_success_response(
-            results, 
-            f"Found {len(results)} similar movies for query: '{q}'"
-        )
-        
+        # Retrieve the created document to return complete data
+        created_movie = await movies_collection.find_one({"_id": result.inserted_id})
     except Exception as e:
         return create_error_response(
-            message="Vector search failed",
+            message="Database error occurred",
             code="INTERNAL_SERVER_ERROR",
             details=str(e)
         )
     
+    if created_movie is None:
+        return create_error_response(
+            message="Movie creation verification failed",
+            code="INTERNAL_SERVER_ERROR",
+            details="Movie was created but could not be retrieved for verification"
+        )
+
+    created_movie["_id"] = str(created_movie["_id"]) # Convert ObjectId to string
+    
+    return create_success_response(created_movie, f"Movie '{movie_data['title']}' created successfully")
+
+#------------------------------------
+# Place create_movies_batch endpoint here
+#------------------------------------
+
 """
-    GET /api/movies/aggregations/reportingByComments
-    Aggregate movies with their most recent comments using MongoDB $lookup aggregation.
-    Joins movies with comments collection to show recent comment activity.
-    Query Parameters:
-        limit (int, optional): Number of results to return (default: 10, max: 50).
-        movie_id (str, optional): Filter by specific movie ObjectId.
+POST /api/movies/batch
+
+Create multiple movies in a single request. 
+
+Request Body:
+        movies (List[CreateMovieRequest]): A list of movie objects to insert. Each object should include:
+            - title (str): The movie title.
+            - year (int, optional): The release year.
+            - plot (str, optional): Short plot summary.
+            - fullplot (str, optional): Full plot summary.
+            - genres (List[str], optional): List of genres.
+            - directors (List[str], optional): List of directors.
+            - writers (List[str], optional): List of writers.
+            - cast (List[str], optional): List of cast members.
+            - countries (List[str], optional): List of countries.
+            - languages (List[str], optional): List of languages.
+            - rated (str, optional): Movie rating.
+            - runtime (int, optional): Runtime in minutes.
+            - poster (str, optional): Poster URL.
+
     Returns:
-        SuccessResponse[List[dict]]: A response object containing movies with their most recent comments.
+        SuccessResponse: A response object containing the number of inserted movies and their IDs.
+
 """
 
-@router.get("/aggregations/reportingByComments",
-            response_model=SuccessResponse[List[dict]],
-            status_code=200,
-            summary="Aggregate movies with their most recent comments.")
-async def aggregate_movies_recent_commented(
-    limit: int = Query(default=10, ge=1, le=50),
-    movie_id: str = Query(default=None)
-):
-    
-    # Add a multi-stage aggregation that:
-    # 1. Filters movies by valid year range
-    # 2. Joins with comments collection (like SQL JOIN)
-    # 3. Filters to only movies that have comments
-    # 4. Sorts comments by date and extracts most recent ones
-    # 5. Sorts movies by their most recent comment date
-    # 6. Shapes the final output with transformed comment structure
-    
-    pipeline = [
-        # STAGE 1: $match - Initial Filter
-        # Filter movies to only those with valid year data
-        # Tip: Use $match early to reduce the initial dataset for better performance
-        {
-            "$match": {
-                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
-            }
-        }
-    ]
+@router.post(
+        "/batch",
+        response_model=SuccessResponse[dict],
+        status_code = 201,
+        summary = "Create multiple movies in a single request."
+        )
+async def create_movies_batch(movies: List[CreateMovieRequest]) ->SuccessResponse[dict]:
+    movies_collection = get_collection("movies")
 
-    # Add movie_id filter if provided
-    if movie_id:
-        try:
-            object_id = ObjectId(movie_id)
-            pipeline[0]["$match"]["_id"] = object_id
-        except Exception:
-            return create_error_response(
-                message="Invalid movie ID format",
-                code="INTERNAL_SERVER_ERROR",
-                details="The provided movie_id is not a valid ObjectId"
-            )
+    #Verify that the movies list is not empty
+    if not movies:
+        return create_error_response(
+            message="Request body must be a non-empty list of movies.",
+            code="INVALID_INPUT",
+            details=None
+        )
     
-    # Add remaining pipeline stages
-    pipeline.extend([
-        # STAGE 2: $lookup - Join with the 'comments' Collection
-        # This gives each movie document a 'comments' array containing all its comments
-        {
-            "$lookup": {
-                "from": "comments",
-                "localField": "_id",
-                "foreignField": "movie_id",
-                "as": "comments"
-            }
-        },
-        # STAGE 3: $match - Filter Movies with at Least One Comment
-        # This helps reduces dataset to only movies with user engagement
-        {
-            "$match": {
-                "comments": {"$ne": []}
-            }
-        },
-        # STAGE 4: $addFields - Add New Computed Fields
-        {
-            "$addFields": {
-                # Add computed field 'recentComments' that extracts only the N most recent comments (up to 'limit')
-                "recentComments": {
-                    "$slice": [
-                        {
-                            "$sortArray": {
-                                "input": "$comments",
-                                "sortBy": {"date": -1}  # -1 = descending (newest first)
-                            }
-                        },
-                        limit  # Number of comments to keep
-                    ]
-                },
-                # Add computed field 'mostRecentCommentDate' that gets the date of the most recent comment (to use in the next $sort stage)
-                "mostRecentCommentDate": {
-                    "$max": "$comments.date"
-                }
-            }
-        },
-        # STAGE 5: $sort - Sort Movies by Most Recent Comment Date
-        {
-            "$sort": {"mostRecentCommentDate": -1}
-        },
-        # STAGE 6: $limit - Restrict Result Set Size
-        # - If querying single movie: return up to 50 results
-        # - If querying all movies: return up to 20 results
-        # Tip: This prevents overwhelming the client with too much data
-        {
-            "$limit": 50 if movie_id else 20
-        },
-        # STAGE 7: $project - Shape Final Response Output
-        {
-            "$project": {
-                # Include basic movie fields
-                "title": 1,
-                "year": 1,
-                "genres": 1,
-                "_id": 1,
-                # Extract nested field: imdb.rating -> imdbRating
-                "imdbRating": "$imdb.rating",
-                # Use $map to reshape computed 'recentComments' field with cleaner field names
-                "recentComments": {
-                    "$map": {
-                        "input": "$recentComments",
-                        "as": "comment",
-                        "in": {
-                            "userName": "$$comment.name",      # Rename: name -> userName
-                            "userEmail": "$$comment.email",    # Rename: email -> userEmail
-                            "text": "$$comment.text",          # Keep: text
-                            "date": "$$comment.date"           # Keep: date
-                        }
-                    }
-                },
-                # Calculate the total number of comments into 'totalComments' (not just 'recentComments')
-                # Used in display (e.g., "Showing 5 of 127 comments")
-                "totalComments": {"$size": "$comments"}
-            }
-        }
-    ])
-    # Execute the aggregation
+    movies_dicts = []
+
+    for movie in movies:
+        movie_dict = movie.model_dump(exclude_unset=True, exclude_none=True)
+        # Remove _id if it exists to let MongoDB generate it automatically
+        movie_dict.pop('_id', None)
+        movies_dicts.append(movie_dict)
+
     try:
-        results = await execute_aggregation(pipeline)
+        result = await movies_collection.insert_many(movies_dicts)
+        return create_success_response({
+            "insertedCount": len(result.inserted_ids),
+            "insertedIds": [str(_id) for _id in result.inserted_ids]
+            },
+            f"Successfully created {len(result.inserted_ids)} movies."
+        )
     except Exception as e:
         return create_error_response(
-            message="Database error occurred during aggregation",
+            message="Database error occurred",
             code="INTERNAL_SERVER_ERROR",
             details=str(e)
         )
 
-    # Convert ObjectId to string for response
-    for result in results:
-        if "_id" in result:
-            result["_id"] = str(result["_id"])
+#------------------------------------
+# Place update_movie endpoint here
+#------------------------------------
+
+"""    
+    PATCH /api/movies/{id}
+
+    Update a single movie by its ID.
+
+    Path Parameters:
+        id (str): The ObjectId of the movie to update
+
+    Request Body:
+        move_data (UpdateMovieRequest): Fields and values to update. Only provided fields will be updated.
+
+    Returns:
+        SuccessResponse: The updated movie document, the number of fields modified and a success message.
+"""
+@router.patch(
+        "/{id}",
+        response_model=SuccessResponse[Movie],
+        status_code=200,
+        summary="Update a single movie by its ID.")
+async def update_movie(
+    movie_data: UpdateMovieRequest,
+    movie_id: str = Path(..., alias="id")
+) -> SuccessResponse[Movie]:
+
+    movies_collection = get_collection("movies")
     
-    # Calculate total comments from all movies
-    total_comments = sum(result.get("totalComments", 0) for result in results)
+    # Validate the ObjectId
+    try:
+        movie_id = ObjectId(movie_id)
+    except Exception :
+        return create_error_response(
+            message="Invalid movie_id format.",
+            code="INVALID_OBJECT_ID",
+            details=str(movie_id)
+        )    
     
-    return create_success_response(
-        results, 
-        f"Found {total_comments} comments from movie{'s' if len(results) != 1 else ''}"
-    )
+    update_dict = movie_data.model_dump(exclude_unset=True, exclude_none=True)
+
+    # Validate that the dict is not empty
+    if not update_dict:
+        return create_error_response(
+            message="No valid fields provided for update.",
+            code="NO_UPDATE_DATA",
+            details=None
+        )
+
+    try:
+        result = await movies_collection.update_one(
+            {"_id": movie_id},
+            {"$set":update_dict}
+        )
+    except Exception as e:
+        return create_error_response(
+            message="An error occurred while updating the movie.",
+            code="DATABASE_ERROR",
+            details=str(e)
+        )    
 
+    if result.matched_count == 0:
+        return create_error_response(
+            message="No movie with that _id was found.",
+            code="MOVIE_NOT_FOUND",
+            details=str(movie_id)
+        )
+    
+    updatedMovie = await movies_collection.find_one({"_id": movie_id})
+    updatedMovie["_id"] = str(updatedMovie["_id"])
+
+    return create_success_response(updatedMovie, f"Movie updated successfully. Modified {len(update_dict)} fields.")
+
+#------------------------------------
+# Place update_movies_by_batch endpoint here
+#------------------------------------
 
 """
-    GET /api/movies/aggregations/reportingByYear
-    Aggregate movies by year with average rating and movie count.
-    Reports yearly statistics including average rating and total movies per year.
+    PATCH /api/movies
+
+    Batch update movies matching the given filter
+
+    Request Body:
+        filter (MoviesUpdateFilter): Criteria to select which movies to update. Only movies matching this filter will be updated.
+        update (UpdateMovieRequest): Fields and values to update for the matched movies. Only provided fields will be updated.
     Returns:
-        SuccessResponse[List[dict]]: A response object containing yearly movie statistics.
+        SuccessResponse: A response object containing the number of matched and modified movies and a success message.
 """
 
-@router.get("/aggregations/reportingByYear",
-            response_model=SuccessResponse[List[dict]],
-            status_code=200,
-            summary="Aggregate movies by year with average rating and movie count.")
-async def aggregate_movies_by_year():
-    # Define aggregation pipeline to group movies by year with statistics
-    # This pipeline demonstrates grouping, statistical calculations, and data cleaning
+@router.patch("/",
+        response_model=SuccessResponse[dict],
+        status_code=200,
+        summary="Batch update movies matching the given filter."
+        )
+async def update_movies_batch(
+    request_body: dict = Body(...)
+) -> SuccessResponse[dict]:
+    movies_collection = get_collection("movies")
 
-    # Add a multi-stage aggregation that:
-    # 1. Filters movies by valid year range (data quality filter)
-    # 2. Groups movies by release year and calculates statistics per year
-    # 3. Shapes the final output with clean field names and rounded averages
-    # 4. Sorts results by year (newest first) for chronological presentation
-    
-    pipeline = [
-        # STAGE 1: $match - Data Quality Filter
-        # Clean data: ensure year is an integer and within reasonable range
-        # Tip: Filter early to reduce dataset size and improve performance
-        {
-            "$match": {
-                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
-            }
-        },
-        
-        # STAGE 2: $group - Aggregate Movies by Year
-        # Group all movies by their release year and calculate various statistics
-        {
-            "$group": {
-                "_id": "$year",  # Group by year field
-                "movieCount": {"$sum": 1},  # Count total movies per year
-                
-                # Calculate average rating (only for valid numeric ratings)
-                "averageRating": {
-                    "$avg": {
-                        "$cond": [
-                            {"$and": [
-                                {"$ne": ["$imdb.rating", None]},           # Not null
-                                {"$ne": ["$imdb.rating", ""]},             # Not empty string
-                                {"$eq": [{"$type": "$imdb.rating"}, "double"]}  # Is numeric
-                            ]},
-                            "$imdb.rating",  # Include valid IMDB ratings
-                            "$$REMOVE"       # Exclude invalid IMDB ratings
-                        ]
-                    }
-                },
-                
-                # Find highest rating for the year (same validation as average rating)
-                "highestRating": {
-                    "$max": {
-                        "$cond": [
-                            {"$and": [
-                                {"$ne": ["$imdb.rating", None]},
-                                {"$ne": ["$imdb.rating", ""]},
-                                {"$eq": [{"$type": "$imdb.rating"}, "double"]}
-                            ]},
-                            "$imdb.rating",
-                            "$$REMOVE"
-                        ]
-                    }
-                },
-                
-                # Find lowest rating for the year (same validation as average and highest rating)
-                "lowestRating": {
-                    "$min": {
-                        "$cond": [
-                            {"$and": [
-                                {"$ne": ["$imdb.rating", None]},
-                                {"$ne": ["$imdb.rating", ""]},
-                                {"$eq": [{"$type": "$imdb.rating"}, "double"]}
-                            ]},
-                            "$imdb.rating",
-                            "$$REMOVE"
-                        ]
-                    }
-                },
-                
-                # Sum total votes across all movies in the year
-                "totalVotes": {"$sum": "$imdb.votes"}
-            }
-        },
-        
-        # STAGE 3: $project - Shape Final Output
-        # Transform the grouped data into a clean, readable format
-        {
-            "$project": {
-                "year": "$_id",  # Rename _id back to year because grouping was done by year but values were stored in _id
-                "movieCount": 1,
-                "averageRating": {"$round": ["$averageRating", 2]},  # Round to 2 decimal places
-                "highestRating": 1,
-                "lowestRating": 1,
-                "totalVotes": 1,
-                "_id": 0  # Exclude the _id field from output
-            }
-        },
-        
-        # STAGE 4: $sort - Sort by Year (Newest First)
-        # Sort results in descending order to show most recent years first
-        {"$sort": {"year": -1}}  # -1 = descending order
-    ]
+    # Extract filter and update from the request body
+    filter_data = request_body.get("filter", {})
+    update_data = request_body.get("update", {})
 
-    # Execute the aggregation
-    try:
-        results = await execute_aggregation(pipeline)
-    except Exception as e:
+    if not filter_data or not update_data:
         return create_error_response(
-            message="Database error occurred during aggregation",
-            code="INTERNAL_SERVER_ERROR",
-            details=str(e)
+            message="Both filter and update objects are required",
+            code="MISSING_REQUIRED_FIELDS",
+            details=None
         )
-    
-    return create_success_response(
-        results, 
-        f"Aggregated statistics for {len(results)} years"
-    )
-
-
-"""
-    GET /api/movies/aggregations/reportingByDirectors
-    Aggregate directors with the most movies and their statistics.
-    Reports directors sorted by number of movies directed.
-    Query Parameters:
-        limit (int, optional): Number of results to return (default: 20, max: 100).
-    Returns:
-        SuccessResponse[List[dict]]: A response object containing director statistics.
-"""
-
-@router.get("/aggregations/reportingByDirectors",
-            response_model=SuccessResponse[List[dict]],
-            status_code=200,
-            summary="Aggregate directors with the most movies and their statistics.")
-async def aggregate_directors_most_movies(
-    limit: int = Query(default=20, ge=1, le=100)
-):
-    # Define aggregation pipeline to find directors with the most movies
-    # This pipeline demonstrates array unwinding, filtering, and ranking
-    
-    # Add a multi-stage aggregation that:
-    # 1. Filters movies with valid directors and year data (data quality filter)
-    # 2. Unwinds directors array to create separate documents per director
-    # 3. Cleans director names by filtering out null/empty names
-    # 4. Groups movies by individual director and calculates statistics per director
-    # 5. Sorts directors based on movie count
-    # 6. Limits results to top N directors
-    # 7. Shapes the final output with clean field names and rounded averages
 
-    pipeline = [
-        # STAGE 1: $match - Initial Data Quality Filter
-        # Filter movies that have director information and valid years
-        {
-            "$match": {
-                "directors": {"$exists": True, "$ne": None, "$ne": []},  # Has directors array
-                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}  # Valid year range
-            }
-        },
-        
-        # STAGE 2: $unwind - Flatten Directors Array
-        # Convert each movie's directors array into separate documents
-        # Example: Movie with ["Director A", "Director B"] becomes 2 documents
-        {
-            "$unwind": "$directors"
-        },
-        
-        # STAGE 3: $match - Clean Director Names
-        # Filter out any null or empty director names after unwinding
-        {
-            "$match": {
-                "directors": {"$ne": None, "$ne": ""}
-            }
-        },
-        
-        # STAGE 4: $group - Aggregate by Director
-        # Group all movies by director name and calculate statistics
-        {
-            "$group": {
-                "_id": "$directors",  # Group by individual director name
-                "movieCount": {"$sum": 1},  # Count movies per director
-                "averageRating": {"$avg": "$imdb.rating"}  # Average rating of director's movies
-            }
-        },
-        
-        # STAGE 5: $sort - Rank Directors by Movie Count
-        # Sort directors by number of movies (highest first)
-        {"$sort": {"movieCount": -1}},  # -1 = descending (most movies first)
-        
-        # STAGE 6: $limit - Restrict Results
-        # Limit to top N directors based on user input
-        {"$limit": limit},
-        
-        # STAGE 7: $project - Shape Final Output
-        # Transform the grouped data into a clean, readable format
-        {
-            "$project": {
-                "director": "$_id",  # Rename _id to director
-                "movieCount": 1,
-                "averageRating": {"$round": ["$averageRating", 2]},  # Round to 2 decimal places
-                "_id": 0  # Exclude the _id field from output
-            }
-        }
-    ]
+    # Convert string IDs to ObjectIds if _id filter is present
+    if "_id" in filter_data and isinstance(filter_data["_id"], dict):
+        if "$in" in filter_data["_id"]:
+            # Convert list of string IDs to ObjectIds
+            try:
+                filter_data["_id"]["$in"] = [ObjectId(id_str) for id_str in filter_data["_id"]["$in"]]
+            except Exception:
+                return create_error_response(
+                    message="Invalid ObjectId format in filter",
+                    code="INVALID_OBJECT_ID",
+                    details=None
+                )
 
-    # Execute the aggregation
     try:
-        results = await execute_aggregation(pipeline)
+        result = await movies_collection.update_many(filter_data, {"$set": update_data})
     except Exception as e:
         return create_error_response(
-            message="Database error occurred during aggregation",
-            code="INTERNAL_SERVER_ERROR",
+            message="An error occurred while updating movies.",
+            code="DATABASE_ERROR",
             details=str(e)
         )
     
-    return create_success_response(
-        results, 
-        f"Found {len(results)} directors with most movies"
-    )
-
-
+    return create_success_response({
+        "matchedCount": result.matched_count,
+        "modifiedCount": result.modified_count
+        },
+        f"Update operation completed. Matched {result.matched_count} movie(s), modified {result.modified_count} movie(s)."
+)
 
 #------------------------------------
-# Place get_movie_by_id endpoint here
+# Place delete_movie endpoint here
 #------------------------------------
 
 """
-    GET /api/movies/{id}
-    Retrieve a single movie by its ID.
+    DELETE /api/movies/{id}
+    Delete a single movie by its ID.
     Path Parameters:
-        id (str): The ObjectId of the movie to retrieve.
+        id (str): The ObjectId of the movie to delete.
     Returns:
-        SuccessResponse[Movie]: A response object containing the movie data.
+        SuccessResponse[dict]: A response object containing deletion details.
 """
 
-@router.get("/{id}",
-            response_model=SuccessResponse[Movie],
-            status_code=200,
-            summary="Retrieve a single movie by its ID.")
-async def get_movie_by_id(id: str):
-    # Validate ObjectId format
+@router.delete("/{id}",
+                response_model=SuccessResponse[dict],
+                status_code=200,
+                summary="Delete a single movie by its ID.")
+async def delete_movie_by_id(id: str):
     try:
         object_id = ObjectId(id)
     except InvalidId:
@@ -783,7 +508,8 @@ async def get_movie_by_id(id: str):
 
     movies_collection = get_collection("movies")
     try:
-        movie = await movies_collection.find_one({"_id": object_id})
+        # Use deleteOne() to remove a single document
+        result = await movies_collection.delete_one({"_id": object_id})
     except Exception as e:
         return create_error_response(
             message="Database error occurred",
@@ -791,548 +517,819 @@ async def get_movie_by_id(id: str):
             details=str(e)
         )
 
-    if movie is None:
+    if result.deleted_count == 0:
         return create_error_response(
             message="Movie not found",
-            code="INTERNAL_SERVER_ERROR",
+            code="INTERNAL_SERVER_ERROR", 
             details=f"No movie found with ID: {id}"
         )
-
-    movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
     
-    return create_success_response(movie, "Movie retrieved successfully")
+    return create_success_response(
+        {"deletedCount": result.deleted_count}, 
+        "Movie deleted successfully"
+    )
 
+#------------------------------------
+# Place delete_movies_by_batch endpoint here
+#------------------------------------
 """
-    GET /api/movies/
+    DELETE /api/movies/
 
-    Retrieve a list of movies with optional filtering, sorting, and pagination.
+    Delete multiple movies matching the given filter.
 
-    Query Parameters:
-        q (str, optional): Text search query (searches title, plot, fullplot).
-        genre (str, optional): Filter by genre.
-        year (int, optional): Filter by year.
-        min_rating (float, optional): Minimum IMDB rating.
-        max_rating (float, optional): Maximum IMDB rating.
-        limitNum (int, optional): Number of results to return (default: 20, max: 100).
-        skipNum (int, optional): Number of documents to skip for pagination (default: 0).
-        sortBy (str, optional): Field to sort by (default: "title").
-        sort_order (str, optional): Sort direction, "asc" or "desc" (default: "asc").
+    Request Body:
+        movie_filter (MovieFilter): Criteria to select which movies to delete. Only movies matching this filter will be removed.
 
-    Returns:
-        SuccessResponse[List[Movie]]: A response object containing the list of movies and metadata.
+        Returns:
+        SuccessResponse: An object containing the number of deleted movies and a success message.
 """
 
-@router.get("/",
-            response_model=SuccessResponse[List[Movie]],
-            status_code=200,
-            summary="Retrieve a list of movies with optional filtering, sorting, and pagination.")
-# Validate the query parameters using FastAPI's Query functionality.
-async def get_all_movies(
-    q:str = Query(default=None),
-    title: str = Query(default=None),
-    genre:str = Query(default=None),
-    year:int = Query(default=None),
-    min_rating:float = Query(default=None),
-    max_rating:float = Query(default=None),
-    limit:int = Query(default=20, ge=1, le=100),
-    skip:int = Query(default=0, ge=0),
-    sort_by:str = Query(default="title"),
-    sort_order:str = Query(default="asc")
-):
+@router.delete(
+        "/",
+        response_model=SuccessResponse[dict],
+        status_code=200,
+        summary="Delete multiple movies matching the given filter."
+)
+async def delete_movies_batch(request_body: dict = Body(...)) -> SuccessResponse[dict]:
+
     movies_collection = get_collection("movies")
-    filter_dict = {}
-    if q:
-        filter_dict["$text"] = {"$search": q} 
-    if title:
-        filter_dict["title"] = {"$regex": title, "$options": "i"}       
-    if genre:
-        filter_dict["genres"] = {"$regex": genre, "$options": "i"}
-    if year:
-        filter_dict["year"] = year
-    if min_rating is not None or max_rating is not None:
-        rating_filter = {}
-        if min_rating is not None:
-            rating_filter["$gte"] = min_rating
-        if max_rating is not None:
-            rating_filter["$lte"] = max_rating
-        filter_dict["imdb.rating"] = rating_filter
-        
-    # Building the sort object based on user input
-    sort_order = -1 if sort_order == "desc" else 1
+    
+    # Extract filter from the request body
+    filter_data = request_body.get("filter", {})
 
-    sort = [(sort_by, sort_order)]
+    if not filter_data:
+        return create_error_response(
+            message="Filter object is required and cannot be empty.",
+            code="MISSING_FILTER",
+            details=None
+        )
 
-    # Query the database with the constructed filter, sort, skip, and limit.
+    # Convert string IDs to ObjectIds if _id filter is present
+    if "_id" in filter_data and isinstance(filter_data["_id"], dict):
+        if "$in" in filter_data["_id"]:
+            # Convert list of string IDs to ObjectIds
+            try:
+                filter_data["_id"]["$in"] = [ObjectId(id_str) for id_str in filter_data["_id"]["$in"]]
+            except Exception:
+                return create_error_response(
+                    message="Invalid ObjectId format in filter",
+                    code="INVALID_OBJECT_ID",
+                    details=None
+                )
 
     try:
-        result = movies_collection.find(filter_dict).sort(sort).skip(skip).limit(limit)  
+        result = await movies_collection.delete_many(filter_data)
     except Exception as e:
         return create_error_response(
-            message="An error occurred while fetching movies.",
+            message="An error occurred while deleting movies.",
             code="DATABASE_ERROR",
             details=str(e)
-        )   
-
-    movies = []
-
-    async for movie in result:
-        movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
-        # Ensure that the year field contains int value.
-        if "year" in movie and not isinstance(movie["year"], int):
-            cleaned_year = re.sub(r"\D", "", str(movie["year"]))
-            try:
-                movie["year"] = int(cleaned_year) if cleaned_year else None
-            except ValueError:
-                movie["year"] = None
+        )
 
-        movies.append(movie)            
-    # Return the results wrapped in a SuccessResponse    
-    return create_success_response(movies, f"Found {len(movies)} movies.")
+    return create_success_response(
+        {"deletedCount":result.deleted_count},
+        f'Delete operation completed. Removed {result.deleted_count} movies.'
+    )
 
 #------------------------------------
-# Place create_movie endpoint here
+# Place find_and_delete_movie endpoint here
 #------------------------------------
 
 """
-    POST /api/movies/
-    Create a new movie.
-    Request Body:
-        movie (CreateMovieRequest): A movie object containing the movie data.
-            See CreateMovieRequest model for available fields.
+    DELETE /api/movies/{id}/find-and-delete
+    Finds and deletes a movie in a single atomic operation.
+    Demonstrates the findOneAndDelete() operation.
+    Path Parameters:
+        id (str): The ObjectId of the movie to find and delete.
     Returns:
-        SuccessResponse[Movie]: A response object containing the created movie data.
+        SuccessResponse[Movie]: A response object containing the deleted movie data.
 """
 
-@router.post("/", 
-            response_model=SuccessResponse[Movie],
-            status_code=201,
-            summary="Creates a new movie in the database.")
-async def create_movie(movie: CreateMovieRequest):
-    # Pydantic automatically validates the structure
-    movie_data = movie.model_dump(by_alias=True, exclude_none=True)
-    
-    movies_collection = get_collection("movies")
+@router.delete("/{id}/find-and-delete",
+                response_model=SuccessResponse[Movie],
+                status_code=200,
+                summary="Find and delete a movie in a single operation.")
+async def find_and_delete_movie(id: str):
     try:
-        result = await movies_collection.insert_one(movie_data)
-    except Exception as e:
-        return create_error_response(
-            message="Database error occurred",
-            code="INTERNAL_SERVER_ERROR",
-            details=str(e)
-        )
-    
-    # Verify that the document was created before querying it
-    if not result.acknowledged:
+        object_id = ObjectId(id)
+    except InvalidId:
         return create_error_response(
-            message="Failed to create movie",
+            message="Invalid movie ID format",
             code="INTERNAL_SERVER_ERROR",
-            details="The database did not acknowledge the insert operation"
+            details=f"The provided ID '{id}' is not a valid ObjectId"
         )
-    
+
+    movies_collection = get_collection("movies")
+    # Use find_one_and_delete() to find and delete in a single atomic operation
+    # This is useful when you need to return the deleted document
+    # or ensure the document exists before deletion
     try:
-        # Retrieve the created document to return complete data
-        created_movie = await movies_collection.find_one({"_id": result.inserted_id})
+        deleted_movie = await movies_collection.find_one_and_delete({"_id": object_id})
     except Exception as e:
         return create_error_response(
             message="Database error occurred",
             code="INTERNAL_SERVER_ERROR",
             details=str(e)
         )
-    
-    if created_movie is None:
+
+    if deleted_movie is None:
         return create_error_response(
-            message="Movie creation verification failed",
-            code="INTERNAL_SERVER_ERROR",
-            details="Movie was created but could not be retrieved for verification"
+            message="Movie not found",
+            code="INTERNAL_SERVER_ERROR", 
+            details=f"No movie found with ID: {id}"
         )
-
-    created_movie["_id"] = str(created_movie["_id"]) # Convert ObjectId to string
+    deleted_movie["_id"] = str(deleted_movie["_id"]) # Convert ObjectId to string
     
-    return create_success_response(created_movie, f"Movie '{movie_data['title']}' created successfully")
-
-#------------------------------------
-# Place create_movies_batch endpoint here
-#------------------------------------
+    return create_success_response(deleted_movie, "Movie found and deleted successfully")
 
 """
-POST /api/movies/batch
-
-Create multiple movies in a single request. 
-
-Request Body:
-        movies (List[CreateMovieRequest]): A list of movie objects to insert. Each object should include:
-            - title (str): The movie title.
-            - year (int, optional): The release year.
-            - plot (str, optional): Short plot summary.
-            - fullplot (str, optional): Full plot summary.
-            - genres (List[str], optional): List of genres.
-            - directors (List[str], optional): List of directors.
-            - writers (List[str], optional): List of writers.
-            - cast (List[str], optional): List of cast members.
-            - countries (List[str], optional): List of countries.
-            - languages (List[str], optional): List of languages.
-            - rated (str, optional): Movie rating.
-            - runtime (int, optional): Runtime in minutes.
-            - poster (str, optional): Poster URL.
-
+    GET /api/movies/aggregations/reportingByComments
+    Aggregate movies with their most recent comments using MongoDB $lookup aggregation.
+    Joins movies with comments collection to show recent comment activity.
+    Query Parameters:
+        limit (int, optional): Number of results to return (default: 10, max: 50).
+        movie_id (str, optional): Filter by specific movie ObjectId.
     Returns:
-        SuccessResponse: A response object containing the number of inserted movies and their IDs.
-
+        SuccessResponse[List[dict]]: A response object containing movies with their most recent comments.
 """
 
-@router.post(
-        "/batch",
-        response_model=SuccessResponse[dict],
-        status_code = 201,
-        summary = "Create multiple movies in a single request."
-        )
-async def create_movies_batch(movies: List[CreateMovieRequest]) ->SuccessResponse[dict]:
-    movies_collection = get_collection("movies")
-
-    #Verify that the movies list is not empty
-    if not movies:
-        return create_error_response(
-            message="Request body must be a non-empty list of movies.",
-            code="INVALID_INPUT",
-            details=None
-        )
-    
-    movies_dicts = []
-
-    for movie in movies:
-        movies_dicts.append(movie.model_dump(exclude_unset=True, exclude_none=True))
-
-    try:
-        result = await movies_collection.insert_many(movies_dicts)
-    except Exception as e:
-        return create_error_response(
-            message="An error occurred while creating movies.",
-            code="DATABASE_ERROR",
-            details=str(e)
-        )    
+@router.get("/aggregations/reportingByComments",
+            response_model=SuccessResponse[List[dict]],
+            status_code=200,
+            summary="Aggregate movies with their most recent comments.")
+async def aggregate_movies_recent_commented(
+    limit: int = Query(default=10, ge=1, le=50),
+    movie_id: str = Query(default=None)
+):
     
-    try:
-        result = await movies_collection.insert_many(movies_dicts)
-    except Exception as e:
-        return create_error_response(
-            message="Database error occurred during batch creation",
-            code="INTERNAL_SERVER_ERROR",
-            details=str(e)
-        )
+    # Add a multi-stage aggregation that:
+    # 1. Filters movies by valid year range
+    # 2. Joins with comments collection (like SQL JOIN)
+    # 3. Filters to only movies that have comments
+    # 4. Sorts comments by date and extracts most recent ones
+    # 5. Sorts movies by their most recent comment date
+    # 6. Shapes the final output with transformed comment structure
     
-    return create_success_response({
-        "insertedCount": len(result.inserted_ids),
-        "insertedIds": [str(_id) for _id in result.inserted_ids]
-        },
-        f"Successfully created {len(result.inserted_ids)} movies."
-    )
-
-#------------------------------------
-# Place update_movie endpoint here
-#------------------------------------
-
-"""    
-    PATCH /api/movies/{id}
-
-    Update a single movie by its ID.
-
-    Path Parameters:
-        id (str): The ObjectId of the movie to update
-
-    Request Body:
-        move_data (UpdateMovieRequest): Fields and values to update. Only provided fields will be updated.
-
-    Returns:
-        SuccessResponse: The updated movie document, the number of fields modified and a success message.
-"""
-@router.patch(
-        "/{id}",
-        response_model=SuccessResponse[Movie],
-        status_code=200,
-        summary="Update a single movie by its ID.")
-async def update_movie(
-    movie_data: UpdateMovieRequest,
-    movie_id: str = Path(..., alias="id")
-) -> SuccessResponse[Movie]:
+    pipeline = [
+        # STAGE 1: $match - Initial Filter
+        # Filter movies to only those with valid year data
+        {
+            "$match": {
+                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
+            }
+        }
+    ]
 
-    movies_collection = get_collection("movies")
-    
-    # Validate the ObjectId
-    try:
-        movie_id = ObjectId(movie_id)
-    except Exception :
-        return create_error_response(
-            message="Invalid movie_id format.",
-            code="INVALID_OBJECT_ID",
-            details=str(movie_id)
-        )    
+    # Add movie_id filter if provided
+    if movie_id:
+        try:
+            object_id = ObjectId(movie_id)
+            pipeline[0]["$match"]["_id"] = object_id
+        except Exception:
+            return create_error_response(
+                message="Invalid movie ID format",
+                code="INTERNAL_SERVER_ERROR",
+                details="The provided movie_id is not a valid ObjectId"
+            )
     
-    update_dict = movie_data.model_dump(exclude_unset=True, exclude_none=True)
-
-    # Validate that the dict is not empty
-    if not update_dict:
-        return create_error_response(
-            message="No valid fields provided for update.",
-            code="NO_UPDATE_DATA",
-            details=None
-        )
-
+    # Add remaining pipeline stages
+    pipeline.extend([
+        # STAGE 2: $lookup - Join with the 'comments' Collection
+        # This gives each movie document a 'comments' array containing all its comments
+        {
+            "$lookup": {
+                "from": "comments",
+                "localField": "_id",
+                "foreignField": "movie_id",
+                "as": "comments"
+            }
+        },
+        # STAGE 3: $match - Filter Movies with at Least One Comment
+        # This helps reduces dataset to only movies with user engagement
+        {
+            "$match": {
+                "comments": {"$ne": []}
+            }
+        },
+        # STAGE 4: $addFields - Add New Computed Fields
+        {
+            "$addFields": {
+                # Add computed field 'recentComments' that extracts only the N most recent comments (up to 'limit')
+                "recentComments": {
+                    "$slice": [
+                        {
+                            "$sortArray": {
+                                "input": "$comments",
+                                "sortBy": {"date": -1}  # -1 = descending (newest first)
+                            }
+                        },
+                        limit  # Number of comments to keep
+                    ]
+                },
+                # Add computed field 'mostRecentCommentDate' that gets the date of the most recent comment (to use in the next $sort stage)
+                "mostRecentCommentDate": {
+                    "$max": "$comments.date"
+                }
+            }
+        },
+        # STAGE 5: $sort - Sort Movies by Most Recent Comment Date
+        {
+            "$sort": {"mostRecentCommentDate": -1}
+        },
+        # STAGE 6: $limit - Restrict Result Set Size
+        # - If querying single movie: return up to 50 results
+        # - If querying all movies: return up to 20 results
+        # Tip: This prevents overwhelming the client with too much data
+        {
+            "$limit": 50 if movie_id else 20
+        },
+        # STAGE 7: $project - Shape Final Response Output
+        {
+            "$project": {
+                # Include basic movie fields
+                "title": 1,
+                "year": 1,
+                "genres": 1,
+                "_id": 1,
+                # Extract nested field: imdb.rating -> imdbRating
+                "imdbRating": "$imdb.rating",
+                # Use $map to reshape computed 'recentComments' field with cleaner field names
+                "recentComments": {
+                    "$map": {
+                        "input": "$recentComments",
+                        "as": "comment",
+                        "in": {
+                            "userName": "$$comment.name",      # Rename: name -> userName
+                            "userEmail": "$$comment.email",    # Rename: email -> userEmail
+                            "text": "$$comment.text",          # Keep: text
+                            "date": "$$comment.date"           # Keep: date
+                        }
+                    }
+                },
+                # Calculate the total number of comments into 'totalComments' (not just 'recentComments')
+                # Used in display (e.g., "Showing 5 of 127 comments")
+                "totalComments": {"$size": "$comments"}
+            }
+        }
+    ])
+    # Execute the aggregation
     try:
-        result = await movies_collection.update_one(
-            {"_id": movie_id},
-            {"$set":update_dict}
-        )
+        results = await execute_aggregation(pipeline)
     except Exception as e:
         return create_error_response(
-            message="An error occurred while updating the movie.",
-            code="DATABASE_ERROR",
+            message="Database error occurred during aggregation",
+            code="INTERNAL_SERVER_ERROR",
             details=str(e)
-        )    
-
-    if result.matched_count == 0:
-        return create_error_response(
-            message="No movie with that _id was found.",
-            code="MOVIE_NOT_FOUND",
-            details=str(movie_id)
         )
-    
-    updatedMovie = await movies_collection.find_one({"_id": movie_id})
-    print(updatedMovie)
-    updatedMovie["_id"] = str(updatedMovie["_id"])
 
-    return create_success_response(updatedMovie, f"Movie updated successfully. Modified {len(update_dict)} fields.")
-
-#------------------------------------
-# Place update_movies_by_batch endpoint here
-#------------------------------------
+    # Convert ObjectId to string for response
+    for result in results:
+        if "_id" in result:
+            result["_id"] = str(result["_id"])
+    
+    # Calculate total comments from all movies
+    total_comments = sum(result.get("totalComments", 0) for result in results)
+    
+    return create_success_response(
+        results, 
+        f"Found {total_comments} comments from movie{'s' if len(results) != 1 else ''}"
+    )
 
 """
-    PATCH /api/movies
-
-    Batch update movies matching the given filter
-
-    Request Body:
-        filter (MoviesUpdateFilter): Criteria to select which movies to update. Only movies matching this filter will be updated.
-        update (UpdateMovieRequest): Fields and values to update for the matched movies. Only provided fields will be updated.
+    GET /api/movies/aggregations/reportingByYear
+    Aggregate movies by year with average rating and movie count.
+    Reports yearly statistics including average rating and total movies per year.
     Returns:
-        SuccessResponse: A response object containing the number of matched and modified movies and a success message.
+        SuccessResponse[List[dict]]: A response object containing yearly movie statistics.
 """
 
-@router.patch("/",
-        response_model=SuccessResponse[dict],
-        status_code=200,
-        summary="Batch update movies matching the given filter."
-        )
-async def update_movies_batch(
-    request_body: dict = Body(...)
-) -> SuccessResponse[dict]:
-    movies_collection = get_collection("movies")
-
-    # Extract filter and update from the request body
-    filter_data = request_body.get("filter", {})
-    update_data = request_body.get("update", {})
-
-    if not filter_data or not update_data:
-        return create_error_response(
-            message="Both filter and update objects are required",
-            code="MISSING_REQUIRED_FIELDS",
-            details=None
-        )
+@router.get("/aggregations/reportingByYear",
+            response_model=SuccessResponse[List[dict]],
+            status_code=200,
+            summary="Aggregate movies by year with average rating and movie count.")
+async def aggregate_movies_by_year():
+    # Define aggregation pipeline to group movies by year with statistics
+    # This pipeline demonstrates grouping, statistical calculations, and data cleaning
 
-    # Convert string IDs to ObjectIds if _id filter is present
-    if "_id" in filter_data and isinstance(filter_data["_id"], dict):
-        if "$in" in filter_data["_id"]:
-            # Convert list of string IDs to ObjectIds
-            try:
-                filter_data["_id"]["$in"] = [ObjectId(id_str) for id_str in filter_data["_id"]["$in"]]
-            except Exception:
-                return create_error_response(
-                    message="Invalid ObjectId format in filter",
-                    code="INVALID_OBJECT_ID",
-                    details=None
-                )
+    # Add a multi-stage aggregation that:
+    # 1. Filters movies by valid year range (data quality filter)
+    # 2. Groups movies by release year and calculates statistics per year
+    # 3. Shapes the final output with clean field names and rounded averages
+    # 4. Sorts results by year (newest first) for chronological presentation
+    
+    pipeline = [
+        # STAGE 1: $match - Data Quality Filter
+        # Clean data: ensure year is an integer and within reasonable range
+        # Tip: Filter early to reduce dataset size and improve performance
+        {
+            "$match": {
+                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
+            }
+        },
+        
+        # STAGE 2: $group - Aggregate Movies by Year
+        # Group all movies by their release year and calculate various statistics
+        {
+            "$group": {
+                "_id": "$year",  # Group by year field
+                "movieCount": {"$sum": 1},  # Count total movies per year
+                
+                # Calculate average rating (only for valid numeric ratings)
+                "averageRating": {
+                    "$avg": {
+                        "$cond": [
+                            {"$and": [
+                                {"$ne": ["$imdb.rating", None]},           # Not null
+                                {"$ne": ["$imdb.rating", ""]},             # Not empty string
+                                {"$eq": [{"$type": "$imdb.rating"}, "double"]}  # Is numeric
+                            ]},
+                            "$imdb.rating",  # Include valid IMDB ratings
+                            "$$REMOVE"       # Exclude invalid IMDB ratings
+                        ]
+                    }
+                },
+                
+                # Find highest rating for the year (same validation as average rating)
+                "highestRating": {
+                    "$max": {
+                        "$cond": [
+                            {"$and": [
+                                {"$ne": ["$imdb.rating", None]},
+                                {"$ne": ["$imdb.rating", ""]},
+                                {"$eq": [{"$type": "$imdb.rating"}, "double"]}
+                            ]},
+                            "$imdb.rating",
+                            "$$REMOVE"
+                        ]
+                    }
+                },
+                
+                # Find lowest rating for the year (same validation as average and highest rating)
+                "lowestRating": {
+                    "$min": {
+                        "$cond": [
+                            {"$and": [
+                                {"$ne": ["$imdb.rating", None]},
+                                {"$ne": ["$imdb.rating", ""]},
+                                {"$eq": [{"$type": "$imdb.rating"}, "double"]}
+                            ]},
+                            "$imdb.rating",
+                            "$$REMOVE"
+                        ]
+                    }
+                },
+                
+                # Sum total votes across all movies in the year
+                "totalVotes": {"$sum": "$imdb.votes"}
+            }
+        },
+        
+        # STAGE 3: $project - Shape Final Output
+        # Transform the grouped data into a clean, readable format
+        {
+            "$project": {
+                "year": "$_id",  # Rename _id back to year because grouping was done by year but values were stored in _id
+                "movieCount": 1,
+                "averageRating": {"$round": ["$averageRating", 2]},  # Round to 2 decimal places
+                "highestRating": 1,
+                "lowestRating": 1,
+                "totalVotes": 1,
+                "_id": 0  # Exclude the _id field from output
+            }
+        },
+        
+        # STAGE 4: $sort - Sort by Year (Newest First)
+        # Sort results in descending order to show most recent years first
+        {"$sort": {"year": -1}}  # -1 = descending order
+    ]
 
+    # Execute the aggregation
     try:
-        result = await movies_collection.update_many(filter_data, {"$set": update_data})
+        results = await execute_aggregation(pipeline)
     except Exception as e:
         return create_error_response(
-            message="An error occurred while updating movies.",
-            code="DATABASE_ERROR",
+            message="Database error occurred during aggregation",
+            code="INTERNAL_SERVER_ERROR",
             details=str(e)
         )
     
-    return create_success_response({
-        "matchedCount": result.matched_count,
-        "modifiedCount": result.modified_count
-        },
-        f"Update operation completed. Matched {result.matched_count} movie(s), modified {result.modified_count} movie(s)."
-)
-
-#------------------------------------
-# Place delete_movie endpoint here
-#------------------------------------
+    return create_success_response(
+        results, 
+        f"Aggregated statistics for {len(results)} years"
+    )
 
 """
-    DELETE /api/movies/{id}
-    Delete a single movie by its ID.
-    Path Parameters:
-        id (str): The ObjectId of the movie to delete.
+    GET /api/movies/aggregations/reportingByDirectors
+    Aggregate directors with the most movies and their statistics.
+    Reports directors sorted by number of movies directed.
+    Query Parameters:
+        limit (int, optional): Number of results to return (default: 20, max: 100).
     Returns:
-        SuccessResponse[dict]: A response object containing deletion details.
+        SuccessResponse[List[dict]]: A response object containing director statistics.
 """
 
-@router.delete("/{id}",
-                response_model=SuccessResponse[dict],
-                status_code=200,
-                summary="Delete a single movie by its ID.")
-async def delete_movie_by_id(id: str):
-    try:
-        object_id = ObjectId(id)
-    except InvalidId:
-        return create_error_response(
-            message="Invalid movie ID format",
-            code="INTERNAL_SERVER_ERROR",
-            details=f"The provided ID '{id}' is not a valid ObjectId"
-        )
+@router.get("/aggregations/reportingByDirectors",
+            response_model=SuccessResponse[List[dict]],
+            status_code=200,
+            summary="Aggregate directors with the most movies and their statistics.")
+async def aggregate_directors_most_movies(
+    limit: int = Query(default=20, ge=1, le=100)
+):
+    # Define aggregation pipeline to find directors with the most movies
+    # This pipeline demonstrates array unwinding, filtering, and ranking
+    
+    # Add a multi-stage aggregation that:
+    # 1. Filters movies with valid directors and year data (data quality filter)
+    # 2. Unwinds directors array to create separate documents per director
+    # 3. Cleans director names by filtering out null/empty names
+    # 4. Groups movies by individual director and calculates statistics per director
+    # 5. Sorts directors based on movie count
+    # 6. Limits results to top N directors
+    # 7. Shapes the final output with clean field names and rounded averages
 
-    movies_collection = get_collection("movies")
+    pipeline = [
+        # STAGE 1: $match - Initial Data Quality Filter
+        # Filter movies that have director information and valid years
+        {
+            "$match": {
+                "directors": {"$exists": True, "$ne": None, "$ne": []},  # Has directors array
+                "year": {"$type": "number", "$gte": 1800, "$lte": 2030}  # Valid year range
+            }
+        },
+        
+        # STAGE 2: $unwind - Flatten Directors Array
+        # Convert each movie's directors array into separate documents
+        # Example: Movie with ["Director A", "Director B"] becomes 2 documents
+        {
+            "$unwind": "$directors"
+        },
+        
+        # STAGE 3: $match - Clean Director Names
+        # Filter out any null or empty director names after unwinding
+        {
+            "$match": {
+                "directors": {"$ne": None, "$ne": ""}
+            }
+        },
+        
+        # STAGE 4: $group - Aggregate by Director
+        # Group all movies by director name and calculate statistics
+        {
+            "$group": {
+                "_id": "$directors",  # Group by individual director name
+                "movieCount": {"$sum": 1},  # Count movies per director
+                "averageRating": {"$avg": "$imdb.rating"}  # Average rating of director's movies
+            }
+        },
+        
+        # STAGE 5: $sort - Rank Directors by Movie Count
+        # Sort directors by number of movies (highest first)
+        {"$sort": {"movieCount": -1}},  # -1 = descending (most movies first)
+        
+        # STAGE 6: $limit - Restrict Results
+        # Limit to top N directors based on user input
+        {"$limit": limit},
+        
+        # STAGE 7: $project - Shape Final Output
+        # Transform the grouped data into a clean, readable format
+        {
+            "$project": {
+                "director": "$_id",  # Rename _id to director
+                "movieCount": 1,
+                "averageRating": {"$round": ["$averageRating", 2]},  # Round to 2 decimal places
+                "_id": 0  # Exclude the _id field from output
+            }
+        }
+    ]
+
+    # Execute the aggregation
     try:
-        # Use deleteOne() to remove a single document
-        result = await movies_collection.delete_one({"_id": object_id})
+        results = await execute_aggregation(pipeline)
     except Exception as e:
         return create_error_response(
-            message="Database error occurred",
+            message="Database error occurred during aggregation",
             code="INTERNAL_SERVER_ERROR",
             details=str(e)
         )
-
-    if result.deleted_count == 0:
-        return create_error_response(
-            message="Movie not found",
-            code="INTERNAL_SERVER_ERROR", 
-            details=f"No movie found with ID: {id}"
-        )
     
     return create_success_response(
-        {"deletedCount": result.deleted_count}, 
-        "Movie deleted successfully"
+        results, 
+        f"Found {len(results)} directors with most movies"
     )
 
-#------------------------------------
-# Place delete_movies_by_batch endpoint here
-#------------------------------------
+#----------------------------------------------------------------------------------------------------------
+# MongoDB Search
+#
+# MongoDB Search based on searching the plot, fullplot, directors, writers, and cast fields.
+# This function was made with the assumption that the UI will have fields for plot,fullplot, 
+# directors, writers, and cast to search on. Or some sort of combined search field.
+# Also this fuzzy operator is being used to allow for some misspellings in the search terms
+# but that allows for very generous matching. This can be adjusted as needed.
+#----------------------------------------------------------------------------------------------------------
 """
-    DELETE /api/movies/
 
-    Delete multiple movies matching the given filter.
+    GET /api/movies/search
 
-    Request Body:
-        movie_filter (MovieFilter): Criteria to select which movies to delete. Only movies matching this filter will be removed.
+    Search movies using MongoDB Search across the plot, fullplot, directors, writers, and cast fields.
+    You can combine multiple fields in a single query, and control how they are combined using the `search_operator` parameter.
 
-        Returns:
-        SuccessResponse: An object containing the number of deleted movies and a success message.
-"""
+    Query Parameters:
+        plot (str, optional): Text to search against the plot field.
+        fullplot (str, optional): Text to search against the fullplot field.
+        directors (str, optional): Text to search against the directors field.
+        writers (str, optional): Text to search against the writers field.
+        cast (str, optional): Text to search against the cast field.
+        limit (int, optional): Number of results to return (default: 20)
+        skip (int, optional): Number of results to skip for pagination (default: 0)
+        search_operator (str, optional): How to combine multiple search fields. 
+            Must be one of "must", "should", "mustNot", or "filter". Default is "must".
 
-@router.delete(
-        "/",
-        response_model=SuccessResponse[dict],
-        status_code=200,
-        summary="Delete multiple movies matching the given filter."
+    Returns:
+        SuccessResponse[SearchMoviesResponse]: A response object containing the list of matching movies and total count.
+"""
+@router.get(
+    "/search/mongodb-search",
+    response_model=SuccessResponse[SearchMoviesResponse],
+    status_code=200,
+    summary="Search movies using MongoDB Search."
 )
-async def delete_movies_batch(request_body: dict = Body(...)) -> SuccessResponse[dict]:
+async def search_movies(
+    plot: str = Query(default=None),
+    fullplot: str = Query(default=None),
+    directors: str = Query(default=None),
+    writers: str = Query(default=None),
+    cast: str = Query(default=None),
+    limit:int = Query(default=20, ge=1, le=100),
+    skip:int = Query(default=0, ge=0),
+    search_operator: str = Query(default="must")
+) -> SuccessResponse[SearchMoviesResponse]:
+    
+    search_phrases = []
+
+    # Validate the search_operator parameter to ensure it's a valid compound operator
+    valid_operators = {"must", "should", "mustNot", "filter"}
+    if search_operator not in valid_operators:
+        return create_error_response(
+        message=f"Invalid search_operator '{search_operator}'. The search_operator must be one of {valid_operators}.",
+        code="INVALID_SEARCH_OPERATOR",
+        details=None
+    )
+
+    # Build the search_phrases list based on which fields were provided by the user.
+    # Each phrase becomes a separate clause in the MongoDB Search compound query.
+
+    if plot:
+        search_phrases.append({
+            # The phrase operator performs an exact phrase match on the specified field. This is useful for searching for specific phrases within text fields.
+            # The text operator is more flexible and allows for fuzzy matching, making it suitable for fields like names where typos may occur.
+            "phrase": {
+                "query": plot,
+                "path": "plot",
+            }
+        })
+    if fullplot:
+        search_phrases.append({
+            "phrase": {
+                "query": fullplot,
+                "path": "fullplot",
+            }
+        })
+    if directors:
+        # The "fuzzy" option enables typo-tolerant (fuzzy) search within MongoDB Search.
+        # - maxEdits: The maximum number of single-character edits (insertions, deletions, or substitutions)
+        #             allowed when matching the search term to indexed terms. (Range: 1-2; higher = more tolerant)
+        # - prefixLength: The number of initial characters that must exactly match before fuzzy matching is applied.
+        #             (Higher values make the search stricter and faster.)
+        # For more details, see: https://www.mongodb.com/docs/atlas/atlas-search/operators-collectors/text/
 
-    movies_collection = get_collection("movies")
-    
-    # Extract filter from the request body
-    filter_data = request_body.get("filter", {})
+        search_phrases.append({
+            "text": {
+                "query": directors,
+                "path": "directors",
+                "fuzzy":{"maxEdits":1, "prefixLength":5}
 
-    if not filter_data:
+            }
+        })
+    if writers:
+        # See comments above regarding fuzzy search options.
+        search_phrases.append({
+            "text": {
+                "query": writers,
+                "path": "writers",
+                "fuzzy":{"maxEdits":1, "prefixLength":5}
+            }
+        })
+    if cast:
+        # See comments above regarding fuzzy search options.
+        search_phrases.append({
+            "text": {
+                "query": cast,
+                "path": "cast",
+                "fuzzy":{"maxEdits":1, "prefixLength":5}
+            }
+        })
+
+    if not search_phrases:
         return create_error_response(
-            message="Filter object is required and cannot be empty.",
-            code="MISSING_FILTER",
+            message="At least one search parameter must be provided.",
+            code="NO_SEARCH_PARAMETERS",
             details=None
         )
 
-    # Convert string IDs to ObjectIds if _id filter is present
-    if "_id" in filter_data and isinstance(filter_data["_id"], dict):
-        if "$in" in filter_data["_id"]:
-            # Convert list of string IDs to ObjectIds
-            try:
-                filter_data["_id"]["$in"] = [ObjectId(id_str) for id_str in filter_data["_id"]["$in"]]
-            except Exception:
-                return create_error_response(
-                    message="Invalid ObjectId format in filter",
-                    code="INVALID_OBJECT_ID",
-                    details=None
-                )
+    # Build the aggregation pipeline for MongoDB Search.
+    # The $search stage uses the specified compound operator (must, should, etc.)
+    aggregation_pipeline = [
+        {
+            "$search": {
+                "index": "movieSearchIndex",
+                "compound": {
+                    search_operator: search_phrases
+                }
+            }
+        },
+        {
+            "$facet": {
+                "totalCount": [
+                    {"$count": "count"}
+                ],
+                "results": [
+                    {"$skip": skip},
+                    {"$limit": limit},
+                    # Project only the fields needed in the response
+                    {
+                        "$project": {
+                            "_id": 1,
+                            "title": 1,
+                            "year": 1,
+                            "plot": 1,
+                            "fullplot": 1,
+                            "released":1,
+                            "runtime": 1,
+                            "poster": 1,
+                            "genres": 1,
+                            "directors": 1,
+                            "writers": 1,
+                            "cast": 1,
+                            "countries": 1,
+                            "languages": 1,
+                            "rated": 1,
+                            "awards": 1,
+                            "imdb": 1,
+                        }
+                    }
+                ]
+            }
+        }
+    ]
 
+    # Execute the aggregation pipeline using the helper function
     try:
-        result = await movies_collection.delete_many(filter_data)
+        results = await execute_aggregation(aggregation_pipeline)
     except Exception as e:
         return create_error_response(
-            message="An error occurred while deleting movies.",
+            message="An error occurred while performing the search.",
             code="DATABASE_ERROR",
             details=str(e)
+        )    
+
+    # Extract total count and movies from facet results with proper bounds checking
+    if not results or len(results) == 0:
+        return create_success_response(
+            SearchMoviesResponse(movies=[], totalCount=0), 
+            "No movies found matching the search criteria."
         )
+    
+    facet_result = results[0]
+    
+    # Safely extract total count
+    total_count_array = facet_result.get("totalCount", [])
+    total_count = total_count_array[0].get("count", 0) if total_count_array else 0
+    
+    # Safely extract movies data
+    movies_data = facet_result.get("results", [])
+    
+    # Convert ObjectId to string for each movie in the results
+    movies = []
+    for movie in movies_data:
+        movie["_id"] = str(movie["_id"])
+        movies.append(movie)
 
     return create_success_response(
-        {"deletedCount":result.deleted_count},
-        f'Delete operation completed. Removed {result.deleted_count} movies.'
-    )
+        SearchMoviesResponse(movies=movies, totalCount=total_count), 
+        f"Found {total_count} movies matching the search criteria."
+      )
+
+#----------------------------------------------------------------------------------------------------------
+# MongoDB Vector Search
+#
+# MongoDB Vector Search based on searching the plot_embedding_voyage_3_large field.
+#----------------------------------------------------------------------------------------------------------
+"""
 
+    GET /api/movies/vector-search
 
+    Search movies using MongoDB Vector Search to find movies with similar plots.
+    Uses embeddings generated by the Voyage AI model to perform semantic similarity search.
 
-#------------------------------------
-# Place find_and_delete_movie endpoint here
-#------------------------------------
+    Query Parameters:
+        q (str, required): Search query text to find movies with similar plots.
+        limit (int, optional): Number of results to return (default: 10, max: 50).
 
-"""
-    DELETE /api/movies/{id}/find-and-delete
-    Finds and deletes a movie in a single atomic operation.
-    Demonstrates the findOneAndDelete() operation.
-    Path Parameters:
-        id (str): The ObjectId of the movie to find and delete.
     Returns:
-        SuccessResponse[Movie]: A response object containing the deleted movie data.
+        SuccessResponse[List[VectorSearchResult]]: A response object containing movies with similarity scores.
+        Each result includes:
+            - _id: Movie ObjectId
+            - title: Movie title  
+            - plot: Movie plot text
+            - score: Vector search similarity score (0.0 to 1.0, higher = more similar)
 """
+# Specify your Voyage API key and embedding model
+model = "voyage-3-large"
+outputDimension = 2048 #Set to 2048 to match the dimensions of the collection's embeddings
 
-@router.delete("/{id}/find-and-delete",
-                response_model=SuccessResponse[Movie],
-                status_code=200,
-                summary="Find and delete a movie in a single operation.")
-async def find_and_delete_movie(id: str):
-    try:
-        object_id = ObjectId(id)
-    except InvalidId:
+# Vector Search Endpoint
+@router.get("/search/vector-search", response_model=SuccessResponse[List[VectorSearchResult]])
+async def vector_search_movies(
+    q: str = Query(..., description="Search query to find similar movies by plot"),
+    limit: int = Query(default=10, ge=1, le=50, description="Number of results to return")
+):
+    """
+    Vector search endpoint for finding movies with similar plots.
+    
+    Args:
+        q: The search query string
+        limit: Maximum number of results to return
+    
+    Returns:
+        SuccessResponse containing a list of movies with similarity scores
+    """
+    if not voyage_ai_available():
         return create_error_response(
-            message="Invalid movie ID format",
-            code="INTERNAL_SERVER_ERROR",
-            details=f"The provided ID '{id}' is not a valid ObjectId"
+            message="Vector search unavailable",
+            code="SERVICE_UNAVAILABLE",
+            details="VOYAGE_API_KEY not configured. Please add your API key to your .env file."
         )
-
-    movies_collection = get_collection("movies")
-    # Use find_one_and_delete() to find and delete in a single atomic operation
-    # This is useful when you need to return the deleted document
-    # or ensure the document exists before deletion
+    
     try:
-        deleted_movie = await movies_collection.find_one_and_delete({"_id": object_id})
+        # Initialize the client here to avoid import-time errors
+        vo = voyageai.Client()
+        
+        # The vector search index was already created at startup time
+        # Generate embedding for the search query
+        query_embedding = get_embedding(q, input_type="query", client=vo)
+        
+        # Get the embedded movies collection
+        embedded_movies_collection = get_collection("embedded_movies")
+        
+        # Define vector search pipeline
+        pipeline = [
+            {
+                "$vectorSearch": {
+                    "index": "vector_index",
+                    "path": "plot_embedding_voyage_3_large",
+                    "queryVector": query_embedding, #2048
+                    "numCandidates": limit * 15,  # Search more candidates for better results
+                    "limit": limit
+                }
+            },
+            {
+                "$project": {
+                    "_id": 1,
+                    "title": 1,
+                    "plot": 1,
+                    "score": {
+                        "$meta": "vectorSearchScore"
+                    }
+                }
+            }
+        ]
+
+        raw_results = await execute_aggregation_on_collection(embedded_movies_collection, pipeline)
+        
+        # Convert ObjectId to string and create VectorSearchResult objects
+        for result in raw_results:
+            if "_id" in result and result["_id"]:
+                try:
+                    result["_id"] = str(result["_id"])
+                except (InvalidId, TypeError):
+                    # Handle invalid ObjectId conversion
+                    result["_id"] = str(result["_id"]) if result["_id"] else None
+        
+        # This code converts the raw results into VectorSearchResult objects
+        results = [VectorSearchResult(**doc) for doc in raw_results]
+        
+        return create_success_response(
+            results, 
+            f"Found {len(results)} similar movies for query: '{q}'"
+        )
+        
     except Exception as e:
         return create_error_response(
-            message="Database error occurred",
+            message="Vector search failed",
             code="INTERNAL_SERVER_ERROR",
             details=str(e)
         )
 
-    if deleted_movie is None:
-        return create_error_response(
-            message="Movie not found",
-            code="INTERNAL_SERVER_ERROR", 
-            details=f"No movie found with ID: {id}"
-        )
-    deleted_movie["_id"] = str(deleted_movie["_id"]) # Convert ObjectId to string
-    
-    return create_success_response(deleted_movie, "Movie found and deleted successfully")
-
 #------------------------------------
 #Helper Functions
 #------------------------------------
@@ -1349,18 +1346,12 @@ async def find_and_delete_movie(id: str):
 
 async def execute_aggregation(pipeline: list) -> list:
     """Helper function to execute aggregation pipeline and return results"""
-    print(f"Executing pipeline: {pipeline}")  # Debug logging
     
     movies_collection = get_collection("movies")
     # For the async Pymongo driver, we need to await the aggregate call
     cursor = await movies_collection.aggregate(pipeline)
     results = await cursor.to_list(length=None)  # Convert cursor to list to collect all data at once rather than processing data per document
     
-    print(f"Aggregation returned {len(results)} results")  # Debug logging
-    if len(results) <= 3:  # Log first few results for debugging
-        for i, doc in enumerate(results):
-            print(f"Result {i+1}: {doc}")
-    
     return results
 
 """  
@@ -1376,17 +1367,10 @@ async def execute_aggregation(pipeline: list) -> list:
 
 async def execute_aggregation_on_collection(collection, pipeline: list) -> list:
     """Helper function to execute aggregation pipeline on a specified collection and return results"""
-    print(f"Executing pipeline: {pipeline}")  # Debug logging
-    print(f"Collection: {collection.name if hasattr(collection, 'name') else 'embedded_movies'}")
 
     cursor = await collection.aggregate(pipeline)
     results = await cursor.to_list(length=None)  # Convert cursor to list
 
-    print(f"Aggregation returned {len(results)} results")  # Debug logging
-    if len(results) <= 3:  # Log first few results for debugging
-        for i, doc in enumerate(results):
-            print(f"Result {i+1}: {doc}")
-
     return results
 
 """  

From bc6a6126faf1b14ff8b7c9fffefa52db5ebeeb74 Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Wed, 5 Nov 2025 16:31:52 -0500
Subject: [PATCH 064/110] add explanatory comment

---
 server/python/src/routers/movies.py | 733 ++++++++++++++--------------
 1 file changed, 368 insertions(+), 365 deletions(-)

diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index cbc2e56..7ce784f 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -15,8 +15,20 @@
 This file contains all the business logic for movie operations.
 Each method demonstrates different MongoDB operations using the PyMongo driver.
 
+The /search and /vector-search endpoints are at the top of the file because they must be
+before the /{id} endpoint to avoid route conflicts where the /search and /vector-search
+endpoints match the /{id} pattern rather than the intended paths.
+
 Implemented Endpoints:
 
+- GET /api/movies/search :
+    Search movies using MongoDB Search across the plot, fullplot, directors, writers, and cast fields.
+    Supports compound search operators and fuzzy matching.
+
+- GET /api/movies/vector-search :
+    Search movies using MongoDB Vector Search to enable semantic search capabilities over
+    the plot field.
+
 - GET /api/movies/{id} :
     Retrieve a single movie by its ID.
 
@@ -54,15 +66,6 @@
 - GET /api/movies/aggregations/reportingByDirectors :
     Aggregate directors with the most movies and their statistics.
 
-- GET /api/movies/search :
-    Search movies using MongoDB Search across the plot, fullplot, directors, writers, and cast fields.
-    Supports compound search operators and fuzzy matching.
-
-- GET /api/movies/vector-search :
-    Search movies using MongoDB Vector Search to enable semantic search capabilities over
-    the plot field.
-
-
 Helper Functions:
 - execute_aggregation(pipeline): Executes a MongoDB aggregation pipeline and returns the
 results.
@@ -72,68 +75,381 @@
 
 router = APIRouter()
 
-#------------------------------------
-# Place get_movie_by_id endpoint here
-#------------------------------------
-
+#----------------------------------------------------------------------------------------------------------
+# MongoDB Search
+#
+# MongoDB Search based on searching the plot, fullplot, directors, writers, and cast fields.
+# This function was made with the assumption that the UI will have fields for plot,fullplot, 
+# directors, writers, and cast to search on. Or some sort of combined search field.
+# Also this fuzzy operator is being used to allow for some misspellings in the search terms
+# but that allows for very generous matching. This can be adjusted as needed.
+#----------------------------------------------------------------------------------------------------------
 """
-    GET /api/movies/{id}
-    Retrieve a single movie by its ID.
-    Path Parameters:
-        id (str): The ObjectId of the movie to retrieve.
+
+    GET /api/movies/search
+
+    Search movies using MongoDB Search across the plot, fullplot, directors, writers, and cast fields.
+    You can combine multiple fields in a single query, and control how they are combined using the `search_operator` parameter.
+
+    Query Parameters:
+        plot (str, optional): Text to search against the plot field.
+        fullplot (str, optional): Text to search against the fullplot field.
+        directors (str, optional): Text to search against the directors field.
+        writers (str, optional): Text to search against the writers field.
+        cast (str, optional): Text to search against the cast field.
+        limit (int, optional): Number of results to return (default: 20)
+        skip (int, optional): Number of results to skip for pagination (default: 0)
+        search_operator (str, optional): How to combine multiple search fields. 
+            Must be one of "must", "should", "mustNot", or "filter". Default is "must".
+
     Returns:
-        SuccessResponse[Movie]: A response object containing the movie data.
+        SuccessResponse[SearchMoviesResponse]: A response object containing the list of matching movies and total count.
 """
+@router.get(
+    "/search",
+    response_model=SuccessResponse[SearchMoviesResponse],
+    status_code=200,
+    summary="Search movies using MongoDB Search."
+)
+async def search_movies(
+    plot: str = Query(default=None),
+    fullplot: str = Query(default=None),
+    directors: str = Query(default=None),
+    writers: str = Query(default=None),
+    cast: str = Query(default=None),
+    limit:int = Query(default=20, ge=1, le=100),
+    skip:int = Query(default=0, ge=0),
+    search_operator: str = Query(default="must")
+) -> SuccessResponse[SearchMoviesResponse]:
+    
+    search_phrases = []
 
-@router.get("/{id}",
-            response_model=SuccessResponse[Movie],
-            status_code=200,
-            summary="Retrieve a single movie by its ID.")
-async def get_movie_by_id(id: str):
-    # Validate ObjectId format
-    try:
-        object_id = ObjectId(id)
-    except InvalidId:
+    # Validate the search_operator parameter to ensure it's a valid compound operator
+    valid_operators = {"must", "should", "mustNot", "filter"}
+    if search_operator not in valid_operators:
         return create_error_response(
-            message="Invalid movie ID format",
-            code="INTERNAL_SERVER_ERROR",
-            details=f"The provided ID '{id}' is not a valid ObjectId"
+        message=f"Invalid search_operator '{search_operator}'. The search_operator must be one of {valid_operators}.",
+        code="INVALID_SEARCH_OPERATOR",
+        details=None
+    )
+
+    # Build the search_phrases list based on which fields were provided by the user.
+    # Each phrase becomes a separate clause in the MongoDB Search compound query.
+
+    if plot:
+        search_phrases.append({
+            # The phrase operator performs an exact phrase match on the specified field. This is useful for searching for specific phrases within text fields.
+            # The text operator is more flexible and allows for fuzzy matching, making it suitable for fields like names where typos may occur.
+            "phrase": {
+                "query": plot,
+                "path": "plot",
+            }
+        })
+    if fullplot:
+        search_phrases.append({
+            "phrase": {
+                "query": fullplot,
+                "path": "fullplot",
+            }
+        })
+    if directors:
+        # The "fuzzy" option enables typo-tolerant (fuzzy) search within MongoDB Search.
+        # - maxEdits: The maximum number of single-character edits (insertions, deletions, or substitutions)
+        #             allowed when matching the search term to indexed terms. (Range: 1-2; higher = more tolerant)
+        # - prefixLength: The number of initial characters that must exactly match before fuzzy matching is applied.
+        #             (Higher values make the search stricter and faster.)
+        # For more details, see: https://www.mongodb.com/docs/atlas/atlas-search/operators-collectors/text/
+
+        search_phrases.append({
+            "text": {
+                "query": directors,
+                "path": "directors",
+                "fuzzy":{"maxEdits":1, "prefixLength":5}
+
+            }
+        })
+    if writers:
+        # See comments above regarding fuzzy search options.
+        search_phrases.append({
+            "text": {
+                "query": writers,
+                "path": "writers",
+                "fuzzy":{"maxEdits":1, "prefixLength":5}
+            }
+        })
+    if cast:
+        # See comments above regarding fuzzy search options.
+        search_phrases.append({
+            "text": {
+                "query": cast,
+                "path": "cast",
+                "fuzzy":{"maxEdits":1, "prefixLength":5}
+            }
+        })
+
+    if not search_phrases:
+        return create_error_response(
+            message="At least one search parameter must be provided.",
+            code="NO_SEARCH_PARAMETERS",
+            details=None
         )
 
-    movies_collection = get_collection("movies")
+    # Build the aggregation pipeline for MongoDB Search.
+    # The $search stage uses the specified compound operator (must, should, etc.)
+    aggregation_pipeline = [
+        {
+            "$search": {
+                "index": "movieSearchIndex",
+                "compound": {
+                    search_operator: search_phrases
+                }
+            }
+        },
+        {
+            "$facet": {
+                "totalCount": [
+                    {"$count": "count"}
+                ],
+                "results": [
+                    {"$skip": skip},
+                    {"$limit": limit},
+                    # Project only the fields needed in the response
+                    {
+                        "$project": {
+                            "_id": 1,
+                            "title": 1,
+                            "year": 1,
+                            "plot": 1,
+                            "fullplot": 1,
+                            "released":1,
+                            "runtime": 1,
+                            "poster": 1,
+                            "genres": 1,
+                            "directors": 1,
+                            "writers": 1,
+                            "cast": 1,
+                            "countries": 1,
+                            "languages": 1,
+                            "rated": 1,
+                            "awards": 1,
+                            "imdb": 1,
+                        }
+                    }
+                ]
+            }
+        }
+    ]
+
+    # Execute the aggregation pipeline using the helper function
     try:
-        movie = await movies_collection.find_one({"_id": object_id})
+        results = await execute_aggregation(aggregation_pipeline)
     except Exception as e:
         return create_error_response(
-            message="Database error occurred",
-            code="INTERNAL_SERVER_ERROR",
+            message="An error occurred while performing the search.",
+            code="DATABASE_ERROR",
             details=str(e)
-        )
+        )    
 
-    if movie is None:
-        return create_error_response(
-            message="Movie not found",
-            code="INTERNAL_SERVER_ERROR",
-            details=f"No movie found with ID: {id}"
+    # Extract total count and movies from facet results with proper bounds checking
+    if not results or len(results) == 0:
+        return create_success_response(
+            SearchMoviesResponse(movies=[], totalCount=0), 
+            "No movies found matching the search criteria."
         )
-
-    movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
     
-    return create_success_response(movie, "Movie retrieved successfully")
+    facet_result = results[0]
+    
+    # Safely extract total count
+    total_count_array = facet_result.get("totalCount", [])
+    total_count = total_count_array[0].get("count", 0) if total_count_array else 0
+    
+    # Safely extract movies data
+    movies_data = facet_result.get("results", [])
+    
+    # Convert ObjectId to string for each movie in the results
+    movies = []
+    for movie in movies_data:
+        movie["_id"] = str(movie["_id"])
+        movies.append(movie)
+
+    return create_success_response(
+        SearchMoviesResponse(movies=movies, totalCount=total_count), 
+        f"Found {total_count} movies matching the search criteria."
+      )
 
+#----------------------------------------------------------------------------------------------------------
+# MongoDB Vector Search
+#
+# MongoDB Vector Search based on searching the plot_embedding_voyage_3_large field.
+#----------------------------------------------------------------------------------------------------------
 """
-    GET /api/movies/
 
-    Retrieve a list of movies with optional filtering, sorting, and pagination.
+    GET /api/movies/vector-search
+
+    Search movies using MongoDB Vector Search to find movies with similar plots.
+    Uses embeddings generated by the Voyage AI model to perform semantic similarity search.
 
     Query Parameters:
-        q (str, optional): Text search query (searches title, plot, fullplot).
-        genre (str, optional): Filter by genre.
-        year (int, optional): Filter by year.
-        min_rating (float, optional): Minimum IMDB rating.
-        max_rating (float, optional): Maximum IMDB rating.
-        limitNum (int, optional): Number of results to return (default: 20, max: 100).
-        skipNum (int, optional): Number of documents to skip for pagination (default: 0).
+        q (str, required): Search query text to find movies with similar plots.
+        limit (int, optional): Number of results to return (default: 10, max: 50).
+
+    Returns:
+        SuccessResponse[List[VectorSearchResult]]: A response object containing movies with similarity scores.
+        Each result includes:
+            - _id: Movie ObjectId
+            - title: Movie title  
+            - plot: Movie plot text
+            - score: Vector search similarity score (0.0 to 1.0, higher = more similar)
+"""
+# Specify your Voyage API key and embedding model
+model = "voyage-3-large"
+outputDimension = 2048 #Set to 2048 to match the dimensions of the collection's embeddings
+
+# Vector Search Endpoint
+@router.get("/vector-search", response_model=SuccessResponse[List[VectorSearchResult]])
+async def vector_search_movies(
+    q: str = Query(..., description="Search query to find similar movies by plot"),
+    limit: int = Query(default=10, ge=1, le=50, description="Number of results to return")
+):
+    """
+    Vector search endpoint for finding movies with similar plots.
+    
+    Args:
+        q: The search query string
+        limit: Maximum number of results to return
+    
+    Returns:
+        SuccessResponse containing a list of movies with similarity scores
+    """
+    if not voyage_ai_available():
+        return create_error_response(
+            message="Vector search unavailable",
+            code="SERVICE_UNAVAILABLE",
+            details="VOYAGE_API_KEY not configured. Please add your API key to your .env file."
+        )
+    
+    try:
+        # Initialize the client here to avoid import-time errors
+        vo = voyageai.Client()
+        
+        # The vector search index was already created at startup time
+        # Generate embedding for the search query
+        query_embedding = get_embedding(q, input_type="query", client=vo)
+        
+        # Get the embedded movies collection
+        embedded_movies_collection = get_collection("embedded_movies")
+        
+        # Define vector search pipeline
+        pipeline = [
+            {
+                "$vectorSearch": {
+                    "index": "vector_index",
+                    "path": "plot_embedding_voyage_3_large",
+                    "queryVector": query_embedding, #2048
+                    "numCandidates": limit * 15,  # Search more candidates for better results
+                    "limit": limit
+                }
+            },
+            {
+                "$project": {
+                    "_id": 1,
+                    "title": 1,
+                    "plot": 1,
+                    "score": {
+                        "$meta": "vectorSearchScore"
+                    }
+                }
+            }
+        ]
+
+        raw_results = await execute_aggregation_on_collection(embedded_movies_collection, pipeline)
+        
+        # Convert ObjectId to string and create VectorSearchResult objects
+        for result in raw_results:
+            if "_id" in result and result["_id"]:
+                try:
+                    result["_id"] = str(result["_id"])
+                except (InvalidId, TypeError):
+                    # Handle invalid ObjectId conversion
+                    result["_id"] = str(result["_id"]) if result["_id"] else None
+        
+        # This code converts the raw results into VectorSearchResult objects
+        results = [VectorSearchResult(**doc) for doc in raw_results]
+        
+        return create_success_response(
+            results, 
+            f"Found {len(results)} similar movies for query: '{q}'"
+        )
+        
+    except Exception as e:
+        return create_error_response(
+            message="Vector search failed",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
+
+#------------------------------------
+# Place get_movie_by_id endpoint here
+#------------------------------------
+
+"""
+    GET /api/movies/{id}
+    Retrieve a single movie by its ID.
+    Path Parameters:
+        id (str): The ObjectId of the movie to retrieve.
+    Returns:
+        SuccessResponse[Movie]: A response object containing the movie data.
+"""
+
+@router.get("/{id}",
+            response_model=SuccessResponse[Movie],
+            status_code=200,
+            summary="Retrieve a single movie by its ID.")
+async def get_movie_by_id(id: str):
+    # Validate ObjectId format
+    try:
+        object_id = ObjectId(id)
+    except InvalidId:
+        return create_error_response(
+            message="Invalid movie ID format",
+            code="INTERNAL_SERVER_ERROR",
+            details=f"The provided ID '{id}' is not a valid ObjectId"
+        )
+
+    movies_collection = get_collection("movies")
+    try:
+        movie = await movies_collection.find_one({"_id": object_id})
+    except Exception as e:
+        return create_error_response(
+            message="Database error occurred",
+            code="INTERNAL_SERVER_ERROR",
+            details=str(e)
+        )
+
+    if movie is None:
+        return create_error_response(
+            message="Movie not found",
+            code="INTERNAL_SERVER_ERROR",
+            details=f"No movie found with ID: {id}"
+        )
+
+    movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
+    
+    return create_success_response(movie, "Movie retrieved successfully")
+
+"""
+    GET /api/movies/
+
+    Retrieve a list of movies with optional filtering, sorting, and pagination.
+
+    Query Parameters:
+        q (str, optional): Text search query (searches title, plot, fullplot).
+        genre (str, optional): Filter by genre.
+        year (int, optional): Filter by year.
+        min_rating (float, optional): Minimum IMDB rating.
+        max_rating (float, optional): Maximum IMDB rating.
+        limitNum (int, optional): Number of results to return (default: 20, max: 100).
+        skipNum (int, optional): Number of documents to skip for pagination (default: 0).
         sortBy (str, optional): Field to sort by (default: "title").
         sort_order (str, optional): Sort direction, "asc" or "desc" (default: "asc").
 
@@ -1017,319 +1333,6 @@ async def aggregate_directors_most_movies(
         f"Found {len(results)} directors with most movies"
     )
 
-#----------------------------------------------------------------------------------------------------------
-# MongoDB Search
-#
-# MongoDB Search based on searching the plot, fullplot, directors, writers, and cast fields.
-# This function was made with the assumption that the UI will have fields for plot,fullplot, 
-# directors, writers, and cast to search on. Or some sort of combined search field.
-# Also this fuzzy operator is being used to allow for some misspellings in the search terms
-# but that allows for very generous matching. This can be adjusted as needed.
-#----------------------------------------------------------------------------------------------------------
-"""
-
-    GET /api/movies/search
-
-    Search movies using MongoDB Search across the plot, fullplot, directors, writers, and cast fields.
-    You can combine multiple fields in a single query, and control how they are combined using the `search_operator` parameter.
-
-    Query Parameters:
-        plot (str, optional): Text to search against the plot field.
-        fullplot (str, optional): Text to search against the fullplot field.
-        directors (str, optional): Text to search against the directors field.
-        writers (str, optional): Text to search against the writers field.
-        cast (str, optional): Text to search against the cast field.
-        limit (int, optional): Number of results to return (default: 20)
-        skip (int, optional): Number of results to skip for pagination (default: 0)
-        search_operator (str, optional): How to combine multiple search fields. 
-            Must be one of "must", "should", "mustNot", or "filter". Default is "must".
-
-    Returns:
-        SuccessResponse[SearchMoviesResponse]: A response object containing the list of matching movies and total count.
-"""
-@router.get(
-    "/search/mongodb-search",
-    response_model=SuccessResponse[SearchMoviesResponse],
-    status_code=200,
-    summary="Search movies using MongoDB Search."
-)
-async def search_movies(
-    plot: str = Query(default=None),
-    fullplot: str = Query(default=None),
-    directors: str = Query(default=None),
-    writers: str = Query(default=None),
-    cast: str = Query(default=None),
-    limit:int = Query(default=20, ge=1, le=100),
-    skip:int = Query(default=0, ge=0),
-    search_operator: str = Query(default="must")
-) -> SuccessResponse[SearchMoviesResponse]:
-    
-    search_phrases = []
-
-    # Validate the search_operator parameter to ensure it's a valid compound operator
-    valid_operators = {"must", "should", "mustNot", "filter"}
-    if search_operator not in valid_operators:
-        return create_error_response(
-        message=f"Invalid search_operator '{search_operator}'. The search_operator must be one of {valid_operators}.",
-        code="INVALID_SEARCH_OPERATOR",
-        details=None
-    )
-
-    # Build the search_phrases list based on which fields were provided by the user.
-    # Each phrase becomes a separate clause in the MongoDB Search compound query.
-
-    if plot:
-        search_phrases.append({
-            # The phrase operator performs an exact phrase match on the specified field. This is useful for searching for specific phrases within text fields.
-            # The text operator is more flexible and allows for fuzzy matching, making it suitable for fields like names where typos may occur.
-            "phrase": {
-                "query": plot,
-                "path": "plot",
-            }
-        })
-    if fullplot:
-        search_phrases.append({
-            "phrase": {
-                "query": fullplot,
-                "path": "fullplot",
-            }
-        })
-    if directors:
-        # The "fuzzy" option enables typo-tolerant (fuzzy) search within MongoDB Search.
-        # - maxEdits: The maximum number of single-character edits (insertions, deletions, or substitutions)
-        #             allowed when matching the search term to indexed terms. (Range: 1-2; higher = more tolerant)
-        # - prefixLength: The number of initial characters that must exactly match before fuzzy matching is applied.
-        #             (Higher values make the search stricter and faster.)
-        # For more details, see: https://www.mongodb.com/docs/atlas/atlas-search/operators-collectors/text/
-
-        search_phrases.append({
-            "text": {
-                "query": directors,
-                "path": "directors",
-                "fuzzy":{"maxEdits":1, "prefixLength":5}
-
-            }
-        })
-    if writers:
-        # See comments above regarding fuzzy search options.
-        search_phrases.append({
-            "text": {
-                "query": writers,
-                "path": "writers",
-                "fuzzy":{"maxEdits":1, "prefixLength":5}
-            }
-        })
-    if cast:
-        # See comments above regarding fuzzy search options.
-        search_phrases.append({
-            "text": {
-                "query": cast,
-                "path": "cast",
-                "fuzzy":{"maxEdits":1, "prefixLength":5}
-            }
-        })
-
-    if not search_phrases:
-        return create_error_response(
-            message="At least one search parameter must be provided.",
-            code="NO_SEARCH_PARAMETERS",
-            details=None
-        )
-
-    # Build the aggregation pipeline for MongoDB Search.
-    # The $search stage uses the specified compound operator (must, should, etc.)
-    aggregation_pipeline = [
-        {
-            "$search": {
-                "index": "movieSearchIndex",
-                "compound": {
-                    search_operator: search_phrases
-                }
-            }
-        },
-        {
-            "$facet": {
-                "totalCount": [
-                    {"$count": "count"}
-                ],
-                "results": [
-                    {"$skip": skip},
-                    {"$limit": limit},
-                    # Project only the fields needed in the response
-                    {
-                        "$project": {
-                            "_id": 1,
-                            "title": 1,
-                            "year": 1,
-                            "plot": 1,
-                            "fullplot": 1,
-                            "released":1,
-                            "runtime": 1,
-                            "poster": 1,
-                            "genres": 1,
-                            "directors": 1,
-                            "writers": 1,
-                            "cast": 1,
-                            "countries": 1,
-                            "languages": 1,
-                            "rated": 1,
-                            "awards": 1,
-                            "imdb": 1,
-                        }
-                    }
-                ]
-            }
-        }
-    ]
-
-    # Execute the aggregation pipeline using the helper function
-    try:
-        results = await execute_aggregation(aggregation_pipeline)
-    except Exception as e:
-        return create_error_response(
-            message="An error occurred while performing the search.",
-            code="DATABASE_ERROR",
-            details=str(e)
-        )    
-
-    # Extract total count and movies from facet results with proper bounds checking
-    if not results or len(results) == 0:
-        return create_success_response(
-            SearchMoviesResponse(movies=[], totalCount=0), 
-            "No movies found matching the search criteria."
-        )
-    
-    facet_result = results[0]
-    
-    # Safely extract total count
-    total_count_array = facet_result.get("totalCount", [])
-    total_count = total_count_array[0].get("count", 0) if total_count_array else 0
-    
-    # Safely extract movies data
-    movies_data = facet_result.get("results", [])
-    
-    # Convert ObjectId to string for each movie in the results
-    movies = []
-    for movie in movies_data:
-        movie["_id"] = str(movie["_id"])
-        movies.append(movie)
-
-    return create_success_response(
-        SearchMoviesResponse(movies=movies, totalCount=total_count), 
-        f"Found {total_count} movies matching the search criteria."
-      )
-
-#----------------------------------------------------------------------------------------------------------
-# MongoDB Vector Search
-#
-# MongoDB Vector Search based on searching the plot_embedding_voyage_3_large field.
-#----------------------------------------------------------------------------------------------------------
-"""
-
-    GET /api/movies/vector-search
-
-    Search movies using MongoDB Vector Search to find movies with similar plots.
-    Uses embeddings generated by the Voyage AI model to perform semantic similarity search.
-
-    Query Parameters:
-        q (str, required): Search query text to find movies with similar plots.
-        limit (int, optional): Number of results to return (default: 10, max: 50).
-
-    Returns:
-        SuccessResponse[List[VectorSearchResult]]: A response object containing movies with similarity scores.
-        Each result includes:
-            - _id: Movie ObjectId
-            - title: Movie title  
-            - plot: Movie plot text
-            - score: Vector search similarity score (0.0 to 1.0, higher = more similar)
-"""
-# Specify your Voyage API key and embedding model
-model = "voyage-3-large"
-outputDimension = 2048 #Set to 2048 to match the dimensions of the collection's embeddings
-
-# Vector Search Endpoint
-@router.get("/search/vector-search", response_model=SuccessResponse[List[VectorSearchResult]])
-async def vector_search_movies(
-    q: str = Query(..., description="Search query to find similar movies by plot"),
-    limit: int = Query(default=10, ge=1, le=50, description="Number of results to return")
-):
-    """
-    Vector search endpoint for finding movies with similar plots.
-    
-    Args:
-        q: The search query string
-        limit: Maximum number of results to return
-    
-    Returns:
-        SuccessResponse containing a list of movies with similarity scores
-    """
-    if not voyage_ai_available():
-        return create_error_response(
-            message="Vector search unavailable",
-            code="SERVICE_UNAVAILABLE",
-            details="VOYAGE_API_KEY not configured. Please add your API key to your .env file."
-        )
-    
-    try:
-        # Initialize the client here to avoid import-time errors
-        vo = voyageai.Client()
-        
-        # The vector search index was already created at startup time
-        # Generate embedding for the search query
-        query_embedding = get_embedding(q, input_type="query", client=vo)
-        
-        # Get the embedded movies collection
-        embedded_movies_collection = get_collection("embedded_movies")
-        
-        # Define vector search pipeline
-        pipeline = [
-            {
-                "$vectorSearch": {
-                    "index": "vector_index",
-                    "path": "plot_embedding_voyage_3_large",
-                    "queryVector": query_embedding, #2048
-                    "numCandidates": limit * 15,  # Search more candidates for better results
-                    "limit": limit
-                }
-            },
-            {
-                "$project": {
-                    "_id": 1,
-                    "title": 1,
-                    "plot": 1,
-                    "score": {
-                        "$meta": "vectorSearchScore"
-                    }
-                }
-            }
-        ]
-
-        raw_results = await execute_aggregation_on_collection(embedded_movies_collection, pipeline)
-        
-        # Convert ObjectId to string and create VectorSearchResult objects
-        for result in raw_results:
-            if "_id" in result and result["_id"]:
-                try:
-                    result["_id"] = str(result["_id"])
-                except (InvalidId, TypeError):
-                    # Handle invalid ObjectId conversion
-                    result["_id"] = str(result["_id"]) if result["_id"] else None
-        
-        # This code converts the raw results into VectorSearchResult objects
-        results = [VectorSearchResult(**doc) for doc in raw_results]
-        
-        return create_success_response(
-            results, 
-            f"Found {len(results)} similar movies for query: '{q}'"
-        )
-        
-    except Exception as e:
-        return create_error_response(
-            message="Vector search failed",
-            code="INTERNAL_SERVER_ERROR",
-            details=str(e)
-        )
-
 #------------------------------------
 #Helper Functions
 #------------------------------------

From 1f6fd3267ab79469d3ded65072437a02ee0eeae1 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 17:12:31 -0500
Subject: [PATCH 065/110] Update GitHub workflows to use local scripts for test
 summary display

---
 .github/scripts/generate-test-summary-jest.sh | 83 +++++++++++++++++++
 .../scripts/generate-test-summary-surefire.sh | 82 ++++++++++++++++++
 .github/workflows/run-express-tests.yml       | 12 ++-
 .../workflows/run-java-spring-boot-tests.yml  |  8 +-
 server/express/.gitignore                     |  3 +
 5 files changed, 182 insertions(+), 6 deletions(-)
 create mode 100644 .github/scripts/generate-test-summary-jest.sh
 create mode 100644 .github/scripts/generate-test-summary-surefire.sh

diff --git a/.github/scripts/generate-test-summary-jest.sh b/.github/scripts/generate-test-summary-jest.sh
new file mode 100644
index 0000000..6bbdf35
--- /dev/null
+++ b/.github/scripts/generate-test-summary-jest.sh
@@ -0,0 +1,83 @@
+#!/bin/bash
+set -e
+
+# Generate Test Summary from Jest JSON Output
+# Usage: ./generate-test-summary-jest.sh <path-to-jest-json-file>
+
+JSON_FILE="${1:-test-results.json}"
+
+echo "## Test Results" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# Parse test results from Jest JSON output
+if [ -f "$JSON_FILE" ]; then
+  # Extract test counts using jq or grep/sed
+  # Jest JSON structure: { "numTotalTests": N, "numPassedTests": N, "numFailedTests": N, "numPendingTests": N, ... }
+  
+  if command -v jq &> /dev/null; then
+    # Use jq if available (preferred)
+    total_tests=$(jq -r '.numTotalTests // 0' "$JSON_FILE")
+    passed=$(jq -r '.numPassedTests // 0' "$JSON_FILE")
+    failed=$(jq -r '.numFailedTests // 0' "$JSON_FILE")
+    skipped=$(jq -r '.numPendingTests // 0' "$JSON_FILE")
+    
+    # Extract failed test details
+    failed_tests_file=$(mktemp)
+    jq -r '.testResults[]? | select(.status == "failed") | .assertionResults[]? | select(.status == "failed") | "\(.ancestorTitles | join(" > ")) > \(.title)"' "$JSON_FILE" > "$failed_tests_file" 2>/dev/null || true
+  else
+    # Fallback to grep/sed if jq is not available
+    total_tests=$(grep -oP '"numTotalTests":\s*\K[0-9]+' "$JSON_FILE" | head -1)
+    passed=$(grep -oP '"numPassedTests":\s*\K[0-9]+' "$JSON_FILE" | head -1)
+    failed=$(grep -oP '"numFailedTests":\s*\K[0-9]+' "$JSON_FILE" | head -1)
+    skipped=$(grep -oP '"numPendingTests":\s*\K[0-9]+' "$JSON_FILE" | head -1)
+    
+    # Extract failed test names (basic extraction without jq)
+    failed_tests_file=$(mktemp)
+    grep -oP '"fullName":\s*"\K[^"]*' "$JSON_FILE" | while read -r line; do
+      if echo "$line" | grep -q "failed"; then
+        echo "$line" >> "$failed_tests_file"
+      fi
+    done 2>/dev/null || true
+  fi
+  
+  # Default to 0 if values are empty
+  total_tests=${total_tests:-0}
+  passed=${passed:-0}
+  failed=${failed:-0}
+  skipped=${skipped:-0}
+
+  echo "| Status | Count |" >> $GITHUB_STEP_SUMMARY
+  echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
+  echo "| ✅ Passed | $passed |" >> $GITHUB_STEP_SUMMARY
+  echo "| ❌ Failed | $failed |" >> $GITHUB_STEP_SUMMARY
+  echo "| ⏭️ Skipped | $skipped |" >> $GITHUB_STEP_SUMMARY
+  echo "| **Total** | **$total_tests** |" >> $GITHUB_STEP_SUMMARY
+  echo "" >> $GITHUB_STEP_SUMMARY
+
+  # List failed tests if any
+  if [ "$failed" -gt 0 ]; then
+    echo "### ❌ Failed Tests" >> $GITHUB_STEP_SUMMARY
+    echo "" >> $GITHUB_STEP_SUMMARY
+    
+    if [ -s "$failed_tests_file" ]; then
+      while IFS= read -r test; do
+        echo "- \`$test\`" >> $GITHUB_STEP_SUMMARY
+      done < "$failed_tests_file"
+    else
+      echo "_Unable to parse individual test names_" >> $GITHUB_STEP_SUMMARY
+    fi
+    
+    echo "" >> $GITHUB_STEP_SUMMARY
+    echo "❌ **Tests failed!**" >> $GITHUB_STEP_SUMMARY
+    rm -f "$failed_tests_file"
+    exit 1
+  else
+    echo "✅ **All tests passed!**" >> $GITHUB_STEP_SUMMARY
+  fi
+  
+  rm -f "$failed_tests_file"
+else
+  echo "⚠️ No test results found at: $JSON_FILE" >> $GITHUB_STEP_SUMMARY
+  exit 1
+fi
+
diff --git a/.github/scripts/generate-test-summary-surefire.sh b/.github/scripts/generate-test-summary-surefire.sh
new file mode 100644
index 0000000..fee0e56
--- /dev/null
+++ b/.github/scripts/generate-test-summary-surefire.sh
@@ -0,0 +1,82 @@
+#!/bin/bash
+set -e
+
+# Generate Test Summary from Maven Surefire Reports
+# Usage: ./generate-test-summary-surefire.sh <path-to-surefire-reports>
+
+REPORTS_DIR="${1:-target/surefire-reports}"
+
+echo "## Test Results" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# Parse test results from Surefire reports
+if [ -d "$REPORTS_DIR" ]; then
+  total_tests=0
+  failures=0
+  errors=0
+  skipped=0
+  failed_tests_file=$(mktemp)
+
+  for file in "$REPORTS_DIR"/TEST-*.xml; do
+    if [ -f "$file" ]; then
+      # Extract test counts from XML
+      tests=$(grep -oP 'tests="\K[0-9]+' "$file" | head -1)
+      fails=$(grep -oP 'failures="\K[0-9]+' "$file" | head -1)
+      errs=$(grep -oP 'errors="\K[0-9]+' "$file" | head -1)
+      skip=$(grep -oP 'skipped="\K[0-9]+' "$file" | head -1)
+
+      total_tests=$((total_tests + ${tests:-0}))
+      failures=$((failures + ${fails:-0}))
+      errors=$((errors + ${errs:-0}))
+      skipped=$((skipped + ${skip:-0}))
+
+      # Extract failed test cases
+      if [ "${fails:-0}" -gt 0 ] || [ "${errs:-0}" -gt 0 ]; then
+        classname=$(basename "$file" .xml | sed 's/^TEST-//')
+
+        # Find failed testcases (with failure or error elements)
+        grep -oP '<testcase[^>]*name="[^"]*"[^>]*>.*?<(failure|error)' "$file" | \
+          grep -oP 'name="\K[^"]*' | while read -r testname; do
+            echo "$classname.$testname" >> "$failed_tests_file"
+          done
+      fi
+    fi
+  done
+
+  passed=$((total_tests - failures - errors - skipped))
+
+  echo "| Status | Count |" >> $GITHUB_STEP_SUMMARY
+  echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
+  echo "| ✅ Passed | $passed |" >> $GITHUB_STEP_SUMMARY
+  echo "| ❌ Failed | $((failures + errors)) |" >> $GITHUB_STEP_SUMMARY
+  echo "| ⏭️ Skipped | $skipped |" >> $GITHUB_STEP_SUMMARY
+  echo "| **Total** | **$total_tests** |" >> $GITHUB_STEP_SUMMARY
+  echo "" >> $GITHUB_STEP_SUMMARY
+
+  # List failed tests if any
+  if [ $((failures + errors)) -gt 0 ]; then
+    echo "### ❌ Failed Tests" >> $GITHUB_STEP_SUMMARY
+    echo "" >> $GITHUB_STEP_SUMMARY
+
+    if [ -s "$failed_tests_file" ]; then
+      while IFS= read -r test; do
+        echo "- \`$test\`" >> $GITHUB_STEP_SUMMARY
+      done < "$failed_tests_file"
+    else
+      echo "_Unable to parse individual test names_" >> $GITHUB_STEP_SUMMARY
+    fi
+
+    echo "" >> $GITHUB_STEP_SUMMARY
+    echo "❌ **Tests failed!**" >> $GITHUB_STEP_SUMMARY
+    rm -f "$failed_tests_file"
+    exit 1
+  else
+    echo "✅ **All tests passed!**" >> $GITHUB_STEP_SUMMARY
+  fi
+
+  rm -f "$failed_tests_file"
+else
+  echo "⚠️ No test results found at: $REPORTS_DIR" >> $GITHUB_STEP_SUMMARY
+  exit 1
+fi
+
diff --git a/.github/workflows/run-express-tests.yml b/.github/workflows/run-express-tests.yml
index c83b23f..04df4b8 100644
--- a/.github/workflows/run-express-tests.yml
+++ b/.github/workflows/run-express-tests.yml
@@ -30,7 +30,7 @@ jobs:
         run: npm install
 
       - name: Run tests
-        run: npm test
+        run: npm test -- --json --outputFile=test-results.json || true
         env:
           MONGODB_URI: ${{ secrets.MFLIX_URI }}
 
@@ -39,5 +39,13 @@ jobs:
         if: always()
         with:
           name: test-results
-          path: server/express/coverage/
+          path: |
+            server/express/coverage/
+            server/express/test-results.json
           retention-days: 30
+
+      - name: Generate Test Summary
+        if: always()
+        run: |
+          chmod +x .github/scripts/generate-test-summary-jest.sh
+          .github/scripts/generate-test-summary-jest.sh server/express/test-results.json
diff --git a/.github/workflows/run-java-spring-boot-tests.yml b/.github/workflows/run-java-spring-boot-tests.yml
index 001cfba..f587041 100644
--- a/.github/workflows/run-java-spring-boot-tests.yml
+++ b/.github/workflows/run-java-spring-boot-tests.yml
@@ -51,8 +51,8 @@ jobs:
           path: server/java-spring/target/surefire-reports/
           retention-days: 30
 
-      - name: Test Summary
-        uses: test-summary/action@v2
+      - name: Generate Test Summary
         if: always()
-        with:
-          paths: server/java-spring/target/surefire-reports/TEST-*.xml
+        run: |
+          chmod +x .github/scripts/generate-test-summary-surefire.sh
+          .github/scripts/generate-test-summary-surefire.sh server/java-spring/target/surefire-reports
diff --git a/server/express/.gitignore b/server/express/.gitignore
index f9e1d4c..cdf5c6d 100644
--- a/server/express/.gitignore
+++ b/server/express/.gitignore
@@ -19,6 +19,9 @@ logs
 # Test coverage
 coverage/
 
+# Test results
+test-results.json
+
 # Optional npm cache directory
 .npm
 

From 7ab845514718b47107d587df5d68fb6adb3ea7d0 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 17:17:54 -0500
Subject: [PATCH 066/110] Fix script path issue by overriding working directory
 in test summary step

---
 .github/workflows/run-express-tests.yml          | 1 +
 .github/workflows/run-java-spring-boot-tests.yml | 1 +
 2 files changed, 2 insertions(+)

diff --git a/.github/workflows/run-express-tests.yml b/.github/workflows/run-express-tests.yml
index 04df4b8..97d362f 100644
--- a/.github/workflows/run-express-tests.yml
+++ b/.github/workflows/run-express-tests.yml
@@ -46,6 +46,7 @@ jobs:
 
       - name: Generate Test Summary
         if: always()
+        working-directory: .
         run: |
           chmod +x .github/scripts/generate-test-summary-jest.sh
           .github/scripts/generate-test-summary-jest.sh server/express/test-results.json
diff --git a/.github/workflows/run-java-spring-boot-tests.yml b/.github/workflows/run-java-spring-boot-tests.yml
index f587041..ddbc32f 100644
--- a/.github/workflows/run-java-spring-boot-tests.yml
+++ b/.github/workflows/run-java-spring-boot-tests.yml
@@ -53,6 +53,7 @@ jobs:
 
       - name: Generate Test Summary
         if: always()
+        working-directory: .
         run: |
           chmod +x .github/scripts/generate-test-summary-surefire.sh
           .github/scripts/generate-test-summary-surefire.sh server/java-spring/target/surefire-reports

From b38963e91d5ad8e05a231bc6e4faae606172183e Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 17:30:14 -0500
Subject: [PATCH 067/110] Pass MONGODB_URI directly to maven when invoking it

---
 .github/workflows/run-java-spring-boot-tests.yml | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/run-java-spring-boot-tests.yml b/.github/workflows/run-java-spring-boot-tests.yml
index ddbc32f..019c08c 100644
--- a/.github/workflows/run-java-spring-boot-tests.yml
+++ b/.github/workflows/run-java-spring-boot-tests.yml
@@ -32,15 +32,14 @@ jobs:
         run: chmod +x mvnw
 
       - name: Run unit tests
-        run: ./mvnw test
+        run: ./mvnw test -DMONGODB_URI="${MONGODB_URI}"
         env:
           MONGODB_URI: ${{ secrets.MFLIX_URI }}
 
       - name: Run integration tests
-        run: ./mvnw test -Dtest=MongoDBSearchIntegrationTest
+        run: ./mvnw test -Dtest=MongoDBSearchIntegrationTest -DMONGODB_URI="${MONGODB_URI}" -DENABLE_SEARCH_TESTS=true
         env:
           MONGODB_URI: ${{ secrets.MFLIX_URI }}
-          ENABLE_SEARCH_TESTS: true
         continue-on-error: true
 
       - name: Upload test results

From 21e89a0727f7de42e025691ab45b747274d93fbb Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 17:35:43 -0500
Subject: [PATCH 068/110] Handle env variables in pom.xml for Surefire Plugin

---
 .../workflows/run-java-spring-boot-tests.yml    |  5 +++--
 server/java-spring/pom.xml                      | 17 +++++++++++------
 2 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/run-java-spring-boot-tests.yml b/.github/workflows/run-java-spring-boot-tests.yml
index 019c08c..ddbc32f 100644
--- a/.github/workflows/run-java-spring-boot-tests.yml
+++ b/.github/workflows/run-java-spring-boot-tests.yml
@@ -32,14 +32,15 @@ jobs:
         run: chmod +x mvnw
 
       - name: Run unit tests
-        run: ./mvnw test -DMONGODB_URI="${MONGODB_URI}"
+        run: ./mvnw test
         env:
           MONGODB_URI: ${{ secrets.MFLIX_URI }}
 
       - name: Run integration tests
-        run: ./mvnw test -Dtest=MongoDBSearchIntegrationTest -DMONGODB_URI="${MONGODB_URI}" -DENABLE_SEARCH_TESTS=true
+        run: ./mvnw test -Dtest=MongoDBSearchIntegrationTest
         env:
           MONGODB_URI: ${{ secrets.MFLIX_URI }}
+          ENABLE_SEARCH_TESTS: true
         continue-on-error: true
 
       - name: Upload test results
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index d1a45d3..52e5363 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -1,23 +1,23 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project xmlns="http://maven.apache.org/POM/4.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
          https://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
-    
+
     <parent>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-parent</artifactId>
         <version>3.5.7</version>
         <relativePath/>
     </parent>
-    
+
     <groupId>com.mongodb</groupId>
     <artifactId>sample-app-java-mflix</artifactId>
     <version>1.0.0</version>
     <name>sample-app-java-mflix</name>
     <description>Java Spring Boot backend for MongoDB sample_mflix application demonstrating CRUD operations using Spring Data MongoDB</description>
-    
+
     <properties>
         <java.version>21</java.version>
         <springdoc.version>2.8.13</springdoc.version>
@@ -80,7 +80,7 @@
                 </exclusion>
             </exclusions>
         </dependency>
-        
+
         <!-- Spring Boot Test Starter -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
@@ -101,7 +101,7 @@
             <version>${langchain4j.version}</version>
         </dependency>
     </dependencies>
-    
+
     <build>
         <plugins>
             <!-- Spring Boot Maven Plugin -->
@@ -138,6 +138,11 @@
                         -javaagent:${settings.localRepository}/net/bytebuddy/byte-buddy-agent/${byte-buddy.version}/byte-buddy-agent-${byte-buddy.version}.jar
                         -Xshare:off
                     </argLine>
+                    <!-- Pass environment variables to test JVM -->
+                    <environmentVariables>
+                        <MONGODB_URI>${env.MONGODB_URI}</MONGODB_URI>
+                        <ENABLE_SEARCH_TESTS>${env.ENABLE_SEARCH_TESTS}</ENABLE_SEARCH_TESTS>
+                    </environmentVariables>
                 </configuration>
             </plugin>
 

From 0d1e0b41d58982220f6331a27bc27933f3aee551 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 17:41:07 -0500
Subject: [PATCH 069/110] Try 'argLine' I guess?

---
 .github/workflows/run-java-spring-boot-tests.yml | 9 ++-------
 server/java-spring/pom.xml                       | 5 -----
 2 files changed, 2 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/run-java-spring-boot-tests.yml b/.github/workflows/run-java-spring-boot-tests.yml
index ddbc32f..2f15969 100644
--- a/.github/workflows/run-java-spring-boot-tests.yml
+++ b/.github/workflows/run-java-spring-boot-tests.yml
@@ -32,15 +32,10 @@ jobs:
         run: chmod +x mvnw
 
       - name: Run unit tests
-        run: ./mvnw test
-        env:
-          MONGODB_URI: ${{ secrets.MFLIX_URI }}
+        run: ./mvnw test -Dspring.data.mongodb.uri="${{ secrets.MFLIX_URI }}"
 
       - name: Run integration tests
-        run: ./mvnw test -Dtest=MongoDBSearchIntegrationTest
-        env:
-          MONGODB_URI: ${{ secrets.MFLIX_URI }}
-          ENABLE_SEARCH_TESTS: true
+        run: ./mvnw test -Dtest=MongoDBSearchIntegrationTest -Dspring.data.mongodb.uri="${{ secrets.MFLIX_URI }}" -DENABLE_SEARCH_TESTS=true
         continue-on-error: true
 
       - name: Upload test results
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index 52e5363..baff5c0 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -138,11 +138,6 @@
                         -javaagent:${settings.localRepository}/net/bytebuddy/byte-buddy-agent/${byte-buddy.version}/byte-buddy-agent-${byte-buddy.version}.jar
                         -Xshare:off
                     </argLine>
-                    <!-- Pass environment variables to test JVM -->
-                    <environmentVariables>
-                        <MONGODB_URI>${env.MONGODB_URI}</MONGODB_URI>
-                        <ENABLE_SEARCH_TESTS>${env.ENABLE_SEARCH_TESTS}</ENABLE_SEARCH_TESTS>
-                    </environmentVariables>
                 </configuration>
             </plugin>
 

From 851526b6cf54a011b113a14298f8c1045a872cd7 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 17:46:30 -0500
Subject: [PATCH 070/110] Maybe this? Maybe?

---
 .github/workflows/run-java-spring-boot-tests.yml | 4 ++--
 server/java-spring/pom.xml                       | 5 +++++
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/run-java-spring-boot-tests.yml b/.github/workflows/run-java-spring-boot-tests.yml
index 2f15969..0b10793 100644
--- a/.github/workflows/run-java-spring-boot-tests.yml
+++ b/.github/workflows/run-java-spring-boot-tests.yml
@@ -32,10 +32,10 @@ jobs:
         run: chmod +x mvnw
 
       - name: Run unit tests
-        run: ./mvnw test -Dspring.data.mongodb.uri="${{ secrets.MFLIX_URI }}"
+        run: ./mvnw test -DMONGODB_URI="${{ secrets.MFLIX_URI }}"
 
       - name: Run integration tests
-        run: ./mvnw test -Dtest=MongoDBSearchIntegrationTest -Dspring.data.mongodb.uri="${{ secrets.MFLIX_URI }}" -DENABLE_SEARCH_TESTS=true
+        run: ./mvnw test -Dtest=MongoDBSearchIntegrationTest -DMONGODB_URI="${{ secrets.MFLIX_URI }}" -DENABLE_SEARCH_TESTS=true
         continue-on-error: true
 
       - name: Upload test results
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index baff5c0..9afa58e 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -138,6 +138,11 @@
                         -javaagent:${settings.localRepository}/net/bytebuddy/byte-buddy-agent/${byte-buddy.version}/byte-buddy-agent-${byte-buddy.version}.jar
                         -Xshare:off
                     </argLine>
+                    <!-- Pass system properties as environment variables to test JVM -->
+                    <environmentVariables>
+                        <MONGODB_URI>${MONGODB_URI}</MONGODB_URI>
+                        <ENABLE_SEARCH_TESTS>${ENABLE_SEARCH_TESTS}</ENABLE_SEARCH_TESTS>
+                    </environmentVariables>
                 </configuration>
             </plugin>
 

From 113a1b9152d769d4e683638354a0cd71a0bf6b63 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 17:53:42 -0500
Subject: [PATCH 071/110] Try what works in the docs repo?

---
 .github/workflows/run-java-spring-boot-tests.yml |  9 +++++++--
 server/java-spring/pom.xml                       | 10 +++++++---
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/run-java-spring-boot-tests.yml b/.github/workflows/run-java-spring-boot-tests.yml
index 0b10793..ddbc32f 100644
--- a/.github/workflows/run-java-spring-boot-tests.yml
+++ b/.github/workflows/run-java-spring-boot-tests.yml
@@ -32,10 +32,15 @@ jobs:
         run: chmod +x mvnw
 
       - name: Run unit tests
-        run: ./mvnw test -DMONGODB_URI="${{ secrets.MFLIX_URI }}"
+        run: ./mvnw test
+        env:
+          MONGODB_URI: ${{ secrets.MFLIX_URI }}
 
       - name: Run integration tests
-        run: ./mvnw test -Dtest=MongoDBSearchIntegrationTest -DMONGODB_URI="${{ secrets.MFLIX_URI }}" -DENABLE_SEARCH_TESTS=true
+        run: ./mvnw test -Dtest=MongoDBSearchIntegrationTest
+        env:
+          MONGODB_URI: ${{ secrets.MFLIX_URI }}
+          ENABLE_SEARCH_TESTS: true
         continue-on-error: true
 
       - name: Upload test results
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index 9afa58e..dda7415 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -26,6 +26,10 @@
         <impsort.plugin.version>1.12.0</impsort.plugin.version>
         <byte-buddy.version>1.17.8</byte-buddy.version>
         <langchain4j.version>1.0.0-beta3</langchain4j.version>
+        <!--suppress UnresolvedMavenProperty -->
+        <mongodb.uri>${env.MONGODB_URI}</mongodb.uri>
+        <!--suppress UnresolvedMavenProperty -->
+        <enable.search.tests>${env.ENABLE_SEARCH_TESTS}</enable.search.tests>
     </properties>
 
     <dependencies>
@@ -138,10 +142,10 @@
                         -javaagent:${settings.localRepository}/net/bytebuddy/byte-buddy-agent/${byte-buddy.version}/byte-buddy-agent-${byte-buddy.version}.jar
                         -Xshare:off
                     </argLine>
-                    <!-- Pass system properties as environment variables to test JVM -->
+                    <!-- Pass Maven properties as environment variables to test JVM -->
                     <environmentVariables>
-                        <MONGODB_URI>${MONGODB_URI}</MONGODB_URI>
-                        <ENABLE_SEARCH_TESTS>${ENABLE_SEARCH_TESTS}</ENABLE_SEARCH_TESTS>
+                        <MONGODB_URI>${mongodb.uri}</MONGODB_URI>
+                        <ENABLE_SEARCH_TESTS>${enable.search.tests}</ENABLE_SEARCH_TESTS>
                     </environmentVariables>
                 </configuration>
             </plugin>

From 1974e1e0d9a2304378eeabc052ff4d9b46683aff Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 17:58:15 -0500
Subject: [PATCH 072/110] Try, try again

---
 .github/workflows/run-java-spring-boot-tests.yml | 16 +++++++++-------
 server/java-spring/pom.xml                       | 10 +++-------
 2 files changed, 12 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/run-java-spring-boot-tests.yml b/.github/workflows/run-java-spring-boot-tests.yml
index ddbc32f..11bfd2b 100644
--- a/.github/workflows/run-java-spring-boot-tests.yml
+++ b/.github/workflows/run-java-spring-boot-tests.yml
@@ -32,15 +32,17 @@ jobs:
         run: chmod +x mvnw
 
       - name: Run unit tests
-        run: ./mvnw test
-        env:
-          MONGODB_URI: ${{ secrets.MFLIX_URI }}
+        run: |
+          export MONGODB_URI="${{ secrets.MFLIX_URI }}"
+          ./mvnw test
+        shell: bash
 
       - name: Run integration tests
-        run: ./mvnw test -Dtest=MongoDBSearchIntegrationTest
-        env:
-          MONGODB_URI: ${{ secrets.MFLIX_URI }}
-          ENABLE_SEARCH_TESTS: true
+        run: |
+          export MONGODB_URI="${{ secrets.MFLIX_URI }}"
+          export ENABLE_SEARCH_TESTS=true
+          ./mvnw test -Dtest=MongoDBSearchIntegrationTest
+        shell: bash
         continue-on-error: true
 
       - name: Upload test results
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index dda7415..0edfedf 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -26,10 +26,6 @@
         <impsort.plugin.version>1.12.0</impsort.plugin.version>
         <byte-buddy.version>1.17.8</byte-buddy.version>
         <langchain4j.version>1.0.0-beta3</langchain4j.version>
-        <!--suppress UnresolvedMavenProperty -->
-        <mongodb.uri>${env.MONGODB_URI}</mongodb.uri>
-        <!--suppress UnresolvedMavenProperty -->
-        <enable.search.tests>${env.ENABLE_SEARCH_TESTS}</enable.search.tests>
     </properties>
 
     <dependencies>
@@ -142,10 +138,10 @@
                         -javaagent:${settings.localRepository}/net/bytebuddy/byte-buddy-agent/${byte-buddy.version}/byte-buddy-agent-${byte-buddy.version}.jar
                         -Xshare:off
                     </argLine>
-                    <!-- Pass Maven properties as environment variables to test JVM -->
+                    <!-- Inherit all environment variables from parent process -->
                     <environmentVariables>
-                        <MONGODB_URI>${mongodb.uri}</MONGODB_URI>
-                        <ENABLE_SEARCH_TESTS>${enable.search.tests}</ENABLE_SEARCH_TESTS>
+                        <MONGODB_URI>${env.MONGODB_URI}</MONGODB_URI>
+                        <ENABLE_SEARCH_TESTS>${env.ENABLE_SEARCH_TESTS}</ENABLE_SEARCH_TESTS>
                     </environmentVariables>
                 </configuration>
             </plugin>

From c612218ac2cd2c8df7d64a514cb6bae06ddce59a Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 18:05:05 -0500
Subject: [PATCH 073/110] Zillionth time is the charm?

---
 .github/workflows/run-java-spring-boot-tests.yml | 15 ++++++---------
 server/java-spring/pom.xml                       |  5 -----
 2 files changed, 6 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/run-java-spring-boot-tests.yml b/.github/workflows/run-java-spring-boot-tests.yml
index 11bfd2b..138ec1a 100644
--- a/.github/workflows/run-java-spring-boot-tests.yml
+++ b/.github/workflows/run-java-spring-boot-tests.yml
@@ -17,6 +17,10 @@ jobs:
       run:
         working-directory: server/java-spring
 
+    env:
+      MONGODB_URI: ${{ secrets.MFLIX_URI }}
+      ENABLE_SEARCH_TESTS: true
+
     steps:
       - name: Checkout code
         uses: actions/checkout@v5
@@ -32,17 +36,10 @@ jobs:
         run: chmod +x mvnw
 
       - name: Run unit tests
-        run: |
-          export MONGODB_URI="${{ secrets.MFLIX_URI }}"
-          ./mvnw test
-        shell: bash
+        run: ./mvnw test
 
       - name: Run integration tests
-        run: |
-          export MONGODB_URI="${{ secrets.MFLIX_URI }}"
-          export ENABLE_SEARCH_TESTS=true
-          ./mvnw test -Dtest=MongoDBSearchIntegrationTest
-        shell: bash
+        run: ./mvnw test -Dtest=MongoDBSearchIntegrationTest
         continue-on-error: true
 
       - name: Upload test results
diff --git a/server/java-spring/pom.xml b/server/java-spring/pom.xml
index 0edfedf..baff5c0 100644
--- a/server/java-spring/pom.xml
+++ b/server/java-spring/pom.xml
@@ -138,11 +138,6 @@
                         -javaagent:${settings.localRepository}/net/bytebuddy/byte-buddy-agent/${byte-buddy.version}/byte-buddy-agent-${byte-buddy.version}.jar
                         -Xshare:off
                     </argLine>
-                    <!-- Inherit all environment variables from parent process -->
-                    <environmentVariables>
-                        <MONGODB_URI>${env.MONGODB_URI}</MONGODB_URI>
-                        <ENABLE_SEARCH_TESTS>${env.ENABLE_SEARCH_TESTS}</ENABLE_SEARCH_TESTS>
-                    </environmentVariables>
                 </configuration>
             </plugin>
 

From 1b4af1567f62eb642f378de53231e52591c2b7be Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 18:14:10 -0500
Subject: [PATCH 074/110] Add debug output to workflow

---
 .github/workflows/run-java-spring-boot-tests.yml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/.github/workflows/run-java-spring-boot-tests.yml b/.github/workflows/run-java-spring-boot-tests.yml
index 138ec1a..07a599d 100644
--- a/.github/workflows/run-java-spring-boot-tests.yml
+++ b/.github/workflows/run-java-spring-boot-tests.yml
@@ -35,6 +35,13 @@ jobs:
       - name: Make mvnw executable
         run: chmod +x mvnw
 
+      - name: Debug environment variables
+        run: |
+          echo "Checking environment variables..."
+          echo "MONGODB_URI is set: $(if [ -n "$MONGODB_URI" ]; then echo 'YES'; else echo 'NO'; fi)"
+          echo "ENABLE_SEARCH_TESTS is set: $(if [ -n "$ENABLE_SEARCH_TESTS" ]; then echo 'YES'; else echo 'NO'; fi)"
+          echo "MONGODB_URI length: ${#MONGODB_URI}"
+
       - name: Run unit tests
         run: ./mvnw test
 

From 54ccf5f4497e3651589201adbaff87c3a0124a78 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 18:30:59 -0500
Subject: [PATCH 075/110] Try using GitHub environment

---
 .github/workflows/run-express-tests.yml          | 6 +++++-
 .github/workflows/run-java-spring-boot-tests.yml | 6 +++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/run-express-tests.yml b/.github/workflows/run-express-tests.yml
index 97d362f..e13673e 100644
--- a/.github/workflows/run-express-tests.yml
+++ b/.github/workflows/run-express-tests.yml
@@ -1,7 +1,7 @@
 name: Run Express Tests
 
 on:
-  pull_request:
+  pull_request_target:
     branches:
       - development
   push:
@@ -12,6 +12,8 @@ jobs:
   test:
     name: Run Express Tests
     runs-on: ubuntu-latest
+    # Require manual approval for fork PRs
+    environment: testing
 
     defaults:
       run:
@@ -20,6 +22,8 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v5
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
 
       - name: Set up Node.js
         uses: actions/setup-node@v4
diff --git a/.github/workflows/run-java-spring-boot-tests.yml b/.github/workflows/run-java-spring-boot-tests.yml
index 07a599d..8108f69 100644
--- a/.github/workflows/run-java-spring-boot-tests.yml
+++ b/.github/workflows/run-java-spring-boot-tests.yml
@@ -1,7 +1,7 @@
 name: Run Java Spring Boot Tests
 
 on:
-  pull_request:
+  pull_request_target:
     branches:
       - development
   push:
@@ -12,6 +12,8 @@ jobs:
   test:
     name: Run Java Spring Boot Tests
     runs-on: ubuntu-latest
+    # Require manual approval for fork PRs
+    environment: testing
 
     defaults:
       run:
@@ -24,6 +26,8 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v5
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
 
       - name: Set up JDK 21
         uses: actions/setup-java@v5

From 5d26e641c230ecc4073a48c445738d2602a1407d Mon Sep 17 00:00:00 2001
From: cbullinger <cory.bullinger@mongodb.com>
Date: Wed, 5 Nov 2025 19:24:22 -0500
Subject: [PATCH 076/110] test(python): add test infrastructure

---
 .../scripts/generate-test-summary-pytest.sh   |  70 ++++++++
 .github/workflows/run-python-tests.yml        |  61 +++++++
 server/python/pytest.ini                      |  33 ++++
 server/python/tests/__init__.py               |   2 +
 server/python/tests/conftest.py               |  90 ++++++++++
 server/python/tests/test_movie_routes.py      | 160 ++++++++++++++++++
 6 files changed, 416 insertions(+)
 create mode 100644 .github/scripts/generate-test-summary-pytest.sh
 create mode 100644 .github/workflows/run-python-tests.yml
 create mode 100644 server/python/pytest.ini
 create mode 100644 server/python/tests/__init__.py
 create mode 100644 server/python/tests/conftest.py
 create mode 100644 server/python/tests/test_movie_routes.py

diff --git a/.github/scripts/generate-test-summary-pytest.sh b/.github/scripts/generate-test-summary-pytest.sh
new file mode 100644
index 0000000..f88ffff
--- /dev/null
+++ b/.github/scripts/generate-test-summary-pytest.sh
@@ -0,0 +1,70 @@
+#!/bin/bash
+set -e
+
+# Generate Test Summary from Pytest JUnit XML Output
+# Usage: ./generate-test-summary-pytest.sh <path-to-junit-xml>
+
+XML_FILE="${1:-test-results.xml}"
+
+echo "## Test Results" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# Parse test results from JUnit XML
+if [ -f "$XML_FILE" ]; then
+  # Extract test counts from XML
+  # JUnit XML structure: <testsuite tests="N" failures="N" errors="N" skipped="N">
+  
+  tests=$(grep -oP 'tests="\K[0-9]+' "$XML_FILE" | head -1)
+  failures=$(grep -oP 'failures="\K[0-9]+' "$XML_FILE" | head -1)
+  errors=$(grep -oP 'errors="\K[0-9]+' "$XML_FILE" | head -1)
+  skipped=$(grep -oP 'skipped="\K[0-9]+' "$XML_FILE" | head -1)
+  
+  # Default to 0 if values are empty
+  tests=${tests:-0}
+  failures=${failures:-0}
+  errors=${errors:-0}
+  skipped=${skipped:-0}
+  
+  passed=$((tests - failures - errors - skipped))
+  
+  echo "| Status | Count |" >> $GITHUB_STEP_SUMMARY
+  echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
+  echo "| ✅ Passed | $passed |" >> $GITHUB_STEP_SUMMARY
+  echo "| ❌ Failed | $((failures + errors)) |" >> $GITHUB_STEP_SUMMARY
+  echo "| ⏭️ Skipped | $skipped |" >> $GITHUB_STEP_SUMMARY
+  echo "| **Total** | **$tests** |" >> $GITHUB_STEP_SUMMARY
+  echo "" >> $GITHUB_STEP_SUMMARY
+  
+  # List failed tests if any
+  if [ $((failures + errors)) -gt 0 ]; then
+    echo "### ❌ Failed Tests" >> $GITHUB_STEP_SUMMARY
+    echo "" >> $GITHUB_STEP_SUMMARY
+    
+    # Extract failed test names from XML
+    failed_tests_file=$(mktemp)
+    
+    # Find testcase elements with failure or error children
+    grep -oP '<testcase[^>]*classname="[^"]*"[^>]*name="[^"]*"[^>]*>.*?<(failure|error)' "$XML_FILE" | \
+      grep -oP 'classname="\K[^"]*|name="\K[^"]*' | \
+      paste -d '.' - - >> "$failed_tests_file" 2>/dev/null || true
+    
+    if [ -s "$failed_tests_file" ]; then
+      while IFS= read -r test; do
+        echo "- \`$test\`" >> $GITHUB_STEP_SUMMARY
+      done < "$failed_tests_file"
+    else
+      echo "_Unable to parse individual test names_" >> $GITHUB_STEP_SUMMARY
+    fi
+    
+    echo "" >> $GITHUB_STEP_SUMMARY
+    echo "❌ **Tests failed!**" >> $GITHUB_STEP_SUMMARY
+    rm -f "$failed_tests_file"
+    exit 1
+  else
+    echo "✅ **All tests passed!**" >> $GITHUB_STEP_SUMMARY
+  fi
+else
+  echo "⚠️ No test results found at: $XML_FILE" >> $GITHUB_STEP_SUMMARY
+  exit 1
+fi
+
diff --git a/.github/workflows/run-python-tests.yml b/.github/workflows/run-python-tests.yml
new file mode 100644
index 0000000..26109ab
--- /dev/null
+++ b/.github/workflows/run-python-tests.yml
@@ -0,0 +1,61 @@
+name: Run Python Tests
+
+on:
+  pull_request_target:
+    branches:
+      - development
+  push:
+    branches:
+      - development
+
+jobs:
+  test:
+    name: Run Python Tests
+    runs-on: ubuntu-latest
+    # Require manual approval for fork PRs
+    environment: testing
+
+    defaults:
+      run:
+        working-directory: server/python
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Run tests
+        run: pytest --verbose --tb=short --junit-xml=test-results.xml || true
+        env:
+          MONGO_URI: ${{ secrets.MFLIX_URI }}
+          MONGO_DB: sample_mflix
+
+      - name: Upload test results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: test-results
+          path: |
+            server/python/test-results.xml
+            server/python/htmlcov/
+          retention-days: 30
+
+      - name: Generate Test Summary
+        if: always()
+        working-directory: .
+        run: |
+          chmod +x .github/scripts/generate-test-summary-pytest.sh
+          .github/scripts/generate-test-summary-pytest.sh server/python/test-results.xml
+
diff --git a/server/python/pytest.ini b/server/python/pytest.ini
new file mode 100644
index 0000000..f17276f
--- /dev/null
+++ b/server/python/pytest.ini
@@ -0,0 +1,33 @@
+[pytest]
+# Pytest configuration for Python FastAPI backend tests
+
+# Test discovery patterns
+python_files = test_*.py *_test.py
+python_classes = Test*
+python_functions = test_*
+
+# Test paths
+testpaths = tests
+
+# Output options
+addopts =
+    -v
+    --strict-markers
+    --tb=short
+    --asyncio-mode=auto
+    --color=yes
+
+# Markers for categorizing tests
+markers =
+    unit: Unit tests with mocked dependencies
+    integration: Integration tests requiring database
+    slow: Tests that take longer to run
+
+# Async settings
+asyncio_mode = auto
+asyncio_default_fixture_loop_scope = function
+
+# Coverage settings (optional)
+# Uncomment to enable coverage reporting
+# addopts = --cov=src --cov-report=html --cov-report=term
+
diff --git a/server/python/tests/__init__.py b/server/python/tests/__init__.py
new file mode 100644
index 0000000..e7991ee
--- /dev/null
+++ b/server/python/tests/__init__.py
@@ -0,0 +1,2 @@
+# Tests package
+
diff --git a/server/python/tests/conftest.py b/server/python/tests/conftest.py
new file mode 100644
index 0000000..440cedf
--- /dev/null
+++ b/server/python/tests/conftest.py
@@ -0,0 +1,90 @@
+"""
+Pytest configuration and fixtures for testing.
+
+This file contains shared fixtures and configuration for all tests.
+"""
+
+import pytest
+import sys
+from pathlib import Path
+
+# Add the parent directory to the path so we can import from src
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+# Configure pytest-asyncio
+pytest_plugins = ('pytest_asyncio',)
+
+
+@pytest.fixture
+def sample_movie():
+    """Sample movie data for testing."""
+    return {
+        "_id": "507f1f77bcf86cd799439011",
+        "title": "Test Movie",
+        "year": 2024,
+        "plot": "A test movie plot",
+        "genres": ["Action", "Drama"],
+        "directors": ["Test Director"],
+        "cast": ["Actor 1", "Actor 2"],
+        "runtime": 120,
+        "rated": "PG-13"
+    }
+
+
+@pytest.fixture
+def sample_movies():
+    """Multiple sample movies for testing."""
+    return [
+        {
+            "_id": "507f1f77bcf86cd799439011",
+            "title": "Test Movie 1",
+            "year": 2024,
+            "plot": "First test movie",
+            "genres": ["Action"],
+        },
+        {
+            "_id": "507f1f77bcf86cd799439012",
+            "title": "Test Movie 2",
+            "year": 2023,
+            "plot": "Second test movie",
+            "genres": ["Comedy"],
+        },
+        {
+            "_id": "507f1f77bcf86cd799439013",
+            "title": "Test Movie 3",
+            "year": 2024,
+            "plot": "Third test movie",
+            "genres": ["Drama"],
+        }
+    ]
+
+
+@pytest.fixture
+def mock_success_response():
+    """Mock success response structure."""
+    def _create_response(data, message="Success"):
+        return {
+            "success": True,
+            "message": message,
+            "data": data,
+            "timestamp": "2024-01-01T00:00:00.000Z"
+        }
+    return _create_response
+
+
+@pytest.fixture
+def mock_error_response():
+    """Mock error response structure."""
+    def _create_response(message, code=None, details=None):
+        return {
+            "success": False,
+            "message": message,
+            "error": {
+                "message": message,
+                "code": code,
+                "details": details
+            },
+            "timestamp": "2024-01-01T00:00:00.000Z"
+        }
+    return _create_response
+
diff --git a/server/python/tests/test_movie_routes.py b/server/python/tests/test_movie_routes.py
new file mode 100644
index 0000000..a4735ca
--- /dev/null
+++ b/server/python/tests/test_movie_routes.py
@@ -0,0 +1,160 @@
+"""
+Unit Tests for Movie Routes
+
+These tests verify basic API validation and structure.
+Following the pattern from PR #21 Express tests - simple validation tests.
+
+Note: These are basic validation tests only. Full integration tests
+would require a test database or mocking strategy that handles
+AsyncMongoClient event loop binding issues.
+"""
+
+import pytest
+from pydantic import ValidationError
+from src.models.models import CreateMovieRequest, UpdateMovieRequest
+
+
+# Test constants
+TEST_MOVIE_ID = "507f1f77bcf86cd799439011"
+INVALID_MOVIE_ID = "invalid-id"
+
+
+@pytest.mark.unit
+class TestMovieCreateValidation:
+    """Tests for CreateMovieRequest model validation."""
+
+    def test_create_movie_with_valid_data(self):
+        """Should accept valid movie data."""
+        movie_data = {
+            "title": "Test Movie",
+            "year": 2024,
+            "plot": "A test movie plot",
+            "genres": ["Action", "Drama"],
+            "runtime": 120
+        }
+
+        movie = CreateMovieRequest(**movie_data)
+        assert movie.title == "Test Movie"
+        assert movie.year == 2024
+        assert movie.plot == "A test movie plot"
+
+    def test_create_movie_missing_required_field(self):
+        """Should raise ValidationError when title is missing."""
+        movie_data = {
+            "year": 2024,
+            "plot": "A movie without title"
+        }
+
+        with pytest.raises(ValidationError) as exc_info:
+            CreateMovieRequest(**movie_data)
+
+        errors = exc_info.value.errors()
+        assert any(error["loc"] == ("title",) for error in errors)
+
+    def test_create_movie_invalid_year_type(self):
+        """Should raise ValidationError when year is not an integer."""
+        movie_data = {
+            "title": "Test Movie",
+            "year": "not-a-number"
+        }
+
+        with pytest.raises(ValidationError) as exc_info:
+            CreateMovieRequest(**movie_data)
+
+        errors = exc_info.value.errors()
+        assert any(error["loc"] == ("year",) for error in errors)
+
+    def test_create_movie_with_optional_fields(self):
+        """Should accept movie with only required fields."""
+        movie_data = {
+            "title": "Minimal Movie"
+        }
+
+        movie = CreateMovieRequest(**movie_data)
+        assert movie.title == "Minimal Movie"
+        assert movie.year is None
+        assert movie.plot is None
+
+
+@pytest.mark.unit
+class TestMovieUpdateValidation:
+    """Tests for UpdateMovieRequest model validation."""
+
+    def test_update_movie_with_valid_data(self):
+        """Should accept valid update data."""
+        update_data = {
+            "title": "Updated Title",
+            "year": 2025
+        }
+
+        movie_update = UpdateMovieRequest(**update_data)
+        assert movie_update.title == "Updated Title"
+        assert movie_update.year == 2025
+
+    def test_update_movie_with_partial_data(self):
+        """Should accept partial update data."""
+        update_data = {
+            "title": "Only Title Updated"
+        }
+
+        movie_update = UpdateMovieRequest(**update_data)
+        assert movie_update.title == "Only Title Updated"
+        assert movie_update.year is None
+
+    def test_update_movie_empty_data(self):
+        """Should accept empty update (all fields optional)."""
+        update_data = {}
+
+        movie_update = UpdateMovieRequest(**update_data)
+        assert movie_update.title is None
+        assert movie_update.year is None
+
+
+@pytest.mark.unit
+class TestMovieDataStructure:
+    """Tests for movie data structure and types."""
+
+    def test_movie_with_all_fields(self):
+        """Should handle movie with all possible fields."""
+        movie_data = {
+            "title": "Complete Movie",
+            "year": 2024,
+            "plot": "Full plot",
+            "fullplot": "Extended plot description",
+            "genres": ["Action", "Drama", "Thriller"],
+            "runtime": 142,
+            "cast": ["Actor 1", "Actor 2", "Actor 3"],
+            "directors": ["Director 1"],
+            "writers": ["Writer 1", "Writer 2"],
+            "languages": ["English", "Spanish"],
+            "rated": "PG-13",
+            "countries": ["USA"]
+        }
+
+        movie = CreateMovieRequest(**movie_data)
+        assert movie.title == "Complete Movie"
+        assert len(movie.genres) == 3
+        assert len(movie.cast) == 3
+
+    def test_movie_genres_as_list(self):
+        """Should accept genres as a list."""
+        movie_data = {
+            "title": "Genre Test",
+            "genres": ["Sci-Fi", "Adventure"]
+        }
+
+        movie = CreateMovieRequest(**movie_data)
+        assert isinstance(movie.genres, list)
+        assert "Sci-Fi" in movie.genres
+
+    def test_movie_with_numeric_fields(self):
+        """Should handle numeric fields correctly."""
+        movie_data = {
+            "title": "Numeric Test",
+            "year": 2024,
+            "runtime": 120
+        }
+
+        movie = CreateMovieRequest(**movie_data)
+        assert isinstance(movie.year, int)
+        assert isinstance(movie.runtime, int)

From 55b7c656ab29ede78f34b751c87d081701be0e19 Mon Sep 17 00:00:00 2001
From: Jordan Smith <45415425+jordan-smith721@users.noreply.github.com>
Date: Thu, 6 Nov 2025 09:20:28 -0500
Subject: [PATCH 077/110] feat: add a dashboard page to the front end to
 display aggregations (#18)

---
 .../app/aggregations/aggregations.module.css  | 172 ++++++++++++++
 client/app/aggregations/page.tsx              | 156 +++++++++++++
 client/app/layout.tsx                         |   6 +
 client/app/lib/api.ts                         | 218 ++++++++++++++++++
 client/app/lib/constants.ts                   |   1 +
 client/app/movies/page.tsx                    |   4 +-
 client/app/types/aggregations.ts              |  31 +++
 server/python/main.py                         |  79 +++++--
 server/python/src/routers/movies.py           |   2 +-
 9 files changed, 642 insertions(+), 27 deletions(-)
 create mode 100644 client/app/aggregations/aggregations.module.css
 create mode 100644 client/app/aggregations/page.tsx
 create mode 100644 client/app/types/aggregations.ts

diff --git a/client/app/aggregations/aggregations.module.css b/client/app/aggregations/aggregations.module.css
new file mode 100644
index 0000000..89a3d13
--- /dev/null
+++ b/client/app/aggregations/aggregations.module.css
@@ -0,0 +1,172 @@
+/* Aggregations styles */
+.container {
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 2rem;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', sans-serif;
+}
+
+.title {
+  font-size: 2.5rem;
+  font-weight: 700;
+  color: #1a1a1a;
+  margin-bottom: 0.5rem;
+  text-align: center;
+}
+
+.subtitle {
+  font-size: 1.1rem;
+  color: #666;
+  text-align: center;
+  margin-bottom: 3rem;
+}
+
+.section {
+  margin-bottom: 3rem;
+  background: #fff;
+  border-radius: 8px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  overflow: hidden;
+}
+
+.sectionTitle {
+  font-size: 1.5rem;
+  font-weight: 600;
+  color: #2c3e50;
+  margin: 0;
+  padding: 1.5rem 2rem;
+  background: #f8f9fa;
+  border-bottom: 1px solid #e9ecef;
+}
+
+.tableContainer {
+  overflow-x: auto;
+  padding: 0;
+}
+
+.table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.9rem;
+}
+
+.table th {
+  background: #34495e;
+  color: white;
+  font-weight: 600;
+  padding: 1rem;
+  text-align: left;
+  white-space: nowrap;
+}
+
+.table td {
+  padding: 1rem;
+  border-bottom: 1px solid #e9ecef;
+  vertical-align: top;
+}
+
+.table tr:hover {
+  background: #f8f9fa;
+}
+
+.movieTitle {
+  font-weight: 600;
+  color: #2c3e50;
+  max-width: 200px;
+  word-wrap: break-word;
+}
+
+.year {
+  font-weight: 600;
+}
+
+.rank {
+  font-weight: 700;
+}
+
+.directorName {
+  font-weight: 600;
+  color: #2c3e50;
+}
+
+.commentsContainer {
+  max-width: 300px;
+}
+
+.comment {
+  margin-bottom: 0.75rem;
+  padding: 0.5rem;
+  background: #f8f9fa;
+  border-radius: 4px;
+  border-left: 3px solid #3498db;
+}
+
+.comment:last-child {
+  margin-bottom: 0;
+}
+
+.commentText {
+  font-size: 0.85rem;
+  color: #2c3e50;
+  margin-bottom: 0.25rem;
+  line-height: 1.4;
+}
+
+.commentMeta {
+  font-size: 0.75rem;
+  color: #7f8c8d;
+  font-style: italic;
+}
+
+.error {
+  color: #e74c3c;
+  background: #ffeaa7;
+  padding: 1rem;
+  margin: 1rem 2rem;
+  border-radius: 4px;
+  font-weight: 500;
+}
+
+/* Responsive design */
+@media (max-width: 768px) {
+  .container {
+    padding: 1rem;
+  }
+  
+  .title {
+    font-size: 2rem;
+  }
+  
+  .sectionTitle {
+    padding: 1rem;
+    font-size: 1.25rem;
+  }
+  
+  .table {
+    font-size: 0.8rem;
+  }
+  
+  .table th,
+  .table td {
+    padding: 0.5rem;
+  }
+  
+  .commentsContainer {
+    max-width: 200px;
+  }
+  
+  .movieTitle {
+    max-width: 150px;
+  }
+}
+
+@media (max-width: 480px) {
+  .table th,
+  .table td {
+    padding: 0.25rem;
+  }
+  
+  .commentsContainer {
+    max-width: 150px;
+  }
+}
\ No newline at end of file
diff --git a/client/app/aggregations/page.tsx b/client/app/aggregations/page.tsx
new file mode 100644
index 0000000..a211141
--- /dev/null
+++ b/client/app/aggregations/page.tsx
@@ -0,0 +1,156 @@
+import React from 'react';
+import { fetchMoviesWithComments, fetchMoviesByYear, fetchDirectorStats } from '../lib/api';
+import { MovieWithComments, YearlyStats, DirectorStats } from '../types/aggregations';
+import styles from './aggregations.module.css';
+
+export default async function AggregationsPage() {
+  const MOVIES_WITH_COMMENTS_LIMIT = 5;
+  const DIRECTOR_STATS_LIMIT = 15;
+
+  // Fetch all aggregation data with error handling
+  const [commentsResult, yearResult, directorsResult] = await Promise.allSettled([
+    fetchMoviesWithComments(MOVIES_WITH_COMMENTS_LIMIT),
+    fetchMoviesByYear(),
+    fetchDirectorStats(DIRECTOR_STATS_LIMIT)
+  ]);
+
+  // Process results with fallbacks
+  const commentsData = commentsResult.status === 'fulfilled' ? commentsResult.value : { success: false, error: 'Failed to fetch comments data' };
+  const yearData = yearResult.status === 'fulfilled' ? yearResult.value : { success: false, error: 'Failed to fetch year data' };
+  const directorsData = directorsResult.status === 'fulfilled' ? directorsResult.value : { success: false, error: 'Failed to fetch directors data' };
+
+  if (process.env.NODE_ENV === 'development') {
+    console.log('Aggregations SSR: Data fetch completed', {
+      comments: commentsData.success,
+      year: yearData.success,
+      directors: directorsData.success
+    });
+  }
+
+  return (
+    <div className={styles.container}>
+      <h1 className={styles.title}>Movie Analytics Aggregations</h1>
+      <p className={styles.subtitle}>
+        Explore movie data through various aggregations and insights
+      </p>
+
+      {/* Movies with Recent Comments Section */}
+      <section className={styles.section}>
+        <h2 className={styles.sectionTitle}>Movies with Recent Comments</h2>
+        {commentsData.success && commentsData.data ? (
+          <div className={styles.tableContainer}>
+            <table className={styles.table}>
+              <thead>
+                <tr>
+                  <th>Movie Title</th>
+                  <th>Year</th>
+                  <th>Rating</th>
+                  <th>Total Comments</th>
+                  <th>Recent Comments</th>
+                </tr>
+              </thead>
+              <tbody>
+                {(commentsData.data as MovieWithComments[]).map((movie) => (
+                  <tr key={movie._id}>
+                    <td className={styles.movieTitle}>{movie.title}</td>
+                    <td>{movie.year}</td>
+                    <td>{movie.imdbRating ? movie.imdbRating.toFixed(1) : 'N/A'}</td>
+                    <td>{movie.totalComments}</td>
+                    <td>
+                      <div className={styles.commentsContainer}>
+                        {movie.recentComments?.slice(0, 2).map((comment, index) => (
+                          <div key={`${movie._id}-${comment.date}-${index}`} className={styles.comment}>
+                            <div className={styles.commentText}>
+                              &ldquo;{(comment.text || 'No text').slice(0, 80)}{comment.text?.length > 80 ? '...' : ''}&rdquo;
+                            </div>
+                            <div className={styles.commentMeta}>
+                              by {comment.userName} on {new Date(comment.date).toLocaleDateString()}
+                            </div>
+                          </div>
+                        )) || <div>No recent comments</div>}
+                      </div>
+                    </td>
+                  </tr>
+                ))}
+              </tbody>
+            </table>
+          </div>
+        ) : (
+          <div className={styles.error}>
+            Failed to load movies with comments: {commentsData.error || 'Unknown error'}
+          </div>
+        )}
+      </section>
+
+      {/* Movies by Year Section */}
+      <section className={styles.section}>
+        <h2 className={styles.sectionTitle}>Movies by Year Statistics</h2>
+        {yearData.success && yearData.data ? (
+          <div className={styles.tableContainer}>
+            <table className={styles.table}>
+              <thead>
+                <tr>
+                  <th>Year</th>
+                  <th>Movie Count</th>
+                  <th>Average Rating</th>
+                  <th>Highest Rating</th>
+                  <th>Lowest Rating</th>
+                  <th>Total Votes</th>
+                </tr>
+              </thead>
+              <tbody>
+                {(yearData.data as YearlyStats[]).slice(0, 20).map((yearStats) => (
+                  <tr key={yearStats.year}>
+                    <td className={styles.year}>{yearStats.year}</td>
+                    <td>{yearStats.movieCount}</td>
+                    <td>{yearStats.averageRating ? yearStats.averageRating.toFixed(2) : 'N/A'}</td>
+                    <td>{yearStats.highestRating ? yearStats.highestRating.toFixed(1) : 'N/A'}</td>
+                    <td>{yearStats.lowestRating ? yearStats.lowestRating.toFixed(1) : 'N/A'}</td>
+                    <td>{yearStats.totalVotes?.toLocaleString() || 'N/A'}</td>
+                  </tr>
+                ))}
+              </tbody>
+            </table>
+          </div>
+        ) : (
+          <div className={styles.error}>
+            Failed to load yearly statistics: {yearData.error || 'Unknown error'}
+          </div>
+        )}
+      </section>
+
+      {/* Directors with Most Movies Section */}
+      <section className={styles.section}>
+        <h2 className={styles.sectionTitle}>Directors with Most Movies</h2>
+        {directorsData.success && directorsData.data ? (
+          <div className={styles.tableContainer}>
+            <table className={styles.table}>
+              <thead>
+                <tr>
+                  <th>Rank</th>
+                  <th>Director</th>
+                  <th>Movie Count</th>
+                  <th>Average Rating</th>
+                </tr>
+              </thead>
+              <tbody>
+                {(directorsData.data as DirectorStats[]).map((director, index) => (
+                  <tr key={director.director}>
+                    <td className={styles.rank}>#{index + 1}</td>
+                    <td className={styles.directorName}>{director.director}</td>
+                    <td>{director.movieCount}</td>
+                    <td>{director.averageRating ? director.averageRating.toFixed(2) : 'N/A'}</td>
+                  </tr>
+                ))}
+              </tbody>
+            </table>
+          </div>
+        ) : (
+          <div className={styles.error}>
+            Failed to load director statistics: {directorsData.error || 'Unknown error'}
+          </div>
+        )}
+      </section>
+    </div>
+  );
+}
\ No newline at end of file
diff --git a/client/app/layout.tsx b/client/app/layout.tsx
index acabb89..4ae50ee 100644
--- a/client/app/layout.tsx
+++ b/client/app/layout.tsx
@@ -38,6 +38,12 @@ export default function RootLayout({
               >
                 Movies
               </Link>
+              <Link 
+                href={ROUTES.aggregations}
+                className={styles.navLink}
+              >
+                Aggregations
+              </Link>
             </div>
           </div>
         </nav>
diff --git a/client/app/lib/api.ts b/client/app/lib/api.ts
index 02f4cb5..1d3929c 100644
--- a/client/app/lib/api.ts
+++ b/client/app/lib/api.ts
@@ -437,3 +437,221 @@ export async function searchMovies(searchParams: {
     };
   }
 }
+
+/**
+ * Aggregation API Functions for Aggregations
+ */
+
+// Type definitions for aggregation responses
+export interface MovieWithComments {
+  _id: string;
+  title: string;
+  year: number;
+  genres: string[];
+  imdbRating: number;
+  totalComments: number;
+  recentComments: Array<{
+    userName: string;
+    userEmail: string;
+    text: string;
+    date: string;
+  }>;
+}
+
+export interface YearlyStats {
+  year: number;
+  movieCount: number;
+  averageRating: number;
+  highestRating: number;
+  lowestRating: number;
+  totalVotes: number;
+}
+
+export interface DirectorStats {
+  director: string;
+  movieCount: number;
+  averageRating: number;
+}
+
+/**
+ * Fetch movies with their most recent comments
+ */
+export async function fetchMoviesWithComments(
+  limit: number = 5,
+  movieId?: string
+): Promise<{ success: boolean; error?: string; data?: MovieWithComments[] }> {
+  try {
+    const queryParams = new URLSearchParams();
+    queryParams.append('limit', limit.toString());
+    if (movieId) {
+      queryParams.append('movie_id', movieId);
+    }
+
+    console.log(`Fetching comments from: ${API_BASE_URL}/api/movies/aggregations/reportingByComments?${queryParams}`);
+    
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 15000); // 15 second timeout
+    
+    const response = await fetch(`${API_BASE_URL}/api/movies/aggregations/reportingByComments?${queryParams}`, {
+      signal: controller.signal,
+      next: { revalidate: 300 },
+      headers: {
+        'Accept': 'application/json',
+        'Content-Type': 'application/json',
+      },
+    });
+
+    clearTimeout(timeoutId);
+    console.log(`Comments response status: ${response.status}`);
+
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => 'Unable to read error response');
+      console.error(`Comments API error: ${response.status} - ${errorText}`);
+      throw new Error(`HTTP ${response.status}: ${errorText || 'Unknown error'}`);
+    }
+
+    const result = await response.json();
+    console.log('Comments result:', result.success ? `${result.data?.length || 0} items` : 'failed');
+    
+    if (!result.success) {
+      return { 
+        success: false, 
+        error: result.error || 'API returned error response' 
+      };
+    }
+
+    return {
+      success: true,
+      data: result.data
+    };
+  } catch (error) {
+    console.error('Error fetching movies with comments:', error);
+    if (error instanceof Error && error.name === 'AbortError') {
+      return {
+        success: false,
+        error: 'Request timed out after 15 seconds'
+      };
+    }
+    return { 
+      success: false, 
+      error: error instanceof Error ? error.message : 'Network error occurred while fetching movies with comments'
+    };
+  }
+}
+
+/**
+ * Fetch movies aggregated by year with statistics
+ */
+export async function fetchMoviesByYear(): Promise<{ success: boolean; error?: string; data?: YearlyStats[] }> {
+  try {
+    console.log(`Fetching year stats from: ${API_BASE_URL}/api/movies/aggregations/reportingByYear`);
+    
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 15000); // 15 second timeout
+    
+    const response = await fetch(`${API_BASE_URL}/api/movies/aggregations/reportingByYear`, {
+      signal: controller.signal,
+      next: { revalidate: 300 },
+      headers: {
+        'Accept': 'application/json',
+        'Content-Type': 'application/json',
+      },
+    });
+
+    clearTimeout(timeoutId);
+    console.log(`Year stats response status: ${response.status}`);
+
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => 'Unable to read error response');
+      console.error(`Year stats API error: ${response.status} - ${errorText}`);
+      throw new Error(`HTTP ${response.status}: ${errorText || 'Unknown error'}`);
+    }
+
+    const result = await response.json();
+    console.log('Year stats result:', result.success ? `${result.data?.length || 0} years` : 'failed');
+    
+    if (!result.success) {
+      return { 
+        success: false, 
+        error: result.error || 'API returned error response' 
+      };
+    }
+
+    return {
+      success: true,
+      data: result.data
+    };
+  } catch (error) {
+    console.error('Error fetching movies by year:', error);
+    if (error instanceof Error && error.name === 'AbortError') {
+      return {
+        success: false,
+        error: 'Request timed out after 15 seconds'
+      };
+    }
+    return { 
+      success: false, 
+      error: error instanceof Error ? error.message : 'Network error occurred while fetching movies by year'
+    };
+  }
+}
+
+/**
+ * Fetch directors with most movies and their statistics
+ */
+export async function fetchDirectorStats(limit: number = 20): Promise<{ success: boolean; error?: string; data?: DirectorStats[] }> {
+  try {
+    const queryParams = new URLSearchParams();
+    queryParams.append('limit', limit.toString());
+
+    console.log(`Fetching director stats from: ${API_BASE_URL}/api/movies/aggregations/reportingByDirectors?${queryParams}`);
+    
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 15000); // 15 second timeout
+    
+    const response = await fetch(`${API_BASE_URL}/api/movies/aggregations/reportingByDirectors?${queryParams}`, {
+      signal: controller.signal,
+      next: { revalidate: 300 },
+      headers: {
+        'Accept': 'application/json',
+        'Content-Type': 'application/json',
+      },
+    });
+
+    clearTimeout(timeoutId);
+    console.log(`Director stats response status: ${response.status}`);
+
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => 'Unable to read error response');
+      console.error(`Director stats API error: ${response.status} - ${errorText}`);
+      throw new Error(`HTTP ${response.status}: ${errorText || 'Unknown error'}`);
+    }
+
+    const result = await response.json();
+    console.log('Director stats result:', result.success ? `${result.data?.length || 0} directors` : 'failed');
+    
+    if (!result.success) {
+      return { 
+        success: false, 
+        error: result.error || 'API returned error response' 
+      };
+    }
+
+    return {
+      success: true,
+      data: result.data
+    };
+  } catch (error) {
+    console.error('Error fetching director stats:', error);
+    if (error instanceof Error && error.name === 'AbortError') {
+      return {
+        success: false,
+        error: 'Request timed out after 15 seconds'
+      };
+    }
+    return { 
+      success: false, 
+      error: error instanceof Error ? error.message : 'Network error occurred while fetching director stats'
+    };
+  }
+}
diff --git a/client/app/lib/constants.ts b/client/app/lib/constants.ts
index a0308bb..9eb2092 100644
--- a/client/app/lib/constants.ts
+++ b/client/app/lib/constants.ts
@@ -14,6 +14,7 @@ export const ROUTES = {
   home: '/',
   movies: '/movies',
   movie: (id: string) => `/movie/${id}`,
+  aggregations: '/aggregations',
 } as const;
 
 export const API_ENDPOINTS = {
diff --git a/client/app/movies/page.tsx b/client/app/movies/page.tsx
index 421478e..bfae6e1 100644
--- a/client/app/movies/page.tsx
+++ b/client/app/movies/page.tsx
@@ -56,7 +56,7 @@ export default function Movies() {
       setHasNextPage(result.hasNextPage);
       setHasPrevPage(result.hasPrevPage);
     } catch (err) {
-      setError('Failed to load movies. Make sure the Express server is running on port 3001.');
+      setError('Failed to load movies. Make sure the server is running on port 3001.');
       setMovies([]);
     }
     
@@ -449,7 +449,7 @@ export default function Movies() {
                 <p>
                   {isSearchMode 
                     ? 'No movies found matching your search criteria. Try different search terms.'
-                    : 'No movies found. Make sure the Express server is running on port 3001.'
+                    : 'No movies found. Make sure the server is running on port 3001.'
                   }
                 </p>
               </div>
diff --git a/client/app/types/aggregations.ts b/client/app/types/aggregations.ts
new file mode 100644
index 0000000..dea239d
--- /dev/null
+++ b/client/app/types/aggregations.ts
@@ -0,0 +1,31 @@
+// Type definitions for aggregations page
+
+export interface MovieWithComments {
+  _id: string;
+  title: string;
+  year: number;
+  genres: string[];
+  imdbRating: number;
+  totalComments: number;
+  recentComments: Array<{
+    userName: string;
+    userEmail: string;
+    text: string;
+    date: string;
+  }>;
+}
+
+export interface YearlyStats {
+  year: number;
+  movieCount: number;
+  averageRating: number;
+  highestRating: number;
+  lowestRating: number;
+  totalVotes: number;
+}
+
+export interface DirectorStats {
+  director: string;
+  movieCount: number;
+  averageRating: number;
+}
\ No newline at end of file
diff --git a/server/python/main.py b/server/python/main.py
index c8bcdb9..9dbeeb4 100644
--- a/server/python/main.py
+++ b/server/python/main.py
@@ -27,40 +27,71 @@
 
 
 @app.on_event("startup")
-async def ensure_search_index():
+async def initialize_database_indexes():
     try:
         movies_collection = db.get_collection("movies")
+        comments_collection = db.get_collection("comments")
+        
+        # Check and create search index for movies collection
         result = await movies_collection.list_search_indexes()
         indexes = [idx async for idx in result]
         index_names = [index["name"] for index in indexes]
         if "movieSearchIndex" in index_names:
             print("MongoDB Search index already exists.")
-            return
-
-        # Create a mapping if the movieSearchIndex does not exist
-        index_definition = {
-            "mappings": {
-                "dynamic": False,
-                "fields": {
-                    "plot": {"type": "string", "analyzer": "lucene.standard"},
-                    "fullplot": {"type": "string", "analyzer": "lucene.standard"},
-                    "directors": {"type": "string", "analyzer": "lucene.standard"},
-                    "writers": {"type": "string", "analyzer": "lucene.standard"},
-                    "cast": {"type": "string", "analyzer": "lucene.standard"}
+        else:
+            # Create a mapping if the movieSearchIndex does not exist
+            index_definition = {
+                "mappings": {
+                    "dynamic": False,
+                    "fields": {
+                        "plot": {"type": "string", "analyzer": "lucene.standard"},
+                        "fullplot": {"type": "string", "analyzer": "lucene.standard"},
+                        "directors": {"type": "string", "analyzer": "lucene.standard"},
+                        "writers": {"type": "string", "analyzer": "lucene.standard"},
+                        "cast": {"type": "string", "analyzer": "lucene.standard"}
+                    }
                 }
             }
-        }
-        # Creates movieSearchIndex on the movies collection
-        await db.command({
-            "createSearchIndexes": "movies",
-            "indexes": [{
-                "name": "movieSearchIndex",
-                "definition": index_definition
-            }]
-        })
-        print("MongoDB Search index created.")
+            # Creates movieSearchIndex on the movies collection
+            await db.command({
+                "createSearchIndexes": "movies",
+                "indexes": [{
+                    "name": "movieSearchIndex",
+                    "definition": index_definition
+                }]
+            })
+            print("MongoDB Search index created.")
+        
+        # Check and create index on movie_id field in comments collection
+        # This index will significantly improve $lookup performance in aggregations
+        cursor = await comments_collection.list_indexes()
+        existing_indexes = await cursor.to_list(length=None)
+        movie_id_index_exists = any(
+            "movie_id" in index.get("key", {}) for index in existing_indexes
+        )
+        
+        if not movie_id_index_exists:
+            # Create index on movie_id field for better aggregation performance
+            await comments_collection.create_index("movie_id")
+            print("Index on 'movie_id' field in comments collection created.")
+        else:
+            print("Index on 'movie_id' field in comments collection already exists.")
+            
+        # Also create a compound index on movie_id and date for even better performance
+        # when sorting comments by date within each movie
+        compound_index_exists = any(
+            index.get("key", {}).get("movie_id") == 1 and index.get("key", {}).get("date") == -1
+            for index in existing_indexes
+        )
+        
+        if not compound_index_exists:
+            await comments_collection.create_index([("movie_id", 1), ("date", -1)])
+            print("Compound index on 'movie_id' and 'date' fields in comments collection created.")
+        else:
+            print("Compound index on 'movie_id' and 'date' fields already exists.")
+            
     except Exception as e:
-        print(f"Error creating the search index: {e}")
+        print(f"Error creating indexes: {e}")
 
 @app.on_event("startup")
 async def vector_search_index():
diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 6538f96..df4c213 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -473,7 +473,7 @@ async def aggregate_movies_recent_commented(
         # - If querying all movies: return up to 20 results
         # Tip: This prevents overwhelming the client with too much data
         {
-            "$limit": 50 if movie_id else 20
+            "$limit": 20 if movie_id else 5
         },
         # STAGE 7: $project - Shape Final Response Output
         {

From 2755c63bb24f10d11d17c96b332f28a94d857a4c Mon Sep 17 00:00:00 2001
From: Jordan Smith <jordan.smith@mongodb.com>
Date: Thu, 6 Nov 2025 11:36:54 -0500
Subject: [PATCH 078/110] feat: add searches and aggregation to express backend

---
 client/tsconfig.json                          |   2 +-
 server/express/package.json                   |   5 +-
 .../src/controllers/movieController.ts        | 746 +++++++++++++++++-
 server/express/src/routes/movies.ts           |  48 ++
 server/express/src/types/index.ts             | 132 ++++
 server/express/src/utils/errorHandler.ts      |   2 +-
 .../tests/controllers/movieController.test.ts | 734 ++++++++++++++---
 server/express/tests/utils/testHelpers.ts     | 259 ++++++
 8 files changed, 1830 insertions(+), 98 deletions(-)
 create mode 100644 server/express/tests/utils/testHelpers.ts

diff --git a/client/tsconfig.json b/client/tsconfig.json
index ddba9b4..b0209d7 100644
--- a/client/tsconfig.json
+++ b/client/tsconfig.json
@@ -15,7 +15,7 @@
     "moduleResolution": "bundler",
     "resolveJsonModule": true,
     "isolatedModules": true,
-    "jsx": "react-jsx",
+    "jsx": "preserve",
     "incremental": true,
     "plugins": [
       {
diff --git a/server/express/package.json b/server/express/package.json
index 29b341c..c067a31 100644
--- a/server/express/package.json
+++ b/server/express/package.json
@@ -12,7 +12,10 @@
     "dev": "ts-node src/app.ts",
     "test": "jest",
     "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage"
+    "test:coverage": "jest --coverage",
+    "test:unit": "jest tests/controllers",
+    "test:verbose": "jest --verbose",
+    "test:silent": "jest --silent"
   },
   "dependencies": {
     "cors": "^2.8.5",
diff --git a/server/express/src/controllers/movieController.ts b/server/express/src/controllers/movieController.ts
index 13021b4..55032d8 100644
--- a/server/express/src/controllers/movieController.ts
+++ b/server/express/src/controllers/movieController.ts
@@ -17,7 +17,7 @@
  */
 
 import { Request, Response } from "express";
-import { ObjectId, Sort } from "mongodb";
+import { ObjectId, Sort, Document } from "mongodb";
 import { getCollection } from "../config/database";
 import {
   createErrorResponse,
@@ -25,11 +25,17 @@ import {
   validateRequiredFields,
 } from "../utils/errorHandler";
 import {
-  Movie,
   CreateMovieRequest,
   UpdateMovieRequest,
   RawSearchQuery,
   MovieFilter,
+  VectorSearchResult,
+  MovieWithCommentsResult,
+  SearchMoviesResponse,
+  RawMovieSearchQuery,
+  SearchPhrase,
+  AggregationComment,
+  VoyageAIResponse,
 } from "../types";
 
 /**
@@ -516,3 +522,739 @@ export async function findAndDeleteMovie(
     createSuccessResponse(deletedMovie, "Movie found and deleted successfully")
   );
 }
+
+/**
+ * GET /api/movies/search
+ *
+ * Search movies using MongoDB Search across multiple fields.
+ * Demonstrates MongoDB Search with compound queries.
+ */
+export async function searchMovies(req: Request, res: Response): Promise<void> {
+  const moviesCollection = getCollection("movies");
+
+  const {
+    plot,
+    fullplot,
+    directors,
+    writers,
+    cast,
+    limit = "20",
+    skip = "0",
+    searchOperator = "must",
+  }: RawMovieSearchQuery = req.query;
+
+  // Validate search operator
+  const validOperators = ["must", "should", "mustNot", "filter"];
+  if (!validOperators.includes(searchOperator)) {
+    res
+      .status(400)
+      .json(
+        createErrorResponse(
+          `Invalid search_operator '${searchOperator}'. Must be one of: ${validOperators.join(", ")}`,
+          "INVALID_SEARCH_OPERATOR"
+        )
+      );
+    return;
+  }
+
+  // Build search phrases array
+  const searchPhrases: SearchPhrase[] = [];
+
+  if (plot) {
+    searchPhrases.push({
+      phrase: {
+        query: plot,
+        path: "plot",
+      },
+    });
+  }
+
+  if (fullplot) {
+    searchPhrases.push({
+      phrase: {
+        query: fullplot,
+        path: "fullplot",
+      },
+    });
+  }
+
+  if (directors) {
+    searchPhrases.push({
+      text: {
+        query: directors,
+        path: "directors",
+        fuzzy: { maxEdits: 1, prefixLength: 5 },
+      },
+    });
+  }
+
+  if (writers) {
+    searchPhrases.push({
+      text: {
+        query: writers,
+        path: "writers",
+        fuzzy: { maxEdits: 1, prefixLength: 5 },
+      },
+    });
+  }
+
+  if (cast) {
+    searchPhrases.push({
+      text: {
+        query: cast,
+        path: "cast",
+        fuzzy: { maxEdits: 1, prefixLength: 5 },
+      },
+    });
+  }
+
+  if (searchPhrases.length === 0) {
+    res
+      .status(400)
+      .json(
+        createErrorResponse(
+          "At least one search parameter must be provided",
+          "NO_SEARCH_PARAMETERS"
+        )
+      );
+    return;
+  }
+
+  // Parse pagination parameters
+  const limitNum = Math.min(Math.max(parseInt(limit) || 20, 1), 100);
+  const skipNum = Math.max(parseInt(skip) || 0, 0);
+
+  // Build aggregation pipeline
+  const pipeline = [
+    {
+      $search: {
+        index: "movieSearchIndex",
+        compound: {
+          [searchOperator]: searchPhrases,
+        },
+      },
+    },
+    {
+      $facet: {
+        totalCount: [{ $count: "count" }],
+        results: [
+          { $skip: skipNum },
+          { $limit: limitNum },
+          {
+            $project: {
+              _id: 1,
+              title: 1,
+              year: 1,
+              plot: 1,
+              fullplot: 1,
+              released: 1,
+              runtime: 1,
+              poster: 1,
+              genres: 1,
+              directors: 1,
+              writers: 1,
+              cast: 1,
+              countries: 1,
+              languages: 1,
+              rated: 1,
+              awards: 1,
+              imdb: 1,
+            },
+          },
+        ],
+      },
+    },
+  ];
+
+  const results = await moviesCollection.aggregate(pipeline).toArray();
+  const facetResult = results[0] || {};
+  const totalCount = facetResult.totalCount?.[0]?.count || 0;
+  const movies = facetResult.results || [];
+
+  const response: SearchMoviesResponse = {
+    movies,
+    totalCount,
+  };
+
+  res.json(
+    createSuccessResponse(
+      response,
+      `Found ${totalCount} movies matching the search criteria`
+    )
+  );
+}
+
+/**
+ * GET /api/movies/vector-search
+ *
+ * Search movies using MongoDB Vector Search for semantic similarity.
+ * Demonstrates vector search using embeddings to find similar plots.
+ */
+export async function vectorSearchMovies(req: Request, res: Response): Promise<void> {
+  const { q, limit = "10" } = req.query;
+
+  // Validate query parameter
+  if (!q || typeof q !== "string" || q.trim().length === 0) {
+    res
+      .status(400)
+      .json(
+        createErrorResponse(
+          "Search query is required",
+          "MISSING_QUERY_PARAMETER"
+        )
+      );
+    return;
+  }
+
+  // Check if Voyage AI API key is configured
+  if (!process.env.VOYAGE_API_KEY || process.env.VOYAGE_API_KEY.trim().length === 0) {
+    res
+      .status(400)
+      .json(
+        createErrorResponse(
+          "Vector search unavailable: VOYAGE_API_KEY not configured. Please add your API key to the .env file",
+          "SERVICE_UNAVAILABLE"
+        )
+      );
+    return;
+  }
+
+  // Validate and set limit (default: 10, min: 1, max: 50)
+  const limitNum = Math.min(Math.max(parseInt(limit as string) || 10, 1), 50);
+
+  try {
+    // Generate embedding using Voyage AI REST API
+    const queryVector = await generateVoyageEmbedding(q.trim(), process.env.VOYAGE_API_KEY);
+
+    // Get embedded movies collection
+    const embeddedMoviesCollection = getCollection("embedded_movies");
+
+    // Build the $vectorSearch aggregation pipeline
+    const pipeline = [
+      {
+        $vectorSearch: {
+          index: "vector_index",
+          path: "plot_embedding_voyage_3_large",
+          queryVector: queryVector,
+          numCandidates: limitNum * 15, // Search more candidates for better results
+          limit: limitNum,
+        },
+      },
+      {
+        $project: {
+          _id: 1,
+          title: 1,
+          plot: 1,
+          score: { $meta: "vectorSearchScore" },
+        },
+      },
+    ];
+
+    const results = await embeddedMoviesCollection.aggregate(pipeline).toArray();
+
+    // Convert ObjectId to string for each result
+    const vectorResults: VectorSearchResult[] = results.map((doc) => ({
+      _id: doc._id.toString(),
+      title: doc.title,
+      plot: doc.plot,
+      score: doc.score,
+    }));
+
+    res.json(
+      createSuccessResponse(
+        vectorResults,
+        `Found ${vectorResults.length} similar movies for query: '${q}'`
+      )
+    );
+  } catch (error) {
+    console.error("Vector search error:", error);
+    res
+      .status(500)
+      .json(
+        createErrorResponse(
+          "Error performing vector search",
+          "VECTOR_SEARCH_ERROR",
+          error instanceof Error ? error.message : "Unknown error"
+        )
+      );
+  }
+}
+
+/**
+ * GET /api/movies/find-similar-movies
+ *
+ * Find similar movies using vector search based on a movie ID.
+ * Demonstrates finding semantically similar movies using plot embeddings.
+ */
+export async function findSimilarMovies(req: Request, res: Response): Promise<void> {
+  const { movieId, limit = "10" } = req.query;
+
+  // Validate movieId parameter
+  if (!movieId || typeof movieId !== "string") {
+    res
+      .status(400)
+      .json(
+        createErrorResponse(
+          "Query parameter 'movieId' is required",
+          "MISSING_MOVIE_ID"
+        )
+      );
+    return;
+  }
+
+  if (!ObjectId.isValid(movieId)) {
+    res
+      .status(400)
+      .json(
+        createErrorResponse("Invalid movie ID format", "INVALID_OBJECT_ID")
+      );
+    return;
+  }
+
+  // Validate and set limit (default: 10, min: 1, max: 50)
+  const limitNum = Math.min(Math.max(parseInt(limit as string) || 10, 1), 50);
+
+  try {
+    const embeddedMoviesCollection = getCollection("embedded_movies");
+
+    // First, get the target movie's embedding
+    const targetMovie = await embeddedMoviesCollection.findOne({
+      _id: new ObjectId(movieId),
+    });
+
+    if (!targetMovie) {
+      res
+        .status(404)
+        .json(createErrorResponse("Movie not found", "MOVIE_NOT_FOUND"));
+      return;
+    }
+
+    if (!targetMovie.plot_embedding_voyage_3_large) {
+      res
+        .status(400)
+        .json(
+          createErrorResponse(
+            "Movie does not have embedding data",
+            "NO_EMBEDDING_DATA"
+          )
+        );
+      return;
+    }
+
+    // Use the target movie's embedding to find similar movies
+    const pipeline = [
+      {
+        $vectorSearch: {
+          index: "vector_index",
+          path: "plot_embedding_voyage_3_large",
+          queryVector: targetMovie.plot_embedding_voyage_3_large,
+          numCandidates: (limitNum + 1) * 15, // +1 to account for self-match
+          limit: limitNum + 1, // +1 to exclude self from results
+        },
+      },
+      {
+        $match: {
+          _id: { $ne: new ObjectId(movieId) }, // Exclude the original movie
+        },
+      },
+      {
+        $limit: limitNum,
+      },
+      {
+        $project: {
+          _id: 1,
+          title: 1,
+          year: 1,
+          plot: 1,
+          fullplot: 1,
+          genres: 1,
+          directors: 1,
+          cast: 1,
+          poster: 1,
+          imdb: 1,
+        },
+      },
+    ];
+
+    const results = await embeddedMoviesCollection.aggregate(pipeline).toArray();
+
+    res.json(
+      createSuccessResponse(results, `Found ${results.length} similar movies`)
+    );
+  } catch (error) {
+    console.error("Find similar movies error:", error);
+    res
+      .status(500)
+      .json(
+        createErrorResponse(
+          "Failed to find similar movies",
+          "SIMILAR_MOVIES_ERROR",
+          error instanceof Error ? error.message : "Unknown error"
+        )
+      );
+  }
+}
+
+/**
+ * GET /api/movies/aggregations/comments
+ *
+ * Aggregate movies with their most recent comments.
+ * Demonstrates MongoDB $lookup aggregation to join collections.
+ */
+export async function getMoviesWithMostRecentComments(
+  req: Request,
+  res: Response
+): Promise<void> {
+  const moviesCollection = getCollection("movies");
+  const { limit = "10", movieId } = req.query;
+
+  const limitNum = Math.min(Math.max(parseInt(limit as string) || 10, 1), 50);
+
+  // Build aggregation pipeline
+  const pipeline: Document[] = [
+    // STAGE 1: Initial filter for data quality - filters bad data in
+    // the collection
+    {
+      $match: {
+        year: { $type: "number", $gte: 1800, $lte: 2030 },
+      },
+    },
+  ];
+
+  // Add movie ID filter if provided
+  if (movieId && typeof movieId === "string") {
+    if (!ObjectId.isValid(movieId)) {
+      res
+        .status(400)
+        .json(
+          createErrorResponse("Invalid movie ID format", "INVALID_OBJECT_ID")
+        );
+      return;
+    }
+    pipeline[0].$match._id = new ObjectId(movieId);
+  }
+
+  // Add remaining pipeline stages
+  pipeline.push(
+    // STAGE 2: Join with comments collection
+    {
+      $lookup: {
+        from: "comments",
+        localField: "_id",
+        foreignField: "movie_id",
+        as: "comments",
+      },
+    },
+    // STAGE 3: Filter movies with at least one comment
+    {
+      $match: {
+        comments: { $ne: [] },
+      },
+    },
+    // STAGE 4: Add computed fields
+    {
+      $addFields: {
+        recentComments: {
+          $slice: [
+            {
+              $sortArray: {
+                input: "$comments",
+                sortBy: { date: -1 },
+              },
+            },
+            limitNum,
+          ],
+        },
+        mostRecentCommentDate: {
+          $max: "$comments.date",
+        },
+      },
+    },
+    // STAGE 5: Sort by most recent comment date
+    {
+      $sort: { mostRecentCommentDate: -1 },
+    },
+    // STAGE 6: Limit results
+    {
+      $limit: movieId ? 50 : 20,
+    },
+    // STAGE 7: Shape final output
+    {
+      $project: {
+        title: 1,
+        year: 1,
+        genres: 1,
+        _id: 1,
+        imdbRating: "$imdb.rating",
+        recentComments: {
+          $map: {
+            input: "$recentComments",
+            as: "comment",
+            in: {
+              _id: "$$comment._id",
+              userName: "$$comment.name",
+              userEmail: "$$comment.email",
+              text: "$$comment.text",
+              date: "$$comment.date",
+            },
+          },
+        },
+        totalComments: { $size: "$comments" },
+      },
+    }
+  );
+
+  const results = await moviesCollection.aggregate(pipeline).toArray();
+
+  // Convert ObjectId to string for response
+  const processedResults: MovieWithCommentsResult[] = results.map((result) => ({
+    _id: result._id.toString(),
+    title: result.title,
+    year: result.year,
+    genres: result.genres,
+    imdb: result.imdbRating ? { rating: result.imdbRating } : undefined,
+    recentComments: result.recentComments.map((comment: AggregationComment) => ({
+      _id: comment._id?.toString(),
+      userName: comment.userName,
+      userEmail: comment.userEmail,
+      text: comment.text,
+      date: comment.date,
+    })),
+    totalComments: result.totalComments,
+  }));
+
+  // Calculate total comments across all movies
+  const totalComments = processedResults.reduce(
+    (sum, result) => sum + (result.totalComments || 0),
+    0
+  );
+
+  const message = movieId
+    ? `Found ${totalComments} comments from movie`
+    : `Found ${totalComments} comments from ${processedResults.length} movie${
+        processedResults.length !== 1 ? "s" : ""
+      }`;
+
+  res.json(createSuccessResponse(processedResults, message));
+}
+
+/**
+ * GET /api/movies/aggregations/years
+ *
+ * Aggregate movies by year with statistics.
+ * Demonstrates MongoDB $group aggregation for statistical calculations.
+ */
+export async function getMoviesByYearWithStats(
+  req: Request,
+  res: Response
+): Promise<void> {
+  const moviesCollection = getCollection("movies");
+
+  const pipeline = [
+    // STAGE 1: Data quality filter
+    {
+      $match: {
+        year: { $type: "number", $gte: 1800, $lte: 2030 },
+      },
+    },
+    // STAGE 2: Group by year and calculate statistics
+    {
+      $group: {
+        _id: "$year",
+        movieCount: { $sum: 1 },
+        averageRating: {
+          $avg: {
+            $cond: [
+              {
+                $and: [
+                  { $ne: ["$imdb.rating", null] },
+                  { $ne: ["$imdb.rating", ""] },
+                  { $eq: [{ $type: "$imdb.rating" }, "double"] },
+                ],
+              },
+              "$imdb.rating",
+              "$$REMOVE",
+            ],
+          },
+        },
+        highestRating: {
+          $max: {
+            $cond: [
+              {
+                $and: [
+                  { $ne: ["$imdb.rating", null] },
+                  { $ne: ["$imdb.rating", ""] },
+                  { $eq: [{ $type: "$imdb.rating" }, "double"] },
+                ],
+              },
+              "$imdb.rating",
+              "$$REMOVE",
+            ],
+          },
+        },
+        lowestRating: {
+          $min: {
+            $cond: [
+              {
+                $and: [
+                  { $ne: ["$imdb.rating", null] },
+                  { $ne: ["$imdb.rating", ""] },
+                  { $eq: [{ $type: "$imdb.rating" }, "double"] },
+                ],
+              },
+              "$imdb.rating",
+              "$$REMOVE",
+            ],
+          },
+        },
+        totalVotes: { $sum: "$imdb.votes" },
+      },
+    },
+    // STAGE 3: Shape final output
+    {
+      $project: {
+        year: "$_id",
+        movieCount: 1,
+        averageRating: { $round: ["$averageRating", 2] },
+        highestRating: 1,
+        lowestRating: 1,
+        totalVotes: 1,
+        _id: 0,
+      },
+    },
+    // STAGE 4: Sort by year (newest first)
+    {
+      $sort: { year: -1 },
+    },
+  ];
+
+  const results = await moviesCollection.aggregate(pipeline).toArray();
+
+  res.json(
+    createSuccessResponse(
+      results,
+      `Aggregated statistics for ${results.length} years`
+    )
+  );
+}
+
+/**
+ * GET /api/movies/aggregations/directors
+ *
+ * Aggregate directors with the most movies.
+ * Demonstrates MongoDB $unwind and $group for array aggregation.
+ */
+export async function getDirectorsWithMostMovies(
+  req: Request,
+  res: Response
+): Promise<void> {
+  const moviesCollection = getCollection("movies");
+  const { limit = "20" } = req.query;
+
+  const limitNum = Math.min(Math.max(parseInt(limit as string) || 20, 1), 100);
+
+  const pipeline = [
+    // STAGE 1: Data quality filter
+    {
+      $match: {
+        directors: { $exists: true, $ne: null, $not: { $eq: [] } },
+        year: { $type: "number", $gte: 1800, $lte: 2030 },
+      },
+    },
+    // STAGE 2: Unwind directors array
+    {
+      $unwind: "$directors",
+    },
+    // STAGE 3: Clean director names
+    {
+      $match: {
+        directors: { $nin: [null, ""] },
+      },
+    },
+    // STAGE 4: Group by director
+    {
+      $group: {
+        _id: "$directors",
+        movieCount: { $sum: 1 },
+        averageRating: { $avg: "$imdb.rating" },
+      },
+    },
+    // STAGE 5: Sort by movie count
+    {
+      $sort: { movieCount: -1 },
+    },
+    // STAGE 6: Limit results
+    {
+      $limit: limitNum,
+    },
+    // STAGE 7: Shape final output
+    {
+      $project: {
+        director: "$_id",
+        movieCount: 1,
+        averageRating: { $round: ["$averageRating", 2] },
+        _id: 0,
+      },
+    },
+  ];
+
+  const results = await moviesCollection.aggregate(pipeline).toArray();
+
+  res.json(
+    createSuccessResponse(
+      results,
+      `Found ${results.length} directors with most movies`
+    )
+  );
+}
+
+/**
+ * Generates a vector embedding using the Voyage AI REST API.
+ * 
+ * This function calls the Voyage AI API directly to generate embeddings with 2048 dimensions.
+ * The voyage-3-large model supports multiple dimensions (256, 512, 1024, 2048), and we explicitly
+ * request 2048 to match the vector search index configuration.
+ * 
+ * @param text The text to generate an embedding for
+ * @param apiKey The Voyage AI API key
+ * @returns Promise<number[]> representing the embedding vector
+ */
+async function generateVoyageEmbedding(text: string, apiKey: string): Promise<number[]> {
+  // Build the request body with output_dimension set to 2048
+  const requestBody = {
+    input: [text],
+    model: "voyage-3-large",
+    output_dimension: 2048,
+    input_type: "query"
+  };
+
+  try {
+    const response = await fetch("https://api.voyageai.com/v1/embeddings", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${apiKey}`
+      },
+      body: JSON.stringify(requestBody)
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Voyage AI API returned status ${response.status}: ${errorText}`);
+    }
+
+    const data = await response.json() as VoyageAIResponse;
+    
+    // Extract the embedding from the response
+    if (!data.data || !data.data[0] || !data.data[0].embedding) {
+      throw new Error("Invalid response format from Voyage AI API");
+    }
+
+    return data.data[0].embedding;
+  } catch (error) {
+    if (error instanceof Error) {
+      throw new Error(`Failed to generate embedding: ${error.message}`);
+    }
+    throw new Error("Failed to generate embedding: Unknown error");
+  }
+}
diff --git a/server/express/src/routes/movies.ts b/server/express/src/routes/movies.ts
index 2bb9cbf..4731537 100644
--- a/server/express/src/routes/movies.ts
+++ b/server/express/src/routes/movies.ts
@@ -29,6 +29,54 @@ const router = express.Router();
  */
 router.get("/", asyncHandler(movieController.getAllMovies));
 
+/**
+ * GET /api/movies/search
+ *
+ * Search movies using MongoDB Search across multiple fields.
+ * Demonstrates MongoDB Atlas Search with compound queries and fuzzy matching.
+ */
+router.get("/search", asyncHandler(movieController.searchMovies));
+
+/**
+ * GET /api/movies/vector-search
+ *
+ * Search movies using MongoDB Vector Search for semantic similarity.
+ * Demonstrates vector search using embeddings to find similar plots.
+ */
+router.get("/vector-search", asyncHandler(movieController.vectorSearchMovies));
+
+/**
+ * GET /api/movies/find-similar-movies
+ *
+ * Find similar movies using vector search based on a movie ID.
+ * Demonstrates finding semantically similar movies using plot embeddings.
+ */
+router.get("/find-similar-movies", asyncHandler(movieController.findSimilarMovies));
+
+/**
+ * GET /api/movies/aggregations/comments
+ *
+ * Aggregate movies with their most recent comments.
+ * Demonstrates MongoDB $lookup aggregation to join collections.
+ */
+router.get("/aggregations/comments", asyncHandler(movieController.getMoviesWithMostRecentComments));
+
+/**
+ * GET /api/movies/aggregations/years
+ *
+ * Aggregate movies by year with statistics.
+ * Demonstrates MongoDB $group aggregation for statistical calculations.
+ */
+router.get("/aggregations/years", asyncHandler(movieController.getMoviesByYearWithStats));
+
+/**
+ * GET /api/movies/aggregations/directors
+ *
+ * Aggregate directors with the most movies.
+ * Demonstrates MongoDB $unwind and $group for array aggregation.
+ */
+router.get("/aggregations/directors", asyncHandler(movieController.getDirectorsWithMostMovies));
+
 /**
  * GET /api/movies/:id
  *
diff --git a/server/express/src/types/index.ts b/server/express/src/types/index.ts
index af5f127..0f2027d 100644
--- a/server/express/src/types/index.ts
+++ b/server/express/src/types/index.ts
@@ -185,3 +185,135 @@ export type ErrorResponse = {
 };
 
 export type ApiResponse<T> = SuccessResponse<T> | ErrorResponse;
+
+/**
+ * Interface for vector search results
+ */
+export interface VectorSearchResult {
+  _id: string;
+  title: string;
+  plot?: string;
+  score: number;
+}
+
+/**
+ * Interface for director statistics aggregation results
+ */
+export interface DirectorStatisticsResult {
+  director: string;
+  movieCount: number;
+  averageRating?: number;
+}
+
+/**
+ * Interface for movies by year aggregation results
+ */
+export interface MoviesByYearResult {
+  year: number;
+  movieCount: number;
+  averageRating?: number;
+  highestRating?: number;
+  lowestRating?: number;
+  totalVotes?: number;
+}
+
+/**
+ * Interface for movies with comments aggregation results
+ */
+export interface MovieWithCommentsResult {
+  _id: string;
+  title: string;
+  year?: number;
+  plot?: string;
+  poster?: string;
+  genres?: string[];
+  imdb?: {
+    rating?: number;
+    votes?: number;
+  };
+  recentComments: CommentInfo[];
+  totalComments: number;
+  mostRecentCommentDate?: Date;
+}
+
+/**
+ * Interface for comment information in aggregation results
+ */
+export interface CommentInfo {
+  _id?: string;
+  userName: string;
+  userEmail: string;
+  text: string;
+  date: Date;
+}
+
+/**
+ * Interface for search movies response with total count
+ */
+export interface SearchMoviesResponse {
+  movies: Movie[];
+  totalCount: number;
+}
+
+/**
+ * Interface for movie search request parameters
+ */
+export interface MovieSearchRequest {
+  plot?: string;
+  fullplot?: string;
+  directors?: string;
+  writers?: string;
+  cast?: string;
+  limit?: number;
+  skip?: number;
+  searchOperator?: string;
+}
+
+/**
+ * Type for raw search query parameters from MongoDB Search endpoint
+ */
+export type RawMovieSearchQuery = {
+  plot?: string;
+  fullplot?: string;
+  directors?: string;
+  writers?: string;
+  cast?: string;
+  limit?: string;
+  skip?: string;
+  searchOperator?: string;
+};
+
+/**
+ * Interface for MongoDB Atlas Search phrase queries
+ */
+export interface SearchPhrase {
+  phrase?: {
+    query: string;
+    path: string;
+  };
+  text?: {
+    query: string;
+    path: string;
+    fuzzy?: { maxEdits: number; prefixLength: number };
+  };
+}
+
+/**
+ * Interface for aggregation comment data from MongoDB pipelines
+ */
+export interface AggregationComment {
+  _id?: ObjectId;
+  userName: string;
+  userEmail: string;
+  text: string;
+  date: Date;
+}
+
+/**
+ * Interface for Voyage AI API response structure
+ */
+export interface VoyageAIResponse {
+  data: Array<{
+    embedding: number[];
+  }>;
+}
diff --git a/server/express/src/utils/errorHandler.ts b/server/express/src/utils/errorHandler.ts
index 929cf29..4ddd5c6 100644
--- a/server/express/src/utils/errorHandler.ts
+++ b/server/express/src/utils/errorHandler.ts
@@ -135,7 +135,7 @@ function parseErrorDetails(err: Error): {
  * @returns Express middleware function
  */
 export function asyncHandler(
-  fn: (req: Request, res: Response, next: NextFunction) => Promise<any>
+  fn: (req: Request, res: Response, next: NextFunction) => Promise<void>
 ) {
   return (req: Request, res: Response, next: NextFunction) => {
     try {
diff --git a/server/express/tests/controllers/movieController.test.ts b/server/express/tests/controllers/movieController.test.ts
index 3309932..ae13dbe 100644
--- a/server/express/tests/controllers/movieController.test.ts
+++ b/server/express/tests/controllers/movieController.test.ts
@@ -7,35 +7,33 @@
 
 import { Request, Response } from "express";
 import { ObjectId } from "mongodb";
-
-// Test Data Constants
-const TEST_MOVIE_ID = "507f1f77bcf86cd799439011";
-const INVALID_MOVIE_ID = "invalid-id";
-
-const SAMPLE_MOVIE = {
-  _id: TEST_MOVIE_ID,
-  title: "Test Movie",
-  year: 2024,
-  plot: "A test movie",
-  genres: ["Action"],
-};
-
-const SAMPLE_MOVIES = [
-  {
-    _id: TEST_MOVIE_ID,
-    title: "Test Movie 1",
-    year: 2024,
-    plot: "A test movie",
-    genres: ["Action"],
-  },
-  {
-    _id: TEST_MOVIE_ID + "-b",
-    title: "Test Movie 2",
-    year: 2024,
-    plot: "Another test movie",
-    genres: ["Comedy"],
-  },
-];
+import { 
+  TEST_OBJECT_IDS, 
+  SAMPLE_REQUESTS,
+  SAMPLE_RESPONSES,
+  SAMPLE_MOVIE,
+  SAMPLE_MOVIES,
+  SAMPLE_SEARCH_RESULTS,
+  SAMPLE_VECTOR_RESULTS,
+  SAMPLE_COMMENTS_AGGREGATION,
+  SAMPLE_YEARS_AGGREGATION,
+  SAMPLE_DIRECTORS_AGGREGATION,
+  createMockRequest,
+  createMockResponse,
+  createMockVoyageResponse,
+  expectSuccessResponse,
+  expectErrorResponse
+} from "../utils/testHelpers";
+
+// Mock fetch globally for vector search tests
+global.fetch = jest.fn();
+
+// Test Data Constants - Using constants from testHelpers
+const TEST_MOVIE_ID = TEST_OBJECT_IDS.VALID;
+const INVALID_MOVIE_ID = TEST_OBJECT_IDS.INVALID;
+
+// Mock Voyage AI API response
+const MOCK_VOYAGE_RESPONSE = createMockVoyageResponse();
 
 // Create mock collection methods
 const mockFind = jest.fn();
@@ -47,6 +45,7 @@ const mockUpdateMany = jest.fn();
 const mockDeleteOne = jest.fn();
 const mockDeleteMany = jest.fn();
 const mockFindOneAndDelete = jest.fn();
+const mockAggregate = jest.fn();
 const mockToArray = jest.fn();
 
 // Create mock database module
@@ -65,6 +64,9 @@ const mockGetCollection = jest.fn(() => ({
   deleteOne: mockDeleteOne,
   deleteMany: mockDeleteMany,
   findOneAndDelete: mockFindOneAndDelete,
+  aggregate: mockAggregate.mockReturnValue({
+    toArray: mockToArray,
+  }),
 }));
 
 // Mock the database module
@@ -112,64 +114,14 @@ import {
   deleteMovie,
   deleteMoviesBatch,
   findAndDeleteMovie,
+  searchMovies,
+  vectorSearchMovies,
+  findSimilarMovies,
+  getMoviesWithMostRecentComments,
+  getMoviesByYearWithStats,
+  getDirectorsWithMostMovies,
 } from "../../src/controllers/movieController";
 
-// Helper Functions
-function createMockRequest(overrides: Partial<Request> = {}): Partial<Request> {
-  return {
-    query: {},
-    params: {},
-    body: {},
-    ...overrides,
-  };
-}
-
-function createMockResponse(): {
-  mockJson: jest.Mock;
-  mockStatus: jest.Mock;
-  mockResponse: Partial<Response>;
-} {
-  const mockJson = jest.fn();
-  const mockStatus = jest.fn().mockReturnThis();
-
-  const mockResponse = {
-    json: mockJson,
-    status: mockStatus,
-    setHeader: jest.fn(),
-  };
-
-  return { mockJson, mockStatus, mockResponse };
-}
-
-function expectSuccessResponse(
-  mockCreateSuccessResponse: jest.Mock,
-  data: any,
-  message: string
-) {
-  expect(mockCreateSuccessResponse).toHaveBeenCalledWith(data, message);
-}
-
-function expectErrorResponse(
-  mockStatus: jest.Mock,
-  mockJson: jest.Mock,
-  statusCode: number,
-  errorMessage: string,
-  errorCode: string
-) {
-  expect(mockStatus).toHaveBeenCalledWith(statusCode);
-  expect(mockCreateErrorResponse).toHaveBeenCalledWith(errorMessage, errorCode);
-  expect(mockJson).toHaveBeenCalledWith({
-    success: false,
-    message: errorMessage,
-    error: {
-      message: errorMessage,
-      code: errorCode,
-      details: undefined,
-    },
-    timestamp: "2024-01-01T00:00:00.000Z",
-  });
-}
-
 describe("Movie Controller Tests", () => {
   let mockRequest: Partial<Request>;
   let mockResponse: Partial<Response>;
@@ -314,8 +266,8 @@ describe("Movie Controller Tests", () => {
 
   describe("createMovie", () => {
     it("should successfully create a movie", async () => {
-      const movieData = { title: "New Movie", year: 2024 };
-      const insertResult = { acknowledged: true, insertedId: new ObjectId() };
+      const movieData = SAMPLE_REQUESTS.CREATE_MOVIE;
+      const insertResult = SAMPLE_RESPONSES.INSERT_ONE;
       const createdMovie = { _id: insertResult.insertedId, ...movieData };
 
       mockRequest.body = movieData;
@@ -368,12 +320,8 @@ describe("Movie Controller Tests", () => {
 
   describe("createMoviesBatch", () => {
     it("should successfully create multiple movies", async () => {
-      const moviesData = [{ title: "Movie 1" }, { title: "Movie 2" }];
-      const insertResult = {
-        acknowledged: true,
-        insertedCount: 2,
-        insertedIds: [new ObjectId(), new ObjectId()],
-      };
+      const moviesData = SAMPLE_REQUESTS.BATCH_CREATE;
+      const insertResult = SAMPLE_RESPONSES.INSERT_MANY;
 
       mockRequest.body = moviesData;
       mockValidateRequiredFields.mockImplementation(() => {}); // Don't throw validation error
@@ -678,4 +626,604 @@ describe("Movie Controller Tests", () => {
       ).rejects.toThrow(errorMessage);
     });
   });
+
+  // ==================== SEARCH ENDPOINTS TESTS ====================
+
+  describe("searchMovies", () => {
+    beforeEach(() => {
+      // Reset environment variables
+      delete process.env.NODE_ENV;
+    });
+
+    it("should successfully search movies by plot", async () => {
+      const searchResults = [
+        {
+          totalCount: [{ count: 2 }],
+          results: SAMPLE_SEARCH_RESULTS,
+        },
+      ];
+
+      mockRequest.query = { plot: "space adventure" };
+      mockToArray.mockResolvedValue(searchResults);
+
+      await searchMovies(mockRequest as Request, mockResponse as Response);
+
+      expect(mockGetCollection).toHaveBeenCalledWith("movies");
+      expect(mockAggregate).toHaveBeenCalled();
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        {
+          movies: SAMPLE_SEARCH_RESULTS,
+          totalCount: 2,
+        },
+        "Found 2 movies matching the search criteria"
+      );
+    });
+
+    it("should handle search with multiple fields", async () => {
+      const searchResults = [
+        {
+          totalCount: [{ count: 1 }],
+          results: [SAMPLE_SEARCH_RESULTS[0]],
+        },
+      ];
+
+      mockRequest.query = {
+        plot: "space",
+        directors: "Nolan",
+        cast: "DiCaprio",
+      };
+      mockToArray.mockResolvedValue(searchResults);
+
+      await searchMovies(mockRequest as Request, mockResponse as Response);
+
+      expect(mockAggregate).toHaveBeenCalled();
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        {
+          movies: [SAMPLE_SEARCH_RESULTS[0]],
+          totalCount: 1,
+        },
+        "Found 1 movies matching the search criteria"
+      );
+    });
+
+    it("should return 400 when no search parameters provided", async () => {
+      mockRequest.query = {};
+
+      await searchMovies(mockRequest as Request, mockResponse as Response);
+
+      expectErrorResponse(
+        mockStatus,
+        mockJson,
+        400,
+        "At least one search parameter must be provided",
+        "NO_SEARCH_PARAMETERS"
+      );
+    });
+
+    it("should return 400 for invalid search operator", async () => {
+      mockRequest.query = {
+        plot: "adventure",
+        searchOperator: "invalid",
+      };
+
+      await searchMovies(mockRequest as Request, mockResponse as Response);
+
+      expectErrorResponse(
+        mockStatus,
+        mockJson,
+        400,
+        "Invalid search_operator 'invalid'. Must be one of: must, should, mustNot, filter",
+        "INVALID_SEARCH_OPERATOR"
+      );
+    });
+
+    it("should handle pagination parameters", async () => {
+      const searchResults = [
+        {
+          totalCount: [{ count: 10 }],
+          results: SAMPLE_SEARCH_RESULTS,
+        },
+      ];
+
+      mockRequest.query = {
+        plot: "adventure",
+        limit: "5",
+        skip: "10",
+      };
+      mockToArray.mockResolvedValue(searchResults);
+
+      await searchMovies(mockRequest as Request, mockResponse as Response);
+
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        {
+          movies: SAMPLE_SEARCH_RESULTS,
+          totalCount: 10,
+        },
+        "Found 10 movies matching the search criteria"
+      );
+    });
+
+    it("should return empty results when no matches found", async () => {
+      const searchResults = [
+        {
+          totalCount: [],
+          results: [],
+        },
+      ];
+
+      mockRequest.query = { plot: "nonexistent" };
+      mockToArray.mockResolvedValue(searchResults);
+
+      await searchMovies(mockRequest as Request, mockResponse as Response);
+
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        {
+          movies: [],
+          totalCount: 0,
+        },
+        "Found 0 movies matching the search criteria"
+      );
+    });
+  });
+
+  describe("vectorSearchMovies", () => {
+    const mockFetch = fetch as jest.MockedFunction<typeof fetch>;
+
+    beforeEach(() => {
+      process.env.VOYAGE_API_KEY = "test-api-key";
+      mockFetch.mockClear();
+    });
+
+    afterEach(() => {
+      delete process.env.VOYAGE_API_KEY;
+    });
+
+    it("should successfully perform vector search", async () => {
+      // Mock Voyage AI API response
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: () => Promise.resolve(MOCK_VOYAGE_RESPONSE),
+      } as any);
+
+      // Mock database response
+      mockToArray.mockResolvedValue(SAMPLE_VECTOR_RESULTS);
+
+      mockRequest.query = { q: "space adventure", limit: "3" };
+
+      await vectorSearchMovies(mockRequest as Request, mockResponse as Response);
+
+      expect(mockFetch).toHaveBeenCalledWith(
+        "https://api.voyageai.com/v1/embeddings",
+        expect.objectContaining({
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: "Bearer test-api-key",
+          },
+        })
+      );
+
+      expect(mockGetCollection).toHaveBeenCalledWith("embedded_movies");
+      expect(mockAggregate).toHaveBeenCalled();
+
+      const expectedResults = SAMPLE_VECTOR_RESULTS.map((result) => ({
+        _id: result._id.toString(),
+        title: result.title,
+        plot: result.plot,
+        score: result.score,
+      }));
+
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        expectedResults,
+        "Found 2 similar movies for query: 'space adventure'"
+      );
+    });
+
+    it("should return 400 when query is missing", async () => {
+      mockRequest.query = {};
+
+      await vectorSearchMovies(mockRequest as Request, mockResponse as Response);
+
+      expectErrorResponse(
+        mockStatus,
+        mockJson,
+        400,
+        "Search query is required",
+        "MISSING_QUERY_PARAMETER"
+      );
+    });
+
+    it("should return 400 when query is empty", async () => {
+      mockRequest.query = { q: "" };
+
+      await vectorSearchMovies(mockRequest as Request, mockResponse as Response);
+
+      expectErrorResponse(
+        mockStatus,
+        mockJson,
+        400,
+        "Search query is required",
+        "MISSING_QUERY_PARAMETER"
+      );
+    });
+
+    it("should return 400 when VOYAGE_API_KEY is not configured", async () => {
+      delete process.env.VOYAGE_API_KEY;
+
+      mockRequest.query = { q: "test" };
+
+      await vectorSearchMovies(mockRequest as Request, mockResponse as Response);
+
+      expectErrorResponse(
+        mockStatus,
+        mockJson,
+        400,
+        "Vector search unavailable: VOYAGE_API_KEY not configured. Please add your API key to the .env file",
+        "SERVICE_UNAVAILABLE"
+      );
+    });
+
+    it("should handle Voyage AI API errors", async () => {
+      mockFetch.mockResolvedValueOnce({
+        ok: false,
+        status: 401,
+        text: () => Promise.resolve("Unauthorized"),
+      } as any);
+
+      mockRequest.query = { q: "test" };
+
+      await vectorSearchMovies(mockRequest as Request, mockResponse as Response);
+
+      expect(mockStatus).toHaveBeenCalledWith(500);
+      expect(mockCreateErrorResponse).toHaveBeenCalledWith(
+        "Error performing vector search",
+        "VECTOR_SEARCH_ERROR",
+        expect.stringContaining("Voyage AI API returned status 401")
+      );
+    });
+
+    it("should use default limit when not provided", async () => {
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: () => Promise.resolve(MOCK_VOYAGE_RESPONSE),
+      } as any);
+
+      mockToArray.mockResolvedValue([]);
+
+      mockRequest.query = { q: "test" };
+
+      await vectorSearchMovies(mockRequest as Request, mockResponse as Response);
+
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        [],
+        "Found 0 similar movies for query: 'test'"
+      );
+    });
+  });
+
+  describe("findSimilarMovies", () => {
+    it("should successfully find similar movies", async () => {
+      const targetMovie = {
+        _id: new ObjectId(TEST_MOVIE_ID),
+        title: "Target Movie",
+        plot_embedding_voyage_3_large: new Array(2048).fill(0.1),
+      };
+
+      mockRequest.query = { movieId: TEST_MOVIE_ID, limit: "5" };
+      mockFindOne.mockResolvedValue(targetMovie);
+      mockToArray.mockResolvedValue(SAMPLE_SEARCH_RESULTS);
+
+      await findSimilarMovies(mockRequest as Request, mockResponse as Response);
+
+      expect(mockGetCollection).toHaveBeenCalledWith("embedded_movies");
+      expect(mockFindOne).toHaveBeenCalledWith({
+        _id: new ObjectId(TEST_MOVIE_ID),
+      });
+      expect(mockAggregate).toHaveBeenCalled();
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        SAMPLE_SEARCH_RESULTS,
+        "Found 2 similar movies"
+      );
+    });
+
+    it("should return 400 when movieId is missing", async () => {
+      mockRequest.query = {};
+
+      await findSimilarMovies(mockRequest as Request, mockResponse as Response);
+
+      expectErrorResponse(
+        mockStatus,
+        mockJson,
+        400,
+        "Query parameter 'movieId' is required",
+        "MISSING_MOVIE_ID"
+      );
+    });
+
+    it("should return 400 for invalid movieId format", async () => {
+      mockRequest.query = { movieId: INVALID_MOVIE_ID };
+
+      await findSimilarMovies(mockRequest as Request, mockResponse as Response);
+
+      expectErrorResponse(
+        mockStatus,
+        mockJson,
+        400,
+        "Invalid movie ID format",
+        "INVALID_OBJECT_ID"
+      );
+    });
+
+    it("should return 404 when movie not found", async () => {
+      mockRequest.query = { movieId: TEST_MOVIE_ID };
+      mockFindOne.mockResolvedValue(null);
+
+      await findSimilarMovies(mockRequest as Request, mockResponse as Response);
+
+      expectErrorResponse(
+        mockStatus,
+        mockJson,
+        404,
+        "Movie not found",
+        "MOVIE_NOT_FOUND"
+      );
+    });
+
+    it("should return 400 when movie has no embedding data", async () => {
+      const targetMovie = {
+        _id: new ObjectId(TEST_MOVIE_ID),
+        title: "Target Movie",
+        // No plot_embedding_voyage_3_large field
+      };
+
+      mockRequest.query = { movieId: TEST_MOVIE_ID };
+      mockFindOne.mockResolvedValue(targetMovie);
+
+      await findSimilarMovies(mockRequest as Request, mockResponse as Response);
+
+      expectErrorResponse(
+        mockStatus,
+        mockJson,
+        400,
+        "Movie does not have embedding data",
+        "NO_EMBEDDING_DATA"
+      );
+    });
+
+    it("should use default limit when not provided", async () => {
+      const targetMovie = {
+        _id: new ObjectId(TEST_MOVIE_ID),
+        title: "Target Movie",
+        plot_embedding_voyage_3_large: new Array(2048).fill(0.1),
+      };
+
+      mockRequest.query = { movieId: TEST_MOVIE_ID };
+      mockFindOne.mockResolvedValue(targetMovie);
+      mockToArray.mockResolvedValue([]);
+
+      await findSimilarMovies(mockRequest as Request, mockResponse as Response);
+
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        [],
+        "Found 0 similar movies"
+      );
+    });
+  });
+
+  // ==================== AGGREGATION ENDPOINTS TESTS ====================
+
+  describe("getMoviesWithMostRecentComments", () => {
+    it("should successfully get movies with comments", async () => {
+      mockRequest.query = { limit: "10" };
+      mockToArray.mockResolvedValue(SAMPLE_COMMENTS_AGGREGATION);
+
+      await getMoviesWithMostRecentComments(
+        mockRequest as Request,
+        mockResponse as Response
+      );
+
+      expect(mockGetCollection).toHaveBeenCalledWith("movies");
+      expect(mockAggregate).toHaveBeenCalled();
+
+      const expectedResults = SAMPLE_COMMENTS_AGGREGATION.map((result) => ({
+        _id: result._id.toString(),
+        title: result.title,
+        year: result.year,
+        genres: result.genres,
+        imdb: result.imdbRating ? { rating: result.imdbRating } : undefined,
+        recentComments: result.recentComments.map((comment) => ({
+          _id: comment._id?.toString(),
+          userName: comment.userName,
+          userEmail: comment.userEmail,
+          text: comment.text,
+          date: comment.date,
+        })),
+        totalComments: result.totalComments,
+      }));
+
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        expectedResults,
+        "Found 5 comments from 1 movie"
+      );
+    });
+
+    it("should filter by specific movieId when provided", async () => {
+      mockRequest.query = { movieId: TEST_MOVIE_ID };
+      mockToArray.mockResolvedValue(SAMPLE_COMMENTS_AGGREGATION);
+
+      await getMoviesWithMostRecentComments(
+        mockRequest as Request,
+        mockResponse as Response
+      );
+
+      expect(mockAggregate).toHaveBeenCalledWith(
+        expect.arrayContaining([
+          expect.objectContaining({
+            $match: expect.objectContaining({
+              _id: new ObjectId(TEST_MOVIE_ID),
+            }),
+          }),
+        ])
+      );
+    });
+
+    it("should return 400 for invalid movieId format", async () => {
+      mockRequest.query = { movieId: INVALID_MOVIE_ID };
+
+      await getMoviesWithMostRecentComments(
+        mockRequest as Request,
+        mockResponse as Response
+      );
+
+      expectErrorResponse(
+        mockStatus,
+        mockJson,
+        400,
+        "Invalid movie ID format",
+        "INVALID_OBJECT_ID"
+      );
+    });
+
+    it("should handle empty results", async () => {
+      mockRequest.query = {};
+      mockToArray.mockResolvedValue([]);
+
+      await getMoviesWithMostRecentComments(
+        mockRequest as Request,
+        mockResponse as Response
+      );
+
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        [],
+        "Found 0 comments from 0 movies"
+      );
+    });
+
+    it("should use default limit when not provided", async () => {
+      mockRequest.query = {};
+      mockToArray.mockResolvedValue(SAMPLE_COMMENTS_AGGREGATION);
+
+      await getMoviesWithMostRecentComments(
+        mockRequest as Request,
+        mockResponse as Response
+      );
+
+      expect(mockAggregate).toHaveBeenCalled();
+    });
+  });
+
+  describe("getMoviesByYearWithStats", () => {
+    it("should successfully get movies statistics by year", async () => {
+      mockRequest.query = {};
+      mockToArray.mockResolvedValue(SAMPLE_YEARS_AGGREGATION);
+
+      await getMoviesByYearWithStats(
+        mockRequest as Request,
+        mockResponse as Response
+      );
+
+      expect(mockGetCollection).toHaveBeenCalledWith("movies");
+      expect(mockAggregate).toHaveBeenCalled();
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        SAMPLE_YEARS_AGGREGATION,
+        "Aggregated statistics for 2 years"
+      );
+    });
+
+    it("should handle empty results", async () => {
+      mockRequest.query = {};
+      mockToArray.mockResolvedValue([]);
+
+      await getMoviesByYearWithStats(
+        mockRequest as Request,
+        mockResponse as Response
+      );
+
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        [],
+        "Aggregated statistics for 0 years"
+      );
+    });
+
+    it("should handle database errors", async () => {
+      mockRequest.query = {};
+      const errorMessage = "Aggregation failed";
+      mockToArray.mockRejectedValue(new Error(errorMessage));
+
+      await expect(
+        getMoviesByYearWithStats(mockRequest as Request, mockResponse as Response)
+      ).rejects.toThrow(errorMessage);
+    });
+  });
+
+  describe("getDirectorsWithMostMovies", () => {
+    it("should successfully get directors statistics", async () => {
+      mockRequest.query = { limit: "20" };
+      mockToArray.mockResolvedValue(SAMPLE_DIRECTORS_AGGREGATION);
+
+      await getDirectorsWithMostMovies(
+        mockRequest as Request,
+        mockResponse as Response
+      );
+
+      expect(mockGetCollection).toHaveBeenCalledWith("movies");
+      expect(mockAggregate).toHaveBeenCalled();
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        SAMPLE_DIRECTORS_AGGREGATION,
+        "Found 2 directors with most movies"
+      );
+    });
+
+    it("should handle custom limit parameter", async () => {
+      mockRequest.query = { limit: "10" };
+      mockToArray.mockResolvedValue(SAMPLE_DIRECTORS_AGGREGATION.slice(0, 1));
+
+      await getDirectorsWithMostMovies(
+        mockRequest as Request,
+        mockResponse as Response
+      );
+
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        SAMPLE_DIRECTORS_AGGREGATION.slice(0, 1),
+        "Found 1 directors with most movies"
+      );
+    });
+
+    it("should use default limit when not provided", async () => {
+      mockRequest.query = {};
+      mockToArray.mockResolvedValue(SAMPLE_DIRECTORS_AGGREGATION);
+
+      await getDirectorsWithMostMovies(
+        mockRequest as Request,
+        mockResponse as Response
+      );
+
+      expect(mockAggregate).toHaveBeenCalled();
+    });
+
+    it("should handle empty results", async () => {
+      mockRequest.query = {};
+      mockToArray.mockResolvedValue([]);
+
+      await getDirectorsWithMostMovies(
+        mockRequest as Request,
+        mockResponse as Response
+      );
+
+      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
+        [],
+        "Found 0 directors with most movies"
+      );
+    });
+
+    it("should handle database errors", async () => {
+      mockRequest.query = {};
+      const errorMessage = "Aggregation pipeline failed";
+      mockToArray.mockRejectedValue(new Error(errorMessage));
+
+      await expect(
+        getDirectorsWithMostMovies(mockRequest as Request, mockResponse as Response)
+      ).rejects.toThrow(errorMessage);
+    });
+  });
 });
diff --git a/server/express/tests/utils/testHelpers.ts b/server/express/tests/utils/testHelpers.ts
new file mode 100644
index 0000000..1a051e2
--- /dev/null
+++ b/server/express/tests/utils/testHelpers.ts
@@ -0,0 +1,259 @@
+/**
+ * Test Utilities and Helpers
+ *
+ * This file contains common utilities, test data, and helper functions
+ * used across unit tests to ensure consistency and reduce duplication.
+ */
+
+import { ObjectId } from "mongodb";
+import { Request, Response } from "express";
+
+export const TEST_OBJECT_IDS = {
+  VALID: "507f1f77bcf86cd799439011",
+  VALID_2: "507f1f77bcf86cd799439012",
+  INVALID: "invalid-id",
+};
+
+// ==================== SAMPLE MOVIE DATA ====================
+
+export const SAMPLE_MOVIE = {
+  _id: TEST_OBJECT_IDS.VALID,
+  title: "Test Movie",
+  year: 2024,
+  plot: "A test movie",
+  genres: ["Action"],
+};
+
+export const SAMPLE_MOVIES = [
+  {
+    _id: TEST_OBJECT_IDS.VALID,
+    title: "Test Movie 1",
+    year: 2024,
+    plot: "A test movie",
+    genres: ["Action"],
+  },
+  {
+    _id: TEST_OBJECT_IDS.VALID + "-b",
+    title: "Test Movie 2",
+    year: 2024,
+    plot: "Another test movie",
+    genres: ["Comedy"],
+  },
+];
+
+export const SAMPLE_SEARCH_RESULTS = [
+  {
+    _id: new ObjectId(),
+    title: "Space Adventure",
+    year: 2024,
+    plot: "An epic space adventure across the galaxy",
+    genres: ["Sci-Fi", "Adventure"],
+  },
+  {
+    _id: new ObjectId(),
+    title: "Space Quest",
+    year: 2023,
+    plot: "A thrilling space adventure to save humanity",
+    genres: ["Sci-Fi", "Action"],
+  },
+];
+
+export const SAMPLE_VECTOR_RESULTS = [
+  {
+    _id: new ObjectId(),
+    title: "Space Raiders",
+    plot: "A futuristic space adventure",
+    score: 0.85,
+  },
+  {
+    _id: new ObjectId(),
+    title: "Galaxy Quest",
+    plot: "An epic space journey",
+    score: 0.78,
+  },
+];
+
+export const SAMPLE_COMMENTS_AGGREGATION = [
+  {
+    _id: new ObjectId(),
+    title: "Test Movie",
+    year: 2024,
+    genres: ["Action", "Drama"],
+    imdbRating: 8.5,
+    recentComments: [
+      {
+        _id: new ObjectId(),
+        userName: "John Doe",
+        userEmail: "john@example.com",
+        text: "Great movie!",
+        date: new Date("2024-01-01"),
+      },
+    ],
+    totalComments: 5,
+  },
+];
+
+export const SAMPLE_YEARS_AGGREGATION = [
+  {
+    year: 2024,
+    movieCount: 10,
+    averageRating: 7.5,
+    highestRating: 9.0,
+    lowestRating: 6.0,
+    totalVotes: 5000,
+  },
+  {
+    year: 2023,
+    movieCount: 15,
+    averageRating: 7.8,
+    highestRating: 9.5,
+    lowestRating: 6.5,
+    totalVotes: 7500,
+  },
+];
+
+export const SAMPLE_DIRECTORS_AGGREGATION = [
+  {
+    director: "Christopher Nolan",
+    movieCount: 10,
+    averageRating: 8.5,
+  },
+  {
+    director: "Steven Spielberg",
+    movieCount: 25,
+    averageRating: 8.2,
+  },
+];
+
+// ==================== REQUEST/RESPONSE DATA ====================
+
+export const SAMPLE_REQUESTS = {
+  CREATE_MOVIE: {
+    title: "New Movie",
+    year: 2024,
+    plot: "A new movie plot",
+    genres: ["Action"],
+  },
+  UPDATE_MOVIE: {
+    title: "Updated Movie Title",
+    year: 2025,
+    plot: "Updated plot",
+  },
+  BATCH_CREATE: [
+    { title: "Batch Movie 1", year: 2024 },
+    { title: "Batch Movie 2", year: 2024 },
+  ],
+};
+
+export const SAMPLE_RESPONSES = {
+  INSERT_ONE: {
+    acknowledged: true,
+    insertedId: new ObjectId(),
+  },
+  INSERT_MANY: {
+    acknowledged: true,
+    insertedCount: 2,
+    insertedIds: [new ObjectId(), new ObjectId()],
+  },
+  UPDATE_ONE: {
+    matchedCount: 1,
+    modifiedCount: 1,
+  },
+  UPDATE_MANY: {
+    matchedCount: 5,
+    modifiedCount: 3,
+  },
+  DELETE_ONE: {
+    deletedCount: 1,
+  },
+  DELETE_MANY: {
+    deletedCount: 10,
+  },
+};
+
+// ==================== MOCK HELPER FUNCTIONS ====================
+
+/**
+ * Creates mock Express request object with default values
+ */
+export function createMockRequest(overrides: Partial<Request> = {}): Partial<Request> {
+  return {
+    query: {},
+    params: {},
+    body: {},
+    ...overrides,
+  };
+}
+
+/**
+ * Creates mock Express response object with spies
+ */
+export function createMockResponse(): {
+  mockJson: jest.Mock;
+  mockStatus: jest.Mock;
+  mockResponse: Partial<Response>;
+} {
+  const mockJson = jest.fn();
+  const mockStatus = jest.fn().mockReturnThis();
+
+  const mockResponse = {
+    json: mockJson,
+    status: mockStatus,
+    setHeader: jest.fn(),
+  };
+
+  return { mockJson, mockStatus, mockResponse };
+}
+
+/**
+ * Creates mock Voyage AI API response for vector search tests
+ */
+export function createMockVoyageResponse(dimensions = 2048) {
+  return {
+    data: [
+      {
+        embedding: new Array(dimensions).fill(0.1),
+      },
+    ],
+  };
+}
+
+// ==================== TEST ASSERTION HELPERS ====================
+
+/**
+ * Asserts that a success response was created correctly
+ */
+export function expectSuccessResponse(
+  mockCreateSuccessResponse: jest.Mock,
+  data: any,
+  message: string
+) {
+  expect(mockCreateSuccessResponse).toHaveBeenCalledWith(data, message);
+}
+
+/**
+ * Asserts that an error response was created correctly
+ */
+export function expectErrorResponse(
+  mockStatus: jest.Mock,
+  mockJson: jest.Mock,
+  statusCode: number,
+  errorMessage: string,
+  errorCode: string,
+  mockCreateErrorResponse?: jest.Mock
+) {
+  expect(mockStatus).toHaveBeenCalledWith(statusCode);
+  if (mockCreateErrorResponse) {
+    expect(mockCreateErrorResponse).toHaveBeenCalledWith(errorMessage, errorCode);
+  }
+  expect(mockJson).toHaveBeenCalledWith({
+    success: false,
+    message: errorMessage,
+    error: {
+      message: errorMessage,
+      code: errorCode,
+      details: undefined,
+    },
+    timestamp: "2024-01-01T00:00:00.000Z",
+  });
+}
\ No newline at end of file

From 8276d843c70151f0acb0f7ac57f79a4e7067b736 Mon Sep 17 00:00:00 2001
From: Jordan Smith <45415425+jordan-smith721@users.noreply.github.com>
Date: Thu, 6 Nov 2025 11:48:10 -0500
Subject: [PATCH 079/110] feat: implement vector search UI (#23)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* feat: add vector search UI

* Fix Java vector search NullPointerException and dirty data handling

- Replace List.of() with Arrays.asList() to handle null values in MongoDB aggregation pipeline
- Add safe type conversion for year field to handle dirty data (e.g., '1994è1998')
- Improve error handling with specific catch blocks for IOException and InterruptedException
- Add validation for Voyage AI API response structure
- Remove debug logging statements

* Fix Python vector search dirty data handling and missing import

- Add missing import for voyage_ai_available function
- Add conditional projection to handle non-integer year values (e.g., '1994è1998')
- Return None for invalid year data instead of causing validation errors

* add pagination to search results

---------

Co-authored-by: cbullinger <cory.bullinger@mongodb.com>
---
 .../SearchMovieModal/SearchMovieModal.tsx     | 393 +++++++++++-------
 .../app/components/SearchMovieModal/index.ts  |   2 +-
 client/app/lib/api.ts                         | 233 +++++++----
 client/app/movies/movies.module.css           |  11 +
 client/app/movies/page.tsx                    | 332 +++++++++++----
 .../model/dto/VectorSearchResult.java         |  25 ++
 .../samplemflix/service/MovieServiceImpl.java | 127 +++++-
 server/python/src/models/models.py            |   5 +
 server/python/src/routers/movies.py           |  18 +-
 9 files changed, 838 insertions(+), 308 deletions(-)

diff --git a/client/app/components/SearchMovieModal/SearchMovieModal.tsx b/client/app/components/SearchMovieModal/SearchMovieModal.tsx
index 0466819..45bfcb4 100644
--- a/client/app/components/SearchMovieModal/SearchMovieModal.tsx
+++ b/client/app/components/SearchMovieModal/SearchMovieModal.tsx
@@ -16,7 +16,11 @@ interface SearchMovieModalProps {
   isLoading?: boolean;
 }
 
+export type SearchType = 'mongodb-search' | 'vector-search';
+
 export interface SearchParams {
+  searchType: SearchType;
+  // MongoDB Search fields
   plot?: string;
   fullplot?: string;
   directors?: string;
@@ -25,9 +29,13 @@ export interface SearchParams {
   limit?: number;
   skip?: number;
   search_operator?: 'must' | 'should' | 'mustNot' | 'filter';
+  // Vector Search fields
+  q?: string;
 }
 
 interface SearchFormData {
+  searchType: SearchType;
+  // MongoDB Search fields
   plot: string;
   fullplot: string;
   directors: string;
@@ -35,9 +43,13 @@ interface SearchFormData {
   cast: string;
   limit: string;
   search_operator: 'must' | 'should' | 'mustNot' | 'filter';
+  // Vector Search fields
+  q: string;
 }
 
 const getInitialFormData = (): SearchFormData => ({
+  searchType: 'mongodb-search',
+  // MongoDB Search fields
   plot: '',
   fullplot: '',
   directors: '',
@@ -45,6 +57,8 @@ const getInitialFormData = (): SearchFormData => ({
   cast: '',
   limit: '20',
   search_operator: 'must',
+  // Vector Search fields
+  q: '',
 });
 
 export default function SearchMovieModal({ 
@@ -58,15 +72,22 @@ export default function SearchMovieModal({
   const validateForm = () => {
     const newErrors: Record<string, string> = {};
 
-    // Check if at least one search field has a value
-    const hasSearchInput = formData.plot.trim() || 
-                          formData.fullplot.trim() || 
-                          formData.directors.trim() || 
-                          formData.writers.trim() || 
-                          formData.cast.trim();
+    if (formData.searchType === 'mongodb-search') {
+      // Check if at least one search field has a value for MongoDB Search
+      const hasSearchInput = formData.plot.trim() || 
+                            formData.fullplot.trim() || 
+                            formData.directors.trim() || 
+                            formData.writers.trim() || 
+                            formData.cast.trim();
 
-    if (!hasSearchInput) {
-      newErrors.general = 'Please enter search terms in at least one field';
+      if (!hasSearchInput) {
+        newErrors.general = 'Please enter search terms in at least one field';
+      }
+    } else if (formData.searchType === 'vector-search') {
+      // Check if query field has a value for Vector Search
+      if (!formData.q.trim()) {
+        newErrors.q = 'Please enter a search query.';
+      }
     }
 
     // Validate limit
@@ -86,27 +107,35 @@ export default function SearchMovieModal({
       return;
     }
 
-    // Build search parameters, only including non-empty fields
+    // Build search parameters based on search type
     const searchParams: SearchParams = {
-      search_operator: formData.search_operator,
+      searchType: formData.searchType,
       limit: parseInt(formData.limit),
-      skip: 0, // Always start from beginning for new search
     };
 
-    if (formData.plot.trim()) {
-      searchParams.plot = formData.plot.trim();
-    }
-    if (formData.fullplot.trim()) {
-      searchParams.fullplot = formData.fullplot.trim();
-    }
-    if (formData.directors.trim()) {
-      searchParams.directors = formData.directors.trim();
-    }
-    if (formData.writers.trim()) {
-      searchParams.writers = formData.writers.trim();
-    }
-    if (formData.cast.trim()) {
-      searchParams.cast = formData.cast.trim();
+    if (formData.searchType === 'mongodb-search') {
+      // Add MongoDB Search specific parameters
+      searchParams.search_operator = formData.search_operator;
+      searchParams.skip = 0; // Always start from beginning for new search
+
+      if (formData.plot.trim()) {
+        searchParams.plot = formData.plot.trim();
+      }
+      if (formData.fullplot.trim()) {
+        searchParams.fullplot = formData.fullplot.trim();
+      }
+      if (formData.directors.trim()) {
+        searchParams.directors = formData.directors.trim();
+      }
+      if (formData.writers.trim()) {
+        searchParams.writers = formData.writers.trim();
+      }
+      if (formData.cast.trim()) {
+        searchParams.cast = formData.cast.trim();
+      }
+    } else if (formData.searchType === 'vector-search') {
+      // Add Vector Search specific parameters
+      searchParams.q = formData.q.trim();
     }
 
     onSearch(searchParams);
@@ -140,7 +169,10 @@ export default function SearchMovieModal({
     <div className={styles.formContainer}>
       <h2 className={styles.formTitle}>Search Movies</h2>
       <p className={styles.batchDescription}>
-        Search across movie plots, directors, writers, and cast.
+        {formData.searchType === 'mongodb-search' 
+          ? 'Search across movie plots, directors, writers, and cast.'
+          : 'Find movies with similar plots using semantic search.'
+        }
       </p>
       
       {errors.general && (
@@ -150,135 +182,206 @@ export default function SearchMovieModal({
       )}
 
       <form onSubmit={handleSubmit} className={styles.form}>
-        {/* Search Fields */}
-        <div className={styles.formGrid}>
-          {/* Plot Search */}
-          <div className={styles.formGroup}>
-            <label htmlFor="plot" className={styles.label}>
-              Plot Keywords
-            </label>
-            <input
-              type="text"
-              id="plot"
-              value={formData.plot}
-              onChange={(e) => handleInputChange('plot', e.target.value)}
-              className={`${styles.input} ${errors.plot ? styles.inputError : ''}`}
-              disabled={isLoading}
-                            placeholder="Exact phrase search in plot summaries"
-            />
-            {errors.plot && <span className={styles.error}>{errors.plot}</span>}
-          </div>
-
-          {/* Full Plot Search */}
-          <div className={styles.formGroup}>
-            <label htmlFor="fullplot" className={styles.label}>
-              Full Plot Keywords
-            </label>
-            <input
-              type="text"
-              id="fullplot"
-              value={formData.fullplot}
-              onChange={(e) => handleInputChange('fullplot', e.target.value)}
-              className={`${styles.input} ${errors.fullplot ? styles.inputError : ''}`}
-              disabled={isLoading}
-              placeholder="Search in full plot descriptions"
-            />
-            {errors.fullplot && <span className={styles.error}>{errors.fullplot}</span>}
-          </div>
-
-          {/* Directors Search */}
-          <div className={styles.formGroup}>
-            <label htmlFor="directors" className={styles.label}>
-              Directors
-            </label>
-            <input
-              type="text"
-              id="directors"
-              value={formData.directors}
-              onChange={(e) => handleInputChange('directors', e.target.value)}
-              className={`${styles.input} ${errors.directors ? styles.inputError : ''}`}
-              disabled={isLoading}
-              placeholder="Director names"
-            />
-            {errors.directors && <span className={styles.error}>{errors.directors}</span>}
-          </div>
-
-          {/* Writers Search */}
-          <div className={styles.formGroup}>
-            <label htmlFor="writers" className={styles.label}>
-              Writers
-            </label>
-            <input
-              type="text"
-              id="writers"
-              value={formData.writers}
-              onChange={(e) => handleInputChange('writers', e.target.value)}
-              className={`${styles.input} ${errors.writers ? styles.inputError : ''}`}
-              disabled={isLoading}
-              placeholder="Writer names"
-            />
-            {errors.writers && <span className={styles.error}>{errors.writers}</span>}
-          </div>
-
-          {/* Cast Search */}
-          <div className={styles.formGroup}>
-            <label htmlFor="cast" className={styles.label}>
-              Cast
-            </label>
-            <input
-              type="text"
-              id="cast"
-              value={formData.cast}
-              onChange={(e) => handleInputChange('cast', e.target.value)}
-              className={`${styles.input} ${errors.cast ? styles.inputError : ''}`}
-              disabled={isLoading}
-              placeholder="Actor names"
-            />
-            {errors.cast && <span className={styles.error}>{errors.cast}</span>}
-          </div>
-
-          {/* Limit */}
-          <div className={styles.formGroup}>
-            <label htmlFor="limit" className={styles.label}>
-              Max Results
-            </label>
-            <input
-              type="number"
-              id="limit"
-              value={formData.limit}
-              onChange={(e) => handleInputChange('limit', e.target.value)}
-              className={`${styles.input} ${errors.limit ? styles.inputError : ''}`}
-              disabled={isLoading}
-              min="1"
-              max="100"
-            />
-            {errors.limit && <span className={styles.error}>{errors.limit}</span>}
-          </div>
-        </div>
-
-        {/* Search Operator */}
+        {/* Search Type Selector */}
         <div className={styles.formGroup}>
-          <label htmlFor="search_operator" className={styles.label}>
-            Search Logic
+          <label htmlFor="searchType" className={styles.label}>
+            Search Type
           </label>
           <select
-            id="search_operator"
-            value={formData.search_operator}
-            onChange={(e) => handleInputChange('search_operator', e.target.value)}
+            id="searchType"
+            value={formData.searchType}
+            onChange={(e) => handleInputChange('searchType', e.target.value)}
             className={styles.input}
             disabled={isLoading}
           >
-            {searchOperatorOptions.map((option) => (
-              <option key={option.value} value={option.value}>
-                {option.label}
-              </option>
-            ))}
+            <option value="mongodb-search">MongoDB Search</option>
+            <option value="vector-search">MongoDB Vector Search</option>
           </select>
           <small className={styles.searchOperatorDescription}>
-            {searchOperatorOptions.find(opt => opt.value === formData.search_operator)?.description}
+            {formData.searchType === 'mongodb-search' 
+              ? 'Search across multiple fields by using text matching and compound operators'
+              : 'Find movies with similar plots using AI-powered semantic search'
+            }
           </small>
         </div>
 
+        {/* Conditional Form Fields */}
+        {formData.searchType === 'mongodb-search' ? (
+          <>
+            {/* MongoDB Search Fields */}
+            <div className={styles.formGrid}>
+              {/* Plot Search */}
+              <div className={styles.formGroup}>
+                <label htmlFor="plot" className={styles.label}>
+                  Plot Keywords
+                </label>
+                <input
+                  type="text"
+                  id="plot"
+                  value={formData.plot}
+                  onChange={(e) => handleInputChange('plot', e.target.value)}
+                  className={`${styles.input} ${errors.plot ? styles.inputError : ''}`}
+                  disabled={isLoading}
+                  placeholder="Exact phrase search in plot summaries"
+                />
+                {errors.plot && <span className={styles.error}>{errors.plot}</span>}
+              </div>
+
+              {/* Full Plot Search */}
+              <div className={styles.formGroup}>
+                <label htmlFor="fullplot" className={styles.label}>
+                  Full Plot Keywords
+                </label>
+                <input
+                  type="text"
+                  id="fullplot"
+                  value={formData.fullplot}
+                  onChange={(e) => handleInputChange('fullplot', e.target.value)}
+                  className={`${styles.input} ${errors.fullplot ? styles.inputError : ''}`}
+                  disabled={isLoading}
+                  placeholder="Search in full plot descriptions"
+                />
+                {errors.fullplot && <span className={styles.error}>{errors.fullplot}</span>}
+              </div>
+
+              {/* Directors Search */}
+              <div className={styles.formGroup}>
+                <label htmlFor="directors" className={styles.label}>
+                  Directors
+                </label>
+                <input
+                  type="text"
+                  id="directors"
+                  value={formData.directors}
+                  onChange={(e) => handleInputChange('directors', e.target.value)}
+                  className={`${styles.input} ${errors.directors ? styles.inputError : ''}`}
+                  disabled={isLoading}
+                  placeholder="Director names"
+                />
+                {errors.directors && <span className={styles.error}>{errors.directors}</span>}
+              </div>
+
+              {/* Writers Search */}
+              <div className={styles.formGroup}>
+                <label htmlFor="writers" className={styles.label}>
+                  Writers
+                </label>
+                <input
+                  type="text"
+                  id="writers"
+                  value={formData.writers}
+                  onChange={(e) => handleInputChange('writers', e.target.value)}
+                  className={`${styles.input} ${errors.writers ? styles.inputError : ''}`}
+                  disabled={isLoading}
+                  placeholder="Writer names"
+                />
+                {errors.writers && <span className={styles.error}>{errors.writers}</span>}
+              </div>
+
+              {/* Cast Search */}
+              <div className={styles.formGroup}>
+                <label htmlFor="cast" className={styles.label}>
+                  Cast
+                </label>
+                <input
+                  type="text"
+                  id="cast"
+                  value={formData.cast}
+                  onChange={(e) => handleInputChange('cast', e.target.value)}
+                  className={`${styles.input} ${errors.cast ? styles.inputError : ''}`}
+                  disabled={isLoading}
+                  placeholder="Actor names"
+                />
+                {errors.cast && <span className={styles.error}>{errors.cast}</span>}
+              </div>
+
+              {/* Limit */}
+              <div className={styles.formGroup}>
+                <label htmlFor="limit" className={styles.label}>
+                  Max Results
+                </label>
+                <input
+                  type="number"
+                  id="limit"
+                  value={formData.limit}
+                  onChange={(e) => handleInputChange('limit', e.target.value)}
+                  className={`${styles.input} ${errors.limit ? styles.inputError : ''}`}
+                  disabled={isLoading}
+                  min="1"
+                  max="100"
+                />
+                {errors.limit && <span className={styles.error}>{errors.limit}</span>}
+              </div>
+            </div>
+
+            {/* Search Operator */}
+            <div className={styles.formGroup}>
+              <label htmlFor="search_operator" className={styles.label}>
+                Search Logic
+              </label>
+              <select
+                id="search_operator"
+                value={formData.search_operator}
+                onChange={(e) => handleInputChange('search_operator', e.target.value)}
+                className={styles.input}
+                disabled={isLoading}
+              >
+                {searchOperatorOptions.map((option) => (
+                  <option key={option.value} value={option.value}>
+                    {option.label}
+                  </option>
+                ))}
+              </select>
+              <small className={styles.searchOperatorDescription}>
+                {searchOperatorOptions.find(opt => opt.value === formData.search_operator)?.description}
+              </small>
+            </div>
+          </>
+        ) : (
+          <>
+            {/* Vector Search Fields */}
+            <div className={styles.formGroup}>
+              <label htmlFor="q" className={styles.label}>
+                Search Query
+              </label>
+              <textarea
+                id="q"
+                value={formData.q}
+                onChange={(e) => handleInputChange('q', e.target.value)}
+                className={`${styles.input} ${errors.q ? styles.inputError : ''}`}
+                disabled={isLoading}
+                placeholder="Describe the plot or theme you're looking for. e.g., 'A story about friendship and adventure in space'"
+                rows={3}
+              />
+              {errors.q && <span className={styles.error}>{errors.q}</span>}
+              <small className={styles.searchOperatorDescription}>
+                Describe the plot, theme, or mood you're looking for. MongoDB will find movies with similar content.
+              </small>
+            </div>
+
+            {/* Limit for Vector Search */}
+            <div className={styles.formGroup}>
+              <label htmlFor="limit_vector" className={styles.label}>
+                Max Results
+              </label>
+              <input
+                type="number"
+                id="limit_vector"
+                value={formData.limit}
+                onChange={(e) => handleInputChange('limit', e.target.value)}
+                className={`${styles.input} ${errors.limit ? styles.inputError : ''}`}
+                disabled={isLoading}
+                min="1"
+                max="50"
+              />
+              {errors.limit && <span className={styles.error}>{errors.limit}</span>}
+              <small className={styles.searchOperatorDescription}>
+                Vector search supports up to 50 results
+              </small>
+            </div>
+          </>
+        )}
+
         {/* Form Actions */}
         <div className={styles.formActions}>
           <button
@@ -302,7 +405,7 @@ export default function SearchMovieModal({
             className={`${styles.button} ${styles.saveButton}`}
             disabled={isLoading}
           >
-            {isLoading ? 'Searching...' : 'Search Movies'}
+            {isLoading ? 'Searching...' : `Search Movies`}
           </button>
         </div>
       </form>
diff --git a/client/app/components/SearchMovieModal/index.ts b/client/app/components/SearchMovieModal/index.ts
index 06150bc..ad9340f 100644
--- a/client/app/components/SearchMovieModal/index.ts
+++ b/client/app/components/SearchMovieModal/index.ts
@@ -1,2 +1,2 @@
 export { default } from './SearchMovieModal';
-export type { SearchParams } from './SearchMovieModal';
\ No newline at end of file
+export type { SearchParams, SearchType } from './SearchMovieModal';
\ No newline at end of file
diff --git a/client/app/lib/api.ts b/client/app/lib/api.ts
index 1d3929c..e8417e2 100644
--- a/client/app/lib/api.ts
+++ b/client/app/lib/api.ts
@@ -183,7 +183,7 @@ export async function deleteMovie(id: string): Promise<{ success: boolean; error
  */
 export async function createMovie(movieData: Omit<Movie, '_id'>): Promise<{ success: boolean; error?: string; movieId?: string }> {
   try {
-    const response = await fetch(`${API_BASE_URL}/api/movies/`, {
+    const response = await fetch(`${API_BASE_URL}/api/movies`, {
       method: 'POST',
       headers: {
         'Content-Type': 'application/json',
@@ -276,7 +276,7 @@ export async function deleteMoviesBatch(movieIds: string[]): Promise<{ success:
       }
     };
 
-    const response = await fetch(`${API_BASE_URL}/api/movies/`, {
+    const response = await fetch(`${API_BASE_URL}/api/movies`, {
       method: 'DELETE',
       headers: {
         'Content-Type': 'application/json',
@@ -326,7 +326,7 @@ export async function updateMoviesBatch(movieIds: string[], updateData: Partial<
       }
     };
 
-    const response = await fetch(`${API_BASE_URL}/api/movies/`, {
+    const response = await fetch(`${API_BASE_URL}/api/movies`, {
       method: 'PATCH',
       headers: {
         'Content-Type': 'application/json',
@@ -364,80 +364,6 @@ export async function updateMoviesBatch(movieIds: string[], updateData: Partial<
   }
 }
 
-/**
- * Search movies using MongoDB Search across multiple fields with pagination support
- */
-export async function searchMovies(searchParams: {
-  plot?: string;
-  fullplot?: string;
-  directors?: string;
-  writers?: string;
-  cast?: string;
-  limit?: number;
-  skip?: number;
-  search_operator?: 'must' | 'should' | 'mustNot' | 'filter';
-}): Promise<{ success: boolean; error?: string; movies?: Movie[]; hasNextPage?: boolean; hasPrevPage?: boolean; totalCount?: number }> {
-  try {
-    // Build query parameters
-    const limit = searchParams.limit || 20;
-    const skip = searchParams.skip || 0;
-    
-    const queryParams = new URLSearchParams();
-    
-    if (searchParams.plot) queryParams.append('plot', searchParams.plot);
-    if (searchParams.fullplot) queryParams.append('fullplot', searchParams.fullplot);
-    if (searchParams.directors) queryParams.append('directors', searchParams.directors);
-    if (searchParams.writers) queryParams.append('writers', searchParams.writers);
-    if (searchParams.cast) queryParams.append('cast', searchParams.cast);
-    queryParams.append('limit', limit.toString());
-    queryParams.append('skip', skip.toString());
-    if (searchParams.search_operator) queryParams.append('search_operator', searchParams.search_operator);
-
-    const response = await fetch(`${API_BASE_URL}/api/movies/search?${queryParams}`, {
-      method: 'GET',
-      headers: {
-        'Content-Type': 'application/json',
-      },
-    });
-
-    const result = await response.json();
-
-    if (!response.ok) {
-      return {
-        success: false,
-        error: result.message || result.error?.message || `Failed to search movies: ${response.status}`
-      };
-    }
-
-    if (!result.success) {
-      return {
-        success: false,
-        error: result.message || result.error?.message || 'API returned error response'
-      };
-    }
-
-    const responseData = result.data || {};
-    const movies = responseData.movies || [];
-    const totalCount = responseData.totalCount || 0;
-    const hasNextPage = skip + limit < totalCount;
-    const hasPrevPage = skip > 0;
-
-    return {
-      success: true,
-      movies,
-      hasNextPage,
-      hasPrevPage,
-      totalCount
-    };
-  } catch (error) {
-    console.error('Error searching movies:', error);
-    return { 
-      success: false, 
-      error: 'Network error occurred while searching movies' 
-    };
-  }
-}
-
 /**
  * Aggregation API Functions for Aggregations
  */
@@ -655,3 +581,156 @@ export async function fetchDirectorStats(limit: number = 20): Promise<{ success:
     };
   }
 }
+
+/**
+ * Search movies using MongoDB Search across multiple fields with pagination support
+ */
+export async function searchMovies(searchParams: {
+  plot?: string;
+  fullplot?: string;
+  directors?: string;
+  writers?: string;
+  cast?: string;
+  limit?: number;
+  skip?: number;
+  search_operator?: 'must' | 'should' | 'mustNot' | 'filter';
+}): Promise<{ success: boolean; error?: string; movies?: Movie[]; hasNextPage?: boolean; hasPrevPage?: boolean; totalCount?: number }> {
+  try {
+    // Build query parameters
+    const limit = searchParams.limit || 20;
+    const skip = searchParams.skip || 0;
+    
+    const queryParams = new URLSearchParams();
+    
+    if (searchParams.plot) queryParams.append('plot', searchParams.plot);
+    if (searchParams.fullplot) queryParams.append('fullplot', searchParams.fullplot);
+    if (searchParams.directors) queryParams.append('directors', searchParams.directors);
+    if (searchParams.writers) queryParams.append('writers', searchParams.writers);
+    if (searchParams.cast) queryParams.append('cast', searchParams.cast);
+    queryParams.append('limit', limit.toString());
+    queryParams.append('skip', skip.toString());
+    if (searchParams.search_operator) queryParams.append('search_operator', searchParams.search_operator);
+
+    const response = await fetch(`${API_BASE_URL}/api/movies/search?${queryParams}`, {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+    });
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      return {
+        success: false,
+        error: result.message || result.error?.message || `Failed to search movies: ${response.status}`
+      };
+    }
+
+    if (!result.success) {
+      return {
+        success: false,
+        error: result.message || result.error?.message || 'API returned error response'
+      };
+    }
+
+    const responseData = result.data || {};
+    const movies = responseData.movies || [];
+    const totalCount = responseData.totalCount || 0;
+    const hasNextPage = skip + limit < totalCount;
+    const hasPrevPage = skip > 0;
+
+    return {
+      success: true,
+      movies,
+      hasNextPage,
+      hasPrevPage,
+      totalCount
+    };
+  } catch (error) {
+    console.error('Error searching movies:', error);
+    return { 
+      success: false, 
+      error: 'Network error occurred while searching movies' 
+    };
+  }
+}
+
+/**
+ * Search movies using MongoDB Vector Search to find movies with similar plots
+ */
+export async function vectorSearchMovies(searchParams: {
+  q: string;
+  limit?: number;
+}): Promise<{ success: boolean; error?: string; movies?: Movie[]; results?: any[] }> {
+  try {
+    const limit = searchParams.limit || 10;
+    
+    const queryParams = new URLSearchParams();
+    queryParams.append('q', searchParams.q);
+    queryParams.append('limit', limit.toString());
+
+    const response = await fetch(`${API_BASE_URL}/api/movies/vector-search?${queryParams}`, {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+    });
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      return { 
+        success: false, 
+        error: result.error || `Failed to perform vector search: ${response.status}` 
+      };
+    }
+
+    if (!result.success) {
+      return { 
+        success: false, 
+        error: result.error || 'API returned error response' 
+      };
+    }
+
+    // Transform VectorSearchResult objects to Movie objects for backend compatibility
+    const movies: Movie[] = (result.data || []).map((item: any) => {
+      // Convert VectorSearchResult to Movie format
+      return {
+        _id: item._id || item.id, // Handle both _id (Python) and id (Java) field names
+        title: item.title || '',
+        plot: item.plot || '',
+        poster: item.poster,
+        year: item.year,
+        genres: item.genres || [],
+        directors: item.directors || [],
+        cast: item.cast || [],
+        // Add default values for fields not included in VectorSearchResult
+        fullplot: undefined,
+        released: undefined,
+        runtime: undefined,
+        writers: [],
+        countries: [],
+        languages: [],
+        rated: undefined,
+        awards: undefined,
+        imdb: undefined,
+        tomatoes: undefined,
+        metacritic: undefined,
+        type: undefined
+      } as Movie;
+    });
+
+    return { 
+      success: true, 
+      movies,
+      results: result.data || []
+    };
+  } catch (error) {
+    console.error('Error performing vector search:', error);
+    return { 
+      success: false, 
+      error: 'Network error occurred while performing vector search' 
+    };
+  }
+}
\ No newline at end of file
diff --git a/client/app/movies/movies.module.css b/client/app/movies/movies.module.css
index 477547f..f44e5b9 100644
--- a/client/app/movies/movies.module.css
+++ b/client/app/movies/movies.module.css
@@ -148,6 +148,17 @@
   text-align: center;
 }
 
+.searchInfo {
+  margin: 2rem 0;
+  padding: 1rem;
+  background: #f8f9fa;
+  border: 1px solid #e9ecef;
+  border-radius: 8px;
+  text-align: center;
+  font-size: 0.9rem;
+  color: #666;
+}
+
 .selectAllButton {
   padding: 0.5rem 1rem;
   background: #6c757d;
diff --git a/client/app/movies/page.tsx b/client/app/movies/page.tsx
index bfae6e1..504fa1a 100644
--- a/client/app/movies/page.tsx
+++ b/client/app/movies/page.tsx
@@ -6,11 +6,22 @@ import pageStyles from "./page.module.css";
 import movieStyles from "./movies.module.css";
 import { MovieCard, Pagination, PageSizeSelector, AddMovieForm, BatchEditMovieForm, SearchMovieModal } from "../components";
 import { ErrorDisplay, LoadingSpinner } from "../components/ui";
-import { fetchMovies, createMovie, createMoviesBatch, deleteMoviesBatch, updateMoviesBatch, searchMovies } from "../lib/api";
+import { fetchMovies, createMovie, createMoviesBatch, deleteMoviesBatch, updateMoviesBatch, searchMovies, vectorSearchMovies } from "../lib/api";
 import { Movie } from "../types/movie";
 import { APP_CONFIG, ROUTES } from "../lib/constants";
 import type { SearchParams } from "../components/SearchMovieModal";
 
+/**
+ * Movies Page Component
+ * 
+ * Main page for browsing movies with the following features:
+ * - Regular movie browsing with URL-based pagination
+ * - MongoDB text search with server-side pagination
+ * - Vector search with client-side pagination
+ * - CRUD operations (create, update, delete movies)
+ * - Batch operations on selected movies
+ * 
+ */
 export default function Movies() {
   const searchParams = useSearchParams();
   const router = useRouter();
@@ -31,6 +42,9 @@ export default function Movies() {
   const [error, setError] = useState<string | null>(null);
   const [successMessage, setSuccessMessage] = useState<string | null>(null);
   const [searchResults, setSearchResults] = useState<Movie[]>([]);
+  const [allVectorSearchResults, setAllVectorSearchResults] = useState<Movie[]>([]);
+  const [vectorSearchPage, setVectorSearchPage] = useState(1);
+  const [vectorSearchPageSize, setVectorSearchPageSize] = useState(20);
   const [searchHasNextPage, setSearchHasNextPage] = useState(false);
   const [searchHasPrevPage, setSearchHasPrevPage] = useState(false);
   const [searchTotalCount, setSearchTotalCount] = useState(0);
@@ -221,46 +235,100 @@ export default function Movies() {
     setError(null);
     setSuccessMessage(null);
 
-    // For new searches, start from page 1
-    const searchSkip = 0;
-    const searchLimitToUse = searchParams.limit || 20;
-    
-    const searchParamsWithPagination = {
-      ...searchParams,
-      limit: searchLimitToUse,
-      skip: searchSkip,
-    };
+    try {
+      let result;
+
+      if (searchParams.searchType === 'vector-search') {
+        // Vector Search: Fetch all results and implement client-side pagination
+        const vectorSearchParams = {
+          q: searchParams.q!,
+          limit: searchParams.limit || 50, // Get more results for better pagination experience
+        };
+        result = await vectorSearchMovies(vectorSearchParams);
+        
+        if (result.success) {
+          const allResults = result.movies || [];
+          const pageSize = searchParams.limit || 20;
+          setAllVectorSearchResults(allResults);
+          setVectorSearchPage(1);
+          setVectorSearchPageSize(pageSize);
+          
+          // Calculate first page of results for immediate display
+          const firstPageResults = allResults.slice(0, pageSize);
+          setSearchResults(firstPageResults);
+          
+          // Set pagination state based on total results
+          const totalPages = Math.ceil(allResults.length / pageSize);
+          setSearchHasNextPage(totalPages > 1);
+          setSearchHasPrevPage(false);
+          setSearchTotalCount(allResults.length);
+        }
+      } else {
+        // MongoDB Search
+        const searchSkip = 0; // Always start from page 1 for new searches
+        const searchLimitToUse = searchParams.limit || 20;
+        
+        const searchParamsWithPagination = {
+          ...searchParams,
+          limit: searchLimitToUse,
+          skip: searchSkip,
+        };
 
-    const result = await searchMovies(searchParamsWithPagination);
+        result = await searchMovies(searchParamsWithPagination);
+        
+        if (result.success) {
+          setSearchResults(result.movies || []);
+          setSearchHasNextPage(result.hasNextPage || false);
+          setSearchHasPrevPage(result.hasPrevPage || false);
+          setSearchTotalCount(result.totalCount || 0);
+        }
+      }
 
-    if (result.success) {
-      setSearchResults(result.movies || []);
-      setSearchHasNextPage(result.hasNextPage || false);
-      setSearchHasPrevPage(result.hasPrevPage || false);
-      setSearchTotalCount(result.totalCount || 0);
-      setIsSearchMode(true);
-      setSearchPage(1);
-      setSearchLimit(searchLimitToUse);
-      setCurrentSearchParams(searchParams);
-      setShowSearchModal(false);
-      setSelectedMovies(new Set()); // Clear selection when switching to search mode
-      
-      const totalCount = result.totalCount || 0;
-      if (totalCount === 0) {
-        setSuccessMessage('Search completed, but no movies matched your criteria. Try different search terms.');
+      if (result.success) {
+        setIsSearchMode(true);
+        setSearchPage(1);
+        setSearchLimit(searchParams.limit || 20);
+        setCurrentSearchParams(searchParams);
+        setShowSearchModal(false);
+        setSelectedMovies(new Set()); // Clear selection when switching to search mode
+        
+        if (searchParams.searchType === 'vector-search') {
+          const returnedCount = result.movies?.length || 0;
+          
+          if (returnedCount === 0) {
+            setSuccessMessage('Vector search completed, but no movies matched your query. Try different search terms.');
+          } else {
+            setSuccessMessage(`Found ${returnedCount} results using vector search.`);
+          }
+        } else {
+          // MongoDB text search success message
+          const totalCount = (result as any).totalCount || 0;
+          
+          if (totalCount === 0) {
+            setSuccessMessage('Search completed, but no movies matched your criteria. Try different search terms.');
+          } else {
+            setSuccessMessage(`Found ${totalCount} results using MongoDB search.`);
+          }
+        }
       } else {
-        setSuccessMessage(`Found ${totalCount} total movies matching your search criteria.`);
+        setError(result.error || 'Failed to search movies');
       }
-    } else {
-      setError(result.error || 'Failed to search movies');
+    } catch (err) {
+      setError('An unexpected error occurred while searching');
     }
 
     setIsSearching(false);
   };
 
+  /**
+   * Clears search mode and returns to regular movie browsing
+   * Resets all search-related state including vector search pagination
+   */
   const handleClearSearch = () => {
     setIsSearchMode(false);
     setSearchResults([]);
+    setAllVectorSearchResults([]);
+    setVectorSearchPage(1);
     setSearchHasNextPage(false);
     setSearchHasPrevPage(false);
     setSearchTotalCount(0);
@@ -275,9 +343,68 @@ export default function Movies() {
   // Get the movies to display based on current mode
   const displayMovies = isSearchMode ? searchResults : movies;
 
+  /**
+   * Helper function for vector search client-side pagination
+   * Calculates pagination data for the current vector search results
+   */
+  const getVectorSearchPageData = () => {
+    if (!isSearchMode || currentSearchParams?.searchType !== 'vector-search') {
+      return { paginatedResults: [], hasNext: false, hasPrev: false, totalPages: 0 };
+    }
+
+    const startIndex = (vectorSearchPage - 1) * vectorSearchPageSize;
+    const endIndex = startIndex + vectorSearchPageSize;
+    const paginatedResults = allVectorSearchResults.slice(startIndex, endIndex);
+    const totalPages = Math.ceil(allVectorSearchResults.length / vectorSearchPageSize);
+    
+    return {
+      paginatedResults,
+      hasNext: vectorSearchPage < totalPages,
+      hasPrev: vectorSearchPage > 1,
+      totalPages
+    };
+  };
+
+  /**
+   * Handles page navigation for vector search results (client-side pagination)
+   * Slices the cached results and updates the display
+   */
+  const handleVectorSearchPageChange = (newPage: number) => {
+    if (!isSearchMode || currentSearchParams?.searchType !== 'vector-search') return;
+    
+    const totalPages = Math.ceil(allVectorSearchResults.length / vectorSearchPageSize);
+    if (newPage < 1 || newPage > totalPages) return;
+    
+    setVectorSearchPage(newPage);
+    
+    // Update the displayed results based on the new page
+    const startIndex = (newPage - 1) * vectorSearchPageSize;
+    const endIndex = startIndex + vectorSearchPageSize;
+    const paginatedResults = allVectorSearchResults.slice(startIndex, endIndex);
+    
+    setSearchResults(paginatedResults);
+    setSearchHasNextPage(newPage < totalPages);
+    setSearchHasPrevPage(newPage > 1);
+    
+    // Clear selection and scroll to top for better UX
+    setSelectedMovies(new Set());
+    window.scrollTo({ top: 0, behavior: 'smooth' });
+  };
+
   const handleSearchPageChange = async (newPage: number) => {
     if (!currentSearchParams) return;
     
+    // This function handles MongoDB search pagination (server-side)
+    // Vector search uses handleVectorSearchPageChange for client-side pagination
+    if (currentSearchParams.searchType === 'vector-search') {
+      return;
+    }
+    
+    // Validate page number and prevent invalid navigation
+    if (newPage < 1) return;
+    if (isSearching) return;
+    if (newPage > searchPage && !searchHasNextPage) return;
+    
     setIsSearching(true);
     setError(null);
     
@@ -297,10 +424,17 @@ export default function Movies() {
         setSearchHasPrevPage(result.hasPrevPage || false);
         setSearchTotalCount(result.totalCount || 0);
         setSearchPage(newPage);
+        
+        // Clear any previously selected movies when changing pages
+        setSelectedMovies(new Set());
+        
+        // Scroll to top to show new results
+        window.scrollTo({ top: 0, behavior: 'smooth' });
       } else {
         setError(result.error || 'Failed to load search results');
       }
     } catch (error) {
+      console.error('Search pagination error:', error);
       setError('Failed to load search results');
     }
     
@@ -469,51 +603,107 @@ export default function Movies() {
                 
                 {/* Show pagination based on current mode */}
                 {isSearchMode ? (
-                  <nav className={movieStyles.pagination} aria-label="Search results pagination">
-                    <div className={movieStyles.paginationContainer}>
-                      {/* Previous Button */}
-                      {searchHasPrevPage ? (
-                        <button
-                          onClick={() => handleSearchPageChange(searchPage - 1)}
-                          className={movieStyles.pageButton}
-                          disabled={isSearching}
-                          aria-label="Go to previous page"
-                        >
-                          ← Previous
-                        </button>
-                      ) : (
-                        <span className={`${movieStyles.pageButton} ${movieStyles.disabled}`}>
-                          ← Previous
-                        </span>
-                      )}
-
-                      {/* Current Page Info */}
-                      <div className={movieStyles.pageInfo}>
-                        Page {searchPage}
+                  currentSearchParams?.searchType === 'mongodb-search' ? (
+                    <nav className={movieStyles.pagination} aria-label="Search results pagination">
+                      <div className={movieStyles.paginationContainer}>
+                        {/* Previous Button */}
+                        {searchHasPrevPage && !isSearching ? (
+                          <button
+                            onClick={() => handleSearchPageChange(searchPage - 1)}
+                            className={movieStyles.pageButton}
+                            disabled={isSearching}
+                            aria-label="Go to previous page"
+                          >
+                            ← Previous
+                          </button>
+                        ) : (
+                          <span className={`${movieStyles.pageButton} ${movieStyles.disabled}`}>
+                            ← Previous
+                          </span>
+                        )}
+
+                        {/* Current Page Info */}
+                        <div className={movieStyles.pageInfo}>
+                          Page {searchPage} {searchTotalCount > 0 ? `of ${Math.ceil(searchTotalCount / searchLimit)}` : ''}
+                        </div>
+
+                        {/* Next Button */}
+                        {searchHasNextPage && !isSearching ? (
+                          <button
+                            onClick={() => handleSearchPageChange(searchPage + 1)}
+                            className={movieStyles.pageButton}
+                            disabled={isSearching}
+                            aria-label="Go to next page"
+                          >
+                            Next →
+                          </button>
+                        ) : (
+                          <span className={`${movieStyles.pageButton} ${movieStyles.disabled}`}>
+                            Next →
+                          </span>
+                        )}
                       </div>
 
-                      {/* Next Button */}
-                      {searchHasNextPage ? (
-                        <button
-                          onClick={() => handleSearchPageChange(searchPage + 1)}
-                          className={movieStyles.pageButton}
-                          disabled={isSearching}
-                          aria-label="Go to next page"
-                        >
-                          Next →
-                        </button>
+                      {/* Additional Info */}
+                      <div className={movieStyles.additionalInfo}>
+                        {searchLimit} movies per page • {searchTotalCount} total results
+                      </div>
+                    </nav>
+                  ) : (
+                    /* Vector search results with client-side pagination */
+                    (() => {
+                      const { hasNext, hasPrev, totalPages } = getVectorSearchPageData();
+                      return totalPages > 1 ? (
+                        <nav className={movieStyles.pagination} aria-label="Vector search results pagination">
+                          <div className={movieStyles.paginationContainer}>
+                            {/* Previous Button */}
+                            {hasPrev ? (
+                              <button
+                                onClick={() => handleVectorSearchPageChange(vectorSearchPage - 1)}
+                                className={movieStyles.pageButton}
+                                aria-label="Go to previous page"
+                              >
+                                ← Previous
+                              </button>
+                            ) : (
+                              <span className={`${movieStyles.pageButton} ${movieStyles.disabled}`}>
+                                ← Previous
+                              </span>
+                            )}
+
+                            {/* Current Page Info */}
+                            <div className={movieStyles.pageInfo}>
+                              Page {vectorSearchPage} of {totalPages}
+                            </div>
+
+                            {/* Next Button */}
+                            {hasNext ? (
+                              <button
+                                onClick={() => handleVectorSearchPageChange(vectorSearchPage + 1)}
+                                className={movieStyles.pageButton}
+                                aria-label="Go to next page"
+                              >
+                                Next →
+                              </button>
+                            ) : (
+                              <span className={`${movieStyles.pageButton} ${movieStyles.disabled}`}>
+                                Next →
+                              </span>
+                            )}
+                          </div>
+
+                          {/* Additional Info */}
+                          <div className={movieStyles.additionalInfo}>
+                            {vectorSearchPageSize} movies per page • {allVectorSearchResults.length} total results
+                          </div>
+                        </nav>
                       ) : (
-                        <span className={`${movieStyles.pageButton} ${movieStyles.disabled}`}>
-                          Next →
-                        </span>
-                      )}
-                    </div>
-
-                    {/* Additional Info */}
-                    <div className={movieStyles.additionalInfo}>
-                      {searchLimit} movies per page
-                    </div>
-                  </nav>
+                        <div className={movieStyles.searchInfo}>
+                          Showing {allVectorSearchResults.length} results (vector search)
+                        </div>
+                      );
+                    })()
+                  )
                 ) : (
                   <Pagination
                     currentPage={page}
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/VectorSearchResult.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/VectorSearchResult.java
index edcdf45..00dc38e 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/VectorSearchResult.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/VectorSearchResult.java
@@ -32,6 +32,31 @@ public class VectorSearchResult {
      */
     private String plot;
     
+    /**
+     * Movie poster URL.
+     */
+    private String poster;
+    
+    /**
+     * Movie release year.
+     */
+    private Integer year;
+    
+    /**
+     * Movie genres.
+     */
+    private java.util.List<String> genres;
+    
+    /**
+     * Movie directors.
+     */
+    private java.util.List<String> directors;
+    
+    /**
+     * Movie cast members.
+     */
+    private java.util.List<String> cast;
+    
     /**
      * Vector search similarity score (0.0 to 1.0, higher = more similar).
      */
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 6248fa9..3b6ee5a 100644
--- a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -17,6 +17,7 @@
 import java.net.http.HttpResponse;
 import java.util.ArrayList;
 import java.util.Collection;
+import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import java.util.regex.Pattern;
@@ -807,6 +808,18 @@ public List<Movie> findSimilarMovies(String movieId, Integer limit) {
         }
     }
 
+    /**
+     * Performs vector search on movie plots using MongoDB Vector Search.
+     * 
+     * This method uses a two-step process:
+     * 1. Query the embedded_movies collection (which has vector embeddings) to get movie IDs and similarity scores
+     * 2. Fetch complete movie data from the movies collection using those IDs
+     * 
+     * This approach ensures that:
+     * - Vector search works correctly with the embedded data
+     * - Returned movie objects are compatible with CRUD operations on the movies collection
+     * - Complete movie metadata is available in the response
+     */
     @Override
     public List<VectorSearchResult> vectorSearchMovies(String query, Integer limit) {
         // Validate query parameter
@@ -838,34 +851,103 @@ public List<VectorSearchResult> vectorSearchMovies(String query, Integer limit)
                     .append("limit", resultLimit)
             );
 
-            // Project the fields we need in the response
+            // Project only the fields we need from embedded_movies: _id and score
             Document projectStage = new Document("$project", new Document()
                     .append("_id", 1)
-                    .append("title", 1)
-                    .append("plot", 1)
                     .append("score", new Document("$meta", "vectorSearchScore"))
             );
 
             // Execute the aggregation pipeline on the embedded_movies collection
             List<Document> aggregationPipeline = List.of(vectorSearchStage, projectStage);
 
-            List<VectorSearchResult> results = new ArrayList<>();
+            // Step 1: Get movie IDs and scores from embedded_movies (which has the vector embeddings)
+            List<ObjectId> movieIds = new ArrayList<>();
+            Map<String, Double> scoreMap = new HashMap<>();
+
             mongoTemplate.getCollection("embedded_movies")
                     .aggregate(aggregationPipeline)
                     .forEach(doc -> {
-                        VectorSearchResult result = VectorSearchResult.builder()
-                                .id(doc.getObjectId("_id").toString())
-                                .title(doc.getString("title"))
-                                .plot(doc.getString("plot"))
-                                .score(doc.getDouble("score"))
-                                .build();
-                        results.add(result);
+                        ObjectId movieId = doc.getObjectId("_id");
+                        movieIds.add(movieId);
+                        scoreMap.put(movieId.toString(), doc.getDouble("score"));
                     });
 
+            // Step 2: Fetch complete movie data from the movies collection (for CRUD compatibility)
+            // Use aggregation to safely handle dirty data in the year field
+            List<VectorSearchResult> results = new ArrayList<>();
+
+            if (!movieIds.isEmpty()) {
+                // Build aggregation pipeline to safely convert year field
+                Document matchStage = new Document("$match", new Document("_id", new Document("$in", movieIds)));
+
+                // Project stage to safely convert year to integer, handling dirty data
+                Document projectStage2 = new Document("$project", new Document()
+                        .append("_id", 1)
+                        .append("title", 1)
+                        .append("plot", 1)
+                        .append("poster", 1)
+                        .append("genres", 1)
+                        .append("directors", 1)
+                        .append("cast", 1)
+                        // Safely convert year to integer, handling strings and dirty data
+                        .append("year", new Document("$cond", new Document()
+                                .append("if", new Document("$and", java.util.Arrays.asList(
+                                        new Document("$ne", java.util.Arrays.asList("$year", null)),
+                                        new Document("$eq", java.util.Arrays.asList(new Document("$type", "$year"), "int"))
+                                )))
+                                .append("then", "$year")
+                                .append("else", null)
+                        ))
+                );
+
+                List<Document> moviePipeline = List.of(matchStage, projectStage2);
+
+                // Execute aggregation and manually build VectorSearchResult objects
+                mongoTemplate.getCollection("movies").aggregate(moviePipeline)
+                        .forEach(doc -> {
+                            ObjectId movieIdObj = doc.getObjectId("_id");
+                            if (movieIdObj == null) {
+                                return;
+                            }
+
+                            String movieIdStr = movieIdObj.toString();
+                            Double score = scoreMap.get(movieIdStr);
+
+                            if (score != null) {  // Only include movies that have vector scores
+                                // Safely get list fields, defaulting to null if not present
+                                List<String> genres = doc.getList("genres", String.class);
+                                List<String> directors = doc.getList("directors", String.class);
+                                List<String> cast = doc.getList("cast", String.class);
+
+                                VectorSearchResult result = VectorSearchResult.builder()
+                                        .id(movieIdStr)
+                                        .title(doc.getString("title"))
+                                        .plot(doc.getString("plot"))
+                                        .poster(doc.getString("poster"))
+                                        .year(doc.getInteger("year"))  // Will be null for dirty data
+                                        .genres(genres)
+                                        .directors(directors)
+                                        .cast(cast)
+                                        .score(score)
+                                        .build();
+                                results.add(result);
+                            }
+                        });
+            }
+
             return results;
 
+        } catch (IOException e) {
+            // Handle Voyage AI API errors
+            String errorMsg = e.getMessage() != null ? e.getMessage() : "Network error calling Voyage AI API";
+            throw new DatabaseOperationException("Error performing vector search: " + errorMsg);
+        } catch (InterruptedException e) {
+            Thread.currentThread().interrupt();
+            throw new DatabaseOperationException("Vector search was interrupted");
         } catch (Exception e) {
-            throw new DatabaseOperationException("Error performing vector search: " + e.getMessage());
+            // Handle other errors (e.g., MongoDB errors, parsing errors)
+            String errorMsg = e.getMessage() != null ? e.getMessage() : e.getClass().getSimpleName();
+            throw new DatabaseOperationException("Error performing vector search: " + errorMsg);
         }
     }
 
@@ -911,7 +993,26 @@ private List<Double> generateVoyageEmbedding(String text, String apiKey) throws
         // Parse the JSON response to extract the embedding
         ObjectMapper mapper = new ObjectMapper();
         JsonNode root = mapper.readTree(response.body());
-        JsonNode embeddingNode = root.path("data").get(0).path("embedding");
+
+        // Validate response structure
+        if (!root.has("data")) {
+            throw new IOException("Invalid Voyage AI API response: missing 'data' field. Response: " + response.body());
+        }
+
+        JsonNode dataNode = root.get("data");
+        if (dataNode == null || !dataNode.isArray() || dataNode.size() == 0) {
+            throw new IOException("Invalid Voyage AI API response: 'data' field is empty or not an array. Response: " + response.body());
+        }
+
+        JsonNode firstElement = dataNode.get(0);
+        if (firstElement == null || !firstElement.has("embedding")) {
+            throw new IOException("Invalid Voyage AI API response: missing 'embedding' field. Response: " + response.body());
+        }
+
+        JsonNode embeddingNode = firstElement.get("embedding");
+        if (embeddingNode == null || !embeddingNode.isArray()) {
+            throw new IOException("Invalid Voyage AI API response: 'embedding' is not an array. Response: " + response.body());
+        }
 
         // Convert the embedding to a List<Double>
         List<Double> embedding = new ArrayList<>();
diff --git a/server/python/src/models/models.py b/server/python/src/models/models.py
index f6d5dda..8c2528a 100644
--- a/server/python/src/models/models.py
+++ b/server/python/src/models/models.py
@@ -120,6 +120,11 @@ class VectorSearchResult(BaseModel):
     id: Optional[str] = Field(alias="_id")
     title: str
     plot: Optional[str] = None
+    poster: Optional[str] = None
+    year: Optional[int] = None
+    genres: Optional[list[str]] = None
+    directors: Optional[list[str]] = None
+    cast: Optional[list[str]] = None
     score: float
 
     model_config = {
diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index df4c213..a1b3d3f 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -1,5 +1,5 @@
 from fastapi import APIRouter, Query, Path, Body
-from src.database.mongo_client import db, get_collection
+from src.database.mongo_client import db, get_collection, voyage_ai_available
 from src.models.models import VectorSearchResult, CreateMovieRequest, Movie, MovieFilter, SuccessResponse, UpdateMovieRequest, SearchMoviesResponse, BatchUpdateRequest, BatchDeleteRequest
 
 from typing import List
@@ -340,6 +340,22 @@ async def vector_search_movies(
                     "_id": 1,
                     "title": 1,
                     "plot": 1,
+                    "poster": 1,
+                    "year": {
+                        "$cond": {
+                            "if": {
+                                "$and": [
+                                    {"$ne": ["$year", None]},
+                                    {"$eq": [{"$type": "$year"}, "int"]}
+                                ]
+                            },
+                            "then": "$year",
+                            "else": None
+                        }
+                    },
+                    "genres": 1,
+                    "directors": 1,
+                    "cast": 1,
                     "score": {
                         "$meta": "vectorSearchScore"
                     }

From dbb1dbf8cd570cd9b7a57c405b55ccdd4f62e7aa Mon Sep 17 00:00:00 2001
From: Jordan Smith <jordan.smith@mongodb.com>
Date: Thu, 6 Nov 2025 12:42:09 -0500
Subject: [PATCH 080/110] fix vector search implementation

---
 client/app/lib/constants.ts                   |   1 +
 client/app/movies/page.tsx                    | 120 ++++++++++--------
 .../src/controllers/movieController.ts        |  97 +++++++++++---
 server/express/src/types/index.ts             |   5 +
 .../tests/controllers/movieController.test.ts |  48 +++++--
 server/express/tests/utils/testHelpers.ts     |  23 +++-
 6 files changed, 210 insertions(+), 84 deletions(-)

diff --git a/client/app/lib/constants.ts b/client/app/lib/constants.ts
index 9eb2092..391dfec 100644
--- a/client/app/lib/constants.ts
+++ b/client/app/lib/constants.ts
@@ -7,6 +7,7 @@ export const APP_CONFIG = {
   description: 'Browse movies from the sample MFlix database',
   defaultMovieLimit: 20,
   maxMovieLimit: 100,
+  vectorSearchPageSize: 20, // Fixed page size for vector search results display
   imageFormats: ['image/avif', 'image/webp'],
 } as const;
 
diff --git a/client/app/movies/page.tsx b/client/app/movies/page.tsx
index 504fa1a..fdba676 100644
--- a/client/app/movies/page.tsx
+++ b/client/app/movies/page.tsx
@@ -239,16 +239,18 @@ export default function Movies() {
       let result;
 
       if (searchParams.searchType === 'vector-search') {
-        // Vector Search: Fetch all results and implement client-side pagination
+        // Vector Search: Use the limit from search params as the fetch limit
         const vectorSearchParams = {
           q: searchParams.q!,
-          limit: searchParams.limit || 50, // Get more results for better pagination experience
+          limit: searchParams.limit || 50, // This is how many results to fetch from backend
         };
+        
         result = await vectorSearchMovies(vectorSearchParams);
         
         if (result.success) {
           const allResults = result.movies || [];
-          const pageSize = searchParams.limit || 20;
+          const pageSize = APP_CONFIG.vectorSearchPageSize; // Fixed page size for UI display
+          
           setAllVectorSearchResults(allResults);
           setVectorSearchPage(1);
           setVectorSearchPageSize(pageSize);
@@ -257,10 +259,7 @@ export default function Movies() {
           const firstPageResults = allResults.slice(0, pageSize);
           setSearchResults(firstPageResults);
           
-          // Set pagination state based on total results
-          const totalPages = Math.ceil(allResults.length / pageSize);
-          setSearchHasNextPage(totalPages > 1);
-          setSearchHasPrevPage(false);
+          // Set pagination state for vector search
           setSearchTotalCount(allResults.length);
         }
       } else {
@@ -352,15 +351,19 @@ export default function Movies() {
       return { paginatedResults: [], hasNext: false, hasPrev: false, totalPages: 0 };
     }
 
+    const totalResults = allVectorSearchResults.length;
+    const totalPages = Math.ceil(totalResults / vectorSearchPageSize);
+    const hasNext = vectorSearchPage < totalPages;
+    const hasPrev = vectorSearchPage > 1;
+    
     const startIndex = (vectorSearchPage - 1) * vectorSearchPageSize;
     const endIndex = startIndex + vectorSearchPageSize;
     const paginatedResults = allVectorSearchResults.slice(startIndex, endIndex);
-    const totalPages = Math.ceil(allVectorSearchResults.length / vectorSearchPageSize);
     
     return {
       paginatedResults,
-      hasNext: vectorSearchPage < totalPages,
-      hasPrev: vectorSearchPage > 1,
+      hasNext,
+      hasPrev,
       totalPages
     };
   };
@@ -653,55 +656,60 @@ export default function Movies() {
                     /* Vector search results with client-side pagination */
                     (() => {
                       const { hasNext, hasPrev, totalPages } = getVectorSearchPageData();
-                      return totalPages > 1 ? (
-                        <nav className={movieStyles.pagination} aria-label="Vector search results pagination">
-                          <div className={movieStyles.paginationContainer}>
-                            {/* Previous Button */}
-                            {hasPrev ? (
-                              <button
-                                onClick={() => handleVectorSearchPageChange(vectorSearchPage - 1)}
-                                className={movieStyles.pageButton}
-                                aria-label="Go to previous page"
-                              >
-                                ← Previous
-                              </button>
-                            ) : (
-                              <span className={`${movieStyles.pageButton} ${movieStyles.disabled}`}>
-                                ← Previous
-                              </span>
-                            )}
-
-                            {/* Current Page Info */}
-                            <div className={movieStyles.pageInfo}>
-                              Page {vectorSearchPage} of {totalPages}
+                      
+                      if (totalPages > 1) {
+                        return (
+                          <nav className={movieStyles.pagination} aria-label="Vector search results pagination">
+                            <div className={movieStyles.paginationContainer}>
+                              {/* Previous Button */}
+                              {hasPrev ? (
+                                <button
+                                  onClick={() => handleVectorSearchPageChange(vectorSearchPage - 1)}
+                                  className={movieStyles.pageButton}
+                                  aria-label="Go to previous page"
+                                >
+                                  ← Previous
+                                </button>
+                              ) : (
+                                <span className={`${movieStyles.pageButton} ${movieStyles.disabled}`}>
+                                  ← Previous
+                                </span>
+                              )}
+
+                              {/* Current Page Info */}
+                              <div className={movieStyles.pageInfo}>
+                                Page {vectorSearchPage} of {totalPages}
+                              </div>
+
+                              {/* Next Button */}
+                              {hasNext ? (
+                                <button
+                                  onClick={() => handleVectorSearchPageChange(vectorSearchPage + 1)}
+                                  className={movieStyles.pageButton}
+                                  aria-label="Go to next page"
+                                >
+                                  Next →
+                                </button>
+                              ) : (
+                                <span className={`${movieStyles.pageButton} ${movieStyles.disabled}`}>
+                                  Next →
+                                </span>
+                              )}
                             </div>
 
-                            {/* Next Button */}
-                            {hasNext ? (
-                              <button
-                                onClick={() => handleVectorSearchPageChange(vectorSearchPage + 1)}
-                                className={movieStyles.pageButton}
-                                aria-label="Go to next page"
-                              >
-                                Next →
-                              </button>
-                            ) : (
-                              <span className={`${movieStyles.pageButton} ${movieStyles.disabled}`}>
-                                Next →
-                              </span>
-                            )}
-                          </div>
-
-                          {/* Additional Info */}
-                          <div className={movieStyles.additionalInfo}>
-                            {vectorSearchPageSize} movies per page • {allVectorSearchResults.length} total results
+                            {/* Additional Info */}
+                            <div className={movieStyles.additionalInfo}>
+                              {vectorSearchPageSize} movies per page • {allVectorSearchResults.length} total results
+                            </div>
+                          </nav>
+                        );
+                      } else {
+                        return (
+                          <div className={movieStyles.searchInfo}>
+                            Showing {allVectorSearchResults.length} results (vector search)
                           </div>
-                        </nav>
-                      ) : (
-                        <div className={movieStyles.searchInfo}>
-                          Showing {allVectorSearchResults.length} results (vector search)
-                        </div>
-                      );
+                        );
+                      }
                     })()
                   )
                 ) : (
diff --git a/server/express/src/controllers/movieController.ts b/server/express/src/controllers/movieController.ts
index 55032d8..1d65924 100644
--- a/server/express/src/controllers/movieController.ts
+++ b/server/express/src/controllers/movieController.ts
@@ -726,11 +726,11 @@ export async function vectorSearchMovies(req: Request, res: Response): Promise<v
     // Generate embedding using Voyage AI REST API
     const queryVector = await generateVoyageEmbedding(q.trim(), process.env.VOYAGE_API_KEY);
 
-    // Get embedded movies collection
+    // Get embedded movies collection for vector search
     const embeddedMoviesCollection = getCollection("embedded_movies");
 
-    // Build the $vectorSearch aggregation pipeline
-    const pipeline = [
+    // Step 1: Build the $vectorSearch aggregation pipeline for embedded_movies
+    const vectorSearchPipeline = [
       {
         $vectorSearch: {
           index: "vector_index",
@@ -743,27 +743,94 @@ export async function vectorSearchMovies(req: Request, res: Response): Promise<v
       {
         $project: {
           _id: 1,
-          title: 1,
-          plot: 1,
           score: { $meta: "vectorSearchScore" },
         },
       },
     ];
 
-    const results = await embeddedMoviesCollection.aggregate(pipeline).toArray();
+    // Execute vector search to get movie IDs and scores
+    const vectorResults = await embeddedMoviesCollection.aggregate(vectorSearchPipeline).toArray();
+
+    if (vectorResults.length === 0) {
+      res.json(
+        createSuccessResponse(
+          [],
+          `No similar movies found for query: '${q}'`
+        )
+      );
+      return;
+    }
+
+    // Extract movie IDs and create score mapping
+    const movieIds = vectorResults.map(doc => doc._id);
+    const scoreMap = new Map();
+    vectorResults.forEach(doc => {
+      scoreMap.set(doc._id.toString(), doc.score);
+    });
+
+    // Step 2: Fetch complete movie data from the movies collection
+    const moviesCollection = getCollection("movies");
+    
+    // Build aggregation pipeline to safely handle year field and get complete movie data
+    const moviesPipeline = [
+      {
+        $match: {
+          _id: { $in: movieIds }
+        }
+      },
+      {
+        $project: {
+          _id: 1,
+          title: 1,
+          plot: 1,
+          poster: 1,
+          genres: 1,
+          directors: 1,
+          cast: 1,
+          // Safely convert year to integer, handling strings and dirty data
+          year: {
+            $cond: {
+              if: {
+                $and: [
+                  { $ne: ["$year", null] },
+                  { $eq: [{ $type: "$year" }, "int"] }
+                ]
+              },
+              then: "$year",
+              else: null
+            }
+          }
+        }
+      }
+    ];
+
+    const movieResults = await moviesCollection.aggregate(moviesPipeline).toArray();
+
+    // Step 3: Combine movie data with vector search scores
+    const finalResults: VectorSearchResult[] = movieResults.map(movie => {
+      const movieIdStr = movie._id.toString();
+      const score = scoreMap.get(movieIdStr) || 0;
+
+      return {
+        _id: movieIdStr,
+        title: movie.title || '',
+        plot: movie.plot,
+        poster: movie.poster,
+        year: movie.year,
+        genres: movie.genres || [],
+        directors: movie.directors || [],
+        cast: movie.cast || [],
+        score: score,
+      };
+    });
 
-    // Convert ObjectId to string for each result
-    const vectorResults: VectorSearchResult[] = results.map((doc) => ({
-      _id: doc._id.toString(),
-      title: doc.title,
-      plot: doc.plot,
-      score: doc.score,
-    }));
+    // Sort results by score (highest first) to maintain relevance order
+    finalResults.sort((a, b) => b.score - a.score);
 
     res.json(
       createSuccessResponse(
-        vectorResults,
-        `Found ${vectorResults.length} similar movies for query: '${q}'`
+        finalResults,
+        `Found ${finalResults.length} similar movies for query: '${q}'`
       )
     );
   } catch (error) {
diff --git a/server/express/src/types/index.ts b/server/express/src/types/index.ts
index 0f2027d..6305156 100644
--- a/server/express/src/types/index.ts
+++ b/server/express/src/types/index.ts
@@ -193,6 +193,11 @@ export interface VectorSearchResult {
   _id: string;
   title: string;
   plot?: string;
+  poster?: string;
+  year?: number;
+  genres?: string[];
+  directors?: string[];
+  cast?: string[];
   score: number;
 }
 
diff --git a/server/express/tests/controllers/movieController.test.ts b/server/express/tests/controllers/movieController.test.ts
index ae13dbe..bc9ad4f 100644
--- a/server/express/tests/controllers/movieController.test.ts
+++ b/server/express/tests/controllers/movieController.test.ts
@@ -15,6 +15,7 @@ import {
   SAMPLE_MOVIES,
   SAMPLE_SEARCH_RESULTS,
   SAMPLE_VECTOR_RESULTS,
+  SAMPLE_VECTOR_MOVIES,
   SAMPLE_COMMENTS_AGGREGATION,
   SAMPLE_YEARS_AGGREGATION,
   SAMPLE_DIRECTORS_AGGREGATION,
@@ -785,8 +786,17 @@ describe("Movie Controller Tests", () => {
         json: () => Promise.resolve(MOCK_VOYAGE_RESPONSE),
       } as any);
 
-      // Mock database response
-      mockToArray.mockResolvedValue(SAMPLE_VECTOR_RESULTS);
+      // Ensure SAMPLE_VECTOR_RESULTS and SAMPLE_VECTOR_MOVIES have matching IDs
+      const vectorResultsWithMatchingIds = SAMPLE_VECTOR_RESULTS.map((result, index) => ({
+        ...result,
+        _id: SAMPLE_VECTOR_MOVIES[index]._id,
+      }));
+
+      // Mock database responses - first call for embedded_movies collection (vector search)
+      mockToArray
+        .mockResolvedValueOnce(vectorResultsWithMatchingIds)
+        // Second call for movies collection (complete movie data)
+        .mockResolvedValueOnce(SAMPLE_VECTOR_MOVIES);
 
       mockRequest.query = { q: "space adventure", limit: "3" };
 
@@ -803,14 +813,22 @@ describe("Movie Controller Tests", () => {
         })
       );
 
+      // Should call embedded_movies collection first, then movies collection
       expect(mockGetCollection).toHaveBeenCalledWith("embedded_movies");
-      expect(mockAggregate).toHaveBeenCalled();
-
-      const expectedResults = SAMPLE_VECTOR_RESULTS.map((result) => ({
-        _id: result._id.toString(),
-        title: result.title,
-        plot: result.plot,
-        score: result.score,
+      expect(mockGetCollection).toHaveBeenCalledWith("movies");
+      expect(mockAggregate).toHaveBeenCalledTimes(2);
+
+      // Verify the final result structure includes all movie fields
+      const expectedResults = SAMPLE_VECTOR_MOVIES.map((movie, index) => ({
+        _id: movie._id.toString(),
+        title: movie.title,
+        plot: movie.plot,
+        poster: movie.poster,
+        year: movie.year,
+        genres: movie.genres,
+        directors: movie.directors,
+        cast: movie.cast,
+        score: SAMPLE_VECTOR_RESULTS[index].score,
       }));
 
       expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
@@ -888,7 +906,10 @@ describe("Movie Controller Tests", () => {
         json: () => Promise.resolve(MOCK_VOYAGE_RESPONSE),
       } as any);
 
-      mockToArray.mockResolvedValue([]);
+      // Mock empty results from vector search
+      mockToArray
+        .mockResolvedValueOnce([]) // empty vector search results
+        .mockResolvedValueOnce([]); // empty movie results
 
       mockRequest.query = { q: "test" };
 
@@ -896,12 +917,17 @@ describe("Movie Controller Tests", () => {
 
       expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
         [],
-        "Found 0 similar movies for query: 'test'"
+        "No similar movies found for query: 'test'"
       );
     });
   });
 
   describe("findSimilarMovies", () => {
+    beforeEach(() => {
+      // Reset mocks specifically for findSimilarMovies tests
+      mockToArray.mockReset();
+    });
+
     it("should successfully find similar movies", async () => {
       const targetMovie = {
         _id: new ObjectId(TEST_MOVIE_ID),
diff --git a/server/express/tests/utils/testHelpers.ts b/server/express/tests/utils/testHelpers.ts
index 1a051e2..e98f9c0 100644
--- a/server/express/tests/utils/testHelpers.ts
+++ b/server/express/tests/utils/testHelpers.ts
@@ -59,17 +59,36 @@ export const SAMPLE_SEARCH_RESULTS = [
 ];
 
 export const SAMPLE_VECTOR_RESULTS = [
+  {
+    _id: new ObjectId(),
+    score: 0.85,
+  },
+  {
+    _id: new ObjectId(),
+    score: 0.78,
+  },
+];
+
+export const SAMPLE_VECTOR_MOVIES = [
   {
     _id: new ObjectId(),
     title: "Space Raiders",
     plot: "A futuristic space adventure",
-    score: 0.85,
+    poster: "https://example.com/poster1.jpg",
+    year: 2024,
+    genres: ["Sci-Fi", "Action"],
+    directors: ["John Director"],
+    cast: ["Actor One", "Actor Two"],
   },
   {
     _id: new ObjectId(),
     title: "Galaxy Quest",
     plot: "An epic space journey",
-    score: 0.78,
+    poster: "https://example.com/poster2.jpg",
+    year: 2023,
+    genres: ["Sci-Fi", "Comedy"],
+    directors: ["Jane Director"],
+    cast: ["Actor Three", "Actor Four"],
   },
 ];
 

From 2b71ff3963ec9011b019909388cc9f7f0692e203 Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Thu, 6 Nov 2025 15:22:30 -0500
Subject: [PATCH 081/110] add new changes

---
 server/python/main.py               | 47 ++++++++++++++++++-----------
 server/python/src/routers/movies.py |  9 +++---
 2 files changed, 33 insertions(+), 23 deletions(-)

diff --git a/server/python/main.py b/server/python/main.py
index 0b75cf2..2dc2310 100644
--- a/server/python/main.py
+++ b/server/python/main.py
@@ -1,32 +1,27 @@
+from contextlib import asynccontextmanager
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
 from src.routers import movies
-from src.utils.errorHandler import register_error_handlers, create_error_response
+from src.utils.errorHandler import register_error_handlers
 from src.database.mongo_client import db, get_collection
-import traceback
+
 import os
 from dotenv import load_dotenv
 
 # Load environment variables from .env file
 load_dotenv()
 
-app = FastAPI()
 
-# Add CORS middleware
-cors_origins = os.getenv("CORS_ORIGINS", "http://localhost:3000,http://localhost:3001").split(",")
-app.add_middleware(
-    CORSMiddleware,
-    allow_origins=[origin.strip() for origin in cors_origins],  # Load from environment variable
-    allow_credentials=True,
-    allow_methods=["*"],
-    allow_headers=["*"],
-)
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    # Startup: Create search indexes
+    await ensure_search_index()
+    await vector_search_index()
+    yield
+    # Shutdown: Clean up resources if needed
+    # Add any cleanup code here
 
-register_error_handlers(app)
-app.include_router(movies.router, prefix="/api/movies", tags=["movies"])
 
-
-@app.on_event("startup")
 async def ensure_search_index():
     try:
         movies_collection = db.get_collection("movies")
@@ -64,7 +59,7 @@ async def ensure_search_index():
             f"Please check your MongoDB Atlas configuration and ensure the cluster supports search indexes."
         )
 
-@app.on_event("startup")
+
 async def vector_search_index():
     """
     Creates vector search index on application startup if it doesn't already exist.
@@ -98,7 +93,7 @@ async def vector_search_index():
             }
             
             # Create the index
-            result = await embedded_movies_collection.create_search_index(index_definition)
+            await embedded_movies_collection.create_search_index(index_definition)
             
     except Exception as e:
         raise RuntimeError(
@@ -108,3 +103,19 @@ async def vector_search_index():
             f"and verify the 'embedded_movies' collection exists with the required embedding field."
         )
 
+
+app = FastAPI(lifespan=lifespan)
+
+# Add CORS middleware
+cors_origins = os.getenv("CORS_ORIGINS", "http://localhost:3000,http://localhost:3001").split(",")
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=[origin.strip() for origin in cors_origins],  # Load from environment variable
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+register_error_handlers(app)
+app.include_router(movies.router, prefix="/api/movies", tags=["movies"])
+
diff --git a/server/python/src/routers/movies.py b/server/python/src/routers/movies.py
index 7ce784f..d76c2b6 100644
--- a/server/python/src/routers/movies.py
+++ b/server/python/src/routers/movies.py
@@ -1,9 +1,8 @@
 from fastapi import APIRouter, Query, Path, Body
-from src.database.mongo_client import db, get_collection, voyage_ai_available
-from src.models.models import VectorSearchResult, CreateMovieRequest, Movie, MovieFilter, SuccessResponse, UpdateMovieRequest, SearchMoviesResponse, BatchUpdateRequest, BatchDeleteRequest
+from src.database.mongo_client import get_collection, voyage_ai_available
+from src.models.models import VectorSearchResult, CreateMovieRequest, Movie, SuccessResponse, UpdateMovieRequest, SearchMoviesResponse
 
-from typing import List
-from datetime import datetime
+from typing import Any, List
 from src.utils.errorHandler import create_success_response, create_error_response
 from bson import ObjectId
 import re
@@ -986,7 +985,7 @@ async def aggregate_movies_recent_commented(
     # 5. Sorts movies by their most recent comment date
     # 6. Shapes the final output with transformed comment structure
     
-    pipeline = [
+    pipeline: list[dict[str, Any]] =[
         # STAGE 1: $match - Initial Filter
         # Filter movies to only those with valid year data
         {

From 3c2042f72e962dc66acb71d69c7f3ece5a27299c Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Thu, 6 Nov 2025 10:58:31 -0500
Subject: [PATCH 082/110] Rename test file and add unit tests for routes

---
 server/python/tests/test_movie_routes.py  | 685 ++++++++++++++++++----
 server/python/tests/test_movie_schemas.py | 160 +++++
 2 files changed, 729 insertions(+), 116 deletions(-)
 create mode 100644 server/python/tests/test_movie_schemas.py

diff --git a/server/python/tests/test_movie_routes.py b/server/python/tests/test_movie_routes.py
index a4735ca..2220ec7 100644
--- a/server/python/tests/test_movie_routes.py
+++ b/server/python/tests/test_movie_routes.py
@@ -1,16 +1,16 @@
 """
 Unit Tests for Movie Routes
 
-These tests verify basic API validation and structure.
-Following the pattern from PR #21 Express tests - simple validation tests.
-
-Note: These are basic validation tests only. Full integration tests
-would require a test database or mocking strategy that handles
-AsyncMongoClient event loop binding issues.
+These tests verify the route handler logic using mocked MongoDB operations.
+Tests use unittest.mock.AsyncMock to mock database calls without requiring
+an actual database connection or server instance.
 """
 
 import pytest
-from pydantic import ValidationError
+from unittest.mock import AsyncMock, MagicMock, patch
+from bson import ObjectId
+from bson.errors import InvalidId
+
 from src.models.models import CreateMovieRequest, UpdateMovieRequest
 
 
@@ -20,141 +20,594 @@
 
 
 @pytest.mark.unit
-class TestMovieCreateValidation:
-    """Tests for CreateMovieRequest model validation."""
-
-    def test_create_movie_with_valid_data(self):
-        """Should accept valid movie data."""
-        movie_data = {
+@pytest.mark.asyncio
+class TestGetMovieById:
+    """Tests for GET /api/movies/{id} endpoint."""
+
+    @patch('src.routers.movies.get_collection')
+    async def test_get_movie_by_id_success(self, mock_get_collection):
+        """Should return movie when valid ID is provided and movie exists."""
+        # Setup mock
+        mock_collection = AsyncMock()
+        mock_movie = {
+            "_id": ObjectId(TEST_MOVIE_ID),
             "title": "Test Movie",
             "year": 2024,
-            "plot": "A test movie plot",
-            "genres": ["Action", "Drama"],
-            "runtime": 120
+            "plot": "A test movie plot"
         }
+        mock_collection.find_one.return_value = mock_movie
+        mock_get_collection.return_value = mock_collection
+
+        # Import and call the route handler
+        from src.routers.movies import get_movie_by_id
+        result = await get_movie_by_id(TEST_MOVIE_ID)
+
+        # Assertions
+        assert result.success is True
+        assert result.data["title"] == "Test Movie"
+        assert result.data["_id"] == TEST_MOVIE_ID
+        mock_collection.find_one.assert_called_once_with({"_id": ObjectId(TEST_MOVIE_ID)})
+
+    @patch('src.routers.movies.get_collection')
+    async def test_get_movie_by_id_not_found(self, mock_get_collection):
+        """Should return error when movie does not exist."""
+        # Setup mock
+        mock_collection = AsyncMock()
+        mock_collection.find_one.return_value = None
+        mock_get_collection.return_value = mock_collection
+
+        # Import and call the route handler
+        from src.routers.movies import get_movie_by_id
+        result = await get_movie_by_id(TEST_MOVIE_ID)
+
+        # Assertions
+        assert result.success is False
+        assert "not found" in result.message.lower()
+
+    async def test_get_movie_by_id_invalid_id(self):
+        """Should return error when invalid ObjectId format is provided."""
+        # Import and call the route handler
+        from src.routers.movies import get_movie_by_id
+        result = await get_movie_by_id(INVALID_MOVIE_ID)
+
+        # Assertions
+        assert result.success is False
+        assert "invalid" in result.message.lower()
+
+    @patch('src.routers.movies.get_collection')
+    async def test_get_movie_by_id_database_error(self, mock_get_collection):
+        """Should return error when database operation fails."""
+        # Setup mock to raise exception
+        mock_collection = AsyncMock()
+        mock_collection.find_one.side_effect = Exception("Database connection failed")
+        mock_get_collection.return_value = mock_collection
+
+        # Import and call the route handler
+        from src.routers.movies import get_movie_by_id
+        result = await get_movie_by_id(TEST_MOVIE_ID)
+
+        # Assertions
+        assert result.success is False
+        assert "error" in result.message.lower()
 
-        movie = CreateMovieRequest(**movie_data)
-        assert movie.title == "Test Movie"
-        assert movie.year == 2024
-        assert movie.plot == "A test movie plot"
 
-    def test_create_movie_missing_required_field(self):
-        """Should raise ValidationError when title is missing."""
-        movie_data = {
+@pytest.mark.unit
+@pytest.mark.asyncio
+class TestCreateMovie:
+    """Tests for POST /api/movies/ endpoint."""
+
+    @patch('src.routers.movies.get_collection')
+    async def test_create_movie_success(self, mock_get_collection):
+        """Should create movie and return created movie data."""
+        # Setup mock
+        mock_collection = AsyncMock()
+        mock_result = MagicMock()
+        mock_result.acknowledged = True
+        mock_result.inserted_id = ObjectId(TEST_MOVIE_ID)
+        mock_collection.insert_one.return_value = mock_result
+
+        mock_created_movie = {
+            "_id": ObjectId(TEST_MOVIE_ID),
+            "title": "New Movie",
             "year": 2024,
-            "plot": "A movie without title"
+            "plot": "A new movie"
         }
+        mock_collection.find_one.return_value = mock_created_movie
+        mock_get_collection.return_value = mock_collection
+
+        # Create request
+        from src.routers.movies import create_movie
+        movie_request = CreateMovieRequest(
+            title="New Movie",
+            year=2024,
+            plot="A new movie"
+        )
+        result = await create_movie(movie_request)
+
+        # Assertions
+        assert result.success is True
+        assert result.data["title"] == "New Movie"
+        assert result.data["_id"] == TEST_MOVIE_ID
+        mock_collection.insert_one.assert_called_once()
+
+    @patch('src.routers.movies.get_collection')
+    async def test_create_movie_database_error(self, mock_get_collection):
+        """Should return error when database insert fails."""
+        # Setup mock to raise exception
+        mock_collection = AsyncMock()
+        mock_collection.insert_one.side_effect = Exception("Insert failed")
+        mock_get_collection.return_value = mock_collection
+
+        # Create request
+        from src.routers.movies import create_movie
+        movie_request = CreateMovieRequest(title="New Movie")
+        result = await create_movie(movie_request)
+
+        # Assertions
+        assert result.success is False
+        assert "error" in result.message.lower()
 
-        with pytest.raises(ValidationError) as exc_info:
-            CreateMovieRequest(**movie_data)
-
-        errors = exc_info.value.errors()
-        assert any(error["loc"] == ("title",) for error in errors)
 
-    def test_create_movie_invalid_year_type(self):
-        """Should raise ValidationError when year is not an integer."""
-        movie_data = {
-            "title": "Test Movie",
-            "year": "not-a-number"
+@pytest.mark.unit
+@pytest.mark.asyncio
+class TestUpdateMovie:
+    """Tests for PATCH /api/movies/{id} endpoint."""
+
+    @patch('src.routers.movies.get_collection')
+    async def test_update_movie_success(self, mock_get_collection):
+        """Should update movie and return updated movie data."""
+        # Setup mock
+        mock_collection = AsyncMock()
+        mock_result = MagicMock()
+        mock_result.matched_count = 1
+        mock_result.modified_count = 1
+        mock_collection.update_one.return_value = mock_result
+
+        mock_updated_movie = {
+            "_id": ObjectId(TEST_MOVIE_ID),
+            "title": "Updated Movie",
+            "year": 2025,
+            "plot": "Updated plot"
         }
+        mock_collection.find_one.return_value = mock_updated_movie
+        mock_get_collection.return_value = mock_collection
+
+        # Create request
+        from src.routers.movies import update_movie
+        update_request = UpdateMovieRequest(title="Updated Movie", year=2025)
+        result = await update_movie(update_request, TEST_MOVIE_ID)
+
+        # Assertions
+        assert result.success is True
+        assert result.data["title"] == "Updated Movie"
+        mock_collection.update_one.assert_called_once()
+
+    @patch('src.routers.movies.get_collection')
+    async def test_update_movie_not_found(self, mock_get_collection):
+        """Should return error when movie to update does not exist."""
+        # Setup mock
+        mock_collection = AsyncMock()
+        mock_result = MagicMock()
+        mock_result.matched_count = 0
+        mock_collection.update_one.return_value = mock_result
+        mock_get_collection.return_value = mock_collection
+
+        # Create request
+        from src.routers.movies import update_movie
+        update_request = UpdateMovieRequest(title="Updated Movie")
+        result = await update_movie(update_request, TEST_MOVIE_ID)
+
+        # Assertions
+        assert result.success is False
+        assert "was found" in result.message.lower() or "not found" in result.message.lower()
+
+    async def test_update_movie_invalid_id(self):
+        """Should return error when invalid ObjectId format is provided."""
+        # Create request
+        from src.routers.movies import update_movie
+        update_request = UpdateMovieRequest(title="Updated Movie")
+        result = await update_movie(update_request, INVALID_MOVIE_ID)
+
+        # Assertions
+        assert result.success is False
+        assert "invalid" in result.message.lower()
 
-        with pytest.raises(ValidationError) as exc_info:
-            CreateMovieRequest(**movie_data)
 
-        errors = exc_info.value.errors()
-        assert any(error["loc"] == ("year",) for error in errors)
+@pytest.mark.unit
+@pytest.mark.asyncio
+class TestDeleteMovie:
+    """Tests for DELETE /api/movies/{id} endpoint."""
+
+    @patch('src.routers.movies.get_collection')
+    async def test_delete_movie_success(self, mock_get_collection):
+        """Should delete movie and return success response."""
+        # Setup mock
+        mock_collection = AsyncMock()
+        mock_result = MagicMock()
+        mock_result.deleted_count = 1
+        mock_collection.delete_one.return_value = mock_result
+        mock_get_collection.return_value = mock_collection
+
+        # Call the route handler
+        from src.routers.movies import delete_movie_by_id
+        result = await delete_movie_by_id(TEST_MOVIE_ID)
+
+        # Assertions
+        assert result.success is True
+        assert result.data["deletedCount"] == 1
+        mock_collection.delete_one.assert_called_once_with({"_id": ObjectId(TEST_MOVIE_ID)})
+
+    @patch('src.routers.movies.get_collection')
+    async def test_delete_movie_not_found(self, mock_get_collection):
+        """Should return error when movie to delete does not exist."""
+        # Setup mock
+        mock_collection = AsyncMock()
+        mock_result = MagicMock()
+        mock_result.deleted_count = 0
+        mock_collection.delete_one.return_value = mock_result
+        mock_get_collection.return_value = mock_collection
+
+        # Call the route handler
+        from src.routers.movies import delete_movie_by_id
+        result = await delete_movie_by_id(TEST_MOVIE_ID)
+
+        # Assertions
+        assert result.success is False
+        assert "not found" in result.message.lower()
+
+    async def test_delete_movie_invalid_id(self):
+        """Should return error when invalid ObjectId format is provided."""
+        # Call the route handler
+        from src.routers.movies import delete_movie_by_id
+        result = await delete_movie_by_id(INVALID_MOVIE_ID)
+
+        # Assertions
+        assert result.success is False
+        assert "invalid" in result.message.lower()
+
+    @patch('src.routers.movies.get_collection')
+    async def test_delete_movie_database_error(self, mock_get_collection):
+        """Should return error when database operation fails."""
+        # Setup mock to raise exception
+        mock_collection = AsyncMock()
+        mock_collection.delete_one.side_effect = Exception("Delete failed")
+        mock_get_collection.return_value = mock_collection
+
+        # Call the route handler
+        from src.routers.movies import delete_movie_by_id
+        result = await delete_movie_by_id(TEST_MOVIE_ID)
+
+        # Assertions
+        assert result.success is False
+        assert "error" in result.message.lower()
 
-    def test_create_movie_with_optional_fields(self):
-        """Should accept movie with only required fields."""
-        movie_data = {
-            "title": "Minimal Movie"
-        }
 
-        movie = CreateMovieRequest(**movie_data)
-        assert movie.title == "Minimal Movie"
-        assert movie.year is None
-        assert movie.plot is None
 
 
 @pytest.mark.unit
-class TestMovieUpdateValidation:
-    """Tests for UpdateMovieRequest model validation."""
-
-    def test_update_movie_with_valid_data(self):
-        """Should accept valid update data."""
-        update_data = {
-            "title": "Updated Title",
-            "year": 2025
-        }
+@pytest.mark.asyncio
+class TestGetAllMovies:
+    """Tests for GET /api/movies/ endpoint."""
+
+    @patch('src.routers.movies.get_collection')
+    async def test_get_all_movies_success(self, mock_get_collection):
+        """Should return list of movies with default pagination."""
+        # Setup mock with proper cursor chaining
+        mock_collection = MagicMock()
+        mock_cursor = MagicMock()
+
+        # Mock the chaining: find().sort().skip().limit()
+        mock_cursor.sort.return_value = mock_cursor
+        mock_cursor.skip.return_value = mock_cursor
+        mock_cursor.limit.return_value = mock_cursor
+
+        # Mock async iteration
+        mock_cursor.__aiter__.return_value = iter([
+            {"_id": ObjectId(TEST_MOVIE_ID), "title": "Movie 1", "year": 2024},
+            {"_id": ObjectId("507f1f77bcf86cd799439012"), "title": "Movie 2", "year": 2023}
+        ])
+
+        mock_collection.find.return_value = mock_cursor
+        mock_get_collection.return_value = mock_collection
+
+        # Call the route handler
+        from src.routers.movies import get_all_movies
+        result = await get_all_movies()
+
+        # Assertions
+        assert result.success is True
+        assert len(result.data) == 2
+        assert result.data[0]["title"] == "Movie 1"
+        mock_collection.find.assert_called_once()
+
+    @patch('src.routers.movies.get_collection')
+    async def test_get_all_movies_with_filters(self, mock_get_collection):
+        """Should filter movies by genre and year."""
+        # Setup mock with proper cursor chaining
+        mock_collection = MagicMock()
+        mock_cursor = MagicMock()
+
+        # Mock the chaining: find().sort().skip().limit()
+        mock_cursor.sort.return_value = mock_cursor
+        mock_cursor.skip.return_value = mock_cursor
+        mock_cursor.limit.return_value = mock_cursor
+
+        # Mock async iteration
+        mock_cursor.__aiter__.return_value = iter([
+            {"_id": ObjectId(TEST_MOVIE_ID), "title": "Action Movie", "year": 2024, "genres": ["Action"]}
+        ])
+
+        mock_collection.find.return_value = mock_cursor
+        mock_get_collection.return_value = mock_collection
+
+        # Call the route handler with filters
+        from src.routers.movies import get_all_movies
+        result = await get_all_movies(genre="Action", year=2024)
+
+        # Assertions
+        assert result.success is True
+        assert len(result.data) == 1
+        assert "Action" in result.data[0]["genres"]
+
+    @patch('src.routers.movies.get_collection')
+    async def test_get_all_movies_empty_result(self, mock_get_collection):
+        """Should return empty list when no movies match filters."""
+        # Setup mock with proper cursor chaining
+        mock_collection = MagicMock()
+        mock_cursor = MagicMock()
+
+        # Mock the chaining: find().sort().skip().limit()
+        mock_cursor.sort.return_value = mock_cursor
+        mock_cursor.skip.return_value = mock_cursor
+        mock_cursor.limit.return_value = mock_cursor
+
+        # Mock async iteration with empty list
+        mock_cursor.__aiter__.return_value = iter([])
+
+        mock_collection.find.return_value = mock_cursor
+        mock_get_collection.return_value = mock_collection
+
+        # Call the route handler
+        from src.routers.movies import get_all_movies
+        result = await get_all_movies(year=1800)
+
+        # Assertions
+        assert result.success is True
+        assert len(result.data) == 0
+
+    @patch('src.routers.movies.get_collection')
+    async def test_get_all_movies_database_error(self, mock_get_collection):
+        """Should return error when database operation fails."""
+        # Setup mock to raise exception - use MagicMock since find() is synchronous
+        mock_collection = MagicMock()
+        mock_collection.find.side_effect = Exception("Database error")
+        mock_get_collection.return_value = mock_collection
+
+        # Call the route handler
+        from src.routers.movies import get_all_movies
+        result = await get_all_movies()
+
+        # Assertions
+        assert result.success is False
+        assert "error" in result.message.lower()
 
-        movie_update = UpdateMovieRequest(**update_data)
-        assert movie_update.title == "Updated Title"
-        assert movie_update.year == 2025
 
-    def test_update_movie_with_partial_data(self):
-        """Should accept partial update data."""
-        update_data = {
-            "title": "Only Title Updated"
-        }
-
-        movie_update = UpdateMovieRequest(**update_data)
-        assert movie_update.title == "Only Title Updated"
-        assert movie_update.year is None
-
-    def test_update_movie_empty_data(self):
-        """Should accept empty update (all fields optional)."""
-        update_data = {}
+@pytest.mark.unit
+@pytest.mark.asyncio
+class TestBatchOperations:
+    """Tests for batch create and delete operations."""
+
+    @patch('src.routers.movies.get_collection')
+    async def test_create_movies_batch_success(self, mock_get_collection):
+        """Should create multiple movies in batch."""
+        # Setup mock
+        mock_collection = AsyncMock()
+        mock_result = MagicMock()
+        mock_result.acknowledged = True
+        mock_result.inserted_ids = [
+            ObjectId(TEST_MOVIE_ID),
+            ObjectId("507f1f77bcf86cd799439012")
+        ]
+        mock_collection.insert_many.return_value = mock_result
+        mock_get_collection.return_value = mock_collection
+
+        # Create request
+        from src.routers.movies import create_movies_batch
+        movies = [
+            CreateMovieRequest(title="Movie 1", year=2024),
+            CreateMovieRequest(title="Movie 2", year=2023)
+        ]
+        result = await create_movies_batch(movies)
+
+        # Assertions
+        assert result.success is True
+        assert result.data["insertedCount"] == 2
+        # Note: The route handler has a bug where it calls insert_many twice
+        # This test documents the current behavior
+        assert mock_collection.insert_many.call_count == 2
+
+    @patch('src.routers.movies.get_collection')
+    async def test_create_movies_batch_empty_list(self, mock_get_collection):
+        """Should return error when empty list is provided."""
+        mock_get_collection.return_value = AsyncMock()
+
+        # Create request with empty list
+        from src.routers.movies import create_movies_batch
+        result = await create_movies_batch([])
+
+        # Assertions
+        assert result.success is False
+        assert "empty" in result.message.lower()
+
+    @patch('src.routers.movies.get_collection')
+    async def test_delete_movies_batch_success(self, mock_get_collection):
+        """Should delete multiple movies matching filter."""
+        # Setup mock
+        mock_collection = AsyncMock()
+        mock_result = MagicMock()
+        mock_result.deleted_count = 3
+        mock_collection.delete_many.return_value = mock_result
+        mock_get_collection.return_value = mock_collection
+
+        # Create request
+        from src.routers.movies import delete_movies_batch
+        request_body = {"filter": {"year": 2020}}
+        result = await delete_movies_batch(request_body)
+
+        # Assertions
+        assert result.success is True
+        assert result.data["deletedCount"] == 3
+        mock_collection.delete_many.assert_called_once()
+
+    @patch('src.routers.movies.get_collection')
+    async def test_delete_movies_batch_missing_filter(self, mock_get_collection):
+        """Should return error when filter is missing."""
+        mock_get_collection.return_value = AsyncMock()
+
+        # Create request without filter
+        from src.routers.movies import delete_movies_batch
+        request_body = {}
+        result = await delete_movies_batch(request_body)
+
+        # Assertions
+        assert result.success is False
+        assert "filter" in result.message.lower()
 
-        movie_update = UpdateMovieRequest(**update_data)
-        assert movie_update.title is None
-        assert movie_update.year is None
 
 
 @pytest.mark.unit
-class TestMovieDataStructure:
-    """Tests for movie data structure and types."""
-
-    def test_movie_with_all_fields(self):
-        """Should handle movie with all possible fields."""
-        movie_data = {
-            "title": "Complete Movie",
-            "year": 2024,
-            "plot": "Full plot",
-            "fullplot": "Extended plot description",
-            "genres": ["Action", "Drama", "Thriller"],
-            "runtime": 142,
-            "cast": ["Actor 1", "Actor 2", "Actor 3"],
-            "directors": ["Director 1"],
-            "writers": ["Writer 1", "Writer 2"],
-            "languages": ["English", "Spanish"],
-            "rated": "PG-13",
-            "countries": ["USA"]
+@pytest.mark.asyncio
+class TestFindAndDeleteMovie:
+    """Tests for DELETE /api/movies/{id}/find-and-delete endpoint."""
+
+    @patch('src.routers.movies.get_collection')
+    async def test_find_and_delete_success(self, mock_get_collection):
+        """Should find and delete movie in atomic operation."""
+        # Setup mock
+        mock_collection = AsyncMock()
+        mock_deleted_movie = {
+            "_id": ObjectId(TEST_MOVIE_ID),
+            "title": "Deleted Movie",
+            "year": 2024
         }
+        mock_collection.find_one_and_delete.return_value = mock_deleted_movie
+        mock_get_collection.return_value = mock_collection
+
+        # Call the route handler
+        from src.routers.movies import find_and_delete_movie
+        result = await find_and_delete_movie(TEST_MOVIE_ID)
+
+        # Assertions
+        assert result.success is True
+        assert result.data["title"] == "Deleted Movie"
+        assert result.data["_id"] == TEST_MOVIE_ID
+        mock_collection.find_one_and_delete.assert_called_once_with({"_id": ObjectId(TEST_MOVIE_ID)})
+
+    @patch('src.routers.movies.get_collection')
+    async def test_find_and_delete_not_found(self, mock_get_collection):
+        """Should return error when movie does not exist."""
+        # Setup mock
+        mock_collection = AsyncMock()
+        mock_collection.find_one_and_delete.return_value = None
+        mock_get_collection.return_value = mock_collection
+
+        # Call the route handler
+        from src.routers.movies import find_and_delete_movie
+        result = await find_and_delete_movie(TEST_MOVIE_ID)
+
+        # Assertions
+        assert result.success is False
+        assert "not found" in result.message.lower()
+
+    async def test_find_and_delete_invalid_id(self):
+        """Should return error when invalid ObjectId format is provided."""
+        # Call the route handler
+        from src.routers.movies import find_and_delete_movie
+        result = await find_and_delete_movie(INVALID_MOVIE_ID)
+
+        # Assertions
+        assert result.success is False
+        assert "invalid" in result.message.lower()
 
-        movie = CreateMovieRequest(**movie_data)
-        assert movie.title == "Complete Movie"
-        assert len(movie.genres) == 3
-        assert len(movie.cast) == 3
 
-    def test_movie_genres_as_list(self):
-        """Should accept genres as a list."""
-        movie_data = {
-            "title": "Genre Test",
-            "genres": ["Sci-Fi", "Adventure"]
+@pytest.mark.unit
+@pytest.mark.asyncio
+class TestBatchUpdate:
+    """Tests for PATCH /api/movies/ batch update endpoint."""
+
+    @patch('src.routers.movies.get_collection')
+    async def test_update_movies_batch_success(self, mock_get_collection):
+        """Should update multiple movies matching filter."""
+        # Setup mock
+        mock_collection = AsyncMock()
+        mock_result = MagicMock()
+        mock_result.matched_count = 5
+        mock_result.modified_count = 5
+        mock_collection.update_many.return_value = mock_result
+        mock_get_collection.return_value = mock_collection
+
+        # Create request
+        from src.routers.movies import update_movies_batch
+        request_body = {
+            "filter": {"year": 2020},
+            "update": {"$set": {"rated": "PG-13"}}
         }
-
-        movie = CreateMovieRequest(**movie_data)
-        assert isinstance(movie.genres, list)
-        assert "Sci-Fi" in movie.genres
-
-    def test_movie_with_numeric_fields(self):
-        """Should handle numeric fields correctly."""
-        movie_data = {
-            "title": "Numeric Test",
-            "year": 2024,
-            "runtime": 120
+        result = await update_movies_batch(request_body)
+
+        # Assertions
+        assert result.success is True
+        assert result.data["matchedCount"] == 5
+        assert result.data["modifiedCount"] == 5
+        mock_collection.update_many.assert_called_once()
+
+    @patch('src.routers.movies.get_collection')
+    async def test_update_movies_batch_missing_filter(self, mock_get_collection):
+        """Should return error when filter is missing."""
+        mock_get_collection.return_value = AsyncMock()
+
+        # Create request without filter
+        from src.routers.movies import update_movies_batch
+        request_body = {"update": {"$set": {"rated": "PG-13"}}}
+        result = await update_movies_batch(request_body)
+
+        # Assertions
+        assert result.success is False
+        assert "filter" in result.message.lower() or "required" in result.message.lower()
+
+    @patch('src.routers.movies.get_collection')
+    async def test_update_movies_batch_missing_update(self, mock_get_collection):
+        """Should return error when update is missing."""
+        mock_get_collection.return_value = AsyncMock()
+
+        # Create request without update
+        from src.routers.movies import update_movies_batch
+        request_body = {"filter": {"year": 2020}}
+        result = await update_movies_batch(request_body)
+
+        # Assertions
+        assert result.success is False
+        assert "update" in result.message.lower() or "required" in result.message.lower()
+
+    @patch('src.routers.movies.get_collection')
+    async def test_update_movies_batch_no_matches(self, mock_get_collection):
+        """Should return success with zero modified count when no movies match."""
+        # Setup mock
+        mock_collection = AsyncMock()
+        mock_result = MagicMock()
+        mock_result.matched_count = 0
+        mock_result.modified_count = 0
+        mock_collection.update_many.return_value = mock_result
+        mock_get_collection.return_value = mock_collection
+
+        # Create request
+        from src.routers.movies import update_movies_batch
+        request_body = {
+            "filter": {"year": 1800},
+            "update": {"$set": {"rated": "PG-13"}}
         }
+        result = await update_movies_batch(request_body)
 
-        movie = CreateMovieRequest(**movie_data)
-        assert isinstance(movie.year, int)
-        assert isinstance(movie.runtime, int)
+        # Assertions
+        assert result.success is True
+        assert result.data["matchedCount"] == 0
+        assert result.data["modifiedCount"] == 0
diff --git a/server/python/tests/test_movie_schemas.py b/server/python/tests/test_movie_schemas.py
new file mode 100644
index 0000000..a4735ca
--- /dev/null
+++ b/server/python/tests/test_movie_schemas.py
@@ -0,0 +1,160 @@
+"""
+Unit Tests for Movie Routes
+
+These tests verify basic API validation and structure.
+Following the pattern from PR #21 Express tests - simple validation tests.
+
+Note: These are basic validation tests only. Full integration tests
+would require a test database or mocking strategy that handles
+AsyncMongoClient event loop binding issues.
+"""
+
+import pytest
+from pydantic import ValidationError
+from src.models.models import CreateMovieRequest, UpdateMovieRequest
+
+
+# Test constants
+TEST_MOVIE_ID = "507f1f77bcf86cd799439011"
+INVALID_MOVIE_ID = "invalid-id"
+
+
+@pytest.mark.unit
+class TestMovieCreateValidation:
+    """Tests for CreateMovieRequest model validation."""
+
+    def test_create_movie_with_valid_data(self):
+        """Should accept valid movie data."""
+        movie_data = {
+            "title": "Test Movie",
+            "year": 2024,
+            "plot": "A test movie plot",
+            "genres": ["Action", "Drama"],
+            "runtime": 120
+        }
+
+        movie = CreateMovieRequest(**movie_data)
+        assert movie.title == "Test Movie"
+        assert movie.year == 2024
+        assert movie.plot == "A test movie plot"
+
+    def test_create_movie_missing_required_field(self):
+        """Should raise ValidationError when title is missing."""
+        movie_data = {
+            "year": 2024,
+            "plot": "A movie without title"
+        }
+
+        with pytest.raises(ValidationError) as exc_info:
+            CreateMovieRequest(**movie_data)
+
+        errors = exc_info.value.errors()
+        assert any(error["loc"] == ("title",) for error in errors)
+
+    def test_create_movie_invalid_year_type(self):
+        """Should raise ValidationError when year is not an integer."""
+        movie_data = {
+            "title": "Test Movie",
+            "year": "not-a-number"
+        }
+
+        with pytest.raises(ValidationError) as exc_info:
+            CreateMovieRequest(**movie_data)
+
+        errors = exc_info.value.errors()
+        assert any(error["loc"] == ("year",) for error in errors)
+
+    def test_create_movie_with_optional_fields(self):
+        """Should accept movie with only required fields."""
+        movie_data = {
+            "title": "Minimal Movie"
+        }
+
+        movie = CreateMovieRequest(**movie_data)
+        assert movie.title == "Minimal Movie"
+        assert movie.year is None
+        assert movie.plot is None
+
+
+@pytest.mark.unit
+class TestMovieUpdateValidation:
+    """Tests for UpdateMovieRequest model validation."""
+
+    def test_update_movie_with_valid_data(self):
+        """Should accept valid update data."""
+        update_data = {
+            "title": "Updated Title",
+            "year": 2025
+        }
+
+        movie_update = UpdateMovieRequest(**update_data)
+        assert movie_update.title == "Updated Title"
+        assert movie_update.year == 2025
+
+    def test_update_movie_with_partial_data(self):
+        """Should accept partial update data."""
+        update_data = {
+            "title": "Only Title Updated"
+        }
+
+        movie_update = UpdateMovieRequest(**update_data)
+        assert movie_update.title == "Only Title Updated"
+        assert movie_update.year is None
+
+    def test_update_movie_empty_data(self):
+        """Should accept empty update (all fields optional)."""
+        update_data = {}
+
+        movie_update = UpdateMovieRequest(**update_data)
+        assert movie_update.title is None
+        assert movie_update.year is None
+
+
+@pytest.mark.unit
+class TestMovieDataStructure:
+    """Tests for movie data structure and types."""
+
+    def test_movie_with_all_fields(self):
+        """Should handle movie with all possible fields."""
+        movie_data = {
+            "title": "Complete Movie",
+            "year": 2024,
+            "plot": "Full plot",
+            "fullplot": "Extended plot description",
+            "genres": ["Action", "Drama", "Thriller"],
+            "runtime": 142,
+            "cast": ["Actor 1", "Actor 2", "Actor 3"],
+            "directors": ["Director 1"],
+            "writers": ["Writer 1", "Writer 2"],
+            "languages": ["English", "Spanish"],
+            "rated": "PG-13",
+            "countries": ["USA"]
+        }
+
+        movie = CreateMovieRequest(**movie_data)
+        assert movie.title == "Complete Movie"
+        assert len(movie.genres) == 3
+        assert len(movie.cast) == 3
+
+    def test_movie_genres_as_list(self):
+        """Should accept genres as a list."""
+        movie_data = {
+            "title": "Genre Test",
+            "genres": ["Sci-Fi", "Adventure"]
+        }
+
+        movie = CreateMovieRequest(**movie_data)
+        assert isinstance(movie.genres, list)
+        assert "Sci-Fi" in movie.genres
+
+    def test_movie_with_numeric_fields(self):
+        """Should handle numeric fields correctly."""
+        movie_data = {
+            "title": "Numeric Test",
+            "year": 2024,
+            "runtime": 120
+        }
+
+        movie = CreateMovieRequest(**movie_data)
+        assert isinstance(movie.year, int)
+        assert isinstance(movie.runtime, int)

From 65bf0627d888f9d59cf50ef305ddcfd57348e264 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Thu, 6 Nov 2025 11:12:03 -0500
Subject: [PATCH 083/110] Add tests for remaining routes, missing import

---
 server/python/tests/test_movie_routes.py | 450 +++++++++++++++++++++++
 1 file changed, 450 insertions(+)

diff --git a/server/python/tests/test_movie_routes.py b/server/python/tests/test_movie_routes.py
index 2220ec7..3fd510e 100644
--- a/server/python/tests/test_movie_routes.py
+++ b/server/python/tests/test_movie_routes.py
@@ -611,3 +611,453 @@ async def test_update_movies_batch_no_matches(self, mock_get_collection):
         assert result.success is True
         assert result.data["matchedCount"] == 0
         assert result.data["modifiedCount"] == 0
+
+
+
+@pytest.mark.unit
+@pytest.mark.asyncio
+class TestSearchMovies:
+    """Tests for GET /api/movies/search MongoDB Search endpoint."""
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_search_movies_by_plot_success(self, mock_execute_aggregation):
+        """Should successfully search movies by plot."""
+        # Setup mock
+        mock_execute_aggregation.return_value = [{
+            "totalCount": [{"count": 2}],
+            "results": [
+                {"_id": ObjectId(TEST_MOVIE_ID), "title": "Test Movie 1", "plot": "A test plot", "year": 2024},
+                {"_id": ObjectId("507f1f77bcf86cd799439012"), "title": "Test Movie 2", "plot": "Another test", "year": 2023}
+            ]
+        }]
+
+        # Call the route handler
+        from src.routers.movies import search_movies
+        result = await search_movies(plot="test", search_operator="must")
+
+        # Assertions
+        assert result.success is True
+        assert result.data.totalCount == 2
+        assert len(result.data.movies) == 2
+        assert result.data.movies[0].title == "Test Movie 1"
+        mock_execute_aggregation.assert_called_once()
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_search_movies_multiple_fields(self, mock_execute_aggregation):
+        """Should search across multiple fields (directors and cast)."""
+        # Setup mock
+        mock_execute_aggregation.return_value = [{
+            "totalCount": [{"count": 1}],
+            "results": [
+                {"_id": ObjectId(TEST_MOVIE_ID), "title": "Action Movie", "directors": ["John Doe"], "cast": ["Jane Smith"], "year": 2024}
+            ]
+        }]
+
+        # Call the route handler
+        from src.routers.movies import search_movies
+        result = await search_movies(directors="John", cast="Jane", search_operator="must")
+
+        # Assertions
+        assert result.success is True
+        assert result.data.totalCount == 1
+        assert len(result.data.movies) == 1
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_search_movies_with_pagination(self, mock_execute_aggregation):
+        """Should support pagination parameters."""
+        # Setup mock
+        mock_execute_aggregation.return_value = [{
+            "totalCount": [{"count": 100}],
+            "results": [
+                {"_id": ObjectId(TEST_MOVIE_ID), "title": f"Movie {i}", "year": 2024}
+                for i in range(20)
+            ]
+        }]
+
+        # Call the route handler
+        from src.routers.movies import search_movies
+        result = await search_movies(plot="test", limit=20, skip=20, search_operator="must")
+
+        # Assertions
+        assert result.success is True
+        assert result.data.totalCount == 100
+        assert len(result.data.movies) == 20
+
+    async def test_search_movies_no_parameters(self):
+        """Should return error when no search parameters provided."""
+        from src.routers.movies import search_movies
+        result = await search_movies(search_operator="must")
+
+        # Assertions
+        assert result.success is False
+        assert result.error.code == "DATABASE_ERROR"
+
+    async def test_search_movies_invalid_operator(self):
+        """Should return error for invalid search operator."""
+        from src.routers.movies import search_movies
+        result = await search_movies(plot="test", search_operator="invalid")
+
+        # Assertions
+        assert result.success is False
+        assert result.error.code == "INVALID_SEARCH_OPERATOR"
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_search_movies_database_error(self, mock_execute_aggregation):
+        """Should handle database errors gracefully."""
+        # Setup mock to raise exception
+        mock_execute_aggregation.side_effect = Exception("Database connection failed")
+
+        # Call the route handler
+        from src.routers.movies import search_movies
+        result = await search_movies(plot="test", search_operator="must")
+
+        # Assertions
+        assert result.success is False
+        assert result.error.code == "DATABASE_ERROR"
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_search_movies_empty_results(self, mock_execute_aggregation):
+        """Should return empty results when no movies match."""
+        # Setup mock
+        mock_execute_aggregation.return_value = [{
+            "totalCount": [{"count": 0}],
+            "results": []
+        }]
+
+        # Call the route handler
+        from src.routers.movies import search_movies
+        result = await search_movies(plot="nonexistent", search_operator="must")
+
+        # Assertions
+        assert result.success is True
+        assert result.data.totalCount == 0
+        assert len(result.data.movies) == 0
+
+
+@pytest.mark.unit
+@pytest.mark.asyncio
+class TestVectorSearchMovies:
+    """Tests for GET /api/movies/vector-search endpoint."""
+
+    @patch('src.routers.movies.voyage_ai_available')
+    async def test_vector_search_unavailable(self, mock_voyage_available):
+        """Should return error when Voyage AI is not configured."""
+        # Setup mock
+        mock_voyage_available.return_value = False
+
+        # Call the route handler
+        from src.routers.movies import vector_search_movies
+        result = await vector_search_movies(q="action movie")
+
+        # Assertions
+        assert result.success is False
+        assert result.error.code == "SERVICE_UNAVAILABLE"
+        assert "VOYAGE_API_KEY" in result.error.details
+
+    @patch('src.routers.movies.voyage_ai_available')
+    @patch('src.routers.movies.voyageai.Client')
+    @patch('src.routers.movies.get_embedding')
+    @patch('src.routers.movies.get_collection')
+    @patch('src.routers.movies.execute_aggregation_on_collection')
+    async def test_vector_search_success(
+        self,
+        mock_execute_agg,
+        mock_get_collection,
+        mock_get_embedding,
+        mock_voyage_client,
+        mock_voyage_available
+    ):
+        """Should successfully perform vector search."""
+        # Setup mocks
+        mock_voyage_available.return_value = True
+        mock_voyage_client.return_value = MagicMock()  # Mock the Voyage AI client
+        mock_get_embedding.return_value = [0.1] * 2048  # Mock embedding vector
+        mock_execute_agg.return_value = [
+            {"_id": ObjectId(TEST_MOVIE_ID), "title": "Similar Movie 1", "plot": "Action packed", "score": 0.95},
+            {"_id": ObjectId("507f1f77bcf86cd799439012"), "title": "Similar Movie 2", "plot": "More action", "score": 0.87}
+        ]
+
+        # Call the route handler
+        from src.routers.movies import vector_search_movies
+        result = await vector_search_movies(q="action movie", limit=10)
+
+        # Assertions
+        assert result.success is True
+        assert len(result.data) == 2
+        assert result.data[0].title == "Similar Movie 1"
+        assert result.data[0].score == 0.95
+        mock_get_embedding.assert_called_once()
+        mock_execute_agg.assert_called_once()
+
+    @patch('src.routers.movies.voyage_ai_available')
+    @patch('src.routers.movies.voyageai.Client')
+    @patch('src.routers.movies.get_embedding')
+    async def test_vector_search_embedding_error(self, mock_get_embedding, mock_voyage_client, mock_voyage_available):
+        """Should handle embedding generation errors."""
+        # Setup mocks
+        mock_voyage_available.return_value = True
+        mock_voyage_client.return_value = MagicMock()  # Mock the Voyage AI client
+        mock_get_embedding.side_effect = Exception("Embedding API error")
+
+        # Call the route handler
+        from src.routers.movies import vector_search_movies
+        result = await vector_search_movies(q="action movie")
+
+        # Assertions
+        assert result.success is False
+        assert result.error.code == "INTERNAL_SERVER_ERROR"
+
+    @patch('src.routers.movies.voyage_ai_available')
+    @patch('src.routers.movies.voyageai.Client')
+    @patch('src.routers.movies.get_embedding')
+    @patch('src.routers.movies.get_collection')
+    @patch('src.routers.movies.execute_aggregation_on_collection')
+    async def test_vector_search_empty_results(
+        self,
+        mock_execute_agg,
+        mock_get_collection,
+        mock_get_embedding,
+        mock_voyage_client,
+        mock_voyage_available
+    ):
+        """Should return empty results when no similar movies found."""
+        # Setup mocks
+        mock_voyage_available.return_value = True
+        mock_voyage_client.return_value = MagicMock()  # Mock the Voyage AI client
+        mock_get_embedding.return_value = [0.1] * 2048
+        mock_execute_agg.return_value = []
+
+        # Call the route handler
+        from src.routers.movies import vector_search_movies
+        result = await vector_search_movies(q="very specific query", limit=10)
+
+        # Assertions
+        assert result.success is True
+        assert len(result.data) == 0
+
+
+
+@pytest.mark.unit
+@pytest.mark.asyncio
+class TestAggregationReportingByComments:
+    """Tests for GET /api/movies/aggregations/reportingByComments endpoint."""
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_aggregate_movies_recent_commented_success(self, mock_execute_aggregation):
+        """Should successfully aggregate movies with recent comments."""
+        # Setup mock
+        mock_execute_aggregation.return_value = [
+            {
+                "_id": ObjectId(TEST_MOVIE_ID),
+                "title": "Popular Movie",
+                "year": 2024,
+                "genres": ["Action"],
+                "imdbRating": 8.5,
+                "recentComments": [
+                    {"userName": "John", "userEmail": "john@test.com", "text": "Great movie!", "date": "2024-01-01"},
+                    {"userName": "Jane", "userEmail": "jane@test.com", "text": "Loved it!", "date": "2024-01-02"}
+                ],
+                "totalComments": 10
+            }
+        ]
+
+        # Call the route handler
+        from src.routers.movies import aggregate_movies_recent_commented
+        result = await aggregate_movies_recent_commented(limit=10, movie_id=None)
+
+        # Assertions
+        assert result.success is True
+        assert len(result.data) == 1
+        assert result.data[0]["title"] == "Popular Movie"
+        assert result.data[0]["totalComments"] == 10
+        assert len(result.data[0]["recentComments"]) == 2
+        mock_execute_aggregation.assert_called_once()
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_aggregate_movies_by_movie_id(self, mock_execute_aggregation):
+        """Should filter by specific movie ID."""
+        # Setup mock
+        mock_execute_aggregation.return_value = [
+            {
+                "_id": ObjectId(TEST_MOVIE_ID),
+                "title": "Specific Movie",
+                "year": 2024,
+                "totalComments": 5,
+                "recentComments": []
+            }
+        ]
+
+        # Call the route handler
+        from src.routers.movies import aggregate_movies_recent_commented
+        result = await aggregate_movies_recent_commented(movie_id=TEST_MOVIE_ID)
+
+        # Assertions
+        assert result.success is True
+        assert len(result.data) == 1
+        assert result.data[0]["_id"] == TEST_MOVIE_ID
+
+    async def test_aggregate_movies_invalid_movie_id(self):
+        """Should return error for invalid movie ID format."""
+        from src.routers.movies import aggregate_movies_recent_commented
+        result = await aggregate_movies_recent_commented(movie_id="invalid_id")
+
+        # Assertions
+        assert result.success is False
+        assert result.error.code == "INTERNAL_SERVER_ERROR"
+        assert "ObjectId" in result.error.details
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_aggregate_movies_database_error(self, mock_execute_aggregation):
+        """Should handle database errors gracefully."""
+        # Setup mock to raise exception
+        mock_execute_aggregation.side_effect = Exception("Aggregation failed")
+
+        # Call the route handler
+        from src.routers.movies import aggregate_movies_recent_commented
+        result = await aggregate_movies_recent_commented(limit=10, movie_id=None)
+
+        # Assertions
+        assert result.success is False
+        assert result.error.code == "INTERNAL_SERVER_ERROR"
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_aggregate_movies_empty_results(self, mock_execute_aggregation):
+        """Should return empty results when no movies have comments."""
+        # Setup mock
+        mock_execute_aggregation.return_value = []
+
+        # Call the route handler
+        from src.routers.movies import aggregate_movies_recent_commented
+        result = await aggregate_movies_recent_commented(limit=10, movie_id=None)
+
+        # Assertions
+        assert result.success is True
+        assert len(result.data) == 0
+
+
+@pytest.mark.unit
+@pytest.mark.asyncio
+class TestAggregationReportingByYear:
+    """Tests for GET /api/movies/aggregations/reportingByYear endpoint."""
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_aggregate_movies_by_year_success(self, mock_execute_aggregation):
+        """Should successfully aggregate movies by year with statistics."""
+        # Setup mock
+        mock_execute_aggregation.return_value = [
+            {"year": 2024, "movieCount": 150, "averageRating": 7.5, "highestRating": 9.5, "lowestRating": 5.0, "totalVotes": 50000},
+            {"year": 2023, "movieCount": 200, "averageRating": 7.2, "highestRating": 9.0, "lowestRating": 4.5, "totalVotes": 75000}
+        ]
+
+        # Call the route handler
+        from src.routers.movies import aggregate_movies_by_year
+        result = await aggregate_movies_by_year()
+
+        # Assertions
+        assert result.success is True
+        assert len(result.data) == 2
+        assert result.data[0]["year"] == 2024
+        assert result.data[0]["movieCount"] == 150
+        assert result.data[0]["averageRating"] == 7.5
+        mock_execute_aggregation.assert_called_once()
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_aggregate_movies_by_year_database_error(self, mock_execute_aggregation):
+        """Should handle database errors gracefully."""
+        # Setup mock to raise exception
+        mock_execute_aggregation.side_effect = Exception("Aggregation pipeline failed")
+
+        # Call the route handler
+        from src.routers.movies import aggregate_movies_by_year
+        result = await aggregate_movies_by_year()
+
+        # Assertions
+        assert result.success is False
+        assert result.error.code == "INTERNAL_SERVER_ERROR"
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_aggregate_movies_by_year_empty_results(self, mock_execute_aggregation):
+        """Should return empty results when no valid year data."""
+        # Setup mock
+        mock_execute_aggregation.return_value = []
+
+        # Call the route handler
+        from src.routers.movies import aggregate_movies_by_year
+        result = await aggregate_movies_by_year()
+
+        # Assertions
+        assert result.success is True
+        assert len(result.data) == 0
+
+
+@pytest.mark.unit
+@pytest.mark.asyncio
+class TestAggregationReportingByDirectors:
+    """Tests for GET /api/movies/aggregations/reportingByDirectors endpoint."""
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_aggregate_directors_most_movies_success(self, mock_execute_aggregation):
+        """Should successfully aggregate directors with most movies."""
+        # Setup mock
+        mock_execute_aggregation.return_value = [
+            {"director": "Steven Spielberg", "movieCount": 50, "averageRating": 8.2},
+            {"director": "Martin Scorsese", "movieCount": 45, "averageRating": 8.5},
+            {"director": "Christopher Nolan", "movieCount": 40, "averageRating": 8.7}
+        ]
+
+        # Call the route handler
+        from src.routers.movies import aggregate_directors_most_movies
+        result = await aggregate_directors_most_movies(limit=20)
+
+        # Assertions
+        assert result.success is True
+        assert len(result.data) == 3
+        assert result.data[0]["director"] == "Steven Spielberg"
+        assert result.data[0]["movieCount"] == 50
+        assert result.data[0]["averageRating"] == 8.2
+        mock_execute_aggregation.assert_called_once()
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_aggregate_directors_with_custom_limit(self, mock_execute_aggregation):
+        """Should respect custom limit parameter."""
+        # Setup mock
+        mock_execute_aggregation.return_value = [
+            {"director": "Director 1", "movieCount": 10, "averageRating": 7.0}
+        ]
+
+        # Call the route handler
+        from src.routers.movies import aggregate_directors_most_movies
+        result = await aggregate_directors_most_movies(limit=5)
+
+        # Assertions
+        assert result.success is True
+        # Verify the aggregation was called (limit is applied in pipeline)
+        mock_execute_aggregation.assert_called_once()
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_aggregate_directors_database_error(self, mock_execute_aggregation):
+        """Should handle database errors gracefully."""
+        # Setup mock to raise exception
+        mock_execute_aggregation.side_effect = Exception("Pipeline execution failed")
+
+        # Call the route handler
+        from src.routers.movies import aggregate_directors_most_movies
+        result = await aggregate_directors_most_movies()
+
+        # Assertions
+        assert result.success is False
+        assert result.error.code == "INTERNAL_SERVER_ERROR"
+
+    @patch('src.routers.movies.execute_aggregation')
+    async def test_aggregate_directors_empty_results(self, mock_execute_aggregation):
+        """Should return empty results when no directors found."""
+        # Setup mock
+        mock_execute_aggregation.return_value = []
+
+        # Call the route handler
+        from src.routers.movies import aggregate_directors_most_movies
+        result = await aggregate_directors_most_movies()
+
+        # Assertions
+        assert result.success is True
+        assert len(result.data) == 0

From 093d78a19c7f08859ca5cfaa2e4b505b33f092f3 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Thu, 6 Nov 2025 12:03:25 -0500
Subject: [PATCH 084/110] Add integration tests, update workflow and script

---
 .../scripts/generate-test-summary-pytest.sh   | 131 ++++---
 .github/workflows/run-python-tests.yml        |  18 +-
 server/python/tests/README.md                 | 192 ++++++++++
 server/python/tests/integration/__init__.py   |   2 +
 server/python/tests/integration/conftest.py   | 213 +++++++++++
 .../test_movie_routes_integration.py          | 333 ++++++++++++++++++
 6 files changed, 838 insertions(+), 51 deletions(-)
 mode change 100644 => 100755 .github/scripts/generate-test-summary-pytest.sh
 create mode 100644 server/python/tests/README.md
 create mode 100644 server/python/tests/integration/__init__.py
 create mode 100644 server/python/tests/integration/conftest.py
 create mode 100644 server/python/tests/integration/test_movie_routes_integration.py

diff --git a/.github/scripts/generate-test-summary-pytest.sh b/.github/scripts/generate-test-summary-pytest.sh
old mode 100644
new mode 100755
index f88ffff..9b1bef1
--- a/.github/scripts/generate-test-summary-pytest.sh
+++ b/.github/scripts/generate-test-summary-pytest.sh
@@ -1,70 +1,109 @@
 #!/bin/bash
 set -e
 
-# Generate Test Summary from Pytest JUnit XML Output
-# Usage: ./generate-test-summary-pytest.sh <path-to-junit-xml>
+# Generate Detailed Test Summary from Multiple Pytest JUnit XML Output Files
+# Shows breakdown by test type (unit vs integration)
+# Usage: ./generate-test-summary-pytest-detailed.sh <unit-xml> <integration-xml>
 
-XML_FILE="${1:-test-results.xml}"
+UNIT_XML="${1:-}"
+INTEGRATION_XML="${2:-}"
 
 echo "## Test Results" >> $GITHUB_STEP_SUMMARY
 echo "" >> $GITHUB_STEP_SUMMARY
 
-# Parse test results from JUnit XML
-if [ -f "$XML_FILE" ]; then
-  # Extract test counts from XML
-  # JUnit XML structure: <testsuite tests="N" failures="N" errors="N" skipped="N">
+# Function to parse XML file
+parse_xml() {
+  local xml_file="$1"
+  local test_type="$2"
   
-  tests=$(grep -oP 'tests="\K[0-9]+' "$XML_FILE" | head -1)
-  failures=$(grep -oP 'failures="\K[0-9]+' "$XML_FILE" | head -1)
-  errors=$(grep -oP 'errors="\K[0-9]+' "$XML_FILE" | head -1)
-  skipped=$(grep -oP 'skipped="\K[0-9]+' "$XML_FILE" | head -1)
+  if [ ! -f "$xml_file" ]; then
+    echo "0 0 0 0 0"
+    return
+  fi
+  
+  tests=$(grep -oP 'tests="\K[0-9]+' "$xml_file" | head -1)
+  failures=$(grep -oP 'failures="\K[0-9]+' "$xml_file" | head -1)
+  errors=$(grep -oP 'errors="\K[0-9]+' "$xml_file" | head -1)
+  skipped=$(grep -oP 'skipped="\K[0-9]+' "$xml_file" | head -1)
   
-  # Default to 0 if values are empty
   tests=${tests:-0}
   failures=${failures:-0}
   errors=${errors:-0}
   skipped=${skipped:-0}
-  
   passed=$((tests - failures - errors - skipped))
   
-  echo "| Status | Count |" >> $GITHUB_STEP_SUMMARY
-  echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
-  echo "| ✅ Passed | $passed |" >> $GITHUB_STEP_SUMMARY
-  echo "| ❌ Failed | $((failures + errors)) |" >> $GITHUB_STEP_SUMMARY
-  echo "| ⏭️ Skipped | $skipped |" >> $GITHUB_STEP_SUMMARY
-  echo "| **Total** | **$tests** |" >> $GITHUB_STEP_SUMMARY
+  echo "$tests $failures $errors $skipped $passed"
+}
+
+# Parse both files
+read -r unit_tests unit_failures unit_errors unit_skipped unit_passed <<< "$(parse_xml "$UNIT_XML" "Unit")"
+read -r int_tests int_failures int_errors int_skipped int_passed <<< "$(parse_xml "$INTEGRATION_XML" "Integration")"
+
+# Calculate totals
+total_tests=$((unit_tests + int_tests))
+total_failures=$((unit_failures + int_failures))
+total_errors=$((unit_errors + int_errors))
+total_skipped=$((unit_skipped + int_skipped))
+total_passed=$((unit_passed + int_passed))
+total_failed=$((total_failures + total_errors))
+
+# Display detailed breakdown
+echo "### Summary by Test Type" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+echo "| Test Type | Passed | Failed | Skipped | Total |" >> $GITHUB_STEP_SUMMARY
+echo "|-----------|--------|--------|---------|-------|" >> $GITHUB_STEP_SUMMARY
+
+if [ -f "$UNIT_XML" ]; then
+  echo "| 🔧 Unit Tests | $unit_passed | $((unit_failures + unit_errors)) | $unit_skipped | $unit_tests |" >> $GITHUB_STEP_SUMMARY
+fi
+
+if [ -f "$INTEGRATION_XML" ]; then
+  echo "| 🔗 Integration Tests | $int_passed | $((int_failures + int_errors)) | $int_skipped | $int_tests |" >> $GITHUB_STEP_SUMMARY
+fi
+
+echo "| **Total** | **$total_passed** | **$total_failed** | **$total_skipped** | **$total_tests** |" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# Overall status
+echo "### Overall Status" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+echo "| Status | Count |" >> $GITHUB_STEP_SUMMARY
+echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
+echo "| ✅ Passed | $total_passed |" >> $GITHUB_STEP_SUMMARY
+echo "| ❌ Failed | $total_failed |" >> $GITHUB_STEP_SUMMARY
+echo "| ⏭️ Skipped | $total_skipped |" >> $GITHUB_STEP_SUMMARY
+echo "| **Total** | **$total_tests** |" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# List failed tests if any
+if [ $total_failed -gt 0 ]; then
+  echo "### ❌ Failed Tests" >> $GITHUB_STEP_SUMMARY
   echo "" >> $GITHUB_STEP_SUMMARY
   
-  # List failed tests if any
-  if [ $((failures + errors)) -gt 0 ]; then
-    echo "### ❌ Failed Tests" >> $GITHUB_STEP_SUMMARY
-    echo "" >> $GITHUB_STEP_SUMMARY
-    
-    # Extract failed test names from XML
-    failed_tests_file=$(mktemp)
-    
-    # Find testcase elements with failure or error children
-    grep -oP '<testcase[^>]*classname="[^"]*"[^>]*name="[^"]*"[^>]*>.*?<(failure|error)' "$XML_FILE" | \
-      grep -oP 'classname="\K[^"]*|name="\K[^"]*' | \
-      paste -d '.' - - >> "$failed_tests_file" 2>/dev/null || true
-    
-    if [ -s "$failed_tests_file" ]; then
-      while IFS= read -r test; do
-        echo "- \`$test\`" >> $GITHUB_STEP_SUMMARY
-      done < "$failed_tests_file"
-    else
-      echo "_Unable to parse individual test names_" >> $GITHUB_STEP_SUMMARY
+  failed_tests_file=$(mktemp)
+  
+  # Extract failed tests from both files
+  for xml_file in "$UNIT_XML" "$INTEGRATION_XML"; do
+    if [ -f "$xml_file" ]; then
+      grep -oP '<testcase[^>]*classname="[^"]*"[^>]*name="[^"]*"[^>]*>.*?<(failure|error)' "$xml_file" | \
+        grep -oP 'classname="\K[^"]*|name="\K[^"]*' | \
+        paste -d '.' - - >> "$failed_tests_file" 2>/dev/null || true
     fi
-    
-    echo "" >> $GITHUB_STEP_SUMMARY
-    echo "❌ **Tests failed!**" >> $GITHUB_STEP_SUMMARY
-    rm -f "$failed_tests_file"
-    exit 1
+  done
+  
+  if [ -s "$failed_tests_file" ]; then
+    while IFS= read -r test; do
+      echo "- \`$test\`" >> $GITHUB_STEP_SUMMARY
+    done < "$failed_tests_file"
   else
-    echo "✅ **All tests passed!**" >> $GITHUB_STEP_SUMMARY
+    echo "_Unable to parse individual test names_" >> $GITHUB_STEP_SUMMARY
   fi
-else
-  echo "⚠️ No test results found at: $XML_FILE" >> $GITHUB_STEP_SUMMARY
+  
+  echo "" >> $GITHUB_STEP_SUMMARY
+  echo "❌ **Tests failed!**" >> $GITHUB_STEP_SUMMARY
+  rm -f "$failed_tests_file"
   exit 1
+else
+  echo "✅ **All tests passed!**" >> $GITHUB_STEP_SUMMARY
 fi
 
diff --git a/.github/workflows/run-python-tests.yml b/.github/workflows/run-python-tests.yml
index 26109ab..117671a 100644
--- a/.github/workflows/run-python-tests.yml
+++ b/.github/workflows/run-python-tests.yml
@@ -36,8 +36,14 @@ jobs:
           python -m pip install --upgrade pip
           pip install -r requirements.txt
 
-      - name: Run tests
-        run: pytest --verbose --tb=short --junit-xml=test-results.xml || true
+      - name: Run unit tests
+        run: pytest -m unit --verbose --tb=short --junit-xml=test-results-unit.xml
+        env:
+          MONGO_URI: ${{ secrets.MFLIX_URI }}
+          MONGO_DB: sample_mflix
+
+      - name: Run integration tests
+        run: pytest -m integration --verbose --tb=short --junit-xml=test-results-integration.xml || true
         env:
           MONGO_URI: ${{ secrets.MFLIX_URI }}
           MONGO_DB: sample_mflix
@@ -48,7 +54,8 @@ jobs:
         with:
           name: test-results
           path: |
-            server/python/test-results.xml
+            server/python/test-results-unit.xml
+            server/python/test-results-integration.xml
             server/python/htmlcov/
           retention-days: 30
 
@@ -57,5 +64,6 @@ jobs:
         working-directory: .
         run: |
           chmod +x .github/scripts/generate-test-summary-pytest.sh
-          .github/scripts/generate-test-summary-pytest.sh server/python/test-results.xml
-
+          .github/scripts/generate-test-summary-pytest.sh \
+            server/python/test-results-unit.xml \
+            server/python/test-results-integration.xml
diff --git a/server/python/tests/README.md b/server/python/tests/README.md
new file mode 100644
index 0000000..bf73ce3
--- /dev/null
+++ b/server/python/tests/README.md
@@ -0,0 +1,192 @@
+# Testing Guide for FastAPI MongoDB Sample Application
+
+This document describes the testing strategy and how to run tests for the FastAPI MongoDB MFlix sample application.
+
+## Test Structure
+
+The test suite is organized into three categories:
+
+### 1. **Schema Tests** (`test_movie_schemas.py`)
+- Tests Pydantic model validation
+- Validates request/response data structures
+- No database or external dependencies required
+- **10 tests** covering `CreateMovieRequest`, `UpdateMovieRequest`, and `Movie` models
+
+### 2. **Unit Tests** (`test_movie_routes.py`)
+- Tests route handler functions in isolation
+- Uses `unittest.mock.AsyncMock` to mock MongoDB operations
+- No database connection required
+- Fast execution (< 2 seconds)
+- **51 tests** covering:
+  - CRUD operations (create, read, update, delete)
+  - Batch operations
+  - Search functionality
+  - Vector search
+  - Aggregation pipelines
+
+### 3. **Integration Tests** (`tests/integration/test_movie_routes_integration.py`)
+- Tests the full HTTP request/response cycle
+- Requires a running MongoDB instance with MFlix dataset
+- Uses a real server running in a subprocess
+- Tests are idempotent (clean up after themselves)
+- **8 tests** (7 passing, 1 skipped due to known bug) covering:
+  - End-to-end CRUD operations
+  - Search against real data
+  - Batch operations with cleanup
+  - Aggregation queries
+
+## Running Tests
+
+### Prerequisites
+
+1. **For all tests:**
+   ```bash
+   cd server/python
+   source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows
+   ```
+
+2. **For integration tests only:**
+   - MongoDB instance running with MFlix dataset loaded
+   - Connection string configured in `.env` file
+   - Port 8001 available (used for test server)
+
+### Run All Tests
+
+```bash
+pytest tests/ -v
+```
+
+**Expected output:** 68 passed, 1 skipped in ~5 seconds
+
+### Run Only Unit Tests (Fast, No Database Required)
+
+```bash
+pytest -m unit -v
+```
+
+**Expected output:** 51 passed in ~1 second
+
+### Run Only Integration Tests (Requires Database)
+
+```bash
+pytest -m integration -v
+```
+
+**Expected output:** 7 passed, 1 skipped in ~4 seconds
+
+### Run Specific Test File
+
+```bash
+# Schema tests
+pytest tests/test_movie_schemas.py -v
+
+# Unit tests
+pytest tests/test_movie_routes.py -v
+
+# Integration tests
+pytest tests/integration/test_movie_routes_integration.py -v
+```
+
+### Run Specific Test Class or Method
+
+```bash
+# Run a specific test class
+pytest tests/test_movie_routes.py::TestCreateMovie -v
+
+# Run a specific test method
+pytest tests/test_movie_routes.py::TestCreateMovie::test_create_movie_success -v
+```
+
+## Test Markers
+
+Tests are marked with pytest markers for selective execution:
+
+- `@pytest.mark.unit` - Unit tests with mocked dependencies
+- `@pytest.mark.integration` - Integration tests requiring database
+
+## Integration Test Strategy
+
+### Why Use a Running Server?
+
+The integration tests start a real FastAPI server in a subprocess because:
+
+1. **Event Loop Isolation**: AsyncMongoClient binds to the event loop it was created in. Using a real server avoids event loop conflicts.
+2. **Real-World Testing**: Tests the actual deployment configuration, including middleware, CORS, and startup events.
+3. **Educational Value**: Demonstrates a practical integration testing pattern for async Python applications.
+
+### Idempotent Tests
+
+All integration tests are designed to be idempotent:
+
+- **Create operations**: Tests create new documents with unique identifiers
+- **Cleanup**: Fixtures automatically delete created documents after tests
+- **Read-only tests**: Tests against existing MFlix data don't modify anything
+- **Batch operations**: Create and delete multiple documents with proper cleanup
+
+### Fixtures
+
+Integration tests use pytest fixtures for test data lifecycle management:
+
+- `client`: AsyncClient connected to the test server
+- `test_movie_data`: Sample movie data for creating test documents
+- `created_movie`: Creates a movie and cleans it up automatically
+- `multiple_test_movies`: Creates 3 movies for batch operation testing
+
+## Known Issues
+
+### Batch Create Bug (Skipped Test)
+
+The `test_batch_create_movies` test is currently skipped due to a known bug in the API:
+
+- **Issue**: `create_movies_batch` function calls `insert_many` twice (lines 1006 and 1015 in `movies.py`)
+- **Impact**: Causes 500 error on batch create operations
+- **Status**: To be fixed in a separate PR
+- **Test behavior**: Test detects the error and skips gracefully
+
+## Troubleshooting
+
+### Integration Tests Fail to Start Server
+
+**Error**: `Port 8001 is already in use`
+
+**Solution**: 
+- Kill any process using port 8001: `lsof -ti:8001 | xargs kill -9`
+- Or change the port in `tests/integration/conftest.py`
+
+### Integration Tests Can't Connect to MongoDB
+
+**Error**: Connection timeout or authentication error
+
+**Solution**:
+- Verify MongoDB is running
+- Check `.env` file has correct `MONGODB_URI`
+- Ensure MFlix dataset is loaded
+- Test connection: `mongosh <your-connection-string>`
+
+### Unit Tests Fail with Import Errors
+
+**Error**: `ModuleNotFoundError`
+
+**Solution**:
+- Ensure virtual environment is activated
+- Install dependencies: `pip install -r requirements.txt`
+- Run from `server/python` directory
+
+## Contributing
+
+When adding new routes or functionality:
+
+1. **Add unit tests** in `test_movie_routes.py` with mocked dependencies
+2. **Add integration tests** in `tests/integration/test_movie_routes_integration.py` for end-to-end validation
+3. **Use appropriate markers** (`@pytest.mark.unit` or `@pytest.mark.integration`)
+4. **Follow fixture patterns** for test data lifecycle management
+5. **Ensure idempotency** - tests should clean up after themselves
+6. **Document test purpose** with clear docstrings
+
+## Additional Resources
+
+- [pytest documentation](https://docs.pytest.org/)
+- [pytest-asyncio documentation](https://pytest-asyncio.readthedocs.io/)
+- [FastAPI testing guide](https://fastapi.tiangolo.com/tutorial/testing/)
+- [MongoDB Motor documentation](https://motor.readthedocs.io/)
+
diff --git a/server/python/tests/integration/__init__.py b/server/python/tests/integration/__init__.py
new file mode 100644
index 0000000..a4bb8be
--- /dev/null
+++ b/server/python/tests/integration/__init__.py
@@ -0,0 +1,2 @@
+"""Integration tests for the FastAPI MongoDB sample application."""
+
diff --git a/server/python/tests/integration/conftest.py b/server/python/tests/integration/conftest.py
new file mode 100644
index 0000000..329cbdc
--- /dev/null
+++ b/server/python/tests/integration/conftest.py
@@ -0,0 +1,213 @@
+"""
+Shared fixtures for integration tests.
+
+This module demonstrates MongoDB data lifecycle management patterns
+for integration testing with FastAPI and MongoDB.
+
+These integration tests use a real running server to avoid event loop
+issues with AsyncMongoClient. This approach:
+- Tests the actual deployment configuration
+- Avoids event loop binding issues
+- Demonstrates real-world integration testing patterns
+"""
+
+import uuid
+import time
+import subprocess
+import sys
+import os
+import pytest
+import pytest_asyncio
+from httpx import AsyncClient
+import socket
+
+
+def is_port_in_use(port):
+    """Check if a port is already in use."""
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        return s.connect_ex(('localhost', port)) == 0
+
+
+@pytest.fixture(scope="session")
+def server():
+    """
+    Start the FastAPI server in a subprocess for integration testing.
+
+    This fixture demonstrates:
+    - Starting a real server for integration tests
+    - Proper cleanup of server process
+    - Waiting for server to be ready
+    - Using a test-specific port
+
+    The server runs for the entire test session and is shared across all tests.
+    """
+    # Use a different port for testing to avoid conflicts
+    test_port = 8001
+
+    # Check if port is already in use
+    if is_port_in_use(test_port):
+        pytest.skip(f"Port {test_port} is already in use. Cannot start test server.")
+
+    # Get the absolute path to the server/python directory
+    # Tests are in server/python/tests/integration, so go up two levels
+    test_dir = os.path.dirname(os.path.abspath(__file__))
+    server_python_dir = os.path.abspath(os.path.join(test_dir, "..", ".."))
+
+    # Start the server process
+    process = subprocess.Popen(
+        [sys.executable, "-m", "uvicorn", "main:app", "--host", "127.0.0.1", "--port", str(test_port)],
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        cwd=server_python_dir
+    )
+
+    # Wait for server to be ready (max 10 seconds)
+    max_wait = 10
+    start_time = time.time()
+    while time.time() - start_time < max_wait:
+        if is_port_in_use(test_port):
+            # Server is ready
+            time.sleep(0.5)  # Give it a bit more time to fully initialize
+            break
+        time.sleep(0.1)
+    else:
+        # Server didn't start in time
+        process.kill()
+        pytest.fail(f"Server failed to start within {max_wait} seconds")
+
+    yield f"http://127.0.0.1:{test_port}"
+
+    # Cleanup: Stop the server
+    process.terminate()
+    try:
+        process.wait(timeout=5)
+    except subprocess.TimeoutExpired:
+        process.kill()
+        process.wait()
+
+
+@pytest_asyncio.fixture
+async def client(server):
+    """
+    Create an AsyncClient that connects to the running test server.
+
+    This client makes real HTTP requests to the server running in a subprocess,
+    testing the full request/response cycle including:
+    - Request validation
+    - Route handlers
+    - Database operations
+    - Response serialization
+    - Middleware
+    - CORS
+
+    This approach avoids event loop issues with AsyncMongoClient.
+    """
+    async with AsyncClient(base_url=server, timeout=30.0) as ac:
+        yield ac
+
+
+@pytest.fixture
+def test_movie_data():
+    """
+    Generate unique test movie data.
+    
+    Uses UUID to ensure uniqueness and avoid conflicts with:
+    - Existing MFlix data
+    - Other concurrent tests
+    - Previous test runs
+    
+    Returns minimal required fields for a valid movie document.
+    """
+    unique_id = str(uuid.uuid4())[:8]
+    return {
+        "title": f"Integration Test Movie {unique_id}",
+        "year": 2024,
+        "plot": f"This is a test movie created during integration testing. ID: {unique_id}",
+        "genres": ["Test", "Integration"],
+        "runtime": 120,
+        "cast": ["Test Actor 1", "Test Actor 2"],
+        "directors": ["Test Director"],
+        "rated": "PG-13"
+    }
+
+
+@pytest_asyncio.fixture
+async def created_movie(client, test_movie_data):
+    """
+    Create a test movie and automatically clean it up after the test.
+
+    This fixture demonstrates the create -> test -> cleanup pattern:
+    1. POST request creates a new movie
+    2. Yield the movie ID to the test
+    3. DELETE request removes the movie (runs even if test fails)
+
+    Usage:
+        async def test_something(created_movie):
+            # created_movie is the movie ID
+            response = await client.get(f"/api/movies/{created_movie}")
+            # ... test assertions ...
+            # Cleanup happens automatically
+    """
+    # Setup: Create test movie
+    response = await client.post("/api/movies/", json=test_movie_data)
+    assert response.status_code in [200, 201], f"Failed to create test movie: {response.text}"
+
+    movie_id = response.json()["data"]["_id"]
+
+    # Provide movie ID to test
+    yield movie_id
+
+    # Teardown: Clean up test movie (always runs)
+    cleanup_response = await client.delete(f"/api/movies/{movie_id}")
+    # Verify cleanup succeeded (helps catch cleanup issues early)
+    assert cleanup_response.status_code == 200, f"Failed to clean up test movie {movie_id}"
+
+
+@pytest_asyncio.fixture
+async def multiple_test_movies(client):
+    """
+    Create multiple test movies for batch operation testing.
+
+    This fixture demonstrates:
+    - Creating multiple related test documents
+    - Tracking all created IDs for cleanup
+    - Cleaning up all documents even if test fails
+
+    Usage:
+        async def test_batch_operation(multiple_test_movies):
+            # multiple_test_movies is a list of movie IDs
+            assert len(multiple_test_movies) == 3
+            # ... test batch operations ...
+            # All movies cleaned up automatically
+    """
+    movie_ids = []
+    unique_id = str(uuid.uuid4())[:8]
+
+    # Create 3 test movies
+    for i in range(3):
+        movie_data = {
+            "title": f"Batch Test Movie {i} - {unique_id}",
+            "year": 2024,
+            "plot": f"Batch test movie {i}",
+            "genres": ["Test"],
+            "runtime": 90
+        }
+        response = await client.post("/api/movies/", json=movie_data)
+        assert response.status_code in [200, 201], f"Failed to create batch test movie {i}"
+        movie_ids.append(response.json()["data"]["_id"])
+
+    yield movie_ids
+
+    # Cleanup all test movies
+    # Note: Some tests may have already deleted these movies, so we handle that gracefully
+    for movie_id in movie_ids:
+        cleanup_response = await client.delete(f"/api/movies/{movie_id}")
+        # Accept 200 (success) or 500 (movie already deleted)
+        if cleanup_response.status_code == 500:
+            # Check if it's a "not found" error
+            response_data = cleanup_response.json()
+            if response_data.get("success") is False and "not found" in response_data.get("error", {}).get("message", "").lower():
+                # Movie was already deleted, which is fine
+                continue
+        assert cleanup_response.status_code == 200, f"Failed to clean up movie {movie_id}"
+
diff --git a/server/python/tests/integration/test_movie_routes_integration.py b/server/python/tests/integration/test_movie_routes_integration.py
new file mode 100644
index 0000000..7c83a57
--- /dev/null
+++ b/server/python/tests/integration/test_movie_routes_integration.py
@@ -0,0 +1,333 @@
+"""
+Integration tests for movie routes.
+
+These tests validate the full request/response cycle against a real MongoDB instance.
+They demonstrate best practices for:
+- Testing with real database operations
+- Managing test data lifecycle
+- Leaving the database in a clean state
+- Testing against production-like data (MFlix dataset)
+
+Note: These tests create and clean up their own test data, leaving the
+existing MFlix dataset untouched.
+"""
+
+import pytest
+
+
+@pytest.mark.integration
+class TestMovieCRUDIntegration:
+    """
+    Integration tests for basic CRUD operations.
+
+    These tests demonstrate the full lifecycle of movie documents:
+    - Creating new documents
+    - Reading documents by ID
+    - Updating existing documents
+    - Deleting documents
+    """
+
+    @pytest.mark.asyncio
+    async def test_create_and_retrieve_movie(self, client, test_movie_data):
+        """
+        Test creating a movie and retrieving it by ID.
+
+        This test demonstrates:
+        - POST request with JSON body
+        - Response validation
+        - GET request with path parameter
+        - Explicit cleanup pattern
+        """
+        # Create a new movie
+        create_response = await client.post("/api/movies/", json=test_movie_data)
+
+        # Validate creation response (201 Created is correct for POST)
+        assert create_response.status_code == 201
+        create_data = create_response.json()
+        assert create_data["success"] is True
+        assert create_data["data"]["title"] == test_movie_data["title"]
+
+        movie_id = create_data["data"]["_id"]
+
+        try:
+            # Retrieve the created movie
+            get_response = await client.get(f"/api/movies/{movie_id}")
+
+            # Validate retrieval response
+            assert get_response.status_code == 200
+            get_data = get_response.json()
+            assert get_data["success"] is True
+            assert get_data["data"]["_id"] == movie_id
+            assert get_data["data"]["title"] == test_movie_data["title"]
+            assert get_data["data"]["year"] == test_movie_data["year"]
+
+        finally:
+            # Cleanup: Delete the test movie
+            delete_response = await client.delete(f"/api/movies/{movie_id}")
+            assert delete_response.status_code == 200
+
+    @pytest.mark.asyncio
+    async def test_update_movie(self, client, created_movie):
+        """
+        Test updating a movie's fields.
+
+        This test demonstrates:
+        - Using fixtures for setup/cleanup
+        - PATCH request with partial updates
+        - Verifying updates persisted to database
+        """
+        # Update the movie
+        update_data = {
+            "title": "Updated Integration Test Title",
+            "year": 2025,
+            "plot": "Updated plot for integration testing"
+        }
+        update_response = await client.patch(
+            f"/api/movies/{created_movie}",
+            json=update_data
+        )
+
+        # Validate update response
+        assert update_response.status_code == 200
+        update_result = update_response.json()
+        assert update_result["success"] is True
+
+        # Verify the update persisted
+        get_response = await client.get(f"/api/movies/{created_movie}")
+        assert get_response.status_code == 200
+        movie_data = get_response.json()["data"]
+        assert movie_data["title"] == update_data["title"]
+        assert movie_data["year"] == update_data["year"]
+        assert movie_data["plot"] == update_data["plot"]
+
+        # Fixture handles cleanup automatically
+
+    @pytest.mark.asyncio
+    async def test_delete_movie(self, client, test_movie_data):
+        """
+        Test deleting a movie.
+
+        This test demonstrates:
+        - Complete lifecycle: create -> delete -> verify
+        - Testing 404 response after deletion
+        - No cleanup needed (movie already deleted)
+        """
+        # Create a movie
+        create_response = await client.post("/api/movies/", json=test_movie_data)
+        movie_id = create_response.json()["data"]["_id"]
+
+        # Delete the movie
+        delete_response = await client.delete(f"/api/movies/{movie_id}")
+        assert delete_response.status_code == 200
+        delete_data = delete_response.json()
+        assert delete_data["success"] is True
+
+        # Verify movie no longer exists
+        # Note: The API returns 200 with INTERNAL_SERVER_ERROR code, not 404
+        get_response = await client.get(f"/api/movies/{movie_id}")
+        error_data = get_response.json()
+        assert error_data["success"] is False
+        assert error_data["error"]["code"] == "INTERNAL_SERVER_ERROR"
+        assert "not found" in error_data["error"]["message"].lower()
+
+        # No cleanup needed - movie already deleted
+
+
+@pytest.mark.integration
+class TestMovieSearchIntegration:
+    """
+    Integration tests for search functionality.
+
+    These tests use the existing MFlix dataset (read-only operations).
+    No cleanup needed since we're not modifying data.
+    """
+
+    @pytest.mark.asyncio
+    async def test_search_existing_movies_by_plot(self, client):
+        """
+        Test searching movies using the existing MFlix dataset.
+
+        This test demonstrates:
+        - Read-only operations against production-like data
+        - Query parameters in GET requests
+        - No cleanup needed for read operations
+        """
+        # Search for movies with "love" in the plot
+        response = await client.get("/api/movies/search?plot=love&search_operator=must")
+
+        # Validate response
+        assert response.status_code == 200
+        data = response.json()
+        assert data["success"] is True
+        assert data["data"]["totalCount"] > 0
+        assert len(data["data"]["movies"]) > 0
+
+        # Verify search results contain the search term
+        first_movie = data["data"]["movies"][0]
+        assert "title" in first_movie
+        assert "plot" in first_movie
+
+    @pytest.mark.asyncio
+    async def test_get_all_movies_with_pagination(self, client):
+        """
+        Test retrieving movies with pagination.
+
+        This test demonstrates:
+        - Pagination parameters (skip/limit, not page-based)
+        - Testing against existing dataset
+        - Validating response structure
+        """
+        # Get first page using skip and limit
+        response = await client.get("/api/movies/?skip=0&limit=10")
+
+        assert response.status_code == 200
+        data = response.json()
+        assert data["success"] is True
+        # The API returns a simple list in data, not a paginated object
+        assert isinstance(data["data"], list)
+        assert len(data["data"]) <= 10
+
+
+@pytest.mark.integration
+class TestBatchOperationsIntegration:
+    """
+    Integration tests for batch operations.
+
+    These tests demonstrate working with multiple documents
+    and proper cleanup of all created test data.
+    """
+
+    @pytest.mark.asyncio
+    async def test_batch_create_movies(self, client):
+        """
+        Test creating multiple movies in a single request.
+
+        This test demonstrates:
+        - Batch creation endpoint
+        - Creating multiple test documents
+        - Cleaning up all created documents
+        """
+        # Prepare batch of movies
+        import uuid
+        unique_id = str(uuid.uuid4())[:8]
+        movies = [
+            {
+                "title": f"Batch Movie {i} - {unique_id}",
+                "year": 2024,
+                "plot": f"Batch test movie {i}",
+                "genres": ["Test"],
+                "runtime": 90
+            }
+            for i in range(3)
+        ]
+
+        # Create batch
+        response = await client.post("/api/movies/batch", json=movies)
+
+        # Note: Due to a bug in the API (duplicate insert_many calls),
+        # this may return 500. This is a known issue to be fixed.
+        # For now, we'll accept either 201 (success) or 500 (bug)
+        assert response.status_code in [201, 500]
+
+        if response.status_code == 500:
+            # Skip the rest of the test if the bug occurs
+            import pytest
+            pytest.skip("Batch create failed due to known duplicate insert_many bug")
+        data = response.json()
+        assert data["success"] is True
+
+        # Extract created IDs for cleanup
+        created_ids = data["data"]["insertedIds"]
+        assert len(created_ids) == 3
+
+        try:
+            # Verify all movies were created
+            for movie_id in created_ids:
+                get_response = await client.get(f"/api/movies/{movie_id}")
+                assert get_response.status_code == 200
+        finally:
+            # Cleanup: Delete all created movies
+            for movie_id in created_ids:
+                await client.delete(f"/api/movies/{movie_id}")
+
+    @pytest.mark.asyncio
+    async def test_batch_delete_movies(self, client, multiple_test_movies):
+        """
+        Test deleting multiple movies using a filter.
+
+        This test demonstrates:
+        - Using fixtures to create test data
+        - Batch delete with filter
+        - Verifying deletions
+        """
+        # Get one of the test movie titles for filtering
+        first_movie_response = await client.get(f"/api/movies/{multiple_test_movies[0]}")
+        first_movie_title = first_movie_response.json()["data"]["title"]
+
+        # Extract the unique ID from the title (format: "Batch Test Movie X - {uuid}")
+        unique_id = first_movie_title.split(" - ")[-1]
+
+        # Delete all movies with this unique ID in the title
+        # Note: httpx AsyncClient.delete() doesn't support json parameter
+        # We need to use request() method instead
+        # The API expects the filter to be wrapped in a "filter" key
+        # The batch delete endpoint is at DELETE /api/movies/ (not /batch)
+        delete_response = await client.request(
+            "DELETE",
+            "/api/movies/",
+            json={"filter": {"title": {"$regex": unique_id}}}
+        )
+
+        assert delete_response.status_code == 200
+        delete_data = delete_response.json()
+        assert delete_data["success"] is True
+        assert delete_data["data"]["deletedCount"] == 3
+
+        # Verify all movies were deleted
+        # Note: The API returns 200 with INTERNAL_SERVER_ERROR code, not 404
+        for movie_id in multiple_test_movies:
+            get_response = await client.get(f"/api/movies/{movie_id}")
+            response_data = get_response.json()
+            assert response_data["success"] is False
+            assert response_data["error"]["code"] == "INTERNAL_SERVER_ERROR"
+            assert "not found" in response_data["error"]["message"].lower()
+
+        # Note: Fixture cleanup will try to delete but movies are already gone
+        # The fixture should handle this gracefully
+
+
+@pytest.mark.integration
+class TestAggregationIntegration:
+    """
+    Integration tests for aggregation endpoints.
+
+    These tests use the existing MFlix dataset (read-only operations).
+    """
+
+    @pytest.mark.asyncio
+    async def test_aggregate_movies_by_year(self, client):
+        """
+        Test aggregation reporting by year.
+
+        This test demonstrates:
+        - Complex aggregation pipelines
+        - Testing against existing dataset
+        - Validating aggregation results
+        """
+        response = await client.get("/api/movies/aggregations/reportingByYear")
+
+        assert response.status_code == 200
+        data = response.json()
+        assert data["success"] is True
+        assert len(data["data"]) > 0
+
+        # Validate structure of aggregation results
+        # Note: The aggregation projects "year" field and excludes "_id"
+        first_result = data["data"][0]
+        assert "year" in first_result  # Year field (not _id)
+        assert "movieCount" in first_result
+        assert "averageRating" in first_result  # Note: it's averageRating, not avgRuntime
+        assert "highestRating" in first_result
+        assert "lowestRating" in first_result
+        assert "totalVotes" in first_result
+

From 050539dec0d16573f18b25067fd2628872cae606 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Thu, 6 Nov 2025 17:20:34 -0500
Subject: [PATCH 085/110] Update tests after pulling in bug fix

---
 server/python/tests/README.md                          |  6 +++---
 .../tests/integration/test_movie_routes_integration.py | 10 +---------
 server/python/tests/test_movie_routes.py               |  4 +---
 3 files changed, 5 insertions(+), 15 deletions(-)

diff --git a/server/python/tests/README.md b/server/python/tests/README.md
index bf73ce3..64dbafd 100644
--- a/server/python/tests/README.md
+++ b/server/python/tests/README.md
@@ -56,7 +56,7 @@ The test suite is organized into three categories:
 pytest tests/ -v
 ```
 
-**Expected output:** 68 passed, 1 skipped in ~5 seconds
+**Expected output:** 69 passed in ~5 seconds
 
 ### Run Only Unit Tests (Fast, No Database Required)
 
@@ -64,7 +64,7 @@ pytest tests/ -v
 pytest -m unit -v
 ```
 
-**Expected output:** 51 passed in ~1 second
+**Expected output:** 61 passed, 8 deselected in ~1 second
 
 ### Run Only Integration Tests (Requires Database)
 
@@ -72,7 +72,7 @@ pytest -m unit -v
 pytest -m integration -v
 ```
 
-**Expected output:** 7 passed, 1 skipped in ~4 seconds
+**Expected output:** 8 passed, 61 deselected in ~4 seconds
 
 ### Run Specific Test File
 
diff --git a/server/python/tests/integration/test_movie_routes_integration.py b/server/python/tests/integration/test_movie_routes_integration.py
index 7c83a57..0909089 100644
--- a/server/python/tests/integration/test_movie_routes_integration.py
+++ b/server/python/tests/integration/test_movie_routes_integration.py
@@ -224,15 +224,7 @@ async def test_batch_create_movies(self, client):
         # Create batch
         response = await client.post("/api/movies/batch", json=movies)
 
-        # Note: Due to a bug in the API (duplicate insert_many calls),
-        # this may return 500. This is a known issue to be fixed.
-        # For now, we'll accept either 201 (success) or 500 (bug)
-        assert response.status_code in [201, 500]
-
-        if response.status_code == 500:
-            # Skip the rest of the test if the bug occurs
-            import pytest
-            pytest.skip("Batch create failed due to known duplicate insert_many bug")
+        assert response.status_code == 201
         data = response.json()
         assert data["success"] is True
 
diff --git a/server/python/tests/test_movie_routes.py b/server/python/tests/test_movie_routes.py
index 3fd510e..9a04b06 100644
--- a/server/python/tests/test_movie_routes.py
+++ b/server/python/tests/test_movie_routes.py
@@ -422,9 +422,7 @@ async def test_create_movies_batch_success(self, mock_get_collection):
         # Assertions
         assert result.success is True
         assert result.data["insertedCount"] == 2
-        # Note: The route handler has a bug where it calls insert_many twice
-        # This test documents the current behavior
-        assert mock_collection.insert_many.call_count == 2
+        assert mock_collection.insert_many.call_count == 1
 
     @patch('src.routers.movies.get_collection')
     async def test_create_movies_batch_empty_list(self, mock_get_collection):

From 833321f73329f9a9cdc0fe2f108b18f0c1276b24 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Thu, 6 Nov 2025 19:11:03 -0500
Subject: [PATCH 086/110] Add integration tests for remaining aggregation APIs

---
 server/python/tests/README.md                 | 16 ++---
 .../test_movie_routes_integration.py          | 62 +++++++++++++++++++
 2 files changed, 70 insertions(+), 8 deletions(-)

diff --git a/server/python/tests/README.md b/server/python/tests/README.md
index 64dbafd..f8bf9f9 100644
--- a/server/python/tests/README.md
+++ b/server/python/tests/README.md
@@ -29,11 +29,11 @@ The test suite is organized into three categories:
 - Requires a running MongoDB instance with MFlix dataset
 - Uses a real server running in a subprocess
 - Tests are idempotent (clean up after themselves)
-- **8 tests** (7 passing, 1 skipped due to known bug) covering:
-  - End-to-end CRUD operations
-  - Search against real data
-  - Batch operations with cleanup
-  - Aggregation queries
+- **10 tests** covering:
+  - CRUD operations
+  - Batch operations
+  - Search functionality
+  - Aggregation pipelines
 
 ## Running Tests
 
@@ -56,7 +56,7 @@ The test suite is organized into three categories:
 pytest tests/ -v
 ```
 
-**Expected output:** 69 passed in ~5 seconds
+**Expected output:** 71 passed in ~6 seconds
 
 ### Run Only Unit Tests (Fast, No Database Required)
 
@@ -64,7 +64,7 @@ pytest tests/ -v
 pytest -m unit -v
 ```
 
-**Expected output:** 61 passed, 8 deselected in ~1 second
+**Expected output:** 61 passed, 10 deselected in ~1.5 seconds
 
 ### Run Only Integration Tests (Requires Database)
 
@@ -72,7 +72,7 @@ pytest -m unit -v
 pytest -m integration -v
 ```
 
-**Expected output:** 8 passed, 61 deselected in ~4 seconds
+**Expected output:** 10 passed, 61 deselected in ~5 seconds
 
 ### Run Specific Test File
 
diff --git a/server/python/tests/integration/test_movie_routes_integration.py b/server/python/tests/integration/test_movie_routes_integration.py
index 0909089..f018bbd 100644
--- a/server/python/tests/integration/test_movie_routes_integration.py
+++ b/server/python/tests/integration/test_movie_routes_integration.py
@@ -323,3 +323,65 @@ async def test_aggregate_movies_by_year(self, client):
         assert "lowestRating" in first_result
         assert "totalVotes" in first_result
 
+    @pytest.mark.asyncio
+    async def test_aggregate_movies_by_comments(self, client):
+        """
+        Test aggregation reporting by comments.
+
+        This test demonstrates:
+        - $lookup aggregation (joining collections)
+        - Testing against existing dataset with comments
+        - Validating nested data structures
+        """
+        response = await client.get("/api/movies/aggregations/reportingByComments?limit=5")
+
+        assert response.status_code == 200
+        data = response.json()
+        assert data["success"] is True
+
+        # Should return movies that have comments
+        if len(data["data"]) > 0:
+            first_result = data["data"][0]
+            # Validate structure of aggregation results
+            assert "_id" in first_result
+            assert "title" in first_result
+            assert "year" in first_result
+            assert "totalComments" in first_result
+            assert "recentComments" in first_result
+            assert isinstance(first_result["recentComments"], list)
+
+            # If there are recent comments, validate their structure
+            if len(first_result["recentComments"]) > 0:
+                comment = first_result["recentComments"][0]
+                assert "userName" in comment
+                assert "userEmail" in comment
+                assert "text" in comment
+                assert "date" in comment
+
+    @pytest.mark.asyncio
+    async def test_aggregate_directors_most_movies(self, client):
+        """
+        Test aggregation reporting by directors.
+
+        This test demonstrates:
+        - $unwind aggregation (array flattening)
+        - Grouping and sorting operations
+        - Testing against existing dataset
+        """
+        response = await client.get("/api/movies/aggregations/reportingByDirectors?limit=10")
+
+        assert response.status_code == 200
+        data = response.json()
+        assert data["success"] is True
+        assert len(data["data"]) > 0
+
+        # Validate structure of aggregation results
+        first_result = data["data"][0]
+        assert "director" in first_result
+        assert "movieCount" in first_result
+        assert "averageRating" in first_result
+
+        # Verify results are sorted by movieCount (descending)
+        if len(data["data"]) > 1:
+            assert data["data"][0]["movieCount"] >= data["data"][1]["movieCount"]
+

From e6ec7c623a26700d66298d6e3206b22857cbda8c Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Thu, 6 Nov 2025 19:58:58 -0500
Subject: [PATCH 087/110] Move Java Spring and Python FastAPI apps to final dir
 structure

---
 .../workflows/run-java-spring-boot-tests.yml  |  17 ++-
 .github/workflows/run-python-tests.yml        |  16 ++-
 mflix/.gitignore-java                         | 113 ++++++++++++++++++
 mflix/.gitignore-js                           |  62 ++++++++++
 mflix/.gitignore-python                       |  52 ++++++++
 .../server}/java-spring/.env.example          |   4 +
 .../server}/java-spring/.gitignore            |   0
 .../.mvn/wrapper/maven-wrapper.properties     |   0
 {server => mflix/server}/java-spring/mvnw     |   0
 {server => mflix/server}/java-spring/mvnw.cmd |   0
 {server => mflix/server}/java-spring/pom.xml  |   0
 .../samplemflix/SampleMflixApplication.java   |   0
 .../samplemflix/config/CorsConfig.java        |   0
 .../config/DatabaseVerification.java          |   0
 .../samplemflix/config/MongoConfig.java       |   0
 .../config/ObjectIdSerializer.java            |   0
 .../config/ObjectMapperConfig.java            |   0
 .../samplemflix/config/OpenApiConfig.java     |   0
 .../samplemflix/config/WebMvcConfig.java      |   0
 .../controller/MovieControllerImpl.java       |   0
 .../exception/DatabaseOperationException.java |   0
 .../exception/GlobalExceptionHandler.java     |   0
 .../exception/ResourceNotFoundException.java  |   0
 .../exception/ValidationException.java        |   0
 .../mongodb/samplemflix/model/Comment.java    |   0
 .../com/mongodb/samplemflix/model/Movie.java  |   0
 .../mongodb/samplemflix/model/Theater.java    |   0
 .../model/dto/BatchInsertResponse.java        |   0
 .../model/dto/BatchUpdateResponse.java        |   0
 .../model/dto/CreateMovieRequest.java         |   0
 .../samplemflix/model/dto/DeleteResponse.java |   0
 .../model/dto/DirectorStatisticsResult.java   |   0
 .../model/dto/MovieSearchQuery.java           |   0
 .../model/dto/MovieSearchRequest.java         |   0
 .../model/dto/MovieWithCommentsResult.java    |   0
 .../model/dto/MoviesByYearResult.java         |   0
 .../model/dto/SearchMoviesResponse.java       |   0
 .../model/dto/UpdateMovieRequest.java         |   0
 .../model/dto/VectorSearchResult.java         |   0
 .../model/response/ApiResponse.java           |   0
 .../model/response/ErrorResponse.java         |   0
 .../model/response/SuccessResponse.java       |   0
 .../repository/MovieRepository.java           |   0
 .../samplemflix/service/MovieService.java     |   0
 .../samplemflix/service/MovieServiceImpl.java |   0
 .../samplemflix/util/ValidationUtils.java     |   0
 .../src/main/resources/application.properties |   0
 .../controller/MovieControllerTest.java       |   0
 .../MongoDBSearchIntegrationTest.java         |   0
 .../integration/MovieIntegrationTest.java     |   0
 .../mongodb/samplemflix/integration/README.md |   0
 .../samplemflix/service/MovieServiceTest.java |   0
 .../resources/application-test.properties     |   0
 .../server/python-fastapi}/.env.example       |   4 +
 .../server/python-fastapi}/.gitignore         |   0
 .../python-fastapi/README_OLD_REMOVE_ME.md    |   0
 .../server/python-fastapi}/main.py            |   0
 .../server/python-fastapi}/pytest.ini         |   0
 .../server/python-fastapi}/requirements.in    |   0
 .../server/python-fastapi}/requirements.txt   |   0
 .../src/database/mongo_client.py              |   0
 .../python-fastapi}/src/models/models.py      |   0
 .../python-fastapi}/src/routers/movies.py     |   0
 .../python-fastapi}/src/utils/errorHandler.py |   0
 .../server/python-fastapi}/tests/README.md    |   0
 .../server/python-fastapi}/tests/__init__.py  |   0
 .../server/python-fastapi}/tests/conftest.py  |   0
 .../tests/integration/__init__.py             |   0
 .../tests/integration/conftest.py             |   0
 .../test_movie_routes_integration.py          |   0
 .../tests/test_movie_routes.py                |   0
 .../tests/test_movie_schemas.py               |   0
 72 files changed, 252 insertions(+), 16 deletions(-)
 create mode 100644 mflix/.gitignore-java
 create mode 100644 mflix/.gitignore-js
 create mode 100644 mflix/.gitignore-python
 rename {server => mflix/server}/java-spring/.env.example (76%)
 rename {server => mflix/server}/java-spring/.gitignore (100%)
 rename {server => mflix/server}/java-spring/.mvn/wrapper/maven-wrapper.properties (100%)
 rename {server => mflix/server}/java-spring/mvnw (100%)
 rename {server => mflix/server}/java-spring/mvnw.cmd (100%)
 rename {server => mflix/server}/java-spring/pom.xml (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectIdSerializer.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectMapperConfig.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/config/OpenApiConfig.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/config/WebMvcConfig.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/exception/DatabaseOperationException.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/exception/ResourceNotFoundException.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchInsertResponse.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchUpdateResponse.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DeleteResponse.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DirectorStatisticsResult.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchRequest.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieWithCommentsResult.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MoviesByYearResult.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/SearchMoviesResponse.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/VectorSearchResult.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java (100%)
 rename {server => mflix/server}/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java (100%)
 rename {server => mflix/server}/java-spring/src/main/resources/application.properties (100%)
 rename {server => mflix/server}/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java (100%)
 rename {server => mflix/server}/java-spring/src/test/java/com/mongodb/samplemflix/integration/MongoDBSearchIntegrationTest.java (100%)
 rename {server => mflix/server}/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java (100%)
 rename {server => mflix/server}/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md (100%)
 rename {server => mflix/server}/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java (100%)
 rename {server => mflix/server}/java-spring/src/test/resources/application-test.properties (100%)
 rename {server/python => mflix/server/python-fastapi}/.env.example (62%)
 rename {server/python => mflix/server/python-fastapi}/.gitignore (100%)
 rename server/python/README.md => mflix/server/python-fastapi/README_OLD_REMOVE_ME.md (100%)
 rename {server/python => mflix/server/python-fastapi}/main.py (100%)
 rename {server/python => mflix/server/python-fastapi}/pytest.ini (100%)
 rename {server/python => mflix/server/python-fastapi}/requirements.in (100%)
 rename {server/python => mflix/server/python-fastapi}/requirements.txt (100%)
 rename {server/python => mflix/server/python-fastapi}/src/database/mongo_client.py (100%)
 rename {server/python => mflix/server/python-fastapi}/src/models/models.py (100%)
 rename {server/python => mflix/server/python-fastapi}/src/routers/movies.py (100%)
 rename {server/python => mflix/server/python-fastapi}/src/utils/errorHandler.py (100%)
 rename {server/python => mflix/server/python-fastapi}/tests/README.md (100%)
 rename {server/python => mflix/server/python-fastapi}/tests/__init__.py (100%)
 rename {server/python => mflix/server/python-fastapi}/tests/conftest.py (100%)
 rename {server/python => mflix/server/python-fastapi}/tests/integration/__init__.py (100%)
 rename {server/python => mflix/server/python-fastapi}/tests/integration/conftest.py (100%)
 rename {server/python => mflix/server/python-fastapi}/tests/integration/test_movie_routes_integration.py (100%)
 rename {server/python => mflix/server/python-fastapi}/tests/test_movie_routes.py (100%)
 rename {server/python => mflix/server/python-fastapi}/tests/test_movie_schemas.py (100%)

diff --git a/.github/workflows/run-java-spring-boot-tests.yml b/.github/workflows/run-java-spring-boot-tests.yml
index 8108f69..6c4ffa9 100644
--- a/.github/workflows/run-java-spring-boot-tests.yml
+++ b/.github/workflows/run-java-spring-boot-tests.yml
@@ -4,9 +4,13 @@ on:
   pull_request_target:
     branches:
       - development
+    paths:
+      - 'mflix/server/java-spring/**'
   push:
     branches:
       - development
+    paths:
+      - 'mflix/server/java-spring/**'
 
 jobs:
   test:
@@ -17,7 +21,7 @@ jobs:
 
     defaults:
       run:
-        working-directory: server/java-spring
+        working-directory: mflix/server/java-spring
 
     env:
       MONGODB_URI: ${{ secrets.MFLIX_URI }}
@@ -39,13 +43,6 @@ jobs:
       - name: Make mvnw executable
         run: chmod +x mvnw
 
-      - name: Debug environment variables
-        run: |
-          echo "Checking environment variables..."
-          echo "MONGODB_URI is set: $(if [ -n "$MONGODB_URI" ]; then echo 'YES'; else echo 'NO'; fi)"
-          echo "ENABLE_SEARCH_TESTS is set: $(if [ -n "$ENABLE_SEARCH_TESTS" ]; then echo 'YES'; else echo 'NO'; fi)"
-          echo "MONGODB_URI length: ${#MONGODB_URI}"
-
       - name: Run unit tests
         run: ./mvnw test
 
@@ -58,7 +55,7 @@ jobs:
         if: always()
         with:
           name: test-results
-          path: server/java-spring/target/surefire-reports/
+          path: mflix/server/java-spring/target/surefire-reports/
           retention-days: 30
 
       - name: Generate Test Summary
@@ -66,4 +63,4 @@ jobs:
         working-directory: .
         run: |
           chmod +x .github/scripts/generate-test-summary-surefire.sh
-          .github/scripts/generate-test-summary-surefire.sh server/java-spring/target/surefire-reports
+          .github/scripts/generate-test-summary-surefire.sh mflix/server/java-spring/target/surefire-reports
diff --git a/.github/workflows/run-python-tests.yml b/.github/workflows/run-python-tests.yml
index 117671a..11b43cc 100644
--- a/.github/workflows/run-python-tests.yml
+++ b/.github/workflows/run-python-tests.yml
@@ -4,9 +4,13 @@ on:
   pull_request_target:
     branches:
       - development
+    paths:
+      - 'mflix/server/python-fastapi/**'
   push:
     branches:
       - development
+    paths:
+      - 'mflix/server/python-fastapi/**'
 
 jobs:
   test:
@@ -17,7 +21,7 @@ jobs:
 
     defaults:
       run:
-        working-directory: server/python
+        working-directory: mflix/server/python-fastapi
 
     steps:
       - name: Checkout code
@@ -54,9 +58,9 @@ jobs:
         with:
           name: test-results
           path: |
-            server/python/test-results-unit.xml
-            server/python/test-results-integration.xml
-            server/python/htmlcov/
+            mflix/server/python-fastapi/test-results-unit.xml
+            mflix/server/python-fastapi/test-results-integration.xml
+            mflix/server/python-fastapi/htmlcov/
           retention-days: 30
 
       - name: Generate Test Summary
@@ -65,5 +69,5 @@ jobs:
         run: |
           chmod +x .github/scripts/generate-test-summary-pytest.sh
           .github/scripts/generate-test-summary-pytest.sh \
-            server/python/test-results-unit.xml \
-            server/python/test-results-integration.xml
+            mflix/server/python-fastapi/test-results-unit.xml \
+            mflix/server/python-fastapi/test-results-integration.xml
diff --git a/mflix/.gitignore-java b/mflix/.gitignore-java
new file mode 100644
index 0000000..9e08a98
--- /dev/null
+++ b/mflix/.gitignore-java
@@ -0,0 +1,113 @@
+#-------
+# Common
+#-------
+
+# Environment variables
+.env
+!.env.example
+*.pem
+
+#MacOS files
+.DS_Store
+
+#---------------------------
+# Java / Spring Boot backend
+#---------------------------
+
+#Cache
+.cache/
+
+# Compiled Files
+*.class
+*.ctxt
+.mtj.tmp/
+
+# Package Files
+*.jar
+*.war
+*.nar
+*.ear
+
+# Crash Logs
+hs_err_pid*
+replay_pid*
+
+# Maven
+target/
+pom.xml.tag
+pom.xml.releaseBackup
+pom.xml.versionsBackup
+pom.xml.next
+release.properties
+dependency-reduced-pom.xml
+buildNumber.properties
+.mvn/timing.properties
+.mvn/wrapper/maven-wrapper.jar
+
+# IntelliJ IDEA
+*.iws
+*.iml
+*.ipr
+out/
+!**/src/main/**/out/
+!**/src/test/**/out/
+
+# Eclipse
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+bin/
+!**/src/main/**/bin/
+!**/src/test/**/bin/
+
+# NetBeans
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+
+# Spring Boot
+spring-boot-devtools.properties
+
+#------------------------
+# Next.js Client frontend
+#------------------------
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+package-lock.json
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
diff --git a/mflix/.gitignore-js b/mflix/.gitignore-js
new file mode 100644
index 0000000..aa54d26
--- /dev/null
+++ b/mflix/.gitignore-js
@@ -0,0 +1,62 @@
+#-------
+# Common
+#-------
+
+# Environment variables
+.env
+!.env.example
+*.pem
+
+#MacOS files
+.DS_Store
+
+# Dependencies
+node_modules/
+package-lock.json
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# TypeScript
+*.tsbuildinfo
+
+# Test coverage
+coverage/
+
+# Logs
+logs
+*.log
+
+#-------------------
+# Express.js Backend
+#-------------------
+
+# Build output
+dist/
+
+# Test results
+test-results.json
+
+# Optional npm cache directory
+.npm
+
+#------------------------
+# Next.js Client frontend
+#------------------------
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# vercel
+.vercel
+
+# typescript
+next-env.d.ts
diff --git a/mflix/.gitignore-python b/mflix/.gitignore-python
new file mode 100644
index 0000000..41f9a7e
--- /dev/null
+++ b/mflix/.gitignore-python
@@ -0,0 +1,52 @@
+#-------
+# Common
+#-------
+
+# Environment variables
+.env
+!.env.example
+*.pem
+
+#MacOS files
+.DS_Store
+
+#-------------------------
+# Python / FastAPI backend
+#-------------------------
+
+# Byte-compiled / optimized files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environment
+.venv/
+
+#------------------------
+# Next.js Client frontend
+#------------------------
+
+# dependencies
+/node_modules
+package-lock.json
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# Logs
+logs
+*.log
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
diff --git a/server/java-spring/.env.example b/mflix/server/java-spring/.env.example
similarity index 76%
rename from server/java-spring/.env.example
rename to mflix/server/java-spring/.env.example
index df7ce44..9efc711 100644
--- a/server/java-spring/.env.example
+++ b/mflix/server/java-spring/.env.example
@@ -2,6 +2,10 @@
 # Replace with your MongoDB Atlas connection string or local MongoDB URI
 MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/?retryWrites=true&w=majority
 
+# Voyage AI Configuration
+# API key for Voyage AI embedding model (required for Vector Search)
+VOYAGE_API_KEY=your_voyage_api_key
+
 # Server Configuration
 # Port on which the Spring Boot application will run
 PORT=3001
diff --git a/server/java-spring/.gitignore b/mflix/server/java-spring/.gitignore
similarity index 100%
rename from server/java-spring/.gitignore
rename to mflix/server/java-spring/.gitignore
diff --git a/server/java-spring/.mvn/wrapper/maven-wrapper.properties b/mflix/server/java-spring/.mvn/wrapper/maven-wrapper.properties
similarity index 100%
rename from server/java-spring/.mvn/wrapper/maven-wrapper.properties
rename to mflix/server/java-spring/.mvn/wrapper/maven-wrapper.properties
diff --git a/server/java-spring/mvnw b/mflix/server/java-spring/mvnw
similarity index 100%
rename from server/java-spring/mvnw
rename to mflix/server/java-spring/mvnw
diff --git a/server/java-spring/mvnw.cmd b/mflix/server/java-spring/mvnw.cmd
similarity index 100%
rename from server/java-spring/mvnw.cmd
rename to mflix/server/java-spring/mvnw.cmd
diff --git a/server/java-spring/pom.xml b/mflix/server/java-spring/pom.xml
similarity index 100%
rename from server/java-spring/pom.xml
rename to mflix/server/java-spring/pom.xml
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/SampleMflixApplication.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/CorsConfig.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/DatabaseVerification.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/MongoConfig.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectIdSerializer.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectIdSerializer.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectIdSerializer.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectIdSerializer.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectMapperConfig.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectMapperConfig.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectMapperConfig.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/ObjectMapperConfig.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/OpenApiConfig.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/OpenApiConfig.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/config/OpenApiConfig.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/OpenApiConfig.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/config/WebMvcConfig.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/WebMvcConfig.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/config/WebMvcConfig.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/config/WebMvcConfig.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/DatabaseOperationException.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/DatabaseOperationException.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/exception/DatabaseOperationException.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/DatabaseOperationException.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/GlobalExceptionHandler.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ResourceNotFoundException.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ResourceNotFoundException.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ResourceNotFoundException.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ResourceNotFoundException.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Movie.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchInsertResponse.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchInsertResponse.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchInsertResponse.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchInsertResponse.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchUpdateResponse.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchUpdateResponse.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchUpdateResponse.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/BatchUpdateResponse.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/CreateMovieRequest.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DeleteResponse.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DeleteResponse.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DeleteResponse.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DeleteResponse.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DirectorStatisticsResult.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DirectorStatisticsResult.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DirectorStatisticsResult.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/DirectorStatisticsResult.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchQuery.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchRequest.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchRequest.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchRequest.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieSearchRequest.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieWithCommentsResult.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieWithCommentsResult.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieWithCommentsResult.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieWithCommentsResult.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MoviesByYearResult.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MoviesByYearResult.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MoviesByYearResult.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MoviesByYearResult.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/SearchMoviesResponse.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/SearchMoviesResponse.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/SearchMoviesResponse.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/SearchMoviesResponse.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/UpdateMovieRequest.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/VectorSearchResult.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/VectorSearchResult.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/VectorSearchResult.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/VectorSearchResult.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ApiResponse.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/ErrorResponse.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/response/SuccessResponse.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/repository/MovieRepository.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
diff --git a/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
similarity index 100%
rename from server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
rename to mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
diff --git a/server/java-spring/src/main/resources/application.properties b/mflix/server/java-spring/src/main/resources/application.properties
similarity index 100%
rename from server/java-spring/src/main/resources/application.properties
rename to mflix/server/java-spring/src/main/resources/application.properties
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java b/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
similarity index 100%
rename from server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
rename to mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MongoDBSearchIntegrationTest.java b/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MongoDBSearchIntegrationTest.java
similarity index 100%
rename from server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MongoDBSearchIntegrationTest.java
rename to mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MongoDBSearchIntegrationTest.java
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java b/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
similarity index 100%
rename from server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
rename to mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md b/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
similarity index 100%
rename from server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
rename to mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
diff --git a/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java b/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
similarity index 100%
rename from server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
rename to mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
diff --git a/server/java-spring/src/test/resources/application-test.properties b/mflix/server/java-spring/src/test/resources/application-test.properties
similarity index 100%
rename from server/java-spring/src/test/resources/application-test.properties
rename to mflix/server/java-spring/src/test/resources/application-test.properties
diff --git a/server/python/.env.example b/mflix/server/python-fastapi/.env.example
similarity index 62%
rename from server/python/.env.example
rename to mflix/server/python-fastapi/.env.example
index 363a620..7303405 100644
--- a/server/python/.env.example
+++ b/mflix/server/python-fastapi/.env.example
@@ -2,6 +2,10 @@
 MONGO_URI="mongodb://localhost:27017"
 MONGO_DB="sample_mflix"
 
+# Voyage AI Configuration
+# API key for Voyage AI embedding model (required for Vector Search)
+VOYAGE_API_KEY=your_voyage_api_key
+
 # CORS Configuration
 # Comma-separated list of allowed origins for CORS
 CORS_ORIGINS="http://localhost:3000,http://localhost:3001"
\ No newline at end of file
diff --git a/server/python/.gitignore b/mflix/server/python-fastapi/.gitignore
similarity index 100%
rename from server/python/.gitignore
rename to mflix/server/python-fastapi/.gitignore
diff --git a/server/python/README.md b/mflix/server/python-fastapi/README_OLD_REMOVE_ME.md
similarity index 100%
rename from server/python/README.md
rename to mflix/server/python-fastapi/README_OLD_REMOVE_ME.md
diff --git a/server/python/main.py b/mflix/server/python-fastapi/main.py
similarity index 100%
rename from server/python/main.py
rename to mflix/server/python-fastapi/main.py
diff --git a/server/python/pytest.ini b/mflix/server/python-fastapi/pytest.ini
similarity index 100%
rename from server/python/pytest.ini
rename to mflix/server/python-fastapi/pytest.ini
diff --git a/server/python/requirements.in b/mflix/server/python-fastapi/requirements.in
similarity index 100%
rename from server/python/requirements.in
rename to mflix/server/python-fastapi/requirements.in
diff --git a/server/python/requirements.txt b/mflix/server/python-fastapi/requirements.txt
similarity index 100%
rename from server/python/requirements.txt
rename to mflix/server/python-fastapi/requirements.txt
diff --git a/server/python/src/database/mongo_client.py b/mflix/server/python-fastapi/src/database/mongo_client.py
similarity index 100%
rename from server/python/src/database/mongo_client.py
rename to mflix/server/python-fastapi/src/database/mongo_client.py
diff --git a/server/python/src/models/models.py b/mflix/server/python-fastapi/src/models/models.py
similarity index 100%
rename from server/python/src/models/models.py
rename to mflix/server/python-fastapi/src/models/models.py
diff --git a/server/python/src/routers/movies.py b/mflix/server/python-fastapi/src/routers/movies.py
similarity index 100%
rename from server/python/src/routers/movies.py
rename to mflix/server/python-fastapi/src/routers/movies.py
diff --git a/server/python/src/utils/errorHandler.py b/mflix/server/python-fastapi/src/utils/errorHandler.py
similarity index 100%
rename from server/python/src/utils/errorHandler.py
rename to mflix/server/python-fastapi/src/utils/errorHandler.py
diff --git a/server/python/tests/README.md b/mflix/server/python-fastapi/tests/README.md
similarity index 100%
rename from server/python/tests/README.md
rename to mflix/server/python-fastapi/tests/README.md
diff --git a/server/python/tests/__init__.py b/mflix/server/python-fastapi/tests/__init__.py
similarity index 100%
rename from server/python/tests/__init__.py
rename to mflix/server/python-fastapi/tests/__init__.py
diff --git a/server/python/tests/conftest.py b/mflix/server/python-fastapi/tests/conftest.py
similarity index 100%
rename from server/python/tests/conftest.py
rename to mflix/server/python-fastapi/tests/conftest.py
diff --git a/server/python/tests/integration/__init__.py b/mflix/server/python-fastapi/tests/integration/__init__.py
similarity index 100%
rename from server/python/tests/integration/__init__.py
rename to mflix/server/python-fastapi/tests/integration/__init__.py
diff --git a/server/python/tests/integration/conftest.py b/mflix/server/python-fastapi/tests/integration/conftest.py
similarity index 100%
rename from server/python/tests/integration/conftest.py
rename to mflix/server/python-fastapi/tests/integration/conftest.py
diff --git a/server/python/tests/integration/test_movie_routes_integration.py b/mflix/server/python-fastapi/tests/integration/test_movie_routes_integration.py
similarity index 100%
rename from server/python/tests/integration/test_movie_routes_integration.py
rename to mflix/server/python-fastapi/tests/integration/test_movie_routes_integration.py
diff --git a/server/python/tests/test_movie_routes.py b/mflix/server/python-fastapi/tests/test_movie_routes.py
similarity index 100%
rename from server/python/tests/test_movie_routes.py
rename to mflix/server/python-fastapi/tests/test_movie_routes.py
diff --git a/server/python/tests/test_movie_schemas.py b/mflix/server/python-fastapi/tests/test_movie_schemas.py
similarity index 100%
rename from server/python/tests/test_movie_schemas.py
rename to mflix/server/python-fastapi/tests/test_movie_schemas.py

From 24b407a46e2a7a680154963874db2440b549427a Mon Sep 17 00:00:00 2001
From: Jordan Smith <jordan.smith@mongodb.com>
Date: Thu, 6 Nov 2025 20:38:05 -0500
Subject: [PATCH 088/110] Dachary feedback

---
 client/app/lib/api.ts                         |   2 +-
 .../src/controllers/movieController.ts        | 123 +-----------------
 server/express/src/routes/movies.ts           |  20 +--
 server/express/src/types/index.ts             |   5 +-
 .../tests/controllers/movieController.test.ts | 120 +----------------
 5 files changed, 17 insertions(+), 253 deletions(-)

diff --git a/client/app/lib/api.ts b/client/app/lib/api.ts
index e8417e2..4ec0f96 100644
--- a/client/app/lib/api.ts
+++ b/client/app/lib/api.ts
@@ -410,7 +410,7 @@ export async function fetchMoviesWithComments(
     const queryParams = new URLSearchParams();
     queryParams.append('limit', limit.toString());
     if (movieId) {
-      queryParams.append('movie_id', movieId);
+      queryParams.append('movieId', movieId);
     }
 
     console.log(`Fetching comments from: ${API_BASE_URL}/api/movies/aggregations/reportingByComments?${queryParams}`);
diff --git a/server/express/src/controllers/movieController.ts b/server/express/src/controllers/movieController.ts
index 1d65924..14269dc 100644
--- a/server/express/src/controllers/movieController.ts
+++ b/server/express/src/controllers/movieController.ts
@@ -719,8 +719,8 @@ export async function vectorSearchMovies(req: Request, res: Response): Promise<v
     return;
   }
 
-  // Validate and set limit (default: 10, min: 1, max: 50)
-  const limitNum = Math.min(Math.max(parseInt(limit as string) || 10, 1), 50);
+  // Validate and set limit (default: 20, min: 1, max: 50)
+  const limitNum = Math.min(Math.max(parseInt(limit as string) || 20, 1), 50);
 
   try {
     // Generate embedding using Voyage AI REST API
@@ -736,7 +736,7 @@ export async function vectorSearchMovies(req: Request, res: Response): Promise<v
           index: "vector_index",
           path: "plot_embedding_voyage_3_large",
           queryVector: queryVector,
-          numCandidates: limitNum * 15, // Search more candidates for better results
+          numCandidates: limitNum * 20, // We recommend searching 20 times higher than the limit to improve result relevance
           limit: limitNum,
         },
       },
@@ -847,121 +847,6 @@ export async function vectorSearchMovies(req: Request, res: Response): Promise<v
   }
 }
 
-/**
- * GET /api/movies/find-similar-movies
- *
- * Find similar movies using vector search based on a movie ID.
- * Demonstrates finding semantically similar movies using plot embeddings.
- */
-export async function findSimilarMovies(req: Request, res: Response): Promise<void> {
-  const { movieId, limit = "10" } = req.query;
-
-  // Validate movieId parameter
-  if (!movieId || typeof movieId !== "string") {
-    res
-      .status(400)
-      .json(
-        createErrorResponse(
-          "Query parameter 'movieId' is required",
-          "MISSING_MOVIE_ID"
-        )
-      );
-    return;
-  }
-
-  if (!ObjectId.isValid(movieId)) {
-    res
-      .status(400)
-      .json(
-        createErrorResponse("Invalid movie ID format", "INVALID_OBJECT_ID")
-      );
-    return;
-  }
-
-  // Validate and set limit (default: 10, min: 1, max: 50)
-  const limitNum = Math.min(Math.max(parseInt(limit as string) || 10, 1), 50);
-
-  try {
-    const embeddedMoviesCollection = getCollection("embedded_movies");
-
-    // First, get the target movie's embedding
-    const targetMovie = await embeddedMoviesCollection.findOne({
-      _id: new ObjectId(movieId),
-    });
-
-    if (!targetMovie) {
-      res
-        .status(404)
-        .json(createErrorResponse("Movie not found", "MOVIE_NOT_FOUND"));
-      return;
-    }
-
-    if (!targetMovie.plot_embedding_voyage_3_large) {
-      res
-        .status(400)
-        .json(
-          createErrorResponse(
-            "Movie does not have embedding data",
-            "NO_EMBEDDING_DATA"
-          )
-        );
-      return;
-    }
-
-    // Use the target movie's embedding to find similar movies
-    const pipeline = [
-      {
-        $vectorSearch: {
-          index: "vector_index",
-          path: "plot_embedding_voyage_3_large",
-          queryVector: targetMovie.plot_embedding_voyage_3_large,
-          numCandidates: (limitNum + 1) * 15, // +1 to account for self-match
-          limit: limitNum + 1, // +1 to exclude self from results
-        },
-      },
-      {
-        $match: {
-          _id: { $ne: new ObjectId(movieId) }, // Exclude the original movie
-        },
-      },
-      {
-        $limit: limitNum,
-      },
-      {
-        $project: {
-          _id: 1,
-          title: 1,
-          year: 1,
-          plot: 1,
-          fullplot: 1,
-          genres: 1,
-          directors: 1,
-          cast: 1,
-          poster: 1,
-          imdb: 1,
-        },
-      },
-    ];
-
-    const results = await embeddedMoviesCollection.aggregate(pipeline).toArray();
-
-    res.json(
-      createSuccessResponse(results, `Found ${results.length} similar movies`)
-    );
-  } catch (error) {
-    console.error("Find similar movies error:", error);
-    res
-      .status(500)
-      .json(
-        createErrorResponse(
-          "Failed to find similar movies",
-          "SIMILAR_MOVIES_ERROR",
-          error instanceof Error ? error.message : "Unknown error"
-        )
-      );
-  }
-}
-
 /**
  * GET /api/movies/aggregations/comments
  *
@@ -1079,7 +964,7 @@ export async function getMoviesWithMostRecentComments(
     title: result.title,
     year: result.year,
     genres: result.genres,
-    imdb: result.imdbRating ? { rating: result.imdbRating } : undefined,
+    imdbRating: result.imdbRating,
     recentComments: result.recentComments.map((comment: AggregationComment) => ({
       _id: comment._id?.toString(),
       userName: comment.userName,
diff --git a/server/express/src/routes/movies.ts b/server/express/src/routes/movies.ts
index 4731537..5d6d6ac 100644
--- a/server/express/src/routes/movies.ts
+++ b/server/express/src/routes/movies.ts
@@ -46,36 +46,28 @@ router.get("/search", asyncHandler(movieController.searchMovies));
 router.get("/vector-search", asyncHandler(movieController.vectorSearchMovies));
 
 /**
- * GET /api/movies/find-similar-movies
- *
- * Find similar movies using vector search based on a movie ID.
- * Demonstrates finding semantically similar movies using plot embeddings.
- */
-router.get("/find-similar-movies", asyncHandler(movieController.findSimilarMovies));
-
-/**
- * GET /api/movies/aggregations/comments
+ * GET /api/movies/aggregations/reportingByComments
  *
  * Aggregate movies with their most recent comments.
  * Demonstrates MongoDB $lookup aggregation to join collections.
  */
-router.get("/aggregations/comments", asyncHandler(movieController.getMoviesWithMostRecentComments));
+router.get("/aggregations/reportingByComments", asyncHandler(movieController.getMoviesWithMostRecentComments));
 
 /**
- * GET /api/movies/aggregations/years
+ * GET /api/movies/aggregations/reportingByYear
  *
  * Aggregate movies by year with statistics.
  * Demonstrates MongoDB $group aggregation for statistical calculations.
  */
-router.get("/aggregations/years", asyncHandler(movieController.getMoviesByYearWithStats));
+router.get("/aggregations/reportingByYear", asyncHandler(movieController.getMoviesByYearWithStats));
 
 /**
- * GET /api/movies/aggregations/directors
+ * GET /api/movies/aggregations/reportingByDirectors
  *
  * Aggregate directors with the most movies.
  * Demonstrates MongoDB $unwind and $group for array aggregation.
  */
-router.get("/aggregations/directors", asyncHandler(movieController.getDirectorsWithMostMovies));
+router.get("/aggregations/reportingByDirectors", asyncHandler(movieController.getDirectorsWithMostMovies));
 
 /**
  * GET /api/movies/:id
diff --git a/server/express/src/types/index.ts b/server/express/src/types/index.ts
index 6305156..5515c75 100644
--- a/server/express/src/types/index.ts
+++ b/server/express/src/types/index.ts
@@ -232,10 +232,7 @@ export interface MovieWithCommentsResult {
   plot?: string;
   poster?: string;
   genres?: string[];
-  imdb?: {
-    rating?: number;
-    votes?: number;
-  };
+  imdbRating?: number;
   recentComments: CommentInfo[];
   totalComments: number;
   mostRecentCommentDate?: Date;
diff --git a/server/express/tests/controllers/movieController.test.ts b/server/express/tests/controllers/movieController.test.ts
index bc9ad4f..e0928e9 100644
--- a/server/express/tests/controllers/movieController.test.ts
+++ b/server/express/tests/controllers/movieController.test.ts
@@ -117,7 +117,6 @@ import {
   findAndDeleteMovie,
   searchMovies,
   vectorSearchMovies,
-  findSimilarMovies,
   getMoviesWithMostRecentComments,
   getMoviesByYearWithStats,
   getDirectorsWithMostMovies,
@@ -922,123 +921,14 @@ describe("Movie Controller Tests", () => {
     });
   });
 
-  describe("findSimilarMovies", () => {
+  // ==================== AGGREGATION ENDPOINTS TESTS ====================
+
+  describe("getMoviesWithMostRecentComments", () => {
     beforeEach(() => {
-      // Reset mocks specifically for findSimilarMovies tests
+      // Reset mocks for aggregation tests to avoid interference from vector search tests
       mockToArray.mockReset();
     });
 
-    it("should successfully find similar movies", async () => {
-      const targetMovie = {
-        _id: new ObjectId(TEST_MOVIE_ID),
-        title: "Target Movie",
-        plot_embedding_voyage_3_large: new Array(2048).fill(0.1),
-      };
-
-      mockRequest.query = { movieId: TEST_MOVIE_ID, limit: "5" };
-      mockFindOne.mockResolvedValue(targetMovie);
-      mockToArray.mockResolvedValue(SAMPLE_SEARCH_RESULTS);
-
-      await findSimilarMovies(mockRequest as Request, mockResponse as Response);
-
-      expect(mockGetCollection).toHaveBeenCalledWith("embedded_movies");
-      expect(mockFindOne).toHaveBeenCalledWith({
-        _id: new ObjectId(TEST_MOVIE_ID),
-      });
-      expect(mockAggregate).toHaveBeenCalled();
-      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
-        SAMPLE_SEARCH_RESULTS,
-        "Found 2 similar movies"
-      );
-    });
-
-    it("should return 400 when movieId is missing", async () => {
-      mockRequest.query = {};
-
-      await findSimilarMovies(mockRequest as Request, mockResponse as Response);
-
-      expectErrorResponse(
-        mockStatus,
-        mockJson,
-        400,
-        "Query parameter 'movieId' is required",
-        "MISSING_MOVIE_ID"
-      );
-    });
-
-    it("should return 400 for invalid movieId format", async () => {
-      mockRequest.query = { movieId: INVALID_MOVIE_ID };
-
-      await findSimilarMovies(mockRequest as Request, mockResponse as Response);
-
-      expectErrorResponse(
-        mockStatus,
-        mockJson,
-        400,
-        "Invalid movie ID format",
-        "INVALID_OBJECT_ID"
-      );
-    });
-
-    it("should return 404 when movie not found", async () => {
-      mockRequest.query = { movieId: TEST_MOVIE_ID };
-      mockFindOne.mockResolvedValue(null);
-
-      await findSimilarMovies(mockRequest as Request, mockResponse as Response);
-
-      expectErrorResponse(
-        mockStatus,
-        mockJson,
-        404,
-        "Movie not found",
-        "MOVIE_NOT_FOUND"
-      );
-    });
-
-    it("should return 400 when movie has no embedding data", async () => {
-      const targetMovie = {
-        _id: new ObjectId(TEST_MOVIE_ID),
-        title: "Target Movie",
-        // No plot_embedding_voyage_3_large field
-      };
-
-      mockRequest.query = { movieId: TEST_MOVIE_ID };
-      mockFindOne.mockResolvedValue(targetMovie);
-
-      await findSimilarMovies(mockRequest as Request, mockResponse as Response);
-
-      expectErrorResponse(
-        mockStatus,
-        mockJson,
-        400,
-        "Movie does not have embedding data",
-        "NO_EMBEDDING_DATA"
-      );
-    });
-
-    it("should use default limit when not provided", async () => {
-      const targetMovie = {
-        _id: new ObjectId(TEST_MOVIE_ID),
-        title: "Target Movie",
-        plot_embedding_voyage_3_large: new Array(2048).fill(0.1),
-      };
-
-      mockRequest.query = { movieId: TEST_MOVIE_ID };
-      mockFindOne.mockResolvedValue(targetMovie);
-      mockToArray.mockResolvedValue([]);
-
-      await findSimilarMovies(mockRequest as Request, mockResponse as Response);
-
-      expect(mockCreateSuccessResponse).toHaveBeenCalledWith(
-        [],
-        "Found 0 similar movies"
-      );
-    });
-  });
-
-  // ==================== AGGREGATION ENDPOINTS TESTS ====================
-
-  describe("getMoviesWithMostRecentComments", () => {
     it("should successfully get movies with comments", async () => {
       mockRequest.query = { limit: "10" };
       mockToArray.mockResolvedValue(SAMPLE_COMMENTS_AGGREGATION);
@@ -1056,7 +946,7 @@ describe("Movie Controller Tests", () => {
         title: result.title,
         year: result.year,
         genres: result.genres,
-        imdb: result.imdbRating ? { rating: result.imdbRating } : undefined,
+        imdbRating: result.imdbRating,
         recentComments: result.recentComments.map((comment) => ({
           _id: comment._id?.toString(),
           userName: comment.userName,

From de6d8896cb31b5564fcbaaf18f63b14a8e440e8d Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 15:54:02 -0500
Subject: [PATCH 089/110] Express: Add Swagger API docs

---
 server/express/package.json          |   6 +-
 server/express/src/app.ts            |  42 ++-
 server/express/src/config/swagger.ts | 354 ++++++++++++++++++++
 server/express/src/routes/movies.ts  | 462 +++++++++++++++++++++++++--
 4 files changed, 830 insertions(+), 34 deletions(-)
 create mode 100644 server/express/src/config/swagger.ts

diff --git a/server/express/package.json b/server/express/package.json
index c067a31..b776f78 100644
--- a/server/express/package.json
+++ b/server/express/package.json
@@ -21,13 +21,17 @@
     "cors": "^2.8.5",
     "dotenv": "^17.2.3",
     "express": "^5.1.0",
-    "mongodb": "^6.20.0"
+    "mongodb": "^6.20.0",
+    "swagger-jsdoc": "^6.2.8",
+    "swagger-ui-express": "^5.0.1"
   },
   "devDependencies": {
     "@types/cors": "^2.8.17",
     "@types/express": "^4.17.21",
     "@types/jest": "^29.5.14",
     "@types/node": "^20.10.5",
+    "@types/swagger-jsdoc": "^6.0.4",
+    "@types/swagger-ui-express": "^4.1.8",
     "jest": "^29.7.0",
     "ts-jest": "^29.1.1",
     "ts-node": "^10.9.2",
diff --git a/server/express/src/app.ts b/server/express/src/app.ts
index 571ffd4..1d4898f 100644
--- a/server/express/src/app.ts
+++ b/server/express/src/app.ts
@@ -9,6 +9,7 @@
 import express from "express";
 import cors from "cors";
 import dotenv from "dotenv";
+import swaggerUi from "swagger-ui-express";
 import {
   closeDatabaseConnection,
   connectToDatabase,
@@ -16,6 +17,7 @@ import {
 } from "./config/database";
 import { errorHandler } from "./utils/errorHandler";
 import moviesRouter from "./routes/movies";
+import { swaggerSpec } from "./config/swagger";
 
 // Load environment variables from .env file
 // This must be called before any other imports that use environment variables
@@ -44,6 +46,12 @@ app.use(
 app.use(express.json({ limit: "10mb" }));
 app.use(express.urlencoded({ extended: true, limit: "10mb" }));
 
+/**
+ * Swagger API Documentation
+ * Provides interactive API documentation at /api-docs
+ */
+app.use("/api-docs", swaggerUi.serve, swaggerUi.setup(swaggerSpec));
+
 /**
  * API Routes
  * All movie-related CRUD operations are handled by the movies router
@@ -53,6 +61,37 @@ app.use("/api/movies", moviesRouter);
 /**
  * Root Endpoint
  * Provides basic information about the API
+ * @swagger
+ * /:
+ *   get:
+ *     summary: Get API information
+ *     description: Returns basic information about the API and available endpoints
+ *     tags: [Info]
+ *     responses:
+ *       200:
+ *         description: API information
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 name:
+ *                   type: string
+ *                   example: MongoDB Sample MFlix API
+ *                 version:
+ *                   type: string
+ *                   example: 1.0.0
+ *                 description:
+ *                   type: string
+ *                 endpoints:
+ *                   type: object
+ *                   properties:
+ *                     movies:
+ *                       type: string
+ *                       example: /api/movies
+ *                     documentation:
+ *                       type: string
+ *                       example: /api-docs
  */
 app.get("/", (req, res) => {
   res.json({
@@ -62,6 +101,7 @@ app.get("/", (req, res) => {
       "Express.js backend demonstrating MongoDB operations with the sample_mflix dataset",
     endpoints: {
       movies: "/api/movies",
+      documentation: "/api-docs",
     },
   });
 });
@@ -94,7 +134,7 @@ async function startServer() {
     // Start the Express server
     app.listen(PORT, () => {
       console.log(`Server running on port ${PORT}`);
-      console.log(`API documentation available at http://localhost:${PORT}`);
+      console.log(`API documentation available at http://localhost:${PORT}/api-docs`);
     });
   } catch (error) {
     console.error("Failed to start server:", error);
diff --git a/server/express/src/config/swagger.ts b/server/express/src/config/swagger.ts
new file mode 100644
index 0000000..3002da9
--- /dev/null
+++ b/server/express/src/config/swagger.ts
@@ -0,0 +1,354 @@
+/**
+ * Swagger/OpenAPI Configuration
+ *
+ * This module configures swagger-jsdoc to generate OpenAPI documentation
+ * from JSDoc comments in the codebase.
+ */
+
+import swaggerJsdoc from "swagger-jsdoc";
+
+const options: swaggerJsdoc.Options = {
+  definition: {
+    openapi: "3.0.0",
+    info: {
+      title: "MongoDB Sample MFlix API",
+      version: "1.0.0",
+      description:
+        "Express.js backend demonstrating MongoDB operations with the sample_mflix dataset. " +
+        "This API provides CRUD operations for movies, including text search, filtering, pagination, and batch operations.",
+      contact: {
+        name: "API Support",
+      },
+      license: {
+        name: "Apache 2.0",
+        url: "https://www.apache.org/licenses/LICENSE-2.0.html",
+      },
+    },
+    servers: [
+      {
+        url: "http://localhost:3001",
+        description: "Development server",
+      },
+    ],
+    tags: [
+      {
+        name: "Movies",
+        description: "Movie CRUD operations and queries",
+      },
+      {
+        name: "Info",
+        description: "API information",
+      },
+    ],
+    components: {
+      schemas: {
+        Movie: {
+          type: "object",
+          required: ["title"],
+          properties: {
+            _id: {
+              type: "string",
+              description: "MongoDB ObjectId",
+              example: "573a1390f29313caabcd4135",
+            },
+            title: {
+              type: "string",
+              description: "Movie title",
+              example: "The Shawshank Redemption",
+            },
+            year: {
+              type: "integer",
+              description: "Release year",
+              example: 1994,
+            },
+            plot: {
+              type: "string",
+              description: "Short plot summary",
+              example: "Two imprisoned men bond over a number of years...",
+            },
+            fullplot: {
+              type: "string",
+              description: "Full plot description",
+            },
+            runtime: {
+              type: "integer",
+              description: "Runtime in minutes",
+              example: 142,
+            },
+            poster: {
+              type: "string",
+              description: "URL to movie poster",
+            },
+            genres: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+              description: "Movie genres",
+              example: ["Drama"],
+            },
+            directors: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+              description: "Movie directors",
+              example: ["Frank Darabont"],
+            },
+            writers: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+              description: "Movie writers",
+            },
+            cast: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+              description: "Movie cast",
+              example: ["Tim Robbins", "Morgan Freeman"],
+            },
+            countries: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+              description: "Countries of origin",
+              example: ["USA"],
+            },
+            languages: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+              description: "Languages",
+              example: ["English"],
+            },
+            rated: {
+              type: "string",
+              description: "MPAA rating",
+              example: "R",
+            },
+            awards: {
+              type: "object",
+              properties: {
+                wins: {
+                  type: "integer",
+                  example: 21,
+                },
+                nominations: {
+                  type: "integer",
+                  example: 42,
+                },
+                text: {
+                  type: "string",
+                  example: "Nominated for 7 Oscars. Another 21 wins & 42 nominations.",
+                },
+              },
+            },
+            imdb: {
+              type: "object",
+              properties: {
+                rating: {
+                  type: "number",
+                  format: "float",
+                  example: 9.3,
+                },
+                votes: {
+                  type: "integer",
+                  example: 2343110,
+                },
+                id: {
+                  type: "integer",
+                  example: 111161,
+                },
+              },
+            },
+            tomatoes: {
+              type: "object",
+              properties: {
+                viewer: {
+                  type: "object",
+                  properties: {
+                    rating: {
+                      type: "number",
+                      format: "float",
+                    },
+                    numReviews: {
+                      type: "integer",
+                    },
+                    meter: {
+                      type: "integer",
+                    },
+                  },
+                },
+                critic: {
+                  type: "object",
+                  properties: {
+                    rating: {
+                      type: "number",
+                      format: "float",
+                    },
+                    numReviews: {
+                      type: "integer",
+                    },
+                    meter: {
+                      type: "integer",
+                    },
+                  },
+                },
+              },
+            },
+            metacritic: {
+              type: "integer",
+              example: 80,
+            },
+            type: {
+              type: "string",
+              example: "movie",
+            },
+          },
+        },
+        CreateMovieRequest: {
+          type: "object",
+          required: ["title"],
+          properties: {
+            title: {
+              type: "string",
+              description: "Movie title (required)",
+              example: "My New Movie",
+            },
+            year: {
+              type: "integer",
+              example: 2024,
+            },
+            plot: {
+              type: "string",
+              example: "An exciting new film...",
+            },
+            fullplot: {
+              type: "string",
+            },
+            genres: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+              example: ["Action", "Adventure"],
+            },
+            directors: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+              example: ["Jane Director"],
+            },
+            writers: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+            },
+            cast: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+            },
+            countries: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+            },
+            languages: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+            },
+            rated: {
+              type: "string",
+            },
+            runtime: {
+              type: "integer",
+            },
+            poster: {
+              type: "string",
+            },
+          },
+        },
+        UpdateMovieRequest: {
+          type: "object",
+          properties: {
+            title: {
+              type: "string",
+            },
+            year: {
+              type: "integer",
+            },
+            plot: {
+              type: "string",
+            },
+            genres: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+            },
+          },
+          description: "All fields are optional for partial updates",
+        },
+        SuccessResponse: {
+          type: "object",
+          properties: {
+            success: {
+              type: "boolean",
+              example: true,
+            },
+            message: {
+              type: "string",
+              example: "Operation completed successfully",
+            },
+            data: {
+              type: "object",
+              description: "Response data (varies by endpoint)",
+            },
+          },
+        },
+        ErrorResponse: {
+          type: "object",
+          properties: {
+            success: {
+              type: "boolean",
+              example: false,
+            },
+            error: {
+              type: "object",
+              properties: {
+                message: {
+                  type: "string",
+                  example: "An error occurred",
+                },
+                code: {
+                  type: "string",
+                  example: "ERROR_CODE",
+                },
+                details: {
+                  type: "string",
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+  // Path to the API routes files where JSDoc comments are located
+  apis: ["./src/routes/*.ts", "./src/app.ts"],
+};
+
+export const swaggerSpec = swaggerJsdoc(options);
+
diff --git a/server/express/src/routes/movies.ts b/server/express/src/routes/movies.ts
index 5d6d6ac..a265095 100644
--- a/server/express/src/routes/movies.ts
+++ b/server/express/src/routes/movies.ts
@@ -22,10 +22,99 @@ import * as movieController from "../controllers/movieController";
 const router = express.Router();
 
 /**
- * GET /api/movies
- *
- * Retrieves multiple movies with optional filtering, sorting, and pagination.
- * Demonstrates the find() operation with various query options.
+ * @swagger
+ * /api/movies:
+ *   get:
+ *     summary: Get all movies
+ *     description: Retrieves multiple movies with optional filtering, sorting, and pagination. Demonstrates the MongoDB find() operation.
+ *     tags: [Movies]
+ *     parameters:
+ *       - in: query
+ *         name: q
+ *         schema:
+ *           type: string
+ *         description: Text search query (searches title, plot, fullplot)
+ *         example: shawshank
+ *       - in: query
+ *         name: genre
+ *         schema:
+ *           type: string
+ *         description: Filter by genre
+ *         example: Drama
+ *       - in: query
+ *         name: year
+ *         schema:
+ *           type: integer
+ *         description: Filter by year
+ *         example: 1994
+ *       - in: query
+ *         name: minRating
+ *         schema:
+ *           type: number
+ *         description: Minimum IMDB rating
+ *         example: 8.0
+ *       - in: query
+ *         name: maxRating
+ *         schema:
+ *           type: number
+ *         description: Maximum IMDB rating
+ *         example: 10.0
+ *       - in: query
+ *         name: limit
+ *         schema:
+ *           type: integer
+ *           default: 20
+ *           maximum: 100
+ *         description: Number of results to return
+ *       - in: query
+ *         name: skip
+ *         schema:
+ *           type: integer
+ *           default: 0
+ *         description: Number of documents to skip for pagination
+ *       - in: query
+ *         name: sortBy
+ *         schema:
+ *           type: string
+ *           default: title
+ *         description: Field to sort by
+ *         example: year
+ *       - in: query
+ *         name: sortOrder
+ *         schema:
+ *           type: string
+ *           enum: [asc, desc]
+ *           default: asc
+ *         description: Sort direction
+ *     responses:
+ *       200:
+ *         description: List of movies
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       type: object
+ *                       properties:
+ *                         movies:
+ *                           type: array
+ *                           items:
+ *                             $ref: '#/components/schemas/Movie'
+ *                         count:
+ *                           type: integer
+ *                         limit:
+ *                           type: integer
+ *                         skip:
+ *                           type: integer
+ *       400:
+ *         description: Bad request
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
  */
 router.get("/", asyncHandler(movieController.getAllMovies));
 
@@ -74,46 +163,281 @@ router.get("/aggregations/reportingByDirectors", asyncHandler(movieController.ge
  *
  * Retrieves a single movie by its ObjectId.
  * Demonstrates the findOne() operation.
+ * @swagger
+ * /api/movies/{id}:
+ *   get:
+ *     summary: Get a movie by ID
+ *     description: Retrieves a single movie by its MongoDB ObjectId. Demonstrates the findOne() operation.
+ *     tags: [Movies]
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema:
+ *           type: string
+ *         description: MongoDB ObjectId of the movie
+ *         example: 573a1390f29313caabcd4135
+ *     responses:
+ *       200:
+ *         description: Movie found
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       $ref: '#/components/schemas/Movie'
+ *       400:
+ *         description: Invalid ObjectId format
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
+ *       404:
+ *         description: Movie not found
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
  */
 router.get("/:id", asyncHandler(movieController.getMovieById));
 
 /**
- * POST /api/movies
- *
- * Creates a single new movie document.
- * Demonstrates the insertOne() operation.
+ * @swagger
+ * /api/movies:
+ *   post:
+ *     summary: Create a new movie
+ *     description: Creates a single new movie document. Demonstrates the MongoDB insertOne() operation.
+ *     tags: [Movies]
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             $ref: '#/components/schemas/CreateMovieRequest'
+ *     responses:
+ *       201:
+ *         description: Movie created successfully
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       type: object
+ *                       properties:
+ *                         insertedId:
+ *                           type: string
+ *                           description: MongoDB ObjectId of the created movie
+ *       400:
+ *         description: Validation error
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
  */
 router.post("/", asyncHandler(movieController.createMovie));
 
 /**
- * POST /api/movies/batch
- *
- * Creates multiple movie documents in a single operation.
- * Demonstrates the insertMany() operation.
+ * @swagger
+ * /api/movies/batch:
+ *   post:
+ *     summary: Create multiple movies
+ *     description: Creates multiple movie documents in a single operation. Demonstrates the MongoDB insertMany() operation.
+ *     tags: [Movies]
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: array
+ *             items:
+ *               $ref: '#/components/schemas/CreateMovieRequest'
+ *           example:
+ *             - title: "Movie One"
+ *               year: 2024
+ *               genres: ["Action"]
+ *             - title: "Movie Two"
+ *               year: 2024
+ *               genres: ["Drama"]
+ *     responses:
+ *       201:
+ *         description: Movies created successfully
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       type: object
+ *                       properties:
+ *                         insertedCount:
+ *                           type: integer
+ *                         insertedIds:
+ *                           type: object
+ *       400:
+ *         description: Validation error
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
  */
 router.post("/batch", asyncHandler(movieController.createMoviesBatch));
 
 /**
- * PATCH /api/movies/:id
- *
- * Updates a single movie document.
- * Demonstrates the updateOne() operation.
+ * @swagger
+ * /api/movies/{id}:
+ *   patch:
+ *     summary: Update a movie
+ *     description: Updates a single movie document by ID. Demonstrates the MongoDB updateOne() operation.
+ *     tags: [Movies]
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema:
+ *           type: string
+ *         description: MongoDB ObjectId of the movie
+ *         example: 573a1390f29313caabcd4135
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             $ref: '#/components/schemas/UpdateMovieRequest'
+ *           example:
+ *             title: "Updated Movie Title"
+ *             year: 2024
+ *     responses:
+ *       200:
+ *         description: Movie updated successfully
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       type: object
+ *                       properties:
+ *                         matchedCount:
+ *                           type: integer
+ *                         modifiedCount:
+ *                           type: integer
+ *       400:
+ *         description: Invalid ObjectId or validation error
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
+ *       404:
+ *         description: Movie not found
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
  */
 router.patch("/:id", asyncHandler(movieController.updateMovie));
 
 /**
- * PATCH /api/movies
- *
- * Updates multiple movies based on a filter.
- * Demonstrates the updateMany() operation.
+ * @swagger
+ * /api/movies:
+ *   patch:
+ *     summary: Update multiple movies
+ *     description: Updates multiple movies based on a filter. Demonstrates the MongoDB updateMany() operation.
+ *     tags: [Movies]
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             required:
+ *               - filter
+ *               - update
+ *             properties:
+ *               filter:
+ *                 type: object
+ *                 description: MongoDB filter criteria
+ *                 example:
+ *                   year: 1994
+ *               update:
+ *                 type: object
+ *                 description: Fields to update
+ *                 example:
+ *                   rated: "PG-13"
+ *     responses:
+ *       200:
+ *         description: Movies updated successfully
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       type: object
+ *                       properties:
+ *                         matchedCount:
+ *                           type: integer
+ *                         modifiedCount:
+ *                           type: integer
+ *       400:
+ *         description: Validation error
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
  */
 router.patch("/", asyncHandler(movieController.updateMoviesBatch));
 
 /**
- * DELETE /api/movies/:id/find-and-delete
- *
- * Finds and deletes a movie in a single atomic operation.
- * Demonstrates the findOneAndDelete() operation.
+ * @swagger
+ * /api/movies/{id}/find-and-delete:
+ *   delete:
+ *     summary: Find and delete a movie
+ *     description: Finds and deletes a movie in a single atomic operation. Demonstrates the MongoDB findOneAndDelete() operation.
+ *     tags: [Movies]
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema:
+ *           type: string
+ *         description: MongoDB ObjectId of the movie
+ *         example: 573a1390f29313caabcd4135
+ *     responses:
+ *       200:
+ *         description: Movie found and deleted
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       $ref: '#/components/schemas/Movie'
+ *       400:
+ *         description: Invalid ObjectId format
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
+ *       404:
+ *         description: Movie not found
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
  */
 router.delete(
   "/:id/find-and-delete",
@@ -121,18 +445,92 @@ router.delete(
 );
 
 /**
- * DELETE /api/movies/:id
- *
- * Deletes a single movie document.
- * Demonstrates the deleteOne() operation.
+ * @swagger
+ * /api/movies/{id}:
+ *   delete:
+ *     summary: Delete a movie
+ *     description: Deletes a single movie document by ID. Demonstrates the MongoDB deleteOne() operation.
+ *     tags: [Movies]
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema:
+ *           type: string
+ *         description: MongoDB ObjectId of the movie
+ *         example: 573a1390f29313caabcd4135
+ *     responses:
+ *       200:
+ *         description: Movie deleted successfully
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       type: object
+ *                       properties:
+ *                         deletedCount:
+ *                           type: integer
+ *       400:
+ *         description: Invalid ObjectId format
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
+ *       404:
+ *         description: Movie not found
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
  */
 router.delete("/:id", asyncHandler(movieController.deleteMovie));
 
 /**
- * DELETE /api/movies
- *
- * Deletes multiple movies based on a filter.
- * Demonstrates the deleteMany() operation.
+ * @swagger
+ * /api/movies:
+ *   delete:
+ *     summary: Delete multiple movies
+ *     description: Deletes multiple movies based on a filter. Demonstrates the MongoDB deleteMany() operation.
+ *     tags: [Movies]
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             required:
+ *               - filter
+ *             properties:
+ *               filter:
+ *                 type: object
+ *                 description: MongoDB filter criteria (cannot be empty to prevent accidental deletion of all documents)
+ *                 example:
+ *                   year: 1990
+ *     responses:
+ *       200:
+ *         description: Movies deleted successfully
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       type: object
+ *                       properties:
+ *                         deletedCount:
+ *                           type: integer
+ *       400:
+ *         description: Validation error (missing or empty filter)
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
  */
 router.delete("/", asyncHandler(movieController.deleteMoviesBatch));
 

From 5610a758e51e238a33366060740d3ebe36b07fbb Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Thu, 6 Nov 2025 21:47:54 -0500
Subject: [PATCH 090/110] Add Swagger annotations for new routes

---
 server/express/src/routes/movies.ts | 299 ++++++++++++++++++++++++++--
 1 file changed, 279 insertions(+), 20 deletions(-)

diff --git a/server/express/src/routes/movies.ts b/server/express/src/routes/movies.ts
index a265095..a4dbbf9 100644
--- a/server/express/src/routes/movies.ts
+++ b/server/express/src/routes/movies.ts
@@ -119,42 +119,301 @@ const router = express.Router();
 router.get("/", asyncHandler(movieController.getAllMovies));
 
 /**
- * GET /api/movies/search
- *
- * Search movies using MongoDB Search across multiple fields.
- * Demonstrates MongoDB Atlas Search with compound queries and fuzzy matching.
+ * @swagger
+ * /api/movies/search:
+ *   get:
+ *     summary: Search movies using MongoDB Atlas Search
+ *     description: Search movies using MongoDB Atlas Search across multiple fields with compound queries and fuzzy matching. Demonstrates MongoDB Atlas Search capabilities.
+ *     tags: [Movies]
+ *     parameters:
+ *       - in: query
+ *         name: plot
+ *         schema:
+ *           type: string
+ *         description: Search in plot field using phrase matching
+ *         example: detective solving mystery
+ *       - in: query
+ *         name: fullplot
+ *         schema:
+ *           type: string
+ *         description: Search in fullplot field using phrase matching
+ *         example: crime investigation
+ *       - in: query
+ *         name: directors
+ *         schema:
+ *           type: string
+ *         description: Search for directors with fuzzy matching
+ *         example: Christopher Nolan
+ *       - in: query
+ *         name: writers
+ *         schema:
+ *           type: string
+ *         description: Search for writers with fuzzy matching
+ *         example: Quentin Tarantino
+ *       - in: query
+ *         name: cast
+ *         schema:
+ *           type: string
+ *         description: Search for cast members with fuzzy matching
+ *         example: Tom Hanks
+ *       - in: query
+ *         name: searchOperator
+ *         schema:
+ *           type: string
+ *           enum: [must, should, mustNot, filter]
+ *           default: must
+ *         description: Search operator for compound queries
+ *       - in: query
+ *         name: limit
+ *         schema:
+ *           type: integer
+ *           default: 20
+ *           maximum: 100
+ *         description: Number of results to return
+ *       - in: query
+ *         name: skip
+ *         schema:
+ *           type: integer
+ *           default: 0
+ *         description: Number of documents to skip for pagination
+ *     responses:
+ *       200:
+ *         description: Search results
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       type: object
+ *                       properties:
+ *                         movies:
+ *                           type: array
+ *                           items:
+ *                             $ref: '#/components/schemas/Movie'
+ *                         count:
+ *                           type: integer
+ *                         limit:
+ *                           type: integer
+ *                         skip:
+ *                           type: integer
+ *       400:
+ *         description: Bad request - invalid search operator or no search parameters provided
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
  */
 router.get("/search", asyncHandler(movieController.searchMovies));
 
 /**
- * GET /api/movies/vector-search
- *
- * Search movies using MongoDB Vector Search for semantic similarity.
- * Demonstrates vector search using embeddings to find similar plots.
+ * @swagger
+ * /api/movies/vector-search:
+ *   get:
+ *     summary: Search movies using MongoDB Vector Search
+ *     description: Search movies using MongoDB Vector Search for semantic similarity. Demonstrates vector search using embeddings to find movies with similar plots. Requires VOYAGE_API_KEY to be configured.
+ *     tags: [Movies]
+ *     parameters:
+ *       - in: query
+ *         name: q
+ *         required: true
+ *         schema:
+ *           type: string
+ *         description: Search query for semantic similarity
+ *         example: space exploration and alien encounters
+ *       - in: query
+ *         name: limit
+ *         schema:
+ *           type: integer
+ *           default: 10
+ *           maximum: 50
+ *         description: Number of results to return
+ *     responses:
+ *       200:
+ *         description: Vector search results with similarity scores
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       type: array
+ *                       items:
+ *                         allOf:
+ *                           - $ref: '#/components/schemas/Movie'
+ *                           - type: object
+ *                             properties:
+ *                               score:
+ *                                 type: number
+ *                                 description: Vector similarity score
+ *       400:
+ *         description: Bad request - missing query parameter or VOYAGE_API_KEY not configured
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
  */
 router.get("/vector-search", asyncHandler(movieController.vectorSearchMovies));
 
 /**
- * GET /api/movies/aggregations/reportingByComments
- *
- * Aggregate movies with their most recent comments.
- * Demonstrates MongoDB $lookup aggregation to join collections.
+ * @swagger
+ * /api/movies/aggregations/reportingByComments:
+ *   get:
+ *     summary: Get movies with their most recent comments
+ *     description: Aggregate movies with their most recent comments using MongoDB $lookup aggregation. Demonstrates joining collections and sorting by nested fields.
+ *     tags: [Movies]
+ *     parameters:
+ *       - in: query
+ *         name: limit
+ *         schema:
+ *           type: integer
+ *           default: 10
+ *           maximum: 50
+ *         description: Number of recent comments to include per movie
+ *       - in: query
+ *         name: movieId
+ *         schema:
+ *           type: string
+ *         description: Optional MongoDB ObjectId to filter for a specific movie
+ *         example: 573a1390f29313caabcd4135
+ *     responses:
+ *       200:
+ *         description: Movies with their most recent comments
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       type: array
+ *                       items:
+ *                         type: object
+ *                         properties:
+ *                           _id:
+ *                             type: string
+ *                           title:
+ *                             type: string
+ *                           year:
+ *                             type: integer
+ *                           genres:
+ *                             type: array
+ *                             items:
+ *                               type: string
+ *                           imdbRating:
+ *                             type: number
+ *                           recentComments:
+ *                             type: array
+ *                             items:
+ *                               type: object
+ *                               properties:
+ *                                 _id:
+ *                                   type: string
+ *                                 userName:
+ *                                   type: string
+ *                                 userEmail:
+ *                                   type: string
+ *                                 text:
+ *                                   type: string
+ *                                 date:
+ *                                   type: string
+ *                                   format: date-time
+ *       400:
+ *         description: Invalid movie ID format
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ErrorResponse'
  */
 router.get("/aggregations/reportingByComments", asyncHandler(movieController.getMoviesWithMostRecentComments));
 
 /**
- * GET /api/movies/aggregations/reportingByYear
- *
- * Aggregate movies by year with statistics.
- * Demonstrates MongoDB $group aggregation for statistical calculations.
+ * @swagger
+ * /api/movies/aggregations/reportingByYear:
+ *   get:
+ *     summary: Get movie statistics by year
+ *     description: Aggregate movies by year with statistics including count, average rating, highest/lowest ratings, and total votes. Demonstrates MongoDB $group aggregation for statistical calculations.
+ *     tags: [Movies]
+ *     responses:
+ *       200:
+ *         description: Movie statistics grouped by year
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       type: array
+ *                       items:
+ *                         type: object
+ *                         properties:
+ *                           year:
+ *                             type: integer
+ *                             example: 1994
+ *                           movieCount:
+ *                             type: integer
+ *                             example: 150
+ *                           averageRating:
+ *                             type: number
+ *                             example: 7.25
+ *                           highestRating:
+ *                             type: number
+ *                             example: 9.3
+ *                           lowestRating:
+ *                             type: number
+ *                             example: 4.5
+ *                           totalVotes:
+ *                             type: integer
+ *                             example: 1500000
  */
 router.get("/aggregations/reportingByYear", asyncHandler(movieController.getMoviesByYearWithStats));
 
 /**
- * GET /api/movies/aggregations/reportingByDirectors
- *
- * Aggregate directors with the most movies.
- * Demonstrates MongoDB $unwind and $group for array aggregation.
+ * @swagger
+ * /api/movies/aggregations/reportingByDirectors:
+ *   get:
+ *     summary: Get directors with the most movies
+ *     description: Aggregate directors with the most movies, including their movie count and average rating. Demonstrates MongoDB $unwind and $group for array aggregation.
+ *     tags: [Movies]
+ *     parameters:
+ *       - in: query
+ *         name: limit
+ *         schema:
+ *           type: integer
+ *           default: 20
+ *           maximum: 100
+ *         description: Number of directors to return
+ *     responses:
+ *       200:
+ *         description: Directors with the most movies
+ *         content:
+ *           application/json:
+ *             schema:
+ *               allOf:
+ *                 - $ref: '#/components/schemas/SuccessResponse'
+ *                 - type: object
+ *                   properties:
+ *                     data:
+ *                       type: array
+ *                       items:
+ *                         type: object
+ *                         properties:
+ *                           director:
+ *                             type: string
+ *                             example: Steven Spielberg
+ *                           movieCount:
+ *                             type: integer
+ *                             example: 25
+ *                           averageRating:
+ *                             type: number
+ *                             example: 7.85
  */
 router.get("/aggregations/reportingByDirectors", asyncHandler(movieController.getDirectorsWithMostMovies));
 

From aeca8fc74eeae912863dcbdbd11cbe2ccb72f343 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Thu, 6 Nov 2025 21:51:47 -0500
Subject: [PATCH 091/110] Fix controller comments to match routes whose names
 have changed

---
 server/express/src/controllers/movieController.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/server/express/src/controllers/movieController.ts b/server/express/src/controllers/movieController.ts
index 14269dc..d913a09 100644
--- a/server/express/src/controllers/movieController.ts
+++ b/server/express/src/controllers/movieController.ts
@@ -848,7 +848,7 @@ export async function vectorSearchMovies(req: Request, res: Response): Promise<v
 }
 
 /**
- * GET /api/movies/aggregations/comments
+ * GET /api/movies/aggregations/reportingByComments
  *
  * Aggregate movies with their most recent comments.
  * Demonstrates MongoDB $lookup aggregation to join collections.
@@ -991,7 +991,7 @@ export async function getMoviesWithMostRecentComments(
 }
 
 /**
- * GET /api/movies/aggregations/years
+ * GET /api/movies/aggregations/reportingByYear
  *
  * Aggregate movies by year with statistics.
  * Demonstrates MongoDB $group aggregation for statistical calculations.
@@ -1091,7 +1091,7 @@ export async function getMoviesByYearWithStats(
 }
 
 /**
- * GET /api/movies/aggregations/directors
+ * GET /api/movies/aggregations/reportingByDirectors
  *
  * Aggregate directors with the most movies.
  * Demonstrates MongoDB $unwind and $group for array aggregation.

From d3c66e6d8c45f2fc6abcd1abd3aa75a4fe6df720 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Wed, 5 Nov 2025 15:17:26 -0500
Subject: [PATCH 092/110] Add integration tests for Express server

---
 server/express/.env.example                   |   6 +-
 server/express/jest.config.json               |   4 +
 server/express/jest.integration.config.json   |  15 +
 server/express/package.json                   |   1 +
 server/express/tests/integration/README.md    | 140 ++++++
 .../mongodbSearch.integration.test.ts         | 325 ++++++++++++++
 .../integration/movie.integration.test.ts     | 401 ++++++++++++++++++
 server/express/tests/integration/setup.ts     |  99 +++++
 8 files changed, 990 insertions(+), 1 deletion(-)
 create mode 100644 server/express/jest.integration.config.json
 create mode 100644 server/express/tests/integration/README.md
 create mode 100644 server/express/tests/integration/mongodbSearch.integration.test.ts
 create mode 100644 server/express/tests/integration/movie.integration.test.ts
 create mode 100644 server/express/tests/integration/setup.ts

diff --git a/server/express/.env.example b/server/express/.env.example
index c3551b3..027a11e 100644
--- a/server/express/.env.example
+++ b/server/express/.env.example
@@ -7,4 +7,8 @@ PORT=3001
 NODE_ENV=development
 
 # CORS Configuration (frontend URL)
-CORS_ORIGIN=http://localhost:3000
\ No newline at end of file
+CORS_ORIGIN=http://localhost:3000
+
+# Optional: Enable MongoDB Search tests
+# Uncomment the following line to enable Search tests
+# ENABLE_SEARCH_TESTS=true
\ No newline at end of file
diff --git a/server/express/jest.config.json b/server/express/jest.config.json
index 4c7a843..ec2b758 100644
--- a/server/express/jest.config.json
+++ b/server/express/jest.config.json
@@ -6,6 +6,10 @@
     "**/__tests__/**/*.ts",
     "**/?(*.)+(spec|test).ts"
   ],
+  "testPathIgnorePatterns": [
+    "/node_modules/",
+    "/tests/integration/"
+  ],
   "transform": {
     "^.+\\.ts$": "ts-jest"
   },
diff --git a/server/express/jest.integration.config.json b/server/express/jest.integration.config.json
new file mode 100644
index 0000000..314eff4
--- /dev/null
+++ b/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
+}
+
diff --git a/server/express/package.json b/server/express/package.json
index b776f78..9d39091 100644
--- a/server/express/package.json
+++ b/server/express/package.json
@@ -14,6 +14,7 @@
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
     "test:unit": "jest tests/controllers",
+    "test:integration": "jest --config jest.integration.config.json",
     "test:verbose": "jest --verbose",
     "test:silent": "jest --silent"
   },
diff --git a/server/express/tests/integration/README.md b/server/express/tests/integration/README.md
new file mode 100644
index 0000000..e4a72ab
--- /dev/null
+++ b/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:password@cluster.mongodb.net/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 |
diff --git a/server/express/tests/integration/mongodbSearch.integration.test.ts b/server/express/tests/integration/mongodbSearch.integration.test.ts
new file mode 100644
index 0000000..fe25b4d
--- /dev/null
+++ b/server/express/tests/integration/mongodbSearch.integration.test.ts
@@ -0,0 +1,325 @@
+/**
+ * MongoDB Search Integration Tests
+ *
+ * These tests verify MongoDB Search functionality with a real MongoDB instance.
+ * The tests require:
+ * - A MongoDB instance with Search enabled (local MongoDB or Atlas)
+ * - MONGODB_URI environment variable
+ * - ENABLE_SEARCH_TESTS=true environment variable to enable tests
+ *
+ * Note: These tests are disabled by default and should only be run against a test MongoDB instance.
+ */
+
+import { ObjectId } from "mongodb";
+import { connectToDatabase, getCollection } from "../../src/config/database";
+import { describeSearch } from "./setup";
+
+const SEARCH_INDEX_NAME = "movieSearchIndex";
+const MAX_INDEX_WAIT_SECONDS = 120;
+const POLL_INTERVAL_SECONDS = 5;
+
+describeSearch("MongoDB Search Integration Tests", () => {
+  let testMovieIds: ObjectId[] = [];
+
+  beforeAll(async () => {
+    try {
+      // Clean up any leftover test data from previous failed runs
+      await cleanupTestMovies();
+
+      // Create test data
+      await createTestMovies();
+
+      // Create Search index (or verify it exists)
+      await createSearchIndex();
+
+      // Wait for index to be ready
+      await waitForSearchIndexReady();
+
+      // Wait for documents to be indexed
+      await new Promise((resolve) => setTimeout(resolve, 10000)); // 10 seconds
+    } catch (error) {
+      console.error("❌ Error during setup:", error);
+      // Clean up on setup failure
+      await cleanupTestMovies();
+      throw error;
+    }
+  });
+
+  afterAll(async () => {
+    await cleanupTestMovies();
+  });
+
+  describe("Search by plot", () => {
+    test("should find movies with 'space adventure' in plot", async () => {
+      const moviesCollection = getCollection("movies");
+
+      // Perform Search query
+      const results = await moviesCollection
+        .aggregate([
+          {
+            $search: {
+              index: SEARCH_INDEX_NAME,
+              text: {
+                query: "space adventure",
+                path: ["plot", "fullplot"],
+              },
+            },
+          },
+          { $limit: 10 },
+        ])
+        .toArray();
+
+      expect(results).toBeDefined();
+      expect(results.length).toBeGreaterThan(0);
+
+      // Verify at least one result contains our test movie
+      const foundTestMovie = results.some(
+        (movie: any) =>
+          movie.plot && movie.plot.toLowerCase().includes("space adventure")
+      );
+      expect(foundTestMovie).toBe(true);
+    });
+
+    test("should return empty array when no movies match search query", async () => {
+      const moviesCollection = getCollection("movies");
+
+      // Search for something that definitely doesn't exist
+      const results = await moviesCollection
+        .aggregate([
+          {
+            $search: {
+              index: SEARCH_INDEX_NAME,
+              text: {
+                query: "xyzabc123nonexistent",
+                path: ["plot", "fullplot"],
+              },
+            },
+          },
+          { $limit: 10 },
+        ])
+        .toArray();
+
+      expect(results).toBeDefined();
+      expect(results.length).toBe(0);
+    });
+  });
+
+  describe("Search with pagination", () => {
+    test("should respect limit parameter", async () => {
+      const moviesCollection = getCollection("movies");
+      const limit = 2;
+
+      const results = await moviesCollection
+        .aggregate([
+          {
+            $search: {
+              index: SEARCH_INDEX_NAME,
+              text: {
+                query: "adventure",
+                path: ["plot", "fullplot"],
+              },
+            },
+          },
+          { $limit: limit },
+        ])
+        .toArray();
+
+      expect(results).toBeDefined();
+      expect(results.length).toBeLessThanOrEqual(limit);
+    });
+
+    test("should support pagination with skip", async () => {
+      const moviesCollection = getCollection("movies");
+      const limit = 2;
+
+      // Get first page
+      const firstPage = await moviesCollection
+        .aggregate([
+          {
+            $search: {
+              index: SEARCH_INDEX_NAME,
+              text: {
+                query: "adventure",
+                path: ["plot", "fullplot"],
+              },
+            },
+          },
+          { $limit: limit },
+        ])
+        .toArray();
+
+      // Get second page
+      const secondPage = await moviesCollection
+        .aggregate([
+          {
+            $search: {
+              index: SEARCH_INDEX_NAME,
+              text: {
+                query: "adventure",
+                path: ["plot", "fullplot"],
+              },
+            },
+          },
+          { $skip: limit },
+          { $limit: limit },
+        ])
+        .toArray();
+
+      expect(firstPage).toBeDefined();
+      expect(secondPage).toBeDefined();
+
+      // If we have enough results, verify different pages have different results
+      if (firstPage.length === limit && secondPage.length > 0) {
+        const firstPageIds = firstPage.map((m: any) => m._id.toString());
+        const secondPageIds = secondPage.map((m: any) => m._id.toString());
+
+        // Verify no overlap between pages
+        const hasOverlap = firstPageIds.some((id) => secondPageIds.includes(id));
+        expect(hasOverlap).toBe(false);
+      }
+    });
+  });
+
+  // ==================== HELPER FUNCTIONS ====================
+
+  /**
+   * Clean up test movies from the database.
+   * This function is idempotent and safe to call multiple times.
+   */
+  async function cleanupTestMovies(): Promise<void> {
+    const moviesCollection = getCollection("movies");
+
+    // Clean up by IDs if we have them
+    if (testMovieIds.length > 0) {
+      await moviesCollection.deleteMany({
+        _id: { $in: testMovieIds },
+      });
+      testMovieIds = [];
+    }
+
+    // Also clean up by title pattern to catch any orphaned test data
+    // This ensures idempotency even if previous test runs failed
+    await moviesCollection.deleteMany({
+      title: { $regex: /^Test (Space Adventure|Mystery Movie|Adventure Quest)$/ },
+    });
+  }
+
+  async function createTestMovies(): Promise<void> {
+    const moviesCollection = getCollection("movies");
+
+    const testMovies = [
+      {
+        title: "Test Space Adventure",
+        year: 2024,
+        plot: "An epic space adventure across the galaxy",
+        genres: ["Sci-Fi", "Adventure"],
+      },
+      {
+        title: "Test Mystery Movie",
+        year: 2024,
+        plot: "A detective solves a mysterious crime",
+        genres: ["Mystery", "Thriller"],
+      },
+      {
+        title: "Test Adventure Quest",
+        year: 2024,
+        plot: "Heroes embark on a dangerous adventure",
+        genres: ["Adventure", "Fantasy"],
+      },
+    ];
+
+    const result = await moviesCollection.insertMany(testMovies);
+    testMovieIds = Object.values(result.insertedIds) as ObjectId[];
+  }
+
+  async function createSearchIndex(): Promise<void> {
+    const db = await connectToDatabase();
+    const moviesCollection = getCollection("movies");
+
+    // Check if index already exists
+    const existingIndexes = await moviesCollection.listSearchIndexes().toArray();
+    const indexExists = existingIndexes.some(
+      (idx: any) => idx.name === SEARCH_INDEX_NAME
+    );
+
+    if (indexExists) {
+      return;
+    }
+
+    // Create the search index definition
+    const indexDefinition = {
+      mappings: {
+        dynamic: false,
+        fields: {
+          plot: {
+            type: "string",
+            analyzer: "lucene.standard",
+          },
+          fullplot: {
+            type: "string",
+            analyzer: "lucene.standard",
+          },
+          directors: {
+            type: "string",
+            analyzer: "lucene.standard",
+          },
+          writers: {
+            type: "string",
+            analyzer: "lucene.standard",
+          },
+          cast: {
+            type: "string",
+            analyzer: "lucene.standard",
+          },
+        },
+      },
+    };
+
+    // Create the index using the createSearchIndexes command
+    try {
+      await db.command({
+        createSearchIndexes: "movies",
+        indexes: [
+          {
+            name: SEARCH_INDEX_NAME,
+            definition: indexDefinition,
+          },
+        ],
+      });
+    } catch (error) {
+      console.error("❌ Error creating search index:", error);
+      throw error;
+    }
+  }
+
+  async function waitForSearchIndexReady(): Promise<void> {
+    const moviesCollection = getCollection("movies");
+    const startTime = Date.now();
+    const maxWaitMillis = MAX_INDEX_WAIT_SECONDS * 1000;
+
+    while (Date.now() - startTime < maxWaitMillis) {
+      const indexes = await moviesCollection.listSearchIndexes().toArray();
+
+      const searchIndex = indexes.find(
+        (idx: any) => idx.name === SEARCH_INDEX_NAME
+      );
+
+      if (searchIndex) {
+        const status = (searchIndex as any).status;
+        if (status === "READY") {
+          return;
+        }
+      }
+
+      // Wait before polling again
+      await new Promise((resolve) =>
+        setTimeout(resolve, POLL_INTERVAL_SECONDS * 1000)
+      );
+    }
+
+    throw new Error(
+      `Search index did not become ready within ${MAX_INDEX_WAIT_SECONDS} seconds`
+    );
+  }
+});
+
diff --git a/server/express/tests/integration/movie.integration.test.ts b/server/express/tests/integration/movie.integration.test.ts
new file mode 100644
index 0000000..6c9d573
--- /dev/null
+++ b/server/express/tests/integration/movie.integration.test.ts
@@ -0,0 +1,401 @@
+/**
+ * Movie CRUD Integration Tests
+ *
+ * These tests verify the full database operations for movie CRUD functionality.
+ * Unlike unit tests, these tests connect to a real MongoDB instance.
+ *
+ * Requirements:
+ * - MONGODB_URI environment variable must be set
+ * - MongoDB instance must be accessible
+ */
+
+import { ObjectId } from "mongodb";
+import { getCollection } from "../../src/config/database";
+import { describeIntegration } from "./setup";
+
+describeIntegration("Movie CRUD Integration Tests", () => {
+  let testMovieIds: ObjectId[] = [];
+
+  beforeAll(async () => {
+    // Clean up any orphaned test data from previous failed runs
+    // This ensures tests are idempotent
+    const moviesCollection = getCollection("movies");
+    await moviesCollection.deleteMany({
+      $or: [
+        { title: { $regex: /^Integration Test Movie/ } },
+        { title: { $regex: /^Find By ID Test Movie/ } },
+        { title: { $regex: /^Action Movie 202[0-9]/ } },
+        { title: { $regex: /^Drama Movie 202[0-9]/ } },
+        { title: { $regex: /^Pagination Test Movie/ } },
+        { title: { $regex: /^Original Title/ } },
+        { title: { $regex: /^Updated Title/ } },
+        { title: { $regex: /^Movie [0-9]/ } },
+        { title: { $regex: /^Movie to Delete/ } },
+        { title: { $regex: /^Delete Test/ } },
+        { title: { $regex: /^Find and Delete Test/ } },
+      ],
+    });
+  });
+
+  afterEach(async () => {
+    // Clean up test movies after each test
+    if (testMovieIds.length > 0) {
+      const moviesCollection = getCollection("movies");
+      await moviesCollection.deleteMany({
+        _id: { $in: testMovieIds },
+      });
+      testMovieIds = [];
+    }
+  });
+
+  describe("Create Operations", () => {
+    test("should create a single movie with insertOne", async () => {
+      const moviesCollection = getCollection("movies");
+
+      const newMovie = {
+        title: "Integration Test Movie",
+        year: 2024,
+        plot: "A movie created during integration testing",
+        genres: ["Test", "Drama"],
+      };
+
+      const result = await moviesCollection.insertOne(newMovie);
+
+      expect(result.acknowledged).toBe(true);
+      expect(result.insertedId).toBeDefined();
+      expect(result.insertedId).toBeInstanceOf(ObjectId);
+
+      testMovieIds.push(result.insertedId);
+
+      // Verify the movie was actually inserted
+      const insertedMovie = await moviesCollection.findOne({
+        _id: result.insertedId,
+      });
+
+      expect(insertedMovie).toBeDefined();
+      expect(insertedMovie?.title).toBe(newMovie.title);
+      expect(insertedMovie?.year).toBe(newMovie.year);
+      expect(insertedMovie?.plot).toBe(newMovie.plot);
+    });
+
+    test("should create multiple movies with insertMany", async () => {
+      const moviesCollection = getCollection("movies");
+
+      const newMovies = [
+        {
+          title: "Integration Test Movie 1",
+          year: 2024,
+          plot: "First test movie",
+          genres: ["Test"],
+        },
+        {
+          title: "Integration Test Movie 2",
+          year: 2024,
+          plot: "Second test movie",
+          genres: ["Test"],
+        },
+        {
+          title: "Integration Test Movie 3",
+          year: 2024,
+          plot: "Third test movie",
+          genres: ["Test"],
+        },
+      ];
+
+      const result = await moviesCollection.insertMany(newMovies);
+
+      expect(result.acknowledged).toBe(true);
+      expect(result.insertedCount).toBe(3);
+      expect(Object.keys(result.insertedIds).length).toBe(3);
+
+      testMovieIds.push(...Object.values(result.insertedIds));
+
+      // Verify all movies were inserted
+      const insertedMovies = await moviesCollection
+        .find({ _id: { $in: Object.values(result.insertedIds) } })
+        .toArray();
+
+      expect(insertedMovies.length).toBe(3);
+    });
+  });
+
+  describe("Read Operations", () => {
+    test("should find a movie by ObjectId", async () => {
+      const moviesCollection = getCollection("movies");
+
+      // Create a test movie
+      const newMovie = {
+        title: "Find By ID Test Movie",
+        year: 2024,
+        plot: "Testing findOne by ID",
+      };
+
+      const insertResult = await moviesCollection.insertOne(newMovie);
+      testMovieIds.push(insertResult.insertedId);
+
+      // Find the movie by ID
+      const foundMovie = await moviesCollection.findOne({
+        _id: insertResult.insertedId,
+      });
+
+      expect(foundMovie).toBeDefined();
+      expect(foundMovie?._id.toString()).toBe(insertResult.insertedId.toString());
+      expect(foundMovie?.title).toBe(newMovie.title);
+    });
+
+    test("should find movies with filters", async () => {
+      const moviesCollection = getCollection("movies");
+
+      // Create test movies
+      const testMovies = [
+        {
+          title: "Action Movie 2024",
+          year: 2024,
+          genres: ["Action"],
+        },
+        {
+          title: "Drama Movie 2024",
+          year: 2024,
+          genres: ["Drama"],
+        },
+        {
+          title: "Action Movie 2023",
+          year: 2023,
+          genres: ["Action"],
+        },
+      ];
+
+      const insertResult = await moviesCollection.insertMany(testMovies);
+      testMovieIds.push(...Object.values(insertResult.insertedIds));
+
+      // Find movies by year
+      const movies2024 = await moviesCollection
+        .find({ year: 2024 })
+        .toArray();
+
+      const testMovies2024 = movies2024.filter((m) =>
+        testMovieIds.some((id) => id.toString() === m._id.toString())
+      );
+
+      expect(testMovies2024.length).toBe(2);
+
+      // Find movies by genre
+      const actionMovies = await moviesCollection
+        .find({ genres: { $regex: /Action/i } })
+        .toArray();
+
+      const testActionMovies = actionMovies.filter((m) =>
+        testMovieIds.some((id) => id.toString() === m._id.toString())
+      );
+
+      expect(testActionMovies.length).toBe(2);
+    });
+
+    test("should support pagination with limit and skip", async () => {
+      const moviesCollection = getCollection("movies");
+
+      // Create 5 test movies
+      const testMovies = Array.from({ length: 5 }, (_, i) => ({
+        title: `Pagination Test Movie ${i + 1}`,
+        year: 2024,
+      }));
+
+      const insertResult = await moviesCollection.insertMany(testMovies);
+      testMovieIds.push(...Object.values(insertResult.insertedIds));
+
+      // Get first page (2 movies)
+      const firstPage = await moviesCollection
+        .find({ _id: { $in: testMovieIds } })
+        .limit(2)
+        .toArray();
+
+      expect(firstPage.length).toBe(2);
+
+      // Get second page (2 movies, skip first 2)
+      const secondPage = await moviesCollection
+        .find({ _id: { $in: testMovieIds } })
+        .skip(2)
+        .limit(2)
+        .toArray();
+
+      expect(secondPage.length).toBe(2);
+
+      // Verify different results
+      const firstPageIds = firstPage.map((m) => m._id.toString());
+      const secondPageIds = secondPage.map((m) => m._id.toString());
+      const hasOverlap = firstPageIds.some((id) => secondPageIds.includes(id));
+
+      expect(hasOverlap).toBe(false);
+    });
+  });
+
+  describe("Update Operations", () => {
+    test("should update a single movie with updateOne", async () => {
+      const moviesCollection = getCollection("movies");
+
+      // Create a test movie
+      const newMovie = {
+        title: "Original Title",
+        year: 2024,
+        plot: "Original plot",
+      };
+
+      const insertResult = await moviesCollection.insertOne(newMovie);
+      testMovieIds.push(insertResult.insertedId);
+
+      // Update the movie
+      const updateResult = await moviesCollection.updateOne(
+        { _id: insertResult.insertedId },
+        { $set: { title: "Updated Title", plot: "Updated plot" } }
+      );
+
+      expect(updateResult.acknowledged).toBe(true);
+      expect(updateResult.matchedCount).toBe(1);
+      expect(updateResult.modifiedCount).toBe(1);
+
+      // Verify the update
+      const updatedMovie = await moviesCollection.findOne({
+        _id: insertResult.insertedId,
+      });
+
+      expect(updatedMovie?.title).toBe("Updated Title");
+      expect(updatedMovie?.plot).toBe("Updated plot");
+      expect(updatedMovie?.year).toBe(2024); // Unchanged field
+    });
+
+    test("should update multiple movies with updateMany", async () => {
+      const moviesCollection = getCollection("movies");
+
+      // Create test movies
+      const testMovies = [
+        { title: "Movie 1", year: 2024, rated: "PG" },
+        { title: "Movie 2", year: 2024, rated: "PG" },
+        { title: "Movie 3", year: 2024, rated: "R" },
+      ];
+
+      const insertResult = await moviesCollection.insertMany(testMovies);
+      testMovieIds.push(...Object.values(insertResult.insertedIds));
+
+      // Update all PG movies
+      const updateResult = await moviesCollection.updateMany(
+        { _id: { $in: testMovieIds }, rated: "PG" },
+        { $set: { rated: "PG-13" } }
+      );
+
+      expect(updateResult.acknowledged).toBe(true);
+      expect(updateResult.matchedCount).toBe(2);
+      expect(updateResult.modifiedCount).toBe(2);
+
+      // Verify the updates
+      const updatedMovies = await moviesCollection
+        .find({ _id: { $in: testMovieIds }, rated: "PG-13" })
+        .toArray();
+
+      expect(updatedMovies.length).toBe(2);
+    });
+  });
+
+  describe("Delete Operations", () => {
+    test("should delete a single movie with deleteOne", async () => {
+      const moviesCollection = getCollection("movies");
+
+      // Create a test movie
+      const newMovie = {
+        title: "Movie to Delete",
+        year: 2024,
+      };
+
+      const insertResult = await moviesCollection.insertOne(newMovie);
+      const movieId = insertResult.insertedId;
+
+      // Track the ID in case the test fails before deletion
+      testMovieIds.push(movieId);
+
+      // Delete the movie
+      const deleteResult = await moviesCollection.deleteOne({
+        _id: movieId,
+      });
+
+      expect(deleteResult.acknowledged).toBe(true);
+      expect(deleteResult.deletedCount).toBe(1);
+
+      // Verify deletion
+      const deletedMovie = await moviesCollection.findOne({ _id: movieId });
+      expect(deletedMovie).toBeNull();
+
+      // Remove from tracking since it's successfully deleted
+      testMovieIds = testMovieIds.filter(id => id.toString() !== movieId.toString());
+    });
+
+    test("should delete multiple movies with deleteMany", async () => {
+      const moviesCollection = getCollection("movies");
+
+      // Create test movies
+      const testMovies = [
+        { title: "Delete Test 1", year: 2024 },
+        { title: "Delete Test 2", year: 2024 },
+        { title: "Delete Test 3", year: 2024 },
+      ];
+
+      const insertResult = await moviesCollection.insertMany(testMovies);
+      const movieIds = Object.values(insertResult.insertedIds);
+
+      // Track the IDs in case the test fails before deletion
+      testMovieIds.push(...movieIds);
+
+      // Delete all test movies
+      const deleteResult = await moviesCollection.deleteMany({
+        _id: { $in: movieIds },
+      });
+
+      expect(deleteResult.acknowledged).toBe(true);
+      expect(deleteResult.deletedCount).toBe(3);
+
+      // Verify deletion
+      const remainingMovies = await moviesCollection
+        .find({ _id: { $in: movieIds } })
+        .toArray();
+
+      expect(remainingMovies.length).toBe(0);
+
+      // Remove from tracking since they're successfully deleted
+      testMovieIds = testMovieIds.filter(
+        id => !movieIds.some(deletedId => deletedId.toString() === id.toString())
+      );
+    });
+
+    test("should find and delete a movie with findOneAndDelete", async () => {
+      const moviesCollection = getCollection("movies");
+
+      // Create a test movie
+      const newMovie = {
+        title: "Find and Delete Test",
+        year: 2024,
+        plot: "This movie will be found and deleted",
+      };
+
+      const insertResult = await moviesCollection.insertOne(newMovie);
+      const movieId = insertResult.insertedId;
+
+      // Track the ID in case the test fails before deletion
+      testMovieIds.push(movieId);
+
+      // Find and delete the movie
+      const result = await moviesCollection.findOneAndDelete({
+        _id: movieId,
+      });
+
+      expect(result).toBeDefined();
+      expect(result?._id.toString()).toBe(movieId.toString());
+      expect(result?.title).toBe(newMovie.title);
+
+      // Verify deletion
+      const deletedMovie = await moviesCollection.findOne({ _id: movieId });
+      expect(deletedMovie).toBeNull();
+
+      // Remove from tracking since it's successfully deleted
+      testMovieIds = testMovieIds.filter(id => id.toString() !== movieId.toString());
+    });
+  });
+});
+
diff --git a/server/express/tests/integration/setup.ts b/server/express/tests/integration/setup.ts
new file mode 100644
index 0000000..fe97dc7
--- /dev/null
+++ b/server/express/tests/integration/setup.ts
@@ -0,0 +1,99 @@
+/**
+ * Integration Test Setup
+ *
+ * This file runs before all integration tests and sets up the test environment.
+ * Unlike unit tests, integration tests connect to a real MongoDB instance.
+ */
+
+import { connectToDatabase, closeDatabaseConnection } from "../../src/config/database";
+import dotenv from "dotenv";
+
+// Set test environment variables
+dotenv.config();
+process.env.NODE_ENV = "test";
+
+// Increase timeout for database operations in integration tests
+// Integration tests may take longer due to network calls and index creation
+jest.setTimeout(120000); // 2 minutes
+
+/**
+ * Check if integration tests should run
+ * Integration tests are skipped unless MONGODB_URI is set
+ */
+export function isIntegrationTestEnabled(): boolean {
+  return !!process.env.MONGODB_URI;
+}
+
+/**
+ * Check if Search tests should run
+ * Search tests require MongoDB with Search enabled and are opt-in via environment variable
+ */
+export function isSearchTestEnabled(): boolean {
+  return process.env.ENABLE_SEARCH_TESTS === "true" && isIntegrationTestEnabled();
+}
+
+// Track whether we've already shown the skip messages to avoid duplicates
+let hasShownIntegrationSkipMessage = false;
+let hasShownSearchSkipMessage = false;
+
+/**
+ * Get the appropriate describe function based on whether integration tests are enabled
+ * Usage: describeIntegration("My Test Suite", () => { ... })
+ * This will skip the entire suite if MONGODB_URI is not set
+ */
+export const describeIntegration: jest.Describe = isIntegrationTestEnabled()
+  ? describe
+  : ((...args: Parameters<jest.Describe>) => {
+      if (!hasShownIntegrationSkipMessage) {
+        console.log(`
+⚠️  Integration tests skipped: MONGODB_URI environment variable is not set
+   To run integration tests, set MONGODB_URI to your MongoDB connection string
+   Example: MONGODB_URI=mongodb://localhost:27017/sample_mflix npm run test:integration
+`);
+        hasShownIntegrationSkipMessage = true;
+      }
+      return describe.skip(...args);
+    }) as jest.Describe;
+
+/**
+ * Get the appropriate describe function based on whether search tests are enabled
+ * Usage: describeSearch("My Search Test Suite", () => { ... })
+ * This will skip the entire suite if ENABLE_SEARCH_TESTS is not set
+ */
+export const describeSearch: jest.Describe = isSearchTestEnabled()
+  ? describe
+  : ((...args: Parameters<jest.Describe>) => {
+      if (!hasShownSearchSkipMessage) {
+        console.log(`
+⚠️  Search tests skipped: ENABLE_SEARCH_TESTS environment variable is not set
+   To run Search integration tests, set ENABLE_SEARCH_TESTS=true
+   Example: MONGODB_URI=mongodb://localhost:27017/sample_mflix ENABLE_SEARCH_TESTS=true npm run test:integration
+`);
+        hasShownSearchSkipMessage = true;
+      }
+      return describe.skip(...args);
+    }) as jest.Describe;
+
+// Global setup - runs once before all tests
+beforeAll(async () => {
+  try {
+    await connectToDatabase();
+  } catch (error) {
+    console.error("❌ Failed to connect to MongoDB:", error);
+    throw error;
+  }
+});
+
+// Global teardown - runs once after all tests
+afterAll(async () => {
+  if (!isIntegrationTestEnabled()) {
+    return;
+  }
+
+  try {
+    await closeDatabaseConnection();
+  } catch (error) {
+    console.error("❌ Failed to close MongoDB connection:", error);
+  }
+});
+

From e80e73b39f507d2ab53b06bd6986e5c82fbf018d Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Thu, 6 Nov 2025 22:42:34 -0500
Subject: [PATCH 093/110] Add integration tests for new API endpoints, update
 testing pattern

---
 server/express/package.json                   |   2 +
 server/express/src/app.ts                     |   9 +-
 server/express/src/utils/errorHandler.ts      |  17 +-
 server/express/tests/integration/README.md    |  82 ++-
 .../advancedEndpoints.integration.test.ts     | 532 +++++++++++++++++
 .../mongodbSearch.integration.test.ts         | 409 ++++---------
 .../integration/movie.integration.test.ts     | 535 ++++++++++--------
 server/express/tests/integration/setup.ts     |  30 +
 8 files changed, 1081 insertions(+), 535 deletions(-)
 create mode 100644 server/express/tests/integration/advancedEndpoints.integration.test.ts

diff --git a/server/express/package.json b/server/express/package.json
index 9d39091..2035bac 100644
--- a/server/express/package.json
+++ b/server/express/package.json
@@ -31,9 +31,11 @@
     "@types/express": "^4.17.21",
     "@types/jest": "^29.5.14",
     "@types/node": "^20.10.5",
+    "@types/supertest": "^6.0.3",
     "@types/swagger-jsdoc": "^6.0.4",
     "@types/swagger-ui-express": "^4.1.8",
     "jest": "^29.7.0",
+    "supertest": "^7.1.4",
     "ts-jest": "^29.1.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.3.3"
diff --git a/server/express/src/app.ts b/server/express/src/app.ts
index 1d4898f..9c5a7e8 100644
--- a/server/express/src/app.ts
+++ b/server/express/src/app.ts
@@ -161,5 +161,10 @@ process.on("SIGTERM", () => {
   process.exit(0);
 });
 
-// Start the server
-startServer();
+// Export the app for testing
+export { app };
+
+// Only start the server if this file is run directly (not imported for testing)
+if (require.main === module) {
+  startServer();
+}
diff --git a/server/express/src/utils/errorHandler.ts b/server/express/src/utils/errorHandler.ts
index 4ddd5c6..35d79a6 100644
--- a/server/express/src/utils/errorHandler.ts
+++ b/server/express/src/utils/errorHandler.ts
@@ -38,13 +38,16 @@ export function errorHandler(
 ): void {
   // Log the error for debugging purposes
   // In production, we recommend using a logging service
-  console.error("Error occurred:", {
-    message: err.message,
-    stack: err.stack,
-    url: req.url,
-    method: req.method,
-    timestamp: new Date().toISOString(),
-  });
+  // Suppress error logging during tests to keep test output clean
+  if (process.env.NODE_ENV !== "test") {
+    console.error("Error occurred:", {
+      message: err.message,
+      stack: err.stack,
+      url: req.url,
+      method: req.method,
+      timestamp: new Date().toISOString(),
+    });
+  }
 
   // Determine the appropriate HTTP status code and error message
   const errorDetails = parseErrorDetails(err);
diff --git a/server/express/tests/integration/README.md b/server/express/tests/integration/README.md
index e4a72ab..8fbd90f 100644
--- a/server/express/tests/integration/README.md
+++ b/server/express/tests/integration/README.md
@@ -1,40 +1,67 @@
 # 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.
+This directory contains integration tests for the Express MongoDB application. Unlike unit tests, these tests make actual HTTP requests to the Express app using `supertest` and connect to a real MongoDB instance to verify end-to-end functionality.
 
 ## Overview
 
-The integration tests are organized into two main categories:
+The integration tests are organized into three 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
+   - Tests basic CRUD API endpoints using `supertest`
+   - Makes actual HTTP requests to the Express app
+   - Tests pagination, filtering, and sorting via API
    - 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
+   - Tests the MongoDB Atlas Search API endpoint using `supertest`
+   - Makes actual HTTP requests to test the `/api/movies/search` endpoint
+   - Tests search by plot, directors, cast, pagination, and search operators
    - 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.
+3. **Advanced Endpoints Integration Tests** (`advancedEndpoints.integration.test.ts`)
+   - Tests advanced API endpoints using `supertest`
+   - Makes actual HTTP requests to test:
+     - **Aggregation endpoints**: Movies with comments, statistics by year, directors with most movies
+     - **Atlas Search endpoint**: Compound queries, phrase matching, fuzzy matching
+     - **Vector Search endpoint**: Semantic similarity search using embeddings
+   - Aggregation tests automatically run if `MONGODB_URI` is set
+   - Atlas Search tests require `ENABLE_SEARCH_TESTS=true`
+   - Vector Search tests require `VOYAGE_API_KEY` to be set
+
+**Note:** Tests use `describeIntegration`, `describeSearch`, and `describeVectorSearch` wrappers (from `setup.ts` and test files) that automatically skip entire test suites when the required environment variables are not set.
+
+## Testing Approach
+
+These integration tests use **supertest** to make actual HTTP requests to the Express application, testing the complete request/response cycle including:
+- Routing
+- Request parsing
+- Controller logic
+- Database operations
+- Response formatting
+- Error handling
+
+This approach ensures that the API endpoints work correctly from the client's perspective.
 
 ## Requirements
 
-### Basic Integration Tests
+### Basic Integration Tests (CRUD and Aggregations)
 
 - **MONGODB_URI** environment variable must be set
 - MongoDB instance must be accessible (can be local MongoDB or Atlas)
 
-### Search Tests
+### 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
 
+### Vector Search Tests
+
+- **MONGODB_URI** environment variable must be set
+- **VOYAGE_API_KEY** environment variable must be set with a valid Voyage AI API key
+- MongoDB instance must have the `embedded_movies` collection with vector embeddings
+- Vector search index must be configured on the `embedded_movies` collection
+
 ## Running the Tests
 
 ### Run All Integration Tests
@@ -51,6 +78,9 @@ npx jest --config jest.integration.config.json tests/integration/movie.integrati
 
 # Run only Search tests (requires Search-enabled MongoDB)
 npx jest --config jest.integration.config.json tests/integration/mongodbSearch.integration.test.ts
+
+# Run only Advanced Endpoints tests (aggregations, search, vector search)
+npx jest --config jest.integration.config.json tests/integration/advancedEndpoints.integration.test.ts
 ```
 
 ### Set Environment Variables
@@ -66,15 +96,27 @@ MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/sample_mflix?ret
 
 # Optional: Enable Search tests (requires Search-enabled MongoDB)
 ENABLE_SEARCH_TESTS=true
+
+# Optional: Enable Vector Search tests (requires Voyage AI API key)
+VOYAGE_API_KEY=your-voyage-ai-api-key
 ```
 
 ## Test Structure
 
 ### Setup and Teardown
 
+All integration tests follow an **idempotent pattern** to ensure they can be run multiple times without side effects:
+
 - **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
+- **Pre-Test Cleanup** (`beforeAll` in test files): Removes any orphaned test data from previous runs
+- **Post-Test Cleanup** (`afterEach` in test files): Removes test data created during each test
+
+This ensures:
+- Tests can be run multiple times without conflicts
+- The dataset is left in an untouched state after test execution
+- Tests are isolated from each other
+- Failed test runs don't affect subsequent runs
 
 ## Troubleshooting
 
@@ -94,6 +136,15 @@ If you see "⚠️  Skipping MongoDB Search tests - ENABLE_SEARCH_TESTS not set"
 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
 
+### Vector Search Tests are Skipped
+
+If you see "⚠️  Vector Search tests skipped - VOYAGE_API_KEY not set":
+
+1. Set `VOYAGE_API_KEY` environment variable with your Voyage AI API key
+2. Verify your MongoDB instance has the `embedded_movies` collection
+3. Ensure the vector search index is configured on the `embedded_movies` collection
+4. The `embedded_movies` collection should have documents with `plot_embedding_voyage_3_large` field
+
 ### Connection Errors
 
 If tests fail with connection errors:
@@ -132,9 +183,10 @@ If tests timeout, you may need to:
 
 | Aspect | Unit Tests | Integration Tests |
 |--------|-----------|-------------------|
+| HTTP Requests | Mocked with Jest | Real HTTP requests via supertest |
 | 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 |
+| Purpose | Test business logic | Test end-to-end API functionality |
diff --git a/server/express/tests/integration/advancedEndpoints.integration.test.ts b/server/express/tests/integration/advancedEndpoints.integration.test.ts
new file mode 100644
index 0000000..55f9663
--- /dev/null
+++ b/server/express/tests/integration/advancedEndpoints.integration.test.ts
@@ -0,0 +1,532 @@
+/**
+ * Advanced Endpoints Integration Tests
+ *
+ * These tests verify the advanced MongoDB API endpoints including:
+ * - Atlas Search
+ * - Vector Search
+ * - Aggregation pipelines ($lookup, $group, $unwind)
+ *
+ * These tests use supertest to make actual HTTP requests to the Express app,
+ * testing the full request/response cycle including routing, controllers, and database operations.
+ *
+ * Requirements:
+ * - MONGODB_URI environment variable must be set
+ * - MongoDB instance must be accessible
+ * - For Search tests: ENABLE_SEARCH_TESTS=true
+ * - For Vector Search tests: VOYAGE_API_KEY must be set
+ */
+
+import request from "supertest";
+import { ObjectId } from "mongodb";
+import { app } from "../../src/app";
+import { getCollection } from "../../src/config/database";
+import { describeIntegration, describeSearch, describeVectorSearch } from "./setup";
+
+describeIntegration("Advanced Endpoints Integration Tests", () => {
+  let testMovieIds: string[] = [];
+  let testCommentIds: ObjectId[] = [];
+
+  beforeAll(async () => {
+    // Clean up any orphaned test data from previous failed runs
+    const moviesCollection = getCollection("movies");
+    const commentsCollection = getCollection("comments");
+
+    await moviesCollection.deleteMany({
+      $or: [
+        { title: { $regex: /^Test Advanced Movie/ } },
+        { title: { $regex: /^Test Aggregation Movie/ } },
+        { title: { $regex: /^Test Director Movie/ } },
+        { title: { $regex: /^Test Year Stats Movie/ } },
+      ],
+    });
+
+    await commentsCollection.deleteMany({
+      name: { $regex: /^Test User/ },
+    });
+  });
+
+  afterEach(async () => {
+    // Clean up test data after each test
+    if (testMovieIds.length > 0) {
+      const moviesCollection = getCollection("movies");
+      await moviesCollection.deleteMany({
+        _id: { $in: testMovieIds.map((id) => new ObjectId(id)) },
+      });
+      testMovieIds = [];
+    }
+
+    if (testCommentIds.length > 0) {
+      const commentsCollection = getCollection("comments");
+      await commentsCollection.deleteMany({
+        _id: { $in: testCommentIds },
+      });
+      testCommentIds = [];
+    }
+  });
+
+  describe("GET /api/movies/aggregations/reportingByComments", () => {
+    test("should return movies with their most recent comments", async () => {
+      // Create test movie via API
+      const testMovie = {
+        title: "Test Aggregation Movie 1",
+        year: 2024,
+        plot: "A test movie for aggregation",
+        genres: ["Drama"],
+        imdb: { rating: 8.5 },
+      };
+
+      const createResponse = await request(app)
+        .post("/api/movies")
+        .send(testMovie)
+        .expect(201);
+
+      const movieId = createResponse.body.data._id;
+      testMovieIds.push(movieId);
+
+      // Create test comments directly in database (no API endpoint for comments)
+      const commentsCollection = getCollection("comments");
+      const testComments = [
+        {
+          movie_id: new ObjectId(movieId),
+          name: "Test User 1",
+          email: "test1@example.com",
+          text: "Great movie!",
+          date: new Date("2024-01-15"),
+        },
+        {
+          movie_id: new ObjectId(movieId),
+          name: "Test User 2",
+          email: "test2@example.com",
+          text: "Loved it!",
+          date: new Date("2024-01-20"),
+        },
+        {
+          movie_id: new ObjectId(movieId),
+          name: "Test User 3",
+          email: "test3@example.com",
+          text: "Amazing!",
+          date: new Date("2024-01-25"),
+        },
+      ];
+
+      const commentsResult = await commentsCollection.insertMany(testComments);
+      testCommentIds.push(...Object.values(commentsResult.insertedIds));
+
+      // Test the API endpoint
+      const response = await request(app)
+        .get("/api/movies/aggregations/reportingByComments")
+        .query({ limit: 10 })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(Array.isArray(response.body.data)).toBe(true);
+
+      // Find our test movie in the results
+      const testMovieResult = response.body.data.find(
+        (m: any) => m._id === movieId
+      );
+
+      expect(testMovieResult).toBeDefined();
+      expect(testMovieResult.title).toBe("Test Aggregation Movie 1");
+      expect(testMovieResult.totalComments).toBe(3);
+      expect(testMovieResult.recentComments).toHaveLength(3);
+
+      // Verify comments are sorted by date (most recent first)
+      expect(testMovieResult.recentComments[0].userName).toBe("Test User 3");
+      expect(testMovieResult.recentComments[1].userName).toBe("Test User 2");
+      expect(testMovieResult.recentComments[2].userName).toBe("Test User 1");
+    });
+
+    test("should limit recent comments per movie", async () => {
+      // Create test movie
+      const testMovie = {
+        title: "Test Aggregation Movie Limit",
+        year: 2024,
+        plot: "A test movie",
+        imdb: { rating: 7.5 },
+      };
+
+      const createResponse = await request(app)
+        .post("/api/movies")
+        .send(testMovie)
+        .expect(201);
+
+      testMovieIds.push(createResponse.body.data._id);
+
+      // Create many comments
+      const commentsCollection = getCollection("comments");
+      const manyComments = Array.from({ length: 10 }, (_, i) => ({
+        movie_id: new ObjectId(createResponse.body.data._id),
+        name: `Test User ${i}`,
+        email: `test${i}@example.com`,
+        text: `Comment ${i}`,
+        date: new Date(`2024-01-${i + 1}`),
+      }));
+
+      const commentsResult = await commentsCollection.insertMany(manyComments);
+      testCommentIds.push(...Object.values(commentsResult.insertedIds));
+
+      // Request with limit of 3 recent comments
+      const response = await request(app)
+        .get("/api/movies/aggregations/reportingByComments")
+        .query({ limit: 3 })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      const testMovieResult = response.body.data.find(
+        (m: any) => m._id === createResponse.body.data._id
+      );
+
+      if (testMovieResult) {
+        // Should have all 10 comments total
+        expect(testMovieResult.totalComments).toBe(10);
+        // But only 3 recent comments returned
+        expect(testMovieResult.recentComments.length).toBe(3);
+      }
+    });
+
+    test("should handle movies with no comments", async () => {
+      // Create a movie without comments
+      const testMovie = {
+        title: "Test Aggregation Movie No Comments",
+        year: 2024,
+        plot: "A movie with no comments",
+      };
+
+      const createResponse = await request(app)
+        .post("/api/movies")
+        .send(testMovie)
+        .expect(201);
+
+      testMovieIds.push(createResponse.body.data._id);
+
+      // The endpoint should only return movies with comments
+      const response = await request(app)
+        .get("/api/movies/aggregations/reportingByComments")
+        .query({ limit: 100 })
+        .expect(200);
+
+      const movieWithNoComments = response.body.data.find(
+        (m: any) => m._id === createResponse.body.data._id
+      );
+
+      // Movie without comments should not be in results
+      expect(movieWithNoComments).toBeUndefined();
+    });
+  });
+
+  describe("GET /api/movies/aggregations/reportingByYear", () => {
+    test("should return movie statistics grouped by year", async () => {
+      // Create test movies for a specific year
+      const testYear = 2023;
+      const testMovies = [
+        {
+          title: "Test Year Stats Movie 1",
+          year: testYear,
+          plot: "First test movie",
+          imdb: { rating: 8.0, votes: 1000 },
+        },
+        {
+          title: "Test Year Stats Movie 2",
+          year: testYear,
+          plot: "Second test movie",
+          imdb: { rating: 9.0, votes: 2000 },
+        },
+      ];
+
+      for (const movie of testMovies) {
+        const createResponse = await request(app)
+          .post("/api/movies")
+          .send(movie)
+          .expect(201);
+        testMovieIds.push(createResponse.body.data._id);
+      }
+
+      // Test the API endpoint
+      const response = await request(app)
+        .get("/api/movies/aggregations/reportingByYear")
+        .query({ limit: 50 })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(Array.isArray(response.body.data)).toBe(true);
+
+      // Find our test year in the results
+      const yearStats = response.body.data.find(
+        (y: any) => y.year === testYear
+      );
+
+      expect(yearStats).toBeDefined();
+      expect(yearStats.movieCount).toBeGreaterThanOrEqual(2);
+      expect(yearStats.averageRating).toBeDefined();
+
+      // Check ratings if they exist (our test movies have ratings)
+      if (yearStats.highestRating !== null) {
+        expect(yearStats.highestRating).toBeGreaterThanOrEqual(8.0);
+      }
+      if (yearStats.lowestRating !== null) {
+        expect(yearStats.lowestRating).toBeLessThanOrEqual(9.0);
+      }
+    });
+
+    test("should sort results by year in descending order", async () => {
+      const response = await request(app)
+        .get("/api/movies/aggregations/reportingByYear")
+        .query({ limit: 10 })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      const data = response.body.data;
+
+      // Verify years are in descending order
+      for (let i = 0; i < data.length - 1; i++) {
+        expect(data[i].year).toBeGreaterThanOrEqual(data[i + 1].year);
+      }
+    });
+  });
+
+  describe("GET /api/movies/aggregations/reportingByDirectors", () => {
+    test("should return directors with their movie counts and verify response structure", async () => {
+      // Test the API endpoint
+      const response = await request(app)
+        .get("/api/movies/aggregations/reportingByDirectors")
+        .query({ limit: 20 })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(Array.isArray(response.body.data)).toBe(true);
+      expect(response.body.data.length).toBeGreaterThan(0);
+
+      // Verify the response structure
+      const firstDirector = response.body.data[0];
+      expect(firstDirector).toHaveProperty("director");
+      expect(firstDirector).toHaveProperty("movieCount");
+      expect(firstDirector).toHaveProperty("averageRating");
+
+      // Verify directors are sorted by movie count (descending)
+      expect(firstDirector.movieCount).toBeGreaterThan(0);
+
+      // Verify all directors have the expected structure
+      response.body.data.forEach((director: any) => {
+        expect(typeof director.director).toBe("string");
+        expect(typeof director.movieCount).toBe("number");
+        expect(director.movieCount).toBeGreaterThan(0);
+        if (director.averageRating !== null) {
+          expect(typeof director.averageRating).toBe("number");
+        }
+      });
+    });
+  });
+});
+
+describeSearch("Atlas Search Integration Tests", () => {
+  let testMovieIds: string[] = [];
+
+  beforeAll(async () => {
+    if (!process.env.ENABLE_SEARCH_TESTS) {
+      console.log(`
+⚠️  Atlas Search tests skipped: ENABLE_SEARCH_TESTS environment variable is not set
+   To run Atlas Search integration tests, set ENABLE_SEARCH_TESTS=true in your .env file
+   Example: ENABLE_SEARCH_TESTS=true npm run test:integration
+`);
+      return;
+    }
+
+    // Clean up any orphaned test data from previous failed runs
+    const moviesCollection = getCollection("movies");
+    await moviesCollection.deleteMany({
+      title: { $regex: /^Test Search Movie/ },
+    });
+  });
+
+  afterEach(async () => {
+    if (!process.env.ENABLE_SEARCH_TESTS) {
+      return;
+    }
+
+    // Clean up test data after each test
+    if (testMovieIds.length > 0) {
+      const moviesCollection = getCollection("movies");
+      await moviesCollection.deleteMany({
+        _id: { $in: testMovieIds.map((id) => new ObjectId(id)) },
+      });
+      testMovieIds = [];
+    }
+  });
+
+  describe("GET /api/movies/search", () => {
+    test("should search movies by plot using phrase matching", async () => {
+      // Create test movies with specific plots
+      const testMovies = [
+        {
+          title: "Test Search Movie 1",
+          year: 2024,
+          plot: "A detective solving a mysterious crime in the city",
+          genres: ["Mystery", "Thriller"],
+        },
+        {
+          title: "Test Search Movie 2",
+          year: 2024,
+          plot: "An epic space adventure across the galaxy",
+          genres: ["Sci-Fi", "Adventure"],
+        },
+      ];
+
+      for (const movie of testMovies) {
+        const createResponse = await request(app)
+          .post("/api/movies")
+          .send(movie)
+          .expect(201);
+        testMovieIds.push(createResponse.body.data._id);
+      }
+
+      // Wait for search index to update
+      await new Promise((resolve) => setTimeout(resolve, 2000));
+
+      // Test search for "detective solving"
+      const response = await request(app)
+        .get("/api/movies/search")
+        .query({ plot: "detective solving", searchOperator: "must", limit: 10 })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(response.body.data.movies).toBeDefined();
+      expect(Array.isArray(response.body.data.movies)).toBe(true);
+
+      // Find our test movie in the results
+      const foundMovie = response.body.data.movies.find(
+        (m: any) => m.title === "Test Search Movie 1"
+      );
+
+      if (foundMovie) {
+        expect(foundMovie.plot).toContain("detective solving");
+      }
+    });
+
+    test("should search movies by directors", async () => {
+      const testMovie = {
+        title: "Test Search Movie Director",
+        year: 2024,
+        plot: "A test movie",
+        directors: ["Christopher Nolan"],
+      };
+
+      const createResponse = await request(app)
+        .post("/api/movies")
+        .send(testMovie)
+        .expect(201);
+      testMovieIds.push(createResponse.body.data._id);
+
+      // Wait for search index to update
+      await new Promise((resolve) => setTimeout(resolve, 2000));
+
+      // Test search for director
+      const response = await request(app)
+        .get("/api/movies/search")
+        .query({ directors: "Christopher Nolan", limit: 10 })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(response.body.data.movies).toBeDefined();
+    });
+
+    test("should support pagination with skip and limit", async () => {
+      const response = await request(app)
+        .get("/api/movies/search")
+        .query({ plot: "love", limit: 5, skip: 0 })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data.movies.length).toBeLessThanOrEqual(5);
+      expect(response.body.data.totalCount).toBeDefined();
+    });
+
+    test("should return error when no search parameters provided", async () => {
+      const response = await request(app)
+        .get("/api/movies/search")
+        .expect(400);
+
+      expect(response.body.success).toBe(false);
+      expect(response.body.error).toBeDefined();
+    });
+  });
+});
+
+
+describeVectorSearch("Vector Search Integration Tests", () => {
+  let testMovieIds: string[] = [];
+
+  afterEach(async () => {
+    // Clean up test data after each test
+    if (testMovieIds.length > 0) {
+      const moviesCollection = getCollection("movies");
+      await moviesCollection.deleteMany({
+        _id: { $in: testMovieIds.map((id) => new ObjectId(id)) },
+      });
+      testMovieIds = [];
+    }
+  });
+
+  describe("GET /api/movies/vector-search", () => {
+    test("should perform vector search and return similar movies", async () => {
+      const response = await request(app)
+        .get("/api/movies/vector-search")
+        .query({ q: "space adventure", limit: 5 })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(Array.isArray(response.body.data)).toBe(true);
+
+      // If results are returned, verify structure
+      if (response.body.data.length > 0) {
+        const firstResult = response.body.data[0];
+        expect(firstResult).toHaveProperty("_id");
+        expect(firstResult).toHaveProperty("title");
+        expect(firstResult).toHaveProperty("score");
+        expect(typeof firstResult.score).toBe("number");
+
+        // Verify scores are in descending order
+        for (let i = 0; i < response.body.data.length - 1; i++) {
+          expect(response.body.data[i].score).toBeGreaterThanOrEqual(
+            response.body.data[i + 1].score
+          );
+        }
+      }
+    });
+
+    test("should respect limit parameter", async () => {
+      const limit = 3;
+      const response = await request(app)
+        .get("/api/movies/vector-search")
+        .query({ q: "detective mystery", limit })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data.length).toBeLessThanOrEqual(limit);
+    });
+
+    test("should return error when query parameter is missing", async () => {
+      const response = await request(app)
+        .get("/api/movies/vector-search")
+        .expect(400);
+
+      expect(response.body.success).toBe(false);
+      expect(response.body.error).toBeDefined();
+    });
+
+    test("should handle empty query string", async () => {
+      const response = await request(app)
+        .get("/api/movies/vector-search")
+        .query({ q: "" })
+        .expect(400);
+
+      expect(response.body.success).toBe(false);
+    });
+  });
+});
diff --git a/server/express/tests/integration/mongodbSearch.integration.test.ts b/server/express/tests/integration/mongodbSearch.integration.test.ts
index fe25b4d..614a1de 100644
--- a/server/express/tests/integration/mongodbSearch.integration.test.ts
+++ b/server/express/tests/integration/mongodbSearch.integration.test.ts
@@ -1,325 +1,166 @@
 /**
- * MongoDB Search Integration Tests
+ * MongoDB Atlas Search API Integration Tests
  *
- * These tests verify MongoDB Search functionality with a real MongoDB instance.
+ * These tests verify the Atlas Search API endpoints with actual HTTP requests.
  * The tests require:
- * - A MongoDB instance with Search enabled (local MongoDB or Atlas)
+ * - A MongoDB Atlas instance with Search enabled
  * - MONGODB_URI environment variable
  * - ENABLE_SEARCH_TESTS=true environment variable to enable tests
+ * - movieSearchIndex must be configured in Atlas
  *
- * Note: These tests are disabled by default and should only be run against a test MongoDB instance.
+ * Note: These tests are disabled by default and should only be run against a test MongoDB Atlas instance.
  */
 
-import { ObjectId } from "mongodb";
-import { connectToDatabase, getCollection } from "../../src/config/database";
+import request from "supertest";
+import { app } from "../../src/app";
 import { describeSearch } from "./setup";
 
-const SEARCH_INDEX_NAME = "movieSearchIndex";
-const MAX_INDEX_WAIT_SECONDS = 120;
-const POLL_INTERVAL_SECONDS = 5;
+describeSearch("MongoDB Atlas Search API Integration Tests", () => {
 
-describeSearch("MongoDB Search Integration Tests", () => {
-  let testMovieIds: ObjectId[] = [];
+  describe("GET /api/movies/search - Search by plot", () => {
+    test("should find movies with plot search", async () => {
+      const response = await request(app)
+        .get("/api/movies/search")
+        .query({ plot: "detective mystery" })
+        .expect(200);
 
-  beforeAll(async () => {
-    try {
-      // Clean up any leftover test data from previous failed runs
-      await cleanupTestMovies();
-
-      // Create test data
-      await createTestMovies();
-
-      // Create Search index (or verify it exists)
-      await createSearchIndex();
-
-      // Wait for index to be ready
-      await waitForSearchIndexReady();
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(response.body.data.movies).toBeDefined();
+      expect(Array.isArray(response.body.data.movies)).toBe(true);
+      expect(response.body.data.totalCount).toBeDefined();
+    });
 
-      // Wait for documents to be indexed
-      await new Promise((resolve) => setTimeout(resolve, 10000)); // 10 seconds
-    } catch (error) {
-      console.error("❌ Error during setup:", error);
-      // Clean up on setup failure
-      await cleanupTestMovies();
-      throw error;
-    }
-  });
+    test("should return empty results when no movies match search query", async () => {
+      const response = await request(app)
+        .get("/api/movies/search")
+        .query({ plot: "xyzabc123nonexistent" })
+        .expect(200);
 
-  afterAll(async () => {
-    await cleanupTestMovies();
+      expect(response.body.success).toBe(true);
+      expect(response.body.data.movies).toBeDefined();
+      expect(response.body.data.movies.length).toBe(0);
+      expect(response.body.data.totalCount).toBe(0);
+    });
   });
 
-  describe("Search by plot", () => {
-    test("should find movies with 'space adventure' in plot", async () => {
-      const moviesCollection = getCollection("movies");
-
-      // Perform Search query
-      const results = await moviesCollection
-        .aggregate([
-          {
-            $search: {
-              index: SEARCH_INDEX_NAME,
-              text: {
-                query: "space adventure",
-                path: ["plot", "fullplot"],
-              },
-            },
-          },
-          { $limit: 10 },
-        ])
-        .toArray();
-
-      expect(results).toBeDefined();
-      expect(results.length).toBeGreaterThan(0);
-
-      // Verify at least one result contains our test movie
-      const foundTestMovie = results.some(
-        (movie: any) =>
-          movie.plot && movie.plot.toLowerCase().includes("space adventure")
-      );
-      expect(foundTestMovie).toBe(true);
+  describe("GET /api/movies/search - Search by directors", () => {
+    test("should find movies by director name", async () => {
+      const response = await request(app)
+        .get("/api/movies/search")
+        .query({ directors: "Spielberg" })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(response.body.data.movies).toBeDefined();
+      expect(Array.isArray(response.body.data.movies)).toBe(true);
     });
+  });
 
-    test("should return empty array when no movies match search query", async () => {
-      const moviesCollection = getCollection("movies");
-
-      // Search for something that definitely doesn't exist
-      const results = await moviesCollection
-        .aggregate([
-          {
-            $search: {
-              index: SEARCH_INDEX_NAME,
-              text: {
-                query: "xyzabc123nonexistent",
-                path: ["plot", "fullplot"],
-              },
-            },
-          },
-          { $limit: 10 },
-        ])
-        .toArray();
-
-      expect(results).toBeDefined();
-      expect(results.length).toBe(0);
+  describe("GET /api/movies/search - Search by cast", () => {
+    test("should find movies by cast member", async () => {
+      const response = await request(app)
+        .get("/api/movies/search")
+        .query({ cast: "Tom Hanks" })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(response.body.data.movies).toBeDefined();
+      expect(Array.isArray(response.body.data.movies)).toBe(true);
     });
   });
 
-  describe("Search with pagination", () => {
+  describe("GET /api/movies/search - Pagination", () => {
     test("should respect limit parameter", async () => {
-      const moviesCollection = getCollection("movies");
-      const limit = 2;
-
-      const results = await moviesCollection
-        .aggregate([
-          {
-            $search: {
-              index: SEARCH_INDEX_NAME,
-              text: {
-                query: "adventure",
-                path: ["plot", "fullplot"],
-              },
-            },
-          },
-          { $limit: limit },
-        ])
-        .toArray();
-
-      expect(results).toBeDefined();
-      expect(results.length).toBeLessThanOrEqual(limit);
+      const response = await request(app)
+        .get("/api/movies/search")
+        .query({ plot: "adventure", limit: 5 })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data.movies).toBeDefined();
+      expect(response.body.data.movies.length).toBeLessThanOrEqual(5);
     });
 
-    test("should support pagination with skip", async () => {
-      const moviesCollection = getCollection("movies");
-      const limit = 2;
-
+    test("should support pagination with skip and limit", async () => {
       // Get first page
-      const firstPage = await moviesCollection
-        .aggregate([
-          {
-            $search: {
-              index: SEARCH_INDEX_NAME,
-              text: {
-                query: "adventure",
-                path: ["plot", "fullplot"],
-              },
-            },
-          },
-          { $limit: limit },
-        ])
-        .toArray();
+      const firstPage = await request(app)
+        .get("/api/movies/search")
+        .query({ plot: "adventure", limit: 5, skip: 0 })
+        .expect(200);
 
       // Get second page
-      const secondPage = await moviesCollection
-        .aggregate([
-          {
-            $search: {
-              index: SEARCH_INDEX_NAME,
-              text: {
-                query: "adventure",
-                path: ["plot", "fullplot"],
-              },
-            },
-          },
-          { $skip: limit },
-          { $limit: limit },
-        ])
-        .toArray();
-
-      expect(firstPage).toBeDefined();
-      expect(secondPage).toBeDefined();
-
-      // If we have enough results, verify different pages have different results
-      if (firstPage.length === limit && secondPage.length > 0) {
-        const firstPageIds = firstPage.map((m: any) => m._id.toString());
-        const secondPageIds = secondPage.map((m: any) => m._id.toString());
+      const secondPage = await request(app)
+        .get("/api/movies/search")
+        .query({ plot: "adventure", limit: 5, skip: 5 })
+        .expect(200);
+
+      expect(firstPage.body.success).toBe(true);
+      expect(secondPage.body.success).toBe(true);
+
+      // If we have enough results, verify different pages
+      if (
+        firstPage.body.data.movies.length > 0 &&
+        secondPage.body.data.movies.length > 0
+      ) {
+        const firstPageIds = firstPage.body.data.movies.map((m: any) => m._id);
+        const secondPageIds = secondPage.body.data.movies.map((m: any) => m._id);
 
         // Verify no overlap between pages
-        const hasOverlap = firstPageIds.some((id) => secondPageIds.includes(id));
+        const hasOverlap = firstPageIds.some((id: string) =>
+          secondPageIds.includes(id)
+        );
         expect(hasOverlap).toBe(false);
       }
     });
   });
 
-  // ==================== HELPER FUNCTIONS ====================
-
-  /**
-   * Clean up test movies from the database.
-   * This function is idempotent and safe to call multiple times.
-   */
-  async function cleanupTestMovies(): Promise<void> {
-    const moviesCollection = getCollection("movies");
+  describe("GET /api/movies/search - Search operators", () => {
+    test("should support compound search with must operator", async () => {
+      const response = await request(app)
+        .get("/api/movies/search")
+        .query({ plot: "detective", directors: "Nolan", searchOperator: "must" })
+        .expect(200);
 
-    // Clean up by IDs if we have them
-    if (testMovieIds.length > 0) {
-      await moviesCollection.deleteMany({
-        _id: { $in: testMovieIds },
-      });
-      testMovieIds = [];
-    }
-
-    // Also clean up by title pattern to catch any orphaned test data
-    // This ensures idempotency even if previous test runs failed
-    await moviesCollection.deleteMany({
-      title: { $regex: /^Test (Space Adventure|Mystery Movie|Adventure Quest)$/ },
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
     });
-  }
-
-  async function createTestMovies(): Promise<void> {
-    const moviesCollection = getCollection("movies");
-
-    const testMovies = [
-      {
-        title: "Test Space Adventure",
-        year: 2024,
-        plot: "An epic space adventure across the galaxy",
-        genres: ["Sci-Fi", "Adventure"],
-      },
-      {
-        title: "Test Mystery Movie",
-        year: 2024,
-        plot: "A detective solves a mysterious crime",
-        genres: ["Mystery", "Thriller"],
-      },
-      {
-        title: "Test Adventure Quest",
-        year: 2024,
-        plot: "Heroes embark on a dangerous adventure",
-        genres: ["Adventure", "Fantasy"],
-      },
-    ];
-
-    const result = await moviesCollection.insertMany(testMovies);
-    testMovieIds = Object.values(result.insertedIds) as ObjectId[];
-  }
-
-  async function createSearchIndex(): Promise<void> {
-    const db = await connectToDatabase();
-    const moviesCollection = getCollection("movies");
-
-    // Check if index already exists
-    const existingIndexes = await moviesCollection.listSearchIndexes().toArray();
-    const indexExists = existingIndexes.some(
-      (idx: any) => idx.name === SEARCH_INDEX_NAME
-    );
-
-    if (indexExists) {
-      return;
-    }
-
-    // Create the search index definition
-    const indexDefinition = {
-      mappings: {
-        dynamic: false,
-        fields: {
-          plot: {
-            type: "string",
-            analyzer: "lucene.standard",
-          },
-          fullplot: {
-            type: "string",
-            analyzer: "lucene.standard",
-          },
-          directors: {
-            type: "string",
-            analyzer: "lucene.standard",
-          },
-          writers: {
-            type: "string",
-            analyzer: "lucene.standard",
-          },
-          cast: {
-            type: "string",
-            analyzer: "lucene.standard",
-          },
-        },
-      },
-    };
-
-    // Create the index using the createSearchIndexes command
-    try {
-      await db.command({
-        createSearchIndexes: "movies",
-        indexes: [
-          {
-            name: SEARCH_INDEX_NAME,
-            definition: indexDefinition,
-          },
-        ],
-      });
-    } catch (error) {
-      console.error("❌ Error creating search index:", error);
-      throw error;
-    }
-  }
 
-  async function waitForSearchIndexReady(): Promise<void> {
-    const moviesCollection = getCollection("movies");
-    const startTime = Date.now();
-    const maxWaitMillis = MAX_INDEX_WAIT_SECONDS * 1000;
-
-    while (Date.now() - startTime < maxWaitMillis) {
-      const indexes = await moviesCollection.listSearchIndexes().toArray();
-
-      const searchIndex = indexes.find(
-        (idx: any) => idx.name === SEARCH_INDEX_NAME
-      );
+    test("should support compound search with should operator", async () => {
+      const response = await request(app)
+        .get("/api/movies/search")
+        .query({
+          plot: "adventure",
+          cast: "Harrison Ford",
+          searchOperator: "should",
+        })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+    });
+  });
 
-      if (searchIndex) {
-        const status = (searchIndex as any).status;
-        if (status === "READY") {
-          return;
-        }
-      }
+  describe("GET /api/movies/search - Error handling", () => {
+    test("should return 400 when no search parameters provided", async () => {
+      const response = await request(app)
+        .get("/api/movies/search")
+        .expect(400);
 
-      // Wait before polling again
-      await new Promise((resolve) =>
-        setTimeout(resolve, POLL_INTERVAL_SECONDS * 1000)
-      );
-    }
+      expect(response.body.success).toBe(false);
+      expect(response.body.error).toBeDefined();
+    });
 
-    throw new Error(
-      `Search index did not become ready within ${MAX_INDEX_WAIT_SECONDS} seconds`
-    );
-  }
-});
+    test("should return 400 for invalid search operator", async () => {
+      const response = await request(app)
+        .get("/api/movies/search")
+        .query({ plot: "adventure", searchOperator: "invalid" })
+        .expect(400);
 
+      expect(response.body.success).toBe(false);
+      expect(response.body.error).toBeDefined();
+    });
+  });
+});
\ No newline at end of file
diff --git a/server/express/tests/integration/movie.integration.test.ts b/server/express/tests/integration/movie.integration.test.ts
index 6c9d573..3090e98 100644
--- a/server/express/tests/integration/movie.integration.test.ts
+++ b/server/express/tests/integration/movie.integration.test.ts
@@ -1,20 +1,23 @@
 /**
  * Movie CRUD Integration Tests
  *
- * These tests verify the full database operations for movie CRUD functionality.
- * Unlike unit tests, these tests connect to a real MongoDB instance.
+ * These tests verify the full API functionality for movie CRUD operations.
+ * Unlike unit tests, these tests make actual HTTP requests to the Express app
+ * and connect to a real MongoDB instance.
  *
  * Requirements:
  * - MONGODB_URI environment variable must be set
  * - MongoDB instance must be accessible
  */
 
+import request from "supertest";
 import { ObjectId } from "mongodb";
+import { app } from "../../src/app";
 import { getCollection } from "../../src/config/database";
 import { describeIntegration } from "./setup";
 
-describeIntegration("Movie CRUD Integration Tests", () => {
-  let testMovieIds: ObjectId[] = [];
+describeIntegration("Movie CRUD API Integration Tests", () => {
+  let testMovieIds: string[] = [];
 
   beforeAll(async () => {
     // Clean up any orphaned test data from previous failed runs
@@ -33,6 +36,7 @@ describeIntegration("Movie CRUD Integration Tests", () => {
         { title: { $regex: /^Movie to Delete/ } },
         { title: { $regex: /^Delete Test/ } },
         { title: { $regex: /^Find and Delete Test/ } },
+        { title: { $regex: /^Batch Test Movie/ } },
       ],
     });
   });
@@ -42,16 +46,14 @@ describeIntegration("Movie CRUD Integration Tests", () => {
     if (testMovieIds.length > 0) {
       const moviesCollection = getCollection("movies");
       await moviesCollection.deleteMany({
-        _id: { $in: testMovieIds },
+        _id: { $in: testMovieIds.map((id) => new ObjectId(id)) },
       });
       testMovieIds = [];
     }
   });
 
-  describe("Create Operations", () => {
-    test("should create a single movie with insertOne", async () => {
-      const moviesCollection = getCollection("movies");
-
+  describe("POST /api/movies - Create Single Movie", () => {
+    test("should create a single movie", async () => {
       const newMovie = {
         title: "Integration Test Movie",
         year: 2024,
@@ -59,180 +61,219 @@ describeIntegration("Movie CRUD Integration Tests", () => {
         genres: ["Test", "Drama"],
       };
 
-      const result = await moviesCollection.insertOne(newMovie);
+      const response = await request(app)
+        .post("/api/movies")
+        .send(newMovie)
+        .expect(201);
 
-      expect(result.acknowledged).toBe(true);
-      expect(result.insertedId).toBeDefined();
-      expect(result.insertedId).toBeInstanceOf(ObjectId);
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(response.body.data._id).toBeDefined();
+      expect(response.body.data.title).toBe(newMovie.title);
+      expect(response.body.data.year).toBe(newMovie.year);
+      expect(response.body.data.plot).toBe(newMovie.plot);
+      expect(response.body.data.genres).toEqual(newMovie.genres);
 
-      testMovieIds.push(result.insertedId);
+      testMovieIds.push(response.body.data._id.toString());
+    });
 
-      // Verify the movie was actually inserted
-      const insertedMovie = await moviesCollection.findOne({
-        _id: result.insertedId,
-      });
+    test("should return 400 when title is missing", async () => {
+      const invalidMovie = {
+        year: 2024,
+        plot: "Missing title",
+      };
 
-      expect(insertedMovie).toBeDefined();
-      expect(insertedMovie?.title).toBe(newMovie.title);
-      expect(insertedMovie?.year).toBe(newMovie.year);
-      expect(insertedMovie?.plot).toBe(newMovie.plot);
-    });
+      const response = await request(app)
+        .post("/api/movies")
+        .send(invalidMovie)
+        .expect(400);
 
-    test("should create multiple movies with insertMany", async () => {
-      const moviesCollection = getCollection("movies");
+      expect(response.body.success).toBe(false);
+      expect(response.body.error).toBeDefined();
+    });
+  });
 
+  describe("POST /api/movies/batch - Create Multiple Movies", () => {
+    test("should create multiple movies", async () => {
       const newMovies = [
         {
-          title: "Integration Test Movie 1",
+          title: "Batch Test Movie 1",
           year: 2024,
           plot: "First test movie",
           genres: ["Test"],
         },
         {
-          title: "Integration Test Movie 2",
+          title: "Batch Test Movie 2",
           year: 2024,
           plot: "Second test movie",
           genres: ["Test"],
         },
         {
-          title: "Integration Test Movie 3",
+          title: "Batch Test Movie 3",
           year: 2024,
           plot: "Third test movie",
           genres: ["Test"],
         },
       ];
 
-      const result = await moviesCollection.insertMany(newMovies);
+      const response = await request(app)
+        .post("/api/movies/batch")
+        .send(newMovies)
+        .expect(201);
 
-      expect(result.acknowledged).toBe(true);
-      expect(result.insertedCount).toBe(3);
-      expect(Object.keys(result.insertedIds).length).toBe(3);
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(response.body.data.insertedCount).toBe(3);
+      expect(response.body.data.insertedIds).toBeDefined();
+      expect(Object.keys(response.body.data.insertedIds).length).toBe(3);
 
-      testMovieIds.push(...Object.values(result.insertedIds));
+      // Extract IDs from the insertedIds object
+      const ids = Object.values(response.body.data.insertedIds) as string[];
+      testMovieIds.push(...ids);
+    });
 
-      // Verify all movies were inserted
-      const insertedMovies = await moviesCollection
-        .find({ _id: { $in: Object.values(result.insertedIds) } })
-        .toArray();
+    test("should return 400 when request body is not an array", async () => {
+      const response = await request(app)
+        .post("/api/movies/batch")
+        .send({ title: "Single Movie" })
+        .expect(400);
 
-      expect(insertedMovies.length).toBe(3);
+      expect(response.body.success).toBe(false);
+      expect(response.body.error).toBeDefined();
     });
   });
 
-  describe("Read Operations", () => {
-    test("should find a movie by ObjectId", async () => {
-      const moviesCollection = getCollection("movies");
-
+  describe("GET /api/movies/:id - Get Movie by ID", () => {
+    test("should get a movie by ID", async () => {
       // Create a test movie
       const newMovie = {
         title: "Find By ID Test Movie",
         year: 2024,
-        plot: "Testing findOne by ID",
+        plot: "Testing get by ID",
       };
 
-      const insertResult = await moviesCollection.insertOne(newMovie);
-      testMovieIds.push(insertResult.insertedId);
+      const createResponse = await request(app)
+        .post("/api/movies")
+        .send(newMovie)
+        .expect(201);
 
-      // Find the movie by ID
-      const foundMovie = await moviesCollection.findOne({
-        _id: insertResult.insertedId,
-      });
+      const movieId = createResponse.body.data._id.toString();
+      testMovieIds.push(movieId);
+
+      // Get the movie by ID
+      const response = await request(app)
+        .get(`/api/movies/${movieId}`)
+        .expect(200);
 
-      expect(foundMovie).toBeDefined();
-      expect(foundMovie?._id.toString()).toBe(insertResult.insertedId.toString());
-      expect(foundMovie?.title).toBe(newMovie.title);
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(response.body.data._id).toBe(movieId);
+      expect(response.body.data.title).toBe(newMovie.title);
     });
 
-    test("should find movies with filters", async () => {
-      const moviesCollection = getCollection("movies");
+    test("should return 404 for non-existent movie", async () => {
+      const fakeId = new ObjectId().toString();
 
-      // Create test movies
-      const testMovies = [
-        {
-          title: "Action Movie 2024",
-          year: 2024,
-          genres: ["Action"],
-        },
-        {
-          title: "Drama Movie 2024",
-          year: 2024,
-          genres: ["Drama"],
-        },
-        {
-          title: "Action Movie 2023",
-          year: 2023,
-          genres: ["Action"],
-        },
-      ];
+      const response = await request(app)
+        .get(`/api/movies/${fakeId}`)
+        .expect(404);
 
-      const insertResult = await moviesCollection.insertMany(testMovies);
-      testMovieIds.push(...Object.values(insertResult.insertedIds));
+      expect(response.body.success).toBe(false);
+      expect(response.body.error).toBeDefined();
+    });
 
-      // Find movies by year
-      const movies2024 = await moviesCollection
-        .find({ year: 2024 })
-        .toArray();
+    test("should return 400 for invalid ObjectId format", async () => {
+      const response = await request(app)
+        .get("/api/movies/invalid-id")
+        .expect(400);
 
-      const testMovies2024 = movies2024.filter((m) =>
-        testMovieIds.some((id) => id.toString() === m._id.toString())
-      );
+      expect(response.body.success).toBe(false);
+      expect(response.body.error).toBeDefined();
+    });
+  });
 
-      expect(testMovies2024.length).toBe(2);
+  describe("GET /api/movies - Get All Movies with Filters", () => {
+    test("should get movies with year filter", async () => {
+      // Create a test movie with a specific year
+      const testMovie = {
+        title: "Action Movie 2024",
+        year: 2024,
+        genres: ["Action"],
+      };
 
-      // Find movies by genre
-      const actionMovies = await moviesCollection
-        .find({ genres: { $regex: /Action/i } })
-        .toArray();
+      const createResponse = await request(app)
+        .post("/api/movies")
+        .send(testMovie)
+        .expect(201);
 
-      const testActionMovies = actionMovies.filter((m) =>
-        testMovieIds.some((id) => id.toString() === m._id.toString())
-      );
+      testMovieIds.push(createResponse.body.data._id.toString());
 
-      expect(testActionMovies.length).toBe(2);
-    });
+      // Get movies from 2024
+      const response = await request(app)
+        .get("/api/movies")
+        .query({ year: 2024 })
+        .expect(200);
 
-    test("should support pagination with limit and skip", async () => {
-      const moviesCollection = getCollection("movies");
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(Array.isArray(response.body.data)).toBe(true);
+      expect(response.body.data.length).toBeGreaterThan(0);
 
-      // Create 5 test movies
-      const testMovies = Array.from({ length: 5 }, (_, i) => ({
-        title: `Pagination Test Movie ${i + 1}`,
-        year: 2024,
-      }));
+      // Verify all returned movies have year 2024
+      const allHaveCorrectYear = response.body.data.every(
+        (m: any) => m.year === 2024
+      );
+      expect(allHaveCorrectYear).toBe(true);
+    });
 
-      const insertResult = await moviesCollection.insertMany(testMovies);
-      testMovieIds.push(...Object.values(insertResult.insertedIds));
+    test("should get movies with genre filter", async () => {
+      // Create a test movie with a specific genre
+      const testMovie = {
+        title: "Action Movie 2024",
+        year: 2024,
+        genres: ["Action", "Thriller"],
+      };
 
-      // Get first page (2 movies)
-      const firstPage = await moviesCollection
-        .find({ _id: { $in: testMovieIds } })
-        .limit(2)
-        .toArray();
+      const createResponse = await request(app)
+        .post("/api/movies")
+        .send(testMovie)
+        .expect(201);
 
-      expect(firstPage.length).toBe(2);
+      testMovieIds.push(createResponse.body.data._id.toString());
 
-      // Get second page (2 movies, skip first 2)
-      const secondPage = await moviesCollection
-        .find({ _id: { $in: testMovieIds } })
-        .skip(2)
-        .limit(2)
-        .toArray();
+      // Get action movies
+      const response = await request(app)
+        .get("/api/movies")
+        .query({ genre: "Action" })
+        .expect(200);
 
-      expect(secondPage.length).toBe(2);
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(Array.isArray(response.body.data)).toBe(true);
+      expect(response.body.data.length).toBeGreaterThan(0);
 
-      // Verify different results
-      const firstPageIds = firstPage.map((m) => m._id.toString());
-      const secondPageIds = secondPage.map((m) => m._id.toString());
-      const hasOverlap = firstPageIds.some((id) => secondPageIds.includes(id));
+      // Verify all returned movies have "Action" in their genres
+      const allHaveActionGenre = response.body.data.every((m: any) =>
+        m.genres && m.genres.some((g: string) => /action/i.test(g))
+      );
+      expect(allHaveActionGenre).toBe(true);
+    });
 
-      expect(hasOverlap).toBe(false);
+    test("should support pagination with limit and skip", async () => {
+      const response = await request(app)
+        .get("/api/movies")
+        .query({ limit: 5, skip: 0 })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(Array.isArray(response.body.data)).toBe(true);
+      expect(response.body.data.length).toBeLessThanOrEqual(5);
     });
   });
 
-  describe("Update Operations", () => {
-    test("should update a single movie with updateOne", async () => {
-      const moviesCollection = getCollection("movies");
-
+  describe("PATCH /api/movies/:id - Update Single Movie", () => {
+    test("should update a single movie", async () => {
       // Create a test movie
       const newMovie = {
         title: "Original Title",
@@ -240,32 +281,46 @@ describeIntegration("Movie CRUD Integration Tests", () => {
         plot: "Original plot",
       };
 
-      const insertResult = await moviesCollection.insertOne(newMovie);
-      testMovieIds.push(insertResult.insertedId);
+      const createResponse = await request(app)
+        .post("/api/movies")
+        .send(newMovie)
+        .expect(201);
+
+      const movieId = createResponse.body.data._id.toString();
+      testMovieIds.push(movieId);
 
       // Update the movie
-      const updateResult = await moviesCollection.updateOne(
-        { _id: insertResult.insertedId },
-        { $set: { title: "Updated Title", plot: "Updated plot" } }
-      );
+      const updateData = {
+        title: "Updated Title",
+        plot: "Updated plot",
+      };
 
-      expect(updateResult.acknowledged).toBe(true);
-      expect(updateResult.matchedCount).toBe(1);
-      expect(updateResult.modifiedCount).toBe(1);
+      const response = await request(app)
+        .patch(`/api/movies/${movieId}`)
+        .send(updateData)
+        .expect(200);
 
-      // Verify the update
-      const updatedMovie = await moviesCollection.findOne({
-        _id: insertResult.insertedId,
-      });
-
-      expect(updatedMovie?.title).toBe("Updated Title");
-      expect(updatedMovie?.plot).toBe("Updated plot");
-      expect(updatedMovie?.year).toBe(2024); // Unchanged field
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(response.body.data.title).toBe("Updated Title");
+      expect(response.body.data.plot).toBe("Updated plot");
+      expect(response.body.data.year).toBe(2024); // Unchanged field
     });
 
-    test("should update multiple movies with updateMany", async () => {
-      const moviesCollection = getCollection("movies");
+    test("should return 404 for non-existent movie", async () => {
+      const fakeId = new ObjectId().toString();
 
+      const response = await request(app)
+        .patch(`/api/movies/${fakeId}`)
+        .send({ title: "Updated" })
+        .expect(404);
+
+      expect(response.body.success).toBe(false);
+    });
+  });
+
+  describe("PATCH /api/movies - Update Multiple Movies", () => {
+    test("should update multiple movies", async () => {
       // Create test movies
       const testMovies = [
         { title: "Movie 1", year: 2024, rated: "PG" },
@@ -273,128 +328,154 @@ describeIntegration("Movie CRUD Integration Tests", () => {
         { title: "Movie 3", year: 2024, rated: "R" },
       ];
 
-      const insertResult = await moviesCollection.insertMany(testMovies);
-      testMovieIds.push(...Object.values(insertResult.insertedIds));
-
-      // Update all PG movies
-      const updateResult = await moviesCollection.updateMany(
-        { _id: { $in: testMovieIds }, rated: "PG" },
-        { $set: { rated: "PG-13" } }
-      );
-
-      expect(updateResult.acknowledged).toBe(true);
-      expect(updateResult.matchedCount).toBe(2);
-      expect(updateResult.modifiedCount).toBe(2);
-
-      // Verify the updates
-      const updatedMovies = await moviesCollection
-        .find({ _id: { $in: testMovieIds }, rated: "PG-13" })
-        .toArray();
-
-      expect(updatedMovies.length).toBe(2);
+      const createdIds: string[] = [];
+      for (const movie of testMovies) {
+        const createResponse = await request(app)
+          .post("/api/movies")
+          .send(movie)
+          .expect(201);
+        createdIds.push(createResponse.body.data._id.toString());
+        testMovieIds.push(createResponse.body.data._id.toString());
+      }
+
+      // Update all PG movies to PG-13
+      const response = await request(app)
+        .patch("/api/movies")
+        .send({
+          filter: { _id: { $in: createdIds }, rated: "PG" },
+          update: { rated: "PG-13" },
+        })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(response.body.data.modifiedCount).toBe(2);
     });
   });
 
-  describe("Delete Operations", () => {
-    test("should delete a single movie with deleteOne", async () => {
-      const moviesCollection = getCollection("movies");
-
+  describe("DELETE /api/movies/:id - Delete Single Movie", () => {
+    test("should delete a single movie", async () => {
       // Create a test movie
       const newMovie = {
         title: "Movie to Delete",
         year: 2024,
       };
 
-      const insertResult = await moviesCollection.insertOne(newMovie);
-      const movieId = insertResult.insertedId;
+      const createResponse = await request(app)
+        .post("/api/movies")
+        .send(newMovie)
+        .expect(201);
 
-      // Track the ID in case the test fails before deletion
+      const movieId = createResponse.body.data._id.toString();
       testMovieIds.push(movieId);
 
       // Delete the movie
-      const deleteResult = await moviesCollection.deleteOne({
-        _id: movieId,
-      });
+      const response = await request(app)
+        .delete(`/api/movies/${movieId}`)
+        .expect(200);
 
-      expect(deleteResult.acknowledged).toBe(true);
-      expect(deleteResult.deletedCount).toBe(1);
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(response.body.data.deletedCount).toBe(1);
 
-      // Verify deletion
-      const deletedMovie = await moviesCollection.findOne({ _id: movieId });
-      expect(deletedMovie).toBeNull();
+      // Verify deletion - should return 404
+      await request(app).get(`/api/movies/${movieId}`).expect(404);
 
       // Remove from tracking since it's successfully deleted
-      testMovieIds = testMovieIds.filter(id => id.toString() !== movieId.toString());
+      testMovieIds = testMovieIds.filter((id) => id !== movieId);
     });
 
-    test("should delete multiple movies with deleteMany", async () => {
-      const moviesCollection = getCollection("movies");
-
-      // Create test movies
-      const testMovies = [
-        { title: "Delete Test 1", year: 2024 },
-        { title: "Delete Test 2", year: 2024 },
-        { title: "Delete Test 3", year: 2024 },
-      ];
-
-      const insertResult = await moviesCollection.insertMany(testMovies);
-      const movieIds = Object.values(insertResult.insertedIds);
-
-      // Track the IDs in case the test fails before deletion
-      testMovieIds.push(...movieIds);
-
-      // Delete all test movies
-      const deleteResult = await moviesCollection.deleteMany({
-        _id: { $in: movieIds },
-      });
-
-      expect(deleteResult.acknowledged).toBe(true);
-      expect(deleteResult.deletedCount).toBe(3);
-
-      // Verify deletion
-      const remainingMovies = await moviesCollection
-        .find({ _id: { $in: movieIds } })
-        .toArray();
+    test("should return 404 when deleting non-existent movie", async () => {
+      const fakeId = new ObjectId().toString();
 
-      expect(remainingMovies.length).toBe(0);
+      const response = await request(app)
+        .delete(`/api/movies/${fakeId}`)
+        .expect(404);
 
-      // Remove from tracking since they're successfully deleted
-      testMovieIds = testMovieIds.filter(
-        id => !movieIds.some(deletedId => deletedId.toString() === id.toString())
-      );
+      expect(response.body.success).toBe(false);
     });
+  });
 
-    test("should find and delete a movie with findOneAndDelete", async () => {
-      const moviesCollection = getCollection("movies");
-
+  describe("DELETE /api/movies/:id/find-and-delete - Find and Delete", () => {
+    test("should atomically find and delete a movie", async () => {
       // Create a test movie
       const newMovie = {
         title: "Find and Delete Test",
         year: 2024,
-        plot: "This movie will be found and deleted",
+        plot: "Testing find and delete",
       };
 
-      const insertResult = await moviesCollection.insertOne(newMovie);
-      const movieId = insertResult.insertedId;
+      const createResponse = await request(app)
+        .post("/api/movies")
+        .send(newMovie)
+        .expect(201);
 
-      // Track the ID in case the test fails before deletion
+      const movieId = createResponse.body.data._id.toString();
       testMovieIds.push(movieId);
 
-      // Find and delete the movie
-      const result = await moviesCollection.findOneAndDelete({
-        _id: movieId,
-      });
+      // Find and delete
+      const response = await request(app)
+        .delete(`/api/movies/${movieId}/find-and-delete`)
+        .expect(200);
 
-      expect(result).toBeDefined();
-      expect(result?._id.toString()).toBe(movieId.toString());
-      expect(result?.title).toBe(newMovie.title);
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(response.body.data._id).toBe(movieId);
+      expect(response.body.data.title).toBe(newMovie.title);
 
       // Verify deletion
-      const deletedMovie = await moviesCollection.findOne({ _id: movieId });
-      expect(deletedMovie).toBeNull();
+      await request(app).get(`/api/movies/${movieId}`).expect(404);
 
-      // Remove from tracking since it's successfully deleted
-      testMovieIds = testMovieIds.filter(id => id.toString() !== movieId.toString());
+      // Remove from tracking
+      testMovieIds = testMovieIds.filter((id) => id !== movieId);
+    });
+  });
+
+  describe("DELETE /api/movies - Delete Multiple Movies", () => {
+    test("should delete multiple movies", async () => {
+      // Create test movies
+      const testMovies = [
+        { title: "Delete Test 1", year: 2024 },
+        { title: "Delete Test 2", year: 2024 },
+        { title: "Delete Test 3", year: 2024 },
+      ];
+
+      const createdIds: string[] = [];
+      for (const movie of testMovies) {
+        const createResponse = await request(app)
+          .post("/api/movies")
+          .send(movie)
+          .expect(201);
+        createdIds.push(createResponse.body.data._id.toString());
+        testMovieIds.push(createResponse.body.data._id.toString());
+      }
+
+      // Delete all test movies using filter
+      const response = await request(app)
+        .delete("/api/movies")
+        .send({ filter: { _id: { $in: createdIds } } })
+        .expect(200);
+
+      expect(response.body.success).toBe(true);
+      expect(response.body.data).toBeDefined();
+      expect(response.body.data.deletedCount).toBe(3);
+
+      // Verify deletion
+      for (const id of createdIds) {
+        await request(app).get(`/api/movies/${id}`).expect(404);
+      }
+
+      // Remove from tracking
+      testMovieIds = testMovieIds.filter((id) => !createdIds.includes(id));
+    });
+
+    test("should return 400 when filter is missing", async () => {
+      const response = await request(app)
+        .delete("/api/movies")
+        .send({})
+        .expect(400);
+
+      expect(response.body.success).toBe(false);
     });
   });
 });
diff --git a/server/express/tests/integration/setup.ts b/server/express/tests/integration/setup.ts
index fe97dc7..bd628ea 100644
--- a/server/express/tests/integration/setup.ts
+++ b/server/express/tests/integration/setup.ts
@@ -32,6 +32,14 @@ export function isSearchTestEnabled(): boolean {
   return process.env.ENABLE_SEARCH_TESTS === "true" && isIntegrationTestEnabled();
 }
 
+/**
+ * Check if Vector Search tests should run
+ * Vector Search tests require VOYAGE_API_KEY environment variable
+ */
+export function isVectorSearchEnabled(): boolean {
+    return !!process.env.VOYAGE_API_KEY && process.env.VOYAGE_API_KEY.trim().length > 0;
+}
+
 // Track whether we've already shown the skip messages to avoid duplicates
 let hasShownIntegrationSkipMessage = false;
 let hasShownSearchSkipMessage = false;
@@ -74,6 +82,28 @@ export const describeSearch: jest.Describe = isSearchTestEnabled()
       return describe.skip(...args);
     }) as jest.Describe;
 
+/**
+ * Conditional describe for Vector Search tests
+ */
+/**
+ * Get the appropriate describe function based on whether Vector Search tests are enabled
+ * Usage: describeVectorSearch("My Vector Search Test Suite", () => { ... })
+ * This will skip the entire suite if VOYAGE_API_KEY is not set
+ */
+export const describeVectorSearch: jest.Describe = isVectorSearchEnabled()
+    ? describe
+    : ((...args: Parameters<jest.Describe>) => {
+        if (!hasShownSearchSkipMessage) {
+            console.log(`
+⚠️  Vector Search tests skipped: VOYAGE_API_KEY environment variable is not set
+   To run Vector Search integration tests, set VOYAGE_API_KEY in your .env file
+   Example: VOYAGE_API_KEY=your-api-key npm run test:integration
+`);
+            hasShownSearchSkipMessage = true;
+        }
+        return describe.skip(...args);
+    }) as jest.Describe;
+
 // Global setup - runs once before all tests
 beforeAll(async () => {
   try {

From 78206d30a23fa00ff0b023fd229a6339f72e0c6f Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Thu, 6 Nov 2025 22:55:34 -0500
Subject: [PATCH 094/110] Update CI workflow to also run integration tests

---
 .github/scripts/generate-test-summary-jest.sh | 151 +++++++++++-------
 .github/workflows/run-express-tests.yml       |  22 ++-
 2 files changed, 113 insertions(+), 60 deletions(-)

diff --git a/.github/scripts/generate-test-summary-jest.sh b/.github/scripts/generate-test-summary-jest.sh
index 6bbdf35..48e86bf 100644
--- a/.github/scripts/generate-test-summary-jest.sh
+++ b/.github/scripts/generate-test-summary-jest.sh
@@ -1,83 +1,122 @@
 #!/bin/bash
 set -e
 
-# Generate Test Summary from Jest JSON Output
-# Usage: ./generate-test-summary-jest.sh <path-to-jest-json-file>
+# Generate Detailed Test Summary from Multiple Jest JSON Output Files
+# Shows breakdown by test type (unit vs integration)
+# Usage: ./generate-test-summary-jest.sh <unit-json> <integration-json>
 
-JSON_FILE="${1:-test-results.json}"
+UNIT_JSON="${1:-}"
+INTEGRATION_JSON="${2:-}"
 
 echo "## Test Results" >> $GITHUB_STEP_SUMMARY
 echo "" >> $GITHUB_STEP_SUMMARY
 
-# Parse test results from Jest JSON output
-if [ -f "$JSON_FILE" ]; then
-  # Extract test counts using jq or grep/sed
-  # Jest JSON structure: { "numTotalTests": N, "numPassedTests": N, "numFailedTests": N, "numPendingTests": N, ... }
-  
+# Function to parse Jest JSON file
+parse_json() {
+  local json_file="$1"
+  local test_type="$2"
+
+  if [ ! -f "$json_file" ]; then
+    echo "0 0 0 0"
+    return
+  fi
+
   if command -v jq &> /dev/null; then
     # Use jq if available (preferred)
-    total_tests=$(jq -r '.numTotalTests // 0' "$JSON_FILE")
-    passed=$(jq -r '.numPassedTests // 0' "$JSON_FILE")
-    failed=$(jq -r '.numFailedTests // 0' "$JSON_FILE")
-    skipped=$(jq -r '.numPendingTests // 0' "$JSON_FILE")
-    
-    # Extract failed test details
-    failed_tests_file=$(mktemp)
-    jq -r '.testResults[]? | select(.status == "failed") | .assertionResults[]? | select(.status == "failed") | "\(.ancestorTitles | join(" > ")) > \(.title)"' "$JSON_FILE" > "$failed_tests_file" 2>/dev/null || true
+    total_tests=$(jq -r '.numTotalTests // 0' "$json_file")
+    passed=$(jq -r '.numPassedTests // 0' "$json_file")
+    failed=$(jq -r '.numFailedTests // 0' "$json_file")
+    skipped=$(jq -r '.numPendingTests // 0' "$json_file")
   else
     # Fallback to grep/sed if jq is not available
-    total_tests=$(grep -oP '"numTotalTests":\s*\K[0-9]+' "$JSON_FILE" | head -1)
-    passed=$(grep -oP '"numPassedTests":\s*\K[0-9]+' "$JSON_FILE" | head -1)
-    failed=$(grep -oP '"numFailedTests":\s*\K[0-9]+' "$JSON_FILE" | head -1)
-    skipped=$(grep -oP '"numPendingTests":\s*\K[0-9]+' "$JSON_FILE" | head -1)
-    
-    # Extract failed test names (basic extraction without jq)
-    failed_tests_file=$(mktemp)
-    grep -oP '"fullName":\s*"\K[^"]*' "$JSON_FILE" | while read -r line; do
-      if echo "$line" | grep -q "failed"; then
-        echo "$line" >> "$failed_tests_file"
-      fi
-    done 2>/dev/null || true
+    total_tests=$(grep -oP '"numTotalTests":\s*\K[0-9]+' "$json_file" | head -1)
+    passed=$(grep -oP '"numPassedTests":\s*\K[0-9]+' "$json_file" | head -1)
+    failed=$(grep -oP '"numFailedTests":\s*\K[0-9]+' "$json_file" | head -1)
+    skipped=$(grep -oP '"numPendingTests":\s*\K[0-9]+' "$json_file" | head -1)
   fi
-  
+
   # Default to 0 if values are empty
   total_tests=${total_tests:-0}
   passed=${passed:-0}
   failed=${failed:-0}
   skipped=${skipped:-0}
 
-  echo "| Status | Count |" >> $GITHUB_STEP_SUMMARY
-  echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
-  echo "| ✅ Passed | $passed |" >> $GITHUB_STEP_SUMMARY
-  echo "| ❌ Failed | $failed |" >> $GITHUB_STEP_SUMMARY
-  echo "| ⏭️ Skipped | $skipped |" >> $GITHUB_STEP_SUMMARY
-  echo "| **Total** | **$total_tests** |" >> $GITHUB_STEP_SUMMARY
+  echo "$total_tests $passed $failed $skipped"
+}
+
+# Parse both files
+read -r unit_tests unit_passed unit_failed unit_skipped <<< "$(parse_json "$UNIT_JSON" "Unit")"
+read -r int_tests int_passed int_failed int_skipped <<< "$(parse_json "$INTEGRATION_JSON" "Integration")"
+
+# Calculate totals
+total_tests=$((unit_tests + int_tests))
+total_passed=$((unit_passed + int_passed))
+total_failed=$((unit_failed + int_failed))
+total_skipped=$((unit_skipped + int_skipped))
+
+# Display detailed breakdown
+echo "### Summary by Test Type" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+echo "| Test Type | Passed | Failed | Skipped | Total |" >> $GITHUB_STEP_SUMMARY
+echo "|-----------|--------|--------|---------|-------|" >> $GITHUB_STEP_SUMMARY
+
+if [ -f "$UNIT_JSON" ]; then
+  echo "| 🔧 Unit Tests | $unit_passed | $unit_failed | $unit_skipped | $unit_tests |" >> $GITHUB_STEP_SUMMARY
+fi
+
+if [ -f "$INTEGRATION_JSON" ]; then
+  echo "| 🔗 Integration Tests | $int_passed | $int_failed | $int_skipped | $int_tests |" >> $GITHUB_STEP_SUMMARY
+fi
+
+echo "| **Total** | **$total_passed** | **$total_failed** | **$total_skipped** | **$total_tests** |" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# Overall status
+echo "### Overall Status" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+echo "| Status | Count |" >> $GITHUB_STEP_SUMMARY
+echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
+echo "| ✅ Passed | $total_passed |" >> $GITHUB_STEP_SUMMARY
+echo "| ❌ Failed | $total_failed |" >> $GITHUB_STEP_SUMMARY
+echo "| ⏭️ Skipped | $total_skipped |" >> $GITHUB_STEP_SUMMARY
+echo "| **Total** | **$total_tests** |" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# List failed tests if any
+if [ $total_failed -gt 0 ]; then
+  echo "### ❌ Failed Tests" >> $GITHUB_STEP_SUMMARY
   echo "" >> $GITHUB_STEP_SUMMARY
 
-  # List failed tests if any
-  if [ "$failed" -gt 0 ]; then
-    echo "### ❌ Failed Tests" >> $GITHUB_STEP_SUMMARY
-    echo "" >> $GITHUB_STEP_SUMMARY
-    
-    if [ -s "$failed_tests_file" ]; then
-      while IFS= read -r test; do
-        echo "- \`$test\`" >> $GITHUB_STEP_SUMMARY
-      done < "$failed_tests_file"
-    else
-      echo "_Unable to parse individual test names_" >> $GITHUB_STEP_SUMMARY
+  failed_tests_file=$(mktemp)
+
+  # Extract failed tests from both files
+  for json_file in "$UNIT_JSON" "$INTEGRATION_JSON"; do
+    if [ -f "$json_file" ]; then
+      if command -v jq &> /dev/null; then
+        jq -r '.testResults[]? | select(.status == "failed") | .assertionResults[]? | select(.status == "failed") | "\(.ancestorTitles | join(" > ")) > \(.title)"' "$json_file" >> "$failed_tests_file" 2>/dev/null || true
+      else
+        # Basic fallback without jq
+        grep -oP '"fullName":\s*"\K[^"]*' "$json_file" | while read -r line; do
+          if echo "$line" | grep -q "failed"; then
+            echo "$line" >> "$failed_tests_file"
+          fi
+        done 2>/dev/null || true
+      fi
     fi
-    
-    echo "" >> $GITHUB_STEP_SUMMARY
-    echo "❌ **Tests failed!**" >> $GITHUB_STEP_SUMMARY
-    rm -f "$failed_tests_file"
-    exit 1
+  done
+
+  if [ -s "$failed_tests_file" ]; then
+    while IFS= read -r test; do
+      echo "- \`$test\`" >> $GITHUB_STEP_SUMMARY
+    done < "$failed_tests_file"
   else
-    echo "✅ **All tests passed!**" >> $GITHUB_STEP_SUMMARY
+    echo "_Unable to parse individual test names_" >> $GITHUB_STEP_SUMMARY
   fi
-  
+
+  echo "" >> $GITHUB_STEP_SUMMARY
+  echo "❌ **Tests failed!**" >> $GITHUB_STEP_SUMMARY
   rm -f "$failed_tests_file"
-else
-  echo "⚠️ No test results found at: $JSON_FILE" >> $GITHUB_STEP_SUMMARY
   exit 1
+else
+  echo "✅ **All tests passed!**" >> $GITHUB_STEP_SUMMARY
 fi
-
diff --git a/.github/workflows/run-express-tests.yml b/.github/workflows/run-express-tests.yml
index e13673e..b180844 100644
--- a/.github/workflows/run-express-tests.yml
+++ b/.github/workflows/run-express-tests.yml
@@ -4,9 +4,13 @@ on:
   pull_request_target:
     branches:
       - development
+    paths:
+      - 'server/express/**'
   push:
     branches:
       - development
+    paths:
+      - 'server/express/**'
 
 jobs:
   test:
@@ -33,11 +37,18 @@ jobs:
       - name: Install dependencies
         run: npm install
 
-      - name: Run tests
-        run: npm test -- --json --outputFile=test-results.json || true
+      - name: Run unit tests
+        run: npm run test:unit -- --json --outputFile=test-results-unit.json || true
         env:
           MONGODB_URI: ${{ secrets.MFLIX_URI }}
 
+      - name: Run integration tests
+        run: npm run test:integration -- --json --outputFile=test-results-integration.json || true
+        env:
+          MONGODB_URI: ${{ secrets.MFLIX_URI }}
+          ENABLE_SEARCH_TESTS: true
+          VOYAGE_API_KEY: ${{ secrets.VOYAGE_AI }}
+
       - name: Upload test results
         uses: actions/upload-artifact@v4
         if: always()
@@ -45,7 +56,8 @@ jobs:
           name: test-results
           path: |
             server/express/coverage/
-            server/express/test-results.json
+            server/express/test-results-unit.json
+            server/express/test-results-integration.json
           retention-days: 30
 
       - name: Generate Test Summary
@@ -53,4 +65,6 @@ jobs:
         working-directory: .
         run: |
           chmod +x .github/scripts/generate-test-summary-jest.sh
-          .github/scripts/generate-test-summary-jest.sh server/express/test-results.json
+          .github/scripts/generate-test-summary-jest.sh \
+            server/express/test-results-unit.json \
+            server/express/test-results-integration.json

From a1e276fb21a56a3919e5e27ad4e6dd5d65d6beb7 Mon Sep 17 00:00:00 2001
From: Jordan Smith <45415425+jordan-smith721@users.noreply.github.com>
Date: Fri, 7 Nov 2025 11:52:31 -0500
Subject: [PATCH 095/110] Restructure files into mflix directory (#32)

---
 .github/workflows/run-express-tests.yml       |  16 +-
 {client => mflix/client}/.env.example         |   0
 {client => mflix/client}/.gitignore           |   0
 mflix/client/README.md                        | 159 ++++++++++++++++++
 .../app/aggregations/aggregations.module.css  |   0
 .../client}/app/aggregations/page.tsx         |   0
 .../ActionButtons/ActionButtons.module.css    |   0
 .../ActionButtons/ActionButtons.tsx           |   0
 .../app/components/ActionButtons/index.ts     |   0
 .../components/AddMovieForm/AddMovieForm.tsx  |   0
 .../app/components/AddMovieForm/index.ts      |   0
 .../BatchEditMovieForm/BatchEditMovieForm.tsx |   0
 .../components/BatchEditMovieForm/index.ts    |   0
 .../EditMovieForm/EditMovieForm.module.css    |   0
 .../EditMovieForm/EditMovieForm.tsx           |   0
 .../app/components/EditMovieForm/index.ts     |   0
 .../LoadingSkeleton.module.css                |   0
 .../LoadingSkeleton/LoadingSkeleton.tsx       |   0
 .../app/components/LoadingSkeleton/index.ts   |   0
 .../components/MovieCard/MovieCard.module.css |   0
 .../app/components/MovieCard/MovieCard.tsx    |   0
 .../client}/app/components/MovieCard/index.ts |   0
 .../PageSizeSelector.module.css               |   0
 .../PageSizeSelector/PageSizeSelector.tsx     |   0
 .../app/components/PageSizeSelector/index.ts  |   0
 .../Pagination/Pagination.module.css          |   0
 .../app/components/Pagination/Pagination.tsx  |   0
 .../app/components/Pagination/index.ts        |   0
 .../SearchMovieModal.module.css               |   0
 .../SearchMovieModal/SearchMovieModal.tsx     |   0
 .../app/components/SearchMovieModal/index.ts  |   0
 .../client}/app/components/index.ts           |   0
 .../app/components/ui/ErrorDisplay.tsx        |   0
 .../app/components/ui/LoadingSpinner.tsx      |   0
 .../client}/app/components/ui/index.ts        |   0
 {client => mflix/client}/app/globals.css      |   0
 {client => mflix/client}/app/home.module.css  |   0
 .../client}/app/layout.module.css             |   0
 {client => mflix/client}/app/layout.tsx       |   0
 {client => mflix/client}/app/lib/api.ts       |   0
 {client => mflix/client}/app/lib/constants.ts |   0
 {client => mflix/client}/app/lib/utils.ts     |   0
 .../client}/app/movie/[id]/error.module.css   |   0
 .../client}/app/movie/[id]/error.tsx          |   0
 .../client}/app/movie/[id]/loading.tsx        |   0
 .../app/movie/[id]/not-found.module.css       |   0
 .../client}/app/movie/[id]/not-found.tsx      |   0
 .../client}/app/movie/[id]/page.module.css    |   0
 .../client}/app/movie/[id]/page.tsx           |   0
 {client => mflix/client}/app/movies/error.tsx |   0
 .../client}/app/movies/loading.tsx            |   0
 .../client}/app/movies/movies.module.css      |   0
 .../client}/app/movies/page.module.css        |   0
 {client => mflix/client}/app/movies/page.tsx  |   0
 {client => mflix/client}/app/page.tsx         |   0
 .../client}/app/types/aggregations.ts         |   0
 {client => mflix/client}/app/types/movie.ts   |   0
 {client => mflix/client}/eslint.config.mjs    |   0
 {client => mflix/client}/next.config.ts       |   0
 {client => mflix/client}/package.json         |   0
 {client => mflix/client}/tsconfig.json        |   2 +-
 .../server/js-express}/.env.example           |   0
 .../server/js-express}/.gitignore             |   0
 .../server/js-express}/jest.config.json       |   0
 .../js-express}/jest.integration.config.json  |   0
 .../server/js-express}/package.json           |   0
 .../server/js-express}/src/app.ts             |   0
 .../server/js-express}/src/config/database.ts |   0
 .../server/js-express}/src/config/swagger.ts  |   0
 .../src/controllers/movieController.ts        |   0
 .../server/js-express}/src/routes/movies.ts   |   0
 .../server/js-express}/src/types/index.ts     |   0
 .../js-express}/src/utils/errorHandler.ts     |   0
 .../tests/controllers/movieController.test.ts |   0
 .../js-express}/tests/integration/README.md   |   2 +-
 .../advancedEndpoints.integration.test.ts     |   0
 .../mongodbSearch.integration.test.ts         |   0
 .../integration/movie.integration.test.ts     |   0
 .../js-express}/tests/integration/setup.ts    |   0
 .../server/js-express}/tests/setup.ts         |   0
 .../js-express}/tests/utils/testHelpers.ts    |   0
 .../server/js-express}/tsconfig.json          |   0
 mflix/server/python-fastapi/tests/README.md   |   4 +-
 .../tests/integration/conftest.py             |   4 +-
 84 files changed, 173 insertions(+), 14 deletions(-)
 rename {client => mflix/client}/.env.example (100%)
 rename {client => mflix/client}/.gitignore (100%)
 create mode 100644 mflix/client/README.md
 rename {client => mflix/client}/app/aggregations/aggregations.module.css (100%)
 rename {client => mflix/client}/app/aggregations/page.tsx (100%)
 rename {client => mflix/client}/app/components/ActionButtons/ActionButtons.module.css (100%)
 rename {client => mflix/client}/app/components/ActionButtons/ActionButtons.tsx (100%)
 rename {client => mflix/client}/app/components/ActionButtons/index.ts (100%)
 rename {client => mflix/client}/app/components/AddMovieForm/AddMovieForm.tsx (100%)
 rename {client => mflix/client}/app/components/AddMovieForm/index.ts (100%)
 rename {client => mflix/client}/app/components/BatchEditMovieForm/BatchEditMovieForm.tsx (100%)
 rename {client => mflix/client}/app/components/BatchEditMovieForm/index.ts (100%)
 rename {client => mflix/client}/app/components/EditMovieForm/EditMovieForm.module.css (100%)
 rename {client => mflix/client}/app/components/EditMovieForm/EditMovieForm.tsx (100%)
 rename {client => mflix/client}/app/components/EditMovieForm/index.ts (100%)
 rename {client => mflix/client}/app/components/LoadingSkeleton/LoadingSkeleton.module.css (100%)
 rename {client => mflix/client}/app/components/LoadingSkeleton/LoadingSkeleton.tsx (100%)
 rename {client => mflix/client}/app/components/LoadingSkeleton/index.ts (100%)
 rename {client => mflix/client}/app/components/MovieCard/MovieCard.module.css (100%)
 rename {client => mflix/client}/app/components/MovieCard/MovieCard.tsx (100%)
 rename {client => mflix/client}/app/components/MovieCard/index.ts (100%)
 rename {client => mflix/client}/app/components/PageSizeSelector/PageSizeSelector.module.css (100%)
 rename {client => mflix/client}/app/components/PageSizeSelector/PageSizeSelector.tsx (100%)
 rename {client => mflix/client}/app/components/PageSizeSelector/index.ts (100%)
 rename {client => mflix/client}/app/components/Pagination/Pagination.module.css (100%)
 rename {client => mflix/client}/app/components/Pagination/Pagination.tsx (100%)
 rename {client => mflix/client}/app/components/Pagination/index.ts (100%)
 rename {client => mflix/client}/app/components/SearchMovieModal/SearchMovieModal.module.css (100%)
 rename {client => mflix/client}/app/components/SearchMovieModal/SearchMovieModal.tsx (100%)
 rename {client => mflix/client}/app/components/SearchMovieModal/index.ts (100%)
 rename {client => mflix/client}/app/components/index.ts (100%)
 rename {client => mflix/client}/app/components/ui/ErrorDisplay.tsx (100%)
 rename {client => mflix/client}/app/components/ui/LoadingSpinner.tsx (100%)
 rename {client => mflix/client}/app/components/ui/index.ts (100%)
 rename {client => mflix/client}/app/globals.css (100%)
 rename {client => mflix/client}/app/home.module.css (100%)
 rename {client => mflix/client}/app/layout.module.css (100%)
 rename {client => mflix/client}/app/layout.tsx (100%)
 rename {client => mflix/client}/app/lib/api.ts (100%)
 rename {client => mflix/client}/app/lib/constants.ts (100%)
 rename {client => mflix/client}/app/lib/utils.ts (100%)
 rename {client => mflix/client}/app/movie/[id]/error.module.css (100%)
 rename {client => mflix/client}/app/movie/[id]/error.tsx (100%)
 rename {client => mflix/client}/app/movie/[id]/loading.tsx (100%)
 rename {client => mflix/client}/app/movie/[id]/not-found.module.css (100%)
 rename {client => mflix/client}/app/movie/[id]/not-found.tsx (100%)
 rename {client => mflix/client}/app/movie/[id]/page.module.css (100%)
 rename {client => mflix/client}/app/movie/[id]/page.tsx (100%)
 rename {client => mflix/client}/app/movies/error.tsx (100%)
 rename {client => mflix/client}/app/movies/loading.tsx (100%)
 rename {client => mflix/client}/app/movies/movies.module.css (100%)
 rename {client => mflix/client}/app/movies/page.module.css (100%)
 rename {client => mflix/client}/app/movies/page.tsx (100%)
 rename {client => mflix/client}/app/page.tsx (100%)
 rename {client => mflix/client}/app/types/aggregations.ts (100%)
 rename {client => mflix/client}/app/types/movie.ts (100%)
 rename {client => mflix/client}/eslint.config.mjs (100%)
 rename {client => mflix/client}/next.config.ts (100%)
 rename {client => mflix/client}/package.json (100%)
 rename {client => mflix/client}/tsconfig.json (96%)
 rename {server/express => mflix/server/js-express}/.env.example (100%)
 rename {server/express => mflix/server/js-express}/.gitignore (100%)
 rename {server/express => mflix/server/js-express}/jest.config.json (100%)
 rename {server/express => mflix/server/js-express}/jest.integration.config.json (100%)
 rename {server/express => mflix/server/js-express}/package.json (100%)
 rename {server/express => mflix/server/js-express}/src/app.ts (100%)
 rename {server/express => mflix/server/js-express}/src/config/database.ts (100%)
 rename {server/express => mflix/server/js-express}/src/config/swagger.ts (100%)
 rename {server/express => mflix/server/js-express}/src/controllers/movieController.ts (100%)
 rename {server/express => mflix/server/js-express}/src/routes/movies.ts (100%)
 rename {server/express => mflix/server/js-express}/src/types/index.ts (100%)
 rename {server/express => mflix/server/js-express}/src/utils/errorHandler.ts (100%)
 rename {server/express => mflix/server/js-express}/tests/controllers/movieController.test.ts (100%)
 rename {server/express => mflix/server/js-express}/tests/integration/README.md (99%)
 rename {server/express => mflix/server/js-express}/tests/integration/advancedEndpoints.integration.test.ts (100%)
 rename {server/express => mflix/server/js-express}/tests/integration/mongodbSearch.integration.test.ts (100%)
 rename {server/express => mflix/server/js-express}/tests/integration/movie.integration.test.ts (100%)
 rename {server/express => mflix/server/js-express}/tests/integration/setup.ts (100%)
 rename {server/express => mflix/server/js-express}/tests/setup.ts (100%)
 rename {server/express => mflix/server/js-express}/tests/utils/testHelpers.ts (100%)
 rename {server/express => mflix/server/js-express}/tsconfig.json (100%)

diff --git a/.github/workflows/run-express-tests.yml b/.github/workflows/run-express-tests.yml
index b180844..36457cc 100644
--- a/.github/workflows/run-express-tests.yml
+++ b/.github/workflows/run-express-tests.yml
@@ -5,12 +5,12 @@ on:
     branches:
       - development
     paths:
-      - 'server/express/**'
+      - 'server/js-express/**'
   push:
     branches:
       - development
     paths:
-      - 'server/express/**'
+      - 'server/js-express/**'
 
 jobs:
   test:
@@ -21,7 +21,7 @@ jobs:
 
     defaults:
       run:
-        working-directory: server/express
+        working-directory: server/js-express
 
     steps:
       - name: Checkout code
@@ -55,9 +55,9 @@ jobs:
         with:
           name: test-results
           path: |
-            server/express/coverage/
-            server/express/test-results-unit.json
-            server/express/test-results-integration.json
+            server/js-express/coverage/
+            server/js-express/test-results-unit.json
+            server/js-express/test-results-integration.json
           retention-days: 30
 
       - name: Generate Test Summary
@@ -66,5 +66,5 @@ jobs:
         run: |
           chmod +x .github/scripts/generate-test-summary-jest.sh
           .github/scripts/generate-test-summary-jest.sh \
-            server/express/test-results-unit.json \
-            server/express/test-results-integration.json
+            server/js-express/test-results-unit.json \
+            server/js-express/test-results-integration.json
diff --git a/client/.env.example b/mflix/client/.env.example
similarity index 100%
rename from client/.env.example
rename to mflix/client/.env.example
diff --git a/client/.gitignore b/mflix/client/.gitignore
similarity index 100%
rename from client/.gitignore
rename to mflix/client/.gitignore
diff --git a/mflix/client/README.md b/mflix/client/README.md
new file mode 100644
index 0000000..811c099
--- /dev/null
+++ b/mflix/client/README.md
@@ -0,0 +1,159 @@
+# MongoDB Sample MFlix Frontend
+
+This is a [Next.js](https://nextjs.org) frontend application that demonstrates MongoDB operations by connecting to an Express.js backend. The application showcases Server Side Rendering (SSR) and displays movie data from the sample_mflix database.
+
+## Features
+
+- **Movies Page** (`/movies`): Displays a paginated grid of movies with Server Side Rendering
+- **Pagination**: Navigate through movies with previous/next controls and adjustable page sizes
+- **Movie Details Page** (`/movie/[id]`): Shows comprehensive movie information including plot, cast, ratings, and more
+- **Movie Cards**: Shows movie title, poster, year, rating, and genres with navigation to details
+- **Navigation**: Sticky navigation bar with links to home and movies pages
+- **Responsive Design**: Works on desktop and mobile devices
+- **Error Handling**: Graceful fallbacks for missing posters, API errors, and not-found movies
+- **Loading States**: Professional loading indicators and skeleton screens during data fetching
+- **SEO Optimized**: Dynamic metadata generation for movie pages and pagination
+
+## Prerequisites
+
+1. **Express Backend**: The Express server must be running on `http://localhost:3001`
+2. **MongoDB Database**: The backend must be connected to a MongoDB instance with the sample_mflix dataset
+3. **Node.js**: Version 18 or higher
+
+## Getting Started
+
+### 1. Environment Configuration
+
+Copy the environment example file and configure your API URL:
+
+```bash
+cp .env.example .env.local
+```
+
+Edit `.env.local` and update the API_URL if needed:
+```bash
+API_URL=http://localhost:3001
+```
+
+### 2. Install Dependencies
+
+```bash
+npm install
+```
+
+### 3. Start the Development Server
+
+```bash
+npm run dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the application.
+
+### 4. View the Movies
+
+Navigate to [http://localhost:3000/movies](http://localhost:3000/movies) to see the movies grid with data from the MongoDB sample_mflix database. 
+
+**Pagination Features:**
+- Use the **Previous/Next** buttons to navigate between pages
+- Change the **page size** (10, 20, or 50 movies per page) using the dropdown selector
+- URL parameters support direct linking: `?page=2&limit=10`
+- Click the "Get Details" button on any movie card to view comprehensive movie information
+
+## API Integration
+
+The application connects to the Express backend using Server Side Rendering:
+
+- **Movies API**: `GET /api/movies` - Fetches movie data with pagination support (`limit` and `skip` parameters)
+- **Movie Details API**: `GET /api/movies/:id` - Fetches detailed information for a specific movie
+- **Pagination**: Smart pagination that detects available pages by requesting `limit + 1` movies
+- **Error Handling**: Graceful fallbacks when the API is unavailable
+- **Type Safety**: TypeScript interfaces matching the backend data structure
+
+## Available Scripts
+
+- `npm run dev` - Starts the development server with Turbopack
+- `npm run build` - Builds the application for production
+- `npm run start` - Starts the production server
+- `npm run lint` - Runs ESLint for code quality
+
+## Project Structure
+
+```
+client/
+├── app/
+│   ├── movie/
+│   │   └── [id]/
+│   │       ├── page.tsx      # Movie details page with SSR
+│   │       ├── loading.tsx   # Loading skeleton for details
+│   │       ├── error.tsx     # Error boundary for details
+│   │       └── not-found.tsx # 404 page for invalid movies
+│   ├── movies/
+│   │   ├── page.tsx      # Movies page with SSR
+│   │   └── loading.tsx   # Loading component
+│   ├── components/
+│   │   └── MovieCard/    # Reusable movie card component
+│   ├── lib/
+│   │   ├── api.ts        # API functions
+│   │   └── constants.ts  # App constants and routes
+│   ├── types/
+│   │   └── movie.ts      # TypeScript type definitions
+│   ├── layout.tsx        # Root layout with navigation
+│   └── page.tsx          # Home page
+├── .env.example          # Environment variables template
+└── .env.local           # Local environment configuration
+```
+
+## Development Notes
+
+### Server Side Rendering
+
+The movies page uses Next.js Server Side Rendering (SSR) to fetch data on the server before sending the page to the client. This provides:
+
+- **Better SEO**: Search engines can index the movie content
+- **Faster Initial Load**: Users see content immediately
+- **Fresh Data**: Movie data is fetched on each page request
+
+### Type Safety
+
+The application uses TypeScript interfaces that match the backend MongoDB document structure:
+
+```typescript
+interface Movie {
+  _id: string;
+  title: string;
+  year?: number;
+  poster?: string;
+  genres?: string[];
+  imdb?: {
+    rating?: number;
+  };
+}
+```
+
+### Error Handling
+
+- **API Errors**: Shows fallback message when the backend is unavailable
+- **Missing Posters**: Displays placeholder for movies without poster images
+- **Network Issues**: Graceful degradation with empty state
+
+## Learn More
+
+To learn more about the technologies used:
+
+- [Next.js Documentation](https://nextjs.org/docs) - Learn about Next.js features and API
+- [MongoDB Node.js Driver](https://mongodb.github.io/node-mongodb-native/) - Backend database integration
+- [TypeScript](https://www.typescriptlang.org/) - Type safety and development experience
+
+## Deployment
+
+### Development
+The application is configured to work with a local Express backend on port 3001.
+
+### Production
+For production deployment:
+
+1. Update `API_URL` in your environment configuration
+2. Build the application: `npm run build`
+3. Start the production server: `npm start`
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
diff --git a/client/app/aggregations/aggregations.module.css b/mflix/client/app/aggregations/aggregations.module.css
similarity index 100%
rename from client/app/aggregations/aggregations.module.css
rename to mflix/client/app/aggregations/aggregations.module.css
diff --git a/client/app/aggregations/page.tsx b/mflix/client/app/aggregations/page.tsx
similarity index 100%
rename from client/app/aggregations/page.tsx
rename to mflix/client/app/aggregations/page.tsx
diff --git a/client/app/components/ActionButtons/ActionButtons.module.css b/mflix/client/app/components/ActionButtons/ActionButtons.module.css
similarity index 100%
rename from client/app/components/ActionButtons/ActionButtons.module.css
rename to mflix/client/app/components/ActionButtons/ActionButtons.module.css
diff --git a/client/app/components/ActionButtons/ActionButtons.tsx b/mflix/client/app/components/ActionButtons/ActionButtons.tsx
similarity index 100%
rename from client/app/components/ActionButtons/ActionButtons.tsx
rename to mflix/client/app/components/ActionButtons/ActionButtons.tsx
diff --git a/client/app/components/ActionButtons/index.ts b/mflix/client/app/components/ActionButtons/index.ts
similarity index 100%
rename from client/app/components/ActionButtons/index.ts
rename to mflix/client/app/components/ActionButtons/index.ts
diff --git a/client/app/components/AddMovieForm/AddMovieForm.tsx b/mflix/client/app/components/AddMovieForm/AddMovieForm.tsx
similarity index 100%
rename from client/app/components/AddMovieForm/AddMovieForm.tsx
rename to mflix/client/app/components/AddMovieForm/AddMovieForm.tsx
diff --git a/client/app/components/AddMovieForm/index.ts b/mflix/client/app/components/AddMovieForm/index.ts
similarity index 100%
rename from client/app/components/AddMovieForm/index.ts
rename to mflix/client/app/components/AddMovieForm/index.ts
diff --git a/client/app/components/BatchEditMovieForm/BatchEditMovieForm.tsx b/mflix/client/app/components/BatchEditMovieForm/BatchEditMovieForm.tsx
similarity index 100%
rename from client/app/components/BatchEditMovieForm/BatchEditMovieForm.tsx
rename to mflix/client/app/components/BatchEditMovieForm/BatchEditMovieForm.tsx
diff --git a/client/app/components/BatchEditMovieForm/index.ts b/mflix/client/app/components/BatchEditMovieForm/index.ts
similarity index 100%
rename from client/app/components/BatchEditMovieForm/index.ts
rename to mflix/client/app/components/BatchEditMovieForm/index.ts
diff --git a/client/app/components/EditMovieForm/EditMovieForm.module.css b/mflix/client/app/components/EditMovieForm/EditMovieForm.module.css
similarity index 100%
rename from client/app/components/EditMovieForm/EditMovieForm.module.css
rename to mflix/client/app/components/EditMovieForm/EditMovieForm.module.css
diff --git a/client/app/components/EditMovieForm/EditMovieForm.tsx b/mflix/client/app/components/EditMovieForm/EditMovieForm.tsx
similarity index 100%
rename from client/app/components/EditMovieForm/EditMovieForm.tsx
rename to mflix/client/app/components/EditMovieForm/EditMovieForm.tsx
diff --git a/client/app/components/EditMovieForm/index.ts b/mflix/client/app/components/EditMovieForm/index.ts
similarity index 100%
rename from client/app/components/EditMovieForm/index.ts
rename to mflix/client/app/components/EditMovieForm/index.ts
diff --git a/client/app/components/LoadingSkeleton/LoadingSkeleton.module.css b/mflix/client/app/components/LoadingSkeleton/LoadingSkeleton.module.css
similarity index 100%
rename from client/app/components/LoadingSkeleton/LoadingSkeleton.module.css
rename to mflix/client/app/components/LoadingSkeleton/LoadingSkeleton.module.css
diff --git a/client/app/components/LoadingSkeleton/LoadingSkeleton.tsx b/mflix/client/app/components/LoadingSkeleton/LoadingSkeleton.tsx
similarity index 100%
rename from client/app/components/LoadingSkeleton/LoadingSkeleton.tsx
rename to mflix/client/app/components/LoadingSkeleton/LoadingSkeleton.tsx
diff --git a/client/app/components/LoadingSkeleton/index.ts b/mflix/client/app/components/LoadingSkeleton/index.ts
similarity index 100%
rename from client/app/components/LoadingSkeleton/index.ts
rename to mflix/client/app/components/LoadingSkeleton/index.ts
diff --git a/client/app/components/MovieCard/MovieCard.module.css b/mflix/client/app/components/MovieCard/MovieCard.module.css
similarity index 100%
rename from client/app/components/MovieCard/MovieCard.module.css
rename to mflix/client/app/components/MovieCard/MovieCard.module.css
diff --git a/client/app/components/MovieCard/MovieCard.tsx b/mflix/client/app/components/MovieCard/MovieCard.tsx
similarity index 100%
rename from client/app/components/MovieCard/MovieCard.tsx
rename to mflix/client/app/components/MovieCard/MovieCard.tsx
diff --git a/client/app/components/MovieCard/index.ts b/mflix/client/app/components/MovieCard/index.ts
similarity index 100%
rename from client/app/components/MovieCard/index.ts
rename to mflix/client/app/components/MovieCard/index.ts
diff --git a/client/app/components/PageSizeSelector/PageSizeSelector.module.css b/mflix/client/app/components/PageSizeSelector/PageSizeSelector.module.css
similarity index 100%
rename from client/app/components/PageSizeSelector/PageSizeSelector.module.css
rename to mflix/client/app/components/PageSizeSelector/PageSizeSelector.module.css
diff --git a/client/app/components/PageSizeSelector/PageSizeSelector.tsx b/mflix/client/app/components/PageSizeSelector/PageSizeSelector.tsx
similarity index 100%
rename from client/app/components/PageSizeSelector/PageSizeSelector.tsx
rename to mflix/client/app/components/PageSizeSelector/PageSizeSelector.tsx
diff --git a/client/app/components/PageSizeSelector/index.ts b/mflix/client/app/components/PageSizeSelector/index.ts
similarity index 100%
rename from client/app/components/PageSizeSelector/index.ts
rename to mflix/client/app/components/PageSizeSelector/index.ts
diff --git a/client/app/components/Pagination/Pagination.module.css b/mflix/client/app/components/Pagination/Pagination.module.css
similarity index 100%
rename from client/app/components/Pagination/Pagination.module.css
rename to mflix/client/app/components/Pagination/Pagination.module.css
diff --git a/client/app/components/Pagination/Pagination.tsx b/mflix/client/app/components/Pagination/Pagination.tsx
similarity index 100%
rename from client/app/components/Pagination/Pagination.tsx
rename to mflix/client/app/components/Pagination/Pagination.tsx
diff --git a/client/app/components/Pagination/index.ts b/mflix/client/app/components/Pagination/index.ts
similarity index 100%
rename from client/app/components/Pagination/index.ts
rename to mflix/client/app/components/Pagination/index.ts
diff --git a/client/app/components/SearchMovieModal/SearchMovieModal.module.css b/mflix/client/app/components/SearchMovieModal/SearchMovieModal.module.css
similarity index 100%
rename from client/app/components/SearchMovieModal/SearchMovieModal.module.css
rename to mflix/client/app/components/SearchMovieModal/SearchMovieModal.module.css
diff --git a/client/app/components/SearchMovieModal/SearchMovieModal.tsx b/mflix/client/app/components/SearchMovieModal/SearchMovieModal.tsx
similarity index 100%
rename from client/app/components/SearchMovieModal/SearchMovieModal.tsx
rename to mflix/client/app/components/SearchMovieModal/SearchMovieModal.tsx
diff --git a/client/app/components/SearchMovieModal/index.ts b/mflix/client/app/components/SearchMovieModal/index.ts
similarity index 100%
rename from client/app/components/SearchMovieModal/index.ts
rename to mflix/client/app/components/SearchMovieModal/index.ts
diff --git a/client/app/components/index.ts b/mflix/client/app/components/index.ts
similarity index 100%
rename from client/app/components/index.ts
rename to mflix/client/app/components/index.ts
diff --git a/client/app/components/ui/ErrorDisplay.tsx b/mflix/client/app/components/ui/ErrorDisplay.tsx
similarity index 100%
rename from client/app/components/ui/ErrorDisplay.tsx
rename to mflix/client/app/components/ui/ErrorDisplay.tsx
diff --git a/client/app/components/ui/LoadingSpinner.tsx b/mflix/client/app/components/ui/LoadingSpinner.tsx
similarity index 100%
rename from client/app/components/ui/LoadingSpinner.tsx
rename to mflix/client/app/components/ui/LoadingSpinner.tsx
diff --git a/client/app/components/ui/index.ts b/mflix/client/app/components/ui/index.ts
similarity index 100%
rename from client/app/components/ui/index.ts
rename to mflix/client/app/components/ui/index.ts
diff --git a/client/app/globals.css b/mflix/client/app/globals.css
similarity index 100%
rename from client/app/globals.css
rename to mflix/client/app/globals.css
diff --git a/client/app/home.module.css b/mflix/client/app/home.module.css
similarity index 100%
rename from client/app/home.module.css
rename to mflix/client/app/home.module.css
diff --git a/client/app/layout.module.css b/mflix/client/app/layout.module.css
similarity index 100%
rename from client/app/layout.module.css
rename to mflix/client/app/layout.module.css
diff --git a/client/app/layout.tsx b/mflix/client/app/layout.tsx
similarity index 100%
rename from client/app/layout.tsx
rename to mflix/client/app/layout.tsx
diff --git a/client/app/lib/api.ts b/mflix/client/app/lib/api.ts
similarity index 100%
rename from client/app/lib/api.ts
rename to mflix/client/app/lib/api.ts
diff --git a/client/app/lib/constants.ts b/mflix/client/app/lib/constants.ts
similarity index 100%
rename from client/app/lib/constants.ts
rename to mflix/client/app/lib/constants.ts
diff --git a/client/app/lib/utils.ts b/mflix/client/app/lib/utils.ts
similarity index 100%
rename from client/app/lib/utils.ts
rename to mflix/client/app/lib/utils.ts
diff --git a/client/app/movie/[id]/error.module.css b/mflix/client/app/movie/[id]/error.module.css
similarity index 100%
rename from client/app/movie/[id]/error.module.css
rename to mflix/client/app/movie/[id]/error.module.css
diff --git a/client/app/movie/[id]/error.tsx b/mflix/client/app/movie/[id]/error.tsx
similarity index 100%
rename from client/app/movie/[id]/error.tsx
rename to mflix/client/app/movie/[id]/error.tsx
diff --git a/client/app/movie/[id]/loading.tsx b/mflix/client/app/movie/[id]/loading.tsx
similarity index 100%
rename from client/app/movie/[id]/loading.tsx
rename to mflix/client/app/movie/[id]/loading.tsx
diff --git a/client/app/movie/[id]/not-found.module.css b/mflix/client/app/movie/[id]/not-found.module.css
similarity index 100%
rename from client/app/movie/[id]/not-found.module.css
rename to mflix/client/app/movie/[id]/not-found.module.css
diff --git a/client/app/movie/[id]/not-found.tsx b/mflix/client/app/movie/[id]/not-found.tsx
similarity index 100%
rename from client/app/movie/[id]/not-found.tsx
rename to mflix/client/app/movie/[id]/not-found.tsx
diff --git a/client/app/movie/[id]/page.module.css b/mflix/client/app/movie/[id]/page.module.css
similarity index 100%
rename from client/app/movie/[id]/page.module.css
rename to mflix/client/app/movie/[id]/page.module.css
diff --git a/client/app/movie/[id]/page.tsx b/mflix/client/app/movie/[id]/page.tsx
similarity index 100%
rename from client/app/movie/[id]/page.tsx
rename to mflix/client/app/movie/[id]/page.tsx
diff --git a/client/app/movies/error.tsx b/mflix/client/app/movies/error.tsx
similarity index 100%
rename from client/app/movies/error.tsx
rename to mflix/client/app/movies/error.tsx
diff --git a/client/app/movies/loading.tsx b/mflix/client/app/movies/loading.tsx
similarity index 100%
rename from client/app/movies/loading.tsx
rename to mflix/client/app/movies/loading.tsx
diff --git a/client/app/movies/movies.module.css b/mflix/client/app/movies/movies.module.css
similarity index 100%
rename from client/app/movies/movies.module.css
rename to mflix/client/app/movies/movies.module.css
diff --git a/client/app/movies/page.module.css b/mflix/client/app/movies/page.module.css
similarity index 100%
rename from client/app/movies/page.module.css
rename to mflix/client/app/movies/page.module.css
diff --git a/client/app/movies/page.tsx b/mflix/client/app/movies/page.tsx
similarity index 100%
rename from client/app/movies/page.tsx
rename to mflix/client/app/movies/page.tsx
diff --git a/client/app/page.tsx b/mflix/client/app/page.tsx
similarity index 100%
rename from client/app/page.tsx
rename to mflix/client/app/page.tsx
diff --git a/client/app/types/aggregations.ts b/mflix/client/app/types/aggregations.ts
similarity index 100%
rename from client/app/types/aggregations.ts
rename to mflix/client/app/types/aggregations.ts
diff --git a/client/app/types/movie.ts b/mflix/client/app/types/movie.ts
similarity index 100%
rename from client/app/types/movie.ts
rename to mflix/client/app/types/movie.ts
diff --git a/client/eslint.config.mjs b/mflix/client/eslint.config.mjs
similarity index 100%
rename from client/eslint.config.mjs
rename to mflix/client/eslint.config.mjs
diff --git a/client/next.config.ts b/mflix/client/next.config.ts
similarity index 100%
rename from client/next.config.ts
rename to mflix/client/next.config.ts
diff --git a/client/package.json b/mflix/client/package.json
similarity index 100%
rename from client/package.json
rename to mflix/client/package.json
diff --git a/client/tsconfig.json b/mflix/client/tsconfig.json
similarity index 96%
rename from client/tsconfig.json
rename to mflix/client/tsconfig.json
index b0209d7..ddba9b4 100644
--- a/client/tsconfig.json
+++ b/mflix/client/tsconfig.json
@@ -15,7 +15,7 @@
     "moduleResolution": "bundler",
     "resolveJsonModule": true,
     "isolatedModules": true,
-    "jsx": "preserve",
+    "jsx": "react-jsx",
     "incremental": true,
     "plugins": [
       {
diff --git a/server/express/.env.example b/mflix/server/js-express/.env.example
similarity index 100%
rename from server/express/.env.example
rename to mflix/server/js-express/.env.example
diff --git a/server/express/.gitignore b/mflix/server/js-express/.gitignore
similarity index 100%
rename from server/express/.gitignore
rename to mflix/server/js-express/.gitignore
diff --git a/server/express/jest.config.json b/mflix/server/js-express/jest.config.json
similarity index 100%
rename from server/express/jest.config.json
rename to mflix/server/js-express/jest.config.json
diff --git a/server/express/jest.integration.config.json b/mflix/server/js-express/jest.integration.config.json
similarity index 100%
rename from server/express/jest.integration.config.json
rename to mflix/server/js-express/jest.integration.config.json
diff --git a/server/express/package.json b/mflix/server/js-express/package.json
similarity index 100%
rename from server/express/package.json
rename to mflix/server/js-express/package.json
diff --git a/server/express/src/app.ts b/mflix/server/js-express/src/app.ts
similarity index 100%
rename from server/express/src/app.ts
rename to mflix/server/js-express/src/app.ts
diff --git a/server/express/src/config/database.ts b/mflix/server/js-express/src/config/database.ts
similarity index 100%
rename from server/express/src/config/database.ts
rename to mflix/server/js-express/src/config/database.ts
diff --git a/server/express/src/config/swagger.ts b/mflix/server/js-express/src/config/swagger.ts
similarity index 100%
rename from server/express/src/config/swagger.ts
rename to mflix/server/js-express/src/config/swagger.ts
diff --git a/server/express/src/controllers/movieController.ts b/mflix/server/js-express/src/controllers/movieController.ts
similarity index 100%
rename from server/express/src/controllers/movieController.ts
rename to mflix/server/js-express/src/controllers/movieController.ts
diff --git a/server/express/src/routes/movies.ts b/mflix/server/js-express/src/routes/movies.ts
similarity index 100%
rename from server/express/src/routes/movies.ts
rename to mflix/server/js-express/src/routes/movies.ts
diff --git a/server/express/src/types/index.ts b/mflix/server/js-express/src/types/index.ts
similarity index 100%
rename from server/express/src/types/index.ts
rename to mflix/server/js-express/src/types/index.ts
diff --git a/server/express/src/utils/errorHandler.ts b/mflix/server/js-express/src/utils/errorHandler.ts
similarity index 100%
rename from server/express/src/utils/errorHandler.ts
rename to mflix/server/js-express/src/utils/errorHandler.ts
diff --git a/server/express/tests/controllers/movieController.test.ts b/mflix/server/js-express/tests/controllers/movieController.test.ts
similarity index 100%
rename from server/express/tests/controllers/movieController.test.ts
rename to mflix/server/js-express/tests/controllers/movieController.test.ts
diff --git a/server/express/tests/integration/README.md b/mflix/server/js-express/tests/integration/README.md
similarity index 99%
rename from server/express/tests/integration/README.md
rename to mflix/server/js-express/tests/integration/README.md
index 8fbd90f..c251312 100644
--- a/server/express/tests/integration/README.md
+++ b/mflix/server/js-express/tests/integration/README.md
@@ -87,7 +87,7 @@ npx jest --config jest.integration.config.json tests/integration/advancedEndpoin
 
 #### Using .env file
 
-Create a `.env` file in the `server/express` directory:
+Create a `.env` file in the `server/js-express` directory:
 
 ```env
 MONGODB_URI=mongodb://localhost:27017/sample_mflix
diff --git a/server/express/tests/integration/advancedEndpoints.integration.test.ts b/mflix/server/js-express/tests/integration/advancedEndpoints.integration.test.ts
similarity index 100%
rename from server/express/tests/integration/advancedEndpoints.integration.test.ts
rename to mflix/server/js-express/tests/integration/advancedEndpoints.integration.test.ts
diff --git a/server/express/tests/integration/mongodbSearch.integration.test.ts b/mflix/server/js-express/tests/integration/mongodbSearch.integration.test.ts
similarity index 100%
rename from server/express/tests/integration/mongodbSearch.integration.test.ts
rename to mflix/server/js-express/tests/integration/mongodbSearch.integration.test.ts
diff --git a/server/express/tests/integration/movie.integration.test.ts b/mflix/server/js-express/tests/integration/movie.integration.test.ts
similarity index 100%
rename from server/express/tests/integration/movie.integration.test.ts
rename to mflix/server/js-express/tests/integration/movie.integration.test.ts
diff --git a/server/express/tests/integration/setup.ts b/mflix/server/js-express/tests/integration/setup.ts
similarity index 100%
rename from server/express/tests/integration/setup.ts
rename to mflix/server/js-express/tests/integration/setup.ts
diff --git a/server/express/tests/setup.ts b/mflix/server/js-express/tests/setup.ts
similarity index 100%
rename from server/express/tests/setup.ts
rename to mflix/server/js-express/tests/setup.ts
diff --git a/server/express/tests/utils/testHelpers.ts b/mflix/server/js-express/tests/utils/testHelpers.ts
similarity index 100%
rename from server/express/tests/utils/testHelpers.ts
rename to mflix/server/js-express/tests/utils/testHelpers.ts
diff --git a/server/express/tsconfig.json b/mflix/server/js-express/tsconfig.json
similarity index 100%
rename from server/express/tsconfig.json
rename to mflix/server/js-express/tsconfig.json
diff --git a/mflix/server/python-fastapi/tests/README.md b/mflix/server/python-fastapi/tests/README.md
index f8bf9f9..6a151d4 100644
--- a/mflix/server/python-fastapi/tests/README.md
+++ b/mflix/server/python-fastapi/tests/README.md
@@ -41,7 +41,7 @@ The test suite is organized into three categories:
 
 1. **For all tests:**
    ```bash
-   cd server/python
+   cd server/python-fastapi
    source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows
    ```
 
@@ -170,7 +170,7 @@ The `test_batch_create_movies` test is currently skipped due to a known bug in t
 **Solution**:
 - Ensure virtual environment is activated
 - Install dependencies: `pip install -r requirements.txt`
-- Run from `server/python` directory
+- Run from `server/python-fastapi` directory
 
 ## Contributing
 
diff --git a/mflix/server/python-fastapi/tests/integration/conftest.py b/mflix/server/python-fastapi/tests/integration/conftest.py
index 329cbdc..6fb4e2d 100644
--- a/mflix/server/python-fastapi/tests/integration/conftest.py
+++ b/mflix/server/python-fastapi/tests/integration/conftest.py
@@ -48,8 +48,8 @@ def server():
     if is_port_in_use(test_port):
         pytest.skip(f"Port {test_port} is already in use. Cannot start test server.")
 
-    # Get the absolute path to the server/python directory
-    # Tests are in server/python/tests/integration, so go up two levels
+    # Get the absolute path to the server/python-fastapi directory
+    # Tests are in server/python-fastapi/tests/integration, so go up two levels
     test_dir = os.path.dirname(os.path.abspath(__file__))
     server_python_dir = os.path.abspath(os.path.join(test_dir, "..", ".."))
 

From 5cda8e2dd130399986c6c8bf4da46e6086856626 Mon Sep 17 00:00:00 2001
From: Jordan Smith <jordan.smith@mongodb.com>
Date: Fri, 7 Nov 2025 11:56:17 -0500
Subject: [PATCH 096/110] cleanup and READMEs

---
 mflix/README-JAVA-SPRING.md                   |  18 +-
 mflix/README-JAVASCRIPT-EXPRESS.md            | 194 +++++++++++++++++-
 .../SearchMovieModal/SearchMovieModal.tsx     |  18 +-
 mflix/client/app/lib/api.ts                   |   4 +-
 mflix/server/java-spring/.env.example         |   3 +
 .../samplemflix/service/MovieService.java     |   2 +-
 .../samplemflix/service/MovieServiceImpl.java |   4 +-
 .../mongodb/samplemflix/integration/README.md |  16 +-
 mflix/server/js-express/.env.example          |  13 +-
 mflix/server/js-express/package.json          |   2 +-
 mflix/server/js-express/src/routes/movies.ts  |   4 +-
 mflix/server/js-express/src/types/index.ts    |   2 +-
 .../js-express/tests/integration/README.md    |   8 +-
 .../advancedEndpoints.integration.test.ts     |   8 +-
 .../mongodbSearch.integration.test.ts         |   6 +-
 mflix/server/python-fastapi/.env.example      |   6 +-
 .../python-fastapi/src/routers/movies.py      |  12 +-
 17 files changed, 258 insertions(+), 62 deletions(-)

diff --git a/mflix/README-JAVA-SPRING.md b/mflix/README-JAVA-SPRING.md
index 988fc49..45ef3f7 100644
--- a/mflix/README-JAVA-SPRING.md
+++ b/mflix/README-JAVA-SPRING.md
@@ -100,11 +100,15 @@ Open your browser and navigate to:
 
 ## Features
 
-- **Browse Movies:** View a paginated list of movies from the sample_mflix dataset
-- **Search:** Full-text search using MongoDB Search
-- **Filter:** Filter movies by genre, year, rating, and more
-- **Movie Details:** View detailed information about each movie
-- **Aggregations:** Complex data aggregations and analytics
+- **Browse Movies:** View a paginated list of movies from the
+  sample_mflix dataset
+- **CRUD Operations:** Create, read, update and delete movies by using
+  the MongoDB Java driver
+- **Search:** Search movies with filters by using MongoDB Search
+- **Vector Search:** Search movie plots with similar search terms by
+  using MongoDB Vector Search
+- **Aggregations:** View data aggregations and analytics built with
+  aggregation pipelines
 
 ## Development
 
@@ -176,5 +180,5 @@ If you have problems running the sample app, please check the following:
 - [ ] Verify that you have no firewalls blocking access to the server or client ports.
 
 If you have verified the above and still have issues, please
-[open an issue](https://github.com/mongodb/docs-sample-apps/issues/new/choose)
-on the source repository `mongodb/docs-sample-apps`.
+[open an issue](https://github.com/mongodb/sample-app-java-mflix/issues/new/choose)
+on the source repository `mongodb/sample-app-java-mflix`.
diff --git a/mflix/README-JAVASCRIPT-EXPRESS.md b/mflix/README-JAVASCRIPT-EXPRESS.md
index fa79f86..f212370 100644
--- a/mflix/README-JAVASCRIPT-EXPRESS.md
+++ b/mflix/README-JAVASCRIPT-EXPRESS.md
@@ -1,16 +1,196 @@
 # JavaScript Express.js MongoDB Sample MFlix Application
 
-[TODO: Add intro]
+This is a full-stack movie browsing application built with Express.js and Next.js, demonstrating MongoDB operations using the `sample_mflix` dataset. The application showcases CRUD operations, aggregations, and MongoDB Search using the native MongoDB Node.js driver.
+
+## Project Structure
 
 ```
-├── README.md
-├── client/     # Next.js frontend
-└── server/     # Express.js backend
+├── README-JAVASCRIPT-EXPRESS.md
+├── client/                 # Next.js frontend (TypeScript)
+└── server/js-express/      # Express.js backend
+    ├── src/
+    ├── package.json
+    ├── .env.example
+    └── tsconfig.json
 ```
 
+## Prerequisites
+
+- **Node.js 22** or higher
+- **MongoDB Atlas cluster or local deployment** with the `sample_mflix` dataset loaded
+  - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/) 
+- **npm** (included with Node.js)
+
 ## Getting Started
 
-[TODO: Add getting started instructions explaining how to set connection string, start server, start client, etc.]
+### 1. Configure the Backend
+
+Navigate to the Express server directory:
+
+```bash
+cd server/js-express
+```
+
+Create a `.env` file from the example:
+
+```bash
+cp .env.example .env
+```
+
+Edit the `.env` file and set your MongoDB connection string:
+
+```env
+# MongoDB Configuration
+# Replace with your MongoDB Atlas connection string
+MONGODB_URI=mongodb+srv://<username>:<password>@<cluster>.mongodb.net/sample_mflix?retryWrites=true&w=majority
+
+# Server Configuration
+PORT=3001
+NODE_ENV=development
+
+# CORS Configuration (frontend URL)
+CORS_ORIGIN=http://localhost:3000
+
+# Optional: Enable MongoDB Search tests
+# Uncomment the following line to enable Search tests
+# ENABLE_SEARCH_TESTS=true
+```
+
+**Note:** Replace `<username>`, `<password>`, and `<cluster>` with your actual MongoDB Atlas credentials.
+
+### 2. Install Backend Dependencies
+
+From the `server/js-express` directory, run:
+
+```bash
+npm install
+```
+
+### 3. Start the Backend Server
+
+From the `server/js-express` directory, run:
+
+```bash
+# Development mode with hot reloading
+npm run dev
+
+# Or production mode
+npm run build
+npm start
+```
+
+The server will start on `http://localhost:3001`. You can verify it's running by visiting:
+- API root: http://localhost:3001/
+- API documentation (Swagger UI): http://localhost:3001/api-docs
+
+### 4. Configure and Start the Frontend
+
+Open a new terminal and navigate to the client directory:
+
+```bash
+cd client
+```
+
+Install dependencies:
+
+```bash
+npm install
+```
+
+Start the development server:
+
+```bash
+npm run dev
+```
+
+The Next.js application will start on `http://localhost:3000`.
+
+### 5. Access the Application
+
+Open your browser and navigate to:
+- **Frontend:** http://localhost:3000
+- **Backend API:** http://localhost:3001
+- **API Documentation:** http://localhost:3001/api-docs
+
+## Features
+
+- **Browse Movies:** View a paginated list of movies from the
+  sample_mflix dataset
+- **CRUD Operations:** Create, read, update and delete movies by using
+  the MongoDB Node.js driver
+- **Search:** Search movies with filters by using MongoDB Search
+- **Vector Search:** Search movie plots with similar search terms by
+  using MongoDB Vector Search
+- **Aggregations:** View data aggregations and analytics built with
+  aggregation pipelines
+
+## Development
+
+### Backend Development
+
+The Express.js backend uses:
+- **Express.js 5** for REST API
+- **MongoDB Node.js Driver** for database operations
+- **TypeScript** for type safety
+- **Swagger** for API documentation
+- **Jest** for testing
+
+To run tests:
+
+```bash
+cd server/js-express
+npm test
+```
+
+To run tests with coverage:
+
+```bash
+cd server/js-express
+npm run test:coverage
+```
+
+### Frontend Development
+
+The Next.js frontend uses:
+- **React 19** with TypeScript
+- **Next.js 16** with App Router
+- **Turbopack** for fast development builds
+
+#### Development Mode
+
+For active development with hot reloading and fast refresh:
+
+```bash
+cd client
+npm run dev
+```
+
+This starts the development server on `http://localhost:3000` with Turbopack for fast rebuilds.
+
+#### Production Build
+
+To create an optimized production build and run it:
+
+```bash
+cd client
+npm run build  # Creates optimized production build
+npm start      # Starts production server
+```
+
+The production build:
+- Minifies and optimizes JavaScript and CSS
+- Optimizes images and assets
+- Generates static pages where possible
+- Provides better performance for end users
+
+#### Linting
+
+To check code quality:
+
+```bash
+cd client
+npm run lint
+```
 
 ## Issues
 
@@ -22,5 +202,5 @@ If you have problems running the sample app, please check the following:
 - [ ] Verify that you have no firewalls blocking access to the server or client ports.
 
 If you have verified the above and still have issues, please
-[open an issue](https://github.com/mongodb/docs-sample-apps/issues/new/choose)
-on the source repository `mongodb/docs-sample-apps`.
+[open an issue](https://github.com/mongodb/sample-app-nodejs-mflix/issues/new/choose)
+on the source repository `mongodb/sample-app-nodejs-mflix`.
diff --git a/mflix/client/app/components/SearchMovieModal/SearchMovieModal.tsx b/mflix/client/app/components/SearchMovieModal/SearchMovieModal.tsx
index 45bfcb4..642ec0b 100644
--- a/mflix/client/app/components/SearchMovieModal/SearchMovieModal.tsx
+++ b/mflix/client/app/components/SearchMovieModal/SearchMovieModal.tsx
@@ -28,7 +28,7 @@ export interface SearchParams {
   cast?: string;
   limit?: number;
   skip?: number;
-  search_operator?: 'must' | 'should' | 'mustNot' | 'filter';
+  searchOperator?: 'must' | 'should' | 'mustNot' | 'filter';
   // Vector Search fields
   q?: string;
 }
@@ -42,7 +42,7 @@ interface SearchFormData {
   writers: string;
   cast: string;
   limit: string;
-  search_operator: 'must' | 'should' | 'mustNot' | 'filter';
+  searchOperator: 'must' | 'should' | 'mustNot' | 'filter';
   // Vector Search fields
   q: string;
 }
@@ -56,7 +56,7 @@ const getInitialFormData = (): SearchFormData => ({
   writers: '',
   cast: '',
   limit: '20',
-  search_operator: 'must',
+  searchOperator: 'must',
   // Vector Search fields
   q: '',
 });
@@ -115,7 +115,7 @@ export default function SearchMovieModal({
 
     if (formData.searchType === 'mongodb-search') {
       // Add MongoDB Search specific parameters
-      searchParams.search_operator = formData.search_operator;
+      searchParams.searchOperator = formData.searchOperator;
       searchParams.skip = 0; // Always start from beginning for new search
 
       if (formData.plot.trim()) {
@@ -316,13 +316,13 @@ export default function SearchMovieModal({
 
             {/* Search Operator */}
             <div className={styles.formGroup}>
-              <label htmlFor="search_operator" className={styles.label}>
+              <label htmlFor="searchOperator" className={styles.label}>
                 Search Logic
               </label>
               <select
-                id="search_operator"
-                value={formData.search_operator}
-                onChange={(e) => handleInputChange('search_operator', e.target.value)}
+                id="searchOperator"
+                value={formData.searchOperator}
+                onChange={(e) => handleInputChange('searchOperator', e.target.value)}
                 className={styles.input}
                 disabled={isLoading}
               >
@@ -333,7 +333,7 @@ export default function SearchMovieModal({
                 ))}
               </select>
               <small className={styles.searchOperatorDescription}>
-                {searchOperatorOptions.find(opt => opt.value === formData.search_operator)?.description}
+                {searchOperatorOptions.find(opt => opt.value === formData.searchOperator)?.description}
               </small>
             </div>
           </>
diff --git a/mflix/client/app/lib/api.ts b/mflix/client/app/lib/api.ts
index 4ec0f96..9c77b47 100644
--- a/mflix/client/app/lib/api.ts
+++ b/mflix/client/app/lib/api.ts
@@ -593,7 +593,7 @@ export async function searchMovies(searchParams: {
   cast?: string;
   limit?: number;
   skip?: number;
-  search_operator?: 'must' | 'should' | 'mustNot' | 'filter';
+  searchOperator?: 'must' | 'should' | 'mustNot' | 'filter';
 }): Promise<{ success: boolean; error?: string; movies?: Movie[]; hasNextPage?: boolean; hasPrevPage?: boolean; totalCount?: number }> {
   try {
     // Build query parameters
@@ -609,7 +609,7 @@ export async function searchMovies(searchParams: {
     if (searchParams.cast) queryParams.append('cast', searchParams.cast);
     queryParams.append('limit', limit.toString());
     queryParams.append('skip', skip.toString());
-    if (searchParams.search_operator) queryParams.append('search_operator', searchParams.search_operator);
+    if (searchParams.searchOperator) queryParams.append('searchOperator', searchParams.searchOperator);
 
     const response = await fetch(`${API_BASE_URL}/api/movies/search?${queryParams}`, {
       method: 'GET',
diff --git a/mflix/server/java-spring/.env.example b/mflix/server/java-spring/.env.example
index 9efc711..79c8422 100644
--- a/mflix/server/java-spring/.env.example
+++ b/mflix/server/java-spring/.env.example
@@ -15,3 +15,6 @@ PORT=3001
 # For multiple origins, separate with commas
 CORS_ORIGIN=http://localhost:3000
 
+# Optional: Enable MongoDB Search tests
+# Uncomment the following line to enable Search tests
+# ENABLE_SEARCH_TESTS=true
\ No newline at end of file
diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
index 159bf54..8221b27 100644
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
+++ b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java
@@ -85,7 +85,7 @@ public interface MovieService {
 
     /**
      * Finds similar movies using vector search on plot embeddings.
-     * Demonstrates MongoDB Atlas Vector Search.
+     * Demonstrates MongoDB Vector Search.
      *
      * @param movieId ID of the movie to find similar movies for
      * @param limit Maximum number of similar movies to return (default: 10, max: 50)
diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index 3b6ee5a..eb592a0 100644
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -759,7 +759,7 @@ public List<Movie> findSimilarMovies(String movieId, Integer limit) {
                 .append("index", "plotEmbeddingIndex")
                 .append("path", "plot_embedding")
                 .append("queryVector", plotEmbedding)
-                .append("numCandidates", resultLimit * 10)
+                .append("numCandidates", resultLimit * 20) // We recommend searching 20 times higher than the limit to improve result relevance
                 .append("limit", resultLimit + 1) // +1 to exclude the source movie
         );
 
@@ -847,7 +847,7 @@ public List<VectorSearchResult> vectorSearchMovies(String query, Integer limit)
                     .append("index", "vector_index")
                     .append("path", "plot_embedding_voyage_3_large")
                     .append("queryVector", queryVector)
-                    .append("numCandidates", resultLimit * 15)  // Search more candidates for better results
+                    .append("numCandidates", resultLimit * 20)  // We recommend searching 20 times higher than the limit to improve result relevance
                     .append("limit", resultLimit)
             );
 
diff --git a/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md b/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
index f2083be..a2fc932 100644
--- a/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
+++ b/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/README.md
@@ -1,12 +1,12 @@
-# Atlas Search Integration Tests
+# MongoDB Search Integration Tests
 
-This directory contains integration tests for MongoDB Atlas Search functionality.
+This directory contains integration tests for MongoDB Search functionality.
 
 ## Overview
 
-The `AtlasSearchIntegrationTest` class tests the Atlas Search endpoints with a real MongoDB Atlas instance. These tests verify that:
+The `MongoDBSearchIntegrationTest` class tests the MongoDB Search endpoints with a real MongoDB Atlas instance. These tests verify that:
 
-1. The Atlas Search index is created correctly
+1. The MongoDB Search index is created correctly
 2. The index becomes ready for use (using polling)
 3. The `/search` endpoint returns correct results
 4. Pagination works correctly
@@ -17,7 +17,7 @@ The `AtlasSearchIntegrationTest` class tests the Atlas Search endpoints with a r
 These tests require:
 
 - **MongoDB Atlas cluster** (not local MongoDB or Testcontainers)
-- **Atlas Search capability** enabled on the cluster
+- **MongoDB Search capability** enabled on the cluster
 - **MONGODB_URI** environment variable pointing to your Atlas cluster
 - **ENABLE_SEARCH_TESTS=true** environment variable to enable the tests
 
@@ -49,10 +49,10 @@ MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/sample_mflix?ret
 
 ```bash
 # Run all integration tests
-./mvnw test -Dtest=AtlasSearchIntegrationTest
+./mvnw test -Dtest=MongoDBSearchIntegrationTest
 
 # Run a specific test
-./mvnw test -Dtest=AtlasSearchIntegrationTest#testSearchMoviesByPlot_Success
+./mvnw test -Dtest=MongoDBSearchIntegrationTest#testSearchMoviesByPlot_Success
 ```
 
 ## How the Tests Work
@@ -113,7 +113,7 @@ export ENABLE_SEARCH_TESTS=true
 
 If the tests fail with "Search index did not become ready within 120 seconds":
 
-1. Check that your cluster has Atlas Search enabled
+1. Check that your cluster has MongoDB Search enabled
 2. Verify you're using a MongoDB Atlas cluster (not local MongoDB)
 3. Check the Atlas UI to see if the index is being created
 4. Increase `MAX_INDEX_WAIT_SECONDS` if needed
diff --git a/mflix/server/js-express/.env.example b/mflix/server/js-express/.env.example
index 027a11e..725cc0d 100644
--- a/mflix/server/js-express/.env.example
+++ b/mflix/server/js-express/.env.example
@@ -1,12 +1,19 @@
-# MongoDB Configuration
-# Replace with your MongoDB Atlas connection string
+# MongoDB Connection
+# Replace with your MongoDB Atlas connection string or local MongoDB URI
 MONGODB_URI=mongodb+srv://<username>:<password>@<cluster>.mongodb.net/sample_mflix?retryWrites=true&w=majority
 
+# Voyage AI Configuration
+# API key for Voyage AI embedding model (required for Vector Search)
+VOYAGE_API_KEY=your_voyage_api_key
+
 # Server Configuration
 PORT=3001
 NODE_ENV=development
 
-# CORS Configuration (frontend URL)
+
+# CORS Configuration
+# Allowed origin for cross-origin requests (frontend URL)
+# For multiple origins, separate with commas
 CORS_ORIGIN=http://localhost:3000
 
 # Optional: Enable MongoDB Search tests
diff --git a/mflix/server/js-express/package.json b/mflix/server/js-express/package.json
index 2035bac..151b911 100644
--- a/mflix/server/js-express/package.json
+++ b/mflix/server/js-express/package.json
@@ -22,7 +22,7 @@
     "cors": "^2.8.5",
     "dotenv": "^17.2.3",
     "express": "^5.1.0",
-    "mongodb": "^6.20.0",
+    "mongodb": "^7.0.0",
     "swagger-jsdoc": "^6.2.8",
     "swagger-ui-express": "^5.0.1"
   },
diff --git a/mflix/server/js-express/src/routes/movies.ts b/mflix/server/js-express/src/routes/movies.ts
index a4dbbf9..ed2c9d0 100644
--- a/mflix/server/js-express/src/routes/movies.ts
+++ b/mflix/server/js-express/src/routes/movies.ts
@@ -122,8 +122,8 @@ router.get("/", asyncHandler(movieController.getAllMovies));
  * @swagger
  * /api/movies/search:
  *   get:
- *     summary: Search movies using MongoDB Atlas Search
- *     description: Search movies using MongoDB Atlas Search across multiple fields with compound queries and fuzzy matching. Demonstrates MongoDB Atlas Search capabilities.
+ *     summary: Search movies using MongoDB Search
+ *     description: Search movies using MongoDB Search across multiple fields with compound queries and fuzzy matching. Demonstrates MongoDB Search capabilities.
  *     tags: [Movies]
  *     parameters:
  *       - in: query
diff --git a/mflix/server/js-express/src/types/index.ts b/mflix/server/js-express/src/types/index.ts
index 5515c75..34e3fc7 100644
--- a/mflix/server/js-express/src/types/index.ts
+++ b/mflix/server/js-express/src/types/index.ts
@@ -286,7 +286,7 @@ export type RawMovieSearchQuery = {
 };
 
 /**
- * Interface for MongoDB Atlas Search phrase queries
+ * Interface for MongoDB Search phrase queries
  */
 export interface SearchPhrase {
   phrase?: {
diff --git a/mflix/server/js-express/tests/integration/README.md b/mflix/server/js-express/tests/integration/README.md
index c251312..9e7a7da 100644
--- a/mflix/server/js-express/tests/integration/README.md
+++ b/mflix/server/js-express/tests/integration/README.md
@@ -13,7 +13,7 @@ The integration tests are organized into three main categories:
    - Automatically skipped if `MONGODB_URI` is not set
 
 2. **MongoDB Search Integration Tests** (`mongodbSearch.integration.test.ts`)
-   - Tests the MongoDB Atlas Search API endpoint using `supertest`
+   - Tests the MongoDB Search API endpoint using `supertest`
    - Makes actual HTTP requests to test the `/api/movies/search` endpoint
    - Tests search by plot, directors, cast, pagination, and search operators
    - Automatically skipped if `ENABLE_SEARCH_TESTS` is not set
@@ -22,10 +22,10 @@ The integration tests are organized into three main categories:
    - Tests advanced API endpoints using `supertest`
    - Makes actual HTTP requests to test:
      - **Aggregation endpoints**: Movies with comments, statistics by year, directors with most movies
-     - **Atlas Search endpoint**: Compound queries, phrase matching, fuzzy matching
+     - **MongoDB Search endpoint**: Compound queries, phrase matching, fuzzy matching
      - **Vector Search endpoint**: Semantic similarity search using embeddings
    - Aggregation tests automatically run if `MONGODB_URI` is set
-   - Atlas Search tests require `ENABLE_SEARCH_TESTS=true`
+   - MongoDB Search tests require `ENABLE_SEARCH_TESTS=true`
    - Vector Search tests require `VOYAGE_API_KEY` to be set
 
 **Note:** Tests use `describeIntegration`, `describeSearch`, and `describeVectorSearch` wrappers (from `setup.ts` and test files) that automatically skip entire test suites when the required environment variables are not set.
@@ -49,7 +49,7 @@ This approach ensures that the API endpoints work correctly from the client's pe
 - **MONGODB_URI** environment variable must be set
 - MongoDB instance must be accessible (can be local MongoDB or Atlas)
 
-### Atlas Search Tests
+### MongoDB Search Tests
 
 - **MongoDB instance** with Search enabled (local MongoDB or Atlas)
 - **MONGODB_URI** environment variable
diff --git a/mflix/server/js-express/tests/integration/advancedEndpoints.integration.test.ts b/mflix/server/js-express/tests/integration/advancedEndpoints.integration.test.ts
index 55f9663..71702e2 100644
--- a/mflix/server/js-express/tests/integration/advancedEndpoints.integration.test.ts
+++ b/mflix/server/js-express/tests/integration/advancedEndpoints.integration.test.ts
@@ -2,7 +2,7 @@
  * Advanced Endpoints Integration Tests
  *
  * These tests verify the advanced MongoDB API endpoints including:
- * - Atlas Search
+ * - MongoDB Search
  * - Vector Search
  * - Aggregation pipelines ($lookup, $group, $unwind)
  *
@@ -322,14 +322,14 @@ describeIntegration("Advanced Endpoints Integration Tests", () => {
   });
 });
 
-describeSearch("Atlas Search Integration Tests", () => {
+describeSearch("MongoDB Search Integration Tests", () => {
   let testMovieIds: string[] = [];
 
   beforeAll(async () => {
     if (!process.env.ENABLE_SEARCH_TESTS) {
       console.log(`
-⚠️  Atlas Search tests skipped: ENABLE_SEARCH_TESTS environment variable is not set
-   To run Atlas Search integration tests, set ENABLE_SEARCH_TESTS=true in your .env file
+⚠️  MongoDB Search tests skipped: ENABLE_SEARCH_TESTS environment variable is not set
+   To run MongoDB Search integration tests, set ENABLE_SEARCH_TESTS=true in your .env file
    Example: ENABLE_SEARCH_TESTS=true npm run test:integration
 `);
       return;
diff --git a/mflix/server/js-express/tests/integration/mongodbSearch.integration.test.ts b/mflix/server/js-express/tests/integration/mongodbSearch.integration.test.ts
index 614a1de..741ad65 100644
--- a/mflix/server/js-express/tests/integration/mongodbSearch.integration.test.ts
+++ b/mflix/server/js-express/tests/integration/mongodbSearch.integration.test.ts
@@ -1,7 +1,7 @@
 /**
- * MongoDB Atlas Search API Integration Tests
+ * MongoDB Search API Integration Tests
  *
- * These tests verify the Atlas Search API endpoints with actual HTTP requests.
+ * These tests verify the MongoDB Search API endpoints with actual HTTP requests.
  * The tests require:
  * - A MongoDB Atlas instance with Search enabled
  * - MONGODB_URI environment variable
@@ -15,7 +15,7 @@ import request from "supertest";
 import { app } from "../../src/app";
 import { describeSearch } from "./setup";
 
-describeSearch("MongoDB Atlas Search API Integration Tests", () => {
+describeSearch("MongoDB API Integration Tests", () => {
 
   describe("GET /api/movies/search - Search by plot", () => {
     test("should find movies with plot search", async () => {
diff --git a/mflix/server/python-fastapi/.env.example b/mflix/server/python-fastapi/.env.example
index 7303405..964d6dd 100644
--- a/mflix/server/python-fastapi/.env.example
+++ b/mflix/server/python-fastapi/.env.example
@@ -1,4 +1,5 @@
-# MongoDB Configuration
+# MongoDB Connection
+# Replace with your MongoDB Atlas connection string or local MongoDB URI
 MONGO_URI="mongodb://localhost:27017"
 MONGO_DB="sample_mflix"
 
@@ -7,5 +8,6 @@ MONGO_DB="sample_mflix"
 VOYAGE_API_KEY=your_voyage_api_key
 
 # CORS Configuration
-# Comma-separated list of allowed origins for CORS
+# Allowed origin for cross-origin requests (frontend URL)
+# For multiple origins, separate with commas
 CORS_ORIGINS="http://localhost:3000,http://localhost:3001"
\ No newline at end of file
diff --git a/mflix/server/python-fastapi/src/routers/movies.py b/mflix/server/python-fastapi/src/routers/movies.py
index 797f7d2..4bcbdbf 100644
--- a/mflix/server/python-fastapi/src/routers/movies.py
+++ b/mflix/server/python-fastapi/src/routers/movies.py
@@ -118,7 +118,7 @@ async def search_movies(
     cast: str = Query(default=None),
     limit:int = Query(default=20, ge=1, le=100),
     skip:int = Query(default=0, ge=0),
-    search_operator: str = Query(default="must")
+    search_operator: str = Query(default="must", alias="searchOperator")
 ) -> SuccessResponse[SearchMoviesResponse]:
     
     search_phrases = []
@@ -345,7 +345,7 @@ async def vector_search_movies(
                     "index": "vector_index",
                     "path": "plot_embedding_voyage_3_large",
                     "queryVector": query_embedding, #2048
-                    "numCandidates": limit * 15,  # Search more candidates for better results
+                    "numCandidates": limit * 20,  # We recommend searching 20 times higher than the limit to improve result relevance
                     "limit": limit
                 }
             },
@@ -482,12 +482,12 @@ async def get_all_movies(
     title: str = Query(default=None),
     genre:str = Query(default=None),
     year:int = Query(default=None),
-    min_rating:float = Query(default=None),
-    max_rating:float = Query(default=None),
+    min_rating:float = Query(default=None, alias="minRating"),
+    max_rating:float = Query(default=None, alias="maxRating"),
     limit:int = Query(default=20, ge=1, le=100),
     skip:int = Query(default=0, ge=0),
-    sort_by:str = Query(default="title"),
-    sort_order:str = Query(default="asc")
+    sort_by:str = Query(default="title", alias="sortBy"),
+    sort_order:str = Query(default="asc", alias="sortOrder")
 ):
     movies_collection = get_collection("movies")
     filter_dict = {}

From b9cecb848456ebcb02bc556bd5da4804a7d1fdac Mon Sep 17 00:00:00 2001
From: Jordan Smith <jordan.smith@mongodb.com>
Date: Fri, 7 Nov 2025 12:20:14 -0500
Subject: [PATCH 097/110] sync env examples and add voyage dependency to
 readmes

---
 mflix/README-JAVA-SPRING.md              | 2 ++
 mflix/README-JAVASCRIPT-EXPRESS.md       | 2 ++
 mflix/server/java-spring/.env.example    | 2 +-
 mflix/server/python-fastapi/.env.example | 2 +-
 4 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/mflix/README-JAVA-SPRING.md b/mflix/README-JAVA-SPRING.md
index 45ef3f7..3da91f7 100644
--- a/mflix/README-JAVA-SPRING.md
+++ b/mflix/README-JAVA-SPRING.md
@@ -21,6 +21,8 @@ This is a full-stack movie browsing application built with Java Spring Boot and
 - **MongoDB Atlas cluster or local deployment** with the `sample_mflix` dataset loaded
   - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/) 
 - **Maven** (included via Maven Wrapper)
+- **Voyage AI API key** (For MongoDB Vector Search)
+  - [Get a Voyage AI API key](https://www.voyageai.com/)
 
 ## Getting Started
 
diff --git a/mflix/README-JAVASCRIPT-EXPRESS.md b/mflix/README-JAVASCRIPT-EXPRESS.md
index f212370..2ef3705 100644
--- a/mflix/README-JAVASCRIPT-EXPRESS.md
+++ b/mflix/README-JAVASCRIPT-EXPRESS.md
@@ -20,6 +20,8 @@ This is a full-stack movie browsing application built with Express.js and Next.j
 - **MongoDB Atlas cluster or local deployment** with the `sample_mflix` dataset loaded
   - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/) 
 - **npm** (included with Node.js)
+- **Voyage AI API key** (For MongoDB Vector Search)
+  - [Get a Voyage AI API key](https://www.voyageai.com/)
 
 ## Getting Started
 
diff --git a/mflix/server/java-spring/.env.example b/mflix/server/java-spring/.env.example
index 79c8422..627b54b 100644
--- a/mflix/server/java-spring/.env.example
+++ b/mflix/server/java-spring/.env.example
@@ -1,6 +1,6 @@
 # MongoDB Connection
 # Replace with your MongoDB Atlas connection string or local MongoDB URI
-MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/?retryWrites=true&w=majority
+MONGODB_URI=mongodb+srv://<username>:<password>@<cluster>.mongodb.net/sample_mflix?retryWrites=true&w=majority
 
 # Voyage AI Configuration
 # API key for Voyage AI embedding model (required for Vector Search)
diff --git a/mflix/server/python-fastapi/.env.example b/mflix/server/python-fastapi/.env.example
index 964d6dd..c5cf791 100644
--- a/mflix/server/python-fastapi/.env.example
+++ b/mflix/server/python-fastapi/.env.example
@@ -1,6 +1,6 @@
 # MongoDB Connection
 # Replace with your MongoDB Atlas connection string or local MongoDB URI
-MONGO_URI="mongodb://localhost:27017"
+MONGO_URI="mongodb+srv://<username>:<password>@<cluster>.mongodb.net/sample_mflix?retryWrites=true&w=majority"
 MONGO_DB="sample_mflix"
 
 # Voyage AI Configuration

From 605e3afebd96586f38ba2d3a47a3466b66a0c69e Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Fri, 7 Nov 2025 12:28:07 -0500
Subject: [PATCH 098/110] update readme

---
 mflix/README-PYTHON-FASTAPI.md                | 191 +++++++++++++++++-
 mflix/server/python-fastapi/.env.example      |   4 +-
 .../python-fastapi/README_OLD_REMOVE_ME.md    | 123 -----------
 3 files changed, 188 insertions(+), 130 deletions(-)
 delete mode 100644 mflix/server/python-fastapi/README_OLD_REMOVE_ME.md

diff --git a/mflix/README-PYTHON-FASTAPI.md b/mflix/README-PYTHON-FASTAPI.md
index 229462f..539e317 100644
--- a/mflix/README-PYTHON-FASTAPI.md
+++ b/mflix/README-PYTHON-FASTAPI.md
@@ -1,22 +1,202 @@
 # Python FastAPI MongoDB Sample MFlix Application
 
-[TODO: Add intro]
+This is a full-stack movie browsing application built with Python FastAPI and Next.js, demonstrating MongoDB operations using the `sample_mflix` dataset. The application showcases CRUD operations, aggregations, and MongoDB Search using the PyMongo driver.
+
+## Project Structure
 
 ```
-├── README.md
-├── client/     # Next.js frontend
-└── server/     # Python FastAPI backend
+├── README-PYTHON-FASTAPI.md
+├── client/                 # Next.js frontend (TypeScript)
+└── server/python-fastapi/  # Python FastAPI backend
+    ├── src/
+    ├── tests/
+    ├── .env.example
+    ├── main.py
+    ├── pytest.ini
+    ├── requirements.in
+    └── requirements.txt
 ```
 
+## Prerequisites
+
+- **Python 3.10** to **Python 3.13**
+- **Node.js 20** or higher
+- **MongoDB Atlas cluster or local deployment** with the `sample_mflix` dataset loaded
+  - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/) 
+- **pip** for Python package management
+- **Voyage AI API key** (For MongoDB Vector Search)
+  - [Get a Voyage AI API key](https://www.voyageai.com/)
+
 ## Getting Started
 
-[TODO: Add getting started instructions explaining how to set connection string, start server, start client, etc.]
+### 1. Configure the Backend
+
+Navigate to the Python FastAPI server directory:
+
+```bash
+cd server/python-fastapi
+```
+
+Create a `.env` file from the example:
+
+```bash
+cp .env.example .env
+```
+
+Edit the `.env` file and set your MongoDB connection string:
+
+```env
+# MongoDB Configuration
+MONGO_URI=mongodb+srv://<username>:<password>@<cluster>.mongodb.net/sample_mflix?retryWrites=true&w=majority
+MONGO_DB=sample_mflix
+
+# Voyage AI Configuration
+# API key for Voyage AI embedding model (required for Vector Search)
+VOYAGE_API_KEY=your_voyage_api_key
+
+# CORS Configuration
+# Comma-separated list of allowed origins for CORS
+CORS_ORIGINS=http://localhost:3000,http://localhost:8000
+```
+
+**Note:** Replace `username`, `password`, and `cluster` with your actual MongoDB Atlas
+credentials.
+
+Make a virtual environment:
+
+```bash
+python -m venv .venv
+```
+
+Activate the virtual environment:
+    
+```bash
+source .venv/bin/activate
+```
+
+Install Python dependencies:
+
+```bash
+pip install -r requirements.txt
+```
+
+### 2. Start the Backend Server
+
+From the `server/python-fastapi` directory, run:
+
+```bash
+fastapi dev main.py --reload
+```
+
+The server will start on `http://localhost:8000`. You can verify it's running by visiting:
+- API root: http://localhost:8000/api/movies
+- API documentation (Swagger UI): http://localhost:8000/docs
+
+### 3. Configure and Start the Frontend
+
+Open a new terminal and navigate to the client directory:
+
+```bash
+cd client
+```
+
+Install dependencies:
+
+```bash
+npm install
+```
+
+Start the development server:
+
+```bash
+npm run dev
+```
+
+The Next.js application will start on `http://localhost:3000`.
+
+### 4. Access the Application
+
+Open your browser and navigate to:
+- **Frontend:** http://localhost:3000
+- **Backend API:** http://localhost:8000
+- **API Documentation:** http://localhost:8000/docs
+
+## Features
+
+- **Browse Movies:** View a paginated list of movies from the sample_mflix dataset
+- **Search:** Full-text search using MongoDB Search
+- **Vector Search:** Semantic search using MongoDB Vector Search with Voyage AI embeddings
+- **Filter:** Filter movies by genre, year, rating, and more
+- **Movie Details:** View detailed information about each movie
+- **Aggregations:** Complex data aggregations and analytics
+
+## Development
+
+### Backend Development
+
+The Python FastAPI backend uses:
+- **FastAPI** for REST API framework
+- **PyMongo** for database operations
+- **Voyage AI** for vector embeddings
+- **fastapi** for ASGI server
+
+To run all tests:
+
+```bash
+cd server/python-fastapi
+source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows
+pytest tests/ -v
+```
+
+### Frontend Development
+
+The Next.js frontend uses:
+- **React 19** with TypeScript
+- **Next.js 16** with App Router
+- **Turbopack** for fast development builds
+
+#### Development Mode
+
+For active development with hot reloading and fast refresh:
+
+```bash
+cd client
+npm run dev
+```
+
+This starts the development server on `http://localhost:3000` with Turbopack for fast rebuilds.
+
+#### Production Build
+
+To create an optimized production build and run it:
+
+```bash
+cd client
+npm run build  # Creates optimized production build
+npm start      # Starts production server
+```
+
+The production build:
+- Minifies and optimizes JavaScript and CSS
+- Optimizes images and assets
+- Generates static pages where possible
+- Provides better performance for end users
+
+#### Linting
+
+To check code quality:
+
+```bash
+cd client
+npm run lint
+```
 
 ## Issues
 
 If you have problems running the sample app, please check the following:
 
 - [ ] Verify that you have set your MongoDB connection string in the `.env` file.
+- [ ] Verify that you have created and activated a Python `.venv` on Python v3.10 through v3.13.
 - [ ] Verify that you have started the Python FastAPI server.
 - [ ] Verify that you have started the Next.js client.
 - [ ] Verify that you have no firewalls blocking access to the server or client ports.
@@ -24,3 +204,4 @@ If you have problems running the sample app, please check the following:
 If you have verified the above and still have issues, please
 [open an issue](https://github.com/mongodb/docs-sample-apps/issues/new/choose)
 on the source repository `mongodb/docs-sample-apps`.
+
diff --git a/mflix/server/python-fastapi/.env.example b/mflix/server/python-fastapi/.env.example
index 7303405..e25ebf9 100644
--- a/mflix/server/python-fastapi/.env.example
+++ b/mflix/server/python-fastapi/.env.example
@@ -1,5 +1,5 @@
 # MongoDB Configuration
-MONGO_URI="mongodb://localhost:27017"
+MONGO_URI="mongodb+srv://<username>:<password>@<cluster>.mongodb.net/sample_mflix?retryWrites=true&w=majority"
 MONGO_DB="sample_mflix"
 
 # Voyage AI Configuration
@@ -8,4 +8,4 @@ VOYAGE_API_KEY=your_voyage_api_key
 
 # CORS Configuration
 # Comma-separated list of allowed origins for CORS
-CORS_ORIGINS="http://localhost:3000,http://localhost:3001"
\ No newline at end of file
+CORS_ORIGINS="http://localhost:3000,http://localhost:8000"
\ No newline at end of file
diff --git a/mflix/server/python-fastapi/README_OLD_REMOVE_ME.md b/mflix/server/python-fastapi/README_OLD_REMOVE_ME.md
deleted file mode 100644
index 504019a..0000000
--- a/mflix/server/python-fastapi/README_OLD_REMOVE_ME.md
+++ /dev/null
@@ -1,123 +0,0 @@
-# Welcome to the Python Backend
-
-TOC
-1. [Overview](#overview)
-2. [Getting Setup](#getting-setup)
-3. [Learning FastAPI](#learning-fastapi)
-4. [Exploring the Codebase](#exploring-the-codebase)
-5. [Feature Parity Status](#feature-parity-status)
-6. [Utilities and Nice to Know](#nice-to-know)
-
-
-## Overview
-We're porting our Express backend to Python/FastAPI to achieve **functional parity** - same endpoints, same responses, same MongoDB operations. This allows one frontend to work with multiple backends.
-
-
-**Important**: We're not rewriting - we're replicating behavior exactly. So this means we are figuring out the pythonic way of doing things. You will find that we can accomplish things with Fast in fewer lines of code than in Express.
-
-## Getting Setup
-0. Install Python if you don't already have it. (*Depending on your version of python, you might need to use python3 and pip3 vs python and pip*)
-1. Clone from my fork of the main repo.
-    ```sh
-    https://github.com/tmcneil-mdb/docs-sample-apps.git
-    ```
-
-2. Checkout my branch 
-    ```sh
-    git checkout python-backend-setup
-    ```
-
-4. Verify you are on the right branch 
-    ```sh
-    git branch
-    ```
-5. In the root directory. /python, make a virtual environment. 
-    ```sh
-    python -m venv .venv
-    ```
-6. Activate the virtual environment 
-    ```sh
-    source .venv/bin/activate
-    ```
-7. Navigate back to /python, install the required packages. 
-    ```sh 
-    pip install -r requirements.txt
-    ```
-8. Create an .env file at the /python root.
-It should have this format:
-    ```python
-    MONGO_URI="place your connection string here"
-    MONGO_DB="sample_mflix"
-    ```
-9. Navigate back to the root and start the server.
-    ```sh
-    fastapi dev main.py or uvicorn main:app --reload
-    ``` 
-    (NOTE: THESE WONT WORK IF THE VIRTUAL ENVIRONMENT IS NOT ACTIVATED)
-10. Click the link in the terminal or visit ```localhost:8000/docs```
-11. Try visiting ```localhost:8000/api/movies```.
-
-    If the setup ran correctly, you should see data  🎉 
-
-*I recommend having your atlas instance up to explore your data and query the db directly.*
-
-**Troubleshooting**: If commands fail, ensure your virtual environment is activated (you should see `(.venv)` in your terminal prompt). 
-
-
-## Learning FastAPI 
-Before diving into the repo, I suggest spending some time with the official [FastAPI tutorial](https://fastapi.tiangolo.com/tutorial/).
-
-You only need to read up to the 'Request Body' section to get comfortable. *The query parameters and path parameters section can be read later.*
-
-Key Takeaways:
-- Decorators (@app.get, @app.post,etc.)
-- Query, path, and body parameters
-- Pydantic validation/ serialization
-- Automatic JSON responses
-- Built-in docs and testing at '/docs'
-
-
-## Exploring the Codebase
-Once you have completed the tutorial, I would suggest exploring the code and just noticing the differences between Express and Python. The apps are setup similarly but there are some small differences.
-
-### Architecture
-|Layer|Purpose|Express Equivalent| Differences|
-|:---|:-------|:----------|:------|
-|Routes <br> `src/routers/movies.py`| Defines all /movies endpoints (GET, POST, PUT, etc.)| /controllers/movieController.ts |The movies.ts file inside the routes file in the Express backend it actually wiring up the endpoints. Fast handles this for us in the main.py in one line. ```app.include_router(movies.router, prefix="/api/movies", tags=["movies"])```|
-|Models <br> `src/models/models.py`| Pydantic schema for validating and serializing request/response data.| /types/index.ts|There are some differences in how the models are constructed. Take note on how nested classes are handled.|
-|Utils <br> `src/utils/errorHandler.py`| Centralized utilities for responses, error handling and MongoDB exception mapping.|utils/errorHandler.ts |Express requires devs to write exception handling and validation on their own. Pydanic handles the validation and exception handling is a bit cleaner in Fast. You will notice the most differences here.|
-|Database <br>`src/database/mongo_client.py`| Handles the connection to the db|/config/database.ts| *The current database file does not have feature parity with the Express version*|
-
-
-## Feature Parity Status
-|Feature|Status|Owner|Notes|
-|:------|:-----|:----|:----|
-|Global Exception Handling| DONE| - |Found in Utils |
-|JSON Response Matching| DONE | - |Found in Utils|
-|CRUD- ```insertOne()```| Not Started| Angela| - |
-|CRUD- ```insertMany()```| Not Started| Taylor| - |
-|CRUD- ```findOne()```| Not Started| Angela| - |
-|CRUD- ```find()```| DONE| - | Found in movies.py as ```get_all_movies()``` This is a good function to look at to understand query parameters, requests and responses. Your functions will be simpler than this. But that is a good base to start with.| 
-|CRUD- ```updateOne()```| Not Started| Angela| - |
-|CRUD- ```updateMany()```| Not Started| Taylor| - |
-|CRUD- ```deleteOne()```| Not Started| Angela| - |
-|CRUD- ```deleteMany()```| Not Started| Taylor| -|
-|CRUD- ```findOne()```| Not Started| Angela| - |
-|CRUD- ```findOneAndDelete()```| Not Started| Angela| This one is a bit harder but I figure this could be a fun challenge.|
-
-
-## Nice to Know
-### Utilities (errorHandler.py)
-This module provides a parity replacement for the Express errorHandler.ts file. It provides the same response shapes and error handling and removes the middleware.
-
-- create_success_response(data,message) - creates a success response with the same shape as the Express version.
-- create_error_response(message,code,details) - creates a error response with the same shape as the Express version.
-- parse_mongo_exception(exc) - ensures PyMongo exceptions return JSON identical to the Express Version
-- register_error_handlers - hooks our error system into the Fast app
-
-Fast automatically handles async and validation errors, so there is no need for asyncHandler or validateRequiredFields from the TS version.
-
-### Useful Links
-- [Main Repo]( https://github.com/mongodb/docs-sample-apps/tree/main )
-- [Sample App Scoping Doc](https://docs.google.com/document/d/12dROckw_Cp0ku2IIGku-ch7MvEuBPo0V4Gs-5wQgeHQ/edit?tab=t.0)
-- [Sample App Project Description & Breakdown Doc](https://docs.google.com/document/d/1xv2dmcNrT-HYk5TBE-KtVDPmW0274rpBZ0_0QmC66ac/edit?tab=t.0#heading=h.ki9tatw08ilc)
\ No newline at end of file

From be79f2761645daf3c04212707ceb3643e6c65244 Mon Sep 17 00:00:00 2001
From: Jordan Smith <jordan.smith@mongodb.com>
Date: Fri, 7 Nov 2025 13:16:28 -0500
Subject: [PATCH 099/110] Dachary feedback

---
 mflix/README-JAVA-SPRING.md        |  28 +++--
 mflix/README-JAVASCRIPT-EXPRESS.md |  41 +++---
 mflix/client/README.md             | 195 ++++++++++++++---------------
 3 files changed, 140 insertions(+), 124 deletions(-)

diff --git a/mflix/README-JAVA-SPRING.md b/mflix/README-JAVA-SPRING.md
index 3da91f7..8136dad 100644
--- a/mflix/README-JAVA-SPRING.md
+++ b/mflix/README-JAVA-SPRING.md
@@ -5,9 +5,9 @@ This is a full-stack movie browsing application built with Java Spring Boot and
 ## Project Structure
 
 ```
-├── README-JAVA-SPRING.md
+├── README.md
 ├── client/                 # Next.js frontend (TypeScript)
-└── server/java-spring/     # Java Spring Boot backend
+└── server/                 # Java Spring Boot backend
     ├── src/
     ├── pom.xml
     ├── .env.example
@@ -31,7 +31,7 @@ This is a full-stack movie browsing application built with Java Spring Boot and
 Navigate to the Java Spring server directory:
 
 ```bash
-cd server/java-spring
+cd server
 ```
 
 Create a `.env` file from the example:
@@ -44,20 +44,32 @@ Edit the `.env` file and set your MongoDB connection string:
 
 ```env
 # MongoDB Connection
-MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/?retryWrites=true&w=majority
+# Replace with your MongoDB Atlas connection string or local MongoDB URI
+MONGODB_URI=mongodb+srv://<username>:<password>@<cluster>.mongodb.net/sample_mflix?retryWrites=true&w=majority
+
+# Voyage AI Configuration
+# API key for Voyage AI embedding model (required for Vector Search)
+VOYAGE_API_KEY=your_voyage_api_key
 
 # Server Configuration
+# Port on which the Spring Boot application will run
 PORT=3001
 
 # CORS Configuration
+# Allowed origin for cross-origin requests (frontend URL)
+# For multiple origins, separate with commas
 CORS_ORIGIN=http://localhost:3000
+
+# Optional: Enable MongoDB Search tests
+# Uncomment the following line to enable Search tests
+# ENABLE_SEARCH_TESTS=true
 ```
 
 **Note:** Replace `username`, `password`, and `cluster` with your actual MongoDB Atlas credentials.
 
 ### 2. Start the Backend Server
 
-From the `server/java-spring` directory, run:
+From the `server` directory, run:
 
 ```bash
 # Using Maven Wrapper (recommended)
@@ -125,7 +137,7 @@ The Java Spring Boot backend uses:
 To run tests:
 
 ```bash
-cd server/java-spring
+cd server
 ./mvnw test
 ```
 
@@ -182,5 +194,5 @@ If you have problems running the sample app, please check the following:
 - [ ] Verify that you have no firewalls blocking access to the server or client ports.
 
 If you have verified the above and still have issues, please
-[open an issue](https://github.com/mongodb/sample-app-java-mflix/issues/new/choose)
-on the source repository `mongodb/sample-app-java-mflix`.
+[open an issue](https://github.com/mongodb/docs-sample-apps/issues/new/choose)
+on the source repository `mongodb/docs-sample-apps`.
diff --git a/mflix/README-JAVASCRIPT-EXPRESS.md b/mflix/README-JAVASCRIPT-EXPRESS.md
index 2ef3705..39bd092 100644
--- a/mflix/README-JAVASCRIPT-EXPRESS.md
+++ b/mflix/README-JAVASCRIPT-EXPRESS.md
@@ -5,9 +5,9 @@ This is a full-stack movie browsing application built with Express.js and Next.j
 ## Project Structure
 
 ```
-├── README-JAVASCRIPT-EXPRESS.md
+├── README.md
 ├── client/                 # Next.js frontend (TypeScript)
-└── server/js-express/      # Express.js backend
+└── server                  # Express.js backend
     ├── src/
     ├── package.json
     ├── .env.example
@@ -30,7 +30,7 @@ This is a full-stack movie browsing application built with Express.js and Next.j
 Navigate to the Express server directory:
 
 ```bash
-cd server/js-express
+cd server
 ```
 
 Create a `.env` file from the example:
@@ -42,15 +42,22 @@ cp .env.example .env
 Edit the `.env` file and set your MongoDB connection string:
 
 ```env
-# MongoDB Configuration
-# Replace with your MongoDB Atlas connection string
+# MongoDB Connection
+# Replace with your MongoDB Atlas connection string or local MongoDB URI
 MONGODB_URI=mongodb+srv://<username>:<password>@<cluster>.mongodb.net/sample_mflix?retryWrites=true&w=majority
 
+# Voyage AI Configuration
+# API key for Voyage AI embedding model (required for Vector Search)
+VOYAGE_API_KEY=your_voyage_api_key
+
 # Server Configuration
 PORT=3001
 NODE_ENV=development
 
-# CORS Configuration (frontend URL)
+
+# CORS Configuration
+# Allowed origin for cross-origin requests (frontend URL)
+# For multiple origins, separate with commas
 CORS_ORIGIN=http://localhost:3000
 
 # Optional: Enable MongoDB Search tests
@@ -58,11 +65,13 @@ CORS_ORIGIN=http://localhost:3000
 # ENABLE_SEARCH_TESTS=true
 ```
 
-**Note:** Replace `<username>`, `<password>`, and `<cluster>` with your actual MongoDB Atlas credentials.
+**Note:** Replace `<username>`, `<password>`, and `<cluster>` with
+your actual MongoDB Atlas credentials. Replace `your_voyage_api_key` with
+your key.
 
 ### 2. Install Backend Dependencies
 
-From the `server/js-express` directory, run:
+From the `server` directory, run:
 
 ```bash
 npm install
@@ -70,13 +79,17 @@ npm install
 
 ### 3. Start the Backend Server
 
-From the `server/js-express` directory, run:
+From the `server` directory, run:
 
 ```bash
 # Development mode with hot reloading
 npm run dev
+```
 
-# Or production mode
+
+Or for production mode, run:
+
+```bash
 npm run build
 npm start
 ```
@@ -140,14 +153,14 @@ The Express.js backend uses:
 To run tests:
 
 ```bash
-cd server/js-express
+cd server
 npm test
 ```
 
 To run tests with coverage:
 
 ```bash
-cd server/js-express
+cd server
 npm run test:coverage
 ```
 
@@ -204,5 +217,5 @@ If you have problems running the sample app, please check the following:
 - [ ] Verify that you have no firewalls blocking access to the server or client ports.
 
 If you have verified the above and still have issues, please
-[open an issue](https://github.com/mongodb/sample-app-nodejs-mflix/issues/new/choose)
-on the source repository `mongodb/sample-app-nodejs-mflix`.
+[open an issue](https://github.com/mongodb/docs-sample-apps/issues/new/choose)
+on the source repository `mongodb/docs-sample-apps`.
diff --git a/mflix/client/README.md b/mflix/client/README.md
index 811c099..b66f055 100644
--- a/mflix/client/README.md
+++ b/mflix/client/README.md
@@ -1,37 +1,49 @@
-# MongoDB Sample MFlix Frontend
+# Next.js MFlix Frontend Application
 
-This is a [Next.js](https://nextjs.org) frontend application that demonstrates MongoDB operations by connecting to an Express.js backend. The application showcases Server Side Rendering (SSR) and displays movie data from the sample_mflix database.
+This is a Next.js frontend application that demonstrates a modern movie browsing experience by connecting to a backend API. The application showcases Server Side Rendering (SSR), responsive design, and interactive features while displaying movie data from the MongoDB sample_mflix dataset.
 
-## Features
+## Project Structure
 
-- **Movies Page** (`/movies`): Displays a paginated grid of movies with Server Side Rendering
-- **Pagination**: Navigate through movies with previous/next controls and adjustable page sizes
-- **Movie Details Page** (`/movie/[id]`): Shows comprehensive movie information including plot, cast, ratings, and more
-- **Movie Cards**: Shows movie title, poster, year, rating, and genres with navigation to details
-- **Navigation**: Sticky navigation bar with links to home and movies pages
-- **Responsive Design**: Works on desktop and mobile devices
-- **Error Handling**: Graceful fallbacks for missing posters, API errors, and not-found movies
-- **Loading States**: Professional loading indicators and skeleton screens during data fetching
-- **SEO Optimized**: Dynamic metadata generation for movie pages and pagination
+```
+client/
+├── README.md
+├── package.json
+├── next.config.ts
+├── tsconfig.json
+├── .env.example
+└── app/
+    ├── layout.tsx          # Root layout with navigation
+    ├── page.tsx            # Home page
+    ├── globals.css         # Global styles
+    ├── movies/             # Movies listing page
+    ├── movie/[id]/         # Individual movie details
+    ├── aggregations/       # Data aggregations page
+    ├── components/         # Reusable UI components
+    ├── lib/                # API utilities and constants
+    └── types/              # TypeScript type definitions
+```
 
 ## Prerequisites
 
-1. **Express Backend**: The Express server must be running on `http://localhost:3001`
-2. **MongoDB Database**: The backend must be connected to a MongoDB instance with the sample_mflix dataset
-3. **Node.js**: Version 18 or higher
+- **Backend API Server**: The backend server must be running on `http://localhost:3001`
+- **MongoDB Database**: The backend must be connected to a MongoDB instance with the `sample_mflix` dataset loaded
+  - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/)
+- **Node.js 18** or higher
+- **npm** (included with Node.js)
 
 ## Getting Started
 
-### 1. Environment Configuration
+### 1. Configure the Environment
 
-Copy the environment example file and configure your API URL:
+Copy the environment example file:
 
 ```bash
 cp .env.example .env.local
 ```
 
-Edit `.env.local` and update the API_URL if needed:
-```bash
+Edit `.env.local` and update the API URL if needed:
+
+```env
 API_URL=http://localhost:3001
 ```
 
@@ -47,113 +59,92 @@ npm install
 npm run dev
 ```
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the application.
+The Next.js application will start on `http://localhost:3000`.
 
-### 4. View the Movies
+### 4. Access the Application
 
-Navigate to [http://localhost:3000/movies](http://localhost:3000/movies) to see the movies grid with data from the MongoDB sample_mflix database. 
+Open your browser and navigate to:
+- **Frontend:** http://localhost:3000
+- **Movies Page:** http://localhost:3000/movies
+- **Aggregations:** http://localhost:3000/aggregations
 
-**Pagination Features:**
-- Use the **Previous/Next** buttons to navigate between pages
-- Change the **page size** (10, 20, or 50 movies per page) using the dropdown selector
-- URL parameters support direct linking: `?page=2&limit=10`
-- Click the "Get Details" button on any movie card to view comprehensive movie information
+## Features
 
-## API Integration
+- **Browse Movies:** View a paginated list of movies from the sample_mflix dataset with server-side rendering
+- **Movie Details:** Access comprehensive movie information including plot, cast, ratings, and metadata
+- **CRUD Operations:** Create, read, update, and delete movies through an intuitive interface
+- **Search & Filters:** Search movies with various filters and sorting options
+- **Vector Search:** Find movies with similar plot descriptions using AI-powered search
+- **Data Aggregations:** View analytics and insights built with MongoDB aggregation pipelines
+- **Responsive Design:** Optimized experience across desktop and mobile devices
+- **Real-time Updates:** Dynamic content updates without page refreshes
 
-The application connects to the Express backend using Server Side Rendering:
+## Development
 
-- **Movies API**: `GET /api/movies` - Fetches movie data with pagination support (`limit` and `skip` parameters)
-- **Movie Details API**: `GET /api/movies/:id` - Fetches detailed information for a specific movie
-- **Pagination**: Smart pagination that detects available pages by requesting `limit + 1` movies
-- **Error Handling**: Graceful fallbacks when the API is unavailable
-- **Type Safety**: TypeScript interfaces matching the backend data structure
+### Frontend Development
 
-## Available Scripts
+The Next.js frontend uses:
+- **React 19** with TypeScript for modern component development
+- **Next.js 15** with App Router for server-side rendering and routing
+- **Turbopack** for fast development builds and hot reloading
+- **CSS Modules** for component-scoped styling
+- **ESLint** for code quality and consistency
 
-- `npm run dev` - Starts the development server with Turbopack
-- `npm run build` - Builds the application for production
-- `npm run start` - Starts the production server
-- `npm run lint` - Runs ESLint for code quality
+#### Development Mode
 
-## Project Structure
+For active development with hot reloading and fast refresh:
 
-```
-client/
-├── app/
-│   ├── movie/
-│   │   └── [id]/
-│   │       ├── page.tsx      # Movie details page with SSR
-│   │       ├── loading.tsx   # Loading skeleton for details
-│   │       ├── error.tsx     # Error boundary for details
-│   │       └── not-found.tsx # 404 page for invalid movies
-│   ├── movies/
-│   │   ├── page.tsx      # Movies page with SSR
-│   │   └── loading.tsx   # Loading component
-│   ├── components/
-│   │   └── MovieCard/    # Reusable movie card component
-│   ├── lib/
-│   │   ├── api.ts        # API functions
-│   │   └── constants.ts  # App constants and routes
-│   ├── types/
-│   │   └── movie.ts      # TypeScript type definitions
-│   ├── layout.tsx        # Root layout with navigation
-│   └── page.tsx          # Home page
-├── .env.example          # Environment variables template
-└── .env.local           # Local environment configuration
+```bash
+npm run dev
 ```
 
-## Development Notes
+This starts the development server on `http://localhost:3000` with Turbopack for fast rebuilds.
 
-### Server Side Rendering
+#### Production Build
 
-The movies page uses Next.js Server Side Rendering (SSR) to fetch data on the server before sending the page to the client. This provides:
+To create an optimized production build:
 
-- **Better SEO**: Search engines can index the movie content
-- **Faster Initial Load**: Users see content immediately
-- **Fresh Data**: Movie data is fetched on each page request
-
-### Type Safety
+```bash
+npm run build  # Creates optimized production build
+npm start      # Starts production server
+```
 
-The application uses TypeScript interfaces that match the backend MongoDB document structure:
+The production build:
+- Minifies and optimizes JavaScript and CSS
+- Optimizes images and assets  
+- Generates static pages where possible
+- Provides better performance for end users
 
-```typescript
-interface Movie {
-  _id: string;
-  title: string;
-  year?: number;
-  poster?: string;
-  genres?: string[];
-  imdb?: {
-    rating?: number;
-  };
-}
-```
+#### Code Quality
 
-### Error Handling
+To check code quality and formatting:
 
-- **API Errors**: Shows fallback message when the backend is unavailable
-- **Missing Posters**: Displays placeholder for movies without poster images
-- **Network Issues**: Graceful degradation with empty state
+```bash
+npm run lint
+```
 
-## Learn More
+### API Integration
 
-To learn more about the technologies used:
+The application connects to the backend API using:
+- **Server-Side Rendering**: Data fetched on the server for better SEO and performance
+- **TypeScript**: Type-safe API calls with interfaces matching backend data structures
+- **Error Handling**: Graceful fallbacks when the API is unavailable
+- **Loading States**: Professional loading indicators and skeleton screens
 
-- [Next.js Documentation](https://nextjs.org/docs) - Learn about Next.js features and API
-- [MongoDB Node.js Driver](https://mongodb.github.io/node-mongodb-native/) - Backend database integration
-- [TypeScript](https://www.typescriptlang.org/) - Type safety and development experience
+### Key Technologies
 
-## Deployment
+- **Next.js SSR**: Server-side rendering for better performance and SEO
+- **TypeScript**: Full type safety across the application
+- **CSS Modules**: Scoped styling to prevent style conflicts
+- **Responsive Design**: Mobile-first approach with flexible layouts
 
-### Development
-The application is configured to work with a local Express backend on port 3001.
+## Issues
 
-### Production
-For production deployment:
+If you have problems running the sample app, please check the following:
 
-1. Update `API_URL` in your environment configuration
-2. Build the application: `npm run build`
-3. Start the production server: `npm start`
+- [ ] Verify that you have started the backend server on port 3001.
+- [ ] Verify that the backend is connected to MongoDB with the sample_mflix dataset.
+- [ ] Verify that you have set the correct API_URL in your `.env.local` file.
+- [ ] Verify that you have no firewalls blocking access to ports 3000 or 3001.
 
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+If you have verified the above and still have issues, please [open an issue](https://github.com/mongodb/docs-sample-apps/issues/new/choose) on the source repository `mongodb/docs-sample-apps`.

From 30de09ee723ab71522123e6d29055c0660933b02 Mon Sep 17 00:00:00 2001
From: Jordan Smith <jordan.smith@mongodb.com>
Date: Fri, 7 Nov 2025 13:16:53 -0500
Subject: [PATCH 100/110] Dachary feedback

---
 mflix/README-JAVA-SPRING.md |  4 ++-
 mflix/client/README.md      | 69 +++----------------------------------
 2 files changed, 8 insertions(+), 65 deletions(-)

diff --git a/mflix/README-JAVA-SPRING.md b/mflix/README-JAVA-SPRING.md
index 8136dad..d73a717 100644
--- a/mflix/README-JAVA-SPRING.md
+++ b/mflix/README-JAVA-SPRING.md
@@ -65,7 +65,9 @@ CORS_ORIGIN=http://localhost:3000
 # ENABLE_SEARCH_TESTS=true
 ```
 
-**Note:** Replace `username`, `password`, and `cluster` with your actual MongoDB Atlas credentials.
+**Note:** Replace `username`, `password`, and `cluster` with your
+actual MongoDB Atlas credentials. Replace `your_voyage_api_key` with
+your key.
 
 ### 2. Start the Backend Server
 
diff --git a/mflix/client/README.md b/mflix/client/README.md
index b66f055..8c46ce4 100644
--- a/mflix/client/README.md
+++ b/mflix/client/README.md
@@ -72,71 +72,12 @@ Open your browser and navigate to:
 
 - **Browse Movies:** View a paginated list of movies from the sample_mflix dataset with server-side rendering
 - **Movie Details:** Access comprehensive movie information including plot, cast, ratings, and metadata
-- **CRUD Operations:** Create, read, update, and delete movies through an intuitive interface
-- **Search & Filters:** Search movies with various filters and sorting options
-- **Vector Search:** Find movies with similar plot descriptions using AI-powered search
+- **CRUD Operations:** Create, read, update, and delete movies
+- **Search & Filters:** Search movies with various filters and sorting
+  options using MongoDB Search
+- **Vector Search:** Find movies with similar plot descriptions using
+  MongoDB Vector Search
 - **Data Aggregations:** View analytics and insights built with MongoDB aggregation pipelines
-- **Responsive Design:** Optimized experience across desktop and mobile devices
-- **Real-time Updates:** Dynamic content updates without page refreshes
-
-## Development
-
-### Frontend Development
-
-The Next.js frontend uses:
-- **React 19** with TypeScript for modern component development
-- **Next.js 15** with App Router for server-side rendering and routing
-- **Turbopack** for fast development builds and hot reloading
-- **CSS Modules** for component-scoped styling
-- **ESLint** for code quality and consistency
-
-#### Development Mode
-
-For active development with hot reloading and fast refresh:
-
-```bash
-npm run dev
-```
-
-This starts the development server on `http://localhost:3000` with Turbopack for fast rebuilds.
-
-#### Production Build
-
-To create an optimized production build:
-
-```bash
-npm run build  # Creates optimized production build
-npm start      # Starts production server
-```
-
-The production build:
-- Minifies and optimizes JavaScript and CSS
-- Optimizes images and assets  
-- Generates static pages where possible
-- Provides better performance for end users
-
-#### Code Quality
-
-To check code quality and formatting:
-
-```bash
-npm run lint
-```
-
-### API Integration
-
-The application connects to the backend API using:
-- **Server-Side Rendering**: Data fetched on the server for better SEO and performance
-- **TypeScript**: Type-safe API calls with interfaces matching backend data structures
-- **Error Handling**: Graceful fallbacks when the API is unavailable
-- **Loading States**: Professional loading indicators and skeleton screens
-
-### Key Technologies
-
-- **Next.js SSR**: Server-side rendering for better performance and SEO
-- **TypeScript**: Full type safety across the application
-- **CSS Modules**: Scoped styling to prevent style conflicts
-- **Responsive Design**: Mobile-first approach with flexible layouts
 
 ## Issues
 

From 790486964901e57db82dce64beb2525604119525 Mon Sep 17 00:00:00 2001
From: Angela <angelashu103@gmail.com>
Date: Fri, 7 Nov 2025 13:23:40 -0500
Subject: [PATCH 101/110] dachary feedback

---
 mflix/README-PYTHON-FASTAPI.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/mflix/README-PYTHON-FASTAPI.md b/mflix/README-PYTHON-FASTAPI.md
index 539e317..8225b9a 100644
--- a/mflix/README-PYTHON-FASTAPI.md
+++ b/mflix/README-PYTHON-FASTAPI.md
@@ -5,9 +5,9 @@ This is a full-stack movie browsing application built with Python FastAPI and Ne
 ## Project Structure
 
 ```
-├── README-PYTHON-FASTAPI.md
+├── README.md
 ├── client/                 # Next.js frontend (TypeScript)
-└── server/python-fastapi/  # Python FastAPI backend
+└── server/  # Python FastAPI backend
     ├── src/
     ├── tests/
     ├── .env.example
@@ -34,7 +34,7 @@ This is a full-stack movie browsing application built with Python FastAPI and Ne
 Navigate to the Python FastAPI server directory:
 
 ```bash
-cd server/python-fastapi
+cd server/
 ```
 
 Create a `.env` file from the example:
@@ -82,7 +82,7 @@ pip install -r requirements.txt
 
 ### 2. Start the Backend Server
 
-From the `server/python-fastapi` directory, run:
+From the `server/` directory, run:
 
 ```bash
 fastapi dev main.py --reload
@@ -143,7 +143,7 @@ The Python FastAPI backend uses:
 To run all tests:
 
 ```bash
-cd server/python-fastapi
+cd server/
 source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows
 pytest tests/ -v
 ```

From d3e3326832d9f892a1f0614b505fab2c63817ad5 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Fri, 7 Nov 2025 14:15:10 -0500
Subject: [PATCH 102/110] Remove unneeded files from client

---
 mflix/client/.env.example |  6 ---
 mflix/client/README.md    | 91 ---------------------------------------
 2 files changed, 97 deletions(-)
 delete mode 100644 mflix/client/.env.example
 delete mode 100644 mflix/client/README.md

diff --git a/mflix/client/.env.example b/mflix/client/.env.example
deleted file mode 100644
index 61ed0e9..0000000
--- a/mflix/client/.env.example
+++ /dev/null
@@ -1,6 +0,0 @@
-# Client Environment Variables
-# Copy this file to .env.local and update the values as needed
-
-# URL of the Express API server
-# Default: http://localhost:3001 (for local development)
-API_URL=http://localhost:3001
\ No newline at end of file
diff --git a/mflix/client/README.md b/mflix/client/README.md
deleted file mode 100644
index 8c46ce4..0000000
--- a/mflix/client/README.md
+++ /dev/null
@@ -1,91 +0,0 @@
-# Next.js MFlix Frontend Application
-
-This is a Next.js frontend application that demonstrates a modern movie browsing experience by connecting to a backend API. The application showcases Server Side Rendering (SSR), responsive design, and interactive features while displaying movie data from the MongoDB sample_mflix dataset.
-
-## Project Structure
-
-```
-client/
-├── README.md
-├── package.json
-├── next.config.ts
-├── tsconfig.json
-├── .env.example
-└── app/
-    ├── layout.tsx          # Root layout with navigation
-    ├── page.tsx            # Home page
-    ├── globals.css         # Global styles
-    ├── movies/             # Movies listing page
-    ├── movie/[id]/         # Individual movie details
-    ├── aggregations/       # Data aggregations page
-    ├── components/         # Reusable UI components
-    ├── lib/                # API utilities and constants
-    └── types/              # TypeScript type definitions
-```
-
-## Prerequisites
-
-- **Backend API Server**: The backend server must be running on `http://localhost:3001`
-- **MongoDB Database**: The backend must be connected to a MongoDB instance with the `sample_mflix` dataset loaded
-  - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/)
-- **Node.js 18** or higher
-- **npm** (included with Node.js)
-
-## Getting Started
-
-### 1. Configure the Environment
-
-Copy the environment example file:
-
-```bash
-cp .env.example .env.local
-```
-
-Edit `.env.local` and update the API URL if needed:
-
-```env
-API_URL=http://localhost:3001
-```
-
-### 2. Install Dependencies
-
-```bash
-npm install
-```
-
-### 3. Start the Development Server
-
-```bash
-npm run dev
-```
-
-The Next.js application will start on `http://localhost:3000`.
-
-### 4. Access the Application
-
-Open your browser and navigate to:
-- **Frontend:** http://localhost:3000
-- **Movies Page:** http://localhost:3000/movies
-- **Aggregations:** http://localhost:3000/aggregations
-
-## Features
-
-- **Browse Movies:** View a paginated list of movies from the sample_mflix dataset with server-side rendering
-- **Movie Details:** Access comprehensive movie information including plot, cast, ratings, and metadata
-- **CRUD Operations:** Create, read, update, and delete movies
-- **Search & Filters:** Search movies with various filters and sorting
-  options using MongoDB Search
-- **Vector Search:** Find movies with similar plot descriptions using
-  MongoDB Vector Search
-- **Data Aggregations:** View analytics and insights built with MongoDB aggregation pipelines
-
-## Issues
-
-If you have problems running the sample app, please check the following:
-
-- [ ] Verify that you have started the backend server on port 3001.
-- [ ] Verify that the backend is connected to MongoDB with the sample_mflix dataset.
-- [ ] Verify that you have set the correct API_URL in your `.env.local` file.
-- [ ] Verify that you have no firewalls blocking access to ports 3000 or 3001.
-
-If you have verified the above and still have issues, please [open an issue](https://github.com/mongodb/docs-sample-apps/issues/new/choose) on the source repository `mongodb/docs-sample-apps`.

From cb2cf038d83867d06859cfbd6672cbd2329cc507 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Fri, 7 Nov 2025 14:18:55 -0500
Subject: [PATCH 103/110] Run FastAPI server on port 3001

---
 mflix/README-PYTHON-FASTAPI.md           | 20 ++++++++++----------
 mflix/server/python-fastapi/.env.example |  2 +-
 mflix/server/python-fastapi/main.py      |  8 ++++++++
 3 files changed, 19 insertions(+), 11 deletions(-)

diff --git a/mflix/README-PYTHON-FASTAPI.md b/mflix/README-PYTHON-FASTAPI.md
index 8225b9a..f3be9de 100644
--- a/mflix/README-PYTHON-FASTAPI.md
+++ b/mflix/README-PYTHON-FASTAPI.md
@@ -22,7 +22,7 @@ This is a full-stack movie browsing application built with Python FastAPI and Ne
 - **Python 3.10** to **Python 3.13**
 - **Node.js 20** or higher
 - **MongoDB Atlas cluster or local deployment** with the `sample_mflix` dataset loaded
-  - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/) 
+  - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/)
 - **pip** for Python package management
 - **Voyage AI API key** (For MongoDB Vector Search)
   - [Get a Voyage AI API key](https://www.voyageai.com/)
@@ -56,7 +56,7 @@ VOYAGE_API_KEY=your_voyage_api_key
 
 # CORS Configuration
 # Comma-separated list of allowed origins for CORS
-CORS_ORIGINS=http://localhost:3000,http://localhost:8000
+CORS_ORIGINS=http://localhost:3000,http://localhost:3001
 ```
 
 **Note:** Replace `username`, `password`, and `cluster` with your actual MongoDB Atlas
@@ -69,7 +69,7 @@ python -m venv .venv
 ```
 
 Activate the virtual environment:
-    
+
 ```bash
 source .venv/bin/activate
 ```
@@ -85,12 +85,13 @@ pip install -r requirements.txt
 From the `server/` directory, run:
 
 ```bash
-fastapi dev main.py --reload
+uvicorn main:app --reload --port 3001
 ```
 
-The server will start on `http://localhost:8000`. You can verify it's running by visiting:
-- API root: http://localhost:8000/api/movies
-- API documentation (Swagger UI): http://localhost:8000/docs
+The server will start on `http://localhost:3001`. You can verify it's running by visiting:
+- API root: http://localhost:3001/api/movies
+- API documentation (Swagger UI): http://localhost:3001/docs
+- Interactive API documentation (ReDoc): http://localhost:3001/redoc
 
 ### 3. Configure and Start the Frontend
 
@@ -118,8 +119,8 @@ The Next.js application will start on `http://localhost:3000`.
 
 Open your browser and navigate to:
 - **Frontend:** http://localhost:3000
-- **Backend API:** http://localhost:8000
-- **API Documentation:** http://localhost:8000/docs
+- **Backend API:** http://localhost:3001
+- **API Documentation:** http://localhost:3001/docs
 
 ## Features
 
@@ -204,4 +205,3 @@ If you have problems running the sample app, please check the following:
 If you have verified the above and still have issues, please
 [open an issue](https://github.com/mongodb/docs-sample-apps/issues/new/choose)
 on the source repository `mongodb/docs-sample-apps`.
-
diff --git a/mflix/server/python-fastapi/.env.example b/mflix/server/python-fastapi/.env.example
index 59ac463..d42141d 100644
--- a/mflix/server/python-fastapi/.env.example
+++ b/mflix/server/python-fastapi/.env.example
@@ -9,4 +9,4 @@ VOYAGE_API_KEY=your_voyage_api_key
 
 # CORS Configuration
 # Comma-separated list of allowed origins for CORS
-CORS_ORIGINS="http://localhost:3000,http://localhost:8000"
+CORS_ORIGINS="http://localhost:3000,http://localhost:3001"
diff --git a/mflix/server/python-fastapi/main.py b/mflix/server/python-fastapi/main.py
index 61e6ca4..9d2290e 100644
--- a/mflix/server/python-fastapi/main.py
+++ b/mflix/server/python-fastapi/main.py
@@ -17,6 +17,14 @@ async def lifespan(app: FastAPI):
     # Startup: Create search indexes
     await ensure_search_index()
     await vector_search_index()
+
+    # Print server information
+    print(f"\n{'='*60}")
+    print(f"  Server started at http://127.0.0.1:3001")
+    print(f"  Documentation at http://127.0.0.1:3001/docs")
+    print(f"  Interactive API docs at http://127.0.0.1:3001/redoc")
+    print(f"{'='*60}\n")
+
     yield
     # Shutdown: Clean up resources if needed
     # Add any cleanup code here

From d002f2cd2173b44dd0ac9284a8f4803cbafc9735 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Fri, 7 Nov 2025 14:25:18 -0500
Subject: [PATCH 104/110] Remove unneeded comments

---
 .../src/database/mongo_client.py              |  1 -
 .../python-fastapi/src/models/models.py       | 11 -------
 .../python-fastapi/src/routers/movies.py      | 33 +------------------
 .../python-fastapi/src/utils/errorHandler.py  | 24 ++------------
 4 files changed, 3 insertions(+), 66 deletions(-)

diff --git a/mflix/server/python-fastapi/src/database/mongo_client.py b/mflix/server/python-fastapi/src/database/mongo_client.py
index da2d2b9..0ff350e 100644
--- a/mflix/server/python-fastapi/src/database/mongo_client.py
+++ b/mflix/server/python-fastapi/src/database/mongo_client.py
@@ -8,7 +8,6 @@
 client = AsyncMongoClient(os.getenv("MONGO_URI"))
 db = client[os.getenv("MONGO_DB")]
 
-# Set the API key but don't instantiate the client here
 voyage_api_key = os.getenv("VOYAGE_API_KEY")
 if voyage_api_key:
     voyageai.api_key = voyage_api_key
diff --git a/mflix/server/python-fastapi/src/models/models.py b/mflix/server/python-fastapi/src/models/models.py
index 8c2528a..f9494c7 100644
--- a/mflix/server/python-fastapi/src/models/models.py
+++ b/mflix/server/python-fastapi/src/models/models.py
@@ -38,17 +38,6 @@ class Movie(BaseModel):
         "populate_by_name" : True
     }
 
-
-'''
-So this an interesting conversion. Pydanic doesn't cleanly support constructing
-models that have MongoDB query operators as field names. This becomes an issue when
-we want to convert the validated model back to a dictionary to use as a MongoDB query filter.
-For example, if a user leaves the 'q' parameter blank, we don't want to include the '$text' operator
-in the filter at all but validation will send an empty value for it and that causes errors. So
-I am handling the validation in the query router itself, but leaving this here as an example of how
-it could be done, if I am wrong about Pydantic's capabilities.
-'''
-
 class TextFilter(BaseModel):
     search: str = Field(..., alias="$search")
 
diff --git a/mflix/server/python-fastapi/src/routers/movies.py b/mflix/server/python-fastapi/src/routers/movies.py
index 4bcbdbf..8ec10af 100644
--- a/mflix/server/python-fastapi/src/routers/movies.py
+++ b/mflix/server/python-fastapi/src/routers/movies.py
@@ -300,7 +300,7 @@ async def search_movies(
             - plot: Movie plot text
             - score: Vector search similarity score (0.0 to 1.0, higher = more similar)
 """
-# Specify your Voyage API key and embedding model
+# Specify your Voyage AI embedding model
 model = "voyage-3-large"
 outputDimension = 2048 #Set to 2048 to match the dimensions of the collection's embeddings
 
@@ -403,10 +403,6 @@ async def vector_search_movies(
             details=str(e)
         )
 
-#------------------------------------
-# Place get_movie_by_id endpoint here
-#------------------------------------
-
 """
     GET /api/movies/{id}
     Retrieve a single movie by its ID.
@@ -539,10 +535,6 @@ async def get_all_movies(
     # Return the results wrapped in a SuccessResponse    
     return create_success_response(movies, f"Found {len(movies)} movies.")
 
-#------------------------------------
-# Place create_movie endpoint here
-#------------------------------------
-
 """
     POST /api/movies/
     Create a new movie.
@@ -600,10 +592,6 @@ async def create_movie(movie: CreateMovieRequest):
     
     return create_success_response(created_movie, f"Movie '{movie_data['title']}' created successfully")
 
-#------------------------------------
-# Place create_movies_batch endpoint here
-#------------------------------------
-
 """
 POST /api/movies/batch
 
@@ -670,10 +658,6 @@ async def create_movies_batch(movies: List[CreateMovieRequest]) ->SuccessRespons
             details=str(e)
         )
 
-#------------------------------------
-# Place update_movie endpoint here
-#------------------------------------
-
 """    
     PATCH /api/movies/{id}
 
@@ -744,10 +728,6 @@ async def update_movie(
 
     return create_success_response(updatedMovie, f"Movie updated successfully. Modified {len(update_dict)} fields.")
 
-#------------------------------------
-# Place update_movies_by_batch endpoint here
-#------------------------------------
-
 """
     PATCH /api/movies
 
@@ -810,10 +790,6 @@ async def update_movies_batch(
         f"Update operation completed. Matched {result.matched_count} movie(s), modified {result.modified_count} movie(s)."
 )
 
-#------------------------------------
-# Place delete_movie endpoint here
-#------------------------------------
-
 """
     DELETE /api/movies/{id}
     Delete a single movie by its ID.
@@ -860,9 +836,6 @@ async def delete_movie_by_id(id: str):
         "Movie deleted successfully"
     )
 
-#------------------------------------
-# Place delete_movies_by_batch endpoint here
-#------------------------------------
 """
     DELETE /api/movies/
 
@@ -922,10 +895,6 @@ async def delete_movies_batch(request_body: dict = Body(...)) -> SuccessResponse
         f'Delete operation completed. Removed {result.deleted_count} movies.'
     )
 
-#------------------------------------
-# Place find_and_delete_movie endpoint here
-#------------------------------------
-
 """
     DELETE /api/movies/{id}/find-and-delete
     Finds and deletes a movie in a single atomic operation.
diff --git a/mflix/server/python-fastapi/src/utils/errorHandler.py b/mflix/server/python-fastapi/src/utils/errorHandler.py
index 4258e3a..5e235ec 100644
--- a/mflix/server/python-fastapi/src/utils/errorHandler.py
+++ b/mflix/server/python-fastapi/src/utils/errorHandler.py
@@ -2,18 +2,9 @@
 from fastapi.responses import JSONResponse
 from pymongo.errors import PyMongoError, DuplicateKeyError, WriteError
 from datetime import datetime, timezone
-from typing import Any, Dict, Optional
+from typing import Any, Optional
 from src.models.models import ErrorDetails, ErrorResponse, SuccessResponse, T
 
-
-'''
-Open to having a conversation about parity in the code. From my understanding exception handeling, validation errors and enforcement(Pydantic),
-and error response formatting are all handled natively by FastAPI. So I don't believe I need to create the ValidationError
-class, middleware, or exception handlers present in the TS code.
-
-'''
-
-
 '''
 Creates a standardized success response.
 
@@ -26,8 +17,6 @@
     SuccessResponse[T]: A standardized success response object.
     '''
 
-
-# TODO: Verify the timestamp format is acceptable.
 def create_success_response(data:T, message: Optional[str] = None) -> SuccessResponse[T]:
     return SuccessResponse(
         message=message or "Operation completed successfully.",
@@ -36,7 +25,6 @@ def create_success_response(data:T, message: Optional[str] = None) -> SuccessRes
         
     )
 
-
 '''
 Creates a standardized error response.
 
@@ -50,7 +38,6 @@ def create_success_response(data:T, message: Optional[str] = None) -> SuccessRes
 
 '''
 
-# TODO: Verify the timestamp format is acceptable.
 def create_error_response(message: str, code: Optional[str]=None, details: Optional[Any]=None) -> ErrorResponse:
     return ErrorResponse(
         message=message,
@@ -63,13 +50,6 @@ def create_error_response(message: str, code: Optional[str]=None, details: Optio
     )
 
 
-
-'''
-This is interesting, I am not sure if this is worth explaining that compared to Node, you are 
-not going to get exceptions thrown from MongoDB operations in the same way. You are not getting
-error codes back from operations, you are getting exceptions. 
-'''
-
 def parse_mongo_exception(exc: Exception) -> dict:
     if isinstance(exc, DuplicateKeyError):
         return{
@@ -126,4 +106,4 @@ async def generic_exception_handler(request: Request, exc: Exception):
                 code="INTERNAL_SERVER_ERROR",
                 details=getattr(exc, 'detail', None) or getattr(exc, 'args', None)
             ).model_dump()
-        )
\ No newline at end of file
+        )

From 92472c351bd01f406fc6dc1bba6696668837bb2d Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Fri, 7 Nov 2025 14:28:33 -0500
Subject: [PATCH 105/110] Clean up tests dir

---
 mflix/server/python-fastapi/tests/README.md            | 2 +-
 mflix/server/python-fastapi/tests/test_movie_routes.py | 1 -
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/mflix/server/python-fastapi/tests/README.md b/mflix/server/python-fastapi/tests/README.md
index 6a151d4..8df57cc 100644
--- a/mflix/server/python-fastapi/tests/README.md
+++ b/mflix/server/python-fastapi/tests/README.md
@@ -41,7 +41,7 @@ The test suite is organized into three categories:
 
 1. **For all tests:**
    ```bash
-   cd server/python-fastapi
+   cd server/
    source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows
    ```
 
diff --git a/mflix/server/python-fastapi/tests/test_movie_routes.py b/mflix/server/python-fastapi/tests/test_movie_routes.py
index 9a04b06..b98937f 100644
--- a/mflix/server/python-fastapi/tests/test_movie_routes.py
+++ b/mflix/server/python-fastapi/tests/test_movie_routes.py
@@ -9,7 +9,6 @@
 import pytest
 from unittest.mock import AsyncMock, MagicMock, patch
 from bson import ObjectId
-from bson.errors import InvalidId
 
 from src.models.models import CreateMovieRequest, UpdateMovieRequest
 

From 26ec76697be028b26b2107a7a354cef517e5908e Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Fri, 7 Nov 2025 14:37:24 -0500
Subject: [PATCH 106/110] Teeny tweak

---
 mflix/README-JAVASCRIPT-EXPRESS.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/mflix/README-JAVASCRIPT-EXPRESS.md b/mflix/README-JAVASCRIPT-EXPRESS.md
index 39bd092..130bf5f 100644
--- a/mflix/README-JAVASCRIPT-EXPRESS.md
+++ b/mflix/README-JAVASCRIPT-EXPRESS.md
@@ -18,7 +18,7 @@ This is a full-stack movie browsing application built with Express.js and Next.j
 
 - **Node.js 22** or higher
 - **MongoDB Atlas cluster or local deployment** with the `sample_mflix` dataset loaded
-  - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/) 
+  - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/)
 - **npm** (included with Node.js)
 - **Voyage AI API key** (For MongoDB Vector Search)
   - [Get a Voyage AI API key](https://www.voyageai.com/)
@@ -54,7 +54,6 @@ VOYAGE_API_KEY=your_voyage_api_key
 PORT=3001
 NODE_ENV=development
 
-
 # CORS Configuration
 # Allowed origin for cross-origin requests (frontend URL)
 # For multiple origins, separate with commas

From 91a134ad43aa5219e18df115feb8ea0e995f5353 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Fri, 7 Nov 2025 15:27:29 -0500
Subject: [PATCH 107/110] Remove unneeded comment

---
 .../python-fastapi/src/routers/movies.py      | 198 +++++++++---------
 1 file changed, 98 insertions(+), 100 deletions(-)

diff --git a/mflix/server/python-fastapi/src/routers/movies.py b/mflix/server/python-fastapi/src/routers/movies.py
index 8ec10af..4cc2154 100644
--- a/mflix/server/python-fastapi/src/routers/movies.py
+++ b/mflix/server/python-fastapi/src/routers/movies.py
@@ -78,9 +78,7 @@
 # MongoDB Search
 #
 # MongoDB Search based on searching the plot, fullplot, directors, writers, and cast fields.
-# This function was made with the assumption that the UI will have fields for plot,fullplot, 
-# directors, writers, and cast to search on. Or some sort of combined search field.
-# Also this fuzzy operator is being used to allow for some misspellings in the search terms
+# This fuzzy operator is being used to allow for some misspellings in the search terms
 # but that allows for very generous matching. This can be adjusted as needed.
 #----------------------------------------------------------------------------------------------------------
 """
@@ -98,7 +96,7 @@
         cast (str, optional): Text to search against the cast field.
         limit (int, optional): Number of results to return (default: 20)
         skip (int, optional): Number of results to skip for pagination (default: 0)
-        search_operator (str, optional): How to combine multiple search fields. 
+        search_operator (str, optional): How to combine multiple search fields.
             Must be one of "must", "should", "mustNot", or "filter". Default is "must".
 
     Returns:
@@ -120,7 +118,7 @@ async def search_movies(
     skip:int = Query(default=0, ge=0),
     search_operator: str = Query(default="must", alias="searchOperator")
 ) -> SuccessResponse[SearchMoviesResponse]:
-    
+
     search_phrases = []
 
     # Validate the search_operator parameter to ensure it's a valid compound operator
@@ -247,24 +245,24 @@ async def search_movies(
             message="An error occurred while performing the search.",
             code="DATABASE_ERROR",
             details=str(e)
-        )    
+        )
 
     # Extract total count and movies from facet results with proper bounds checking
     if not results or len(results) == 0:
         return create_success_response(
-            SearchMoviesResponse(movies=[], totalCount=0), 
+            SearchMoviesResponse(movies=[], totalCount=0),
             "No movies found matching the search criteria."
         )
-    
+
     facet_result = results[0]
-    
+
     # Safely extract total count
     total_count_array = facet_result.get("totalCount", [])
     total_count = total_count_array[0].get("count", 0) if total_count_array else 0
-    
+
     # Safely extract movies data
     movies_data = facet_result.get("results", [])
-    
+
     # Convert ObjectId to string for each movie in the results
     movies = []
     for movie in movies_data:
@@ -272,7 +270,7 @@ async def search_movies(
         movies.append(movie)
 
     return create_success_response(
-        SearchMoviesResponse(movies=movies, totalCount=total_count), 
+        SearchMoviesResponse(movies=movies, totalCount=total_count),
         f"Found {total_count} movies matching the search criteria."
       )
 
@@ -296,7 +294,7 @@ async def search_movies(
         SuccessResponse[List[VectorSearchResult]]: A response object containing movies with similarity scores.
         Each result includes:
             - _id: Movie ObjectId
-            - title: Movie title  
+            - title: Movie title
             - plot: Movie plot text
             - score: Vector search similarity score (0.0 to 1.0, higher = more similar)
 """
@@ -312,11 +310,11 @@ async def vector_search_movies(
 ):
     """
     Vector search endpoint for finding movies with similar plots.
-    
+
     Args:
         q: The search query string
         limit: Maximum number of results to return
-    
+
     Returns:
         SuccessResponse containing a list of movies with similarity scores
     """
@@ -326,18 +324,18 @@ async def vector_search_movies(
             code="SERVICE_UNAVAILABLE",
             details="VOYAGE_API_KEY not configured. Please add your API key to your .env file."
         )
-    
+
     try:
         # Initialize the client here to avoid import-time errors
         vo = voyageai.Client()
-        
+
         # The vector search index was already created at startup time
         # Generate embedding for the search query
         query_embedding = get_embedding(q, input_type="query", client=vo)
-        
+
         # Get the embedded movies collection
         embedded_movies_collection = get_collection("embedded_movies")
-        
+
         # Define vector search pipeline
         pipeline = [
             {
@@ -378,7 +376,7 @@ async def vector_search_movies(
         ]
 
         raw_results = await execute_aggregation_on_collection(embedded_movies_collection, pipeline)
-        
+
         # Convert ObjectId to string and create VectorSearchResult objects
         for result in raw_results:
             if "_id" in result and result["_id"]:
@@ -387,15 +385,15 @@ async def vector_search_movies(
                 except (InvalidId, TypeError):
                     # Handle invalid ObjectId conversion
                     result["_id"] = str(result["_id"]) if result["_id"] else None
-        
+
         # This code converts the raw results into VectorSearchResult objects
         results = [VectorSearchResult(**doc) for doc in raw_results]
-        
+
         return create_success_response(
-            results, 
+            results,
             f"Found {len(results)} similar movies for query: '{q}'"
         )
-        
+
     except Exception as e:
         return create_error_response(
             message="Vector search failed",
@@ -445,7 +443,7 @@ async def get_movie_by_id(id: str):
         )
 
     movie["_id"] = str(movie["_id"]) # Convert ObjectId to string
-    
+
     return create_success_response(movie, "Movie retrieved successfully")
 
 """
@@ -488,9 +486,9 @@ async def get_all_movies(
     movies_collection = get_collection("movies")
     filter_dict = {}
     if q:
-        filter_dict["$text"] = {"$search": q} 
+        filter_dict["$text"] = {"$search": q}
     if title:
-        filter_dict["title"] = {"$regex": title, "$options": "i"}       
+        filter_dict["title"] = {"$regex": title, "$options": "i"}
     if genre:
         filter_dict["genres"] = {"$regex": genre, "$options": "i"}
     if year:
@@ -502,7 +500,7 @@ async def get_all_movies(
         if max_rating is not None:
             rating_filter["$lte"] = max_rating
         filter_dict["imdb.rating"] = rating_filter
-        
+
     # Building the sort object based on user input
     sort_order = -1 if sort_order == "desc" else 1
 
@@ -511,13 +509,13 @@ async def get_all_movies(
     # Query the database with the constructed filter, sort, skip, and limit.
 
     try:
-        result = movies_collection.find(filter_dict).sort(sort).skip(skip).limit(limit)  
+        result = movies_collection.find(filter_dict).sort(sort).skip(skip).limit(limit)
     except Exception as e:
         return create_error_response(
             message="An error occurred while fetching movies.",
             code="DATABASE_ERROR",
             details=str(e)
-        )   
+        )
 
     movies = []
 
@@ -531,8 +529,8 @@ async def get_all_movies(
             except ValueError:
                 movie["year"] = None
 
-        movies.append(movie)            
-    # Return the results wrapped in a SuccessResponse    
+        movies.append(movie)
+    # Return the results wrapped in a SuccessResponse
     return create_success_response(movies, f"Found {len(movies)} movies.")
 
 """
@@ -545,14 +543,14 @@ async def get_all_movies(
         SuccessResponse[Movie]: A response object containing the created movie data.
 """
 
-@router.post("/", 
+@router.post("/",
             response_model=SuccessResponse[Movie],
             status_code=201,
             summary="Creates a new movie in the database.")
 async def create_movie(movie: CreateMovieRequest):
     # Pydantic automatically validates the structure
     movie_data = movie.model_dump(by_alias=True, exclude_none=True)
-    
+
     movies_collection = get_collection("movies")
     try:
         result = await movies_collection.insert_one(movie_data)
@@ -562,7 +560,7 @@ async def create_movie(movie: CreateMovieRequest):
             code="INTERNAL_SERVER_ERROR",
             details=str(e)
         )
-    
+
     # Verify that the document was created before querying it
     if not result.acknowledged:
         return create_error_response(
@@ -570,7 +568,7 @@ async def create_movie(movie: CreateMovieRequest):
             code="INTERNAL_SERVER_ERROR",
             details="The database did not acknowledge the insert operation"
         )
-    
+
     try:
         # Retrieve the created document to return complete data
         created_movie = await movies_collection.find_one({"_id": result.inserted_id})
@@ -580,7 +578,7 @@ async def create_movie(movie: CreateMovieRequest):
             code="INTERNAL_SERVER_ERROR",
             details=str(e)
         )
-    
+
     if created_movie is None:
         return create_error_response(
             message="Movie creation verification failed",
@@ -589,13 +587,13 @@ async def create_movie(movie: CreateMovieRequest):
         )
 
     created_movie["_id"] = str(created_movie["_id"]) # Convert ObjectId to string
-    
+
     return create_success_response(created_movie, f"Movie '{movie_data['title']}' created successfully")
 
 """
 POST /api/movies/batch
 
-Create multiple movies in a single request. 
+Create multiple movies in a single request.
 
 Request Body:
         movies (List[CreateMovieRequest]): A list of movie objects to insert. Each object should include:
@@ -634,7 +632,7 @@ async def create_movies_batch(movies: List[CreateMovieRequest]) ->SuccessRespons
             code="INVALID_INPUT",
             details=None
         )
-    
+
     movies_dicts = []
 
     for movie in movies:
@@ -658,7 +656,7 @@ async def create_movies_batch(movies: List[CreateMovieRequest]) ->SuccessRespons
             details=str(e)
         )
 
-"""    
+"""
     PATCH /api/movies/{id}
 
     Update a single movie by its ID.
@@ -683,7 +681,7 @@ async def update_movie(
 ) -> SuccessResponse[Movie]:
 
     movies_collection = get_collection("movies")
-    
+
     # Validate the ObjectId
     try:
         movie_id = ObjectId(movie_id)
@@ -692,8 +690,8 @@ async def update_movie(
             message="Invalid movie_id format.",
             code="INVALID_OBJECT_ID",
             details=str(movie_id)
-        )    
-    
+        )
+
     update_dict = movie_data.model_dump(exclude_unset=True, exclude_none=True)
 
     # Validate that the dict is not empty
@@ -714,7 +712,7 @@ async def update_movie(
             message="An error occurred while updating the movie.",
             code="DATABASE_ERROR",
             details=str(e)
-        )    
+        )
 
     if result.matched_count == 0:
         return create_error_response(
@@ -722,7 +720,7 @@ async def update_movie(
             code="MOVIE_NOT_FOUND",
             details=str(movie_id)
         )
-    
+
     updatedMovie = await movies_collection.find_one({"_id": movie_id})
     updatedMovie["_id"] = str(updatedMovie["_id"])
 
@@ -782,7 +780,7 @@ async def update_movies_batch(
             code="DATABASE_ERROR",
             details=str(e)
         )
-    
+
     return create_success_response({
         "matchedCount": result.matched_count,
         "modifiedCount": result.modified_count
@@ -827,12 +825,12 @@ async def delete_movie_by_id(id: str):
     if result.deleted_count == 0:
         return create_error_response(
             message="Movie not found",
-            code="INTERNAL_SERVER_ERROR", 
+            code="INTERNAL_SERVER_ERROR",
             details=f"No movie found with ID: {id}"
         )
-    
+
     return create_success_response(
-        {"deletedCount": result.deleted_count}, 
+        {"deletedCount": result.deleted_count},
         "Movie deleted successfully"
     )
 
@@ -857,7 +855,7 @@ async def delete_movie_by_id(id: str):
 async def delete_movies_batch(request_body: dict = Body(...)) -> SuccessResponse[dict]:
 
     movies_collection = get_collection("movies")
-    
+
     # Extract filter from the request body
     filter_data = request_body.get("filter", {})
 
@@ -935,11 +933,11 @@ async def find_and_delete_movie(id: str):
     if deleted_movie is None:
         return create_error_response(
             message="Movie not found",
-            code="INTERNAL_SERVER_ERROR", 
+            code="INTERNAL_SERVER_ERROR",
             details=f"No movie found with ID: {id}"
         )
     deleted_movie["_id"] = str(deleted_movie["_id"]) # Convert ObjectId to string
-    
+
     return create_success_response(deleted_movie, "Movie found and deleted successfully")
 
 """
@@ -961,7 +959,7 @@ async def aggregate_movies_recent_commented(
     limit: int = Query(default=10, ge=1, le=50),
     movie_id: str = Query(default=None)
 ):
-    
+
     # Add a multi-stage aggregation that:
     # 1. Filters movies by valid year range
     # 2. Joins with comments collection (like SQL JOIN)
@@ -969,7 +967,7 @@ async def aggregate_movies_recent_commented(
     # 4. Sorts comments by date and extracts most recent ones
     # 5. Sorts movies by their most recent comment date
     # 6. Shapes the final output with transformed comment structure
-    
+
     pipeline: list[dict[str, Any]] =[
         # STAGE 1: $match - Initial Filter
         # Filter movies to only those with valid year data
@@ -991,7 +989,7 @@ async def aggregate_movies_recent_commented(
                 code="INTERNAL_SERVER_ERROR",
                 details="The provided movie_id is not a valid ObjectId"
             )
-    
+
     # Add remaining pipeline stages
     pipeline.extend([
         # STAGE 2: $lookup - Join with the 'comments' Collection
@@ -1086,12 +1084,12 @@ async def aggregate_movies_recent_commented(
     for result in results:
         if "_id" in result:
             result["_id"] = str(result["_id"])
-    
+
     # Calculate total comments from all movies
     total_comments = sum(result.get("totalComments", 0) for result in results)
-    
+
     return create_success_response(
-        results, 
+        results,
         f"Found {total_comments} comments from movie{'s' if len(results) != 1 else ''}"
     )
 
@@ -1116,7 +1114,7 @@ async def aggregate_movies_by_year():
     # 2. Groups movies by release year and calculates statistics per year
     # 3. Shapes the final output with clean field names and rounded averages
     # 4. Sorts results by year (newest first) for chronological presentation
-    
+
     pipeline = [
         # STAGE 1: $match - Data Quality Filter
         # Clean data: ensure year is an integer and within reasonable range
@@ -1126,14 +1124,14 @@ async def aggregate_movies_by_year():
                 "year": {"$type": "number", "$gte": 1800, "$lte": 2030}
             }
         },
-        
+
         # STAGE 2: $group - Aggregate Movies by Year
         # Group all movies by their release year and calculate various statistics
         {
             "$group": {
                 "_id": "$year",  # Group by year field
                 "movieCount": {"$sum": 1},  # Count total movies per year
-                
+
                 # Calculate average rating (only for valid numeric ratings)
                 "averageRating": {
                     "$avg": {
@@ -1148,7 +1146,7 @@ async def aggregate_movies_by_year():
                         ]
                     }
                 },
-                
+
                 # Find highest rating for the year (same validation as average rating)
                 "highestRating": {
                     "$max": {
@@ -1163,7 +1161,7 @@ async def aggregate_movies_by_year():
                         ]
                     }
                 },
-                
+
                 # Find lowest rating for the year (same validation as average and highest rating)
                 "lowestRating": {
                     "$min": {
@@ -1178,12 +1176,12 @@ async def aggregate_movies_by_year():
                         ]
                     }
                 },
-                
+
                 # Sum total votes across all movies in the year
                 "totalVotes": {"$sum": "$imdb.votes"}
             }
         },
-        
+
         # STAGE 3: $project - Shape Final Output
         # Transform the grouped data into a clean, readable format
         {
@@ -1197,7 +1195,7 @@ async def aggregate_movies_by_year():
                 "_id": 0  # Exclude the _id field from output
             }
         },
-        
+
         # STAGE 4: $sort - Sort by Year (Newest First)
         # Sort results in descending order to show most recent years first
         {"$sort": {"year": -1}}  # -1 = descending order
@@ -1212,9 +1210,9 @@ async def aggregate_movies_by_year():
             code="INTERNAL_SERVER_ERROR",
             details=str(e)
         )
-    
+
     return create_success_response(
-        results, 
+        results,
         f"Aggregated statistics for {len(results)} years"
     )
 
@@ -1237,7 +1235,7 @@ async def aggregate_directors_most_movies(
 ):
     # Define aggregation pipeline to find directors with the most movies
     # This pipeline demonstrates array unwinding, filtering, and ranking
-    
+
     # Add a multi-stage aggregation that:
     # 1. Filters movies with valid directors and year data (data quality filter)
     # 2. Unwinds directors array to create separate documents per director
@@ -1256,14 +1254,14 @@ async def aggregate_directors_most_movies(
                 "year": {"$type": "number", "$gte": 1800, "$lte": 2030}  # Valid year range
             }
         },
-        
+
         # STAGE 2: $unwind - Flatten Directors Array
         # Convert each movie's directors array into separate documents
         # Example: Movie with ["Director A", "Director B"] becomes 2 documents
         {
             "$unwind": "$directors"
         },
-        
+
         # STAGE 3: $match - Clean Director Names
         # Filter out any null or empty director names after unwinding
         {
@@ -1271,7 +1269,7 @@ async def aggregate_directors_most_movies(
                 "directors": {"$ne": None, "$ne": ""}
             }
         },
-        
+
         # STAGE 4: $group - Aggregate by Director
         # Group all movies by director name and calculate statistics
         {
@@ -1281,15 +1279,15 @@ async def aggregate_directors_most_movies(
                 "averageRating": {"$avg": "$imdb.rating"}  # Average rating of director's movies
             }
         },
-        
+
         # STAGE 5: $sort - Rank Directors by Movie Count
         # Sort directors by number of movies (highest first)
         {"$sort": {"movieCount": -1}},  # -1 = descending (most movies first)
-        
+
         # STAGE 6: $limit - Restrict Results
         # Limit to top N directors based on user input
         {"$limit": limit},
-        
+
         # STAGE 7: $project - Shape Final Output
         # Transform the grouped data into a clean, readable format
         {
@@ -1311,9 +1309,9 @@ async def aggregate_directors_most_movies(
             code="INTERNAL_SERVER_ERROR",
             details=str(e)
         )
-    
+
     return create_success_response(
-        results, 
+        results,
         f"Found {len(results)} directors with most movies"
     )
 
@@ -1321,36 +1319,36 @@ async def aggregate_directors_most_movies(
 #Helper Functions
 #------------------------------------
 
-"""  
-    Helper function to execute aggregation pipeline and return results.  
+"""
+    Helper function to execute aggregation pipeline and return results.
 
-    Args:  
-        pipeline: MongoDB aggregation pipeline stages  
+    Args:
+        pipeline: MongoDB aggregation pipeline stages
 
-    Returns:  
-        List of documents from aggregation result  
-"""  
+    Returns:
+        List of documents from aggregation result
+"""
 
 async def execute_aggregation(pipeline: list) -> list:
     """Helper function to execute aggregation pipeline and return results"""
-    
+
     movies_collection = get_collection("movies")
     # For the async Pymongo driver, we need to await the aggregate call
     cursor = await movies_collection.aggregate(pipeline)
     results = await cursor.to_list(length=None)  # Convert cursor to list to collect all data at once rather than processing data per document
-    
+
     return results
 
-"""  
-    Helper function to execute aggregation pipeline and return results from a specified collection. 
+"""
+    Helper function to execute aggregation pipeline and return results from a specified collection.
 
-    Args:  
+    Args:
         collection: The MongoDB collection to run the aggregation on
-        pipeline: MongoDB aggregation pipeline stages  
+        pipeline: MongoDB aggregation pipeline stages
 
-    Returns:  
-        List of documents from aggregation result  
-"""  
+    Returns:
+        List of documents from aggregation result
+"""
 
 async def execute_aggregation_on_collection(collection, pipeline: list) -> list:
     """Helper function to execute aggregation pipeline on a specified collection and return results"""
@@ -1360,15 +1358,15 @@ async def execute_aggregation_on_collection(collection, pipeline: list) -> list:
 
     return results
 
-"""  
+"""
     Helper function to generate vector embeddings from an input.
 
-    Args:  
+    Args:
         data: Input data to generate embeddings for
         input_type: Type of input data
         client: Voyage AI client instance
 
-    Returns:  
+    Returns:
         Vector embeddings for the given input
 """
 
@@ -1376,17 +1374,17 @@ def get_embedding(data, input_type = "document", client=None):
     """
     Helper function to generate vector embeddings from an input.
 
-    Args:  
+    Args:
         data: Input data to generate embeddings for
         input_type: Type of input data
         client: Voyage AI client instance
 
-    Returns:  
+    Returns:
         Vector embeddings for the given input
     """
     if client is None:
         client = voyageai.Client()
-    
+
     embeddings = client.embed(
         data, model = model, output_dimension = outputDimension, input_type = input_type
     ).embeddings

From f694fb0cd3334dc4f1fabb17e4a12d282118b198 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Fri, 7 Nov 2025 15:33:47 -0500
Subject: [PATCH 108/110] Resolve Java mismatches with frontend, remove some
 unused files

---
 .../controller/MovieControllerImpl.java       | 12 ++---
 .../exception/DatabaseOperationException.java |  4 --
 .../exception/ResourceNotFoundException.java  |  7 +--
 .../exception/ValidationException.java        |  4 --
 .../mongodb/samplemflix/model/Comment.java    |  9 ----
 .../model/dto/MovieWithCommentsResult.java    | 25 ++--------
 .../samplemflix/service/MovieServiceImpl.java | 21 +++-----
 .../samplemflix/util/ValidationUtils.java     | 28 -----------
 .../controller/MovieControllerTest.java       | 37 ++++++--------
 .../integration/MovieIntegrationTest.java     | 49 -------------------
 .../samplemflix/service/MovieServiceTest.java |  4 +-
 11 files changed, 35 insertions(+), 165 deletions(-)
 delete mode 100644 mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
 delete mode 100644 mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java

diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
index 5a9c638..5ca9ceb 100644
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
+++ b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/controller/MovieControllerImpl.java
@@ -40,9 +40,9 @@
  * - DELETE /api/movies/{id} - Delete a movie
  * - DELETE /api/movies - Delete multiple movies
  * - DELETE /api/movies/{id}/find-and-delete - Find and delete a movie
- * - GET /api/movies/aggregations/comments - Aggregate movies with most comments
- * - GET /api/movies/aggregations/years - Aggregate movies by year with statistics
- * - GET /api/movies/aggregations/directors - Aggregate directors with most movies
+ * - GET /api/movies/aggregations/reportingByComments - Aggregate movies with most comments
+ * - GET /api/movies/aggregations/reportingByYear - Aggregate movies by year with statistics
+ * - GET /api/movies/aggregations/reportingByDirectors - Aggregate directors with most movies
  * - GET /api/movies/search - Text search using MongoDB Search Index across multiple fields (plot, fullplot, directors, writers, cast)
  * - GET /api/movies/vector-search - Vector search using Voyage AI embeddings to find movies with similar plots
  * - GET /api/movies/find-similar-movies - Vector search to find similar movies based on plot embeddings
@@ -296,7 +296,7 @@ public ResponseEntity<SuccessResponse<DeleteResponse>> deleteMoviesBatch(
         description = "Aggregates movies with their most recent comments using MongoDB $lookup (join) operation. " +
                      "Demonstrates how to combine data from the movies and comments collections."
     )
-    @GetMapping("/aggregations/comments")
+    @GetMapping("/aggregations/reportingByComments")
     public ResponseEntity<SuccessResponse<List<MovieWithCommentsResult>>> getMoviesWithMostRecentComments(
             @Parameter(description = "Maximum number of movies to return (default: 10, max: 50)")
             @RequestParam(defaultValue = "10") Integer limit,
@@ -331,7 +331,7 @@ public ResponseEntity<SuccessResponse<List<MovieWithCommentsResult>>> getMoviesW
         description = "Aggregates movies by year with statistics including movie count and average rating. " +
                      "Demonstrates MongoDB $group operation for statistical aggregation."
     )
-    @GetMapping("/aggregations/years")
+    @GetMapping("/aggregations/reportingByYear")
     public ResponseEntity<SuccessResponse<List<MoviesByYearResult>>> getMoviesByYearWithStats() {
 
         List<MoviesByYearResult> results = movieService.getMoviesByYearWithStats();
@@ -352,7 +352,7 @@ public ResponseEntity<SuccessResponse<List<MoviesByYearResult>>> getMoviesByYear
         description = "Aggregates directors with the most movies and their statistics. " +
                      "Demonstrates MongoDB $unwind operation for array flattening and aggregation."
     )
-    @GetMapping("/aggregations/directors")
+    @GetMapping("/aggregations/reportingByDirectors")
     public ResponseEntity<SuccessResponse<List<DirectorStatisticsResult>>> getDirectorsWithMostMovies(
             @Parameter(description = "Maximum number of directors to return (default: 20, max: 100)")
             @RequestParam(defaultValue = "20") Integer limit) {
diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/DatabaseOperationException.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/DatabaseOperationException.java
index 44cfd52..315939f 100644
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/DatabaseOperationException.java
+++ b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/DatabaseOperationException.java
@@ -12,9 +12,5 @@ public class DatabaseOperationException extends RuntimeException {
     public DatabaseOperationException(String message) {
         super(message);
     }
-    
-    public DatabaseOperationException(String message, Throwable cause) {
-        super(message, cause);
-    }
 }
 
diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ResourceNotFoundException.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ResourceNotFoundException.java
index ac2c81c..2322903 100644
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ResourceNotFoundException.java
+++ b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ResourceNotFoundException.java
@@ -4,17 +4,12 @@
  * Exception thrown when a requested resource is not found.
  * 
  * This exception results in a 404 Not Found response.
- * 
- * TODO: Phase 7 - Implement custom exception
+ *
  */
 public class ResourceNotFoundException extends RuntimeException {
     
     public ResourceNotFoundException(String message) {
         super(message);
     }
-    
-    public ResourceNotFoundException(String message, Throwable cause) {
-        super(message, cause);
-    }
 }
 
diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java
index 84175df..30b5527 100644
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java
+++ b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java
@@ -12,9 +12,5 @@ public class ValidationException extends RuntimeException {
     public ValidationException(String message) {
         super(message);
     }
-    
-    public ValidationException(String message, Throwable cause) {
-        super(message, cause);
-    }
 }
 
diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
index 15d9c94..d0e8633 100644
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
+++ b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
@@ -15,15 +15,6 @@
  *
  * <p>This class maps to the comments collection in the sample_mflix database.
  * Comments are user reviews/comments associated with movies.
- *
- * <p>TODO: Implement Comment functionality:
- * - Create CommentRepository extending MongoRepository
- * - Create CommentService and CommentServiceImpl
- * - Create CommentController with REST endpoints
- * - Add validation annotations (@NotNull, @Email, etc.)
- * - Add unit tests for Comment service and controller
- * - Add integration tests
- * - Implement query methods (findByMovieId, findByEmail, etc.)
  */
 @Data
 @Builder
diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieWithCommentsResult.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieWithCommentsResult.java
index ede0b30..62e70c4 100644
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieWithCommentsResult.java
+++ b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/dto/MovieWithCommentsResult.java
@@ -24,7 +24,7 @@ public class MovieWithCommentsResult {
     /**
      * Movie ID as string.
      */
-    private String id;
+    private String _id;
 
     /**
      * Movie title.
@@ -52,9 +52,9 @@ public class MovieWithCommentsResult {
     private List<String> genres;
 
     /**
-     * IMDB rating information.
+     * IMDB rating (0.0 to 10.0).
      */
-    private ImdbInfo imdb;
+    private Double imdbRating;
 
     /**
      * Most recent comments for this movie.
@@ -71,25 +71,6 @@ public class MovieWithCommentsResult {
      */
     private Date mostRecentCommentDate;
 
-    /**
-     * Nested class for IMDB information.
-     */
-    @Data
-    @Builder
-    @NoArgsConstructor
-    @AllArgsConstructor
-    public static class ImdbInfo {
-        /**
-         * IMDB rating (0.0 to 10.0).
-         */
-        private Double rating;
-
-        /**
-         * Number of votes.
-         */
-        private Integer votes;
-    }
-
     /**
      * Nested class for comment information.
      */
diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index eb592a0..ed00296 100644
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -412,13 +412,13 @@ public List<MovieWithCommentsResult> getMoviesWithMostRecentComments(Integer lim
                 // STAGE 7: Project final output with recent comments slice
                 // Shape the response and include only the 5 most recent comments per movie
                 Aggregation.project()
-                        .and(ConditionalOperators.ifNull("_id").then("")).as("id")
+                        .and(ConditionalOperators.ifNull("_id").then("")).as("_id")
                         .and("title").as("title")
                         .and("year").as("year")
                         .and("plot").as("plot")
                         .and("poster").as("poster")
                         .and("genres").as("genres")
-                        .and("imdb").as("imdb")
+                        .and("imdb.rating").as("imdbRating")
                         .and(ArrayOperators.Slice.sliceArrayOf("comments").itemCount(5)).as("recentComments")
                         .and("totalComments").as("totalComments")
                         .and("mostRecentCommentDate").as("mostRecentCommentDate")
@@ -540,15 +540,8 @@ public List<DirectorStatisticsResult> getDirectorsWithMostMovies(Integer limit)
      * Helper method to map Document to MovieWithCommentsResult.
      */
     private MovieWithCommentsResult mapToMovieWithCommentsResult(Document doc) {
-        // Extract IMDB info
-        MovieWithCommentsResult.ImdbInfo imdbInfo = null;
-        Document imdbDoc = doc.get("imdb", Document.class);
-        if (imdbDoc != null) {
-            imdbInfo = MovieWithCommentsResult.ImdbInfo.builder()
-                    .rating(imdbDoc.getDouble("rating"))
-                    .votes(imdbDoc.getInteger("votes"))
-                    .build();
-        }
+        // Extract IMDB rating (just the number)
+        Double imdbRating = doc.getDouble("imdbRating");
 
         // Extract recent comments
         List<MovieWithCommentsResult.CommentInfo> recentComments = null;
@@ -569,7 +562,7 @@ private MovieWithCommentsResult mapToMovieWithCommentsResult(Document doc) {
 
         // Extract movie ID - handle both String and ObjectId types
         String movieId = null;
-        Object idObj = doc.get("id");
+        Object idObj = doc.get("_id");
         if (idObj instanceof String) {
             movieId = (String) idObj;
         } else if (idObj instanceof ObjectId) {
@@ -577,13 +570,13 @@ private MovieWithCommentsResult mapToMovieWithCommentsResult(Document doc) {
         }
 
         return MovieWithCommentsResult.builder()
-                .id(movieId)
+                ._id(movieId)
                 .title(doc.getString("title"))
                 .year(doc.getInteger("year"))
                 .plot(doc.getString("plot"))
                 .poster(doc.getString("poster"))
                 .genres(doc.getList("genres", String.class))
-                .imdb(imdbInfo)
+                .imdbRating(imdbRating)
                 .recentComments(recentComments)
                 .totalComments(doc.getInteger("totalComments"))
                 .mostRecentCommentDate(doc.getDate("mostRecentCommentDate"))
diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
deleted file mode 100644
index a496b14..0000000
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/util/ValidationUtils.java
+++ /dev/null
@@ -1,28 +0,0 @@
-package com.mongodb.samplemflix.util;
-
-/**
- * Utility class for validation operations.
- *
- * This class provides helper methods for validating request data.
- *
- * TODO: Implement validation utility methods:
- * - ObjectId format validation
- * - Date range validation
- * - String sanitization
- * - URL validation
- */
-public class ValidationUtils {
-
-    private ValidationUtils() {
-        // Private constructor to prevent instantiation
-    }
-
-    // TODO: Add ObjectId validation (currently duplicated in service layer)
-    // public static boolean isValidObjectId(String id)
-
-    // TODO: Add string sanitization for XSS prevention
-    // public static String sanitize(String input)
-
-    // TODO: Add URL validation for poster and trailer fields
-    // public static boolean isValidUrl(String url)
-}
diff --git a/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java b/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
index acc1542..0f63dfd 100644
--- a/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
+++ b/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/controller/MovieControllerTest.java
@@ -335,7 +335,7 @@ void testFindAndDeleteMovie_NotFound() throws Exception {
     // ==================== AGGREGATION ENDPOINT TESTS ====================
 
     @Test
-    @DisplayName("GET /api/movies/aggregations/comments - Should return movies with most comments")
+    @DisplayName("GET /api/movies/aggregations/reportingByComments - Should return movies with most comments")
     void testGetMoviesWithMostComments_Success() throws Exception {
         // Arrange
         MovieWithCommentsResult.CommentInfo comment = MovieWithCommentsResult.CommentInfo.builder()
@@ -346,19 +346,14 @@ void testGetMoviesWithMostComments_Success() throws Exception {
                 .date(new Date())
                 .build();
 
-        MovieWithCommentsResult.ImdbInfo imdb = MovieWithCommentsResult.ImdbInfo.builder()
-                .rating(8.5)
-                .votes(1000)
-                .build();
-
         MovieWithCommentsResult result = MovieWithCommentsResult.builder()
-                .id(testId.toHexString())
+                ._id(testId.toHexString())
                 .title("Test Movie")
                 .year(2024)
                 .plot("Test plot")
                 .poster("http://example.com/poster.jpg")
                 .genres(Arrays.asList("Action", "Drama"))
-                .imdb(imdb)
+                .imdbRating(8.5)
                 .recentComments(Arrays.asList(comment))
                 .totalComments(5)
                 .mostRecentCommentDate(new Date())
@@ -367,7 +362,7 @@ void testGetMoviesWithMostComments_Success() throws Exception {
         when(movieService.getMoviesWithMostRecentComments(anyInt(), isNull())).thenReturn(Arrays.asList(result));
 
         // Act & Assert
-        mockMvc.perform(get("/api/movies/aggregations/comments"))
+        mockMvc.perform(get("/api/movies/aggregations/reportingByComments"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.success").value(true))
                 .andExpect(jsonPath("$.data").isArray())
@@ -380,13 +375,13 @@ void testGetMoviesWithMostComments_Success() throws Exception {
     }
 
     @Test
-    @DisplayName("GET /api/movies/aggregations/comments - Should accept limit parameter")
+    @DisplayName("GET /api/movies/aggregations/reportingByComments - Should accept limit parameter")
     void testGetMoviesWithMostComments_WithLimit() throws Exception {
         // Arrange
         when(movieService.getMoviesWithMostRecentComments(eq(5), isNull())).thenReturn(Arrays.asList());
 
         // Act & Assert
-        mockMvc.perform(get("/api/movies/aggregations/comments")
+        mockMvc.perform(get("/api/movies/aggregations/reportingByComments")
                         .param("limit", "5"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.success").value(true))
@@ -394,14 +389,14 @@ void testGetMoviesWithMostComments_WithLimit() throws Exception {
     }
 
     @Test
-    @DisplayName("GET /api/movies/aggregations/comments - Should accept movieId parameter")
+    @DisplayName("GET /api/movies/aggregations/reportingByComments - Should accept movieId parameter")
     void testGetMoviesWithMostComments_WithMovieId() throws Exception {
         // Arrange
         String movieId = testId.toHexString();
         when(movieService.getMoviesWithMostRecentComments(anyInt(), eq(movieId))).thenReturn(Arrays.asList());
 
         // Act & Assert
-        mockMvc.perform(get("/api/movies/aggregations/comments")
+        mockMvc.perform(get("/api/movies/aggregations/reportingByComments")
                         .param("movieId", movieId))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.success").value(true))
@@ -409,7 +404,7 @@ void testGetMoviesWithMostComments_WithMovieId() throws Exception {
     }
 
     @Test
-    @DisplayName("GET /api/movies/aggregations/comments - Should return 400 for invalid movieId")
+    @DisplayName("GET /api/movies/aggregations/reportingByComments - Should return 400 for invalid movieId")
     void testGetMoviesWithMostComments_InvalidMovieId() throws Exception {
         // Arrange
         String invalidMovieId = "invalid-id";
@@ -417,7 +412,7 @@ void testGetMoviesWithMostComments_InvalidMovieId() throws Exception {
                 .thenThrow(new ValidationException("Invalid movie ID format"));
 
         // Act & Assert
-        mockMvc.perform(get("/api/movies/aggregations/comments")
+        mockMvc.perform(get("/api/movies/aggregations/reportingByComments")
                         .param("movieId", invalidMovieId))
                 .andExpect(status().isBadRequest())
                 .andExpect(jsonPath("$.success").value(false))
@@ -425,7 +420,7 @@ void testGetMoviesWithMostComments_InvalidMovieId() throws Exception {
     }
 
     @Test
-    @DisplayName("GET /api/movies/aggregations/years - Should return movies by year with statistics")
+    @DisplayName("GET /api/movies/aggregations/reportingByYear - Should return movies by year with statistics")
     void testGetMoviesByYearWithStats_Success() throws Exception {
         // Arrange
         MoviesByYearResult result1 = MoviesByYearResult.builder()
@@ -449,7 +444,7 @@ void testGetMoviesByYearWithStats_Success() throws Exception {
         when(movieService.getMoviesByYearWithStats()).thenReturn(Arrays.asList(result1, result2));
 
         // Act & Assert
-        mockMvc.perform(get("/api/movies/aggregations/years"))
+        mockMvc.perform(get("/api/movies/aggregations/reportingByYear"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.success").value(true))
                 .andExpect(jsonPath("$.data").isArray())
@@ -462,7 +457,7 @@ void testGetMoviesByYearWithStats_Success() throws Exception {
     }
 
     @Test
-    @DisplayName("GET /api/movies/aggregations/directors - Should return directors with most movies")
+    @DisplayName("GET /api/movies/aggregations/reportingByDirectors - Should return directors with most movies")
     void testGetDirectorsWithMostMovies_Success() throws Exception {
         // Arrange
         DirectorStatisticsResult result1 = DirectorStatisticsResult.builder()
@@ -480,7 +475,7 @@ void testGetDirectorsWithMostMovies_Success() throws Exception {
         when(movieService.getDirectorsWithMostMovies(anyInt())).thenReturn(Arrays.asList(result1, result2));
 
         // Act & Assert
-        mockMvc.perform(get("/api/movies/aggregations/directors"))
+        mockMvc.perform(get("/api/movies/aggregations/reportingByDirectors"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.success").value(true))
                 .andExpect(jsonPath("$.data").isArray())
@@ -493,13 +488,13 @@ void testGetDirectorsWithMostMovies_Success() throws Exception {
     }
 
     @Test
-    @DisplayName("GET /api/movies/aggregations/directors - Should accept limit parameter")
+    @DisplayName("GET /api/movies/aggregations/reportingByDirectors - Should accept limit parameter")
     void testGetDirectorsWithMostMovies_WithLimit() throws Exception {
         // Arrange
         when(movieService.getDirectorsWithMostMovies(eq(10))).thenReturn(Arrays.asList());
 
         // Act & Assert
-        mockMvc.perform(get("/api/movies/aggregations/directors")
+        mockMvc.perform(get("/api/movies/aggregations/reportingByDirectors")
                         .param("limit", "10"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.success").value(true))
diff --git a/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java b/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
deleted file mode 100644
index 91f86fe..0000000
--- a/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/integration/MovieIntegrationTest.java
+++ /dev/null
@@ -1,49 +0,0 @@
-package com.mongodb.samplemflix.integration;
-
-/**
- * Integration tests for the movie API.
- *
- * These tests verify the full request/response cycle including database operations.
- *
- * TODO: Set up Testcontainers for MongoDB
- * - Add testcontainers dependency to pom.xml
- * - Configure MongoDB test container
- * - Set up test data initialization
- *
- * TODO: Implement integration tests for all endpoints:
- * - GET /api/movies (with various filters)
- * - GET /api/movies/{id}
- * - POST /api/movies
- * - POST /api/movies/batch
- * - PATCH /api/movies/{id}
- * - PATCH /api/movies
- * - DELETE /api/movies/{id}
- * - DELETE /api/movies
- * - DELETE /api/movies/{id}/find-and-delete
- *
- * TODO: Implement integration tests for aggregation endpoints:
- * - GET /api/movies/aggregations/comments (with and without limit/movieId)
- * - GET /api/movies/aggregations/years
- * - GET /api/movies/aggregations/directors (with and without limit)
- *
- * TODO: Test error scenarios:
- * - Invalid ObjectId format
- * - Resource not found
- * - Validation errors
- * - Database connection failures
- *
- * TODO: Test performance:
- * - Large dataset queries
- * - Pagination performance
- * - Text search performance
- * - Aggregation pipeline performance
- */
-public class MovieIntegrationTest {
-
-    // TODO: Add @SpringBootTest annotation
-    // TODO: Add @Testcontainers annotation
-    // TODO: Add MongoDB container configuration
-    // TODO: Add test data setup methods
-    // TODO: Add integration test methods for CRUD operations
-    // TODO: Add integration test methods for aggregation endpoints
-}
diff --git a/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java b/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
index 4371dbf..d68e202 100644
--- a/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
+++ b/mflix/server/java-spring/src/test/java/com/mongodb/samplemflix/service/MovieServiceTest.java
@@ -443,13 +443,13 @@ void testGetMoviesWithMostRecentComments_Success() {
         String movieId = null;
 
         Document doc1 = new Document()
-                .append("id", testId.toHexString())
+                .append("_id", testId.toHexString())
                 .append("title", "Test Movie")
                 .append("year", 2024)
                 .append("plot", "Test plot")
                 .append("poster", "http://example.com/poster.jpg")
                 .append("genres", Arrays.asList("Action", "Drama"))
-                .append("imdb", new Document("rating", 8.5).append("votes", 1000))
+                .append("imdbRating", 8.5)
                 .append("recentComments", Arrays.asList(
                         new Document()
                                 .append("_id", new ObjectId())

From 0043350a32012a30ace5835f74bbda53864b1d2c Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Fri, 7 Nov 2025 15:36:59 -0500
Subject: [PATCH 109/110] Delete unused files and todo comments

---
 .../exception/ValidationException.java        |   3 +-
 .../mongodb/samplemflix/model/Comment.java    |  60 ---------
 .../mongodb/samplemflix/model/Theater.java    | 119 ------------------
 .../samplemflix/service/MovieServiceImpl.java |   2 -
 4 files changed, 1 insertion(+), 183 deletions(-)
 delete mode 100644 mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
 delete mode 100644 mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java

diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java
index 30b5527..fa9fec5 100644
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java
+++ b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/exception/ValidationException.java
@@ -4,8 +4,7 @@
  * Exception thrown when request validation fails.
  * 
  * This exception results in a 400 Bad Request response.
- * 
- * TODO: Phase 7 - Implement custom exception
+ *
  */
 public class ValidationException extends RuntimeException {
     
diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
deleted file mode 100644
index d0e8633..0000000
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Comment.java
+++ /dev/null
@@ -1,60 +0,0 @@
-package com.mongodb.samplemflix.model;
-
-import java.util.Date;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.NoArgsConstructor;
-import org.bson.types.ObjectId;
-import org.springframework.data.annotation.Id;
-import org.springframework.data.mongodb.core.mapping.Document;
-import org.springframework.data.mongodb.core.mapping.Field;
-
-/**
- * Domain model representing a comment document from the MongoDB comments collection.
- *
- * <p>This class maps to the comments collection in the sample_mflix database.
- * Comments are user reviews/comments associated with movies.
- */
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-@Document(collection = "comments")
-public class Comment {
-
-    /**
-     * MongoDB document ID.
-     * Maps to the _id field in MongoDB.
-     */
-    @Id
-    private ObjectId id;
-
-    /**
-     * Name of the commenter.
-     */
-    private String name;
-
-    /**
-     * Email address of the commenter.
-     */
-    private String email;
-
-    /**
-     * ID of the movie this comment is associated with.
-     * References a document in the movies collection.
-     */
-    @Field("movie_id")
-    private ObjectId movieId;
-
-    /**
-     * Comment text content.
-     */
-    private String text;
-
-    /**
-     * Date when the comment was posted.
-     */
-    private Date date;
-
-}
diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
deleted file mode 100644
index c0d2045..0000000
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/model/Theater.java
+++ /dev/null
@@ -1,119 +0,0 @@
-package com.mongodb.samplemflix.model;
-
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.NoArgsConstructor;
-import org.bson.types.ObjectId;
-import org.springframework.data.annotation.Id;
-import org.springframework.data.mongodb.core.mapping.Document;
-
-/**
- * Domain model representing a theater document from the MongoDB theaters collection.
- *
- * <p>This class maps to the theaters collection in the sample_mflix database.
- * It includes location information with address and geospatial coordinates.
- *
- * <p>TODO: Implement Theater functionality:
- * - Create TheaterRepository extending MongoRepository
- * - Create TheaterService and TheaterServiceImpl
- * - Create TheaterController with REST endpoints
- * - Implement geospatial queries (findNear, findWithinRadius)
- * - Add validation annotations
- * - Add unit tests for Theater service and controller
- * - Add integration tests with geospatial queries
- * - Add GeoJSON support for location queries
- */
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-@Document(collection = "theaters")
-public class Theater {
-    
-    /**
-     * MongoDB document ID.
-     * Maps to the _id field in MongoDB.
-     */
-    @Id
-    private ObjectId id;
-    
-    /**
-     * Theater ID number.
-     */
-    private Integer theaterId;
-    
-    /**
-     * Location information including address and geospatial coordinates.
-     */
-    private Location location;
-    
-    /**
-     * Nested class representing location information.
-     */
-    @Data
-    @Builder
-    @NoArgsConstructor
-    @AllArgsConstructor
-    public static class Location {
-        /**
-         * Address information.
-         */
-        private Address address;
-        
-        /**
-         * Geospatial coordinates.
-         */
-        private Geo geo;
-        
-        /**
-         * Nested class for address information.
-         */
-        @Data
-        @Builder
-        @NoArgsConstructor
-        @AllArgsConstructor
-        public static class Address {
-            /**
-             * Street address line 1.
-             */
-            private String street1;
-            
-            /**
-             * City name.
-             */
-            private String city;
-            
-            /**
-             * State or province.
-             */
-            private String state;
-            
-            /**
-             * ZIP or postal code.
-             */
-            private String zipcode;
-        }
-        
-        /**
-         * Nested class for geospatial coordinates.
-         * Uses GeoJSON format for MongoDB geospatial queries.
-         */
-        @Data
-        @Builder
-        @NoArgsConstructor
-        @AllArgsConstructor
-        public static class Geo {
-            /**
-             * GeoJSON type (always "Point" for theater locations).
-             */
-            private String type;
-            
-            /**
-             * Coordinates array: [longitude, latitude].
-             * Note: GeoJSON uses longitude first, then latitude.
-             */
-            private double[] coordinates;
-        }
-    }
-}
diff --git a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
index ed00296..624fa36 100644
--- a/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
+++ b/mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java
@@ -712,8 +712,6 @@ public List<Movie> searchMovies(MovieSearchRequest searchRequest) {
         }
     }
 
-
-    // TODO: Implement vector search
     @Override
     public List<Movie> findSimilarMovies(String movieId, Integer limit) {
         // Validate movie ID

From 2444b1f3afe227343d0273c13d9552faab95c234 Mon Sep 17 00:00:00 2001
From: dacharyc <dachary.carey@mongodb.com>
Date: Fri, 7 Nov 2025 15:50:16 -0500
Subject: [PATCH 110/110] Tiny package.json cleanup

---
 mflix/client/package.json            | 3 +++
 mflix/server/js-express/package.json | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/mflix/client/package.json b/mflix/client/package.json
index 3cc711d..0faeda2 100644
--- a/mflix/client/package.json
+++ b/mflix/client/package.json
@@ -1,5 +1,8 @@
 {
   "name": "sample-mflix-front-end",
+  "description": "Next.js frontend for MongoDB sample mflix application demonstrating CRUD operations, aggregations, and search",
+  "license": "Apache-2.0",
+  "author": "MongoDB Documentation Team",
   "version": "0.1.0",
   "private": true,
   "scripts": {
diff --git a/mflix/server/js-express/package.json b/mflix/server/js-express/package.json
index 151b911..01311ba 100644
--- a/mflix/server/js-express/package.json
+++ b/mflix/server/js-express/package.json
@@ -3,7 +3,7 @@
   "version": "1.0.0",
   "description": "Express.js backend for MongoDB sample mflix application demonstrating CRUD operations, aggregations, search, and geospatial queries",
   "license": "Apache-2.0",
-  "author": "Jordan Smith",
+  "author": "MongoDB Documentation Team",
   "type": "commonjs",
   "main": "dist/app.js",
   "scripts": {