add_farewell_endpoints_with_multi-language_goodbye_support_1752552899

Author: Dagger

.dagger/prompts/assignment.md

@@ -6,7 +6,8 @@ You are a programmer working on the Greetings API project
 2. Evaluate the architecture of the project at `## Project Architecture` in CONTRIBUTING.md to think about what files may be relevant to the solution
 3. Understand how the assignment should be implemented in the codebase
 4. Implement the assignment in the workspace provided
-5. Run the checks to make sure the changes are valid and incorporate any changes needed to pass checks
+5. **CRITICAL**: Update documentation in `docs/index.mdx` to reflect any new functionality, endpoints, or changes
+6. Run the checks to make sure the changes are valid and incorporate any changes needed to pass checks
 
 ## Assignment
 
@@ -17,4 +18,5 @@ Here is your assignment: $assignment
 - The workspace has tools to let you read and write the code as well as run the tests
 - Be sure to always write your changes to the workspace
 - Always run check after writing changes to the workspace
+- **IMPORTANT**: Changes to project functionality MUST be reflected in changes to the documentation (`docs/index.mdx`)
 - You are not done until the check tool is successful and the assignment is complete

CONTRIBUTING.md

@@ -64,10 +64,12 @@ greetings-api/
 
 - **Language**: Go
 - **Framework**: Gorilla Mux for routing, CORS middleware
-- **Structure**: Simple REST API with two endpoints:
+- **Structure**: Simple REST API with endpoints for greetings and farewells:
   - `GET /` - Returns a random greeting
   - `GET /{language}` - Returns a greeting in the specified language
-- **Data**: Greetings are stored in `greetings.json` and embedded in the binary
+  - `GET /farewell` - Returns a random farewell
+  - `GET /farewell/{language}` - Returns a farewell in the specified language
+- **Data**: Greetings are stored in `greetings.json` and farewells in `farewells.json`, both embedded in the binary
 - **Testing**: Uses `gotest.tools` for unit tests
 
 ### Frontend Architecture
@@ -154,10 +156,17 @@ npm run lint
 - **TypeScript**: Follow the ESLint configuration in the project
 - **Commits**: Use clear, descriptive commit messages
 
-### Documentation
+### Documentation Requirements
+
+**⚠️ CRITICAL**: Changes to project functionality MUST be reflected in documentation updates.
 
 - **Developer Docs**: Update CONTRIBUTING.md with any architectural changes
-- **Product Docs**: Update docs/ with relevant product changes
+- **Product Docs**: Update `docs/index.mdx` with any new endpoints, functionality, or changes that affect users
+- **API Documentation**: When adding new endpoints, ensure they are properly documented with:
+  - Endpoint paths and HTTP methods
+  - Example requests and responses
+  - Updated supported languages table if applicable
+  - Error handling examples
 
 ### Testing Requirements
 
@@ -174,22 +183,25 @@ npm run lint
 
 2. **Make your changes** following the code style guidelines
 
-3. **Test your changes** thoroughly:
+3. **Update documentation** as required (see Documentation Requirements above)
+
+4. **Test your changes** thoroughly:
    ```bash
    dagger call check
    ```
 
-4. **Commit your changes** with clear commit messages
+5. **Commit your changes** with clear commit messages
 
-5. **Push to your fork**:
+6. **Push to your fork**:
    ```bash
    git push origin feature/your-feature-name
    ```
 
-6. **Create a Pull Request** on GitHub with:
+7. **Create a Pull Request** on GitHub with:
    - Clear description of changes
    - Reference to any related issues
    - Screenshots if UI changes are involved
+   - Confirmation that documentation has been updated if functionality changed
 
 ## Getting Help
 

docs/index.mdx

@@ -1,10 +1,10 @@
 # Greetings API Documentation
 
-Welcome to the Greetings API! This simple service allows you to retrieve greetings in various languages.
+Welcome to the Greetings API! This simple service allows you to retrieve greetings and farewells in various languages.
 
 ## Using the REST API
 
-The Greetings API provides two main endpoints for retrieving greetings:
+The Greetings API provides endpoints for retrieving both greetings and farewells:
 
 ### Get a Random Greeting
 
