@thanh01.pmt/interactive-quiz-kit 1.0.24 → 1.0.27

package/dist/ai.cjs

@@ -5,37 +5,7 @@ var zod = require('zod');
 var genkit = require('genkit');
 var googleai = require('@genkit-ai/googleai');
 
-var __defProp = Object.defineProperty;
-var __defProps = Object.defineProperties;
-var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
-var __getOwnPropSymbols = Object.getOwnPropertySymbols;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __propIsEnum = Object.prototype.propertyIsEnumerable;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues = (a, b) => {
-  for (var prop in b || (b = {}))
-    if (__hasOwnProp.call(b, prop))
-      __defNormalProp(a, prop, b[prop]);
-  if (__getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(b)) {
-      if (__propIsEnum.call(b, prop))
-        __defNormalProp(a, prop, b[prop]);
-    }
-  return a;
-};
-var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
-var __objRest = (source, exclude) => {
-  var target = {};
-  for (var prop in source)
-    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
-      target[prop] = source[prop];
-  if (source != null && __getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(source)) {
-      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
-        target[prop] = source[prop];
-    }
-  return target;
-};
+// src/ai/flows/question-gen/generate-fitb-question.ts
 
 // src/utils/idGenerators.ts
 function generateUniqueId(prefix = "id_") {
@@ -254,7 +224,7 @@ var MAX_RETRY_ATTEMPTS = 3;
 var RETRY_DELAY_MS = 3e3;
 function buildEnhancedPrompt(clientInput, attemptNumber) {
   const { quizContext, language, difficulty, numberOfBlanks, imageUrl } = clientInput;
-  const category = (quizContext == null ? void 0 : quizContext.originalCategory) || "the specified technical category";
+  const category = quizContext?.originalCategory || "the specified technical category";
   const attemptInfo = attemptNumber > 1 ? `
 ## DEBUG INFO - This is attempt #${attemptNumber}
 Previous attempts failed. Pay strict attention to the JSON schema, especially the 'segments' array structure. Ensure 'blank' segments have 'acceptedAnswers' and 'text' segments have 'content'.
@@ -263,10 +233,10 @@ Previous attempts failed. Pay strict attention to the JSON schema, especially th
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The question and blanks must be directly related to the content of this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    (quizContext == null ? void 0 : quizContext.loDescription) && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
     imageContextInstruction,
-    (quizContext == null ? void 0 : quizContext.plannedBloomLevel) && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
-    (quizContext == null ? void 0 : quizContext.targetMisconception) && `**Target Misconception:** Design the blank to test this specific point: "${quizContext.targetMisconception}"`
+    quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
+    quizContext?.targetMisconception && `**Target Misconception:** Design the blank to test this specific point: "${quizContext.targetMisconception}"`
   ].filter(Boolean).map((s) => `- ${s}`).join("\n");
   const exampleJson = JSON.stringify({
     prompt: "Complete the following Swift code snippet.",
@@ -296,7 +266,7 @@ ${contextStrings}
 Based on all the rules and context above, generate a single Fill-in-the-Blanks Question.
 
 ### Input Parameters
-- **Topic for Question:** ${(quizContext == null ? void 0 : quizContext.plannedTopic) || "General"}
+- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
 - **Language for Text:** ${language}
 - **Difficulty Level:** ${difficulty}
 - **Number of Blanks:** Generate exactly ${numberOfBlanks} segment(s) with type 'blank'.
@@ -309,7 +279,6 @@ ${exampleJson}
 Now, generate the JSON for the requested question.`;
 }
 async function generateFillInTheBlanksQuestion(clientInput, apiKey) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
   const ai = new genai.GoogleGenAI({ apiKey });
   const model = "gemini-2.5-flash";
   const config = {
@@ -326,7 +295,7 @@ async function generateFillInTheBlanksQuestion(clientInput, apiKey) {
     const promptText = buildEnhancedPrompt(clientInput, attempt);
     const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
     try {
-      DebugLogger.logPrompt(attempt, promptText, __spreadProps(__spreadValues({}, clientInput), { attemptNumber: attempt, promptHash }));
+      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
       const parts = [{ text: promptText }];
       if (clientInput.imageUrl) {
         const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
@@ -336,7 +305,7 @@ async function generateFillInTheBlanksQuestion(clientInput, apiKey) {
       const contents = [{ role: "user", parts }];
       const aiResult = await ai.models.generateContent({ model, config, contents });
       const response = aiResult;
-      const rawText = ((_e = (_d = (_c = (_b = (_a = response.candidates) == null ? void 0 : _a[0]) == null ? void 0 : _b.content) == null ? void 0 : _c.parts) == null ? void 0 : _d[0]) == null ? void 0 : _e.text) || "";
+      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
       const duration = Date.now() - startTime;
       DebugLogger.logResponse(attempt, rawText);
       if (!rawText) throw new Error("AI returned an empty response.");
@@ -356,8 +325,8 @@ async function generateFillInTheBlanksQuestion(clientInput, apiKey) {
           throw new Error(`Segment ${index} is 'text' but is missing 'content'.`);
         }
       });
-      if ((_f = clientInput.quizContext) == null ? void 0 : _f.originalCategory) {
-        const verifiedCategory = (_g = aiGeneratedContent.verifiedCategory) == null ? void 0 : _g.toLowerCase();
+      if (clientInput.quizContext?.originalCategory) {
+        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
         const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
         if (verifiedCategory && verifiedCategory !== requiredCategory) {
           throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
@@ -383,13 +352,13 @@ async function generateFillInTheBlanksQuestion(clientInput, apiKey) {
         isCaseSensitive: clientInput.isCaseSensitive,
         explanation: aiGeneratedContent.explanation,
         points: aiGeneratedContent.points,
-        topic: aiGeneratedContent.topic || ((_h = clientInput.quizContext) == null ? void 0 : _h.originalTopic),
+        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
         difficulty: clientInput.difficulty,
-        contextCode: (_i = clientInput.quizContext) == null ? void 0 : _i.plannedContextId,
-        bloomLevel: (_j = clientInput.quizContext) == null ? void 0 : _j.plannedBloomLevel,
-        learningObjective: (_k = clientInput.quizContext) == null ? void 0 : _k.originalLoId,
-        subject: (_l = clientInput.quizContext) == null ? void 0 : _l.originalSubject,
-        category: (_m = clientInput.quizContext) == null ? void 0 : _m.originalCategory,
+        contextCode: clientInput.quizContext?.plannedContextId,
+        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
+        learningObjective: clientInput.quizContext?.originalLoId,
+        subject: clientInput.quizContext?.originalSubject,
+        category: clientInput.quizContext?.originalCategory,
         imageUrl: clientInput.imageUrl
       };
       const validatedQuestion = FillInTheBlanksQuestionZodSchema.parse(completeQuestion);
@@ -411,7 +380,7 @@ async function generateFillInTheBlanksQuestion(clientInput, apiKey) {
     }
   }
   DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate FITB question after ${MAX_RETRY_ATTEMPTS} attempts. Last error: ${lastError == null ? void 0 : lastError.message}`;
+  const errorMessage = `Failed to generate FITB question after ${MAX_RETRY_ATTEMPTS} attempts. Last error: ${lastError?.message}`;
   console.error("\n\u274C Final Result: FAILED");
   console.error(errorMessage);
   return { error: errorMessage };
@@ -439,7 +408,7 @@ var MAX_RETRY_ATTEMPTS2 = 3;
 var RETRY_DELAY_MS2 = 3e3;
 function buildEnhancedPrompt2(clientInput, attemptNumber) {
   const { quizContext, language, difficulty, numberOfPairs, imageUrl } = clientInput;
-  const category = (quizContext == null ? void 0 : quizContext.originalCategory) || "the specified technical category";
+  const category = quizContext?.originalCategory || "the specified technical category";
   const attemptInfo = attemptNumber > 1 ? `
 ## DEBUG INFO - This is attempt #${attemptNumber}
 Previous attempts failed. Please ensure the 'correctPairs' array has exactly the required number of items and the JSON is valid.
@@ -448,10 +417,10 @@ Previous attempts failed. Please ensure the 'correctPairs' array has exactly the
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The matching pairs must be directly related to the content of this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    (quizContext == null ? void 0 : quizContext.loDescription) && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
     imageContextInstruction,
-    (quizContext == null ? void 0 : quizContext.plannedBloomLevel) && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
-    (quizContext == null ? void 0 : quizContext.targetMisconception) && `**Target Misconception:** Design a pair that specifically tests this confusion: "${quizContext.targetMisconception}"`
+    quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
+    quizContext?.targetMisconception && `**Target Misconception:** Design a pair that specifically tests this confusion: "${quizContext.targetMisconception}"`
   ].filter(Boolean).map((s) => `- ${s}`).join("\n");
   const exampleJson = JSON.stringify({
     prompt: "Match each Swift collection type to its primary characteristic.",
@@ -481,7 +450,7 @@ ${contextStrings}
 Based on all the rules and context above, generate a single Matching Question.
 
 ### Input Parameters
-- **Topic for Question:** ${(quizContext == null ? void 0 : quizContext.plannedTopic) || "General"}
+- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
 - **Language for Text:** ${language}
 - **Difficulty Level:** ${difficulty}
 - **Number of Pairs:** Generate exactly ${numberOfPairs} correct pairs in the 'correctPairs' array.
@@ -494,7 +463,6 @@ ${exampleJson}
 Now, generate the JSON for the requested question.`;
 }
 async function generateMatchingQuestion(clientInput, apiKey) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
   const ai = new genai.GoogleGenAI({ apiKey });
   const model = "gemini-2.5-flash";
   const config = {
@@ -511,7 +479,7 @@ async function generateMatchingQuestion(clientInput, apiKey) {
     const promptText = buildEnhancedPrompt2(clientInput, attempt);
     const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
     try {
-      DebugLogger.logPrompt(attempt, promptText, __spreadProps(__spreadValues({}, clientInput), { attemptNumber: attempt, promptHash }));
+      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
       const parts = [{ text: promptText }];
       if (clientInput.imageUrl) {
         const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
@@ -521,7 +489,7 @@ async function generateMatchingQuestion(clientInput, apiKey) {
       const contents = [{ role: "user", parts }];
       const aiResult = await ai.models.generateContent({ model, config, contents });
       const response = aiResult;
-      const rawText = ((_e = (_d = (_c = (_b = (_a = response.candidates) == null ? void 0 : _a[0]) == null ? void 0 : _b.content) == null ? void 0 : _c.parts) == null ? void 0 : _d[0]) == null ? void 0 : _e.text) || "";
+      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
       const duration = Date.now() - startTime;
       DebugLogger.logResponse(attempt, rawText);
       if (!rawText) throw new Error("AI returned an empty response.");
@@ -532,8 +500,8 @@ async function generateMatchingQuestion(clientInput, apiKey) {
       if (aiGeneratedContent.correctPairs.length !== clientInput.numberOfPairs) {
         throw new Error(`AI generated ${aiGeneratedContent.correctPairs.length} pairs, but ${clientInput.numberOfPairs} were required.`);
       }
-      if ((_f = clientInput.quizContext) == null ? void 0 : _f.originalCategory) {
-        const verifiedCategory = (_g = aiGeneratedContent.verifiedCategory) == null ? void 0 : _g.toLowerCase();
+      if (clientInput.quizContext?.originalCategory) {
+        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
         const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
         if (verifiedCategory && verifiedCategory !== requiredCategory) {
           throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
@@ -559,13 +527,13 @@ async function generateMatchingQuestion(clientInput, apiKey) {
         shuffleOptions: clientInput.shuffleOptions,
         explanation: aiGeneratedContent.explanation,
         points: aiGeneratedContent.points,
-        topic: aiGeneratedContent.topic || ((_h = clientInput.quizContext) == null ? void 0 : _h.originalTopic),
+        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
         difficulty: clientInput.difficulty,
-        contextCode: (_i = clientInput.quizContext) == null ? void 0 : _i.plannedContextId,
-        bloomLevel: (_j = clientInput.quizContext) == null ? void 0 : _j.plannedBloomLevel,
-        learningObjective: (_k = clientInput.quizContext) == null ? void 0 : _k.originalLoId,
-        subject: (_l = clientInput.quizContext) == null ? void 0 : _l.originalSubject,
-        category: (_m = clientInput.quizContext) == null ? void 0 : _m.originalCategory,
+        contextCode: clientInput.quizContext?.plannedContextId,
+        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
+        learningObjective: clientInput.quizContext?.originalLoId,
+        subject: clientInput.quizContext?.originalSubject,
+        category: clientInput.quizContext?.originalCategory,
         imageUrl: clientInput.imageUrl
       };
       const validatedQuestion = MatchingQuestionZodSchema.parse(completeQuestion);
@@ -587,7 +555,7 @@ async function generateMatchingQuestion(clientInput, apiKey) {
     }
   }
   DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate Matching question after ${MAX_RETRY_ATTEMPTS2} attempts. Last error: ${lastError == null ? void 0 : lastError.message}`;
+  const errorMessage = `Failed to generate Matching question after ${MAX_RETRY_ATTEMPTS2} attempts. Last error: ${lastError?.message}`;
   console.error("\n\u274C Final Result: FAILED");
   console.error(errorMessage);
   return { error: errorMessage };
@@ -616,7 +584,7 @@ var MAX_RETRY_ATTEMPTS3 = 3;
 var RETRY_DELAY_MS3 = 3e3;
 function buildEnhancedPrompt3(clientInput, attemptNumber) {
   const { quizContext, language, difficulty, numberOfOptions, imageUrl } = clientInput;
-  const category = (quizContext == null ? void 0 : quizContext.originalCategory) || "the specified technical category";
+  const category = quizContext?.originalCategory || "the specified technical category";
   const attemptInfo = attemptNumber > 1 ? `
 ## DEBUG INFO - This is attempt #${attemptNumber}
 Previous attempts failed...
@@ -625,11 +593,11 @@ Previous attempts failed...
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The question and options must be directly related to the content of this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    (quizContext == null ? void 0 : quizContext.loDescription) && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
     imageContextInstruction,
-    (quizContext == null ? void 0 : quizContext.plannedBloomLevel) && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
-    (quizContext == null ? void 0 : quizContext.targetMisconception) && `**Target Misconception:** Use this to create plausible incorrect answers: "${quizContext.targetMisconception}"`,
-    (quizContext == null ? void 0 : quizContext.difficultyReason) && `**Pedagogical Reason:** ${quizContext.difficultyReason}`
+    quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
+    quizContext?.targetMisconception && `**Target Misconception:** Use this to create plausible incorrect answers: "${quizContext.targetMisconception}"`,
+    quizContext?.difficultyReason && `**Pedagogical Reason:** ${quizContext.difficultyReason}`
   ].filter(Boolean).map((s) => `- ${s}`).join("\n");
   const exampleJson = JSON.stringify({
     prompt: `In ${category}, what is the primary purpose of the 'guard' statement?`,
@@ -661,7 +629,7 @@ ${contextStrings}
 Based on all the rules and context above, generate a single Multiple Choice Question.
 
 ### Input Parameters
-- **Topic for Question:** ${(quizContext == null ? void 0 : quizContext.plannedTopic) || "General"}
+- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
 - **Language for Text:** ${language}
 - **Difficulty Level:** ${difficulty}
 - **Number of Options:** ${numberOfOptions}
@@ -674,7 +642,6 @@ ${exampleJson}
 Now, generate the JSON for the requested question.`;
 }
 async function generateMCQQuestion(clientInput, apiKey) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
   const ai = new genai.GoogleGenAI({ apiKey });
   const model = "gemini-2.5-flash";
   const config = {
@@ -691,7 +658,7 @@ async function generateMCQQuestion(clientInput, apiKey) {
     const promptText = buildEnhancedPrompt3(clientInput, attempt);
     const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
     try {
-      DebugLogger.logPrompt(attempt, promptText, __spreadProps(__spreadValues({}, clientInput), { attemptNumber: attempt, promptHash }));
+      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
       const parts = [{ text: promptText }];
       if (clientInput.imageUrl) {
         const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
@@ -705,7 +672,7 @@ async function generateMCQQuestion(clientInput, apiKey) {
         contents
       });
       const response = aiResult;
-      const rawText = ((_e = (_d = (_c = (_b = (_a = response.candidates) == null ? void 0 : _a[0]) == null ? void 0 : _b.content) == null ? void 0 : _c.parts) == null ? void 0 : _d[0]) == null ? void 0 : _e.text) || "";
+      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
       const duration = Date.now() - startTime;
       DebugLogger.logResponse(attempt, rawText);
       if (!rawText) {
@@ -715,8 +682,8 @@ async function generateMCQQuestion(clientInput, apiKey) {
       DebugLogger.logValidation(attempt, "JSON Parsed Successfully", parsedJson);
       const aiGeneratedContent = AIMCQOutputFieldsSchema.parse(parsedJson);
       DebugLogger.logValidation(attempt, "Zod Schema Validated", aiGeneratedContent);
-      if ((_f = clientInput.quizContext) == null ? void 0 : _f.originalCategory) {
-        const verifiedCategory = (_g = aiGeneratedContent.verifiedCategory) == null ? void 0 : _g.toLowerCase();
+      if (clientInput.quizContext?.originalCategory) {
+        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
         const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
         if (verifiedCategory && verifiedCategory !== requiredCategory) {
           throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
@@ -741,13 +708,13 @@ async function generateMCQQuestion(clientInput, apiKey) {
         correctAnswerId: finalCorrectAnswerId,
         explanation: aiGeneratedContent.explanation,
         points: aiGeneratedContent.points,
-        topic: aiGeneratedContent.topic || ((_h = clientInput.quizContext) == null ? void 0 : _h.originalTopic),
+        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
         difficulty: clientInput.difficulty,
-        contextCode: (_i = clientInput.quizContext) == null ? void 0 : _i.plannedContextId,
-        bloomLevel: (_j = clientInput.quizContext) == null ? void 0 : _j.plannedBloomLevel,
-        learningObjective: (_k = clientInput.quizContext) == null ? void 0 : _k.originalLoId,
-        subject: (_l = clientInput.quizContext) == null ? void 0 : _l.originalSubject,
-        category: (_m = clientInput.quizContext) == null ? void 0 : _m.originalCategory,
+        contextCode: clientInput.quizContext?.plannedContextId,
+        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
+        learningObjective: clientInput.quizContext?.originalLoId,
+        subject: clientInput.quizContext?.originalSubject,
+        category: clientInput.quizContext?.originalCategory,
         imageUrl: clientInput.imageUrl
       };
       const validatedQuestion = MultipleChoiceQuestionZodSchema.parse(completeQuestion);
@@ -769,7 +736,7 @@ async function generateMCQQuestion(clientInput, apiKey) {
     }
   }
   DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate MCQ question after ${MAX_RETRY_ATTEMPTS3} attempts. Last error: ${lastError == null ? void 0 : lastError.message}`;
+  const errorMessage = `Failed to generate MCQ question after ${MAX_RETRY_ATTEMPTS3} attempts. Last error: ${lastError?.message}`;
   console.error("\n\u274C Final Result: FAILED");
   console.error(errorMessage);
   return { error: errorMessage };
@@ -795,7 +762,7 @@ var MAX_RETRY_ATTEMPTS4 = 3;
 var RETRY_DELAY_MS4 = 3e3;
 function buildEnhancedPrompt4(clientInput, attemptNumber) {
   const { quizContext, language, difficulty, numberOfOptions, minCorrectAnswers, maxCorrectAnswers, imageUrl } = clientInput;
-  const category = (quizContext == null ? void 0 : quizContext.originalCategory) || "the specified technical category";
+  const category = quizContext?.originalCategory || "the specified technical category";
   const attemptInfo = attemptNumber > 1 ? `
 ## DEBUG INFO - This is attempt #${attemptNumber}
 Previous attempts failed due to validation errors. Pay close attention to the number of correct answers and the JSON schema.
@@ -804,11 +771,11 @@ Previous attempts failed due to validation errors. Pay close attention to the nu
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The question and options must be directly related to the content of this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category} (This is the ONLY language to be used)`,
-    (quizContext == null ? void 0 : quizContext.loDescription) && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
     imageContextInstruction,
-    (quizContext == null ? void 0 : quizContext.plannedBloomLevel) && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
-    (quizContext == null ? void 0 : quizContext.targetMisconception) && `**Target Misconception:** Use this to create plausible incorrect answers (distractors). The misconception is: "${quizContext.targetMisconception}"`,
-    (quizContext == null ? void 0 : quizContext.difficultyReason) && `**Pedagogical Reason:** ${quizContext.difficultyReason}`
+    quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
+    quizContext?.targetMisconception && `**Target Misconception:** Use this to create plausible incorrect answers (distractors). The misconception is: "${quizContext.targetMisconception}"`,
+    quizContext?.difficultyReason && `**Pedagogical Reason:** ${quizContext.difficultyReason}`
   ].filter(Boolean).map((s) => `- ${s}`).join("\n");
   const exampleJson = JSON.stringify({
     prompt: "Which of the following are considered programming paradigms?",
@@ -841,7 +808,7 @@ ${contextStrings}
 Based on all the rules and context above, generate a single Multiple Response Question.
 
 ### Input Parameters
-- **Topic for Question:** ${(quizContext == null ? void 0 : quizContext.plannedTopic) || "General"}
+- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
 - **Language for Text:** ${language}
 - **Difficulty Level:** ${difficulty}
 - **Number of Options:** Generate exactly ${numberOfOptions} options.
@@ -855,7 +822,6 @@ ${exampleJson}
 Now, generate the JSON for the requested question.`;
 }
 async function generateMRQQuestion(clientInput, apiKey) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
   if (clientInput.minCorrectAnswers > clientInput.maxCorrectAnswers) {
     return { error: `Invalid input: minCorrectAnswers (${clientInput.minCorrectAnswers}) cannot be greater than maxCorrectAnswers (${clientInput.maxCorrectAnswers}).` };
   }
@@ -878,7 +844,7 @@ async function generateMRQQuestion(clientInput, apiKey) {
     const promptText = buildEnhancedPrompt4(clientInput, attempt);
     const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
     try {
-      DebugLogger.logPrompt(attempt, promptText, __spreadProps(__spreadValues({}, clientInput), { attemptNumber: attempt, promptHash }));
+      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
       const parts = [{ text: promptText }];
       if (clientInput.imageUrl) {
         const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
@@ -892,7 +858,7 @@ async function generateMRQQuestion(clientInput, apiKey) {
         contents
       });
       const response = aiResult;
-      const rawText = ((_e = (_d = (_c = (_b = (_a = response.candidates) == null ? void 0 : _a[0]) == null ? void 0 : _b.content) == null ? void 0 : _c.parts) == null ? void 0 : _d[0]) == null ? void 0 : _e.text) || "";
+      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
       const duration = Date.now() - startTime;
       DebugLogger.logResponse(attempt, rawText);
       if (!rawText) {
@@ -909,8 +875,8 @@ async function generateMRQQuestion(clientInput, apiKey) {
       if (correctCount < clientInput.minCorrectAnswers || correctCount > clientInput.maxCorrectAnswers) {
         throw new Error(`AI provided ${correctCount} correct answers, which is outside the required range of ${clientInput.minCorrectAnswers}-${clientInput.maxCorrectAnswers}.`);
       }
-      if ((_f = clientInput.quizContext) == null ? void 0 : _f.originalCategory) {
-        const verifiedCategory = (_g = aiGeneratedContent.verifiedCategory) == null ? void 0 : _g.toLowerCase();
+      if (clientInput.quizContext?.originalCategory) {
+        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
         const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
         if (verifiedCategory && verifiedCategory !== requiredCategory) {
           throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
@@ -939,13 +905,13 @@ async function generateMRQQuestion(clientInput, apiKey) {
         correctAnswerIds: finalCorrectAnswerIds,
         explanation: aiGeneratedContent.explanation,
         points: aiGeneratedContent.points,
-        topic: aiGeneratedContent.topic || ((_h = clientInput.quizContext) == null ? void 0 : _h.originalTopic),
+        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
         difficulty: aiGeneratedContent.difficulty || clientInput.difficulty,
-        contextCode: (_i = clientInput.quizContext) == null ? void 0 : _i.plannedContextId,
-        bloomLevel: (_j = clientInput.quizContext) == null ? void 0 : _j.plannedBloomLevel,
-        learningObjective: (_k = clientInput.quizContext) == null ? void 0 : _k.originalLoId,
-        subject: (_l = clientInput.quizContext) == null ? void 0 : _l.originalSubject,
-        category: (_m = clientInput.quizContext) == null ? void 0 : _m.originalCategory,
+        contextCode: clientInput.quizContext?.plannedContextId,
+        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
+        learningObjective: clientInput.quizContext?.originalLoId,
+        subject: clientInput.quizContext?.originalSubject,
+        category: clientInput.quizContext?.originalCategory,
         imageUrl: clientInput.imageUrl
       };
       const validatedQuestion = MultipleResponseQuestionZodSchema.parse(completeQuestion);
@@ -967,7 +933,7 @@ async function generateMRQQuestion(clientInput, apiKey) {
     }
   }
   DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate MRQ question after ${MAX_RETRY_ATTEMPTS4} attempts. Last error: ${lastError == null ? void 0 : lastError.message}`;
+  const errorMessage = `Failed to generate MRQ question after ${MAX_RETRY_ATTEMPTS4} attempts. Last error: ${lastError?.message}`;
   console.error("\n\u274C Final Result: FAILED");
   console.error(errorMessage);
   return { error: errorMessage };
@@ -997,7 +963,7 @@ var MAX_RETRY_ATTEMPTS5 = 3;
 var RETRY_DELAY_MS5 = 3e3;
 function buildEnhancedPrompt5(clientInput, attemptNumber) {
   const { quizContext, language, difficulty, minRange, maxRange, allowDecimals, imageUrl } = clientInput;
-  const category = (quizContext == null ? void 0 : quizContext.originalCategory) || "the specified technical category";
+  const category = quizContext?.originalCategory || "the specified technical category";
   const attemptInfo = attemptNumber > 1 ? `
 ## DEBUG INFO - This is attempt #${attemptNumber}
 Previous attempts failed. Ensure the 'answer' is a valid number and fits within the specified constraints.
@@ -1006,10 +972,10 @@ Previous attempts failed. Ensure the 'answer' is a valid number and fits within
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The question and its numerical answer must be directly related to the content of this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    (quizContext == null ? void 0 : quizContext.loDescription) && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
     imageContextInstruction,
-    (quizContext == null ? void 0 : quizContext.plannedBloomLevel) && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
-    (quizContext == null ? void 0 : quizContext.targetMisconception) && `**Target Misconception:** The question should clarify this numerical error: "${quizContext.targetMisconception}"`
+    quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
+    quizContext?.targetMisconception && `**Target Misconception:** The question should clarify this numerical error: "${quizContext.targetMisconception}"`
   ].filter(Boolean).map((s) => `- ${s}`).join("\n");
   const constraintStrings = [
     minRange !== void 0 && `The final 'answer' MUST be greater than or equal to ${minRange}.`,
@@ -1041,7 +1007,7 @@ ${contextStrings}
 Based on all the rules and context above, generate a single Numeric Question.
 
 ### Input Parameters & Constraints
-- **Topic for Question:** ${(quizContext == null ? void 0 : quizContext.plannedTopic) || "General"}
+- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
 - **Language for Text:** ${language}
 - **Difficulty Level:** ${difficulty}
 ${constraintStrings ? `
@@ -1056,7 +1022,6 @@ ${exampleJson}
 Now, generate the JSON for the requested question.`;
 }
 async function generateNumericQuestion(clientInput, apiKey) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o;
   if (clientInput.minRange !== void 0 && clientInput.maxRange !== void 0 && clientInput.minRange > clientInput.maxRange) {
     return { error: `Invalid input: minRange (${clientInput.minRange}) cannot be greater than maxRange (${clientInput.maxRange}).` };
   }
@@ -1077,7 +1042,7 @@ async function generateNumericQuestion(clientInput, apiKey) {
     const promptText = buildEnhancedPrompt5(clientInput, attempt);
     const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
     try {
-      DebugLogger.logPrompt(attempt, promptText, __spreadProps(__spreadValues({}, clientInput), { attemptNumber: attempt, promptHash }));
+      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
       const parts = [{ text: promptText }];
       if (clientInput.imageUrl) {
         const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
@@ -1087,7 +1052,7 @@ async function generateNumericQuestion(clientInput, apiKey) {
       const contents = [{ role: "user", parts }];
       const aiResult = await ai.models.generateContent({ model, config, contents });
       const response = aiResult;
-      const rawText = ((_e = (_d = (_c = (_b = (_a = response.candidates) == null ? void 0 : _a[0]) == null ? void 0 : _b.content) == null ? void 0 : _c.parts) == null ? void 0 : _d[0]) == null ? void 0 : _e.text) || "";
+      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
       const duration = Date.now() - startTime;
       DebugLogger.logResponse(attempt, rawText);
       if (!rawText) throw new Error("AI returned an empty response.");
@@ -1105,8 +1070,8 @@ async function generateNumericQuestion(clientInput, apiKey) {
       if (!clientInput.allowDecimals && !Number.isInteger(answer)) {
         throw new Error(`AI answer ${answer} is not an integer, but decimals are not allowed.`);
       }
-      if ((_f = clientInput.quizContext) == null ? void 0 : _f.originalCategory) {
-        const verifiedCategory = (_g = aiGeneratedContent.verifiedCategory) == null ? void 0 : _g.toLowerCase();
+      if (clientInput.quizContext?.originalCategory) {
+        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
         const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
         if (verifiedCategory && verifiedCategory !== requiredCategory) {
           throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
@@ -1117,16 +1082,16 @@ async function generateNumericQuestion(clientInput, apiKey) {
         questionType: "numeric",
         prompt: aiGeneratedContent.prompt,
         answer: aiGeneratedContent.answer,
-        tolerance: (_i = (_h = clientInput.tolerance) != null ? _h : aiGeneratedContent.tolerance) != null ? _i : 0,
+        tolerance: clientInput.tolerance ?? aiGeneratedContent.tolerance ?? 0,
         explanation: aiGeneratedContent.explanation,
         points: aiGeneratedContent.points,
-        topic: aiGeneratedContent.topic || ((_j = clientInput.quizContext) == null ? void 0 : _j.originalTopic),
+        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
         difficulty: clientInput.difficulty,
-        contextCode: (_k = clientInput.quizContext) == null ? void 0 : _k.plannedContextId,
-        bloomLevel: (_l = clientInput.quizContext) == null ? void 0 : _l.plannedBloomLevel,
-        learningObjective: (_m = clientInput.quizContext) == null ? void 0 : _m.originalLoId,
-        subject: (_n = clientInput.quizContext) == null ? void 0 : _n.originalSubject,
-        category: (_o = clientInput.quizContext) == null ? void 0 : _o.originalCategory,
+        contextCode: clientInput.quizContext?.plannedContextId,
+        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
+        learningObjective: clientInput.quizContext?.originalLoId,
+        subject: clientInput.quizContext?.originalSubject,
+        category: clientInput.quizContext?.originalCategory,
         imageUrl: clientInput.imageUrl
       };
       const validatedQuestion = NumericQuestionZodSchema.parse(completeQuestion);
@@ -1148,7 +1113,7 @@ async function generateNumericQuestion(clientInput, apiKey) {
     }
   }
   DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate Numeric question after ${MAX_RETRY_ATTEMPTS5} attempts. Last error: ${lastError == null ? void 0 : lastError.message}`;
+  const errorMessage = `Failed to generate Numeric question after ${MAX_RETRY_ATTEMPTS5} attempts. Last error: ${lastError?.message}`;
   console.error("\n\u274C Final Result: FAILED");
   console.error(errorMessage);
   return { error: errorMessage };
@@ -1174,7 +1139,7 @@ var MAX_RETRY_ATTEMPTS6 = 3;
 var RETRY_DELAY_MS6 = 3e3;
 function buildEnhancedPrompt6(clientInput, attemptNumber) {
   const { quizContext, language, difficulty, numberOfItems, imageUrl } = clientInput;
-  const category = (quizContext == null ? void 0 : quizContext.originalCategory) || "the specified technical category";
+  const category = quizContext?.originalCategory || "the specified technical category";
   const attemptInfo = attemptNumber > 1 ? `
 ## DEBUG INFO - This is attempt #${attemptNumber}
 Previous attempts failed. Ensure the 'itemsInCorrectOrder' array has exactly the required number of items and the JSON is valid.
@@ -1183,10 +1148,10 @@ Previous attempts failed. Ensure the 'itemsInCorrectOrder' array has exactly the
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The sequence of items must be directly related to the process or content shown in this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    (quizContext == null ? void 0 : quizContext.loDescription) && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
     imageContextInstruction,
-    (quizContext == null ? void 0 : quizContext.plannedBloomLevel) && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
-    (quizContext == null ? void 0 : quizContext.targetMisconception) && `**Target Misconception:** The sequence should clarify this specific process error: "${quizContext.targetMisconception}"`
+    quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
+    quizContext?.targetMisconception && `**Target Misconception:** The sequence should clarify this specific process error: "${quizContext.targetMisconception}"`
   ].filter(Boolean).map((s) => `- ${s}`).join("\n");
   const exampleJson = JSON.stringify({
     prompt: "Arrange the steps to make a network request in Swift using URLSession.",
@@ -1217,7 +1182,7 @@ ${contextStrings}
 Based on all the rules and context above, generate a single Sequence Question.
 
 ### Input Parameters
-- **Topic for Question:** ${(quizContext == null ? void 0 : quizContext.plannedTopic) || "General"}
+- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
 - **Language for Text:** ${language}
 - **Difficulty Level:** ${difficulty}
 - **Number of Items:** Generate an array 'itemsInCorrectOrder' containing exactly ${numberOfItems} items. The array itself MUST be in the correct final sequence.
@@ -1230,7 +1195,6 @@ ${exampleJson}
 Now, generate the JSON for the requested question.`;
 }
 async function generateSequenceQuestion(clientInput, apiKey) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
   const ai = new genai.GoogleGenAI({ apiKey });
   const model = "gemini-2.5-flash";
   const config = {
@@ -1247,7 +1211,7 @@ async function generateSequenceQuestion(clientInput, apiKey) {
     const promptText = buildEnhancedPrompt6(clientInput, attempt);
     const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
     try {
-      DebugLogger.logPrompt(attempt, promptText, __spreadProps(__spreadValues({}, clientInput), { attemptNumber: attempt, promptHash }));
+      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
       const parts = [{ text: promptText }];
       if (clientInput.imageUrl) {
         const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
@@ -1257,7 +1221,7 @@ async function generateSequenceQuestion(clientInput, apiKey) {
       const contents = [{ role: "user", parts }];
       const aiResult = await ai.models.generateContent({ model, config, contents });
       const response = aiResult;
-      const rawText = ((_e = (_d = (_c = (_b = (_a = response.candidates) == null ? void 0 : _a[0]) == null ? void 0 : _b.content) == null ? void 0 : _c.parts) == null ? void 0 : _d[0]) == null ? void 0 : _e.text) || "";
+      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
       const duration = Date.now() - startTime;
       DebugLogger.logResponse(attempt, rawText);
       if (!rawText) throw new Error("AI returned an empty response.");
@@ -1268,8 +1232,8 @@ async function generateSequenceQuestion(clientInput, apiKey) {
       if (aiGeneratedContent.itemsInCorrectOrder.length !== clientInput.numberOfItems) {
         throw new Error(`AI generated ${aiGeneratedContent.itemsInCorrectOrder.length} items, but ${clientInput.numberOfItems} were required.`);
       }
-      if ((_f = clientInput.quizContext) == null ? void 0 : _f.originalCategory) {
-        const verifiedCategory = (_g = aiGeneratedContent.verifiedCategory) == null ? void 0 : _g.toLowerCase();
+      if (clientInput.quizContext?.originalCategory) {
+        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
         const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
         if (verifiedCategory && verifiedCategory !== requiredCategory) {
           throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
@@ -1290,13 +1254,13 @@ async function generateSequenceQuestion(clientInput, apiKey) {
         correctOrder: finalCorrectOrder,
         explanation: aiGeneratedContent.explanation,
         points: aiGeneratedContent.points,
-        topic: aiGeneratedContent.topic || ((_h = clientInput.quizContext) == null ? void 0 : _h.originalTopic),
+        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
         difficulty: clientInput.difficulty,
-        contextCode: (_i = clientInput.quizContext) == null ? void 0 : _i.plannedContextId,
-        bloomLevel: (_j = clientInput.quizContext) == null ? void 0 : _j.plannedBloomLevel,
-        learningObjective: (_k = clientInput.quizContext) == null ? void 0 : _k.originalLoId,
-        subject: (_l = clientInput.quizContext) == null ? void 0 : _l.originalSubject,
-        category: (_m = clientInput.quizContext) == null ? void 0 : _m.originalCategory,
+        contextCode: clientInput.quizContext?.plannedContextId,
+        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
+        learningObjective: clientInput.quizContext?.originalLoId,
+        subject: clientInput.quizContext?.originalSubject,
+        category: clientInput.quizContext?.originalCategory,
         imageUrl: clientInput.imageUrl
       };
       const validatedQuestion = SequenceQuestionZodSchema.parse(completeQuestion);
@@ -1318,7 +1282,7 @@ async function generateSequenceQuestion(clientInput, apiKey) {
     }
   }
   DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate Sequence question after ${MAX_RETRY_ATTEMPTS6} attempts. Last error: ${lastError == null ? void 0 : lastError.message}`;
+  const errorMessage = `Failed to generate Sequence question after ${MAX_RETRY_ATTEMPTS6} attempts. Last error: ${lastError?.message}`;
   console.error("\n\u274C Final Result: FAILED");
   console.error(errorMessage);
   return { error: errorMessage };
@@ -1343,7 +1307,7 @@ var MAX_RETRY_ATTEMPTS7 = 3;
 var RETRY_DELAY_MS7 = 3e3;
 function buildEnhancedPrompt7(clientInput, attemptNumber) {
   const { quizContext, language, difficulty, imageUrl } = clientInput;
-  const category = (quizContext == null ? void 0 : quizContext.originalCategory) || "the specified technical category";
+  const category = quizContext?.originalCategory || "the specified technical category";
   const attemptInfo = attemptNumber > 1 ? `
 ## DEBUG INFO - This is attempt #${attemptNumber}
 Previous attempts failed. Ensure 'acceptedAnswers' is a non-empty array of strings and the JSON is valid.
@@ -1352,10 +1316,10 @@ Previous attempts failed. Ensure 'acceptedAnswers' is a non-empty array of strin
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The question and its short answer must be directly related to the content of this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    (quizContext == null ? void 0 : quizContext.loDescription) && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
     imageContextInstruction,
-    (quizContext == null ? void 0 : quizContext.plannedBloomLevel) && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
-    (quizContext == null ? void 0 : quizContext.targetMisconception) && `**Target Misconception:** The question should require an answer that corrects this specific misconception: "${quizContext.targetMisconception}"`
+    quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
+    quizContext?.targetMisconception && `**Target Misconception:** The question should require an answer that corrects this specific misconception: "${quizContext.targetMisconception}"`
   ].filter(Boolean).map((s) => `- ${s}`).join("\n");
   const exampleJson = JSON.stringify({
     prompt: "In Swift, what keyword is used to declare a constant?",
@@ -1381,7 +1345,7 @@ ${contextStrings}
 Based on all the rules and context above, generate a single Short Answer Question.
 
 ### Input Parameters
-- **Topic for Question:** ${(quizContext == null ? void 0 : quizContext.plannedTopic) || "General"}
+- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
 - **Language for Text:** ${language}
 - **Difficulty Level:** ${difficulty}
 
@@ -1393,7 +1357,6 @@ ${exampleJson}
 Now, generate the JSON for the requested question.`;
 }
 async function generateShortAnswerQuestion(clientInput, apiKey) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
   const ai = new genai.GoogleGenAI({ apiKey });
   const model = "gemini-2.5-flash";
   const config = {
@@ -1410,7 +1373,7 @@ async function generateShortAnswerQuestion(clientInput, apiKey) {
     const promptText = buildEnhancedPrompt7(clientInput, attempt);
     const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
     try {
-      DebugLogger.logPrompt(attempt, promptText, __spreadProps(__spreadValues({}, clientInput), { attemptNumber: attempt, promptHash }));
+      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
       const parts = [{ text: promptText }];
       if (clientInput.imageUrl) {
         const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
@@ -1420,7 +1383,7 @@ async function generateShortAnswerQuestion(clientInput, apiKey) {
       const contents = [{ role: "user", parts }];
       const aiResult = await ai.models.generateContent({ model, config, contents });
       const response = aiResult;
-      const rawText = ((_e = (_d = (_c = (_b = (_a = response.candidates) == null ? void 0 : _a[0]) == null ? void 0 : _b.content) == null ? void 0 : _c.parts) == null ? void 0 : _d[0]) == null ? void 0 : _e.text) || "";
+      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
       const duration = Date.now() - startTime;
       DebugLogger.logResponse(attempt, rawText);
       if (!rawText) throw new Error("AI returned an empty response.");
@@ -1428,8 +1391,8 @@ async function generateShortAnswerQuestion(clientInput, apiKey) {
       DebugLogger.logValidation(attempt, "JSON Parsed Successfully", parsedJson);
       const aiGeneratedContent = AIShortAnswerOutputFieldsSchema.parse(parsedJson);
       DebugLogger.logValidation(attempt, "Zod Schema Validated", aiGeneratedContent);
-      if ((_f = clientInput.quizContext) == null ? void 0 : _f.originalCategory) {
-        const verifiedCategory = (_g = aiGeneratedContent.verifiedCategory) == null ? void 0 : _g.toLowerCase();
+      if (clientInput.quizContext?.originalCategory) {
+        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
         const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
         if (verifiedCategory && verifiedCategory !== requiredCategory) {
           throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
@@ -1443,13 +1406,13 @@ async function generateShortAnswerQuestion(clientInput, apiKey) {
         isCaseSensitive: clientInput.isCaseSensitive,
         explanation: aiGeneratedContent.explanation,
         points: aiGeneratedContent.points,
-        topic: aiGeneratedContent.topic || ((_h = clientInput.quizContext) == null ? void 0 : _h.originalTopic),
+        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
         difficulty: clientInput.difficulty,
-        contextCode: (_i = clientInput.quizContext) == null ? void 0 : _i.plannedContextId,
-        bloomLevel: (_j = clientInput.quizContext) == null ? void 0 : _j.plannedBloomLevel,
-        learningObjective: (_k = clientInput.quizContext) == null ? void 0 : _k.originalLoId,
-        subject: (_l = clientInput.quizContext) == null ? void 0 : _l.originalSubject,
-        category: (_m = clientInput.quizContext) == null ? void 0 : _m.originalCategory,
+        contextCode: clientInput.quizContext?.plannedContextId,
+        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
+        learningObjective: clientInput.quizContext?.originalLoId,
+        subject: clientInput.quizContext?.originalSubject,
+        category: clientInput.quizContext?.originalCategory,
         imageUrl: clientInput.imageUrl
       };
       const validatedQuestion = ShortAnswerQuestionZodSchema.parse(completeQuestion);
@@ -1471,7 +1434,7 @@ async function generateShortAnswerQuestion(clientInput, apiKey) {
     }
   }
   DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate Short Answer question after ${MAX_RETRY_ATTEMPTS7} attempts. Last error: ${lastError == null ? void 0 : lastError.message}`;
+  const errorMessage = `Failed to generate Short Answer question after ${MAX_RETRY_ATTEMPTS7} attempts. Last error: ${lastError?.message}`;
   console.error("\n\u274C Final Result: FAILED");
   console.error(errorMessage);
   return { error: errorMessage };
@@ -1493,21 +1456,21 @@ var MAX_RETRY_ATTEMPTS8 = 3;
 var RETRY_DELAY_MS8 = 3e3;
 function buildEnhancedPrompt8(clientInput, attemptNumber) {
   const { quizContext, language, difficulty, imageUrl } = clientInput;
-  const category = (quizContext == null ? void 0 : quizContext.originalCategory) || "the specified technical category";
+  const category = quizContext?.originalCategory || "the specified technical category";
   const attemptInfo = attemptNumber > 1 ? `
 ## DEBUG INFO - This is attempt #${attemptNumber}
 Previous attempts failed. Ensure the JSON is valid and 'correctAnswer' is a boolean.
 
 ` : "";
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The True/False statement must be directly related to the content of this image.` : "";
-  const misconceptionGuidance = (quizContext == null ? void 0 : quizContext.targetMisconception) ? `**Target Misconception:** The statement you create MUST be FALSE and based on this common mistake: "${quizContext.targetMisconception}"` : "";
+  const misconceptionGuidance = quizContext?.targetMisconception ? `**Target Misconception:** The statement you create MUST be FALSE and based on this common mistake: "${quizContext.targetMisconception}"` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    (quizContext == null ? void 0 : quizContext.loDescription) && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
     imageContextInstruction,
-    (quizContext == null ? void 0 : quizContext.plannedBloomLevel) && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
+    quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
     misconceptionGuidance,
-    (quizContext == null ? void 0 : quizContext.difficultyReason) && `**Pedagogical Reason:** ${quizContext.difficultyReason}`
+    quizContext?.difficultyReason && `**Pedagogical Reason:** ${quizContext.difficultyReason}`
   ].filter(Boolean).map((s) => `- ${s}`).join("\n");
   const exampleJson = JSON.stringify({
     prompt: "In Swift, you must explicitly unwrap an Optional value before you can use its stored value.",
@@ -1534,7 +1497,7 @@ ${contextStrings}
 Based on all the rules and context above, generate a single True/False Question.
 
 ### Input Parameters
-- **Topic for Question:** ${(quizContext == null ? void 0 : quizContext.plannedTopic) || "General"}
+- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
 - **Language for Text:** ${language}
 - **Difficulty Level:** ${difficulty}
 
@@ -1546,7 +1509,6 @@ ${exampleJson}
 Now, generate the JSON for the requested question.`;
 }
 async function generateTrueFalseQuestion(clientInput, apiKey) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
   const ai = new genai.GoogleGenAI({ apiKey });
   const model = "gemini-2.5-flash";
   const config = {
@@ -1563,7 +1525,7 @@ async function generateTrueFalseQuestion(clientInput, apiKey) {
     const promptText = buildEnhancedPrompt8(clientInput, attempt);
     const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
     try {
-      DebugLogger.logPrompt(attempt, promptText, __spreadProps(__spreadValues({}, clientInput), { attemptNumber: attempt, promptHash }));
+      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
       const parts = [{ text: promptText }];
       if (clientInput.imageUrl) {
         const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
@@ -1573,7 +1535,7 @@ async function generateTrueFalseQuestion(clientInput, apiKey) {
       const contents = [{ role: "user", parts }];
       const aiResult = await ai.models.generateContent({ model, config, contents });
       const response = aiResult;
-      const rawText = ((_e = (_d = (_c = (_b = (_a = response.candidates) == null ? void 0 : _a[0]) == null ? void 0 : _b.content) == null ? void 0 : _c.parts) == null ? void 0 : _d[0]) == null ? void 0 : _e.text) || "";
+      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
       const duration = Date.now() - startTime;
       DebugLogger.logResponse(attempt, rawText);
       if (!rawText) throw new Error("AI returned an empty response.");
@@ -1581,11 +1543,11 @@ async function generateTrueFalseQuestion(clientInput, apiKey) {
       DebugLogger.logValidation(attempt, "JSON Parsed Successfully", parsedJson);
       const aiGeneratedContent = AITrueFalseOutputFieldsSchema.parse(parsedJson);
       DebugLogger.logValidation(attempt, "Zod Schema Validated", aiGeneratedContent);
-      if (((_f = clientInput.quizContext) == null ? void 0 : _f.targetMisconception) && aiGeneratedContent.correctAnswer === true) {
+      if (clientInput.quizContext?.targetMisconception && aiGeneratedContent.correctAnswer === true) {
         throw new Error("AI failed to follow the Misconception Priority rule. The answer should have been false.");
       }
-      if ((_g = clientInput.quizContext) == null ? void 0 : _g.originalCategory) {
-        const verifiedCategory = (_h = aiGeneratedContent.verifiedCategory) == null ? void 0 : _h.toLowerCase();
+      if (clientInput.quizContext?.originalCategory) {
+        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
         const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
         if (verifiedCategory && verifiedCategory !== requiredCategory) {
           throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
@@ -1598,13 +1560,13 @@ async function generateTrueFalseQuestion(clientInput, apiKey) {
         correctAnswer: aiGeneratedContent.correctAnswer,
         explanation: aiGeneratedContent.explanation,
         points: aiGeneratedContent.points,
-        topic: aiGeneratedContent.topic || ((_i = clientInput.quizContext) == null ? void 0 : _i.originalTopic),
+        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
         difficulty: clientInput.difficulty,
-        contextCode: (_j = clientInput.quizContext) == null ? void 0 : _j.plannedContextId,
-        bloomLevel: (_k = clientInput.quizContext) == null ? void 0 : _k.plannedBloomLevel,
-        learningObjective: (_l = clientInput.quizContext) == null ? void 0 : _l.originalLoId,
-        subject: (_m = clientInput.quizContext) == null ? void 0 : _m.originalSubject,
-        category: (_n = clientInput.quizContext) == null ? void 0 : _n.originalCategory,
+        contextCode: clientInput.quizContext?.plannedContextId,
+        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
+        learningObjective: clientInput.quizContext?.originalLoId,
+        subject: clientInput.quizContext?.originalSubject,
+        category: clientInput.quizContext?.originalCategory,
         imageUrl: clientInput.imageUrl
       };
       const validatedQuestion = TrueFalseQuestionZodSchema.parse(completeQuestion);
@@ -1626,7 +1588,7 @@ async function generateTrueFalseQuestion(clientInput, apiKey) {
     }
   }
   DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate True/False question after ${MAX_RETRY_ATTEMPTS8} attempts. Last error: ${lastError == null ? void 0 : lastError.message}`;
+  const errorMessage = `Failed to generate True/False question after ${MAX_RETRY_ATTEMPTS8} attempts. Last error: ${lastError?.message}`;
   console.error("\n\u274C Final Result: FAILED");
   console.error(errorMessage);
   return { error: errorMessage };
@@ -1674,10 +1636,10 @@ var JsonRepairEngine = class {
       if (breakIndex !== -1) {
         const stringContent = afterUnterminated.substring(0, breakIndex);
         const remainder = afterUnterminated.substring(breakIndex);
-        const escapedContent = stringContent.replace(new RegExp('(?<!\\\\)"', "g"), '\\"');
+        const escapedContent = stringContent.replace(/(?<!\\)"/g, '\\"');
         repaired = beforeUnterminated + escapedContent + '"' + remainder;
       } else {
-        const escapedContent = afterUnterminated.replace(new RegExp('(?<!\\\\)"', "g"), '\\"');
+        const escapedContent = afterUnterminated.replace(/(?<!\\)"/g, '\\"');
         repaired = beforeUnterminated + escapedContent + '"';
       }
     }
@@ -1753,7 +1715,6 @@ var JsonRepairEngine = class {
    * Main repair function that attempts multiple strategies.
    */
   static repairJson(jsonStr) {
-    var _a;
     let current = jsonStr.trim();
     const maxAttempts = 5;
     let lastError = "";
@@ -1783,7 +1744,7 @@ var JsonRepairEngine = class {
       }
       lastError = validation.error || "";
       lastPosition = validation.position;
-      if ((_a = validation.error) == null ? void 0 : _a.includes("Unterminated string")) {
+      if (validation.error?.includes("Unterminated string")) {
         current = this.repairUnterminatedStrings(current);
       } else {
         current = this.applyCommonFixes(current);
@@ -2115,7 +2076,6 @@ ENHANCED DIVERSITY & QUALITY ASSURANCE RULES:
 `;
 }
 async function generateQuizPlan(clientInput, apiKey, imageContexts = []) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
   const logger = new QuizPlanLogger();
   try {
     logger.log("VALIDATION_START", {
@@ -2251,10 +2211,7 @@ Execute this plan with pedagogical precision. The quiz should feel like a carefu
     logger.log("PROMPT_PREPARATION", {
       promptLength: enhancedPromptText.length,
       topicCount: clientInput.topics.length,
-      misconceptionCount: clientInput.topics.reduce((sum, t) => {
-        var _a2;
-        return sum + (((_a2 = t.commonMisconceptions) == null ? void 0 : _a2.length) || 0);
-      }, 0)
+      misconceptionCount: clientInput.topics.reduce((sum, t) => sum + (t.commonMisconceptions?.length || 0), 0)
     }, Date.now() - promptStartTime);
     const generationStartTime = Date.now();
     const contents = [
@@ -2275,11 +2232,11 @@ Execute this plan with pedagogical precision. The quiz should feel like a carefu
     const response = aiResult;
     const generationDuration = Date.now() - generationStartTime;
     logger.log("AI_GENERATION", {
-      responseLength: ((_f = (_e = (_d = (_c = (_b = (_a = response.candidates) == null ? void 0 : _a[0]) == null ? void 0 : _b.content) == null ? void 0 : _c.parts) == null ? void 0 : _d[0]) == null ? void 0 : _e.text) == null ? void 0 : _f.length) || 0,
+      responseLength: response.candidates?.[0]?.content?.parts?.[0]?.text?.length || 0,
       duration: generationDuration
     }, generationDuration);
     const processingStartTime = Date.now();
-    const rawText = ((_k = (_j = (_i = (_h = (_g = response.candidates) == null ? void 0 : _g[0]) == null ? void 0 : _h.content) == null ? void 0 : _i.parts) == null ? void 0 : _j[0]) == null ? void 0 : _k.text) || "";
+    const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
     let jsonText = rawText;
     if (!rawText.trim().startsWith("{") && !rawText.trim().startsWith("[")) {
       jsonText = extractJsonFromMarkdown(rawText);
@@ -2312,11 +2269,12 @@ Execute this plan with pedagogical precision. The quiz should feel like a carefu
       questionCount: aiGeneratedContent.quizPlan.length,
       codingQuestionCount: codingQuestions.length,
       maxConsecutiveType: diversityAnalysis.maxConsecutive,
-      questionTypeDistribution: ((_l = aiGeneratedContent.diversityMetrics) == null ? void 0 : _l.questionTypeDistribution) || {}
+      questionTypeDistribution: aiGeneratedContent.diversityMetrics?.questionTypeDistribution || {}
     }, Date.now() - validationStartTime);
-    const finalResult = __spreadProps(__spreadValues({}, aiGeneratedContent), {
+    const finalResult = {
+      ...aiGeneratedContent,
       logs: logger.getLogs()
-    });
+    };
     logger.log("GENERATION_COMPLETE", {
       totalDuration: logger.getTotalDuration(),
       success: true,
@@ -2325,8 +2283,8 @@ Execute this plan with pedagogical precision. The quiz should feel like a carefu
     console.log("\n=== QUIZ PLAN GENERATION SUMMARY ===");
     console.log(`\u2705 Successfully generated ${finalResult.quizPlan.length} questions`);
     console.log(`\u23F1\uFE0F Total generation time: ${logger.getTotalDuration()}ms`);
-    console.log(`\u{1F3AF} Question types: ${Object.keys(((_m = finalResult.diversityMetrics) == null ? void 0 : _m.questionTypeDistribution) || {}).join(", ")}`);
-    console.log(`\u{1F9E0} Bloom levels: ${Object.keys(((_n = finalResult.diversityMetrics) == null ? void 0 : _n.bloomLevelDistribution) || {}).join(", ")}`);
+    console.log(`\u{1F3AF} Question types: ${Object.keys(finalResult.diversityMetrics?.questionTypeDistribution || {}).join(", ")}`);
+    console.log(`\u{1F9E0} Bloom levels: ${Object.keys(finalResult.diversityMetrics?.bloomLevelDistribution || {}).join(", ")}`);
     if (numCodingQuestions > 0) {
       console.log(`\u{1F4BB} Coding questions: ${codingQuestions.length}/${numCodingQuestions} required`);
     }
@@ -2345,12 +2303,11 @@ Execute this plan with pedagogical precision. The quiz should feel like a carefu
   }
 }
 function validateConsecutiveTypes(quizPlan) {
-  var _a, _b;
   let maxConsecutive = 1;
-  let maxType = ((_a = quizPlan[0]) == null ? void 0 : _a.plannedQuestionType) || "";
+  let maxType = quizPlan[0]?.plannedQuestionType || "";
   let maxStartIndex = 0;
   let currentConsecutive = 1;
-  let currentType = ((_b = quizPlan[0]) == null ? void 0 : _b.plannedQuestionType) || "";
+  let currentType = quizPlan[0]?.plannedQuestionType || "";
   let currentStartIndex = 0;
   for (let i = 1; i < quizPlan.length; i++) {
     if (quizPlan[i].plannedQuestionType === currentType) {
@@ -2548,7 +2505,10 @@ var AICodingQuestionOutputSchema = zod.z.object({
   solutionCode: zod.z.string().describe("A complete, correct model solution in the specified language."),
   testCases: zod.z.array(zod.z.object({
     input: zod.z.array(zod.z.any()),
-    expectedOutput: zod.z.any().describe("The expected output for this test case - REQUIRED"),
+    // FIX: Use .refine to make it explicitly non-optional for TypeScript's inference
+    expectedOutput: zod.z.any().refine((val) => val !== void 0, {
+      message: "expectedOutput is required and cannot be undefined."
+    }),
     isPublic: zod.z.boolean()
   })).min(3, { message: "Must provide at least 3 test cases." }),
   verifiedCodingLanguage: zod.z.enum(["cpp", "javascript", "python", "swift", "csharp"]).optional().describe("The programming language this question actually addresses.")
@@ -2559,19 +2519,19 @@ var MAX_RETRY_ATTEMPTS9 = 3;
 var RETRY_DELAY_MS9 = 3e3;
 function buildEnhancedPrompt9(clientInput, attemptNumber) {
   const { quizContext, difficulty, codingLanguage, language, imageUrl } = clientInput;
-  const subject = (quizContext == null ? void 0 : quizContext.originalSubject) || codingLanguage;
+  const subject = quizContext?.originalSubject || codingLanguage;
   const attemptInfo = attemptNumber > 1 ? `
 ## DEBUG INFO - This is attempt #${attemptNumber}
-Previous attempts failed. Pay strict attention to the JSON schema and all rules.
+Previous attempts failed. Pay strict attention to the JSON schema and all rules. Ensure every object in the 'testCases' array has a non-null 'expectedOutput' field.
 
 ` : "";
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The coding problem must be directly related to processing or interpreting the content of this image.` : "";
   const contextStrings = [
     `**Subject:** ${subject}`,
-    (quizContext == null ? void 0 : quizContext.loDescription) && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
     imageContextInstruction,
-    (quizContext == null ? void 0 : quizContext.plannedBloomLevel) && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
-    (quizContext == null ? void 0 : quizContext.targetMisconception) && `**Target Misconception:** The problem should test against this common error: "${quizContext.targetMisconception}"`
+    quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
+    quizContext?.targetMisconception && `**Target Misconception:** The problem should test against this common error: "${quizContext.targetMisconception}"`
   ].filter(Boolean).map((s) => `- ${s}`).join("\n");
   const exampleJson = JSON.stringify({
     prompt: "Write a function named 'add' that takes two integers and returns their sum.",
@@ -2591,13 +2551,14 @@ Generate a single, high-quality Coding question.
 1.  **Language Purity:** All code ('functionSignature', 'solutionCode') MUST be in **${codingLanguage}**.
 2.  **Context Adherence:** The problem MUST be directly related to the provided context.
 3.  **Format Integrity:** You MUST return ONLY a single, valid JSON object.
+4.  **Test Case Integrity:** Every test case object in the 'testCases' array MUST have a non-null and defined 'expectedOutput' field. This is a critical rule.
 
 ## CRITICAL CONTEXT FOR THIS QUESTION
 ${contextStrings}
 
 ## Task: Generate the Question
 ### Input Parameters
-- **Topic for Question:** ${(quizContext == null ? void 0 : quizContext.plannedTopic) || "General"}
+- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
 - **Natural Language for Text:** ${language}
 - **Coding Language:** ${codingLanguage}
 - **Difficulty Level:** ${difficulty}
@@ -2610,7 +2571,6 @@ ${exampleJson}
 Now, generate the JSON for the requested question.`;
 }
 async function generateCodingQuestion(clientInput, apiKey) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
   const ai = new genai.GoogleGenAI({ apiKey });
   const model = "gemini-2.5-flash";
   const config = {
@@ -2627,7 +2587,7 @@ async function generateCodingQuestion(clientInput, apiKey) {
     const promptText = buildEnhancedPrompt9(clientInput, attempt);
     const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
     try {
-      DebugLogger.logPrompt(attempt, promptText, __spreadProps(__spreadValues({}, clientInput), { attemptNumber: attempt, promptHash }));
+      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
       const parts = [{ text: promptText }];
       if (clientInput.imageUrl) {
         const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
@@ -2637,7 +2597,7 @@ async function generateCodingQuestion(clientInput, apiKey) {
       const contents = [{ role: "user", parts }];
       const aiResult = await ai.models.generateContent({ model, config, contents });
       const response = aiResult;
-      const rawText = ((_e = (_d = (_c = (_b = (_a = response.candidates) == null ? void 0 : _a[0]) == null ? void 0 : _b.content) == null ? void 0 : _c.parts) == null ? void 0 : _d[0]) == null ? void 0 : _e.text) || "";
+      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
       const duration = Date.now() - startTime;
       DebugLogger.logResponse(attempt, rawText);
       if (!rawText) throw new Error("AI returned an empty response.");
@@ -2648,42 +2608,36 @@ async function generateCodingQuestion(clientInput, apiKey) {
       if (aiGeneratedContent.verifiedCodingLanguage && aiGeneratedContent.verifiedCodingLanguage !== clientInput.codingLanguage) {
         throw new Error(`Language mismatch: Required ${clientInput.codingLanguage}, but AI generated for ${aiGeneratedContent.verifiedCodingLanguage}.`);
       }
-      const testCases = aiGeneratedContent.testCases.map((tc) => {
-        if (tc.expectedOutput === void 0) {
-          throw new Error("A test case from AI is missing the required 'expectedOutput' field.");
-        }
-        return {
-          id: generateUniqueId("tc_"),
-          input: tc.input,
-          expectedOutput: tc.expectedOutput,
-          isPublic: tc.isPublic
-        };
-      });
+      const testCases = aiGeneratedContent.testCases.map((tc) => ({
+        id: generateUniqueId("tc_"),
+        input: tc.input,
+        expectedOutput: tc.expectedOutput,
+        isPublic: tc.isPublic
+      }));
       const completeQuestion = {
         id: generateUniqueId("coding_"),
         questionType: "coding",
         prompt: aiGeneratedContent.prompt,
         codingLanguage: clientInput.codingLanguage,
-        // FIXED: Correct field name
         functionSignature: aiGeneratedContent.functionSignature,
         solutionCode: aiGeneratedContent.solutionCode,
         testCases,
         points: 25,
-        topic: (_f = clientInput.quizContext) == null ? void 0 : _f.originalTopic,
+        topic: clientInput.quizContext?.originalTopic,
         difficulty: clientInput.difficulty,
-        contextCode: (_g = clientInput.quizContext) == null ? void 0 : _g.plannedContextId,
-        bloomLevel: (_h = clientInput.quizContext) == null ? void 0 : _h.plannedBloomLevel,
-        learningObjective: (_i = clientInput.quizContext) == null ? void 0 : _i.originalLoId,
-        subject: (_j = clientInput.quizContext) == null ? void 0 : _j.originalSubject,
-        category: (_k = clientInput.quizContext) == null ? void 0 : _k.originalCategory,
+        contextCode: clientInput.quizContext?.plannedContextId,
+        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
+        learningObjective: clientInput.quizContext?.originalLoId,
+        subject: clientInput.quizContext?.originalSubject,
+        category: clientInput.quizContext?.originalCategory,
         imageUrl: clientInput.imageUrl
       };
-      const validatedQuestion = CodingQuestionZodSchema.parse(completeQuestion);
+      CodingQuestionZodSchema.parse(completeQuestion);
       attemptResults.push({ success: true, duration, promptLength: promptText.length, responseLength: rawText.length, promptHash });
       console.log(`
 \u2705 Coding question generation successful on attempt ${attempt} (${duration}ms)`);
       if (attempt > 1) DebugLogger.logAttemptSummary(attemptResults);
-      return { question: validatedQuestion };
+      return { question: completeQuestion };
     } catch (error) {
       lastError = error;
       const duration = Date.now() - startTime;
@@ -2697,7 +2651,7 @@ async function generateCodingQuestion(clientInput, apiKey) {
     }
   }
   DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate Coding question after ${MAX_RETRY_ATTEMPTS9} attempts. Last error: ${lastError == null ? void 0 : lastError.message}`;
+  const errorMessage = `Failed to generate Coding question after ${MAX_RETRY_ATTEMPTS9} attempts. Last error: ${lastError?.message}`;
   console.error("\n\u274C Final Result: FAILED");
   console.error(errorMessage);
   return { error: errorMessage };
@@ -2736,7 +2690,6 @@ var calculateCombinedDifficulty = (plannedQ) => {
   return "hard";
 };
 async function generateQuestionsFromQuizPlan(clientInput, apiKey) {
-  var _a, _b;
   const { quizPlan, language, imageContexts } = clientInput;
   const generatedQuestions = [];
   const errors = [];
@@ -2760,9 +2713,9 @@ async function generateQuestionsFromQuizPlan(clientInput, apiKey) {
           originalSubject: plannedQ.originalSubject,
           originalCategory: plannedQ.originalCategory,
           originalTopic: plannedQ.originalTopic,
-          loDescription: (fullLO == null ? void 0 : fullLO.loDescription) || plannedQ.plannedTopic
+          loDescription: fullLO?.loDescription || plannedQ.plannedTopic
         };
-        const imageUrl = plannedQ.imageId && imageContexts ? (_a = imageContexts.find((ctx) => ctx.id === plannedQ.imageId)) == null ? void 0 : _a.imageUrl : void 0;
+        const imageUrl = plannedQ.imageId && imageContexts ? imageContexts.find((ctx) => ctx.id === plannedQ.imageId)?.imageUrl : void 0;
         const baseClientInput = {
           language,
           difficulty: calculateCombinedDifficulty(plannedQ),
@@ -2775,35 +2728,36 @@ async function generateQuestionsFromQuizPlan(clientInput, apiKey) {
             result = await generateTrueFalseQuestion(baseClientInput, apiKey);
             break;
           case "multiple_choice":
-            result = await generateMCQQuestion(__spreadProps(__spreadValues({}, baseClientInput), { numberOfOptions: 4 }), apiKey);
+            result = await generateMCQQuestion({ ...baseClientInput, numberOfOptions: 4 }, apiKey);
             break;
           case "multiple_response":
-            result = await generateMRQQuestion(__spreadProps(__spreadValues({}, baseClientInput), { numberOfOptions: 5, minCorrectAnswers: 2, maxCorrectAnswers: 3 }), apiKey);
+            result = await generateMRQQuestion({ ...baseClientInput, numberOfOptions: 5, minCorrectAnswers: 2, maxCorrectAnswers: 3 }, apiKey);
             break;
           case "short_answer":
-            result = await generateShortAnswerQuestion(__spreadProps(__spreadValues({}, baseClientInput), { isCaseSensitive: false }), apiKey);
+            result = await generateShortAnswerQuestion({ ...baseClientInput, isCaseSensitive: false }, apiKey);
             break;
           case "numeric":
-            result = await generateNumericQuestion(__spreadProps(__spreadValues({}, baseClientInput), { allowDecimals: true, tolerance: 0 }), apiKey);
+            result = await generateNumericQuestion({ ...baseClientInput, allowDecimals: true, tolerance: 0 }, apiKey);
             break;
           case "fill_in_the_blanks":
-            result = await generateFillInTheBlanksQuestion(__spreadProps(__spreadValues({}, baseClientInput), { numberOfBlanks: 2, isCaseSensitive: false }), apiKey);
+            result = await generateFillInTheBlanksQuestion({ ...baseClientInput, numberOfBlanks: 2, isCaseSensitive: false }, apiKey);
             break;
           case "sequence":
-            result = await generateSequenceQuestion(__spreadProps(__spreadValues({}, baseClientInput), { numberOfItems: 4 }), apiKey);
+            result = await generateSequenceQuestion({ ...baseClientInput, numberOfItems: 4 }, apiKey);
             break;
           case "matching":
-            result = await generateMatchingQuestion(__spreadProps(__spreadValues({}, baseClientInput), { numberOfPairs: 4, shuffleOptions: true }), apiKey);
+            result = await generateMatchingQuestion({ ...baseClientInput, numberOfPairs: 4, shuffleOptions: true }, apiKey);
             break;
           case "coding": {
-            const subject = ((_b = plannedQ.originalSubject) == null ? void 0 : _b.toLowerCase()) || "";
+            const subject = plannedQ.originalSubject?.toLowerCase() || "";
             let codingLanguage = "javascript";
             if (subject.includes("swift")) codingLanguage = "swift";
             else if (subject.includes("python")) codingLanguage = "python";
-            result = await generateCodingQuestion(__spreadProps(__spreadValues({}, baseClientInput), {
+            result = await generateCodingQuestion({
+              ...baseClientInput,
               codingLanguage,
-              displayLanguage: language || "English"
-            }), apiKey);
+              language: language || "English"
+            }, apiKey);
             break;
           }
           default:
@@ -3540,19 +3494,17 @@ Now, generate the JSON response.`;
               console.warn(`Skipping MCQ due to invalid correctTempOptionId: ${correctTempId}`);
               continue;
             }
-            finalQuestion = __spreadProps(__spreadValues({}, rawQuestion), {
+            finalQuestion = {
+              ...rawQuestion,
               id: questionId,
-              options: finalOptions.map((_a) => {
-                var _b = _a, { tempId } = _b, rest = __objRest(_b, ["tempId"]);
-                return rest;
-              }),
+              options: finalOptions.map(({ tempId, ...rest }) => rest),
               correctAnswerId: correctFinalOption.id
-            });
+            };
             break;
           }
           case "true_false":
           case "short_answer": {
-            finalQuestion = __spreadProps(__spreadValues({}, rawQuestion), { id: questionId });
+            finalQuestion = { ...rawQuestion, id: questionId };
             break;
           }
           default: