@telebort/question-banks 1.0.0

package/dist/schemas/index.js

@@ -0,0 +1,220 @@
+import { z } from 'zod';
+
+// src/schemas/question.ts
+var FeedbackSchema = z.object({
+  short: z.string().min(1).max(200),
+  detailed: z.string().min(1).max(1e3),
+  socraticHint: z.string().max(300).optional()
+});
+var OptionKeySchema = z.enum(["A", "B", "C", "D"]);
+var OptionSchema = z.object({
+  key: OptionKeySchema,
+  text: z.string().min(1),
+  isCorrect: z.boolean(),
+  // v1.1 fields - optional for backward compatibility
+  misconceptionId: z.string().optional(),
+  feedback: FeedbackSchema.optional()
+});
+var QuestionTypeSchema = z.enum([
+  "vocabulary",
+  "code_understanding",
+  "problem_solving",
+  "application",
+  "reflection"
+]);
+var QuestionArchetypeSchema = z.enum([
+  "vocabulary",
+  "trace",
+  "bebras",
+  "blockmodel",
+  "parsons"
+]);
+var DifficultySchema = z.enum(["easy", "medium", "hard", "challenge"]);
+var BloomsTaxonomySchema = z.enum([
+  "remember",
+  "understand",
+  "apply",
+  "analyze",
+  "evaluate",
+  "create"
+]);
+var QuestionMetadataSchema = z.object({
+  difficulty: DifficultySchema,
+  estimatedTime: z.number().int().positive(),
+  // seconds
+  bloomsTaxonomy: BloomsTaxonomySchema,
+  tags: z.array(z.string()),
+  source: z.string().default("exit-ticket"),
+  version: z.string().default("1.1"),
+  createdDate: z.string().optional(),
+  lastModified: z.string().optional()
+});
+var QuestionSchema = z.object({
+  // Identifiers
+  questionId: z.string().regex(/^[a-z0-9-]+-l\d+-q\d+$/),
+  globalId: z.string().regex(/^exit-ticket-\d{4}$/),
+  questionNumber: z.number().int().positive().max(5),
+  // Classification
+  questionType: QuestionTypeSchema,
+  questionTypeLabel: z.string(),
+  questionArchetype: QuestionArchetypeSchema.optional(),
+  // v1.1
+  // Content
+  prompt: z.string().min(10),
+  hasCodeBlock: z.boolean(),
+  codeLanguage: z.string().nullable(),
+  codeContent: z.string().nullable(),
+  // Misconception targeting (v1.1)
+  misconceptionTargets: z.array(z.string()).optional(),
+  // Answer options (exactly 4)
+  options: z.array(OptionSchema).length(4),
+  // Correct answer
+  correctAnswer: OptionKeySchema,
+  correctAnswerText: z.string(),
+  // Metadata
+  metadata: QuestionMetadataSchema
+});
+var QuestionWithoutAnswerSchema = QuestionSchema.omit({
+  correctAnswer: true,
+  correctAnswerText: true
+}).extend({
+  options: z.array(
+    OptionSchema.omit({
+      isCorrect: true,
+      feedback: true,
+      misconceptionId: true
+    })
+  ).length(4)
+});
+var CourseDomainSchema = z.enum([
+  // AI & Data Science
+  "ai_data_science",
+  "ai_ml_cv",
+  "ai_generative",
+  "ai_advanced",
+  // Web Development
+  "web_development",
+  // Mobile Development
+  "mobile_development",
+  "mobile",
+  // Block-based Programming
+  "block_based",
+  "python_programming",
+  "design",
+  // Foundation
+  "foundation",
+  "creative_computing"
+]);
+var CourseTierSchema = z.enum([
+  "foundation",
+  "intermediate",
+  "advanced"
+]);
+var LessonSchema = z.object({
+  lessonId: z.string(),
+  // e.g., "ai-1-lesson-1"
+  lessonNumber: z.number().int().positive(),
+  lessonTitle: z.string(),
+  lessonSlug: z.string().optional(),
+  totalQuestions: z.number().int().positive().default(5),
+  questions: z.array(QuestionSchema)
+});
+var CourseSchema = z.object({
+  courseId: z.string(),
+  // e.g., "ai-1"
+  courseName: z.string(),
+  // e.g., "AI-1 Data Analysis and Data Science"
+  courseCode: z.string(),
+  // e.g., "AI1"
+  domain: CourseDomainSchema,
+  tier: CourseTierSchema,
+  difficulty: z.number().int().min(1).max(5),
+  totalLessons: z.number().int().positive(),
+  totalQuestions: z.number().int().positive(),
+  sourceFile: z.string().optional(),
+  lessons: z.array(LessonSchema)
+});
+var CourseSummarySchema = CourseSchema.omit({ lessons: true }).extend({
+  lessons: z.array(
+    LessonSchema.omit({ questions: true })
+  ).optional()
+});
+var UserResponseSchema = z.object({
+  questionId: z.string(),
+  selectedAnswer: OptionKeySchema,
+  timeSpent: z.number().int().nonnegative().optional(),
+  // milliseconds
+  submittedAt: z.string().datetime().optional()
+});
+var AssessmentSubmissionSchema = z.object({
+  assessmentId: z.string().uuid().optional(),
+  // Generated if not provided
+  userId: z.string().optional(),
+  // For authenticated users
+  sessionId: z.string().optional(),
+  // For anonymous sessions
+  courseId: z.string(),
+  lessonId: z.string().optional(),
+  responses: z.array(UserResponseSchema).min(1),
+  submittedAt: z.string().datetime(),
+  metadata: z.record(z.unknown()).optional()
+  // Custom metadata
+});
+var GradedResponseSchema = z.object({
+  questionId: z.string(),
+  selectedAnswer: OptionKeySchema,
+  correctAnswer: OptionKeySchema,
+  isCorrect: z.boolean(),
+  misconceptionId: z.string().nullable(),
+  // For incorrect answers
+  feedback: FeedbackSchema.optional(),
+  timeSpent: z.number().int().nonnegative().optional()
+});
+var MisconceptionReportSchema = z.object({
+  misconceptionId: z.string(),
+  count: z.number().int().positive(),
+  percentage: z.number().min(0).max(100),
+  questionIds: z.array(z.string()),
+  description: z.string().optional()
+});
+var GradedAssessmentSchema = z.object({
+  assessmentId: z.string().uuid(),
+  userId: z.string().optional(),
+  courseId: z.string(),
+  lessonId: z.string().optional(),
+  // Scores
+  totalQuestions: z.number().int().positive(),
+  correctCount: z.number().int().nonnegative(),
+  incorrectCount: z.number().int().nonnegative(),
+  score: z.number().min(0).max(100),
+  // Percentage
+  passed: z.boolean(),
+  // Based on threshold (default 70%)
+  // Detailed results
+  responses: z.array(GradedResponseSchema),
+  // Misconception analysis (v1.1 feature)
+  misconceptions: z.array(MisconceptionReportSchema).optional(),
+  topMisconceptions: z.array(z.string()).max(3).optional(),
+  // Timing
+  totalTimeSpent: z.number().int().nonnegative().optional(),
+  // milliseconds
+  averageTimePerQuestion: z.number().nonnegative().optional(),
+  submittedAt: z.string().datetime(),
+  gradedAt: z.string().datetime()
+});
+var ValidationResultSchema = z.object({
+  valid: z.boolean(),
+  errors: z.array(z.object({
+    path: z.array(z.union([z.string(), z.number()])),
+    message: z.string(),
+    code: z.string().optional()
+  })).optional(),
+  isComplete: z.boolean(),
+  // All questions answered
+  questionCount: z.number().int(),
+  answeredCount: z.number().int()
+});
+
+export { AssessmentSubmissionSchema, BloomsTaxonomySchema, CourseDomainSchema, CourseSchema, CourseSummarySchema, CourseTierSchema, DifficultySchema, FeedbackSchema, GradedAssessmentSchema, GradedResponseSchema, LessonSchema, MisconceptionReportSchema, OptionKeySchema, OptionSchema, QuestionArchetypeSchema, QuestionMetadataSchema, QuestionSchema, QuestionTypeSchema, QuestionWithoutAnswerSchema, UserResponseSchema, ValidationResultSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/schemas/question.ts","../../src/schemas/course.ts","../../src/schemas/assessment.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["import { z } from 'zod'\n\n// ============================================================================\n// Feedback Schema (v1.1 enhancement)\n// ============================================================================\n\n/**\n * Structured feedback following the \"Not Yet\" protocol\n * - short: Brief acknowledgment (1 sentence)\n * - detailed: Full explanation of the misconception\n * - socraticHint: Optional guiding question for discovery learning\n */\nexport const FeedbackSchema = z.object({\n  short: z.string().min(1).max(200),\n  detailed: z.string().min(1).max(1000),\n  socraticHint: z.string().max(300).optional(),\n})\n\nexport type Feedback = z.infer<typeof FeedbackSchema>\n\n// ============================================================================\n// Option Schema\n// ============================================================================\n\nexport const OptionKeySchema = z.enum(['A', 'B', 'C', 'D'])\n\nexport type OptionKey = z.infer<typeof OptionKeySchema>\n\n/**\n * Answer option with optional misconception tracking (v1.1)\n */\nexport const OptionSchema = z.object({\n  key: OptionKeySchema,\n  text: z.string().min(1),\n  isCorrect: z.boolean(),\n  // v1.1 fields - optional for backward compatibility\n  misconceptionId: z.string().optional(),\n  feedback: FeedbackSchema.optional(),\n})\n\nexport type Option = z.infer<typeof OptionSchema>\n\n// ============================================================================\n// Question Type Enums\n// ============================================================================\n\nexport const QuestionTypeSchema = z.enum([\n  'vocabulary',\n  'code_understanding',\n  'problem_solving',\n  'application',\n  'reflection',\n])\n\nexport type QuestionType = z.infer<typeof QuestionTypeSchema>\n\n/**\n * Question archetype for pedagogical classification\n * - vocabulary: Definition/terminology questions\n * - trace: Code tracing (mental execution)\n * - bebras: Logic-first, computational thinking\n * - blockmodel: Surface/flow/purpose analysis\n * - parsons: Code block reordering (future)\n */\nexport const QuestionArchetypeSchema = z.enum([\n  'vocabulary',\n  'trace',\n  'bebras',\n  'blockmodel',\n  'parsons',\n])\n\nexport type QuestionArchetype = z.infer<typeof QuestionArchetypeSchema>\n\nexport const DifficultySchema = z.enum(['easy', 'medium', 'hard', 'challenge'])\n\nexport type Difficulty = z.infer<typeof DifficultySchema>\n\nexport const BloomsTaxonomySchema = z.enum([\n  'remember',\n  'understand',\n  'apply',\n  'analyze',\n  'evaluate',\n  'create',\n])\n\nexport type BloomsTaxonomy = z.infer<typeof BloomsTaxonomySchema>\n\n// ============================================================================\n// Question Metadata Schema\n// ============================================================================\n\nexport const QuestionMetadataSchema = z.object({\n  difficulty: DifficultySchema,\n  estimatedTime: z.number().int().positive(), // seconds\n  bloomsTaxonomy: BloomsTaxonomySchema,\n  tags: z.array(z.string()),\n  source: z.string().default('exit-ticket'),\n  version: z.string().default('1.1'),\n  createdDate: z.string().optional(),\n  lastModified: z.string().optional(),\n})\n\nexport type QuestionMetadata = z.infer<typeof QuestionMetadataSchema>\n\n// ============================================================================\n// Question Schema (v1.1)\n// ============================================================================\n\n/**\n * Full question schema with v1.1 enhancements:\n * - questionArchetype: Pedagogical classification\n * - misconceptionTargets: Expected misconceptions this question probes\n * - options with misconceptionId and structured feedback\n */\nexport const QuestionSchema = z.object({\n  // Identifiers\n  questionId: z.string().regex(/^[a-z0-9-]+-l\\d+-q\\d+$/),\n  globalId: z.string().regex(/^exit-ticket-\\d{4}$/),\n  questionNumber: z.number().int().positive().max(5),\n\n  // Classification\n  questionType: QuestionTypeSchema,\n  questionTypeLabel: z.string(),\n  questionArchetype: QuestionArchetypeSchema.optional(), // v1.1\n\n  // Content\n  prompt: z.string().min(10),\n  hasCodeBlock: z.boolean(),\n  codeLanguage: z.string().nullable(),\n  codeContent: z.string().nullable(),\n\n  // Misconception targeting (v1.1)\n  misconceptionTargets: z.array(z.string()).optional(),\n\n  // Answer options (exactly 4)\n  options: z.array(OptionSchema).length(4),\n\n  // Correct answer\n  correctAnswer: OptionKeySchema,\n  correctAnswerText: z.string(),\n\n  // Metadata\n  metadata: QuestionMetadataSchema,\n})\n\nexport type Question = z.infer<typeof QuestionSchema>\n\n// ============================================================================\n// Question without answer (for Standard tier - no answer leakage)\n// ============================================================================\n\nexport const QuestionWithoutAnswerSchema = QuestionSchema.omit({\n  correctAnswer: true,\n  correctAnswerText: true,\n}).extend({\n  options: z.array(\n    OptionSchema.omit({\n      isCorrect: true,\n      feedback: true,\n      misconceptionId: true,\n    })\n  ).length(4),\n})\n\nexport type QuestionWithoutAnswer = z.infer<typeof QuestionWithoutAnswerSchema>\n","import { z } from 'zod'\nimport { QuestionSchema } from './question'\n\n// ============================================================================\n// Course Domain & Tier\n// ============================================================================\n\nexport const CourseDomainSchema = z.enum([\n  // AI & Data Science\n  'ai_data_science',\n  'ai_ml_cv',\n  'ai_generative',\n  'ai_advanced',\n  // Web Development\n  'web_development',\n  // Mobile Development\n  'mobile_development',\n  'mobile',\n  // Block-based Programming\n  'block_based',\n  'python_programming',\n  'design',\n  // Foundation\n  'foundation',\n  'creative_computing',\n])\n\nexport type CourseDomain = z.infer<typeof CourseDomainSchema>\n\nexport const CourseTierSchema = z.enum([\n  'foundation',\n  'intermediate',\n  'advanced',\n])\n\nexport type CourseTier = z.infer<typeof CourseTierSchema>\n\n// ============================================================================\n// Lesson Schema\n// ============================================================================\n\nexport const LessonSchema = z.object({\n  lessonId: z.string(), // e.g., \"ai-1-lesson-1\"\n  lessonNumber: z.number().int().positive(),\n  lessonTitle: z.string(),\n  lessonSlug: z.string().optional(),\n  totalQuestions: z.number().int().positive().default(5),\n  questions: z.array(QuestionSchema),\n})\n\nexport type Lesson = z.infer<typeof LessonSchema>\n\n// ============================================================================\n// Course Schema\n// ============================================================================\n\nexport const CourseSchema = z.object({\n  courseId: z.string(), // e.g., \"ai-1\"\n  courseName: z.string(), // e.g., \"AI-1 Data Analysis and Data Science\"\n  courseCode: z.string(), // e.g., \"AI1\"\n  domain: CourseDomainSchema,\n  tier: CourseTierSchema,\n  difficulty: z.number().int().min(1).max(5),\n  totalLessons: z.number().int().positive(),\n  totalQuestions: z.number().int().positive(),\n  sourceFile: z.string().optional(),\n  lessons: z.array(LessonSchema),\n})\n\nexport type Course = z.infer<typeof CourseSchema>\n\n// ============================================================================\n// Course Summary (without questions - for listing)\n// ============================================================================\n\nexport const CourseSummarySchema = CourseSchema.omit({ lessons: true }).extend({\n  lessons: z.array(\n    LessonSchema.omit({ questions: true })\n  ).optional(),\n})\n\nexport type CourseSummary = z.infer<typeof CourseSummarySchema>\n","import { z } from 'zod'\nimport { OptionKeySchema, FeedbackSchema } from './question'\n\n// ============================================================================\n// User Response Schema\n// ============================================================================\n\n/**\n * A single user response to a question\n */\nexport const UserResponseSchema = z.object({\n  questionId: z.string(),\n  selectedAnswer: OptionKeySchema,\n  timeSpent: z.number().int().nonnegative().optional(), // milliseconds\n  submittedAt: z.string().datetime().optional(),\n})\n\nexport type UserResponse = z.infer<typeof UserResponseSchema>\n\n// ============================================================================\n// Assessment Submission Schema\n// ============================================================================\n\n/**\n * An assessment submission containing multiple responses\n */\nexport const AssessmentSubmissionSchema = z.object({\n  assessmentId: z.string().uuid().optional(), // Generated if not provided\n  userId: z.string().optional(), // For authenticated users\n  sessionId: z.string().optional(), // For anonymous sessions\n  courseId: z.string(),\n  lessonId: z.string().optional(),\n  responses: z.array(UserResponseSchema).min(1),\n  submittedAt: z.string().datetime(),\n  metadata: z.record(z.unknown()).optional(), // Custom metadata\n})\n\nexport type AssessmentSubmission = z.infer<typeof AssessmentSubmissionSchema>\n\n// ============================================================================\n// Graded Response Schema (Premium tier)\n// ============================================================================\n\n/**\n * Result of grading a single response\n */\nexport const GradedResponseSchema = z.object({\n  questionId: z.string(),\n  selectedAnswer: OptionKeySchema,\n  correctAnswer: OptionKeySchema,\n  isCorrect: z.boolean(),\n  misconceptionId: z.string().nullable(), // For incorrect answers\n  feedback: FeedbackSchema.optional(),\n  timeSpent: z.number().int().nonnegative().optional(),\n})\n\nexport type GradedResponse = z.infer<typeof GradedResponseSchema>\n\n// ============================================================================\n// Misconception Report Schema (Premium tier)\n// ============================================================================\n\n/**\n * Aggregated misconception analysis for an assessment\n */\nexport const MisconceptionReportSchema = z.object({\n  misconceptionId: z.string(),\n  count: z.number().int().positive(),\n  percentage: z.number().min(0).max(100),\n  questionIds: z.array(z.string()),\n  description: z.string().optional(),\n})\n\nexport type MisconceptionReport = z.infer<typeof MisconceptionReportSchema>\n\n// ============================================================================\n// Graded Assessment Schema (Premium tier)\n// ============================================================================\n\n/**\n * Complete graded assessment with scores and misconception analysis\n */\nexport const GradedAssessmentSchema = z.object({\n  assessmentId: z.string().uuid(),\n  userId: z.string().optional(),\n  courseId: z.string(),\n  lessonId: z.string().optional(),\n\n  // Scores\n  totalQuestions: z.number().int().positive(),\n  correctCount: z.number().int().nonnegative(),\n  incorrectCount: z.number().int().nonnegative(),\n  score: z.number().min(0).max(100), // Percentage\n  passed: z.boolean(), // Based on threshold (default 70%)\n\n  // Detailed results\n  responses: z.array(GradedResponseSchema),\n\n  // Misconception analysis (v1.1 feature)\n  misconceptions: z.array(MisconceptionReportSchema).optional(),\n  topMisconceptions: z.array(z.string()).max(3).optional(),\n\n  // Timing\n  totalTimeSpent: z.number().int().nonnegative().optional(), // milliseconds\n  averageTimePerQuestion: z.number().nonnegative().optional(),\n  submittedAt: z.string().datetime(),\n  gradedAt: z.string().datetime(),\n})\n\nexport type GradedAssessment = z.infer<typeof GradedAssessmentSchema>\n\n// ============================================================================\n// Validation Result Schema (Standard tier - no answer leakage)\n// ============================================================================\n\n/**\n * Result of validating an assessment submission\n * Does NOT reveal correct answers - only schema compliance\n */\nexport const ValidationResultSchema = z.object({\n  valid: z.boolean(),\n  errors: z.array(z.object({\n    path: z.array(z.union([z.string(), z.number()])),\n    message: z.string(),\n    code: z.string().optional(),\n  })).optional(),\n  isComplete: z.boolean(), // All questions answered\n  questionCount: z.number().int(),\n  answeredCount: z.number().int(),\n})\n\nexport type ValidationResult = z.infer<typeof ValidationResultSchema>\n"]}

