@lssm/module.learning-journey 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217072406

package/dist/entities/quiz.js

@@ -1 +1,370 @@
-import{i as e,n as t,r as n,t as r}from"../libs/schema/dist/entity/defineEntity.js";import"../libs/schema/dist/index.js";const i=t({name:`QuestionType`,values:[`MULTIPLE_CHOICE`,`TRUE_FALSE`,`FILL_BLANK`,`MATCHING`,`SHORT_ANSWER`,`CODE`],schema:`lssm_learning`,description:`Type of quiz question.`}),a=t({name:`QuizStatus`,values:[`DRAFT`,`PUBLISHED`,`ARCHIVED`],schema:`lssm_learning`,description:`Publication status of a quiz.`}),o=t({name:`AttemptStatus`,values:[`IN_PROGRESS`,`COMPLETED`,`TIMED_OUT`,`ABANDONED`],schema:`lssm_learning`,description:`Status of a quiz attempt.`}),s=r({name:`Quiz`,description:`A quiz assessment.`,schema:`lssm_learning`,map:`quiz`,fields:{id:n.id({description:`Unique quiz identifier`}),lessonId:n.foreignKey({isOptional:!0,description:`Associated lesson`}),title:n.string({description:`Quiz title`}),description:n.string({isOptional:!0,description:`Quiz description`}),instructions:n.string({isOptional:!0,description:`Quiz instructions`}),passingScore:n.int({default:70,description:`Passing score percentage`}),timeLimit:n.int({isOptional:!0,description:`Time limit in seconds`}),maxAttempts:n.int({isOptional:!0,description:`Maximum attempts allowed`}),shuffleQuestions:n.boolean({default:!1,description:`Shuffle question order`}),shuffleOptions:n.boolean({default:!1,description:`Shuffle answer options`}),showCorrectAnswers:n.boolean({default:!0,description:`Show correct answers after`}),showExplanations:n.boolean({default:!0,description:`Show explanations after`}),status:n.enum(`QuizStatus`,{default:`DRAFT`,description:`Publication status`}),totalPoints:n.int({default:0,description:`Total points available`}),xpReward:n.int({default:20,description:`XP for passing`}),orgId:n.string({isOptional:!0,description:`Organization scope`}),metadata:n.json({isOptional:!0,description:`Additional metadata`}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),lesson:n.belongsTo(`Lesson`,[`lessonId`],[`id`],{onDelete:`Cascade`}),questions:n.hasMany(`Question`),attempts:n.hasMany(`QuizAttempt`)},indexes:[e.on([`lessonId`]),e.on([`status`]),e.on([`orgId`])],enums:[a]}),c=r({name:`Question`,description:`A quiz question.`,schema:`lssm_learning`,map:`question`,fields:{id:n.id({description:`Unique question identifier`}),quizId:n.foreignKey({description:`Parent quiz`}),type:n.enum(`QuestionType`,{description:`Question type`}),content:n.string({description:`Question text`}),mediaUrl:n.string({isOptional:!0,description:`Question media`}),points:n.int({default:1,description:`Points for correct answer`}),codeLanguage:n.string({isOptional:!0,description:`Programming language`}),codeTemplate:n.string({isOptional:!0,description:`Starter code template`}),testCases:n.json({isOptional:!0,description:`Test cases for code validation`}),explanation:n.string({isOptional:!0,description:`Explanation of correct answer`}),hint:n.string({isOptional:!0,description:`Hint for the question`}),order:n.int({default:0,description:`Display order`}),skillId:n.string({isOptional:!0,description:`Associated skill`}),metadata:n.json({isOptional:!0,description:`Additional metadata`}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),quiz:n.belongsTo(`Quiz`,[`quizId`],[`id`],{onDelete:`Cascade`}),options:n.hasMany(`QuestionOption`)},indexes:[e.on([`quizId`,`order`]),e.on([`type`]),e.on([`skillId`])],enums:[i]}),l=r({name:`QuestionOption`,description:`An answer option for a question.`,schema:`lssm_learning`,map:`question_option`,fields:{id:n.id({description:`Unique option identifier`}),questionId:n.foreignKey({description:`Parent question`}),content:n.string({description:`Option text`}),matchContent:n.string({isOptional:!0,description:`Match pair content`}),isCorrect:n.boolean({default:!1,description:`Whether option is correct`}),feedback:n.string({isOptional:!0,description:`Feedback when selected`}),order:n.int({default:0,description:`Display order`}),metadata:n.json({isOptional:!0,description:`Additional metadata`}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),question:n.belongsTo(`Question`,[`questionId`],[`id`],{onDelete:`Cascade`})},indexes:[e.on([`questionId`,`order`])]}),u=r({name:`QuizAttempt`,description:`A learner quiz attempt.`,schema:`lssm_learning`,map:`quiz_attempt`,fields:{id:n.id({description:`Unique attempt identifier`}),learnerId:n.foreignKey({description:`Learner`}),quizId:n.foreignKey({description:`Quiz`}),status:n.enum(`AttemptStatus`,{default:`IN_PROGRESS`,description:`Attempt status`}),score:n.int({isOptional:!0,description:`Score achieved`}),percentageScore:n.int({isOptional:!0,description:`Percentage score`}),passed:n.boolean({isOptional:!0,description:`Whether passed`}),totalQuestions:n.int({default:0,description:`Total questions`}),answeredQuestions:n.int({default:0,description:`Questions answered`}),correctAnswers:n.int({default:0,description:`Correct answers`}),answers:n.json({isOptional:!0,description:`Submitted answers`}),xpEarned:n.int({default:0,description:`XP earned`}),timeSpent:n.int({default:0,description:`Time spent in seconds`}),startedAt:n.dateTime({description:`When started`}),completedAt:n.dateTime({isOptional:!0,description:`When completed`}),attemptNumber:n.int({default:1,description:`Which attempt this is`}),metadata:n.json({isOptional:!0,description:`Additional metadata`}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),learner:n.belongsTo(`Learner`,[`learnerId`],[`id`],{onDelete:`Cascade`}),quiz:n.belongsTo(`Quiz`,[`quizId`],[`id`],{onDelete:`Cascade`})},indexes:[e.on([`learnerId`,`quizId`]),e.on([`learnerId`,`status`]),e.on([`quizId`,`status`])],enums:[o]}),d=r({name:`SkillAssessment`,description:`Assessment of a skill based on quiz performance.`,schema:`lssm_learning`,map:`skill_assessment`,fields:{id:n.id({description:`Unique assessment identifier`}),learnerId:n.foreignKey({description:`Learner`}),skillId:n.string({description:`Skill identifier`}),skillName:n.string({description:`Skill name`}),level:n.int({default:1,description:`Proficiency level (1-5)`}),score:n.int({default:0,description:`Assessment score (0-100)`}),confidence:n.decimal({default:.5,description:`Confidence in assessment`}),questionsAnswered:n.int({default:0,description:`Total questions answered`}),questionsCorrect:n.int({default:0,description:`Total correct`}),assessedAt:n.dateTime({description:`Last assessment time`}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),learner:n.belongsTo(`Learner`,[`learnerId`],[`id`],{onDelete:`Cascade`})},indexes:[e.unique([`learnerId`,`skillId`],{name:`skill_assessment_unique`}),e.on([`learnerId`,`level`]),e.on([`skillId`])]}),f=[s,c,l,u,d],p=[i,a,o];export{o as AttemptStatusEnum,c as QuestionEntity,l as QuestionOptionEntity,i as QuestionTypeEnum,u as QuizAttemptEntity,s as QuizEntity,a as QuizStatusEnum,d as SkillAssessmentEntity,f as quizEntities,p as quizEnums};
+import { defineEntity, defineEntityEnum, field, index } from "../libs/schema/dist/entity/defineEntity.js";
+import "../libs/schema/dist/index.js";
+
+//#region src/entities/quiz.ts
+/**
+* Question type enum.
+*/
+const QuestionTypeEnum = defineEntityEnum({
+	name: "QuestionType",
+	values: [
+		"MULTIPLE_CHOICE",
+		"TRUE_FALSE",
+		"FILL_BLANK",
+		"MATCHING",
+		"SHORT_ANSWER",
+		"CODE"
+	],
+	schema: "lssm_learning",
+	description: "Type of quiz question."
+});
+/**
+* Quiz status enum.
+*/
+const QuizStatusEnum = defineEntityEnum({
+	name: "QuizStatus",
+	values: [
+		"DRAFT",
+		"PUBLISHED",
+		"ARCHIVED"
+	],
+	schema: "lssm_learning",
+	description: "Publication status of a quiz."
+});
+/**
+* Attempt status enum.
+*/
+const AttemptStatusEnum = defineEntityEnum({
+	name: "AttemptStatus",
+	values: [
+		"IN_PROGRESS",
+		"COMPLETED",
+		"TIMED_OUT",
+		"ABANDONED"
+	],
+	schema: "lssm_learning",
+	description: "Status of a quiz attempt."
+});
+/**
+* Quiz entity - assessment for a lesson.
+*/
+const QuizEntity = defineEntity({
+	name: "Quiz",
+	description: "A quiz assessment.",
+	schema: "lssm_learning",
+	map: "quiz",
+	fields: {
+		id: field.id({ description: "Unique quiz identifier" }),
+		lessonId: field.foreignKey({
+			isOptional: true,
+			description: "Associated lesson"
+		}),
+		title: field.string({ description: "Quiz title" }),
+		description: field.string({
+			isOptional: true,
+			description: "Quiz description"
+		}),
+		instructions: field.string({
+			isOptional: true,
+			description: "Quiz instructions"
+		}),
+		passingScore: field.int({
+			default: 70,
+			description: "Passing score percentage"
+		}),
+		timeLimit: field.int({
+			isOptional: true,
+			description: "Time limit in seconds"
+		}),
+		maxAttempts: field.int({
+			isOptional: true,
+			description: "Maximum attempts allowed"
+		}),
+		shuffleQuestions: field.boolean({
+			default: false,
+			description: "Shuffle question order"
+		}),
+		shuffleOptions: field.boolean({
+			default: false,
+			description: "Shuffle answer options"
+		}),
+		showCorrectAnswers: field.boolean({
+			default: true,
+			description: "Show correct answers after"
+		}),
+		showExplanations: field.boolean({
+			default: true,
+			description: "Show explanations after"
+		}),
+		status: field.enum("QuizStatus", {
+			default: "DRAFT",
+			description: "Publication status"
+		}),
+		totalPoints: field.int({
+			default: 0,
+			description: "Total points available"
+		}),
+		xpReward: field.int({
+			default: 20,
+			description: "XP for passing"
+		}),
+		orgId: field.string({
+			isOptional: true,
+			description: "Organization scope"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Additional metadata"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		lesson: field.belongsTo("Lesson", ["lessonId"], ["id"], { onDelete: "Cascade" }),
+		questions: field.hasMany("Question"),
+		attempts: field.hasMany("QuizAttempt")
+	},
+	indexes: [
+		index.on(["lessonId"]),
+		index.on(["status"]),
+		index.on(["orgId"])
+	],
+	enums: [QuizStatusEnum]
+});
+/**
+* Question entity - individual quiz question.
+*/
+const QuestionEntity = defineEntity({
+	name: "Question",
+	description: "A quiz question.",
+	schema: "lssm_learning",
+	map: "question",
+	fields: {
+		id: field.id({ description: "Unique question identifier" }),
+		quizId: field.foreignKey({ description: "Parent quiz" }),
+		type: field.enum("QuestionType", { description: "Question type" }),
+		content: field.string({ description: "Question text" }),
+		mediaUrl: field.string({
+			isOptional: true,
+			description: "Question media"
+		}),
+		points: field.int({
+			default: 1,
+			description: "Points for correct answer"
+		}),
+		codeLanguage: field.string({
+			isOptional: true,
+			description: "Programming language"
+		}),
+		codeTemplate: field.string({
+			isOptional: true,
+			description: "Starter code template"
+		}),
+		testCases: field.json({
+			isOptional: true,
+			description: "Test cases for code validation"
+		}),
+		explanation: field.string({
+			isOptional: true,
+			description: "Explanation of correct answer"
+		}),
+		hint: field.string({
+			isOptional: true,
+			description: "Hint for the question"
+		}),
+		order: field.int({
+			default: 0,
+			description: "Display order"
+		}),
+		skillId: field.string({
+			isOptional: true,
+			description: "Associated skill"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Additional metadata"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		quiz: field.belongsTo("Quiz", ["quizId"], ["id"], { onDelete: "Cascade" }),
+		options: field.hasMany("QuestionOption")
+	},
+	indexes: [
+		index.on(["quizId", "order"]),
+		index.on(["type"]),
+		index.on(["skillId"])
+	],
+	enums: [QuestionTypeEnum]
+});
+/**
+* QuestionOption entity - answer option for a question.
+*/
+const QuestionOptionEntity = defineEntity({
+	name: "QuestionOption",
+	description: "An answer option for a question.",
+	schema: "lssm_learning",
+	map: "question_option",
+	fields: {
+		id: field.id({ description: "Unique option identifier" }),
+		questionId: field.foreignKey({ description: "Parent question" }),
+		content: field.string({ description: "Option text" }),
+		matchContent: field.string({
+			isOptional: true,
+			description: "Match pair content"
+		}),
+		isCorrect: field.boolean({
+			default: false,
+			description: "Whether option is correct"
+		}),
+		feedback: field.string({
+			isOptional: true,
+			description: "Feedback when selected"
+		}),
+		order: field.int({
+			default: 0,
+			description: "Display order"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Additional metadata"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		question: field.belongsTo("Question", ["questionId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [index.on(["questionId", "order"])]
+});
+/**
+* QuizAttempt entity - a learner's quiz attempt.
+*/
+const QuizAttemptEntity = defineEntity({
+	name: "QuizAttempt",
+	description: "A learner quiz attempt.",
+	schema: "lssm_learning",
+	map: "quiz_attempt",
+	fields: {
+		id: field.id({ description: "Unique attempt identifier" }),
+		learnerId: field.foreignKey({ description: "Learner" }),
+		quizId: field.foreignKey({ description: "Quiz" }),
+		status: field.enum("AttemptStatus", {
+			default: "IN_PROGRESS",
+			description: "Attempt status"
+		}),
+		score: field.int({
+			isOptional: true,
+			description: "Score achieved"
+		}),
+		percentageScore: field.int({
+			isOptional: true,
+			description: "Percentage score"
+		}),
+		passed: field.boolean({
+			isOptional: true,
+			description: "Whether passed"
+		}),
+		totalQuestions: field.int({
+			default: 0,
+			description: "Total questions"
+		}),
+		answeredQuestions: field.int({
+			default: 0,
+			description: "Questions answered"
+		}),
+		correctAnswers: field.int({
+			default: 0,
+			description: "Correct answers"
+		}),
+		answers: field.json({
+			isOptional: true,
+			description: "Submitted answers"
+		}),
+		xpEarned: field.int({
+			default: 0,
+			description: "XP earned"
+		}),
+		timeSpent: field.int({
+			default: 0,
+			description: "Time spent in seconds"
+		}),
+		startedAt: field.dateTime({ description: "When started" }),
+		completedAt: field.dateTime({
+			isOptional: true,
+			description: "When completed"
+		}),
+		attemptNumber: field.int({
+			default: 1,
+			description: "Which attempt this is"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Additional metadata"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		learner: field.belongsTo("Learner", ["learnerId"], ["id"], { onDelete: "Cascade" }),
+		quiz: field.belongsTo("Quiz", ["quizId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [
+		index.on(["learnerId", "quizId"]),
+		index.on(["learnerId", "status"]),
+		index.on(["quizId", "status"])
+	],
+	enums: [AttemptStatusEnum]
+});
+/**
+* SkillAssessment entity - maps quiz performance to skills.
+*/
+const SkillAssessmentEntity = defineEntity({
+	name: "SkillAssessment",
+	description: "Assessment of a skill based on quiz performance.",
+	schema: "lssm_learning",
+	map: "skill_assessment",
+	fields: {
+		id: field.id({ description: "Unique assessment identifier" }),
+		learnerId: field.foreignKey({ description: "Learner" }),
+		skillId: field.string({ description: "Skill identifier" }),
+		skillName: field.string({ description: "Skill name" }),
+		level: field.int({
+			default: 1,
+			description: "Proficiency level (1-5)"
+		}),
+		score: field.int({
+			default: 0,
+			description: "Assessment score (0-100)"
+		}),
+		confidence: field.decimal({
+			default: .5,
+			description: "Confidence in assessment"
+		}),
+		questionsAnswered: field.int({
+			default: 0,
+			description: "Total questions answered"
+		}),
+		questionsCorrect: field.int({
+			default: 0,
+			description: "Total correct"
+		}),
+		assessedAt: field.dateTime({ description: "Last assessment time" }),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		learner: field.belongsTo("Learner", ["learnerId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [
+		index.unique(["learnerId", "skillId"], { name: "skill_assessment_unique" }),
+		index.on(["learnerId", "level"]),
+		index.on(["skillId"])
+	]
+});
+const quizEntities = [
+	QuizEntity,
+	QuestionEntity,
+	QuestionOptionEntity,
+	QuizAttemptEntity,
+	SkillAssessmentEntity
+];
+const quizEnums = [
+	QuestionTypeEnum,
+	QuizStatusEnum,
+	AttemptStatusEnum
+];
+
+//#endregion
+export { AttemptStatusEnum, QuestionEntity, QuestionOptionEntity, QuestionTypeEnum, QuizAttemptEntity, QuizEntity, QuizStatusEnum, SkillAssessmentEntity, quizEntities, quizEnums };