@lssm/module.learning-journey 1.41.1 → 1.42.1

package/dist/engines/streak.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streak.js","names":["DEFAULT_STREAK_CONFIG: StreakConfig","result: StreakUpdateResult"],"sources":["../../src/engines/streak.ts"],"sourcesContent":["/**\n * Streak Tracking Engine\n *\n * Manages daily learning streaks with timezone support and freeze protection.\n */\n\n// ============ Types ============\n\nexport interface StreakState {\n  /** Current streak days */\n  currentStreak: number;\n  /** Longest streak ever */\n  longestStreak: number;\n  /** Last activity timestamp */\n  lastActivityAt: Date | null;\n  /** Last activity date (YYYY-MM-DD) */\n  lastActivityDate: string | null;\n  /** Available streak freezes */\n  freezesRemaining: number;\n  /** When a freeze was last used */\n  freezeUsedAt: Date | null;\n}\n\nexport interface StreakUpdateResult {\n  /** Updated streak state */\n  state: StreakState;\n  /** Whether streak was maintained */\n  streakMaintained: boolean;\n  /** Whether streak was lost */\n  streakLost: boolean;\n  /** Whether a freeze was used */\n  freezeUsed: boolean;\n  /** Whether this activity started a new streak */\n  newStreak: boolean;\n  /** Days missed (if streak was lost) */\n  daysMissed: number;\n}\n\nexport interface StreakConfig {\n  /** Timezone for the user */\n  timezone: string;\n  /** How many streak freezes to give per month */\n  freezesPerMonth: number;\n  /** Maximum freezes that can be accumulated */\n  maxFreezes: number;\n  /** Grace period in hours after midnight */\n  gracePeriodHours: number;\n}\n\n// ============ Default Configuration ============\n\nexport const DEFAULT_STREAK_CONFIG: StreakConfig = {\n  timezone: 'UTC',\n  freezesPerMonth: 2,\n  maxFreezes: 5,\n  gracePeriodHours: 4, // 4 hours grace period\n};\n\n// ============ Streak Engine ============\n\nexport class StreakEngine {\n  private config: StreakConfig;\n\n  constructor(config: Partial<StreakConfig> = {}) {\n    this.config = { ...DEFAULT_STREAK_CONFIG, ...config };\n  }\n\n  /**\n   * Update streak based on new activity.\n   */\n  update(state: StreakState, now: Date = new Date()): StreakUpdateResult {\n    const todayDate = this.getDateString(now);\n    const result: StreakUpdateResult = {\n      state: { ...state },\n      streakMaintained: false,\n      streakLost: false,\n      freezeUsed: false,\n      newStreak: false,\n      daysMissed: 0,\n    };\n\n    // If no previous activity, start new streak\n    if (!state.lastActivityDate) {\n      result.state.currentStreak = 1;\n      result.state.longestStreak = Math.max(1, state.longestStreak);\n      result.state.lastActivityAt = now;\n      result.state.lastActivityDate = todayDate;\n      result.newStreak = true;\n      result.streakMaintained = true;\n      return result;\n    }\n\n    // Check if activity is on the same day\n    if (state.lastActivityDate === todayDate) {\n      // Same day - just update timestamp, streak unchanged\n      result.state.lastActivityAt = now;\n      result.streakMaintained = true;\n      return result;\n    }\n\n    // Calculate days since last activity\n    const daysSinceActivity = this.getDaysBetween(\n      state.lastActivityDate,\n      todayDate\n    );\n\n    if (daysSinceActivity === 1) {\n      // Perfect - activity on consecutive day\n      result.state.currentStreak = state.currentStreak + 1;\n      result.state.longestStreak = Math.max(\n        result.state.currentStreak,\n        state.longestStreak\n      );\n      result.state.lastActivityAt = now;\n      result.state.lastActivityDate = todayDate;\n      result.streakMaintained = true;\n      return result;\n    }\n\n    // Streak was potentially broken\n    result.daysMissed = daysSinceActivity - 1;\n\n    // Check if we can use freezes\n    const freezesNeeded = result.daysMissed;\n    if (freezesNeeded <= state.freezesRemaining) {\n      // Use freezes to maintain streak\n      result.state.freezesRemaining = state.freezesRemaining - freezesNeeded;\n      result.state.freezeUsedAt = now;\n      result.state.currentStreak = state.currentStreak + 1; // Add today\n      result.state.longestStreak = Math.max(\n        result.state.currentStreak,\n        state.longestStreak\n      );\n      result.state.lastActivityAt = now;\n      result.state.lastActivityDate = todayDate;\n      result.freezeUsed = true;\n      result.streakMaintained = true;\n      return result;\n    }\n\n    // Streak is lost\n    result.streakLost = true;\n    result.state.currentStreak = 1; // Start new streak\n    result.state.lastActivityAt = now;\n    result.state.lastActivityDate = todayDate;\n    result.newStreak = true;\n    return result;\n  }\n\n  /**\n   * Check streak status without recording activity.\n   */\n  checkStatus(\n    state: StreakState,\n    now: Date = new Date()\n  ): {\n    isActive: boolean;\n    willExpireAt: Date | null;\n    canUseFreeze: boolean;\n    daysUntilExpiry: number;\n  } {\n    if (!state.lastActivityDate) {\n      return {\n        isActive: false,\n        willExpireAt: null,\n        canUseFreeze: false,\n        daysUntilExpiry: 0,\n      };\n    }\n\n    const todayDate = this.getDateString(now);\n    const daysSinceActivity = this.getDaysBetween(\n      state.lastActivityDate,\n      todayDate\n    );\n\n    if (daysSinceActivity === 0) {\n      // Activity today - streak is active\n      const tomorrow = this.addDays(now, 1);\n      tomorrow.setHours(23, 59, 59, 999);\n      return {\n        isActive: true,\n        willExpireAt: tomorrow,\n        canUseFreeze: state.freezesRemaining > 0,\n        daysUntilExpiry: 1,\n      };\n    }\n\n    if (daysSinceActivity === 1) {\n      // No activity today yet, but still within window\n      const endOfDay = new Date(now);\n      endOfDay.setHours(23 + this.config.gracePeriodHours, 59, 59, 999);\n      return {\n        isActive: true,\n        willExpireAt: endOfDay,\n        canUseFreeze: state.freezesRemaining > 0,\n        daysUntilExpiry: 0,\n      };\n    }\n\n    // Streak would be broken\n    const missedDays = daysSinceActivity - 1;\n    return {\n      isActive: missedDays <= state.freezesRemaining,\n      willExpireAt: null,\n      canUseFreeze: missedDays <= state.freezesRemaining,\n      daysUntilExpiry: -missedDays,\n    };\n  }\n\n  /**\n   * Manually use a freeze to protect streak.\n   */\n  useFreeze(state: StreakState, now: Date = new Date()): StreakState | null {\n    if (state.freezesRemaining <= 0) {\n      return null;\n    }\n\n    return {\n      ...state,\n      freezesRemaining: state.freezesRemaining - 1,\n      freezeUsedAt: now,\n    };\n  }\n\n  /**\n   * Award monthly freezes.\n   */\n  awardMonthlyFreezes(state: StreakState): StreakState {\n    return {\n      ...state,\n      freezesRemaining: Math.min(\n        state.freezesRemaining + this.config.freezesPerMonth,\n        this.config.maxFreezes\n      ),\n    };\n  }\n\n  /**\n   * Get initial streak state.\n   */\n  getInitialState(): StreakState {\n    return {\n      currentStreak: 0,\n      longestStreak: 0,\n      lastActivityAt: null,\n      lastActivityDate: null,\n      freezesRemaining: this.config.freezesPerMonth,\n      freezeUsedAt: null,\n    };\n  }\n\n  /**\n   * Calculate streak milestones.\n   */\n  getMilestones(currentStreak: number): {\n    achieved: number[];\n    next: number | null;\n  } {\n    const milestones = [3, 7, 14, 30, 60, 90, 180, 365, 500, 1000];\n    const achieved = milestones.filter((m) => currentStreak >= m);\n    const next = milestones.find((m) => currentStreak < m) ?? null;\n    return { achieved, next };\n  }\n\n  // ============ Helpers ============\n\n  /**\n   * Get date string in YYYY-MM-DD format.\n   */\n  private getDateString(date: Date): string {\n    // Simple implementation - for production, use a proper timezone library\n    const year = date.getFullYear();\n    const month = String(date.getMonth() + 1).padStart(2, '0');\n    const day = String(date.getDate()).padStart(2, '0');\n    return `${year}-${month}-${day}`;\n  }\n\n  /**\n   * Get number of days between two date strings.\n   */\n  private getDaysBetween(dateStr1: string, dateStr2: string): number {\n    const date1 = new Date(dateStr1);\n    const date2 = new Date(dateStr2);\n    const diffTime = date2.getTime() - date1.getTime();\n    return Math.floor(diffTime / (1000 * 60 * 60 * 24));\n  }\n\n  /**\n   * Add days to a date.\n   */\n  private addDays(date: Date, days: number): Date {\n    return new Date(date.getTime() + days * 24 * 60 * 60 * 1000);\n  }\n}\n\n/**\n * Default streak engine instance.\n */\nexport const streakEngine = new StreakEngine();\n"],"mappings":"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"}

