@lssm/module.learning-journey 0.0.0-canary-20251217083314 → 0.0.0-canary-20251219202229

package/dist/contracts/operations.d.ts

@@ -1,138 +1,138 @@
-import * as _lssm_lib_schema2326 from "@lssm/lib.schema";
-import * as _lssm_lib_contracts34 from "@lssm/lib.contracts";
+import * as _lssm_lib_schema814 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts2 from "@lssm/lib.contracts";
 
 //#region src/contracts/operations.d.ts
 /**
  * Enroll in a course.
  */
-declare const EnrollInCourseContract: _lssm_lib_contracts34.ContractSpec<_lssm_lib_schema2326.SchemaModel<{
+declare const EnrollInCourseContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema814.SchemaModel<{
   courseId: {
-    type: _lssm_lib_schema2326.FieldType<string, string>;
+    type: _lssm_lib_schema814.FieldType<string, string>;
     isOptional: false;
   };
-}>, _lssm_lib_schema2326.SchemaModel<{
+}>, _lssm_lib_schema814.SchemaModel<{
   id: {
-    type: _lssm_lib_schema2326.FieldType<string, string>;
+    type: _lssm_lib_schema814.FieldType<string, string>;
     isOptional: false;
   };
   learnerId: {
-    type: _lssm_lib_schema2326.FieldType<string, string>;
+    type: _lssm_lib_schema814.FieldType<string, string>;
     isOptional: false;
   };
   courseId: {
-    type: _lssm_lib_schema2326.FieldType<string, string>;
+    type: _lssm_lib_schema814.FieldType<string, string>;
     isOptional: false;
   };
   status: {
-    type: _lssm_lib_schema2326.FieldType<string, string>;
+    type: _lssm_lib_schema814.FieldType<string, string>;
     isOptional: false;
   };
   progress: {
-    type: _lssm_lib_schema2326.FieldType<number, number>;
+    type: _lssm_lib_schema814.FieldType<number, number>;
     isOptional: false;
   };
   startedAt: {
-    type: _lssm_lib_schema2326.FieldType<Date, string>;
+    type: _lssm_lib_schema814.FieldType<Date, string>;
     isOptional: true;
   };
   completedAt: {
-    type: _lssm_lib_schema2326.FieldType<Date, string>;
+    type: _lssm_lib_schema814.FieldType<Date, string>;
     isOptional: true;
   };
 }>, undefined>;
 /**
  * Complete a lesson.
  */
-declare const CompleteLessonContract: _lssm_lib_contracts34.ContractSpec<_lssm_lib_schema2326.SchemaModel<{
+declare const CompleteLessonContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema814.SchemaModel<{
   lessonId: {
-    type: _lssm_lib_schema2326.FieldType<string, string>;
+    type: _lssm_lib_schema814.FieldType<string, string>;
     isOptional: false;
   };
   score: {
-    type: _lssm_lib_schema2326.FieldType<number, number>;
+    type: _lssm_lib_schema814.FieldType<number, number>;
     isOptional: true;
   };
   timeSpent: {
-    type: _lssm_lib_schema2326.FieldType<number, number>;
+    type: _lssm_lib_schema814.FieldType<number, number>;
     isOptional: false;
   };
-}>, _lssm_lib_schema2326.SchemaModel<{
+}>, _lssm_lib_schema814.SchemaModel<{
   success: {
-    type: _lssm_lib_schema2326.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema814.FieldType<boolean, boolean>;
     isOptional: false;
   };
   xpEarned: {
-    type: _lssm_lib_schema2326.FieldType<number, number>;
+    type: _lssm_lib_schema814.FieldType<number, number>;
     isOptional: true;
   };
 }>, undefined>;
 /**
  * Submit a card review.
  */
-declare const SubmitCardReviewContract: _lssm_lib_contracts34.ContractSpec<_lssm_lib_schema2326.SchemaModel<{
+declare const SubmitCardReviewContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema814.SchemaModel<{
   cardId: {
-    type: _lssm_lib_schema2326.FieldType<string, string>;
+    type: _lssm_lib_schema814.FieldType<string, string>;
     isOptional: false;
   };
   rating: {
-    type: _lssm_lib_schema2326.FieldType<string, string>;
+    type: _lssm_lib_schema814.FieldType<string, string>;
     isOptional: false;
   };
   responseTimeMs: {
-    type: _lssm_lib_schema2326.FieldType<number, number>;
+    type: _lssm_lib_schema814.FieldType<number, number>;
     isOptional: true;
   };
-}>, _lssm_lib_schema2326.SchemaModel<{
+}>, _lssm_lib_schema814.SchemaModel<{
   success: {
-    type: _lssm_lib_schema2326.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema814.FieldType<boolean, boolean>;
     isOptional: false;
   };
   xpEarned: {
-    type: _lssm_lib_schema2326.FieldType<number, number>;
+    type: _lssm_lib_schema814.FieldType<number, number>;
     isOptional: true;
   };
 }>, undefined>;
 /**
  * Get cards due for review.
  */
-declare const GetDueCardsContract: _lssm_lib_contracts34.ContractSpec<_lssm_lib_schema2326.SchemaModel<{
+declare const GetDueCardsContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema814.SchemaModel<{
   deckId: {
-    type: _lssm_lib_schema2326.FieldType<string, string>;
+    type: _lssm_lib_schema814.FieldType<string, string>;
     isOptional: true;
   };
   limit: {
-    type: _lssm_lib_schema2326.FieldType<number, number>;
+    type: _lssm_lib_schema814.FieldType<number, number>;
     isOptional: true;
   };
-}>, _lssm_lib_schema2326.SchemaModel<{
+}>, _lssm_lib_schema814.SchemaModel<{
   cards: {
-    type: _lssm_lib_schema2326.SchemaModel<{
+    type: _lssm_lib_schema814.SchemaModel<{
       id: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       deckId: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       front: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       back: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       hints: {
-        type: _lssm_lib_schema2326.FieldType<unknown, unknown>;
+        type: _lssm_lib_schema814.FieldType<unknown, unknown>;
         isOptional: true;
       };
       isDue: {
-        type: _lssm_lib_schema2326.FieldType<boolean, boolean>;
+        type: _lssm_lib_schema814.FieldType<boolean, boolean>;
         isOptional: false;
       };
       nextReviewAt: {
-        type: _lssm_lib_schema2326.FieldType<Date, string>;
+        type: _lssm_lib_schema814.FieldType<Date, string>;
         isOptional: true;
       };
     }>;
@@ -140,96 +140,96 @@ declare const GetDueCardsContract: _lssm_lib_contracts34.ContractSpec<_lssm_lib_
     isOptional: false;
   };
   total: {
-    type: _lssm_lib_schema2326.FieldType<number, number>;
+    type: _lssm_lib_schema814.FieldType<number, number>;
     isOptional: false;
   };
 }>, undefined>;
 /**
  * Get learner dashboard.
  */
-declare const GetLearnerDashboardContract: _lssm_lib_contracts34.ContractSpec<_lssm_lib_schema2326.SchemaModel<{
+declare const GetLearnerDashboardContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema814.SchemaModel<{
   learnerId: {
-    type: _lssm_lib_schema2326.FieldType<string, string>;
+    type: _lssm_lib_schema814.FieldType<string, string>;
     isOptional: true;
   };
-}>, _lssm_lib_schema2326.SchemaModel<{
+}>, _lssm_lib_schema814.SchemaModel<{
   learner: {
-    type: _lssm_lib_schema2326.SchemaModel<{
+    type: _lssm_lib_schema814.SchemaModel<{
       id: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       userId: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       displayName: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: true;
       };
       level: {
-        type: _lssm_lib_schema2326.FieldType<number, number>;
+        type: _lssm_lib_schema814.FieldType<number, number>;
         isOptional: false;
       };
       totalXp: {
-        type: _lssm_lib_schema2326.FieldType<number, number>;
+        type: _lssm_lib_schema814.FieldType<number, number>;
         isOptional: false;
       };
       currentStreak: {
-        type: _lssm_lib_schema2326.FieldType<number, number>;
+        type: _lssm_lib_schema814.FieldType<number, number>;
         isOptional: false;
       };
       longestStreak: {
-        type: _lssm_lib_schema2326.FieldType<number, number>;
+        type: _lssm_lib_schema814.FieldType<number, number>;
         isOptional: false;
       };
       createdAt: {
-        type: _lssm_lib_schema2326.FieldType<Date, string>;
+        type: _lssm_lib_schema814.FieldType<Date, string>;
         isOptional: false;
       };
     }>;
     isOptional: false;
   };
   currentStreak: {
-    type: _lssm_lib_schema2326.FieldType<number, number>;
+    type: _lssm_lib_schema814.FieldType<number, number>;
     isOptional: false;
   };
   dailyXpGoal: {
-    type: _lssm_lib_schema2326.FieldType<number, number>;
+    type: _lssm_lib_schema814.FieldType<number, number>;
     isOptional: false;
   };
   dailyXpProgress: {
-    type: _lssm_lib_schema2326.FieldType<number, number>;
+    type: _lssm_lib_schema814.FieldType<number, number>;
     isOptional: false;
   };
   activeEnrollments: {
-    type: _lssm_lib_schema2326.SchemaModel<{
+    type: _lssm_lib_schema814.SchemaModel<{
       id: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       learnerId: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       courseId: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       status: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       progress: {
-        type: _lssm_lib_schema2326.FieldType<number, number>;
+        type: _lssm_lib_schema814.FieldType<number, number>;
         isOptional: false;
       };
       startedAt: {
-        type: _lssm_lib_schema2326.FieldType<Date, string>;
+        type: _lssm_lib_schema814.FieldType<Date, string>;
         isOptional: true;
       };
       completedAt: {
-        type: _lssm_lib_schema2326.FieldType<Date, string>;
+        type: _lssm_lib_schema814.FieldType<Date, string>;
         isOptional: true;
       };
     }>;
@@ -237,33 +237,33 @@ declare const GetLearnerDashboardContract: _lssm_lib_contracts34.ContractSpec<_l
     isOptional: false;
   };
   recentAchievements: {
-    type: _lssm_lib_schema2326.SchemaModel<{
+    type: _lssm_lib_schema814.SchemaModel<{
       id: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       key: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       name: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       description: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: false;
       };
       icon: {
-        type: _lssm_lib_schema2326.FieldType<string, string>;
+        type: _lssm_lib_schema814.FieldType<string, string>;
         isOptional: true;
       };
       xpReward: {
-        type: _lssm_lib_schema2326.FieldType<number, number>;
+        type: _lssm_lib_schema814.FieldType<number, number>;
         isOptional: false;
       };
       unlockedAt: {
-        type: _lssm_lib_schema2326.FieldType<Date, string>;
+        type: _lssm_lib_schema814.FieldType<Date, string>;
         isOptional: true;
       };
     }>;
@@ -271,9 +271,10 @@ declare const GetLearnerDashboardContract: _lssm_lib_contracts34.ContractSpec<_l
     isOptional: false;
   };
   dueCardCount: {
-    type: _lssm_lib_schema2326.FieldType<number, number>;
+    type: _lssm_lib_schema814.FieldType<number, number>;
     isOptional: false;
   };
 }>, undefined>;
 //#endregion
-export { CompleteLessonContract, EnrollInCourseContract, GetDueCardsContract, GetLearnerDashboardContract, SubmitCardReviewContract };
+export { CompleteLessonContract, EnrollInCourseContract, GetDueCardsContract, GetLearnerDashboardContract, SubmitCardReviewContract };
+//# sourceMappingURL=operations.d.ts.map

package/dist/contracts/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","names":[],"sources":["../../src/contracts/operations.ts"],"sourcesContent":[],"mappings":";;;;;;;cAkBa,6CAAsB,iCAAA;EAAtB,QAAA,EAAA;IAgCX,IAAA,EAAA,mBAAA,CAAA,SAAA,CAAA,MAAA,EAAA,MAAA,CAAA;qBAhCiC;EAAA,CAAA;;;UAAA,mBAAA,CAAA;;;;;;;;IAAA,IAAA,+BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAqCtB,UAAA,EAAA,KAAA;EAgCX,CAAA;;;qBAhCiC;EAAA,CAAA;;;qBAAA;EAAA,CAAA;EAqCtB,SAAA,EAAA;IAgCX,IAAA,+BAAA,KAAA,EAAA,MAAA,CAAA;;;;IAhCmC,IAAA,+BAAA,KAAA,EAAA,MAAA,CAAA;;;;;AAqCrC;;cA1Ea,6CAAsB,iCAAA;;IA0EH,IAAA,EA1C9B,mBAAA,CAAA,SA0C8B,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;mCAAA,CAAA;EAAA,OAAA,EAAA;IAuBnB,IAAA,EAjGsB,mBAAA,CAAA,SAmHjC,CAAA,OAAA,EAAA,OAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;EAlBsC,QAAA,EAAA;;;;;;;;cA5D3B,+CAAwB,iCAAA;;UAgCnC,mBAAA,CAAA;;;;;;;;;;;;;UAhCmC,mBAAA,CAAA;;;;;;;;;;;cAqCxB,mBAuB2B,uBAvBR,YAuBQ,qBAvBR,WAuBQ,CAAA;EAAA,MAAA,EAAA;UALtC,mBAAA,CAAA;;;;;;;;;;;cAlB8B,mBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuBnB,kDAA2B,iCAAA;;UAkBtC,mBAAA,CAAA;;;;;;;cAlBsC,mBAAA,CAAA"}

package/dist/contracts/operations.js

@@ -148,4 +148,5 @@ const GetLearnerDashboardContract = defineQuery({
 });
 
 //#endregion
-export { CompleteLessonContract, EnrollInCourseContract, GetDueCardsContract, GetLearnerDashboardContract, SubmitCardReviewContract };
+export { CompleteLessonContract, EnrollInCourseContract, GetDueCardsContract, GetLearnerDashboardContract, SubmitCardReviewContract };
+//# sourceMappingURL=operations.js.map

package/dist/contracts/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","names":[],"sources":["../../src/contracts/operations.ts"],"sourcesContent":["import { defineCommand, defineQuery } from '@lssm/lib.contracts';\n\nimport {\n  CompleteLessonInput,\n  EnrollInCourseInput,\n  EnrollmentModel,\n  GetDueCardsInput,\n  GetDueCardsOutput,\n  GetLearnerDashboardInput,\n  LearnerDashboardModel,\n  SubmitCardReviewInput,\n  SuccessOutput,\n} from './models';\nimport { LEARNING_JOURNEY_OWNERS } from './shared';\n\n/**\n * Enroll in a course.\n */\nexport const EnrollInCourseContract = defineCommand({\n  meta: {\n    name: 'learning.enroll',\n    version: 1,\n    stability: 'stable',\n    owners: [...LEARNING_JOURNEY_OWNERS],\n    tags: ['learning', 'enrollment'],\n    description: 'Enroll in a course.',\n    goal: 'Start learning a new course.',\n    context: 'Called when a learner wants to start a course.',\n  },\n  io: {\n    input: EnrollInCourseInput,\n    output: EnrollmentModel,\n    errors: {\n      COURSE_NOT_FOUND: {\n        description: 'Course does not exist',\n        http: 404,\n        gqlCode: 'COURSE_NOT_FOUND',\n        when: 'Course ID is invalid',\n      },\n      ALREADY_ENROLLED: {\n        description: 'Already enrolled in course',\n        http: 409,\n        gqlCode: 'ALREADY_ENROLLED',\n        when: 'Learner is already enrolled',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * Complete a lesson.\n */\nexport const CompleteLessonContract = defineCommand({\n  meta: {\n    name: 'learning.completeLesson',\n    version: 1,\n    stability: 'stable',\n    owners: [...LEARNING_JOURNEY_OWNERS],\n    tags: ['learning', 'progress'],\n    description: 'Mark a lesson as completed.',\n    goal: 'Record lesson completion and earn XP.',\n    context: 'Called when a learner finishes a lesson.',\n  },\n  io: {\n    input: CompleteLessonInput,\n    output: SuccessOutput,\n    errors: {\n      LESSON_NOT_FOUND: {\n        description: 'Lesson does not exist',\n        http: 404,\n        gqlCode: 'LESSON_NOT_FOUND',\n        when: 'Lesson ID is invalid',\n      },\n      NOT_ENROLLED: {\n        description: 'Not enrolled in course',\n        http: 403,\n        gqlCode: 'NOT_ENROLLED',\n        when: 'Learner is not enrolled in the course',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * Submit a card review.\n */\nexport const SubmitCardReviewContract = defineCommand({\n  meta: {\n    name: 'learning.submitCardReview',\n    version: 1,\n    stability: 'stable',\n    owners: [...LEARNING_JOURNEY_OWNERS],\n    tags: ['learning', 'flashcards'],\n    description: 'Submit a flashcard review.',\n    goal: 'Record review and update SRS schedule.',\n    context: 'Called when reviewing flashcards.',\n  },\n  io: {\n    input: SubmitCardReviewInput,\n    output: SuccessOutput,\n    errors: {\n      CARD_NOT_FOUND: {\n        description: 'Card does not exist',\n        http: 404,\n        gqlCode: 'CARD_NOT_FOUND',\n        when: 'Card ID is invalid',\n      },\n      INVALID_RATING: {\n        description: 'Invalid rating',\n        http: 400,\n        gqlCode: 'INVALID_RATING',\n        when: 'Rating must be AGAIN, HARD, GOOD, or EASY',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * Get cards due for review.\n */\nexport const GetDueCardsContract = defineQuery({\n  meta: {\n    name: 'learning.getDueCards',\n    version: 1,\n    stability: 'stable',\n    owners: [...LEARNING_JOURNEY_OWNERS],\n    tags: ['learning', 'flashcards'],\n    description: 'Get flashcards due for review.',\n    goal: 'Get the next batch of cards to review.',\n    context: 'Called when starting a review session.',\n  },\n  io: {\n    input: GetDueCardsInput,\n    output: GetDueCardsOutput,\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * Get learner dashboard.\n */\nexport const GetLearnerDashboardContract = defineQuery({\n  meta: {\n    name: 'learning.getDashboard',\n    version: 1,\n    stability: 'stable',\n    owners: [...LEARNING_JOURNEY_OWNERS],\n    tags: ['learning', 'dashboard'],\n    description: 'Get learner dashboard data.',\n    goal: 'Display learner progress and stats.',\n    context: 'Called when viewing the learning dashboard.',\n  },\n  io: {\n    input: GetLearnerDashboardInput,\n    output: LearnerDashboardModel,\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n"],"mappings":";;;;;;;;;AAkBA,MAAa,yBAAyB,cAAc;CAClD,MAAM;EACJ,MAAM;EACN,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,wBAAwB;EACpC,MAAM,CAAC,YAAY,aAAa;EAChC,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACR,QAAQ;GACN,kBAAkB;IAChB,aAAa;IACb,MAAM;IACN,SAAS;IACT,MAAM;IACP;GACD,kBAAkB;IAChB,aAAa;IACb,MAAM;IACN,SAAS;IACT,MAAM;IACP;GACF;EACF;CACD,QAAQ,EACN,MAAM,QACP;CACF,CAAC;;;;AAKF,MAAa,yBAAyB,cAAc;CAClD,MAAM;EACJ,MAAM;EACN,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,wBAAwB;EACpC,MAAM,CAAC,YAAY,WAAW;EAC9B,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACR,QAAQ;GACN,kBAAkB;IAChB,aAAa;IACb,MAAM;IACN,SAAS;IACT,MAAM;IACP;GACD,cAAc;IACZ,aAAa;IACb,MAAM;IACN,SAAS;IACT,MAAM;IACP;GACF;EACF;CACD,QAAQ,EACN,MAAM,QACP;CACF,CAAC;;;;AAKF,MAAa,2BAA2B,cAAc;CACpD,MAAM;EACJ,MAAM;EACN,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,wBAAwB;EACpC,MAAM,CAAC,YAAY,aAAa;EAChC,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACR,QAAQ;GACN,gBAAgB;IACd,aAAa;IACb,MAAM;IACN,SAAS;IACT,MAAM;IACP;GACD,gBAAgB;IACd,aAAa;IACb,MAAM;IACN,SAAS;IACT,MAAM;IACP;GACF;EACF;CACD,QAAQ,EACN,MAAM,QACP;CACF,CAAC;;;;AAKF,MAAa,sBAAsB,YAAY;CAC7C,MAAM;EACJ,MAAM;EACN,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,wBAAwB;EACpC,MAAM,CAAC,YAAY,aAAa;EAChC,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ,EACN,MAAM,QACP;CACF,CAAC;;;;AAKF,MAAa,8BAA8B,YAAY;CACrD,MAAM;EACJ,MAAM;EACN,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,wBAAwB;EACpC,MAAM,CAAC,YAAY,YAAY;EAC/B,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ,EACN,MAAM,QACP;CACF,CAAC"}

package/dist/contracts/shared.d.ts

@@ -1,4 +1,5 @@
 //#region src/contracts/shared.d.ts
 declare const LEARNING_JOURNEY_OWNERS: readonly ["modules.learning-journey"];
 //#endregion
-export { LEARNING_JOURNEY_OWNERS };
+export { LEARNING_JOURNEY_OWNERS };
+//# sourceMappingURL=shared.d.ts.map

package/dist/contracts/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","names":[],"sources":["../../src/contracts/shared.ts"],"sourcesContent":[],"mappings":";cAAa"}

package/dist/contracts/shared.js

@@ -2,4 +2,5 @@
 const LEARNING_JOURNEY_OWNERS = ["modules.learning-journey"];
 
 //#endregion
-export { LEARNING_JOURNEY_OWNERS };
+export { LEARNING_JOURNEY_OWNERS };
+//# sourceMappingURL=shared.js.map

package/dist/contracts/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","names":[],"sources":["../../src/contracts/shared.ts"],"sourcesContent":["export const LEARNING_JOURNEY_OWNERS = ['modules.learning-journey'] as const;\n"],"mappings":";AAAA,MAAa,0BAA0B,CAAC,2BAA2B"}

package/dist/docs/learning-journey.docblock.js

@@ -133,4 +133,5 @@ const updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });
 	}
 ]);
 
-//#endregion
+//#endregion
+//# sourceMappingURL=learning-journey.docblock.js.map

package/dist/docs/learning-journey.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-journey.docblock.js","names":[],"sources":["../../src/docs/learning-journey.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '@lssm/lib.contracts/docs';\n\nconst learningJourneyDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.learning-journey.engine',\n    title: 'Learning Journey Engine',\n    summary:\n      'Tracks learners, tracks/modules/steps, progress, quizzes, streaks, XP, and AI coaching hooks for product-integrated onboarding.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/learning-journey/engine',\n    tags: ['learning', 'onboarding', 'journey', 'education'],\n    body: `## Capabilities\n\n- **Entities**: Learner, Track, Module, Step, Progress, Quiz, Flashcard, AI Coach, Gamification (XP, streaks, badges).\n- **Contracts**: enroll/resume/advance steps, complete quizzes, record streaks, assign XP, fetch progress dashboards, onboarding list/progress/recordEvent.\n- **Engines**: spaced-repetition (SRS), streak calculator, XP progression.\n- **Events**: learner.enrolled, step.completed, quiz.scored, streak.reset, xp.awarded, onboarding.started/completed/step_completed.\n\n## Completion conditions\n- Event-based: name/version/source + payload filter\n- Count-based: require N events (optional time window)\n- Time-bounded: must complete within a window; steps can unlock by day/hour\n- SRS mastery: complete when cards/skills hit mastery thresholds (with required counts)\n\n## Usage\n\n1) Compose schema\n- Include \\`learningJourneySchemaContribution\\` (entities export) in composition.\n\n2) Register contracts/events\n- Import from \\`@lssm/module.learning-journey\\` into your spec registry.\n\n3) Bind to product actions\n- Tie \\`Step\\` completion conditions to domain events (e.g., deal.created, agent.run.completed, drill.session.completed).\n- Trigger notifications via Notification Center and audits on completion.\n\n4) Gamification\n- Use \\`XP\\` and \\`Streak\\` engines to update learner stats; emit analytics for UI.\n\n## Example\n\n${'```'}ts\nimport { learningJourneyEntities } from '@lssm/module.learning-journey';\nimport { StreakEngine } from '@lssm/module.learning-journey/engines';\n\nconst streak = new StreakEngine({ graceDays: 1 });\nconst updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });\n${'```'},\n\n## Guardrails\n\n- Keep steps bound to real product events, not just button clicks.\n- Avoid storing PII in content; keep org/user scoping for multi-tenant isolation.\n- Emit analytics and audit logs for completions; respect \\`prefers-reduced-motion\\` in UIs consuming these specs.\n- Track completion bonuses: \\`completionXpBonus\\`, \\`completionBadgeKey\\`, optional \\`streakHoursWindow\\` + \\`streakBonusXp\\`.\n`,\n  },\n  {\n    id: 'docs.learning-journey.goal',\n    title: 'Learning Journey — Goal',\n    summary:\n      'Why the learning journey engine exists and the outcomes it targets.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/learning-journey/goal',\n    tags: ['learning', 'goal'],\n    body: `## Why it matters\n- Provides a regenerable onboarding/education engine tied to product signals.\n- Keeps tracks, steps, quizzes, and gamification consistent across surfaces.\n\n## Business/Product goal\n- Drive activation and retention with measurable progress, SRS, and streaks.\n- Allow product teams to adjust journeys safely via specs.\n\n## Success criteria\n- Journey changes regenerate UI/API/events without drift.\n- Analytics/audit hooks exist for completions and streaks.`,\n  },\n  {\n    id: 'docs.learning-journey.usage',\n    title: 'Learning Journey — Usage',\n    summary: 'How to compose, bind, and regenerate journeys safely.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/learning-journey/usage',\n    tags: ['learning', 'usage'],\n    body: `## Setup\n1) Include \\`learningJourneyEntities\\` in schema composition.\n2) Register contracts/events from \\`@lssm/module.learning-journey\\`.\n3) Bind steps to real product events (e.g., deal.created, run.completed).\n\n## Extend & regenerate\n1) Update track/module/step definitions or quiz schemas in spec.\n2) Regenerate to sync UI/API/events; mark PII paths where needed.\n3) Use Feature Flags to trial new tracks or streak rules.\n\n## Guardrails\n- Avoid hardcoded progression; keep engines declarative.\n- Emit analytics/audit for completions; respect user locale/accessibility in presentations.\n- Keep content free of PII; scope learners by org/tenant.`,\n  },\n  {\n    id: 'docs.learning-journey.constraints',\n    title: 'Learning Journey — Constraints & Safety',\n    summary:\n      'Internal guardrails for progression, telemetry, and regeneration semantics.',\n    kind: 'reference',\n    visibility: 'internal',\n    route: '/docs/learning-journey/constraints',\n    tags: ['learning', 'constraints', 'internal'],\n    body: `## Constraints\n- Progression (tracks/modules/steps) and engines (SRS, streaks, XP) must stay declarative in spec.\n- Events to emit: learner.enrolled, step.completed, quiz.scored, streak.reset, xp.awarded.\n- Regeneration should not change scoring/streak rules without explicit spec change.\n\n## PII & Telemetry\n- Mark PII (learner identifiers) and redact in presentations; keep telemetry aggregated when possible.\n- Respect accessibility (prefers-reduced-motion) in UIs consuming these specs.\n\n## Verification\n- Add fixtures for streak/XP rule changes and quiz scoring.\n- Ensure Notifications/Audit wiring persists for completions; analytics emitted for progress.\n- Use Feature Flags to trial new tracks or reward rules; default safe/off.`,\n  },\n];\n\nregisterDocBlocks(learningJourneyDocBlocks);\n"],"mappings":";;;;AAgIA,kBA7H6C;CAC3C;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAY;GAAc;GAAW;GAAY;EACxD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,YAAY,OAAO;EAC1B,MAAM;;;;;;;;;;;EAWP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,YAAY,QAAQ;EAC3B,MAAM;;;;;;;;;;;;;;EAcP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAY;GAAe;GAAW;EAC7C,MAAM;;;;;;;;;;;;;EAaP;CACF,CAE0C"}

package/dist/engines/srs.d.ts

@@ -107,4 +107,5 @@ declare class SRSEngine {
  */
 declare const srsEngine: SRSEngine;
 //#endregion
-export { CardRating, DEFAULT_SRS_CONFIG, ReviewResult, SRSConfig, SRSEngine, SRSState, srsEngine };
+export { CardRating, DEFAULT_SRS_CONFIG, ReviewResult, SRSConfig, SRSEngine, SRSState, srsEngine };
+//# sourceMappingURL=srs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"srs.d.ts","names":[],"sources":["../../src/engines/srs.ts"],"sourcesContent":[],"mappings":";;AAcA;AAEA;AAiBA;AAmBA;AAyBA;AAeA;;;;;AAaS,KA3FG,UAAA,GA2FH,OAAA,GAAA,MAAA,GAAA,MAAA,GAAA,MAAA;AACJ,UA1FY,QAAA,CA0FZ;EAyOgB;EAeC,QAAA,EAAA,MAAA;EAAW;EAOF,UAAA,EAAA,MAAA;EAAW;EAAiB,WAAA,EAAA,MAAA;EAmB9C;;;;;;;;;UA3VI,YAAA;;;;;;;;gBAQD;;;;;;;;;;UAWC,SAAA;;;;;;;;;;;;;;;;;;;;;;cAyBJ,oBAAoB;cAepB,SAAA;;uBAGS,QAAQ;;;;6BAQnB,kBACC,kBACH,OACJ;;;;;;;;;;;;;;;;qBAyOgB;;;;sBAeC,YAAW;;;;+BAOF,YAAW;;;;;;;cAmB7B,WAAS"}

package/dist/engines/srs.js

@@ -216,4 +216,5 @@ var SRSEngine = class {
 const srsEngine = new SRSEngine();
 
 //#endregion
-export { DEFAULT_SRS_CONFIG, SRSEngine, srsEngine };
+export { DEFAULT_SRS_CONFIG, SRSEngine, srsEngine };
+//# sourceMappingURL=srs.js.map

package/dist/engines/srs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"srs.js","names":["DEFAULT_SRS_CONFIG: SRSConfig","nextReviewAt: Date","newInterval: number"],"sources":["../../src/engines/srs.ts"],"sourcesContent":["/**\n * Spaced Repetition System (SRS) Engine\n *\n * Implements the SM-2 algorithm variant for optimal flashcard scheduling.\n *\n * The algorithm calculates the optimal time to review a card based on:\n * - User's rating of recall difficulty (again, hard, good, easy)\n * - Current interval between reviews\n * - Ease factor (how easy the card is for this user)\n * - Number of successful repetitions\n */\n\n// ============ Types ============\n\nexport type CardRating = 'AGAIN' | 'HARD' | 'GOOD' | 'EASY';\n\nexport interface SRSState {\n  /** Current interval in days */\n  interval: number;\n  /** Ease factor (typically 1.3 to 2.5+) */\n  easeFactor: number;\n  /** Number of successful repetitions */\n  repetitions: number;\n  /** Current learning step (for new cards) */\n  learningStep: number;\n  /** Whether card has graduated to review phase */\n  isGraduated: boolean;\n  /** Whether card is being relearned after a lapse */\n  isRelearning: boolean;\n  /** Number of times card was forgotten */\n  lapses: number;\n}\n\nexport interface ReviewResult {\n  /** New interval in days */\n  interval: number;\n  /** New ease factor */\n  easeFactor: number;\n  /** New repetition count */\n  repetitions: number;\n  /** Next review date */\n  nextReviewAt: Date;\n  /** New learning step */\n  learningStep: number;\n  /** Whether card has graduated */\n  isGraduated: boolean;\n  /** Whether card is being relearned */\n  isRelearning: boolean;\n  /** Updated lapse count */\n  lapses: number;\n}\n\nexport interface SRSConfig {\n  /** Learning steps in minutes [1, 10] = 1 min, 10 min */\n  learningSteps: number[];\n  /** Graduating interval in days */\n  graduatingInterval: number;\n  /** Easy interval (for easy button on new cards) */\n  easyInterval: number;\n  /** Relearning steps in minutes */\n  relearningSteps: number[];\n  /** Minimum ease factor */\n  minEaseFactor: number;\n  /** Maximum interval in days */\n  maxInterval: number;\n  /** Interval modifier (1.0 = 100%) */\n  intervalModifier: number;\n  /** New cards interval modifier */\n  newIntervalModifier: number;\n  /** Hard interval modifier */\n  hardIntervalModifier: number;\n  /** Easy bonus modifier */\n  easyBonus: number;\n}\n\n// ============ Default Configuration ============\n\nexport const DEFAULT_SRS_CONFIG: SRSConfig = {\n  learningSteps: [1, 10], // 1 minute, 10 minutes\n  graduatingInterval: 1, // 1 day\n  easyInterval: 4, // 4 days\n  relearningSteps: [10], // 10 minutes\n  minEaseFactor: 1.3,\n  maxInterval: 365, // 1 year\n  intervalModifier: 1.0,\n  newIntervalModifier: 0.5,\n  hardIntervalModifier: 1.2,\n  easyBonus: 1.3,\n};\n\n// ============ SRS Engine ============\n\nexport class SRSEngine {\n  private config: SRSConfig;\n\n  constructor(config: Partial<SRSConfig> = {}) {\n    this.config = { ...DEFAULT_SRS_CONFIG, ...config };\n  }\n\n  /**\n   * Calculate the next review state based on rating.\n   */\n  calculateNextReview(\n    state: SRSState,\n    rating: CardRating,\n    now: Date = new Date()\n  ): ReviewResult {\n    // Handle new/learning cards\n    if (!state.isGraduated && !state.isRelearning) {\n      return this.handleLearningCard(state, rating, now);\n    }\n\n    // Handle relearning cards\n    if (state.isRelearning) {\n      return this.handleRelearningCard(state, rating, now);\n    }\n\n    // Handle graduated cards in review\n    return this.handleReviewCard(state, rating, now);\n  }\n\n  /**\n   * Handle learning phase (new cards).\n   */\n  private handleLearningCard(\n    state: SRSState,\n    rating: CardRating,\n    now: Date\n  ): ReviewResult {\n    const steps = this.config.learningSteps;\n    let newStep = state.learningStep;\n    let isGraduated = false;\n    let interval = 0;\n    let nextReviewAt: Date;\n\n    switch (rating) {\n      case 'AGAIN':\n        // Reset to first step\n        newStep = 0;\n        interval = steps[0] ?? 1;\n        nextReviewAt = this.addMinutes(now, interval);\n        break;\n\n      case 'HARD':\n        // Stay at current step (or repeat first step)\n        interval = steps[newStep] ?? steps[0] ?? 1;\n        nextReviewAt = this.addMinutes(now, interval);\n        break;\n\n      case 'GOOD':\n        // Move to next step\n        newStep++;\n        if (newStep >= steps.length) {\n          // Graduate the card\n          isGraduated = true;\n          interval = this.config.graduatingInterval;\n          nextReviewAt = this.addDays(now, interval);\n        } else {\n          interval = steps[newStep] ?? 10;\n          nextReviewAt = this.addMinutes(now, interval);\n        }\n        break;\n\n      case 'EASY':\n        // Graduate immediately with easy interval\n        isGraduated = true;\n        interval = this.config.easyInterval;\n        nextReviewAt = this.addDays(now, interval);\n        break;\n    }\n\n    return {\n      interval: isGraduated ? interval : 0,\n      easeFactor: state.easeFactor,\n      repetitions: isGraduated ? 1 : 0,\n      nextReviewAt,\n      learningStep: newStep,\n      isGraduated,\n      isRelearning: false,\n      lapses: state.lapses,\n    };\n  }\n\n  /**\n   * Handle relearning phase (lapsed cards).\n   */\n  private handleRelearningCard(\n    state: SRSState,\n    rating: CardRating,\n    now: Date\n  ): ReviewResult {\n    const steps = this.config.relearningSteps;\n    let newStep = state.learningStep;\n    let isRelearning = true;\n    let interval = 0;\n    let nextReviewAt: Date;\n\n    switch (rating) {\n      case 'AGAIN':\n        // Reset to first relearning step\n        newStep = 0;\n        interval = steps[0] ?? 10;\n        nextReviewAt = this.addMinutes(now, interval);\n        break;\n\n      case 'HARD':\n        // Stay at current step\n        interval = steps[newStep] ?? steps[0] ?? 10;\n        nextReviewAt = this.addMinutes(now, interval);\n        break;\n\n      case 'GOOD':\n        // Move to next step or graduate back to review\n        newStep++;\n        if (newStep >= steps.length) {\n          isRelearning = false;\n          // Use reduced interval after lapse\n          interval = Math.max(\n            1,\n            Math.floor(state.interval * this.config.newIntervalModifier)\n          );\n          nextReviewAt = this.addDays(now, interval);\n        } else {\n          interval = steps[newStep] ?? 10;\n          nextReviewAt = this.addMinutes(now, interval);\n        }\n        break;\n\n      case 'EASY':\n        // Graduate immediately with slightly longer interval\n        isRelearning = false;\n        interval = Math.max(\n          1,\n          Math.floor(state.interval * this.config.newIntervalModifier * 1.5)\n        );\n        nextReviewAt = this.addDays(now, interval);\n        break;\n    }\n\n    return {\n      interval: isRelearning ? state.interval : interval,\n      easeFactor: state.easeFactor,\n      repetitions: isRelearning ? state.repetitions : state.repetitions + 1,\n      nextReviewAt,\n      learningStep: newStep,\n      isGraduated: true,\n      isRelearning,\n      lapses: state.lapses,\n    };\n  }\n\n  /**\n   * Handle review phase (graduated cards).\n   */\n  private handleReviewCard(\n    state: SRSState,\n    rating: CardRating,\n    now: Date\n  ): ReviewResult {\n    let newInterval: number;\n    let newEaseFactor = state.easeFactor;\n    let repetitions = state.repetitions;\n    let isRelearning = false;\n    let learningStep = 0;\n    let lapses = state.lapses;\n\n    switch (rating) {\n      case 'AGAIN':\n        // Card lapsed - move to relearning\n        lapses++;\n        isRelearning = true;\n        learningStep = 0;\n        newEaseFactor = Math.max(\n          this.config.minEaseFactor,\n          newEaseFactor - 0.2\n        );\n        newInterval = state.interval; // Keep old interval for reference\n        const relearnStep = this.config.relearningSteps[0] ?? 10;\n        return {\n          interval: newInterval,\n          easeFactor: newEaseFactor,\n          repetitions,\n          nextReviewAt: this.addMinutes(now, relearnStep),\n          learningStep,\n          isGraduated: true,\n          isRelearning: true,\n          lapses,\n        };\n\n      case 'HARD':\n        // Reduce interval slightly, reduce ease\n        newEaseFactor = Math.max(\n          this.config.minEaseFactor,\n          newEaseFactor - 0.15\n        );\n        newInterval = Math.max(\n          state.interval + 1,\n          state.interval * this.config.hardIntervalModifier\n        );\n        break;\n\n      case 'GOOD':\n        // Standard interval increase\n        newInterval =\n          state.interval * newEaseFactor * this.config.intervalModifier;\n        repetitions++;\n        break;\n\n      case 'EASY':\n        // Larger interval increase, increase ease\n        newEaseFactor = newEaseFactor + 0.15;\n        newInterval =\n          state.interval *\n          newEaseFactor *\n          this.config.easyBonus *\n          this.config.intervalModifier;\n        repetitions++;\n        break;\n    }\n\n    // Apply bounds\n    newInterval = Math.min(Math.round(newInterval), this.config.maxInterval);\n    newInterval = Math.max(1, newInterval);\n\n    return {\n      interval: newInterval,\n      easeFactor: newEaseFactor,\n      repetitions,\n      nextReviewAt: this.addDays(now, newInterval),\n      learningStep,\n      isGraduated: true,\n      isRelearning,\n      lapses,\n    };\n  }\n\n  /**\n   * Get initial SRS state for a new card.\n   */\n  getInitialState(): SRSState {\n    return {\n      interval: 0,\n      easeFactor: 2.5,\n      repetitions: 0,\n      learningStep: 0,\n      isGraduated: false,\n      isRelearning: false,\n      lapses: 0,\n    };\n  }\n\n  /**\n   * Check if a card is due for review.\n   */\n  isDue(nextReviewAt: Date, now: Date = new Date()): boolean {\n    return nextReviewAt <= now;\n  }\n\n  /**\n   * Calculate overdue days (negative if not yet due).\n   */\n  getOverdueDays(nextReviewAt: Date, now: Date = new Date()): number {\n    const diff = now.getTime() - nextReviewAt.getTime();\n    return Math.floor(diff / (1000 * 60 * 60 * 24));\n  }\n\n  // ============ Helpers ============\n\n  private addMinutes(date: Date, minutes: number): Date {\n    return new Date(date.getTime() + minutes * 60 * 1000);\n  }\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 SRS engine instance.\n */\nexport const srsEngine = new SRSEngine();\n"],"mappings":"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"}

package/dist/engines/streak.d.ts

@@ -96,4 +96,5 @@ declare class StreakEngine {
  */
 declare const streakEngine: StreakEngine;
 //#endregion
-export { DEFAULT_STREAK_CONFIG, StreakConfig, StreakEngine, StreakState, StreakUpdateResult, streakEngine };
+export { DEFAULT_STREAK_CONFIG, StreakConfig, StreakEngine, StreakState, StreakUpdateResult, streakEngine };
+//# sourceMappingURL=streak.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streak.d.ts","names":[],"sources":["../../src/engines/streak.ts"],"sourcesContent":[],"mappings":";;AAQA;AAeA;AAeA;AAaA;AASa,UApDI,WAAA,CAoDQ;EAGK;EAAR,aAAA,EAAA,MAAA;EAON;EAAkB,aAAA,EAAA,MAAA;EAAoB;EAmF3C,cAAA,EA3IO,IA2IP,GAAA,IAAA;EACF;EAGS,gBAAA,EAAA,MAAA,GAAA,IAAA;EAwDC;EAAkB,gBAAA,EAAA,MAAA;EAAoB;EAe5B,YAAA,EAhNb,IAgNa,GAAA,IAAA;;AAaR,UA1NJ,kBAAA,CA0NI;EAAW;EA0DnB,KAAA,EAlRJ,WAkRqC;;;;;;;;;;;;UArQ7B,YAAA;;;;;;;;;;cAaJ,uBAAuB;cASvB,YAAA;;uBAGS,QAAQ;;;;gBAOd,mBAAkB,OAAoB;;;;qBAmF3C,mBACF;;kBAGS;;;;;;;mBAwDC,mBAAkB,OAAoB;;;;6BAe5B,cAAc;;;;qBAatB;;;;;;;;;;;;;;;;;;;;;;;;cA0DR,cAAY"}

package/dist/engines/streak.js

@@ -190,4 +190,5 @@ var StreakEngine = class {
 const streakEngine = new StreakEngine();
 
 //#endregion
-export { DEFAULT_STREAK_CONFIG, StreakEngine, streakEngine };
+export { DEFAULT_STREAK_CONFIG, StreakEngine, streakEngine };
+//# sourceMappingURL=streak.js.map

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":";AAmDA,MAAaA,wBAAsC;CACjD,UAAU;CACV,iBAAiB;CACjB,YAAY;CACZ,kBAAkB;CACnB;AAID,IAAa,eAAb,MAA0B;CACxB,AAAQ;CAER,YAAY,SAAgC,EAAE,EAAE;AAC9C,OAAK,SAAS;GAAE,GAAG;GAAuB,GAAG;GAAQ;;;;;CAMvD,OAAO,OAAoB,sBAAY,IAAI,MAAM,EAAsB;EACrE,MAAM,YAAY,KAAK,cAAc,IAAI;EACzC,MAAMC,SAA6B;GACjC,OAAO,EAAE,GAAG,OAAO;GACnB,kBAAkB;GAClB,YAAY;GACZ,YAAY;GACZ,WAAW;GACX,YAAY;GACb;AAGD,MAAI,CAAC,MAAM,kBAAkB;AAC3B,UAAO,MAAM,gBAAgB;AAC7B,UAAO,MAAM,gBAAgB,KAAK,IAAI,GAAG,MAAM,cAAc;AAC7D,UAAO,MAAM,iBAAiB;AAC9B,UAAO,MAAM,mBAAmB;AAChC,UAAO,YAAY;AACnB,UAAO,mBAAmB;AAC1B,UAAO;;AAIT,MAAI,MAAM,qBAAqB,WAAW;AAExC,UAAO,MAAM,iBAAiB;AAC9B,UAAO,mBAAmB;AAC1B,UAAO;;EAIT,MAAM,oBAAoB,KAAK,eAC7B,MAAM,kBACN,UACD;AAED,MAAI,sBAAsB,GAAG;AAE3B,UAAO,MAAM,gBAAgB,MAAM,gBAAgB;AACnD,UAAO,MAAM,gBAAgB,KAAK,IAChC,OAAO,MAAM,eACb,MAAM,cACP;AACD,UAAO,MAAM,iBAAiB;AAC9B,UAAO,MAAM,mBAAmB;AAChC,UAAO,mBAAmB;AAC1B,UAAO;;AAIT,SAAO,aAAa,oBAAoB;EAGxC,MAAM,gBAAgB,OAAO;AAC7B,MAAI,iBAAiB,MAAM,kBAAkB;AAE3C,UAAO,MAAM,mBAAmB,MAAM,mBAAmB;AACzD,UAAO,MAAM,eAAe;AAC5B,UAAO,MAAM,gBAAgB,MAAM,gBAAgB;AACnD,UAAO,MAAM,gBAAgB,KAAK,IAChC,OAAO,MAAM,eACb,MAAM,cACP;AACD,UAAO,MAAM,iBAAiB;AAC9B,UAAO,MAAM,mBAAmB;AAChC,UAAO,aAAa;AACpB,UAAO,mBAAmB;AAC1B,UAAO;;AAIT,SAAO,aAAa;AACpB,SAAO,MAAM,gBAAgB;AAC7B,SAAO,MAAM,iBAAiB;AAC9B,SAAO,MAAM,mBAAmB;AAChC,SAAO,YAAY;AACnB,SAAO;;;;;CAMT,YACE,OACA,sBAAY,IAAI,MAAM,EAMtB;AACA,MAAI,CAAC,MAAM,iBACT,QAAO;GACL,UAAU;GACV,cAAc;GACd,cAAc;GACd,iBAAiB;GAClB;EAGH,MAAM,YAAY,KAAK,cAAc,IAAI;EACzC,MAAM,oBAAoB,KAAK,eAC7B,MAAM,kBACN,UACD;AAED,MAAI,sBAAsB,GAAG;GAE3B,MAAM,WAAW,KAAK,QAAQ,KAAK,EAAE;AACrC,YAAS,SAAS,IAAI,IAAI,IAAI,IAAI;AAClC,UAAO;IACL,UAAU;IACV,cAAc;IACd,cAAc,MAAM,mBAAmB;IACvC,iBAAiB;IAClB;;AAGH,MAAI,sBAAsB,GAAG;GAE3B,MAAM,WAAW,IAAI,KAAK,IAAI;AAC9B,YAAS,SAAS,KAAK,KAAK,OAAO,kBAAkB,IAAI,IAAI,IAAI;AACjE,UAAO;IACL,UAAU;IACV,cAAc;IACd,cAAc,MAAM,mBAAmB;IACvC,iBAAiB;IAClB;;EAIH,MAAM,aAAa,oBAAoB;AACvC,SAAO;GACL,UAAU,cAAc,MAAM;GAC9B,cAAc;GACd,cAAc,cAAc,MAAM;GAClC,iBAAiB,CAAC;GACnB;;;;;CAMH,UAAU,OAAoB,sBAAY,IAAI,MAAM,EAAsB;AACxE,MAAI,MAAM,oBAAoB,EAC5B,QAAO;AAGT,SAAO;GACL,GAAG;GACH,kBAAkB,MAAM,mBAAmB;GAC3C,cAAc;GACf;;;;;CAMH,oBAAoB,OAAiC;AACnD,SAAO;GACL,GAAG;GACH,kBAAkB,KAAK,IACrB,MAAM,mBAAmB,KAAK,OAAO,iBACrC,KAAK,OAAO,WACb;GACF;;;;;CAMH,kBAA+B;AAC7B,SAAO;GACL,eAAe;GACf,eAAe;GACf,gBAAgB;GAChB,kBAAkB;GAClB,kBAAkB,KAAK,OAAO;GAC9B,cAAc;GACf;;;;;CAMH,cAAc,eAGZ;EACA,MAAM,aAAa;GAAC;GAAG;GAAG;GAAI;GAAI;GAAI;GAAI;GAAK;GAAK;GAAK;GAAK;AAG9D,SAAO;GAAE,UAFQ,WAAW,QAAQ,MAAM,iBAAiB,EAAE;GAE1C,MADN,WAAW,MAAM,MAAM,gBAAgB,EAAE,IAAI;GACjC;;;;;CAQ3B,AAAQ,cAAc,MAAoB;AAKxC,SAAO,GAHM,KAAK,aAAa,CAGhB,GAFD,OAAO,KAAK,UAAU,GAAG,EAAE,CAAC,SAAS,GAAG,IAAI,CAElC,GADZ,OAAO,KAAK,SAAS,CAAC,CAAC,SAAS,GAAG,IAAI;;;;;CAOrD,AAAQ,eAAe,UAAkB,UAA0B;EACjE,MAAM,QAAQ,IAAI,KAAK,SAAS;EAEhC,MAAM,WADQ,IAAI,KAAK,SAAS,CACT,SAAS,GAAG,MAAM,SAAS;AAClD,SAAO,KAAK,MAAM,YAAY,MAAO,KAAK,KAAK,IAAI;;;;;CAMrD,AAAQ,QAAQ,MAAY,MAAoB;AAC9C,SAAO,IAAI,KAAK,KAAK,SAAS,GAAG,OAAO,KAAK,KAAK,KAAK,IAAK;;;;;;AAOhE,MAAa,eAAe,IAAI,cAAc"}

package/dist/engines/xp.d.ts

@@ -93,4 +93,5 @@ declare class XPEngine {
  */
 declare const xpEngine: XPEngine;
 //#endregion
-export { DEFAULT_XP_CONFIG, XPActivityType, XPBreakdown, XPCalculationInput, XPConfig, XPEngine, XPResult, xpEngine };
+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

@@ -209,4 +209,5 @@ var XPEngine = class {
 const xpEngine = new XPEngine();
 
 //#endregion
-export { DEFAULT_XP_CONFIG, XPEngine, xpEngine };
+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":";AA8EA,MAAaA,oBAA8B;CACzC,YAAY;EACV,iBAAiB;EACjB,WAAW;EACX,cAAc;EACd,kBAAkB;EAClB,iBAAiB;EACjB,iBAAiB;EACjB,cAAc;EACd,oBAAoB;EACpB,qBAAqB;EACrB,cAAc;EACd,iBAAiB;EACjB,qBAAqB;EACtB;CACD,iBAAiB;EACf;GAAE,KAAK;GAAI,YAAY;GAAK;EAC5B;GAAE,KAAK;GAAI,YAAY;GAAM;EAC7B;GAAE,KAAK;GAAI,YAAY;GAAK;EAC5B;GAAE,KAAK;GAAI,YAAY;GAAM;EAC7B;GAAE,KAAK;GAAG,YAAY;GAAK;EAC5B;CACD,aAAa;EACX;GAAE,MAAM;GAAK,OAAO;GAAI;EACxB;GAAE,MAAM;GAAK,OAAO;GAAI;EACxB;GAAE,MAAM;GAAI,OAAO;GAAI;EACvB;GAAE,MAAM;GAAI,OAAO;GAAI;EACvB;GAAE,MAAM;GAAI,OAAO;GAAI;EACvB;GAAE,MAAM;GAAG,OAAO;GAAG;EACrB;GAAE,MAAM;GAAG,OAAO;GAAG;EACrB;GAAE,MAAM;GAAG,OAAO;GAAG;EACtB;CACD,wBAAwB;CACxB,mBAAmB;CACnB,cAAc;CACd,sBAAsB;CACtB,qBAAqB;CACtB;AAID,IAAa,WAAb,MAAsB;CACpB,AAAQ;CAER,YAAY,SAA4B,EAAE,EAAE;AAC1C,OAAK,SAAS;GACZ,GAAG;GACH,GAAG;GACH,YAAY;IAAE,GAAG,kBAAkB;IAAY,GAAG,OAAO;IAAY;GACrE,iBACE,OAAO,mBAAmB,kBAAkB;GAC9C,aAAa,OAAO,eAAe,kBAAkB;GACtD;;;;;CAMH,UAAU,OAAqC;EAC7C,MAAMC,YAA2B,EAAE;EAGnC,MAAM,SAAS,MAAM,UAAU,KAAK,OAAO,WAAW,MAAM;EAC5D,IAAI,UAAU;AAEd,YAAU,KAAK;GACb,QAAQ;GACR,QAAQ;GACT,CAAC;AAGF,MAAI,MAAM,UAAU,QAAW;GAC7B,MAAM,kBAAkB,KAAK,mBAAmB,MAAM,MAAM;AAC5D,OAAI,oBAAoB,GAAK;IAC3B,MAAM,aAAa,KAAK,MAAM,UAAU,kBAAkB,GAAG;AAC7D,eAAW;AACX,cAAU,KAAK;KACb,QAAQ;KACR,QAAQ;KACR,YAAY;KACb,CAAC;;AAIJ,OAAI,MAAM,UAAU,KAAK;IACvB,MAAM,eAAe,KAAK,MACxB,UAAU,KAAK,OAAO,yBAAyB,GAChD;AACD,eAAW;AACX,cAAU,KAAK;KACb,QAAQ;KACR,QAAQ;KACR,YAAY,KAAK,OAAO;KACzB,CAAC;;;AAKN,MAAI,MAAM,kBAAkB,KAAK,CAAC,MAAM,SAAS;AAC/C,cAAW,KAAK,OAAO;AACvB,aAAU,KAAK;IACb,QAAQ;IACR,QAAQ,KAAK,OAAO;IACrB,CAAC;;AAIJ,MAAI,MAAM,SAAS;GACjB,MAAM,UAAU,KAAK,MAAM,WAAW,IAAI,KAAK,OAAO,cAAc;AACpE,cAAW;AACX,aAAU,KAAK;IACb,QAAQ;IACR,QAAQ,CAAC;IACT,YAAY,KAAK,OAAO;IACzB,CAAC;;AAIJ,MAAI,MAAM,iBAAiB,MAAM,gBAAgB,GAAG;GAClD,MAAM,cAAc,KAAK,eAAe,MAAM,cAAc;AAC5D,OAAI,cAAc,GAAG;AACnB,eAAW;AACX,cAAU,KAAK;KACb,QAAQ;KACR,QAAQ;KACT,CAAC;;;AAKN,MAAI,SAAS,EACX,WAAU,KAAK,IAAI,GAAG,QAAQ;AAGhC,SAAO;GACL,SAAS,KAAK,MAAM,QAAQ;GAC5B;GACA;GACD;;;;;CAMH,qBAAqB,eAAiC;EACpD,MAAM,QAAQ,KAAK,eAAe,cAAc;AAChD,SAAO;GACL,SAAS;GACT,QAAQ;GACR,WAAW,CACT;IACE,QAAQ;IACR,QAAQ;IACT,CACF;GACF;;;;;CAMH,cAAc,OAAuB;AAMnC,MAAI,SAAS,EAAG,QAAO;AACvB,SAAO,KAAK,MAAM,MAAM,KAAK,IAAI,QAAQ,GAAG,IAAI,CAAC;;;;;CAMnD,eAAe,SAIb;EACA,IAAI,QAAQ;EACZ,IAAI,aAAa,KAAK,cAAc,QAAQ,EAAE;AAE9C,SAAO,WAAW,cAAc,QAAQ,KAAM;AAC5C;AACA,gBAAa,KAAK,cAAc,QAAQ,EAAE;;EAG5C,MAAM,oBAAoB,KAAK,cAAc,MAAM;EACnD,MAAM,iBAAiB,KAAK,cAAc,QAAQ,EAAE;AAEpD,SAAO;GACL;GACA,WAAW,UAAU;GACrB,gBAAgB,iBAAiB;GAClC;;CAKH,AAAQ,mBAAmB,OAAuB;AAChD,OAAK,MAAM,aAAa,KAAK,OAAO,gBAClC,KAAI,SAAS,UAAU,IACrB,QAAO,UAAU;AAGrB,SAAO;;CAGT,AAAQ,eAAe,QAAwB;AAC7C,OAAK,MAAM,QAAQ,KAAK,OAAO,YAC7B,KAAI,UAAU,KAAK,KACjB,QAAO,KAAK;AAGhB,SAAO;;;;;;AAOX,MAAa,WAAW,IAAI,UAAU"}