package/dist/validation/index.cjs

@@ -0,0 +1,306 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/schemas/question.ts
+var FeedbackSchema = zod.z.object({
+  short: zod.z.string().min(1).max(200),
+  detailed: zod.z.string().min(1).max(1e3),
+  socraticHint: zod.z.string().max(300).optional()
+});
+var OptionKeySchema = zod.z.enum(["A", "B", "C", "D"]);
+var OptionSchema = zod.z.object({
+  key: OptionKeySchema,
+  text: zod.z.string().min(1),
+  isCorrect: zod.z.boolean(),
+  // v1.1 fields - optional for backward compatibility
+  misconceptionId: zod.z.string().optional(),
+  feedback: FeedbackSchema.optional()
+});
+var QuestionTypeSchema = zod.z.enum([
+  "vocabulary",
+  "code_understanding",
+  "problem_solving",
+  "application",
+  "reflection"
+]);
+var QuestionArchetypeSchema = zod.z.enum([
+  "vocabulary",
+  "trace",
+  "bebras",
+  "blockmodel",
+  "parsons"
+]);
+var DifficultySchema = zod.z.enum(["easy", "medium", "hard", "challenge"]);
+var BloomsTaxonomySchema = zod.z.enum([
+  "remember",
+  "understand",
+  "apply",
+  "analyze",
+  "evaluate",
+  "create"
+]);
+var QuestionMetadataSchema = zod.z.object({
+  difficulty: DifficultySchema,
+  estimatedTime: zod.z.number().int().positive(),
+  // seconds
+  bloomsTaxonomy: BloomsTaxonomySchema,
+  tags: zod.z.array(zod.z.string()),
+  source: zod.z.string().default("exit-ticket"),
+  version: zod.z.string().default("1.1"),
+  createdDate: zod.z.string().optional(),
+  lastModified: zod.z.string().optional()
+});
+var QuestionSchema = zod.z.object({
+  // Identifiers
+  questionId: zod.z.string().regex(/^[a-z0-9-]+-l\d+-q\d+$/),
+  globalId: zod.z.string().regex(/^exit-ticket-\d{4}$/),
+  questionNumber: zod.z.number().int().positive().max(5),
+  // Classification
+  questionType: QuestionTypeSchema,
+  questionTypeLabel: zod.z.string(),
+  questionArchetype: QuestionArchetypeSchema.optional(),
+  // v1.1
+  // Content
+  prompt: zod.z.string().min(10),
+  hasCodeBlock: zod.z.boolean(),
+  codeLanguage: zod.z.string().nullable(),
+  codeContent: zod.z.string().nullable(),
+  // Misconception targeting (v1.1)
+  misconceptionTargets: zod.z.array(zod.z.string()).optional(),
+  // Answer options (exactly 4)
+  options: zod.z.array(OptionSchema).length(4),
+  // Correct answer
+  correctAnswer: OptionKeySchema,
+  correctAnswerText: zod.z.string(),
+  // Metadata
+  metadata: QuestionMetadataSchema
+});
+QuestionSchema.omit({
+  correctAnswer: true,
+  correctAnswerText: true
+}).extend({
+  options: zod.z.array(
+    OptionSchema.omit({
+      isCorrect: true,
+      feedback: true,
+      misconceptionId: true
+    })
+  ).length(4)
+});
+var CourseDomainSchema = zod.z.enum([
+  // AI & Data Science
+  "ai_data_science",
+  "ai_ml_cv",
+  "ai_generative",
+  "ai_advanced",
+  // Web Development
+  "web_development",
+  // Mobile Development
+  "mobile_development",
+  "mobile",
+  // Block-based Programming
+  "block_based",
+  "python_programming",
+  "design",
+  // Foundation
+  "foundation",
+  "creative_computing"
+]);
+var CourseTierSchema = zod.z.enum([
+  "foundation",
+  "intermediate",
+  "advanced"
+]);
+var LessonSchema = zod.z.object({
+  lessonId: zod.z.string(),
+  // e.g., "ai-1-lesson-1"
+  lessonNumber: zod.z.number().int().positive(),
+  lessonTitle: zod.z.string(),
+  lessonSlug: zod.z.string().optional(),
+  totalQuestions: zod.z.number().int().positive().default(5),
+  questions: zod.z.array(QuestionSchema)
+});
+var CourseSchema = zod.z.object({
+  courseId: zod.z.string(),
+  // e.g., "ai-1"
+  courseName: zod.z.string(),
+  // e.g., "AI-1 Data Analysis and Data Science"
+  courseCode: zod.z.string(),
+  // e.g., "AI1"
+  domain: CourseDomainSchema,
+  tier: CourseTierSchema,
+  difficulty: zod.z.number().int().min(1).max(5),
+  totalLessons: zod.z.number().int().positive(),
+  totalQuestions: zod.z.number().int().positive(),
+  sourceFile: zod.z.string().optional(),
+  lessons: zod.z.array(LessonSchema)
+});
+CourseSchema.omit({ lessons: true }).extend({
+  lessons: zod.z.array(
+    LessonSchema.omit({ questions: true })
+  ).optional()
+});
+var UserResponseSchema = zod.z.object({
+  questionId: zod.z.string(),
+  selectedAnswer: OptionKeySchema,
+  timeSpent: zod.z.number().int().nonnegative().optional(),
+  // milliseconds
+  submittedAt: zod.z.string().datetime().optional()
+});
+var AssessmentSubmissionSchema = zod.z.object({
+  assessmentId: zod.z.string().uuid().optional(),
+  // Generated if not provided
+  userId: zod.z.string().optional(),
+  // For authenticated users
+  sessionId: zod.z.string().optional(),
+  // For anonymous sessions
+  courseId: zod.z.string(),
+  lessonId: zod.z.string().optional(),
+  responses: zod.z.array(UserResponseSchema).min(1),
+  submittedAt: zod.z.string().datetime(),
+  metadata: zod.z.record(zod.z.unknown()).optional()
+  // Custom metadata
+});
+var GradedResponseSchema = zod.z.object({
+  questionId: zod.z.string(),
+  selectedAnswer: OptionKeySchema,
+  correctAnswer: OptionKeySchema,
+  isCorrect: zod.z.boolean(),
+  misconceptionId: zod.z.string().nullable(),
+  // For incorrect answers
+  feedback: FeedbackSchema.optional(),
+  timeSpent: zod.z.number().int().nonnegative().optional()
+});
+var MisconceptionReportSchema = zod.z.object({
+  misconceptionId: zod.z.string(),
+  count: zod.z.number().int().positive(),
+  percentage: zod.z.number().min(0).max(100),
+  questionIds: zod.z.array(zod.z.string()),
+  description: zod.z.string().optional()
+});
+zod.z.object({
+  assessmentId: zod.z.string().uuid(),
+  userId: zod.z.string().optional(),
+  courseId: zod.z.string(),
+  lessonId: zod.z.string().optional(),
+  // Scores
+  totalQuestions: zod.z.number().int().positive(),
+  correctCount: zod.z.number().int().nonnegative(),
+  incorrectCount: zod.z.number().int().nonnegative(),
+  score: zod.z.number().min(0).max(100),
+  // Percentage
+  passed: zod.z.boolean(),
+  // Based on threshold (default 70%)
+  // Detailed results
+  responses: zod.z.array(GradedResponseSchema),
+  // Misconception analysis (v1.1 feature)
+  misconceptions: zod.z.array(MisconceptionReportSchema).optional(),
+  topMisconceptions: zod.z.array(zod.z.string()).max(3).optional(),
+  // Timing
+  totalTimeSpent: zod.z.number().int().nonnegative().optional(),
+  // milliseconds
+  averageTimePerQuestion: zod.z.number().nonnegative().optional(),
+  submittedAt: zod.z.string().datetime(),
+  gradedAt: zod.z.string().datetime()
+});
+zod.z.object({
+  valid: zod.z.boolean(),
+  errors: zod.z.array(zod.z.object({
+    path: zod.z.array(zod.z.union([zod.z.string(), zod.z.number()])),
+    message: zod.z.string(),
+    code: zod.z.string().optional()
+  })).optional(),
+  isComplete: zod.z.boolean(),
+  // All questions answered
+  questionCount: zod.z.number().int(),
+  answeredCount: zod.z.number().int()
+});
+
+// src/validation/client.ts
+var ValidationClient = class {
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl ?? "https://api.telebort.com/exit-tickets/v1";
+    this.timeout = config.timeout ?? 3e4;
+  }
+  /**
+   * Validate an assessment submission
+   *
+   * @param assessment - The assessment to validate
+   * @returns Validation result (no correct answers revealed)
+   */
+  async validateAssessment(assessment) {
+    const localResult = AssessmentSubmissionSchema.safeParse(assessment);
+    if (!localResult.success) {
+      return {
+        valid: false,
+        errors: localResult.error.issues.map((issue) => ({
+          path: issue.path,
+          message: issue.message,
+          code: issue.code
+        })),
+        isComplete: false,
+        questionCount: 0,
+        answeredCount: assessment.responses?.length ?? 0
+      };
+    }
+    if (this.apiKey && this.apiKey !== "offline") {
+      try {
+        const response = await fetch(`${this.baseUrl}/validate`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "X-API-Key": this.apiKey
+          },
+          body: JSON.stringify(assessment),
+          signal: AbortSignal.timeout(this.timeout)
+        });
+        if (!response.ok) {
+          const error = await response.json();
+          throw new Error(`API Error: ${error.message}`);
+        }
+        return await response.json();
+      } catch (error) {
+        console.warn("API validation failed, using local validation:", error);
+      }
+    }
+    return {
+      valid: true,
+      isComplete: true,
+      // Assume complete for local validation
+      questionCount: assessment.responses.length,
+      answeredCount: assessment.responses.length
+    };
+  }
+  /**
+   * Validate assessment offline (no API call)
+   * Uses only Zod schemas
+   */
+  validateOffline(assessment) {
+    const result = AssessmentSubmissionSchema.safeParse(assessment);
+    if (!result.success) {
+      return {
+        valid: false,
+        errors: result.error.issues.map((issue) => ({
+          path: issue.path,
+          message: issue.message,
+          code: issue.code
+        })),
+        isComplete: false,
+        questionCount: 0,
+        answeredCount: 0
+      };
+    }
+    return {
+      valid: true,
+      isComplete: true,
+      questionCount: result.data.responses.length,
+      answeredCount: result.data.responses.length
+    };
+  }
+};
+
+exports.ValidationClient = ValidationClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/validation/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/schemas/question.ts","../../src/schemas/course.ts","../../src/schemas/assessment.ts","../../src/validation/client.ts"],"names":["z"],"mappings":"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","file":"index.cjs","sourcesContent":["import { z } from 'zod'\n\n// ============================================================================\n// Feedback Schema (v1.1 enhancement)\n// ============================================================================\n\n/**\n * Structured feedback following the \"Not Yet\" protocol\n * - short: Brief acknowledgment (1 sentence)\n * - detailed: Full explanation of the misconception\n * - socraticHint: Optional guiding question for discovery learning\n */\nexport const FeedbackSchema = z.object({\n  short: z.string().min(1).max(200),\n  detailed: z.string().min(1).max(1000),\n  socraticHint: z.string().max(300).optional(),\n})\n\nexport type Feedback = z.infer<typeof FeedbackSchema>\n\n// ============================================================================\n// Option Schema\n// ============================================================================\n\nexport const OptionKeySchema = z.enum(['A', 'B', 'C', 'D'])\n\nexport type OptionKey = z.infer<typeof OptionKeySchema>\n\n/**\n * Answer option with optional misconception tracking (v1.1)\n */\nexport const OptionSchema = z.object({\n  key: OptionKeySchema,\n  text: z.string().min(1),\n  isCorrect: z.boolean(),\n  // v1.1 fields - optional for backward compatibility\n  misconceptionId: z.string().optional(),\n  feedback: FeedbackSchema.optional(),\n})\n\nexport type Option = z.infer<typeof OptionSchema>\n\n// ============================================================================\n// Question Type Enums\n// ============================================================================\n\nexport const QuestionTypeSchema = z.enum([\n  'vocabulary',\n  'code_understanding',\n  'problem_solving',\n  'application',\n  'reflection',\n])\n\nexport type QuestionType = z.infer<typeof QuestionTypeSchema>\n\n/**\n * Question archetype for pedagogical classification\n * - vocabulary: Definition/terminology questions\n * - trace: Code tracing (mental execution)\n * - bebras: Logic-first, computational thinking\n * - blockmodel: Surface/flow/purpose analysis\n * - parsons: Code block reordering (future)\n */\nexport const QuestionArchetypeSchema = z.enum([\n  'vocabulary',\n  'trace',\n  'bebras',\n  'blockmodel',\n  'parsons',\n])\n\nexport type QuestionArchetype = z.infer<typeof QuestionArchetypeSchema>\n\nexport const DifficultySchema = z.enum(['easy', 'medium', 'hard', 'challenge'])\n\nexport type Difficulty = z.infer<typeof DifficultySchema>\n\nexport const BloomsTaxonomySchema = z.enum([\n  'remember',\n  'understand',\n  'apply',\n  'analyze',\n  'evaluate',\n  'create',\n])\n\nexport type BloomsTaxonomy = z.infer<typeof BloomsTaxonomySchema>\n\n// ============================================================================\n// Question Metadata Schema\n// ============================================================================\n\nexport const QuestionMetadataSchema = z.object({\n  difficulty: DifficultySchema,\n  estimatedTime: z.number().int().positive(), // seconds\n  bloomsTaxonomy: BloomsTaxonomySchema,\n  tags: z.array(z.string()),\n  source: z.string().default('exit-ticket'),\n  version: z.string().default('1.1'),\n  createdDate: z.string().optional(),\n  lastModified: z.string().optional(),\n})\n\nexport type QuestionMetadata = z.infer<typeof QuestionMetadataSchema>\n\n// ============================================================================\n// Question Schema (v1.1)\n// ============================================================================\n\n/**\n * Full question schema with v1.1 enhancements:\n * - questionArchetype: Pedagogical classification\n * - misconceptionTargets: Expected misconceptions this question probes\n * - options with misconceptionId and structured feedback\n */\nexport const QuestionSchema = z.object({\n  // Identifiers\n  questionId: z.string().regex(/^[a-z0-9-]+-l\\d+-q\\d+$/),\n  globalId: z.string().regex(/^exit-ticket-\\d{4}$/),\n  questionNumber: z.number().int().positive().max(5),\n\n  // Classification\n  questionType: QuestionTypeSchema,\n  questionTypeLabel: z.string(),\n  questionArchetype: QuestionArchetypeSchema.optional(), // v1.1\n\n  // Content\n  prompt: z.string().min(10),\n  hasCodeBlock: z.boolean(),\n  codeLanguage: z.string().nullable(),\n  codeContent: z.string().nullable(),\n\n  // Misconception targeting (v1.1)\n  misconceptionTargets: z.array(z.string()).optional(),\n\n  // Answer options (exactly 4)\n  options: z.array(OptionSchema).length(4),\n\n  // Correct answer\n  correctAnswer: OptionKeySchema,\n  correctAnswerText: z.string(),\n\n  // Metadata\n  metadata: QuestionMetadataSchema,\n})\n\nexport type Question = z.infer<typeof QuestionSchema>\n\n// ============================================================================\n// Question without answer (for Standard tier - no answer leakage)\n// ============================================================================\n\nexport const QuestionWithoutAnswerSchema = QuestionSchema.omit({\n  correctAnswer: true,\n  correctAnswerText: true,\n}).extend({\n  options: z.array(\n    OptionSchema.omit({\n      isCorrect: true,\n      feedback: true,\n      misconceptionId: true,\n    })\n  ).length(4),\n})\n\nexport type QuestionWithoutAnswer = z.infer<typeof QuestionWithoutAnswerSchema>\n","import { z } from 'zod'\nimport { QuestionSchema } from './question'\n\n// ============================================================================\n// Course Domain & Tier\n// ============================================================================\n\nexport const CourseDomainSchema = z.enum([\n  // AI & Data Science\n  'ai_data_science',\n  'ai_ml_cv',\n  'ai_generative',\n  'ai_advanced',\n  // Web Development\n  'web_development',\n  // Mobile Development\n  'mobile_development',\n  'mobile',\n  // Block-based Programming\n  'block_based',\n  'python_programming',\n  'design',\n  // Foundation\n  'foundation',\n  'creative_computing',\n])\n\nexport type CourseDomain = z.infer<typeof CourseDomainSchema>\n\nexport const CourseTierSchema = z.enum([\n  'foundation',\n  'intermediate',\n  'advanced',\n])\n\nexport type CourseTier = z.infer<typeof CourseTierSchema>\n\n// ============================================================================\n// Lesson Schema\n// ============================================================================\n\nexport const LessonSchema = z.object({\n  lessonId: z.string(), // e.g., \"ai-1-lesson-1\"\n  lessonNumber: z.number().int().positive(),\n  lessonTitle: z.string(),\n  lessonSlug: z.string().optional(),\n  totalQuestions: z.number().int().positive().default(5),\n  questions: z.array(QuestionSchema),\n})\n\nexport type Lesson = z.infer<typeof LessonSchema>\n\n// ============================================================================\n// Course Schema\n// ============================================================================\n\nexport const CourseSchema = z.object({\n  courseId: z.string(), // e.g., \"ai-1\"\n  courseName: z.string(), // e.g., \"AI-1 Data Analysis and Data Science\"\n  courseCode: z.string(), // e.g., \"AI1\"\n  domain: CourseDomainSchema,\n  tier: CourseTierSchema,\n  difficulty: z.number().int().min(1).max(5),\n  totalLessons: z.number().int().positive(),\n  totalQuestions: z.number().int().positive(),\n  sourceFile: z.string().optional(),\n  lessons: z.array(LessonSchema),\n})\n\nexport type Course = z.infer<typeof CourseSchema>\n\n// ============================================================================\n// Course Summary (without questions - for listing)\n// ============================================================================\n\nexport const CourseSummarySchema = CourseSchema.omit({ lessons: true }).extend({\n  lessons: z.array(\n    LessonSchema.omit({ questions: true })\n  ).optional(),\n})\n\nexport type CourseSummary = z.infer<typeof CourseSummarySchema>\n","import { z } from 'zod'\nimport { OptionKeySchema, FeedbackSchema } from './question'\n\n// ============================================================================\n// User Response Schema\n// ============================================================================\n\n/**\n * A single user response to a question\n */\nexport const UserResponseSchema = z.object({\n  questionId: z.string(),\n  selectedAnswer: OptionKeySchema,\n  timeSpent: z.number().int().nonnegative().optional(), // milliseconds\n  submittedAt: z.string().datetime().optional(),\n})\n\nexport type UserResponse = z.infer<typeof UserResponseSchema>\n\n// ============================================================================\n// Assessment Submission Schema\n// ============================================================================\n\n/**\n * An assessment submission containing multiple responses\n */\nexport const AssessmentSubmissionSchema = z.object({\n  assessmentId: z.string().uuid().optional(), // Generated if not provided\n  userId: z.string().optional(), // For authenticated users\n  sessionId: z.string().optional(), // For anonymous sessions\n  courseId: z.string(),\n  lessonId: z.string().optional(),\n  responses: z.array(UserResponseSchema).min(1),\n  submittedAt: z.string().datetime(),\n  metadata: z.record(z.unknown()).optional(), // Custom metadata\n})\n\nexport type AssessmentSubmission = z.infer<typeof AssessmentSubmissionSchema>\n\n// ============================================================================\n// Graded Response Schema (Premium tier)\n// ============================================================================\n\n/**\n * Result of grading a single response\n */\nexport const GradedResponseSchema = z.object({\n  questionId: z.string(),\n  selectedAnswer: OptionKeySchema,\n  correctAnswer: OptionKeySchema,\n  isCorrect: z.boolean(),\n  misconceptionId: z.string().nullable(), // For incorrect answers\n  feedback: FeedbackSchema.optional(),\n  timeSpent: z.number().int().nonnegative().optional(),\n})\n\nexport type GradedResponse = z.infer<typeof GradedResponseSchema>\n\n// ============================================================================\n// Misconception Report Schema (Premium tier)\n// ============================================================================\n\n/**\n * Aggregated misconception analysis for an assessment\n */\nexport const MisconceptionReportSchema = z.object({\n  misconceptionId: z.string(),\n  count: z.number().int().positive(),\n  percentage: z.number().min(0).max(100),\n  questionIds: z.array(z.string()),\n  description: z.string().optional(),\n})\n\nexport type MisconceptionReport = z.infer<typeof MisconceptionReportSchema>\n\n// ============================================================================\n// Graded Assessment Schema (Premium tier)\n// ============================================================================\n\n/**\n * Complete graded assessment with scores and misconception analysis\n */\nexport const GradedAssessmentSchema = z.object({\n  assessmentId: z.string().uuid(),\n  userId: z.string().optional(),\n  courseId: z.string(),\n  lessonId: z.string().optional(),\n\n  // Scores\n  totalQuestions: z.number().int().positive(),\n  correctCount: z.number().int().nonnegative(),\n  incorrectCount: z.number().int().nonnegative(),\n  score: z.number().min(0).max(100), // Percentage\n  passed: z.boolean(), // Based on threshold (default 70%)\n\n  // Detailed results\n  responses: z.array(GradedResponseSchema),\n\n  // Misconception analysis (v1.1 feature)\n  misconceptions: z.array(MisconceptionReportSchema).optional(),\n  topMisconceptions: z.array(z.string()).max(3).optional(),\n\n  // Timing\n  totalTimeSpent: z.number().int().nonnegative().optional(), // milliseconds\n  averageTimePerQuestion: z.number().nonnegative().optional(),\n  submittedAt: z.string().datetime(),\n  gradedAt: z.string().datetime(),\n})\n\nexport type GradedAssessment = z.infer<typeof GradedAssessmentSchema>\n\n// ============================================================================\n// Validation Result Schema (Standard tier - no answer leakage)\n// ============================================================================\n\n/**\n * Result of validating an assessment submission\n * Does NOT reveal correct answers - only schema compliance\n */\nexport const ValidationResultSchema = z.object({\n  valid: z.boolean(),\n  errors: z.array(z.object({\n    path: z.array(z.union([z.string(), z.number()])),\n    message: z.string(),\n    code: z.string().optional(),\n  })).optional(),\n  isComplete: z.boolean(), // All questions answered\n  questionCount: z.number().int(),\n  answeredCount: z.number().int(),\n})\n\nexport type ValidationResult = z.infer<typeof ValidationResultSchema>\n","import { AssessmentSubmissionSchema, type AssessmentSubmission, type ValidationResult } from '../schemas'\nimport type { ValidationClientConfig, ValidationClientResult, ValidationApiError } from './types'\n\n/**\n * Standard Tier - Validation Client\n *\n * Validates assessment submissions against schemas\n * Does NOT reveal correct answers - only schema compliance\n */\nexport class ValidationClient {\n  private apiKey: string\n  private baseUrl: string\n  private timeout: number\n\n  constructor(config: ValidationClientConfig) {\n    this.apiKey = config.apiKey\n    this.baseUrl = config.baseUrl ?? 'https://api.telebort.com/exit-tickets/v1'\n    this.timeout = config.timeout ?? 30000\n  }\n\n  /**\n   * Validate an assessment submission\n   *\n   * @param assessment - The assessment to validate\n   * @returns Validation result (no correct answers revealed)\n   */\n  async validateAssessment(assessment: AssessmentSubmission): Promise<ValidationClientResult> {\n    // First, validate locally with Zod schema\n    const localResult = AssessmentSubmissionSchema.safeParse(assessment)\n\n    if (!localResult.success) {\n      return {\n        valid: false,\n        errors: localResult.error.issues.map(issue => ({\n          path: issue.path,\n          message: issue.message,\n          code: issue.code,\n        })),\n        isComplete: false,\n        questionCount: 0,\n        answeredCount: assessment.responses?.length ?? 0,\n      }\n    }\n\n    // If API key is provided, also validate with server\n    if (this.apiKey && this.apiKey !== 'offline') {\n      try {\n        const response = await fetch(`${this.baseUrl}/validate`, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'X-API-Key': this.apiKey,\n          },\n          body: JSON.stringify(assessment),\n          signal: AbortSignal.timeout(this.timeout),\n        })\n\n        if (!response.ok) {\n          const error = await response.json() as ValidationApiError\n          throw new Error(`API Error: ${error.message}`)\n        }\n\n        return await response.json() as ValidationClientResult\n      } catch (error) {\n        // Fall back to local validation if API fails\n        console.warn('API validation failed, using local validation:', error)\n      }\n    }\n\n    // Return local validation result\n    return {\n      valid: true,\n      isComplete: true, // Assume complete for local validation\n      questionCount: assessment.responses.length,\n      answeredCount: assessment.responses.length,\n    }\n  }\n\n  /**\n   * Validate assessment offline (no API call)\n   * Uses only Zod schemas\n   */\n  validateOffline(assessment: unknown): ValidationResult {\n    const result = AssessmentSubmissionSchema.safeParse(assessment)\n\n    if (!result.success) {\n      return {\n        valid: false,\n        errors: result.error.issues.map(issue => ({\n          path: issue.path,\n          message: issue.message,\n          code: issue.code,\n        })),\n        isComplete: false,\n        questionCount: 0,\n        answeredCount: 0,\n      }\n    }\n\n    return {\n      valid: true,\n      isComplete: true,\n      questionCount: result.data.responses.length,\n      answeredCount: result.data.responses.length,\n    }\n  }\n}\n"]}