package/dist/engines/xp.d.ts

@@ -0,0 +1,97 @@
+//#region src/engines/xp.d.ts
+/**
+ * XP (Experience Points) Engine
+ *
+ * Calculates XP rewards for various learning activities.
+ */
+type XPActivityType = 'lesson_complete' | 'quiz_pass' | 'quiz_perfect' | 'flashcard_review' | 'course_complete' | 'module_complete' | 'streak_bonus' | 'achievement_unlock' | 'daily_goal_complete' | 'first_lesson' | 'onboarding_step' | 'onboarding_complete';
+interface XPCalculationInput {
+  /** Type of activity */
+  activity: XPActivityType;
+  /** Base XP for the activity (from content config) */
+  baseXp?: number;
+  /** Score achieved (0-100) for scored activities */
+  score?: number;
+  /** Current streak (for streak bonuses) */
+  currentStreak?: number;
+  /** Time spent in seconds */
+  timeSpent?: number;
+  /** Attempt number (for quizzes) */
+  attemptNumber?: number;
+  /** Whether this is a retry */
+  isRetry?: boolean;
+}
+interface XPResult {
+  /** Total XP earned */
+  totalXp: number;
+  /** Base XP before bonuses */
+  baseXp: number;
+  /** Breakdown of XP sources */
+  breakdown: XPBreakdown[];
+}
+interface XPBreakdown {
+  /** Source of XP */
+  source: string;
+  /** XP amount */
+  amount: number;
+  /** Multiplier applied */
+  multiplier?: number;
+}
+interface XPConfig {
+  /** Base XP values for each activity */
+  baseValues: Record<XPActivityType, number>;
+  /** Score thresholds for bonus XP */
+  scoreThresholds: {
+    min: number;
+    multiplier: number;
+  }[];
+  /** Streak bonus tiers */
+  streakTiers: {
+    days: number;
+    bonus: number;
+  }[];
+  /** Perfect score bonus multiplier */
+  perfectScoreMultiplier: number;
+  /** First attempt bonus */
+  firstAttemptBonus: number;
+  /** Retry penalty multiplier */
+  retryPenalty: number;
+  /** Speed bonus (complete under expected time) */
+  speedBonusMultiplier: number;
+  /** Speed bonus threshold (percentage of expected time) */
+  speedBonusThreshold: number;
+}
+declare const DEFAULT_XP_CONFIG: XPConfig;
+declare class XPEngine {
+  private config;
+  constructor(config?: Partial<XPConfig>);
+  /**
+   * Calculate XP for an activity.
+   */
+  calculate(input: XPCalculationInput): XPResult;
+  /**
+   * Calculate streak bonus XP.
+   */
+  calculateStreakBonus(currentStreak: number): XPResult;
+  /**
+   * Calculate XP needed for a level.
+   */
+  getXpForLevel(level: number): number;
+  /**
+   * Get level from total XP.
+   */
+  getLevelFromXp(totalXp: number): {
+    level: number;
+    xpInLevel: number;
+    xpForNextLevel: number;
+  };
+  private getScoreMultiplier;
+  private getStreakBonus;
+}
+/**
+ * Default XP engine instance.
+ */
+declare const xpEngine: XPEngine;
+//#endregion
+export { DEFAULT_XP_CONFIG, XPActivityType, XPBreakdown, XPCalculationInput, XPConfig, XPEngine, XPResult, xpEngine };
+//# sourceMappingURL=xp.d.ts.map

