auq-mcp-server 0.1.0

package/dist/src/session/__tests__/ResponseFormatter.test.js

@@ -0,0 +1,741 @@
+/**
+ * Unit tests for Response Formatter
+ */
+import { describe, expect, it } from "vitest";
+import { ResponseFormatter } from "../ResponseFormatter.js";
+describe("ResponseFormatter", () => {
+    describe("formatUserResponse", () => {
+        it("should format a single question with selected option", () => {
+            const questions = [
+                {
+                    options: [
+                        {
+                            description: "Dynamic web language",
+                            label: "JavaScript",
+                        },
+                        {
+                            description: "Type-safe JavaScript",
+                            label: "TypeScript",
+                        },
+                    ],
+                    prompt: "What is your favorite programming language?",
+                    title: "Language",
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOption: "TypeScript",
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            const result = ResponseFormatter.formatUserResponse(answers, questions);
+            expect(result).toBe("Here are the user's answers:\n\n" +
+                "1. What is your favorite programming language?\n" +
+                "→ TypeScript — Type-safe JavaScript");
+        });
+        it("should format multiple questions with selected options", () => {
+            const questions = [
+                {
+                    options: [
+                        {
+                            description: "Dynamic web language",
+                            label: "JavaScript",
+                        },
+                        {
+                            description: "Type-safe JavaScript",
+                            label: "TypeScript",
+                        },
+                    ],
+                    prompt: "What is your favorite programming language?",
+                    title: "Language",
+                },
+                {
+                    options: [
+                        {
+                            description: "Frontend or backend web application",
+                            label: "Web",
+                        },
+                        {
+                            description: "Command-line tool",
+                            label: "CLI",
+                        },
+                    ],
+                    prompt: "What type of application are you building?",
+                    title: "Application Type",
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOption: "TypeScript",
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                    {
+                        questionIndex: 1,
+                        selectedOption: "Web",
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            const result = ResponseFormatter.formatUserResponse(answers, questions);
+            expect(result).toBe("Here are the user's answers:\n\n" +
+                "1. What is your favorite programming language?\n" +
+                "→ TypeScript — Type-safe JavaScript\n\n" +
+                "2. What type of application are you building?\n" +
+                "→ Web — Frontend or backend web application");
+        });
+        it("should format custom text answer", () => {
+            const questions = [
+                {
+                    options: [
+                        {
+                            description: "Frontend or backend web application",
+                            label: "Web",
+                        },
+                        {
+                            description: "Command-line tool",
+                            label: "CLI",
+                        },
+                    ],
+                    prompt: "What type of application are you building?",
+                    title: "Application Type",
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        customText: "Desktop app with Electron",
+                        questionIndex: 0,
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            const result = ResponseFormatter.formatUserResponse(answers, questions);
+            expect(result).toBe("Here are the user's answers:\n\n" +
+                "1. What type of application are you building?\n" +
+                "→ Other: 'Desktop app with Electron'");
+        });
+        it("should format mix of selected and custom answers", () => {
+            const questions = [
+                {
+                    options: [
+                        {
+                            description: "Dynamic web language",
+                            label: "JavaScript",
+                        },
+                        {
+                            description: "Type-safe JavaScript",
+                            label: "TypeScript",
+                        },
+                    ],
+                    prompt: "What is your favorite programming language?",
+                    title: "Language",
+                },
+                {
+                    options: [
+                        {
+                            description: "Frontend or backend web application",
+                            label: "Web",
+                        },
+                        {
+                            description: "Command-line tool",
+                            label: "CLI",
+                        },
+                    ],
+                    prompt: "What type of application are you building?",
+                    title: "Application Type",
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOption: "TypeScript",
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                    {
+                        customText: "Desktop app with Electron",
+                        questionIndex: 1,
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            const result = ResponseFormatter.formatUserResponse(answers, questions);
+            expect(result).toBe("Here are the user's answers:\n\n" +
+                "1. What is your favorite programming language?\n" +
+                "→ TypeScript — Type-safe JavaScript\n\n" +
+                "2. What type of application are you building?\n" +
+                "→ Other: 'Desktop app with Electron'");
+        });
+        it("should handle option without description", () => {
+            const questions = [
+                {
+                    options: [
+                        {
+                            label: "Red",
+                        },
+                        {
+                            label: "Blue",
+                        },
+                    ],
+                    prompt: "Choose a color",
+                    title: "Color",
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOption: "Red",
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            const result = ResponseFormatter.formatUserResponse(answers, questions);
+            expect(result).toBe("Here are the user's answers:\n\n" + "1. Choose a color\n" + "→ Red");
+        });
+        it("should escape single quotes in custom text", () => {
+            const questions = [
+                {
+                    options: [
+                        {
+                            label: "Good",
+                        },
+                    ],
+                    prompt: "What is your feedback?",
+                    title: "Feedback",
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        customText: "It's great! I'm loving it!",
+                        questionIndex: 0,
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            const result = ResponseFormatter.formatUserResponse(answers, questions);
+            expect(result).toContain("It\\'s great! I\\'m loving it!");
+        });
+        it("should throw error for empty answers", () => {
+            const questions = [
+                {
+                    options: [{ label: "Option 1" }],
+                    prompt: "Test question",
+                    title: "Test Question",
+                },
+            ];
+            const answers = {
+                answers: [],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            expect(() => ResponseFormatter.formatUserResponse(answers, questions)).toThrow("No answers provided in session");
+        });
+        it("should throw error for empty questions", () => {
+            const questions = [];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOption: "Option 1",
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            expect(() => ResponseFormatter.formatUserResponse(answers, questions)).toThrow("No questions provided");
+        });
+        it("should handle missing answer for a question gracefully", () => {
+            const questions = [
+                {
+                    options: [{ label: "Option 1" }],
+                    prompt: "Question 1",
+                    title: "Question 1",
+                },
+                {
+                    options: [{ label: "Option 2" }],
+                    prompt: "Question 2",
+                    title: "Question 2",
+                },
+            ];
+            const answers = {
+                answers: [
+                    // Only answer for question 0, missing answer for question 1
+                    {
+                        questionIndex: 0,
+                        selectedOption: "Option 1",
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            const result = ResponseFormatter.formatUserResponse(answers, questions);
+            // Should only include the answered question
+            expect(result).toBe("Here are the user's answers:\n\n" + "1. Question 1\n" + "→ Option 1");
+        });
+    });
+    describe("validateAnswers", () => {
+        it("should validate correct answers", () => {
+            const questions = [
+                {
+                    options: [{ label: "Option 1" }, { label: "Option 2" }],
+                    prompt: "Test question",
+                    title: "Test Question",
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOption: "Option 1",
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            expect(() => ResponseFormatter.validateAnswers(answers, questions)).not.toThrow();
+        });
+        it("should throw error for invalid question index", () => {
+            const questions = [
+                {
+                    options: [{ label: "Option 1" }],
+                    prompt: "Test question",
+                    title: "Test Question",
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 99, // Invalid index
+                        selectedOption: "Option 1",
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            expect(() => ResponseFormatter.validateAnswers(answers, questions)).toThrow("Answer references invalid question index: 99");
+        });
+        it("should throw error for answer with neither selectedOption nor customText", () => {
+            const questions = [
+                {
+                    options: [{ label: "Option 1" }],
+                    prompt: "Test question",
+                    title: "Test Question",
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        // Neither selectedOption nor customText provided
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            expect(() => ResponseFormatter.validateAnswers(answers, questions)).toThrow("has neither selectedOption, selectedOptions, nor customText");
+        });
+        it("should throw error for non-existent option", () => {
+            const questions = [
+                {
+                    options: [{ label: "Option 1" }, { label: "Option 2" }],
+                    prompt: "Test question",
+                    title: "Test Question",
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOption: "Option 3", // Non-existent option
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            expect(() => ResponseFormatter.validateAnswers(answers, questions)).toThrow("references non-existent option: Option 3");
+        });
+        it("should validate custom text answers", () => {
+            const questions = [
+                {
+                    options: [{ label: "Option 1" }],
+                    prompt: "Test question",
+                    title: "Test Question",
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        customText: "My custom answer",
+                        questionIndex: 0,
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            expect(() => ResponseFormatter.validateAnswers(answers, questions)).not.toThrow();
+        });
+        it("should throw error for empty answers array", () => {
+            const questions = [
+                {
+                    options: [{ label: "Option 1" }],
+                    prompt: "Test question",
+                    title: "Test Question",
+                },
+            ];
+            const answers = {
+                answers: [],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            expect(() => ResponseFormatter.validateAnswers(answers, questions)).toThrow("No answers provided");
+        });
+        it("should throw error for empty questions array", () => {
+            const questions = [];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOption: "Option 1",
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            expect(() => ResponseFormatter.validateAnswers(answers, questions)).toThrow("No questions provided");
+        });
+        it("should validate multi-select answers with selectedOptions array", () => {
+            const questions = [
+                {
+                    options: [
+                        { label: "Feature A" },
+                        { label: "Feature B" },
+                        { label: "Feature C" },
+                    ],
+                    prompt: "Which features do you want?",
+                    title: "Features",
+                    multiSelect: true,
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOptions: ["Feature A", "Feature C"],
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            expect(() => ResponseFormatter.validateAnswers(answers, questions)).not.toThrow();
+        });
+        it("should throw error for invalid option in selectedOptions array", () => {
+            const questions = [
+                {
+                    options: [
+                        { label: "Feature A" },
+                        { label: "Feature B" },
+                        { label: "Feature C" },
+                    ],
+                    prompt: "Which features do you want?",
+                    title: "Features",
+                    multiSelect: true,
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOptions: ["Feature A", "Invalid Feature"],
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            expect(() => ResponseFormatter.validateAnswers(answers, questions)).toThrow("references non-existent option: Invalid Feature");
+        });
+        it("should validate empty selectedOptions array (no selections)", () => {
+            const questions = [
+                {
+                    options: [
+                        { label: "Feature A" },
+                        { label: "Feature B" },
+                    ],
+                    prompt: "Which features do you want?",
+                    title: "Features",
+                    multiSelect: true,
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOptions: [],
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            expect(() => ResponseFormatter.validateAnswers(answers, questions)).not.toThrow();
+        });
+    });
+    describe("formatUserResponse - Multi-Select", () => {
+        it("should format multi-select question with multiple selections (with descriptions)", () => {
+            const questions = [
+                {
+                    options: [
+                        {
+                            description: "Authentication support",
+                            label: "Auth",
+                        },
+                        {
+                            description: "Database integration",
+                            label: "Database",
+                        },
+                        {
+                            description: "API endpoints",
+                            label: "API",
+                        },
+                    ],
+                    prompt: "Which features do you want to enable?",
+                    title: "Features",
+                    multiSelect: true,
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOptions: ["Auth", "API"],
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            const result = ResponseFormatter.formatUserResponse(answers, questions);
+            expect(result).toBe("Here are the user's answers:\n\n" +
+                "1. Which features do you want to enable?\n" +
+                "→ Auth — Authentication support\n" +
+                "→ API — API endpoints");
+        });
+        it("should format multi-select question with multiple selections (without descriptions)", () => {
+            const questions = [
+                {
+                    options: [
+                        { label: "Red" },
+                        { label: "Green" },
+                        { label: "Blue" },
+                    ],
+                    prompt: "Select your favorite colors",
+                    title: "Colors",
+                    multiSelect: true,
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOptions: ["Red", "Blue"],
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            const result = ResponseFormatter.formatUserResponse(answers, questions);
+            expect(result).toBe("Here are the user's answers:\n\n" +
+                "1. Select your favorite colors\n" +
+                "→ Red\n" +
+                "→ Blue");
+        });
+        it("should format multi-select question with empty selections", () => {
+            const questions = [
+                {
+                    options: [
+                        { label: "Feature A" },
+                        { label: "Feature B" },
+                    ],
+                    prompt: "Which optional features do you want?",
+                    title: "Optional Features",
+                    multiSelect: true,
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOptions: [],
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            const result = ResponseFormatter.formatUserResponse(answers, questions);
+            expect(result).toBe("Here are the user's answers:\n\n" +
+                "1. Which optional features do you want?\n" +
+                "→ (No selection)");
+        });
+        it("should format mixed single-select and multi-select questions", () => {
+            const questions = [
+                {
+                    options: [
+                        {
+                            description: "Type-safe JavaScript",
+                            label: "TypeScript",
+                        },
+                        {
+                            description: "Dynamic web language",
+                            label: "JavaScript",
+                        },
+                    ],
+                    prompt: "What is your primary language?",
+                    title: "Language",
+                    multiSelect: false,
+                },
+                {
+                    options: [
+                        {
+                            description: "Authentication support",
+                            label: "Auth",
+                        },
+                        {
+                            description: "Database integration",
+                            label: "Database",
+                        },
+                        {
+                            description: "API endpoints",
+                            label: "API",
+                        },
+                    ],
+                    prompt: "Which features do you want?",
+                    title: "Features",
+                    multiSelect: true,
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOption: "TypeScript",
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                    {
+                        questionIndex: 1,
+                        selectedOptions: ["Auth", "Database"],
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            const result = ResponseFormatter.formatUserResponse(answers, questions);
+            expect(result).toBe("Here are the user's answers:\n\n" +
+                "1. What is your primary language?\n" +
+                "→ TypeScript — Type-safe JavaScript\n\n" +
+                "2. Which features do you want?\n" +
+                "→ Auth — Authentication support\n" +
+                "→ Database — Database integration");
+        });
+        it("should format multi-select with single selection (edge case)", () => {
+            const questions = [
+                {
+                    options: [
+                        { label: "Option A" },
+                        { label: "Option B" },
+                        { label: "Option C" },
+                    ],
+                    prompt: "Select any options you like",
+                    title: "Options",
+                    multiSelect: true,
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOptions: ["Option B"],
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            const result = ResponseFormatter.formatUserResponse(answers, questions);
+            expect(result).toBe("Here are the user's answers:\n\n" +
+                "1. Select any options you like\n" +
+                "→ Option B");
+        });
+        it("should format multi-select with both selected options AND custom text", () => {
+            const questions = [
+                {
+                    options: [
+                        {
+                            description: "Authentication support",
+                            label: "Auth",
+                        },
+                        {
+                            description: "Database integration",
+                            label: "Database",
+                        },
+                        {
+                            description: "API endpoints",
+                            label: "API",
+                        },
+                    ],
+                    prompt: "Which features do you want?",
+                    title: "Features",
+                    multiSelect: true,
+                },
+            ];
+            const answers = {
+                answers: [
+                    {
+                        questionIndex: 0,
+                        selectedOptions: ["Auth", "Database"],
+                        customText: "Also need caching system",
+                        timestamp: "2025-01-01T00:00:00Z",
+                    },
+                ],
+                sessionId: "test-123",
+                timestamp: "2025-01-01T00:00:00Z",
+            };
+            const result = ResponseFormatter.formatUserResponse(answers, questions);
+            expect(result).toBe("Here are the user's answers:\n\n" +
+                "1. Which features do you want?\n" +
+                "→ Auth — Authentication support\n" +
+                "→ Database — Database integration\n" +
+                "→ Other: 'Also need caching system'");
+        });
+    });
+});