@lssm/module.learning-journey 0.0.0-canary-20251217080011 → 1.41.0

package/dist/entities/quiz.js

@@ -1,370 +1 @@
-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 };
+import{defineEntity as e,defineEntityEnum as t,field as n,index as r}from"@lssm/lib.schema";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=e({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:[r.on([`lessonId`]),r.on([`status`]),r.on([`orgId`])],enums:[a]}),c=e({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:[r.on([`quizId`,`order`]),r.on([`type`]),r.on([`skillId`])],enums:[i]}),l=e({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:[r.on([`questionId`,`order`])]}),u=e({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:[r.on([`learnerId`,`quizId`]),r.on([`learnerId`,`status`]),r.on([`quizId`,`status`])],enums:[o]}),d=e({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:[r.unique([`learnerId`,`skillId`],{name:`skill_assessment_unique`}),r.on([`learnerId`,`level`]),r.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};