package/dist/engines/xp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xp.d.ts","names":[],"sources":["../../src/engines/xp.ts"],"sourcesContent":[],"mappings":";;AAQA;AAcA;AAiBA;AASA;AASiB,KAjDL,cAAA,GAmDS,iBAAP,GAAA,WAAM,GAAA,cAAA,GAAA,kBAAA,GAAA,iBAAA,GAAA,iBAAA,GAAA,cAAA,GAAA,oBAAA,GAAA,qBAAA,GAAA,cAAA,GAAA,iBAAA,GAAA,qBAAA;AAmBP,UAxDI,kBAAA,CAwDe;EAyCnB;EAGiB,QAAA,EAlGlB,cAkGkB;EAAR;EAcH,MAAA,CAAA,EAAA,MAAA;EAAqB;EAsFO,KAAA,CAAA,EAAA,MAAA;EAAQ;EA6E1C,aAAyB,CAAA,EAAA,MAAA;;;;;;;;UApQrB,QAAA;;;;;;aAMJ;;UAGI,WAAA;;;;;;;;UASA,QAAA;;cAEH,OAAO;;;;;;;;;;;;;;;;;;;;;;cAmBR,mBAAmB;cAyCnB,QAAA;;uBAGS,QAAQ;;;;mBAcX,qBAAqB;;;;+CAsFO;;;;;;;;;;;;;;;;;;;cA6ElC,UAAQ"}

package/dist/engines/xp.js