@@ -39,38 +39,72 @@ GET http://locahost:8080/french
 }
 ```
 
+### Get a Random Farewell
+
+```
+GET http://locahost:8080/farewell
+```
+
+**Example Response:**
+```json
+{
+  "farewell": "Goodbye, World!"
+}
+```
+
+### Get a Farewell in a Specific Language
+
+```
+GET http://locahost:8080/farewell/{language}
+```
+
+Replace `{language}` with one of the supported language codes.
+
+**Example Request:**
+```
+GET http://locahost:8080/farewell/french
+```
+
+**Example Response:**
+```json
+{
+  "farewell": "Au revoir, Monde !"
+}
+```
+
 ## Supported Languages
 
 The API currently supports the following languages:
 
-| Language Code | Greeting |
-|---------------|----------|
-| english       | Hello, World! |
-| british       | Hello, World! Cheers! |
-| french        | Bonjour, Monde ! |
-| italian       | Ciao, Mondo! |
-| spanish       | ¡Hola, Mundo! |
-| german        | Hallo, Welt! |
-| mandarin      | 你好，世界！ |
-| hindi         | नमस्ते दुनिया! |
-| arabic        | مرحبا بالعالم! |
-| bengali       | ওহে বিশ্ব! |
-| russian       | Привет, мир! |
-| portuguese    | Olá, Mundo! |
-| urdu          | ہیلو، دنیا! |
-| indonesian    | Halo Dunia! |
-| japanese      | こんにちは世界！ |
-| marathi       | नमस्कार जग! |
-| telugu        | హలో ప్రపంచం! |
+| Language Code | Greeting | Farewell |
+|---------------|----------|----------|
+| english       | Hello, World! | Goodbye, World! |
+| british       | Hello, World! Cheers! | Goodbye, World! Cheerio! |
+| french        | Bonjour, Monde ! | Au revoir, Monde ! |
+| italian       | Ciao, Mondo! | Arrivederci, Mondo! |
+| spanish       | ¡Hola, Mundo! | ¡Adiós, Mundo! |
+| german        | Hallo, Welt! | Auf Wiedersehen, Welt! |
+| mandarin      | 你好，世界！ | 再见，世界！ |
+| hindi         | नमस्ते दुनिया! | अलविदा दुनिया! |
+| arabic        | مرحبا بالعالم! | وداعا يا عالم! |
+| bengali       | ওহে বিশ্ব! | বিদায় পৃথিবী! |
+| russian       | Привет, мир! | До свидания, мир! |
+| portuguese    | Olá, Mundo! | Adeus, Mundo! |
+| urdu          | ہیلو، دنیا! | الوداع، دنیا! |
+| indonesian    | Halo Dunia! | Selamat tinggal Dunia! |
+| japanese      | こんにちは世界！ | さようなら世界！ |
+| marathi       | नमस्कार जग! | निरोप जग! |
+| telugu        | హలో ప్రపంచం! | వీడ్కోలు ప్రపంచం! |
 
 ## Using the Greetings Website
 
 If you prefer a web interface, you can visit the website at http://locahost:8081/ where you can:
 
 1. View random greetings with a simple click
-2. Experience our user-friendly interface
+2. View random farewells with a simple click
+3. Experience our user-friendly interface
 
-Simply click the greeting button (👋) to get a new random greeting displayed on the screen.
+Simply click the greeting button (👋) to get a new random greeting or the farewell button (👋😢) to get a new random farewell displayed on the screen.
 
 ## API Limits
 
@@ -80,13 +114,20 @@ Currently, there are no rate limits on the API usage, but please be respectful o
 
 If you request a language that doesn't exist, the API will return an appropriate error message with a 400 status code.
 
-Example error response:
+Example error response for greeting:
 ```json
 {
   "error": "no greeting found for language 'klingon'"
 }
 ```
 
+Example error response for farewell:
+```json
+{
+  "error": "no farewell found for language 'klingon'"
+}
+```
+
 ## Need Help?
 
 If you have any questions or need assistance with the Greetings API, please open an issue on our GitHub repository.

website/index.html

@@ -21,7 +21,7 @@ <h1 class="text-3xl font-bold mb-4">Greetings Daggernauts</h1>
     <script>
         async function getRandomGreeting() {
             try {
-                const response = await fetch('http://localhost:8080/random');
+                const response = await fetch('http://localhost:8080/');
                 const data = await response.json();
                 document.getElementById('greetingDisplay').textContent = data.greeting;
             } catch (error) {