@@ -1 +1,213 @@
-const e={baseValues:{lesson_complete:10,quiz_pass:20,quiz_perfect:50,flashcard_review:1,course_complete:200,module_complete:50,streak_bonus:5,achievement_unlock:0,daily_goal_complete:15,first_lesson:25,onboarding_step:5,onboarding_complete:50},scoreThresholds:[{min:90,multiplier:1.5},{min:80,multiplier:1.25},{min:70,multiplier:1},{min:60,multiplier:.75},{min:0,multiplier:.5}],streakTiers:[{days:365,bonus:50},{days:180,bonus:30},{days:90,bonus:20},{days:30,bonus:15},{days:14,bonus:10},{days:7,bonus:5},{days:3,bonus:2},{days:1,bonus:0}],perfectScoreMultiplier:1.5,firstAttemptBonus:10,retryPenalty:.5,speedBonusMultiplier:1.2,speedBonusThreshold:.8};var t=class{config;constructor(t={}){this.config={...e,...t,baseValues:{...e.baseValues,...t.baseValues},scoreThresholds:t.scoreThresholds||e.scoreThresholds,streakTiers:t.streakTiers||e.streakTiers}}calculate(e){let t=[],n=e.baseXp??this.config.baseValues[e.activity],r=n;if(t.push({source:`base`,amount:n}),e.score!==void 0){let i=this.getScoreMultiplier(e.score);if(i!==1){let e=Math.round(n*(i-1));r+=e,t.push({source:`score_bonus`,amount:e,multiplier:i})}if(e.score===100){let e=Math.round(n*(this.config.perfectScoreMultiplier-1));r+=e,t.push({source:`perfect_score`,amount:e,multiplier:this.config.perfectScoreMultiplier})}}if(e.attemptNumber===1&&!e.isRetry&&(r+=this.config.firstAttemptBonus,t.push({source:`first_attempt`,amount:this.config.firstAttemptBonus})),e.isRetry){let e=Math.round(r*(1-this.config.retryPenalty));r-=e,t.push({source:`retry_penalty`,amount:-e,multiplier:this.config.retryPenalty})}if(e.currentStreak&&e.currentStreak>0){let n=this.getStreakBonus(e.currentStreak);n>0&&(r+=n,t.push({source:`streak_bonus`,amount:n}))}return n>0&&(r=Math.max(1,r)),{totalXp:Math.round(r),baseXp:n,breakdown:t}}calculateStreakBonus(e){let t=this.getStreakBonus(e);return{totalXp:t,baseXp:t,breakdown:[{source:`streak_bonus`,amount:t}]}}getXpForLevel(e){return e<=1?0:Math.round(100*(e-1)**1.5)}getLevelFromXp(e){let t=1,n=this.getXpForLevel(t+1);for(;e>=n&&t<1e3;)t++,n=this.getXpForLevel(t+1);let r=this.getXpForLevel(t),i=this.getXpForLevel(t+1);return{level:t,xpInLevel:e-r,xpForNextLevel:i-r}}getScoreMultiplier(e){for(let t of this.config.scoreThresholds)if(e>=t.min)return t.multiplier;return 1}getStreakBonus(e){for(let t of this.config.streakTiers)if(e>=t.days)return t.bonus;return 0}};const n=new t;export{e as DEFAULT_XP_CONFIG,t as XPEngine,n as xpEngine};
+//#region src/engines/xp.ts
+const DEFAULT_XP_CONFIG = {
+	baseValues: {
+		lesson_complete: 10,
+		quiz_pass: 20,
+		quiz_perfect: 50,
+		flashcard_review: 1,
+		course_complete: 200,
+		module_complete: 50,
+		streak_bonus: 5,
+		achievement_unlock: 0,
+		daily_goal_complete: 15,
+		first_lesson: 25,
+		onboarding_step: 5,
+		onboarding_complete: 50
+	},
+	scoreThresholds: [
+		{
+			min: 90,
+			multiplier: 1.5
+		},
+		{
+			min: 80,
+			multiplier: 1.25
+		},
+		{
+			min: 70,
+			multiplier: 1
+		},
+		{
+			min: 60,
+			multiplier: .75
+		},
+		{
+			min: 0,
+			multiplier: .5
+		}
+	],
+	streakTiers: [
+		{
+			days: 365,
+			bonus: 50
+		},
+		{
+			days: 180,
+			bonus: 30
+		},
+		{
+			days: 90,
+			bonus: 20
+		},
+		{
+			days: 30,
+			bonus: 15
+		},
+		{
+			days: 14,
+			bonus: 10
+		},
+		{
+			days: 7,
+			bonus: 5
+		},
+		{
+			days: 3,
+			bonus: 2
+		},
+		{
+			days: 1,
+			bonus: 0
+		}
+	],
+	perfectScoreMultiplier: 1.5,
+	firstAttemptBonus: 10,
+	retryPenalty: .5,
+	speedBonusMultiplier: 1.2,
+	speedBonusThreshold: .8
+};
+var XPEngine = class {
+	config;
+	constructor(config = {}) {
+		this.config = {
+			...DEFAULT_XP_CONFIG,
+			...config,
+			baseValues: {
+				...DEFAULT_XP_CONFIG.baseValues,
+				...config.baseValues
+			},
+			scoreThresholds: config.scoreThresholds || DEFAULT_XP_CONFIG.scoreThresholds,
+			streakTiers: config.streakTiers || DEFAULT_XP_CONFIG.streakTiers
+		};
+	}
+	/**
+	* Calculate XP for an activity.
+	*/
+	calculate(input) {
+		const breakdown = [];
+		const baseXp = input.baseXp ?? this.config.baseValues[input.activity];
+		let totalXp = baseXp;
+		breakdown.push({
+			source: "base",
+			amount: baseXp
+		});
+		if (input.score !== void 0) {
+			const scoreMultiplier = this.getScoreMultiplier(input.score);
+			if (scoreMultiplier !== 1) {
+				const scoreBonus = Math.round(baseXp * (scoreMultiplier - 1));
+				totalXp += scoreBonus;
+				breakdown.push({
+					source: "score_bonus",
+					amount: scoreBonus,
+					multiplier: scoreMultiplier
+				});
+			}
+			if (input.score === 100) {
+				const perfectBonus = Math.round(baseXp * (this.config.perfectScoreMultiplier - 1));
+				totalXp += perfectBonus;
+				breakdown.push({
+					source: "perfect_score",
+					amount: perfectBonus,
+					multiplier: this.config.perfectScoreMultiplier
+				});
+			}
+		}
+		if (input.attemptNumber === 1 && !input.isRetry) {
+			totalXp += this.config.firstAttemptBonus;
+			breakdown.push({
+				source: "first_attempt",
+				amount: this.config.firstAttemptBonus
+			});
+		}
+		if (input.isRetry) {
+			const penalty = Math.round(totalXp * (1 - this.config.retryPenalty));
+			totalXp -= penalty;
+			breakdown.push({
+				source: "retry_penalty",
+				amount: -penalty,
+				multiplier: this.config.retryPenalty
+			});
+		}
+		if (input.currentStreak && input.currentStreak > 0) {
+			const streakBonus = this.getStreakBonus(input.currentStreak);
+			if (streakBonus > 0) {
+				totalXp += streakBonus;
+				breakdown.push({
+					source: "streak_bonus",
+					amount: streakBonus
+				});
+			}
+		}
+		if (baseXp > 0) totalXp = Math.max(1, totalXp);
+		return {
+			totalXp: Math.round(totalXp),
+			baseXp,
+			breakdown
+		};
+	}
+	/**
+	* Calculate streak bonus XP.
+	*/
+	calculateStreakBonus(currentStreak) {
+		const bonus = this.getStreakBonus(currentStreak);
+		return {
+			totalXp: bonus,
+			baseXp: bonus,
+			breakdown: [{
+				source: "streak_bonus",
+				amount: bonus
+			}]
+		};
+	}
+	/**
+	* Calculate XP needed for a level.
+	*/
+	getXpForLevel(level) {
+		if (level <= 1) return 0;
+		return Math.round(100 * Math.pow(level - 1, 1.5));
+	}
+	/**
+	* Get level from total XP.
+	*/
+	getLevelFromXp(totalXp) {
+		let level = 1;
+		let xpRequired = this.getXpForLevel(level + 1);
+		while (totalXp >= xpRequired && level < 1e3) {
+			level++;
+			xpRequired = this.getXpForLevel(level + 1);
+		}
+		const xpForCurrentLevel = this.getXpForLevel(level);
+		const xpForNextLevel = this.getXpForLevel(level + 1);
+		return {
+			level,
+			xpInLevel: totalXp - xpForCurrentLevel,
+			xpForNextLevel: xpForNextLevel - xpForCurrentLevel
+		};
+	}
+	getScoreMultiplier(score) {
+		for (const threshold of this.config.scoreThresholds) if (score >= threshold.min) return threshold.multiplier;
+		return 1;
+	}
+	getStreakBonus(streak) {
+		for (const tier of this.config.streakTiers) if (streak >= tier.days) return tier.bonus;
+		return 0;
+	}
+};
+/**
+* Default XP engine instance.
+*/
+const xpEngine = new XPEngine();
+
+//#endregion
+export { DEFAULT_XP_CONFIG, XPEngine, xpEngine };
+//# sourceMappingURL=xp.js.map

package/dist/engines/xp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xp.js","names":["DEFAULT_XP_CONFIG: XPConfig","breakdown: XPBreakdown[]"],"sources":["../../src/engines/xp.ts"],"sourcesContent":["/**\n * XP (Experience Points) Engine\n *\n * Calculates XP rewards for various learning activities.\n */\n\n// ============ Types ============\n\nexport type XPActivityType =\n  | 'lesson_complete'\n  | 'quiz_pass'\n  | 'quiz_perfect'\n  | 'flashcard_review'\n  | 'course_complete'\n  | 'module_complete'\n  | 'streak_bonus'\n  | 'achievement_unlock'\n  | 'daily_goal_complete'\n  | 'first_lesson'\n  | 'onboarding_step'\n  | 'onboarding_complete';\n\nexport interface XPCalculationInput {\n  /** Type of activity */\n  activity: XPActivityType;\n  /** Base XP for the activity (from content config) */\n  baseXp?: number;\n  /** Score achieved (0-100) for scored activities */\n  score?: number;\n  /** Current streak (for streak bonuses) */\n  currentStreak?: number;\n  /** Time spent in seconds */\n  timeSpent?: number;\n  /** Attempt number (for quizzes) */\n  attemptNumber?: number;\n  /** Whether this is a retry */\n  isRetry?: boolean;\n}\n\nexport interface XPResult {\n  /** Total XP earned */\n  totalXp: number;\n  /** Base XP before bonuses */\n  baseXp: number;\n  /** Breakdown of XP sources */\n  breakdown: XPBreakdown[];\n}\n\nexport interface XPBreakdown {\n  /** Source of XP */\n  source: string;\n  /** XP amount */\n  amount: number;\n  /** Multiplier applied */\n  multiplier?: number;\n}\n\nexport interface XPConfig {\n  /** Base XP values for each activity */\n  baseValues: Record<XPActivityType, number>;\n  /** Score thresholds for bonus XP */\n  scoreThresholds: { min: number; multiplier: number }[];\n  /** Streak bonus tiers */\n  streakTiers: { days: number; bonus: number }[];\n  /** Perfect score bonus multiplier */\n  perfectScoreMultiplier: number;\n  /** First attempt bonus */\n  firstAttemptBonus: number;\n  /** Retry penalty multiplier */\n  retryPenalty: number;\n  /** Speed bonus (complete under expected time) */\n  speedBonusMultiplier: number;\n  /** Speed bonus threshold (percentage of expected time) */\n  speedBonusThreshold: number;\n}\n\n// ============ Default Configuration ============\n\nexport const DEFAULT_XP_CONFIG: XPConfig = {\n  baseValues: {\n    lesson_complete: 10,\n    quiz_pass: 20,\n    quiz_perfect: 50,\n    flashcard_review: 1,\n    course_complete: 200,\n    module_complete: 50,\n    streak_bonus: 5,\n    achievement_unlock: 0, // XP comes from achievement\n    daily_goal_complete: 15,\n    first_lesson: 25,\n    onboarding_step: 5,\n    onboarding_complete: 50,\n  },\n  scoreThresholds: [\n    { min: 90, multiplier: 1.5 },\n    { min: 80, multiplier: 1.25 },\n    { min: 70, multiplier: 1.0 },\n    { min: 60, multiplier: 0.75 },\n    { min: 0, multiplier: 0.5 },\n  ],\n  streakTiers: [\n    { days: 365, bonus: 50 },\n    { days: 180, bonus: 30 },\n    { days: 90, bonus: 20 },\n    { days: 30, bonus: 15 },\n    { days: 14, bonus: 10 },\n    { days: 7, bonus: 5 },\n    { days: 3, bonus: 2 },\n    { days: 1, bonus: 0 },\n  ],\n  perfectScoreMultiplier: 1.5,\n  firstAttemptBonus: 10,\n  retryPenalty: 0.5,\n  speedBonusMultiplier: 1.2,\n  speedBonusThreshold: 0.8,\n};\n\n// ============ XP Engine ============\n\nexport class XPEngine {\n  private config: XPConfig;\n\n  constructor(config: Partial<XPConfig> = {}) {\n    this.config = {\n      ...DEFAULT_XP_CONFIG,\n      ...config,\n      baseValues: { ...DEFAULT_XP_CONFIG.baseValues, ...config.baseValues },\n      scoreThresholds:\n        config.scoreThresholds || DEFAULT_XP_CONFIG.scoreThresholds,\n      streakTiers: config.streakTiers || DEFAULT_XP_CONFIG.streakTiers,\n    };\n  }\n\n  /**\n   * Calculate XP for an activity.\n   */\n  calculate(input: XPCalculationInput): XPResult {\n    const breakdown: XPBreakdown[] = [];\n\n    // Get base XP\n    const baseXp = input.baseXp ?? this.config.baseValues[input.activity];\n    let totalXp = baseXp;\n\n    breakdown.push({\n      source: 'base',\n      amount: baseXp,\n    });\n\n    // Apply score-based multiplier\n    if (input.score !== undefined) {\n      const scoreMultiplier = this.getScoreMultiplier(input.score);\n      if (scoreMultiplier !== 1.0) {\n        const scoreBonus = Math.round(baseXp * (scoreMultiplier - 1));\n        totalXp += scoreBonus;\n        breakdown.push({\n          source: 'score_bonus',\n          amount: scoreBonus,\n          multiplier: scoreMultiplier,\n        });\n      }\n\n      // Perfect score bonus\n      if (input.score === 100) {\n        const perfectBonus = Math.round(\n          baseXp * (this.config.perfectScoreMultiplier - 1)\n        );\n        totalXp += perfectBonus;\n        breakdown.push({\n          source: 'perfect_score',\n          amount: perfectBonus,\n          multiplier: this.config.perfectScoreMultiplier,\n        });\n      }\n    }\n\n    // First attempt bonus\n    if (input.attemptNumber === 1 && !input.isRetry) {\n      totalXp += this.config.firstAttemptBonus;\n      breakdown.push({\n        source: 'first_attempt',\n        amount: this.config.firstAttemptBonus,\n      });\n    }\n\n    // Retry penalty\n    if (input.isRetry) {\n      const penalty = Math.round(totalXp * (1 - this.config.retryPenalty));\n      totalXp -= penalty;\n      breakdown.push({\n        source: 'retry_penalty',\n        amount: -penalty,\n        multiplier: this.config.retryPenalty,\n      });\n    }\n\n    // Streak bonus\n    if (input.currentStreak && input.currentStreak > 0) {\n      const streakBonus = this.getStreakBonus(input.currentStreak);\n      if (streakBonus > 0) {\n        totalXp += streakBonus;\n        breakdown.push({\n          source: 'streak_bonus',\n          amount: streakBonus,\n        });\n      }\n    }\n\n    // Ensure XP is at least 1 (if base was > 0)\n    if (baseXp > 0) {\n      totalXp = Math.max(1, totalXp);\n    }\n\n    return {\n      totalXp: Math.round(totalXp),\n      baseXp,\n      breakdown,\n    };\n  }\n\n  /**\n   * Calculate streak bonus XP.\n   */\n  calculateStreakBonus(currentStreak: number): XPResult {\n    const bonus = this.getStreakBonus(currentStreak);\n    return {\n      totalXp: bonus,\n      baseXp: bonus,\n      breakdown: [\n        {\n          source: 'streak_bonus',\n          amount: bonus,\n        },\n      ],\n    };\n  }\n\n  /**\n   * Calculate XP needed for a level.\n   */\n  getXpForLevel(level: number): number {\n    // Exponential growth formula\n    // Level 1: 0 XP\n    // Level 2: 100 XP\n    // Level 3: 300 XP\n    // etc.\n    if (level <= 1) return 0;\n    return Math.round(100 * Math.pow(level - 1, 1.5));\n  }\n\n  /**\n   * Get level from total XP.\n   */\n  getLevelFromXp(totalXp: number): {\n    level: number;\n    xpInLevel: number;\n    xpForNextLevel: number;\n  } {\n    let level = 1;\n    let xpRequired = this.getXpForLevel(level + 1);\n\n    while (totalXp >= xpRequired && level < 1000) {\n      level++;\n      xpRequired = this.getXpForLevel(level + 1);\n    }\n\n    const xpForCurrentLevel = this.getXpForLevel(level);\n    const xpForNextLevel = this.getXpForLevel(level + 1);\n\n    return {\n      level,\n      xpInLevel: totalXp - xpForCurrentLevel,\n      xpForNextLevel: xpForNextLevel - xpForCurrentLevel,\n    };\n  }\n\n  // ============ Helpers ============\n\n  private getScoreMultiplier(score: number): number {\n    for (const threshold of this.config.scoreThresholds) {\n      if (score >= threshold.min) {\n        return threshold.multiplier;\n      }\n    }\n    return 1.0;\n  }\n\n  private getStreakBonus(streak: number): number {\n    for (const tier of this.config.streakTiers) {\n      if (streak >= tier.days) {\n        return tier.bonus;\n      }\n    }\n    return 0;\n  }\n}\n\n/**\n * Default XP engine instance.\n */\nexport const xpEngine = new XPEngine();\n"],"mappings":"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"}

package/dist/entities/ai.d.ts

@@ -0,0 +1,232 @@
+import * as _lssm_lib_schema747 from "@lssm/lib.schema";
+
+//#region src/entities/ai.d.ts
+/**
+ * Learning style enum.
+ */
+declare const LearningStyleEnum: _lssm_lib_schema747.EntityEnumDef;
+/**
+ * Recommendation type enum.
+ */
+declare const RecommendationTypeEnum: _lssm_lib_schema747.EntityEnumDef;
+/**
+ * LearnerProfile entity - AI personalization profile.
+ */
+declare const LearnerProfileEntity: _lssm_lib_schema747.EntitySpec<{
+  id: _lssm_lib_schema747.EntityScalarField;
+  learnerId: _lssm_lib_schema747.EntityScalarField;
+  learningStyle: _lssm_lib_schema747.EntityEnumField;
+  preferredDifficulty: _lssm_lib_schema747.EntityScalarField;
+  preferredSessionLength: _lssm_lib_schema747.EntityScalarField;
+  interests: _lssm_lib_schema747.EntityScalarField;
+  goals: _lssm_lib_schema747.EntityScalarField;
+  pacePreference: _lssm_lib_schema747.EntityScalarField;
+  bestTimeOfDay: _lssm_lib_schema747.EntityScalarField;
+  averageSessionLength: _lssm_lib_schema747.EntityScalarField;
+  daysActivePerWeek: _lssm_lib_schema747.EntityScalarField;
+  avgQuizScore: _lssm_lib_schema747.EntityScalarField;
+  avgLessonCompletionTime: _lssm_lib_schema747.EntityScalarField;
+  strengths: _lssm_lib_schema747.EntityScalarField;
+  weaknesses: _lssm_lib_schema747.EntityScalarField;
+  lastAnalyzedAt: _lssm_lib_schema747.EntityScalarField;
+  metadata: _lssm_lib_schema747.EntityScalarField;
+  createdAt: _lssm_lib_schema747.EntityScalarField;
+  updatedAt: _lssm_lib_schema747.EntityScalarField;
+  learner: _lssm_lib_schema747.EntityRelationField;
+}>;
+/**
+ * SkillMap entity - tracks skill proficiency.
+ */
+declare const SkillMapEntity: _lssm_lib_schema747.EntitySpec<{
+  id: _lssm_lib_schema747.EntityScalarField;
+  learnerId: _lssm_lib_schema747.EntityScalarField;
+  skillId: _lssm_lib_schema747.EntityScalarField;
+  skillName: _lssm_lib_schema747.EntityScalarField;
+  skillCategory: _lssm_lib_schema747.EntityScalarField;
+  level: _lssm_lib_schema747.EntityScalarField;
+  confidence: _lssm_lib_schema747.EntityScalarField;
+  lessonsCompleted: _lssm_lib_schema747.EntityScalarField;
+  quizzesCompleted: _lssm_lib_schema747.EntityScalarField;
+  practiceTime: _lssm_lib_schema747.EntityScalarField;
+  lastPracticedAt: _lssm_lib_schema747.EntityScalarField;
+  learningVelocity: _lssm_lib_schema747.EntityScalarField;
+  predictedTimeToMastery: _lssm_lib_schema747.EntityScalarField;
+  createdAt: _lssm_lib_schema747.EntityScalarField;
+  updatedAt: _lssm_lib_schema747.EntityScalarField;
+  learner: _lssm_lib_schema747.EntityRelationField;
+}>;
+/**
+ * LearningPath entity - AI-generated learning paths.
+ */
+declare const LearningPathEntity: _lssm_lib_schema747.EntitySpec<{
+  id: _lssm_lib_schema747.EntityScalarField;
+  learnerId: _lssm_lib_schema747.EntityScalarField;
+  name: _lssm_lib_schema747.EntityScalarField;
+  description: _lssm_lib_schema747.EntityScalarField;
+  goal: _lssm_lib_schema747.EntityScalarField;
+  steps: _lssm_lib_schema747.EntityScalarField;
+  currentStepIndex: _lssm_lib_schema747.EntityScalarField;
+  progress: _lssm_lib_schema747.EntityScalarField;
+  completedSteps: _lssm_lib_schema747.EntityScalarField;
+  totalSteps: _lssm_lib_schema747.EntityScalarField;
+  generatedAt: _lssm_lib_schema747.EntityScalarField;
+  adaptedFrom: _lssm_lib_schema747.EntityScalarField;
+  generationParams: _lssm_lib_schema747.EntityScalarField;
+  adaptationHistory: _lssm_lib_schema747.EntityScalarField;
+  isActive: _lssm_lib_schema747.EntityScalarField;
+  isCompleted: _lssm_lib_schema747.EntityScalarField;
+  startedAt: _lssm_lib_schema747.EntityScalarField;
+  completedAt: _lssm_lib_schema747.EntityScalarField;
+  estimatedCompletionDate: _lssm_lib_schema747.EntityScalarField;
+  createdAt: _lssm_lib_schema747.EntityScalarField;
+  updatedAt: _lssm_lib_schema747.EntityScalarField;
+  learner: _lssm_lib_schema747.EntityRelationField;
+}>;
+/**
+ * Recommendation entity - AI-powered learning recommendations.
+ */
+declare const RecommendationEntity: _lssm_lib_schema747.EntitySpec<{
+  id: _lssm_lib_schema747.EntityScalarField;
+  learnerId: _lssm_lib_schema747.EntityScalarField;
+  type: _lssm_lib_schema747.EntityEnumField;
+  itemId: _lssm_lib_schema747.EntityScalarField;
+  itemType: _lssm_lib_schema747.EntityScalarField;
+  score: _lssm_lib_schema747.EntityScalarField;
+  confidence: _lssm_lib_schema747.EntityScalarField;
+  reason: _lssm_lib_schema747.EntityScalarField;
+  factors: _lssm_lib_schema747.EntityScalarField;
+  status: _lssm_lib_schema747.EntityScalarField;
+  viewedAt: _lssm_lib_schema747.EntityScalarField;
+  acceptedAt: _lssm_lib_schema747.EntityScalarField;
+  dismissedAt: _lssm_lib_schema747.EntityScalarField;
+  feedback: _lssm_lib_schema747.EntityScalarField;
+  feedbackRating: _lssm_lib_schema747.EntityScalarField;
+  expiresAt: _lssm_lib_schema747.EntityScalarField;
+  createdAt: _lssm_lib_schema747.EntityScalarField;
+  updatedAt: _lssm_lib_schema747.EntityScalarField;
+  learner: _lssm_lib_schema747.EntityRelationField;
+}>;
+/**
+ * LearningGap entity - identified knowledge gaps.
+ */
+declare const LearningGapEntity: _lssm_lib_schema747.EntitySpec<{
+  id: _lssm_lib_schema747.EntityScalarField;
+  learnerId: _lssm_lib_schema747.EntityScalarField;
+  skillId: _lssm_lib_schema747.EntityScalarField;
+  skillName: _lssm_lib_schema747.EntityScalarField;
+  severity: _lssm_lib_schema747.EntityScalarField;
+  confidence: _lssm_lib_schema747.EntityScalarField;
+  evidence: _lssm_lib_schema747.EntityScalarField;
+  relatedQuestions: _lssm_lib_schema747.EntityScalarField;
+  suggestedRemediation: _lssm_lib_schema747.EntityScalarField;
+  remediationProgress: _lssm_lib_schema747.EntityScalarField;
+  status: _lssm_lib_schema747.EntityScalarField;
+  resolvedAt: _lssm_lib_schema747.EntityScalarField;
+  detectedAt: _lssm_lib_schema747.EntityScalarField;
+  createdAt: _lssm_lib_schema747.EntityScalarField;
+  updatedAt: _lssm_lib_schema747.EntityScalarField;
+  learner: _lssm_lib_schema747.EntityRelationField;
+}>;
+declare const aiEntities: (_lssm_lib_schema747.EntitySpec<{
+  id: _lssm_lib_schema747.EntityScalarField;
+  learnerId: _lssm_lib_schema747.EntityScalarField;
+  learningStyle: _lssm_lib_schema747.EntityEnumField;
+  preferredDifficulty: _lssm_lib_schema747.EntityScalarField;
+  preferredSessionLength: _lssm_lib_schema747.EntityScalarField;
+  interests: _lssm_lib_schema747.EntityScalarField;
+  goals: _lssm_lib_schema747.EntityScalarField;
+  pacePreference: _lssm_lib_schema747.EntityScalarField;
+  bestTimeOfDay: _lssm_lib_schema747.EntityScalarField;
+  averageSessionLength: _lssm_lib_schema747.EntityScalarField;
+  daysActivePerWeek: _lssm_lib_schema747.EntityScalarField;
+  avgQuizScore: _lssm_lib_schema747.EntityScalarField;
+  avgLessonCompletionTime: _lssm_lib_schema747.EntityScalarField;
+  strengths: _lssm_lib_schema747.EntityScalarField;
+  weaknesses: _lssm_lib_schema747.EntityScalarField;
+  lastAnalyzedAt: _lssm_lib_schema747.EntityScalarField;
+  metadata: _lssm_lib_schema747.EntityScalarField;
+  createdAt: _lssm_lib_schema747.EntityScalarField;
+  updatedAt: _lssm_lib_schema747.EntityScalarField;
+  learner: _lssm_lib_schema747.EntityRelationField;
+}> | _lssm_lib_schema747.EntitySpec<{
+  id: _lssm_lib_schema747.EntityScalarField;
+  learnerId: _lssm_lib_schema747.EntityScalarField;
+  skillId: _lssm_lib_schema747.EntityScalarField;
+  skillName: _lssm_lib_schema747.EntityScalarField;
+  skillCategory: _lssm_lib_schema747.EntityScalarField;
+  level: _lssm_lib_schema747.EntityScalarField;
+  confidence: _lssm_lib_schema747.EntityScalarField;
+  lessonsCompleted: _lssm_lib_schema747.EntityScalarField;
+  quizzesCompleted: _lssm_lib_schema747.EntityScalarField;
+  practiceTime: _lssm_lib_schema747.EntityScalarField;
+  lastPracticedAt: _lssm_lib_schema747.EntityScalarField;
+  learningVelocity: _lssm_lib_schema747.EntityScalarField;
+  predictedTimeToMastery: _lssm_lib_schema747.EntityScalarField;
+  createdAt: _lssm_lib_schema747.EntityScalarField;
+  updatedAt: _lssm_lib_schema747.EntityScalarField;
+  learner: _lssm_lib_schema747.EntityRelationField;
+}> | _lssm_lib_schema747.EntitySpec<{
+  id: _lssm_lib_schema747.EntityScalarField;
+  learnerId: _lssm_lib_schema747.EntityScalarField;
+  name: _lssm_lib_schema747.EntityScalarField;
+  description: _lssm_lib_schema747.EntityScalarField;
+  goal: _lssm_lib_schema747.EntityScalarField;
+  steps: _lssm_lib_schema747.EntityScalarField;
+  currentStepIndex: _lssm_lib_schema747.EntityScalarField;
+  progress: _lssm_lib_schema747.EntityScalarField;
+  completedSteps: _lssm_lib_schema747.EntityScalarField;
+  totalSteps: _lssm_lib_schema747.EntityScalarField;
+  generatedAt: _lssm_lib_schema747.EntityScalarField;
+  adaptedFrom: _lssm_lib_schema747.EntityScalarField;
+  generationParams: _lssm_lib_schema747.EntityScalarField;
+  adaptationHistory: _lssm_lib_schema747.EntityScalarField;
+  isActive: _lssm_lib_schema747.EntityScalarField;
+  isCompleted: _lssm_lib_schema747.EntityScalarField;
+  startedAt: _lssm_lib_schema747.EntityScalarField;
+  completedAt: _lssm_lib_schema747.EntityScalarField;
+  estimatedCompletionDate: _lssm_lib_schema747.EntityScalarField;
+  createdAt: _lssm_lib_schema747.EntityScalarField;
+  updatedAt: _lssm_lib_schema747.EntityScalarField;
+  learner: _lssm_lib_schema747.EntityRelationField;
+}> | _lssm_lib_schema747.EntitySpec<{
+  id: _lssm_lib_schema747.EntityScalarField;
+  learnerId: _lssm_lib_schema747.EntityScalarField;
+  type: _lssm_lib_schema747.EntityEnumField;
+  itemId: _lssm_lib_schema747.EntityScalarField;
+  itemType: _lssm_lib_schema747.EntityScalarField;
+  score: _lssm_lib_schema747.EntityScalarField;
+  confidence: _lssm_lib_schema747.EntityScalarField;
+  reason: _lssm_lib_schema747.EntityScalarField;
+  factors: _lssm_lib_schema747.EntityScalarField;
+  status: _lssm_lib_schema747.EntityScalarField;
+  viewedAt: _lssm_lib_schema747.EntityScalarField;
+  acceptedAt: _lssm_lib_schema747.EntityScalarField;
+  dismissedAt: _lssm_lib_schema747.EntityScalarField;
+  feedback: _lssm_lib_schema747.EntityScalarField;
+  feedbackRating: _lssm_lib_schema747.EntityScalarField;
+  expiresAt: _lssm_lib_schema747.EntityScalarField;
+  createdAt: _lssm_lib_schema747.EntityScalarField;
+  updatedAt: _lssm_lib_schema747.EntityScalarField;
+  learner: _lssm_lib_schema747.EntityRelationField;
+}> | _lssm_lib_schema747.EntitySpec<{
+  id: _lssm_lib_schema747.EntityScalarField;
+  learnerId: _lssm_lib_schema747.EntityScalarField;
+  skillId: _lssm_lib_schema747.EntityScalarField;
+  skillName: _lssm_lib_schema747.EntityScalarField;
+  severity: _lssm_lib_schema747.EntityScalarField;
+  confidence: _lssm_lib_schema747.EntityScalarField;
+  evidence: _lssm_lib_schema747.EntityScalarField;
+  relatedQuestions: _lssm_lib_schema747.EntityScalarField;
+  suggestedRemediation: _lssm_lib_schema747.EntityScalarField;
+  remediationProgress: _lssm_lib_schema747.EntityScalarField;
+  status: _lssm_lib_schema747.EntityScalarField;
+  resolvedAt: _lssm_lib_schema747.EntityScalarField;
+  detectedAt: _lssm_lib_schema747.EntityScalarField;
+  createdAt: _lssm_lib_schema747.EntityScalarField;
+  updatedAt: _lssm_lib_schema747.EntityScalarField;
+  learner: _lssm_lib_schema747.EntityRelationField;
+}>)[];
+declare const aiEnums: _lssm_lib_schema747.EntityEnumDef[];
+//#endregion
+export { LearnerProfileEntity, LearningGapEntity, LearningPathEntity, LearningStyleEnum, RecommendationEntity, RecommendationTypeEnum, SkillMapEntity, aiEntities, aiEnums };
+//# sourceMappingURL=ai.d.ts.map

package/dist/entities/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","names":[],"sources":["../../src/entities/ai.ts"],"sourcesContent":[],"mappings":";;;;;;AAKa,cAAA,iBAKX,EAAA,mBAAA,CAL4B,aAK5B;AAKF;AAiBA;;cAjBa,wBAYX,mBAAA,CAZiC;;;;cAiBtB,0CAAoB;MA2F/B,mBAAA,CAAA;;;;;;;;;;;;;;mDA3F+B;EAAA,cAAA,uCAAA;EAgGpB,QAAA,uCAoEX;EAAA,SAAA,uCAAA;;;;;;;cApEW,oCAAc;MAoEzB,mBAAA,CAAA;;;;;;;;yDApEyB;EAAA,YAAA,uCAAA;EAyEd,eAAA,uCAgFX;EAAA,gBAAA,uCAAA;;;;;;;;;cAhFW,wCAAkB;MAgF7B,mBAAA,CAAA;;;;;;;;;;;;yDAhF6B;EAAA,iBAAA,uCAAA;EAqFlB,QAAA,uCAwEX;EAAA,WAAA,uCAAA;;;;;;;;;;;cAxEW,0CAAoB;MAwE/B,mBAAA,CAAA;;;;;;;+CAxE+B;EAAA,OAAA,uCAAA;EA6EpB,MAAA,uCA8DX;EAAA,QAAA,uCAAA;;;;;;;;;;;;;cA9DW,uCAAiB;MA8D5B,mBAAA,CAAA;;gDA9D4B;EAAA,SAAA,uCAAA;EAgEjB,QAAA,uCAMZ;EAAA,UAAA,uCAAA;;;;;;;;;;;;cANY,iCAAU;MAMtB,mBAAA,CAAA;;;;;;;uDANsB;EAAA,aAAA,uCAAA;;;;;;;;;;;;;MAAA,mBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQV,UAAqD,uCAA9C;;;;;;;;;;;;cAAP,SAAqD,mBAAA,CAA9C,aAAA"}