@contractspec/module.learning-journey 3.7.18 → 4.0.1

package/dist/index.js

@@ -1,16 +1,17 @@
 // @bun
-import{defineSchemaModel as M,ScalarTypeEnum as O}from"@contractspec/lib.schema";var C0=M({name:"Course",description:"A learning course",fields:{id:{type:O.String_unsecure(),isOptional:!1},title:{type:O.String_unsecure(),isOptional:!1},slug:{type:O.String_unsecure(),isOptional:!1},description:{type:O.String_unsecure(),isOptional:!0},difficulty:{type:O.String_unsecure(),isOptional:!1},status:{type:O.String_unsecure(),isOptional:!1},estimatedDuration:{type:O.Int_unsecure(),isOptional:!0},thumbnailUrl:{type:O.String_unsecure(),isOptional:!0},createdAt:{type:O.DateTime(),isOptional:!1}}}),yj=M({name:"Learner",description:"A learner profile",fields:{id:{type:O.String_unsecure(),isOptional:!1},userId:{type:O.String_unsecure(),isOptional:!1},displayName:{type:O.String_unsecure(),isOptional:!0},level:{type:O.Int_unsecure(),isOptional:!1},totalXp:{type:O.Int_unsecure(),isOptional:!1},currentStreak:{type:O.Int_unsecure(),isOptional:!1},longestStreak:{type:O.Int_unsecure(),isOptional:!1},createdAt:{type:O.DateTime(),isOptional:!1}}}),S=M({name:"Enrollment",description:"A course enrollment",fields:{id:{type:O.String_unsecure(),isOptional:!1},learnerId:{type:O.String_unsecure(),isOptional:!1},courseId:{type:O.String_unsecure(),isOptional:!1},status:{type:O.String_unsecure(),isOptional:!1},progress:{type:O.Int_unsecure(),isOptional:!1},startedAt:{type:O.DateTime(),isOptional:!0},completedAt:{type:O.DateTime(),isOptional:!0}}}),L0=M({name:"LessonProgress",description:"Lesson progress",fields:{id:{type:O.String_unsecure(),isOptional:!1},learnerId:{type:O.String_unsecure(),isOptional:!1},lessonId:{type:O.String_unsecure(),isOptional:!1},status:{type:O.String_unsecure(),isOptional:!1},progress:{type:O.Int_unsecure(),isOptional:!1},score:{type:O.Int_unsecure(),isOptional:!0},timeSpent:{type:O.Int_unsecure(),isOptional:!1},completedAt:{type:O.DateTime(),isOptional:!0}}}),h0=M({name:"Deck",description:"A flashcard deck",fields:{id:{type:O.String_unsecure(),isOptional:!1},title:{type:O.String_unsecure(),isOptional:!1},description:{type:O.String_unsecure(),isOptional:!0},cardCount:{type:O.Int_unsecure(),isOptional:!1},isPublic:{type:O.Boolean(),isOptional:!1},createdAt:{type:O.DateTime(),isOptional:!1}}}),Sj=M({name:"Card",description:"A flashcard",fields:{id:{type:O.String_unsecure(),isOptional:!1},deckId:{type:O.String_unsecure(),isOptional:!1},front:{type:O.String_unsecure(),isOptional:!1},back:{type:O.String_unsecure(),isOptional:!1},hints:{type:O.JSON(),isOptional:!0},isDue:{type:O.Boolean(),isOptional:!1},nextReviewAt:{type:O.DateTime(),isOptional:!0}}}),rj=M({name:"Achievement",description:"An achievement",fields:{id:{type:O.String_unsecure(),isOptional:!1},key:{type:O.String_unsecure(),isOptional:!1},name:{type:O.String_unsecure(),isOptional:!1},description:{type:O.String_unsecure(),isOptional:!1},icon:{type:O.String_unsecure(),isOptional:!0},xpReward:{type:O.Int_unsecure(),isOptional:!1},unlockedAt:{type:O.DateTime(),isOptional:!0}}}),E=M({name:"EnrollInCourseInput",description:"Input for enrolling in a course",fields:{courseId:{type:O.String_unsecure(),isOptional:!1}}}),t=M({name:"CompleteLessonInput",description:"Input for completing a lesson",fields:{lessonId:{type:O.String_unsecure(),isOptional:!1},score:{type:O.Int_unsecure(),isOptional:!0},timeSpent:{type:O.Int_unsecure(),isOptional:!1}}}),f=M({name:"SubmitCardReviewInput",description:"Input for submitting a card review",fields:{cardId:{type:O.String_unsecure(),isOptional:!1},rating:{type:O.String_unsecure(),isOptional:!1},responseTimeMs:{type:O.Int_unsecure(),isOptional:!0}}}),a=M({name:"GetDueCardsInput",description:"Input for getting due cards",fields:{deckId:{type:O.String_unsecure(),isOptional:!0},limit:{type:O.Int_unsecure(),isOptional:!0}}}),n=M({name:"GetDueCardsOutput",description:"Output for getting due cards",fields:{cards:{type:Sj,isArray:!0,isOptional:!1},total:{type:O.Int_unsecure(),isOptional:!1}}}),l=M({name:"GetLearnerDashboardInput",description:"Input for getting learner dashboard",fields:{learnerId:{type:O.String_unsecure(),isOptional:!0}}}),d=M({name:"LearnerDashboard",description:"Learner dashboard data",fields:{learner:{type:yj,isOptional:!1},currentStreak:{type:O.Int_unsecure(),isOptional:!1},dailyXpGoal:{type:O.Int_unsecure(),isOptional:!1},dailyXpProgress:{type:O.Int_unsecure(),isOptional:!1},activeEnrollments:{type:S,isArray:!0,isOptional:!1},recentAchievements:{type:rj,isArray:!0,isOptional:!1},dueCardCount:{type:O.Int_unsecure(),isOptional:!1}}}),N=M({name:"SuccessOutput",description:"Generic success output",fields:{success:{type:O.Boolean(),isOptional:!1},xpEarned:{type:O.Int_unsecure(),isOptional:!0}}});var J=["modules.learning-journey"];import{defineCommand as cj,defineQuery as i}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as g,ScalarTypeEnum as D}from"@contractspec/lib.schema";var mj=g({name:"OnboardingStepCondition",description:"Structured completion condition for onboarding steps.",fields:{eventName:{type:D.String_unsecure(),isOptional:!1},eventVersion:{type:D.String_unsecure(),isOptional:!0},sourceModule:{type:D.String_unsecure(),isOptional:!0},payloadFilter:{type:D.JSON(),isOptional:!0}}}),Ej=g({name:"OnboardingStep",description:"Declarative onboarding step definition.",fields:{id:{type:D.String_unsecure(),isOptional:!1},trackId:{type:D.String_unsecure(),isOptional:!1},title:{type:D.String_unsecure(),isOptional:!1},description:{type:D.String_unsecure(),isOptional:!0},instructions:{type:D.String_unsecure(),isOptional:!0},helpUrl:{type:D.String_unsecure(),isOptional:!0},order:{type:D.Int_unsecure(),isOptional:!1},completionEvent:{type:D.String_unsecure(),isOptional:!1},completionCondition:{type:mj,isOptional:!0},xpReward:{type:D.Int_unsecure(),isOptional:!0},isRequired:{type:D.Boolean(),isOptional:!0},canSkip:{type:D.Boolean(),isOptional:!0},actionUrl:{type:D.String_unsecure(),isOptional:!0},actionLabel:{type:D.String_unsecure(),isOptional:!0},metadata:{type:D.JSON(),isOptional:!0}}}),tj=g({name:"OnboardingTrack",description:"Onboarding track metadata and steps.",fields:{id:{type:D.String_unsecure(),isOptional:!1},productId:{type:D.String_unsecure(),isOptional:!0},name:{type:D.String_unsecure(),isOptional:!1},description:{type:D.String_unsecure(),isOptional:!0},targetUserSegment:{type:D.String_unsecure(),isOptional:!0},targetRole:{type:D.String_unsecure(),isOptional:!0},isActive:{type:D.Boolean(),isOptional:!0},isRequired:{type:D.Boolean(),isOptional:!0},canSkip:{type:D.Boolean(),isOptional:!0},totalXp:{type:D.Int_unsecure(),isOptional:!0},completionXpBonus:{type:D.Int_unsecure(),isOptional:!0},completionBadgeKey:{type:D.String_unsecure(),isOptional:!0},streakHoursWindow:{type:D.Int_unsecure(),isOptional:!0},streakBonusXp:{type:D.Int_unsecure(),isOptional:!0},metadata:{type:D.JSON(),isOptional:!0},steps:{type:Ej,isArray:!0,isOptional:!1}}}),fj=g({name:"OnboardingStepProgress",description:"Progress for a specific onboarding step.",fields:{stepId:{type:D.String_unsecure(),isOptional:!1},status:{type:D.String_unsecure(),isOptional:!1},xpEarned:{type:D.Int_unsecure(),isOptional:!0},triggeringEvent:{type:D.String_unsecure(),isOptional:!0},eventPayload:{type:D.JSON(),isOptional:!0},completedAt:{type:D.DateTime(),isOptional:!0}}}),e=g({name:"OnboardingProgress",description:"Aggregated progress for an onboarding track.",fields:{learnerId:{type:D.String_unsecure(),isOptional:!0},trackId:{type:D.String_unsecure(),isOptional:!1},progress:{type:D.Int_unsecure(),isOptional:!1},isCompleted:{type:D.Boolean(),isOptional:!1},xpEarned:{type:D.Int_unsecure(),isOptional:!0},startedAt:{type:D.DateTime(),isOptional:!0},completedAt:{type:D.DateTime(),isOptional:!0},lastActivityAt:{type:D.DateTime(),isOptional:!0},steps:{type:fj,isArray:!0,isOptional:!0}}}),aj=g({name:"ListOnboardingTracksInput",description:"Filters for listing onboarding tracks.",fields:{learnerId:{type:D.String_unsecure(),isOptional:!0},productId:{type:D.String_unsecure(),isOptional:!0},trackIds:{type:D.String_unsecure(),isArray:!0,isOptional:!0},includeProgress:{type:D.Boolean(),isOptional:!0}}}),nj=g({name:"ListOnboardingTracksOutput",description:"Available onboarding tracks with optional progress.",fields:{tracks:{type:tj,isArray:!0,isOptional:!1},progress:{type:e,isArray:!0,isOptional:!0}}}),lj=g({name:"GetOnboardingProgressInput",description:"Input for fetching onboarding progress for a track.",fields:{trackId:{type:D.String_unsecure(),isOptional:!1},learnerId:{type:D.String_unsecure(),isOptional:!0}}}),dj=g({name:"RecordOnboardingEventInput",description:"Record a domain event to advance onboarding progress via completion conditions.",fields:{learnerId:{type:D.String_unsecure(),isOptional:!1},trackId:{type:D.String_unsecure(),isOptional:!0},eventName:{type:D.String_unsecure(),isOptional:!1},eventVersion:{type:D.String_unsecure(),isOptional:!0},eventPayload:{type:D.JSON(),isOptional:!0},occurredAt:{type:D.DateTime(),isOptional:!0}}}),R0=i({meta:{key:"learning.onboarding.listTracks",version:"1.0.0",stability:"stable",owners:[...J],tags:["learning","onboarding","journey"],description:"List onboarding tracks available to a learner or product.",goal:"Expose track catalog for UI/API surfaces.",context:"Called when showing onboarding/learning journey catalog."},io:{input:aj,output:nj},policy:{auth:"user"}}),w0=i({meta:{key:"learning.onboarding.getProgress",version:"1.0.0",stability:"stable",owners:[...J],tags:["learning","onboarding","journey"],description:"Fetch onboarding progress for a specific track.",goal:"Display learner progress and remaining steps.",context:"Called when rendering a track detail or widget."},io:{input:lj,output:e},policy:{auth:"user"}}),s0=cj({meta:{key:"learning.onboarding.recordEvent",version:"1.0.0",stability:"stable",owners:[...J],tags:["learning","onboarding","events"],description:"Record a domain event to evaluate onboarding step completion conditions.",goal:"Advance onboarding automatically from product events.",context:"Called by event bus handlers when relevant product events fire (e.g., deal.created)."},io:{input:dj,output:N,errors:{TRACK_NOT_FOUND:{description:"Track not found for event routing",http:404,gqlCode:"TRACK_NOT_FOUND",when:"Track ID or routing context is invalid"},STEP_NOT_FOUND:{description:"Step not found for completion condition",http:404,gqlCode:"STEP_NOT_FOUND",when:"No step matches the incoming event"}}},policy:{auth:"user"}});import{defineCommand as r,defineQuery as jj}from"@contractspec/lib.contracts-spec";var S0=r({meta:{key:"learning.enroll",version:"1.0.0",stability:"stable",owners:[...J],tags:["learning","enrollment"],description:"Enroll in a course.",goal:"Start learning a new course.",context:"Called when a learner wants to start a course."},io:{input:E,output:S,errors:{COURSE_NOT_FOUND:{description:"Course does not exist",http:404,gqlCode:"COURSE_NOT_FOUND",when:"Course ID is invalid"},ALREADY_ENROLLED:{description:"Already enrolled in course",http:409,gqlCode:"ALREADY_ENROLLED",when:"Learner is already enrolled"}}},policy:{auth:"user"}}),r0=r({meta:{key:"learning.completeLesson",version:"1.0.0",stability:"stable",owners:[...J],tags:["learning","progress"],description:"Mark a lesson as completed.",goal:"Record lesson completion and earn XP.",context:"Called when a learner finishes a lesson."},io:{input:t,output:N,errors:{LESSON_NOT_FOUND:{description:"Lesson does not exist",http:404,gqlCode:"LESSON_NOT_FOUND",when:"Lesson ID is invalid"},NOT_ENROLLED:{description:"Not enrolled in course",http:403,gqlCode:"NOT_ENROLLED",when:"Learner is not enrolled in the course"}}},policy:{auth:"user"}}),c0=r({meta:{key:"learning.submitCardReview",version:"1.0.0",stability:"stable",owners:[...J],tags:["learning","flashcards"],description:"Submit a flashcard review.",goal:"Record review and update SRS schedule.",context:"Called when reviewing flashcards."},io:{input:f,output:N,errors:{CARD_NOT_FOUND:{description:"Card does not exist",http:404,gqlCode:"CARD_NOT_FOUND",when:"Card ID is invalid"},INVALID_RATING:{description:"Invalid rating",http:400,gqlCode:"INVALID_RATING",when:"Rating must be AGAIN, HARD, GOOD, or EASY"}}},policy:{auth:"user"}}),m0=jj({meta:{key:"learning.getDueCards",version:"1.0.0",stability:"stable",owners:[...J],tags:["learning","flashcards"],description:"Get flashcards due for review.",goal:"Get the next batch of cards to review.",context:"Called when starting a review session."},io:{input:a,output:n},policy:{auth:"user"}}),E0=jj({meta:{key:"learning.getDashboard",version:"1.0.0",stability:"stable",owners:[...J],tags:["learning","dashboard"],description:"Get learner dashboard data.",goal:"Display learner progress and stats.",context:"Called when viewing the learning dashboard."},io:{input:l,output:d},policy:{auth:"user"}});import{registerDocBlocks as ij}from"@contractspec/lib.contracts-spec/docs";var ej=[{id:"docs.learning-journey.engine",title:"Learning Journey Engine",summary:"Tracks learners, tracks/modules/steps, progress, quizzes, streaks, XP, and AI coaching hooks for product-integrated onboarding.",kind:"reference",visibility:"public",route:"/docs/learning-journey/engine",tags:["learning","onboarding","journey","education"],body:`## Capabilities
+var P=["modules.learning-journey"];import{defineCommand as ct,defineQuery as gr}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as L,ScalarTypeEnum as k}from"@contractspec/lib.schema";var gt=L({name:"JourneyCondition",description:"Adaptive completion condition for a journey step.",fields:{kind:{type:k.String_unsecure(),isOptional:!0},eventName:{type:k.String_unsecure(),isOptional:!1},eventVersion:{type:k.Int_unsecure(),isOptional:!0},sourceModule:{type:k.String_unsecure(),isOptional:!0},payloadFilter:{type:k.JSON(),isOptional:!0},atLeast:{type:k.Int_unsecure(),isOptional:!0},withinHours:{type:k.Int_unsecure(),isOptional:!0},withinHoursOfStart:{type:k.Int_unsecure(),isOptional:!0},availableAfterHours:{type:k.Int_unsecure(),isOptional:!0},skillIdField:{type:k.String_unsecure(),isOptional:!0},masteryField:{type:k.String_unsecure(),isOptional:!0},minimumMastery:{type:k.Float_unsecure(),isOptional:!0},requiredCount:{type:k.Int_unsecure(),isOptional:!0}}}),kr=L({name:"JourneyReward",description:"XP and badge rewards for journey outcomes.",fields:{badgeKey:{type:k.String_unsecure(),isOptional:!0},xp:{type:k.Int_unsecure(),isOptional:!0}}}),kt=L({name:"JourneyStep",description:"Adaptive learning journey step definition.",fields:{id:{type:k.String_unsecure(),isOptional:!1},title:{type:k.String_unsecure(),isOptional:!1},description:{type:k.String_unsecure(),isOptional:!0},instructions:{type:k.String_unsecure(),isOptional:!0},helpUrl:{type:k.String_unsecure(),isOptional:!0},order:{type:k.Int_unsecure(),isOptional:!0},completion:{type:gt,isOptional:!1},availability:{type:k.JSON(),isOptional:!0},prerequisites:{type:k.JSON(),isOptional:!0},prerequisiteMode:{type:k.String_unsecure(),isOptional:!0},branches:{type:k.JSON(),isOptional:!0},reward:{type:kr,isOptional:!0},xpReward:{type:k.Int_unsecure(),isOptional:!0},isRequired:{type:k.Boolean(),isOptional:!0},canSkip:{type:k.Boolean(),isOptional:!0},actionUrl:{type:k.String_unsecure(),isOptional:!0},actionLabel:{type:k.String_unsecure(),isOptional:!0},metadata:{type:k.JSON(),isOptional:!0}}}),Jt=L({name:"JourneyTrack",description:"Headless adaptive journey track definition.",fields:{id:{type:k.String_unsecure(),isOptional:!1},productId:{type:k.String_unsecure(),isOptional:!0},name:{type:k.String_unsecure(),isOptional:!1},description:{type:k.String_unsecure(),isOptional:!0},targetUserSegment:{type:k.String_unsecure(),isOptional:!0},targetRole:{type:k.String_unsecure(),isOptional:!0},totalXp:{type:k.Int_unsecure(),isOptional:!0},isActive:{type:k.Boolean(),isOptional:!0},isRequired:{type:k.Boolean(),isOptional:!0},canSkip:{type:k.Boolean(),isOptional:!0},streakRule:{type:k.JSON(),isOptional:!0},completionRewards:{type:kr,isOptional:!0},metadata:{type:k.JSON(),isOptional:!0},steps:{type:kt,isArray:!0,isOptional:!1}}}),ht=L({name:"JourneyStepProgress",description:"Persisted and projected state for a journey step.",fields:{stepId:{type:k.String_unsecure(),isOptional:!1},status:{type:k.String_unsecure(),isOptional:!1},xpEarned:{type:k.Int_unsecure(),isOptional:!1},selectedBranchKey:{type:k.String_unsecure(),isOptional:!0},availableAt:{type:k.DateTime(),isOptional:!0},dueAt:{type:k.DateTime(),isOptional:!0},completedAt:{type:k.DateTime(),isOptional:!0},skippedAt:{type:k.DateTime(),isOptional:!0},blockedAt:{type:k.DateTime(),isOptional:!0},missedAt:{type:k.DateTime(),isOptional:!0},triggeringEvent:{type:k.String_unsecure(),isOptional:!0},eventPayload:{type:k.JSON(),isOptional:!0},occurrences:{type:k.Int_unsecure(),isOptional:!0},masteryCount:{type:k.Int_unsecure(),isOptional:!0}}}),E=L({name:"JourneyProgress",description:"Projected adaptive journey progress snapshot.",fields:{learnerId:{type:k.String_unsecure(),isOptional:!0},trackId:{type:k.String_unsecure(),isOptional:!1},progressPercent:{type:k.Int_unsecure(),isOptional:!1},isCompleted:{type:k.Boolean(),isOptional:!1},xpEarned:{type:k.Int_unsecure(),isOptional:!1},streakDays:{type:k.Int_unsecure(),isOptional:!1},badges:{type:k.String_unsecure(),isArray:!0,isOptional:!1},activeStepCount:{type:k.Int_unsecure(),isOptional:!1},completedStepCount:{type:k.Int_unsecure(),isOptional:!1},nextStepId:{type:k.String_unsecure(),isOptional:!0},currentStepId:{type:k.String_unsecure(),isOptional:!0},startedAt:{type:k.DateTime(),isOptional:!0},completedAt:{type:k.DateTime(),isOptional:!0},lastActivityAt:{type:k.DateTime(),isOptional:!0},steps:{type:ht,isArray:!0,isOptional:!1}}}),bt=L({name:"JourneyTrackListInput",description:"Filters for listing adaptive journey tracks.",fields:{learnerId:{type:k.String_unsecure(),isOptional:!0},productId:{type:k.String_unsecure(),isOptional:!0},trackIds:{type:k.String_unsecure(),isArray:!0,isOptional:!0},includeProgress:{type:k.Boolean(),isOptional:!0}}}),at=L({name:"JourneyTrackListOutput",description:"Adaptive journey catalog with optional progress snapshots.",fields:{tracks:{type:Jt,isArray:!0,isOptional:!1},progress:{type:E,isArray:!0,isOptional:!0}}}),It=L({name:"JourneyProgressInput",description:"Input for fetching projected progress for one track.",fields:{learnerId:{type:k.String_unsecure(),isOptional:!0},trackId:{type:k.String_unsecure(),isOptional:!1}}}),At=L({name:"JourneyRecordEventInput",description:"Domain event used to advance an adaptive journey.",fields:{learnerId:{type:k.String_unsecure(),isOptional:!1},trackId:{type:k.String_unsecure(),isOptional:!0},eventName:{type:k.String_unsecure(),isOptional:!1},eventVersion:{type:k.Int_unsecure(),isOptional:!0},sourceModule:{type:k.String_unsecure(),isOptional:!0},eventPayload:{type:k.JSON(),isOptional:!0},occurredAt:{type:k.DateTime(),isOptional:!0}}}),no=gr({meta:{key:"learning.journey.listTracks",version:"1.0.0",stability:"stable",owners:[...P],tags:["adaptive-learning","journey","learning"],description:"List adaptive learning journeys for a learner or product.",goal:"Expose the adaptive journey catalog to UI and API surfaces.",context:"Called when rendering journey lists, launchers, or registries."},io:{input:bt,output:at},policy:{auth:"user"}}),po=gr({meta:{key:"learning.journey.getProgress",version:"1.0.0",stability:"stable",owners:[...P],tags:["adaptive-learning","journey","progress"],description:"Project the latest adaptive journey progress for one track.",goal:"Render next-step, branch, and reward state consistently.",context:"Called by widgets, journey detail pages, and adaptive shells."},io:{input:It,output:E},policy:{auth:"user"}}),uo=ct({meta:{key:"learning.journey.recordEvent",version:"1.0.0",stability:"stable",owners:[...P],tags:["adaptive-learning","journey","events"],description:"Record a domain event and re-evaluate an adaptive journey.",goal:"Advance branch-aware journey progress from product activity.",context:"Called by event handlers when product activity may unlock or complete steps."},io:{input:At,output:E},policy:{auth:"user"}});import{defineSchemaModel as y,ScalarTypeEnum as h}from"@contractspec/lib.schema";var ko=y({name:"Course",description:"A learning course",fields:{id:{type:h.String_unsecure(),isOptional:!1},title:{type:h.String_unsecure(),isOptional:!1},slug:{type:h.String_unsecure(),isOptional:!1},description:{type:h.String_unsecure(),isOptional:!0},difficulty:{type:h.String_unsecure(),isOptional:!1},status:{type:h.String_unsecure(),isOptional:!1},estimatedDuration:{type:h.Int_unsecure(),isOptional:!0},thumbnailUrl:{type:h.String_unsecure(),isOptional:!0},createdAt:{type:h.DateTime(),isOptional:!1}}}),Ot=y({name:"Learner",description:"A learner profile",fields:{id:{type:h.String_unsecure(),isOptional:!1},userId:{type:h.String_unsecure(),isOptional:!1},displayName:{type:h.String_unsecure(),isOptional:!0},level:{type:h.Int_unsecure(),isOptional:!1},totalXp:{type:h.Int_unsecure(),isOptional:!1},currentStreak:{type:h.Int_unsecure(),isOptional:!1},longestStreak:{type:h.Int_unsecure(),isOptional:!1},createdAt:{type:h.DateTime(),isOptional:!1}}}),f=y({name:"Enrollment",description:"A course enrollment",fields:{id:{type:h.String_unsecure(),isOptional:!1},learnerId:{type:h.String_unsecure(),isOptional:!1},courseId:{type:h.String_unsecure(),isOptional:!1},status:{type:h.String_unsecure(),isOptional:!1},progress:{type:h.Int_unsecure(),isOptional:!1},startedAt:{type:h.DateTime(),isOptional:!0},completedAt:{type:h.DateTime(),isOptional:!0}}}),Jo=y({name:"LessonProgress",description:"Lesson progress",fields:{id:{type:h.String_unsecure(),isOptional:!1},learnerId:{type:h.String_unsecure(),isOptional:!1},lessonId:{type:h.String_unsecure(),isOptional:!1},status:{type:h.String_unsecure(),isOptional:!1},progress:{type:h.Int_unsecure(),isOptional:!1},score:{type:h.Int_unsecure(),isOptional:!0},timeSpent:{type:h.Int_unsecure(),isOptional:!1},completedAt:{type:h.DateTime(),isOptional:!0}}}),ho=y({name:"Deck",description:"A flashcard deck",fields:{id:{type:h.String_unsecure(),isOptional:!1},title:{type:h.String_unsecure(),isOptional:!1},description:{type:h.String_unsecure(),isOptional:!0},cardCount:{type:h.Int_unsecure(),isOptional:!1},isPublic:{type:h.Boolean(),isOptional:!1},createdAt:{type:h.DateTime(),isOptional:!1}}}),Pt=y({name:"Card",description:"A flashcard",fields:{id:{type:h.String_unsecure(),isOptional:!1},deckId:{type:h.String_unsecure(),isOptional:!1},front:{type:h.String_unsecure(),isOptional:!1},back:{type:h.String_unsecure(),isOptional:!1},hints:{type:h.JSON(),isOptional:!0},isDue:{type:h.Boolean(),isOptional:!1},nextReviewAt:{type:h.DateTime(),isOptional:!0}}}),Dt=y({name:"Achievement",description:"An achievement",fields:{id:{type:h.String_unsecure(),isOptional:!1},key:{type:h.String_unsecure(),isOptional:!1},name:{type:h.String_unsecure(),isOptional:!1},description:{type:h.String_unsecure(),isOptional:!1},icon:{type:h.String_unsecure(),isOptional:!0},xpReward:{type:h.Int_unsecure(),isOptional:!1},unlockedAt:{type:h.DateTime(),isOptional:!0}}}),Jr=y({name:"EnrollInCourseInput",description:"Input for enrolling in a course",fields:{courseId:{type:h.String_unsecure(),isOptional:!1}}}),hr=y({name:"CompleteLessonInput",description:"Input for completing a lesson",fields:{lessonId:{type:h.String_unsecure(),isOptional:!1},score:{type:h.Int_unsecure(),isOptional:!0},timeSpent:{type:h.Int_unsecure(),isOptional:!1}}}),br=y({name:"SubmitCardReviewInput",description:"Input for submitting a card review",fields:{cardId:{type:h.String_unsecure(),isOptional:!1},rating:{type:h.String_unsecure(),isOptional:!1},responseTimeMs:{type:h.Int_unsecure(),isOptional:!0}}}),ar=y({name:"GetDueCardsInput",description:"Input for getting due cards",fields:{deckId:{type:h.String_unsecure(),isOptional:!0},limit:{type:h.Int_unsecure(),isOptional:!0}}}),Ir=y({name:"GetDueCardsOutput",description:"Output for getting due cards",fields:{cards:{type:Pt,isArray:!0,isOptional:!1},total:{type:h.Int_unsecure(),isOptional:!1}}}),Ar=y({name:"GetLearnerDashboardInput",description:"Input for getting learner dashboard",fields:{learnerId:{type:h.String_unsecure(),isOptional:!0}}}),Or=y({name:"LearnerDashboard",description:"Learner dashboard data",fields:{learner:{type:Ot,isOptional:!1},currentStreak:{type:h.Int_unsecure(),isOptional:!1},dailyXpGoal:{type:h.Int_unsecure(),isOptional:!1},dailyXpProgress:{type:h.Int_unsecure(),isOptional:!1},activeEnrollments:{type:f,isArray:!0,isOptional:!1},recentAchievements:{type:Dt,isArray:!0,isOptional:!1},dueCardCount:{type:h.Int_unsecure(),isOptional:!1}}}),l=y({name:"SuccessOutput",description:"Generic success output",fields:{success:{type:h.Boolean(),isOptional:!1},xpEarned:{type:h.Int_unsecure(),isOptional:!0}}});import{defineCommand as rr,defineQuery as Pr}from"@contractspec/lib.contracts-spec";var Oo=rr({meta:{key:"learning.enroll",version:"1.0.0",stability:"stable",owners:[...P],tags:["learning","enrollment"],description:"Enroll in a course.",goal:"Start learning a new course.",context:"Called when a learner wants to start a course."},io:{input:Jr,output:f,errors:{COURSE_NOT_FOUND:{description:"Course does not exist",http:404,gqlCode:"COURSE_NOT_FOUND",when:"Course ID is invalid"},ALREADY_ENROLLED:{description:"Already enrolled in course",http:409,gqlCode:"ALREADY_ENROLLED",when:"Learner is already enrolled"}}},policy:{auth:"user"}}),Po=rr({meta:{key:"learning.completeLesson",version:"1.0.0",stability:"stable",owners:[...P],tags:["learning","progress"],description:"Mark a lesson as completed.",goal:"Record lesson completion and earn XP.",context:"Called when a learner finishes a lesson."},io:{input:hr,output:l,errors:{LESSON_NOT_FOUND:{description:"Lesson does not exist",http:404,gqlCode:"LESSON_NOT_FOUND",when:"Lesson ID is invalid"},NOT_ENROLLED:{description:"Not enrolled in course",http:403,gqlCode:"NOT_ENROLLED",when:"Learner is not enrolled in the course"}}},policy:{auth:"user"}}),Do=rr({meta:{key:"learning.submitCardReview",version:"1.0.0",stability:"stable",owners:[...P],tags:["learning","flashcards"],description:"Submit a flashcard review.",goal:"Record review and update SRS schedule.",context:"Called when reviewing flashcards."},io:{input:br,output:l,errors:{CARD_NOT_FOUND:{description:"Card does not exist",http:404,gqlCode:"CARD_NOT_FOUND",when:"Card ID is invalid"},INVALID_RATING:{description:"Invalid rating",http:400,gqlCode:"INVALID_RATING",when:"Rating must be AGAIN, HARD, GOOD, or EASY"}}},policy:{auth:"user"}}),Bo=Pr({meta:{key:"learning.getDueCards",version:"1.0.0",stability:"stable",owners:[...P],tags:["learning","flashcards"],description:"Get flashcards due for review.",goal:"Get the next batch of cards to review.",context:"Called when starting a review session."},io:{input:ar,output:Ir},policy:{auth:"user"}}),jo=Pr({meta:{key:"learning.getDashboard",version:"1.0.0",stability:"stable",owners:[...P],tags:["learning","dashboard"],description:"Get learner dashboard data.",goal:"Display learner progress and stats.",context:"Called when viewing the learning dashboard."},io:{input:Ar,output:Or},policy:{auth:"user"}});import{registerDocBlocks as Bt}from"@contractspec/lib.contracts-spec/docs";var jt=[{id:"docs.learning-journey.engine",title:"Learning Journey Engine",summary:"Headless adaptive journey runtime for tracks, branching steps, progress, quizzes, streaks, XP, and AI coaching hooks.",kind:"reference",visibility:"public",route:"/docs/learning-journey/engine",tags:["adaptive-learning","journey","education"],body:`## Capabilities
 
 - **Entities**: Learner, Track, Module, Step, Progress, Quiz, Flashcard, AI Coach, Gamification (XP, streaks, badges).
-- **Contracts**: enroll/resume/advance steps, complete quizzes, record streaks, assign XP, fetch progress dashboards, onboarding list/progress/recordEvent.
+- **Contracts**: enroll/resume/advance steps, complete quizzes, record streaks, assign XP, fetch progress dashboards, journey list/progress/recordEvent.
+- **Runtime**: canonical branch/prerequisite evaluator + projected next-step snapshots.
 - **Engines**: spaced-repetition (SRS), streak calculator, XP progression.
-- **Events**: learner.enrolled, step.completed, quiz.scored, streak.reset, xp.awarded, onboarding.started/completed/step_completed.
+- **Events**: learner.enrolled, step.completed, quiz.scored, streak.reset, xp.awarded, journey.started/completed/step_completed.
 
 ## Completion conditions
 - Event-based: name/version/source + payload filter
 - Count-based: require N events (optional time window)
 - Time-bounded: must complete within a window; steps can unlock by day/hour
-- SRS mastery: complete when cards/skills hit mastery thresholds (with required counts)
+- Mastery: complete when cards/skills hit mastery thresholds (with required counts)
 
 ## Usage
 
@@ -21,7 +22,7 @@ import{defineSchemaModel as M,ScalarTypeEnum as O}from"@contractspec/lib.schema"
 - Import from \`@contractspec/module.learning-journey\` into your spec registry.
 
 3) Bind to product actions
-- Tie \`Step\` completion conditions to domain events (e.g., deal.created, agent.run.completed, drill.session.completed).
+- Tie \`JourneyStep\` completion conditions and branch rules to domain events (e.g., deal.created, agent.run.completed, drill.session.completed).
 - Trigger notifications via Notification Center and audits on completion.
 
 4) Gamification
@@ -42,10 +43,10 @@ const updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });
 - Keep steps bound to real product events, not just button clicks.
 - Avoid storing PII in content; keep org/user scoping for multi-tenant isolation.
 - Emit analytics and audit logs for completions; respect \`prefers-reduced-motion\` in UIs consuming these specs.
-- Track completion bonuses: \`completionXpBonus\`, \`completionBadgeKey\`, optional \`streakHoursWindow\` + \`streakBonusXp\`.
+- Track completion bonuses: \`completionRewards\`, optional \`streakRule\`, and branch-level rewards.
 `},{id:"docs.learning-journey.goal",title:"Learning Journey \u2014 Goal",summary:"Why the learning journey engine exists and the outcomes it targets.",kind:"goal",visibility:"public",route:"/docs/learning-journey/goal",tags:["learning","goal"],body:`## Why it matters
-- Provides a regenerable onboarding/education engine tied to product signals.
-- Keeps tracks, steps, quizzes, and gamification consistent across surfaces.
+- Provides a regenerable adaptive-journey engine tied to product signals.
+- Keeps tracks, steps, branches, quizzes, and gamification consistent across surfaces.
 
 ## Business/Product goal
 - Drive activation and retention with measurable progress, SRS, and streaks.
@@ -56,18 +57,18 @@ const updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });
 - Analytics/audit hooks exist for completions and streaks.`},{id:"docs.learning-journey.usage",title:"Learning Journey \u2014 Usage",summary:"How to compose, bind, and regenerate journeys safely.",kind:"usage",visibility:"public",route:"/docs/learning-journey/usage",tags:["learning","usage"],body:`## Setup
 1) Include \`learningJourneyEntities\` in schema composition.
 2) Register contracts/events from \`@contractspec/module.learning-journey\`.
-3) Bind steps to real product events (e.g., deal.created, run.completed).
+3) Bind steps and branch outcomes to real product events (e.g., deal.created, run.completed).
 
 ## Extend & regenerate
-1) Update track/module/step definitions or quiz schemas in spec.
+1) Update track/module/step definitions, branch rules, or quiz schemas in spec.
 2) Regenerate to sync UI/API/events; mark PII paths where needed.
 3) Use Feature Flags to trial new tracks or streak rules.
 
 ## Guardrails
-- Avoid hardcoded progression; keep engines declarative.
+- Avoid hardcoded progression; keep runtime rules declarative.
 - Emit analytics/audit for completions; respect user locale/accessibility in presentations.
 - Keep content free of PII; scope learners by org/tenant.`},{id:"docs.learning-journey.constraints",title:"Learning Journey \u2014 Constraints & Safety",summary:"Internal guardrails for progression, telemetry, and regeneration semantics.",kind:"reference",visibility:"internal",route:"/docs/learning-journey/constraints",tags:["learning","constraints","internal"],body:`## Constraints
-- Progression (tracks/modules/steps) and engines (SRS, streaks, XP) must stay declarative in spec.
+- Progression (tracks/modules/steps/branches) and engines (SRS, streaks, XP) must stay declarative in spec.
 - Events to emit: learner.enrolled, step.completed, quiz.scored, streak.reset, xp.awarded.
 - Regeneration should not change scoring/streak rules without explicit spec change.
 
@@ -78,4 +79,4 @@ const updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });
 ## Verification
 - Add fixtures for streak/XP rule changes and quiz scoring.
 - Ensure Notifications/Audit wiring persists for completions; analytics emitted for progress.
-- Use Feature Flags to trial new tracks or reward rules; default safe/off.`}];ij(ej);var jZ={learningSteps:[1,10],graduatingInterval:1,easyInterval:4,relearningSteps:[10],minEaseFactor:1.3,maxInterval:365,intervalModifier:1,newIntervalModifier:0.5,hardIntervalModifier:1.2,easyBonus:1.3};class Zj{config;constructor(j={}){this.config={...jZ,...j}}calculateNextReview(j,q,W=new Date){if(!j.isGraduated&&!j.isRelearning)return this.handleLearningCard(j,q,W);if(j.isRelearning)return this.handleRelearningCard(j,q,W);return this.handleReviewCard(j,q,W)}getInitialState(){return{interval:0,easeFactor:2.5,repetitions:0,learningStep:0,isGraduated:!1,isRelearning:!1,lapses:0}}isDue(j,q=new Date){return j<=q}getOverdueDays(j,q=new Date){let W=q.getTime()-j.getTime();return Math.floor(W/86400000)}handleLearningCard(j,q,W){let I=this.config.learningSteps,Q=j.learningStep,Y=!1,F=0,k;switch(q){case"AGAIN":Q=0,F=I[0]??1,k=this.addMinutes(W,F);break;case"HARD":F=I[Q]??I[0]??1,k=this.addMinutes(W,F);break;case"GOOD":if(Q++,Q>=I.length)Y=!0,F=this.config.graduatingInterval,k=this.addDays(W,F);else F=I[Q]??10,k=this.addMinutes(W,F);break;case"EASY":Y=!0,F=this.config.easyInterval,k=this.addDays(W,F);break}return{interval:Y?F:0,easeFactor:j.easeFactor,repetitions:Y?1:0,nextReviewAt:k,learningStep:Q,isGraduated:Y,isRelearning:!1,lapses:j.lapses}}handleRelearningCard(j,q,W){let I=this.config.relearningSteps,Q=j.learningStep,Y=!0,F=0,k;switch(q){case"AGAIN":Q=0,F=I[0]??10,k=this.addMinutes(W,F);break;case"HARD":F=I[Q]??I[0]??10,k=this.addMinutes(W,F);break;case"GOOD":if(Q++,Q>=I.length)Y=!1,F=Math.max(1,Math.floor(j.interval*this.config.newIntervalModifier)),k=this.addDays(W,F);else F=I[Q]??10,k=this.addMinutes(W,F);break;case"EASY":Y=!1,F=Math.max(1,Math.floor(j.interval*this.config.newIntervalModifier*1.5)),k=this.addDays(W,F);break}return{interval:Y?j.interval:F,easeFactor:j.easeFactor,repetitions:Y?j.repetitions:j.repetitions+1,nextReviewAt:k,learningStep:Q,isGraduated:!0,isRelearning:Y,lapses:j.lapses}}handleReviewCard(j,q,W){let I,Q=j.easeFactor,Y=j.repetitions,F=!1,k=0,y=j.lapses;switch(q){case"AGAIN":return y++,F=!0,k=0,Q=Math.max(this.config.minEaseFactor,Q-0.2),I=j.interval,{interval:I,easeFactor:Q,repetitions:Y,nextReviewAt:this.addMinutes(W,this.config.relearningSteps[0]??10),learningStep:k,isGraduated:!0,isRelearning:!0,lapses:y};case"HARD":Q=Math.max(this.config.minEaseFactor,Q-0.15),I=Math.max(j.interval+1,j.interval*this.config.hardIntervalModifier);break;case"GOOD":I=j.interval*Q*this.config.intervalModifier,Y++;break;case"EASY":Q=Q+0.15,I=j.interval*Q*this.config.easyBonus*this.config.intervalModifier,Y++;break}return I=Math.min(Math.round(I),this.config.maxInterval),I=Math.max(1,I),{interval:I,easeFactor:Q,repetitions:Y,nextReviewAt:this.addDays(W,I),learningStep:k,isGraduated:!0,isRelearning:F,lapses:y}}addMinutes(j,q){return new Date(j.getTime()+q*60*1000)}addDays(j,q){return new Date(j.getTime()+q*24*60*60*1000)}}var j1=new Zj;var ZZ={timezone:"UTC",freezesPerMonth:2,maxFreezes:5,gracePeriodHours:4};class $j{config;constructor(j={}){this.config={...ZZ,...j}}update(j,q=new Date){let W=this.getDateString(q),I={state:{...j},streakMaintained:!1,streakLost:!1,freezeUsed:!1,newStreak:!1,daysMissed:0};if(!j.lastActivityDate)return I.state.currentStreak=1,I.state.longestStreak=Math.max(1,j.longestStreak),I.state.lastActivityAt=q,I.state.lastActivityDate=W,I.newStreak=!0,I.streakMaintained=!0,I;if(j.lastActivityDate===W)return I.state.lastActivityAt=q,I.streakMaintained=!0,I;let Q=this.getDaysBetween(j.lastActivityDate,W);if(Q===1)return I.state.currentStreak=j.currentStreak+1,I.state.longestStreak=Math.max(I.state.currentStreak,j.longestStreak),I.state.lastActivityAt=q,I.state.lastActivityDate=W,I.streakMaintained=!0,I;I.daysMissed=Q-1;let Y=I.daysMissed;if(Y<=j.freezesRemaining)return I.state.freezesRemaining=j.freezesRemaining-Y,I.state.freezeUsedAt=q,I.state.currentStreak=j.currentStreak+1,I.state.longestStreak=Math.max(I.state.currentStreak,j.longestStreak),I.state.lastActivityAt=q,I.state.lastActivityDate=W,I.freezeUsed=!0,I.streakMaintained=!0,I;return I.streakLost=!0,I.state.currentStreak=1,I.state.lastActivityAt=q,I.state.lastActivityDate=W,I.newStreak=!0,I}checkStatus(j,q=new Date){if(!j.lastActivityDate)return{isActive:!1,willExpireAt:null,canUseFreeze:!1,daysUntilExpiry:0};let W=this.getDateString(q),I=this.getDaysBetween(j.lastActivityDate,W);if(I===0){let Y=this.addDays(q,1);return Y.setHours(23,59,59,999),{isActive:!0,willExpireAt:Y,canUseFreeze:j.freezesRemaining>0,daysUntilExpiry:1}}if(I===1){let Y=new Date(q);return Y.setHours(23+this.config.gracePeriodHours,59,59,999),{isActive:!0,willExpireAt:Y,canUseFreeze:j.freezesRemaining>0,daysUntilExpiry:0}}let Q=I-1;return{isActive:Q<=j.freezesRemaining,willExpireAt:null,canUseFreeze:Q<=j.freezesRemaining,daysUntilExpiry:-Q}}useFreeze(j,q=new Date){if(j.freezesRemaining<=0)return null;return{...j,freezesRemaining:j.freezesRemaining-1,freezeUsedAt:q}}awardMonthlyFreezes(j){return{...j,freezesRemaining:Math.min(j.freezesRemaining+this.config.freezesPerMonth,this.config.maxFreezes)}}getInitialState(){return{currentStreak:0,longestStreak:0,lastActivityAt:null,lastActivityDate:null,freezesRemaining:this.config.freezesPerMonth,freezeUsedAt:null}}getMilestones(j){let q=[3,7,14,30,60,90,180,365,500,1000],W=q.filter((Q)=>j>=Q),I=q.find((Q)=>j<Q)??null;return{achieved:W,next:I}}getDateString(j){let q=j.getFullYear(),W=String(j.getMonth()+1).padStart(2,"0"),I=String(j.getDate()).padStart(2,"0");return`${q}-${W}-${I}`}getDaysBetween(j,q){let W=new Date(j),Q=new Date(q).getTime()-W.getTime();return Math.floor(Q/86400000)}addDays(j,q){return new Date(j.getTime()+q*24*60*60*1000)}}var $1=new $j;import{defineTranslation as $Z}from"@contractspec/lib.contracts-spec/translations";var Hj=$Z({meta:{key:"learning-journey.messages",version:"1.0.0",domain:"learning-journey",description:"XP source labels for the learning-journey module",owners:["platform"],stability:"experimental"},locale:"en",fallback:"en",messages:{"xp.source.base":{value:"Base",description:"XP breakdown label for base XP"},"xp.source.scoreBonus":{value:"Score Bonus",description:"XP breakdown label for score-based bonus"},"xp.source.perfectScore":{value:"Perfect Score",description:"XP breakdown label for perfect score bonus"},"xp.source.firstAttempt":{value:"First Attempt",description:"XP breakdown label for first attempt bonus"},"xp.source.retryPenalty":{value:"Retry Penalty",description:"XP breakdown label for retry penalty"},"xp.source.streakBonus":{value:"Streak Bonus",description:"XP breakdown label for streak bonus"}}});import{defineTranslation as HZ}from"@contractspec/lib.contracts-spec/translations";var Vj=HZ({meta:{key:"learning-journey.messages",version:"1.0.0",domain:"learning-journey",description:"XP source labels (Spanish)",owners:["platform"],stability:"experimental"},locale:"es",fallback:"en",messages:{"xp.source.base":{value:"Base",description:"XP breakdown label for base XP"},"xp.source.scoreBonus":{value:"Bonificaci\xF3n por puntuaci\xF3n",description:"XP breakdown label for score-based bonus"},"xp.source.perfectScore":{value:"Puntuaci\xF3n perfecta",description:"XP breakdown label for perfect score bonus"},"xp.source.firstAttempt":{value:"Primer intento",description:"XP breakdown label for first attempt bonus"},"xp.source.retryPenalty":{value:"Penalizaci\xF3n por reintento",description:"XP breakdown label for retry penalty"},"xp.source.streakBonus":{value:"Bonificaci\xF3n por racha",description:"XP breakdown label for streak bonus"}}});import{defineTranslation as VZ}from"@contractspec/lib.contracts-spec/translations";var _j=VZ({meta:{key:"learning-journey.messages",version:"1.0.0",domain:"learning-journey",description:"XP source labels (French)",owners:["platform"],stability:"experimental"},locale:"fr",fallback:"en",messages:{"xp.source.base":{value:"Base",description:"XP breakdown label for base XP"},"xp.source.scoreBonus":{value:"Bonus de score",description:"XP breakdown label for score-based bonus"},"xp.source.perfectScore":{value:"Score parfait",description:"XP breakdown label for perfect score bonus"},"xp.source.firstAttempt":{value:"Premier essai",description:"XP breakdown label for first attempt bonus"},"xp.source.retryPenalty":{value:"P\xE9nalit\xE9 de r\xE9essai",description:"XP breakdown label for retry penalty"},"xp.source.streakBonus":{value:"Bonus de s\xE9rie",description:"XP breakdown label for streak bonus"}}});import{createI18nFactory as _Z}from"@contractspec/lib.contracts-spec/translations";var c=_Z({specKey:"learning-journey.messages",catalogs:[Hj,_j,Vj]}),Ij=c.create,W1=c.getDefault,Y1=c.resetRegistry;var w={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:0.75},{min:0,multiplier:0.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:0.5,speedBonusMultiplier:1.2,speedBonusThreshold:0.8};class Kj{config;constructor(j={}){this.config={...w,...j,baseValues:{...w.baseValues,...j.baseValues},scoreThresholds:j.scoreThresholds||w.scoreThresholds,streakTiers:j.streakTiers||w.streakTiers}}calculate(j){let q=[],W=j.baseXp??this.config.baseValues[j.activity],I=W;if(q.push({source:"base",amount:W}),j.score!==void 0){let Q=this.getScoreMultiplier(j.score);if(Q!==1){let Y=Math.round(W*(Q-1));I+=Y,q.push({source:"score_bonus",amount:Y,multiplier:Q})}if(j.score===100){let Y=Math.round(W*(this.config.perfectScoreMultiplier-1));I+=Y,q.push({source:"perfect_score",amount:Y,multiplier:this.config.perfectScoreMultiplier})}}if(j.attemptNumber===1&&!j.isRetry)I+=this.config.firstAttemptBonus,q.push({source:"first_attempt",amount:this.config.firstAttemptBonus});if(j.isRetry){let Q=Math.round(I*(1-this.config.retryPenalty));I-=Q,q.push({source:"retry_penalty",amount:-Q,multiplier:this.config.retryPenalty})}if(j.currentStreak&&j.currentStreak>0){let Q=this.getStreakBonus(j.currentStreak);if(Q>0)I+=Q,q.push({source:"streak_bonus",amount:Q})}if(W>0)I=Math.max(1,I);return{totalXp:Math.round(I),baseXp:W,breakdown:q}}calculateStreakBonus(j){let q=this.getStreakBonus(j);return{totalXp:q,baseXp:q,breakdown:[{source:"streak_bonus",amount:q}]}}getXpForLevel(j){if(j<=1)return 0;return Math.round(100*Math.pow(j-1,1.5))}getLevelFromXp(j){let q=1,W=this.getXpForLevel(q+1);while(j>=W&&q<1000)q++,W=this.getXpForLevel(q+1);let I=this.getXpForLevel(q),Q=this.getXpForLevel(q+1);return{level:q,xpInLevel:j-I,xpForNextLevel:Q-I}}getScoreMultiplier(j){for(let q of this.config.scoreThresholds)if(j>=q.min)return q.multiplier;return 1}getStreakBonus(j){for(let q of this.config.streakTiers)if(j>=q.days)return q.bonus;return 0}}var IZ={base:"xp.source.base",score_bonus:"xp.source.scoreBonus",perfect_score:"xp.source.perfectScore",first_attempt:"xp.source.firstAttempt",retry_penalty:"xp.source.retryPenalty",streak_bonus:"xp.source.streakBonus"};function X1(j,q){let W=Ij(q),I=IZ[j];return I?W.t(I):j}var k1=new Kj;import{defineEntity as p,defineEntityEnum as Oj,field as Z,index as A}from"@contractspec/lib.schema";var qj=Oj({name:"LearningStyle",values:["VISUAL","AUDITORY","READING","KINESTHETIC","MIXED"],schema:"lssm_learning",description:"Preferred learning style."}),Bj=Oj({name:"RecommendationType",values:["COURSE","LESSON","REVIEW","PRACTICE","ASSESSMENT","DECK"],schema:"lssm_learning",description:"Type of learning recommendation."}),KZ=p({name:"LearnerProfile",description:"AI personalization profile for a learner.",schema:"lssm_learning",map:"learner_profile",fields:{id:Z.id({description:"Unique profile identifier"}),learnerId:Z.foreignKey({description:"Learner"}),learningStyle:Z.enum("LearningStyle",{default:"MIXED",description:"Preferred learning style"}),preferredDifficulty:Z.string({default:'"adaptive"',description:"Difficulty preference"}),preferredSessionLength:Z.int({default:30,description:"Preferred session length in minutes"}),interests:Z.json({isOptional:!0,description:"Topic interests"}),goals:Z.json({isOptional:!0,description:"Learning goals"}),pacePreference:Z.string({default:'"normal"',description:"Learning pace: slow, normal, fast"}),bestTimeOfDay:Z.string({isOptional:!0,description:"Best time for learning"}),averageSessionLength:Z.int({isOptional:!0,description:"Average session length"}),daysActivePerWeek:Z.int({isOptional:!0,description:"Days active per week"}),avgQuizScore:Z.int({isOptional:!0,description:"Average quiz score"}),avgLessonCompletionTime:Z.int({isOptional:!0,description:"Avg lesson completion time"}),strengths:Z.json({isOptional:!0,description:"Identified strengths"}),weaknesses:Z.json({isOptional:!0,description:"Areas for improvement"}),lastAnalyzedAt:Z.dateTime({isOptional:!0,description:"Last AI analysis"}),metadata:Z.json({isOptional:!0,description:"Additional metadata"}),createdAt:Z.createdAt(),updatedAt:Z.updatedAt(),learner:Z.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[A.unique(["learnerId"],{name:"learner_profile_unique"}),A.on(["learningStyle"])],enums:[qj]}),OZ=p({name:"SkillMap",description:"Maps learner proficiency across skills.",schema:"lssm_learning",map:"skill_map",fields:{id:Z.id({description:"Unique skill map identifier"}),learnerId:Z.foreignKey({description:"Learner"}),skillId:Z.string({description:"Skill identifier"}),skillName:Z.string({description:"Skill name"}),skillCategory:Z.string({isOptional:!0,description:"Skill category"}),level:Z.int({default:0,description:"Proficiency level (0-100)"}),confidence:Z.decimal({default:0.5,description:"Confidence in assessment"}),lessonsCompleted:Z.int({default:0,description:"Related lessons completed"}),quizzesCompleted:Z.int({default:0,description:"Related quizzes completed"}),practiceTime:Z.int({default:0,description:"Practice time in minutes"}),lastPracticedAt:Z.dateTime({isOptional:!0,description:"Last practice time"}),learningVelocity:Z.decimal({isOptional:!0,description:"Learning speed for this skill"}),predictedTimeToMastery:Z.int({isOptional:!0,description:"Predicted time to mastery (minutes)"}),createdAt:Z.createdAt(),updatedAt:Z.updatedAt(),learner:Z.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[A.unique(["learnerId","skillId"],{name:"skill_map_unique"}),A.on(["skillId","level"]),A.on(["learnerId","level"])]}),qZ=p({name:"LearningPath",description:"AI-generated personalized learning path.",schema:"lssm_learning",map:"learning_path",fields:{id:Z.id({description:"Unique path identifier"}),learnerId:Z.foreignKey({description:"Learner"}),name:Z.string({description:"Path name"}),description:Z.string({isOptional:!0,description:"Path description"}),goal:Z.string({isOptional:!0,description:"Path goal"}),steps:Z.json({description:"Ordered list of learning steps"}),currentStepIndex:Z.int({default:0,description:"Current step index"}),progress:Z.int({default:0,description:"Completion percentage"}),completedSteps:Z.int({default:0,description:"Steps completed"}),totalSteps:Z.int({default:0,description:"Total steps"}),generatedAt:Z.dateTime({description:"When path was generated"}),adaptedFrom:Z.string({isOptional:!0,description:"Original path ID if adapted"}),generationParams:Z.json({isOptional:!0,description:"AI generation parameters"}),adaptationHistory:Z.json({isOptional:!0,description:"Path adaptation history"}),isActive:Z.boolean({default:!0,description:"Whether path is active"}),isCompleted:Z.boolean({default:!1,description:"Whether path is completed"}),startedAt:Z.dateTime({isOptional:!0,description:"When started"}),completedAt:Z.dateTime({isOptional:!0,description:"When completed"}),estimatedCompletionDate:Z.dateTime({isOptional:!0,description:"Estimated completion"}),createdAt:Z.createdAt(),updatedAt:Z.updatedAt(),learner:Z.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[A.on(["learnerId","isActive"]),A.on(["generatedAt"])]}),BZ=p({name:"Recommendation",description:"AI-powered learning recommendation.",schema:"lssm_learning",map:"recommendation",fields:{id:Z.id({description:"Unique recommendation identifier"}),learnerId:Z.foreignKey({description:"Learner"}),type:Z.enum("RecommendationType",{description:"Recommendation type"}),itemId:Z.string({description:"Recommended item ID"}),itemType:Z.string({description:"Item type (course, lesson, deck, etc.)"}),score:Z.decimal({description:"Recommendation score (0-1)"}),confidence:Z.decimal({description:"Confidence in recommendation"}),reason:Z.string({description:"Human-readable reason"}),factors:Z.json({isOptional:!0,description:"Factors that contributed to recommendation"}),status:Z.string({default:'"pending"',description:"Status: pending, viewed, accepted, dismissed"}),viewedAt:Z.dateTime({isOptional:!0,description:"When viewed"}),acceptedAt:Z.dateTime({isOptional:!0,description:"When accepted"}),dismissedAt:Z.dateTime({isOptional:!0,description:"When dismissed"}),feedback:Z.string({isOptional:!0,description:"User feedback"}),feedbackRating:Z.int({isOptional:!0,description:"Feedback rating (1-5)"}),expiresAt:Z.dateTime({isOptional:!0,description:"When recommendation expires"}),createdAt:Z.createdAt(),updatedAt:Z.updatedAt(),learner:Z.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[A.on(["learnerId","status","score"]),A.on(["type","status"]),A.on(["expiresAt"])],enums:[Bj]}),zZ=p({name:"LearningGap",description:"Identified learning gap.",schema:"lssm_learning",map:"learning_gap",fields:{id:Z.id({description:"Unique gap identifier"}),learnerId:Z.foreignKey({description:"Learner"}),skillId:Z.string({description:"Skill with gap"}),skillName:Z.string({description:"Skill name"}),severity:Z.string({default:'"moderate"',description:"Gap severity: minor, moderate, major"}),confidence:Z.decimal({description:"Confidence in gap detection"}),evidence:Z.json({isOptional:!0,description:"Evidence for gap"}),relatedQuestions:Z.json({isOptional:!0,description:"Questions that revealed gap"}),suggestedRemediation:Z.json({isOptional:!0,description:"Suggested remediation"}),remediationProgress:Z.int({default:0,description:"Remediation progress"}),status:Z.string({default:'"open"',description:"Status: open, in_progress, resolved"}),resolvedAt:Z.dateTime({isOptional:!0,description:"When resolved"}),detectedAt:Z.dateTime({description:"When gap was detected"}),createdAt:Z.createdAt(),updatedAt:Z.updatedAt(),learner:Z.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[A.on(["learnerId","status"]),A.on(["skillId","status"]),A.on(["severity","status"])]}),zj=[KZ,OZ,qZ,BZ,zZ],Dj=[qj,Bj];import{defineEntity as s,defineEntityEnum as T,field as B,index as b}from"@contractspec/lib.schema";var Qj=T({name:"CourseDifficulty",values:["BEGINNER","INTERMEDIATE","ADVANCED","EXPERT"],schema:"lssm_learning",description:"Difficulty level of a course."}),Wj=T({name:"CourseStatus",values:["DRAFT","PUBLISHED","ARCHIVED"],schema:"lssm_learning",description:"Publication status of a course."}),Yj=T({name:"LessonType",values:["CONTENT","VIDEO","INTERACTIVE","QUIZ","PRACTICE","PROJECT"],schema:"lssm_learning",description:"Type of lesson content."}),Jj=T({name:"ContentType",values:["MARKDOWN","VIDEO","AUDIO","EMBED","SCORM","CUSTOM"],schema:"lssm_learning",description:"Type of lesson content format."}),DZ=s({name:"Course",description:"A structured learning course.",schema:"lssm_learning",map:"course",fields:{id:B.id({description:"Unique course identifier"}),title:B.string({description:"Course title"}),slug:B.string({isUnique:!0,description:"URL-friendly slug"}),description:B.string({isOptional:!0,description:"Course description"}),summary:B.string({isOptional:!0,description:"Short summary"}),difficulty:B.enum("CourseDifficulty",{default:"BEGINNER",description:"Difficulty level"}),category:B.string({isOptional:!0,description:"Course category"}),tags:B.json({isOptional:!0,description:"Tags for discovery"}),prerequisites:B.json({isOptional:!0,description:"Required course IDs"}),requiredSkills:B.json({isOptional:!0,description:"Required skill levels"}),estimatedDuration:B.int({isOptional:!0,description:"Estimated duration in minutes"}),thumbnailUrl:B.string({isOptional:!0,description:"Thumbnail image URL"}),coverImageUrl:B.string({isOptional:!0,description:"Cover image URL"}),promoVideoUrl:B.string({isOptional:!0,description:"Promo video URL"}),status:B.enum("CourseStatus",{default:"DRAFT",description:"Publication status"}),publishedAt:B.dateTime({isOptional:!0,description:"When published"}),authorId:B.string({description:"Author user ID"}),orgId:B.string({isOptional:!0,description:"Organization scope"}),isPublic:B.boolean({default:!1,description:"Whether course is publicly accessible"}),isFeatured:B.boolean({default:!1,description:"Whether course is featured"}),certificateEnabled:B.boolean({default:!1,description:"Award certificate on completion"}),metadata:B.json({isOptional:!0,description:"Additional metadata"}),createdAt:B.createdAt(),updatedAt:B.updatedAt(),modules:B.hasMany("CourseModule"),enrollments:B.hasMany("Enrollment")},indexes:[b.on(["orgId","status"]),b.on(["category"]),b.on(["difficulty"]),b.on(["authorId"])],enums:[Qj,Wj]}),QZ=s({name:"CourseModule",description:"A module (section) within a course.",schema:"lssm_learning",map:"course_module",fields:{id:B.id({description:"Unique module identifier"}),courseId:B.foreignKey({description:"Parent course"}),title:B.string({description:"Module title"}),description:B.string({isOptional:!0,description:"Module description"}),order:B.int({default:0,description:"Display order"}),unlockCondition:B.json({isOptional:!0,description:"Conditions to unlock module"}),prerequisiteModuleIds:B.json({isOptional:!0,description:"Required modules to complete first"}),estimatedDuration:B.int({isOptional:!0,description:"Estimated duration in minutes"}),createdAt:B.createdAt(),updatedAt:B.updatedAt(),course:B.belongsTo("Course",["courseId"],["id"],{onDelete:"Cascade"}),lessons:B.hasMany("Lesson"),completions:B.hasMany("ModuleCompletion")},indexes:[b.on(["courseId","order"])]}),WZ=s({name:"Lesson",description:"An individual lesson within a module.",schema:"lssm_learning",map:"lesson",fields:{id:B.id({description:"Unique lesson identifier"}),moduleId:B.foreignKey({description:"Parent module"}),title:B.string({description:"Lesson title"}),description:B.string({isOptional:!0,description:"Lesson description"}),type:B.enum("LessonType",{default:"CONTENT",description:"Lesson type"}),order:B.int({default:0,description:"Display order"}),estimatedDuration:B.int({isOptional:!0,description:"Estimated duration in minutes"}),xpReward:B.int({default:10,description:"XP awarded on completion"}),isFree:B.boolean({default:!1,description:"Whether lesson is free preview"}),isRequired:B.boolean({default:!0,description:"Whether lesson is required for completion"}),metadata:B.json({isOptional:!0,description:"Additional metadata"}),createdAt:B.createdAt(),updatedAt:B.updatedAt(),module:B.belongsTo("CourseModule",["moduleId"],["id"],{onDelete:"Cascade"}),contents:B.hasMany("LessonContent"),progress:B.hasMany("LessonProgress"),quizzes:B.hasMany("Quiz")},indexes:[b.on(["moduleId","order"]),b.on(["type"])],enums:[Yj]}),YZ=s({name:"LessonContent",description:"Content block within a lesson.",schema:"lssm_learning",map:"lesson_content",fields:{id:B.id({description:"Unique content identifier"}),lessonId:B.foreignKey({description:"Parent lesson"}),contentType:B.enum("ContentType",{description:"Content format"}),content:B.string({isOptional:!0,description:"Text content (markdown, etc.)"}),mediaUrl:B.string({isOptional:!0,description:"Media URL for video/audio"}),embedData:B.json({isOptional:!0,description:"Embed data for external content"}),order:B.int({default:0,description:"Display order"}),duration:B.int({isOptional:!0,description:"Content duration in seconds"}),metadata:B.json({isOptional:!0,description:"Additional metadata"}),createdAt:B.createdAt(),updatedAt:B.updatedAt(),lesson:B.belongsTo("Lesson",["lessonId"],["id"],{onDelete:"Cascade"})},indexes:[b.on(["lessonId","order"])],enums:[Jj]}),Fj=[DZ,QZ,WZ,YZ],Xj=[Qj,Wj,Yj,Jj];import{defineEntity as o,defineEntityEnum as JZ,field as z,index as L}from"@contractspec/lib.schema";var kj=JZ({name:"CardRating",values:["AGAIN","HARD","GOOD","EASY"],schema:"lssm_learning",description:"Rating for a flashcard review."}),FZ=o({name:"Deck",description:"A collection of flashcards.",schema:"lssm_learning",map:"deck",fields:{id:z.id({description:"Unique deck identifier"}),ownerId:z.foreignKey({description:"Deck owner (learner)"}),title:z.string({description:"Deck title"}),description:z.string({isOptional:!0,description:"Deck description"}),category:z.string({isOptional:!0,description:"Deck category"}),tags:z.json({isOptional:!0,description:"Tags for discovery"}),isPublic:z.boolean({default:!1,description:"Whether deck is publicly visible"}),cardCount:z.int({default:0,description:"Number of cards"}),coverImageUrl:z.string({isOptional:!0,description:"Cover image URL"}),orgId:z.string({isOptional:!0,description:"Organization scope"}),newCardsPerDay:z.int({default:20,description:"New cards to introduce per day"}),reviewsPerDay:z.int({default:100,description:"Maximum reviews per day"}),metadata:z.json({isOptional:!0,description:"Additional metadata"}),createdAt:z.createdAt(),updatedAt:z.updatedAt(),owner:z.belongsTo("Learner",["ownerId"],["id"],{onDelete:"Cascade"}),cards:z.hasMany("Card")},indexes:[L.on(["ownerId"]),L.on(["isPublic","category"]),L.on(["orgId"])]}),XZ=o({name:"Card",description:"An individual flashcard.",schema:"lssm_learning",map:"card",fields:{id:z.id({description:"Unique card identifier"}),deckId:z.foreignKey({description:"Parent deck"}),front:z.string({description:"Front of card (question)"}),back:z.string({description:"Back of card (answer)"}),hints:z.json({isOptional:!0,description:"Hints for the card"}),explanation:z.string({isOptional:!0,description:"Detailed explanation"}),frontMediaUrl:z.string({isOptional:!0,description:"Media for front"}),backMediaUrl:z.string({isOptional:!0,description:"Media for back"}),audioUrl:z.string({isOptional:!0,description:"Audio pronunciation"}),tags:z.json({isOptional:!0,description:"Card tags"}),difficulty:z.int({default:0,description:"Card difficulty (0-5)"}),order:z.int({default:0,description:"Card order in deck"}),isSuspended:z.boolean({default:!1,description:"Whether card is suspended"}),metadata:z.json({isOptional:!0,description:"Additional metadata"}),createdAt:z.createdAt(),updatedAt:z.updatedAt(),deck:z.belongsTo("Deck",["deckId"],["id"],{onDelete:"Cascade"}),reviews:z.hasMany("CardReview"),schedules:z.hasMany("CardSchedule")},indexes:[L.on(["deckId","order"]),L.on(["isSuspended"])]}),kZ=o({name:"CardReview",description:"A single review of a flashcard.",schema:"lssm_learning",map:"card_review",fields:{id:z.id({description:"Unique review identifier"}),learnerId:z.foreignKey({description:"Reviewer"}),cardId:z.foreignKey({description:"Reviewed card"}),rating:z.enum("CardRating",{description:"Review rating"}),responseTimeMs:z.int({isOptional:!0,description:"Time to respond in ms"}),intervalBefore:z.int({description:"Interval before review (days)"}),easeFactorBefore:z.decimal({description:"Ease factor before review"}),intervalAfter:z.int({description:"Interval after review (days)"}),easeFactorAfter:z.decimal({description:"Ease factor after review"}),reviewType:z.string({default:'"review"',description:"Type: new, learning, review, relearning"}),reviewedAt:z.dateTime({description:"When reviewed"}),createdAt:z.createdAt(),learner:z.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),card:z.belongsTo("Card",["cardId"],["id"],{onDelete:"Cascade"})},indexes:[L.on(["learnerId","reviewedAt"]),L.on(["cardId","reviewedAt"]),L.on(["rating"])],enums:[kj]}),UZ=o({name:"CardSchedule",description:"SRS schedule for a learner/card pair.",schema:"lssm_learning",map:"card_schedule",fields:{id:z.id({description:"Unique schedule identifier"}),learnerId:z.foreignKey({description:"Learner"}),cardId:z.foreignKey({description:"Card"}),interval:z.int({default:0,description:"Current interval in days"}),easeFactor:z.decimal({default:2.5,description:"Ease factor (SM-2)"}),repetitions:z.int({default:0,description:"Number of successful repetitions"}),nextReviewAt:z.dateTime({description:"When next review is due"}),lastReviewAt:z.dateTime({isOptional:!0,description:"When last reviewed"}),learningStep:z.int({default:0,description:"Current learning step"}),isGraduated:z.boolean({default:!1,description:"Whether card has graduated"}),isRelearning:z.boolean({default:!1,description:"Whether card is being relearned"}),lapses:z.int({default:0,description:"Number of times card was forgotten"}),reviewCount:z.int({default:0,description:"Total review count"}),createdAt:z.createdAt(),updatedAt:z.updatedAt(),learner:z.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),card:z.belongsTo("Card",["cardId"],["id"],{onDelete:"Cascade"})},indexes:[L.unique(["learnerId","cardId"],{name:"card_schedule_unique"}),L.on(["learnerId","nextReviewAt"]),L.on(["nextReviewAt"])]}),Uj=[FZ,XZ,kZ,UZ],Gj=[kj];import{defineEntity as x,defineEntityEnum as Mj,field as $,index as X}from"@contractspec/lib.schema";var Pj=Mj({name:"AchievementType",values:["MILESTONE","STREAK","SKILL","SOCIAL","SPECIAL","SEASONAL"],schema:"lssm_learning",description:"Type of achievement."}),Aj=Mj({name:"LeaderboardPeriod",values:["DAILY","WEEKLY","MONTHLY","ALL_TIME"],schema:"lssm_learning",description:"Leaderboard time period."}),GZ=x({name:"Achievement",description:"An achievement that can be unlocked.",schema:"lssm_learning",map:"achievement",fields:{id:$.id({description:"Unique achievement identifier"}),key:$.string({isUnique:!0,description:"Achievement key"}),name:$.string({description:"Achievement name"}),description:$.string({description:"Achievement description"}),icon:$.string({isOptional:!0,description:"Icon name or URL"}),color:$.string({isOptional:!0,description:"Display color"}),badgeUrl:$.string({isOptional:!0,description:"Badge image URL"}),type:$.enum("AchievementType",{default:"MILESTONE",description:"Achievement type"}),category:$.string({isOptional:!0,description:"Achievement category"}),rarity:$.string({default:'"common"',description:"Rarity: common, rare, epic, legendary"}),xpReward:$.int({default:50,description:"XP awarded"}),condition:$.json({description:"Unlock condition"}),order:$.int({default:0,description:"Display order"}),isHidden:$.boolean({default:!1,description:"Hide until unlocked"}),isActive:$.boolean({default:!0,description:"Whether achievement is active"}),orgId:$.string({isOptional:!0,description:"Organization scope"}),metadata:$.json({isOptional:!0,description:"Additional metadata"}),createdAt:$.createdAt(),updatedAt:$.updatedAt(),learnerAchievements:$.hasMany("LearnerAchievement")},indexes:[X.on(["type"]),X.on(["category"]),X.on(["isActive"]),X.on(["orgId"])],enums:[Pj]}),MZ=x({name:"LearnerAchievement",description:"An achievement unlocked by a learner.",schema:"lssm_learning",map:"learner_achievement",fields:{id:$.id({description:"Unique record identifier"}),learnerId:$.foreignKey({description:"Learner"}),achievementId:$.foreignKey({description:"Achievement"}),xpEarned:$.int({default:0,description:"XP earned"}),progress:$.int({default:100,description:"Progress percentage"}),currentValue:$.int({isOptional:!0,description:"Current value towards goal"}),targetValue:$.int({isOptional:!0,description:"Target value for completion"}),unlockedAt:$.dateTime({description:"When unlocked"}),createdAt:$.createdAt(),learner:$.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),achievement:$.belongsTo("Achievement",["achievementId"],["id"],{onDelete:"Cascade"})},indexes:[X.unique(["learnerId","achievementId"],{name:"learner_achievement_unique"}),X.on(["learnerId","unlockedAt"]),X.on(["achievementId"])]}),PZ=x({name:"Streak",description:"Tracks daily learning streaks.",schema:"lssm_learning",map:"streak",fields:{id:$.id({description:"Unique streak identifier"}),learnerId:$.foreignKey({description:"Learner"}),currentStreak:$.int({default:0,description:"Current streak days"}),longestStreak:$.int({default:0,description:"Longest streak ever"}),lastActivityAt:$.dateTime({isOptional:!0,description:"Last learning activity"}),lastActivityDate:$.string({isOptional:!0,description:"Last activity date (YYYY-MM-DD)"}),freezesRemaining:$.int({default:0,description:"Streak freezes available"}),freezeUsedAt:$.dateTime({isOptional:!0,description:"When last freeze was used"}),streakHistory:$.json({isOptional:!0,description:"Historical streak data"}),createdAt:$.createdAt(),updatedAt:$.updatedAt(),learner:$.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[X.unique(["learnerId"],{name:"streak_learner_unique"}),X.on(["currentStreak"]),X.on(["longestStreak"])]}),AZ=x({name:"DailyGoal",description:"Daily XP goal tracking.",schema:"lssm_learning",map:"daily_goal",fields:{id:$.id({description:"Unique goal identifier"}),learnerId:$.foreignKey({description:"Learner"}),date:$.string({description:"Date (YYYY-MM-DD)"}),targetXp:$.int({description:"Target XP for the day"}),currentXp:$.int({default:0,description:"XP earned today"}),isCompleted:$.boolean({default:!1,description:"Whether goal was met"}),completedAt:$.dateTime({isOptional:!0,description:"When goal was completed"}),xpBreakdown:$.json({isOptional:!0,description:"XP sources breakdown"}),createdAt:$.createdAt(),updatedAt:$.updatedAt(),learner:$.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[X.unique(["learnerId","date"],{name:"daily_goal_unique"}),X.on(["date","isCompleted"])]}),CZ=x({name:"LeaderboardEntry",description:"Leaderboard entry for a learner.",schema:"lssm_learning",map:"leaderboard_entry",fields:{id:$.id({description:"Unique entry identifier"}),learnerId:$.foreignKey({description:"Learner"}),periodType:$.enum("LeaderboardPeriod",{description:"Period type"}),periodKey:$.string({description:"Period key (e.g., 2024-W01)"}),xp:$.int({default:0,description:"XP earned in period"}),rank:$.int({isOptional:!0,description:"Rank in leaderboard"}),lessonsCompleted:$.int({default:0,description:"Lessons completed"}),quizzesPassed:$.int({default:0,description:"Quizzes passed"}),cardsReviewed:$.int({default:0,description:"Cards reviewed"}),streakDays:$.int({default:0,description:"Streak days in period"}),league:$.string({isOptional:!0,description:"League tier"}),orgId:$.string({isOptional:!0,description:"Organization scope"}),createdAt:$.createdAt(),updatedAt:$.updatedAt(),learner:$.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[X.unique(["learnerId","periodType","periodKey"],{name:"leaderboard_entry_unique"}),X.on(["periodType","periodKey","xp"]),X.on(["orgId","periodType","periodKey","xp"])],enums:[Aj]}),LZ=x({name:"Heart",description:"Lives/hearts system for quiz attempts.",schema:"lssm_learning",map:"heart",fields:{id:$.id({description:"Unique heart record identifier"}),learnerId:$.foreignKey({description:"Learner"}),current:$.int({default:5,description:"Current hearts"}),max:$.int({default:5,description:"Maximum hearts"}),lastRefillAt:$.dateTime({isOptional:!0,description:"Last refill time"}),nextRefillAt:$.dateTime({isOptional:!0,description:"Next refill time"}),refillIntervalMinutes:$.int({default:240,description:"Minutes between refills"}),infiniteUntil:$.dateTime({isOptional:!0,description:"Infinite hearts until"}),createdAt:$.createdAt(),updatedAt:$.updatedAt(),learner:$.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[X.unique(["learnerId"],{name:"heart_learner_unique"}),X.on(["nextRefillAt"])]}),hZ=x({name:"XPTransaction",description:"Record of XP earned or spent.",schema:"lssm_learning",map:"xp_transaction",fields:{id:$.id({description:"Unique transaction identifier"}),learnerId:$.foreignKey({description:"Learner"}),amount:$.int({description:"XP amount (positive = earned, negative = spent)"}),type:$.string({description:"Transaction type (lesson, quiz, streak, achievement, etc.)"}),sourceType:$.string({isOptional:!0,description:"Source entity type"}),sourceId:$.string({isOptional:!0,description:"Source entity ID"}),description:$.string({isOptional:!0,description:"Human-readable description"}),balanceAfter:$.int({description:"Total XP after transaction"}),createdAt:$.createdAt(),learner:$.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[X.on(["learnerId","createdAt"]),X.on(["type"]),X.on(["sourceType","sourceId"])]}),Cj=[GZ,MZ,PZ,AZ,CZ,LZ,hZ],Lj=[Pj,Aj];import{defineEntity as v,defineEntityEnum as hj,field as H,index as P}from"@contractspec/lib.schema";var gj=hj({name:"EnrollmentStatus",values:["ENROLLED","IN_PROGRESS","COMPLETED","DROPPED","EXPIRED"],schema:"lssm_learning",description:"Status of a course enrollment."}),bj=hj({name:"ProgressStatus",values:["NOT_STARTED","IN_PROGRESS","COMPLETED","SKIPPED"],schema:"lssm_learning",description:"Status of lesson progress."}),gZ=v({name:"Learner",description:"A learner profile.",schema:"lssm_learning",map:"learner",fields:{id:H.id({description:"Unique learner identifier"}),userId:H.string({isUnique:!0,description:"Associated user ID"}),displayName:H.string({isOptional:!0,description:"Display name"}),avatarUrl:H.string({isOptional:!0,description:"Avatar URL"}),bio:H.string({isOptional:!0,description:"Short bio"}),level:H.int({default:1,description:"Current level"}),totalXp:H.int({default:0,description:"Total XP earned"}),currentStreak:H.int({default:0,description:"Current streak days"}),longestStreak:H.int({default:0,description:"Longest streak ever"}),lastActivityAt:H.dateTime({isOptional:!0,description:"Last learning activity"}),locale:H.string({isOptional:!0,description:'Preferred locale for learning content (e.g. "en", "fr", "es")'}),timezone:H.string({default:'"UTC"',description:"Learner timezone"}),dailyGoalXp:H.int({default:50,description:"Daily XP goal"}),reminderEnabled:H.boolean({default:!0,description:"Enable reminders"}),reminderTime:H.string({isOptional:!0,description:"Preferred reminder time"}),orgId:H.string({isOptional:!0,description:"Organization scope"}),metadata:H.json({isOptional:!0,description:"Additional metadata"}),createdAt:H.createdAt(),updatedAt:H.updatedAt(),enrollments:H.hasMany("Enrollment"),lessonProgress:H.hasMany("LessonProgress"),achievements:H.hasMany("LearnerAchievement"),decks:H.hasMany("Deck"),profile:H.hasOne("LearnerProfile")},indexes:[P.on(["orgId"]),P.on(["totalXp"]),P.on(["level"]),P.on(["currentStreak"])]}),bZ=v({name:"Enrollment",description:"A learner enrollment in a course.",schema:"lssm_learning",map:"enrollment",fields:{id:H.id({description:"Unique enrollment identifier"}),learnerId:H.foreignKey({description:"Enrolled learner"}),courseId:H.foreignKey({description:"Enrolled course"}),status:H.enum("EnrollmentStatus",{default:"ENROLLED",description:"Enrollment status"}),progress:H.int({default:0,description:"Completion percentage (0-100)"}),completedLessons:H.int({default:0,description:"Number of completed lessons"}),totalLessons:H.int({default:0,description:"Total lessons in course"}),xpEarned:H.int({default:0,description:"XP earned in this course"}),startedAt:H.dateTime({isOptional:!0,description:"When learner started"}),completedAt:H.dateTime({isOptional:!0,description:"When learner completed"}),lastAccessedAt:H.dateTime({isOptional:!0,description:"Last access time"}),certificateId:H.string({isOptional:!0,description:"Issued certificate ID"}),metadata:H.json({isOptional:!0,description:"Additional metadata"}),createdAt:H.createdAt(),updatedAt:H.updatedAt(),learner:H.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),course:H.belongsTo("Course",["courseId"],["id"],{onDelete:"Cascade"})},indexes:[P.unique(["learnerId","courseId"],{name:"enrollment_unique"}),P.on(["learnerId","status"]),P.on(["courseId","status"])],enums:[gj]}),xZ=v({name:"LessonProgress",description:"Progress tracking for a lesson.",schema:"lssm_learning",map:"lesson_progress",fields:{id:H.id({description:"Unique progress identifier"}),learnerId:H.foreignKey({description:"Learner"}),lessonId:H.foreignKey({description:"Lesson"}),status:H.enum("ProgressStatus",{default:"NOT_STARTED",description:"Progress status"}),progress:H.int({default:0,description:"Completion percentage (0-100)"}),score:H.int({isOptional:!0,description:"Score achieved (for quizzes)"}),attempts:H.int({default:0,description:"Number of attempts"}),bestScore:H.int({isOptional:!0,description:"Best score across attempts"}),timeSpent:H.int({default:0,description:"Time spent in seconds"}),xpEarned:H.int({default:0,description:"XP earned from this lesson"}),startedAt:H.dateTime({isOptional:!0,description:"When started"}),completedAt:H.dateTime({isOptional:!0,description:"When completed"}),lastAccessedAt:H.dateTime({isOptional:!0,description:"Last access time"}),bookmarks:H.json({isOptional:!0,description:"Content bookmarks"}),notes:H.string({isOptional:!0,description:"Learner notes"}),createdAt:H.createdAt(),updatedAt:H.updatedAt(),learner:H.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),lesson:H.belongsTo("Lesson",["lessonId"],["id"],{onDelete:"Cascade"})},indexes:[P.unique(["learnerId","lessonId"],{name:"lesson_progress_unique"}),P.on(["learnerId","status"]),P.on(["lessonId"])],enums:[bj]}),NZ=v({name:"ModuleCompletion",description:"Module completion record.",schema:"lssm_learning",map:"module_completion",fields:{id:H.id({description:"Unique completion identifier"}),learnerId:H.foreignKey({description:"Learner"}),moduleId:H.foreignKey({description:"Module"}),score:H.int({isOptional:!0,description:"Average score"}),xpEarned:H.int({default:0,description:"XP earned"}),timeSpent:H.int({default:0,description:"Time spent in seconds"}),completedAt:H.dateTime({description:"When completed"}),createdAt:H.createdAt(),learner:H.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),module:H.belongsTo("CourseModule",["moduleId"],["id"],{onDelete:"Cascade"})},indexes:[P.unique(["learnerId","moduleId"],{name:"module_completion_unique"}),P.on(["learnerId","completedAt"])]}),pZ=v({name:"Certificate",description:"Course completion certificate.",schema:"lssm_learning",map:"certificate",fields:{id:H.id({description:"Unique certificate identifier"}),learnerId:H.foreignKey({description:"Certificate holder"}),courseId:H.foreignKey({description:"Completed course"}),enrollmentId:H.foreignKey({description:"Associated enrollment"}),certificateNumber:H.string({isUnique:!0,description:"Unique certificate number"}),title:H.string({description:"Certificate title"}),description:H.string({isOptional:!0,description:"Certificate description"}),score:H.int({isOptional:!0,description:"Final score"}),grade:H.string({isOptional:!0,description:"Grade awarded"}),issuedAt:H.dateTime({description:"When issued"}),validUntil:H.dateTime({isOptional:!0,description:"Expiration date"}),verificationUrl:H.string({isOptional:!0,description:"Verification URL"}),credentialHash:H.string({isOptional:!0,description:"Credential hash for verification"}),isRevoked:H.boolean({default:!1,description:"Whether certificate is revoked"}),revokedAt:H.dateTime({isOptional:!0,description:"When revoked"}),revokedReason:H.string({isOptional:!0,description:"Revocation reason"}),metadata:H.json({isOptional:!0,description:"Additional metadata"}),createdAt:H.createdAt(),learner:H.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),course:H.belongsTo("Course",["courseId"],["id"],{onDelete:"Cascade"})},indexes:[P.on(["learnerId"]),P.on(["courseId"]),P.on(["issuedAt"])]}),xj=[gZ,bZ,xZ,NZ,pZ],Nj=[gj,bj];import{defineEntity as u,defineEntityEnum as vZ,field as K,index as h}from"@contractspec/lib.schema";var pj=vZ({name:"OnboardingStepStatus",values:["PENDING","IN_PROGRESS","COMPLETED","SKIPPED"],schema:"lssm_learning",description:"Status of an onboarding step."}),RZ=u({name:"OnboardingTrack",description:"An onboarding track for a product.",schema:"lssm_learning",map:"onboarding_track",fields:{id:K.id({description:"Unique track identifier"}),productId:K.string({description:"Product this track is for"}),name:K.string({description:"Track name"}),description:K.string({isOptional:!0,description:"Track description"}),targetUserSegment:K.string({isOptional:!0,description:"Target user segment"}),targetRole:K.string({isOptional:!0,description:"Target user role"}),welcomeTitle:K.string({isOptional:!0,description:"Welcome message title"}),welcomeMessage:K.string({isOptional:!0,description:"Welcome message"}),completionTitle:K.string({isOptional:!0,description:"Completion message title"}),completionMessage:K.string({isOptional:!0,description:"Completion message"}),isActive:K.boolean({default:!0,description:"Whether track is active"}),isRequired:K.boolean({default:!1,description:"Whether track is required"}),canSkip:K.boolean({default:!0,description:"Whether steps can be skipped"}),totalXp:K.int({default:100,description:"Total XP for completing track"}),completionXpBonus:K.int({isOptional:!0,description:"Bonus XP for completing track"}),completionBadgeKey:K.string({isOptional:!0,description:"Badge awarded on completion"}),streakHoursWindow:K.int({isOptional:!0,description:"Hours window to finish for streak bonus"}),streakBonusXp:K.int({isOptional:!0,description:"Bonus XP if completed within streak window"}),orgId:K.string({isOptional:!0,description:"Organization scope"}),metadata:K.json({isOptional:!0,description:"Additional metadata"}),createdAt:K.createdAt(),updatedAt:K.updatedAt(),steps:K.hasMany("OnboardingStep"),progress:K.hasMany("OnboardingProgress")},indexes:[h.on(["productId","isActive"]),h.on(["orgId"]),h.unique(["productId","targetUserSegment","targetRole"],{name:"onboarding_track_target"})]}),wZ=u({name:"OnboardingStep",description:"A step in an onboarding track.",schema:"lssm_learning",map:"onboarding_step",fields:{id:K.id({description:"Unique step identifier"}),trackId:K.foreignKey({description:"Parent track"}),title:K.string({description:"Step title"}),description:K.string({isOptional:!0,description:"Step description"}),instructions:K.string({isOptional:!0,description:"How to complete the step"}),helpUrl:K.string({isOptional:!0,description:"Link to help documentation"}),order:K.int({default:0,description:"Display order"}),triggerEvent:K.string({isOptional:!0,description:"Event that triggers step start"}),completionEvent:K.string({description:"Event that completes the step"}),completionEventVersion:K.int({isOptional:!0,description:"Version of the completion event"}),completionSourceModule:K.string({isOptional:!0,description:"Module emitting the completion event"}),completionEventFilter:K.json({isOptional:!0,description:"Filter for completion event"}),actionUrl:K.string({isOptional:!0,description:"URL to navigate to complete"}),actionLabel:K.string({isOptional:!0,description:"Action button label"}),highlightSelector:K.string({isOptional:!0,description:"CSS selector to highlight"}),tooltipPosition:K.string({isOptional:!0,description:"Tooltip position"}),xpReward:K.int({default:10,description:"XP for completing step"}),isRequired:K.boolean({default:!0,description:"Whether step is required"}),canSkip:K.boolean({default:!0,description:"Whether step can be skipped"}),metadata:K.json({isOptional:!0,description:"Additional metadata"}),createdAt:K.createdAt(),updatedAt:K.updatedAt(),track:K.belongsTo("OnboardingTrack",["trackId"],["id"],{onDelete:"Cascade"})},indexes:[h.on(["trackId","order"]),h.on(["completionEvent"])]}),sZ=u({name:"OnboardingProgress",description:"Tracks user progress through an onboarding track.",schema:"lssm_learning",map:"onboarding_progress",fields:{id:K.id({description:"Unique progress identifier"}),learnerId:K.foreignKey({description:"Learner"}),trackId:K.foreignKey({description:"Onboarding track"}),currentStepId:K.string({isOptional:!0,description:"Current step ID"}),completedSteps:K.json({default:"[]",description:"Array of completed step IDs"}),skippedSteps:K.json({default:"[]",description:"Array of skipped step IDs"}),progress:K.int({default:0,description:"Completion percentage (0-100)"}),isCompleted:K.boolean({default:!1,description:"Whether track is completed"}),xpEarned:K.int({default:0,description:"XP earned from track"}),startedAt:K.dateTime({description:"When user started"}),completedAt:K.dateTime({isOptional:!0,description:"When user completed"}),lastActivityAt:K.dateTime({isOptional:!0,description:"Last activity"}),isDismissed:K.boolean({default:!1,description:"Whether user dismissed onboarding"}),dismissedAt:K.dateTime({isOptional:!0,description:"When dismissed"}),metadata:K.json({isOptional:!0,description:"Additional metadata"}),createdAt:K.createdAt(),updatedAt:K.updatedAt(),learner:K.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),track:K.belongsTo("OnboardingTrack",["trackId"],["id"],{onDelete:"Cascade"})},indexes:[h.unique(["learnerId","trackId"],{name:"onboarding_progress_unique"}),h.on(["learnerId","isCompleted"]),h.on(["trackId"])],enums:[pj]}),TZ=u({name:"OnboardingStepCompletion",description:"Individual step completion record.",schema:"lssm_learning",map:"onboarding_step_completion",fields:{id:K.id({description:"Unique completion identifier"}),progressId:K.foreignKey({description:"Parent progress record"}),stepId:K.foreignKey({description:"Completed step"}),status:K.enum("OnboardingStepStatus",{description:"Completion status"}),xpEarned:K.int({default:0,description:"XP earned"}),triggeringEvent:K.string({isOptional:!0,description:"Event that triggered completion"}),eventPayload:K.json({isOptional:!0,description:"Event payload"}),completedAt:K.dateTime({description:"When completed"}),createdAt:K.createdAt(),progress:K.belongsTo("OnboardingProgress",["progressId"],["id"],{onDelete:"Cascade"}),step:K.belongsTo("OnboardingStep",["stepId"],["id"],{onDelete:"Cascade"})},indexes:[h.unique(["progressId","stepId"],{name:"step_completion_unique"}),h.on(["completedAt"])]}),vj=[RZ,wZ,sZ,TZ],Rj=[pj];import{defineEntity as R,defineEntityEnum as m,field as _,index as C}from"@contractspec/lib.schema";var wj=m({name:"QuestionType",values:["MULTIPLE_CHOICE","TRUE_FALSE","FILL_BLANK","MATCHING","SHORT_ANSWER","CODE"],schema:"lssm_learning",description:"Type of quiz question."}),sj=m({name:"QuizStatus",values:["DRAFT","PUBLISHED","ARCHIVED"],schema:"lssm_learning",description:"Publication status of a quiz."}),Tj=m({name:"AttemptStatus",values:["IN_PROGRESS","COMPLETED","TIMED_OUT","ABANDONED"],schema:"lssm_learning",description:"Status of a quiz attempt."}),oZ=R({name:"Quiz",description:"A quiz assessment.",schema:"lssm_learning",map:"quiz",fields:{id:_.id({description:"Unique quiz identifier"}),lessonId:_.foreignKey({isOptional:!0,description:"Associated lesson"}),title:_.string({description:"Quiz title"}),description:_.string({isOptional:!0,description:"Quiz description"}),instructions:_.string({isOptional:!0,description:"Quiz instructions"}),passingScore:_.int({default:70,description:"Passing score percentage"}),timeLimit:_.int({isOptional:!0,description:"Time limit in seconds"}),maxAttempts:_.int({isOptional:!0,description:"Maximum attempts allowed"}),shuffleQuestions:_.boolean({default:!1,description:"Shuffle question order"}),shuffleOptions:_.boolean({default:!1,description:"Shuffle answer options"}),showCorrectAnswers:_.boolean({default:!0,description:"Show correct answers after"}),showExplanations:_.boolean({default:!0,description:"Show explanations after"}),status:_.enum("QuizStatus",{default:"DRAFT",description:"Publication status"}),totalPoints:_.int({default:0,description:"Total points available"}),xpReward:_.int({default:20,description:"XP for passing"}),orgId:_.string({isOptional:!0,description:"Organization scope"}),metadata:_.json({isOptional:!0,description:"Additional metadata"}),createdAt:_.createdAt(),updatedAt:_.updatedAt(),lesson:_.belongsTo("Lesson",["lessonId"],["id"],{onDelete:"Cascade"}),questions:_.hasMany("Question"),attempts:_.hasMany("QuizAttempt")},indexes:[C.on(["lessonId"]),C.on(["status"]),C.on(["orgId"])],enums:[sj]}),uZ=R({name:"Question",description:"A quiz question.",schema:"lssm_learning",map:"question",fields:{id:_.id({description:"Unique question identifier"}),quizId:_.foreignKey({description:"Parent quiz"}),type:_.enum("QuestionType",{description:"Question type"}),content:_.string({description:"Question text"}),mediaUrl:_.string({isOptional:!0,description:"Question media"}),points:_.int({default:1,description:"Points for correct answer"}),codeLanguage:_.string({isOptional:!0,description:"Programming language"}),codeTemplate:_.string({isOptional:!0,description:"Starter code template"}),testCases:_.json({isOptional:!0,description:"Test cases for code validation"}),explanation:_.string({isOptional:!0,description:"Explanation of correct answer"}),hint:_.string({isOptional:!0,description:"Hint for the question"}),order:_.int({default:0,description:"Display order"}),skillId:_.string({isOptional:!0,description:"Associated skill"}),metadata:_.json({isOptional:!0,description:"Additional metadata"}),createdAt:_.createdAt(),updatedAt:_.updatedAt(),quiz:_.belongsTo("Quiz",["quizId"],["id"],{onDelete:"Cascade"}),options:_.hasMany("QuestionOption")},indexes:[C.on(["quizId","order"]),C.on(["type"]),C.on(["skillId"])],enums:[wj]}),yZ=R({name:"QuestionOption",description:"An answer option for a question.",schema:"lssm_learning",map:"question_option",fields:{id:_.id({description:"Unique option identifier"}),questionId:_.foreignKey({description:"Parent question"}),content:_.string({description:"Option text"}),matchContent:_.string({isOptional:!0,description:"Match pair content"}),isCorrect:_.boolean({default:!1,description:"Whether option is correct"}),feedback:_.string({isOptional:!0,description:"Feedback when selected"}),order:_.int({default:0,description:"Display order"}),metadata:_.json({isOptional:!0,description:"Additional metadata"}),createdAt:_.createdAt(),updatedAt:_.updatedAt(),question:_.belongsTo("Question",["questionId"],["id"],{onDelete:"Cascade"})},indexes:[C.on(["questionId","order"])]}),SZ=R({name:"QuizAttempt",description:"A learner quiz attempt.",schema:"lssm_learning",map:"quiz_attempt",fields:{id:_.id({description:"Unique attempt identifier"}),learnerId:_.foreignKey({description:"Learner"}),quizId:_.foreignKey({description:"Quiz"}),status:_.enum("AttemptStatus",{default:"IN_PROGRESS",description:"Attempt status"}),score:_.int({isOptional:!0,description:"Score achieved"}),percentageScore:_.int({isOptional:!0,description:"Percentage score"}),passed:_.boolean({isOptional:!0,description:"Whether passed"}),totalQuestions:_.int({default:0,description:"Total questions"}),answeredQuestions:_.int({default:0,description:"Questions answered"}),correctAnswers:_.int({default:0,description:"Correct answers"}),answers:_.json({isOptional:!0,description:"Submitted answers"}),xpEarned:_.int({default:0,description:"XP earned"}),timeSpent:_.int({default:0,description:"Time spent in seconds"}),startedAt:_.dateTime({description:"When started"}),completedAt:_.dateTime({isOptional:!0,description:"When completed"}),attemptNumber:_.int({default:1,description:"Which attempt this is"}),metadata:_.json({isOptional:!0,description:"Additional metadata"}),createdAt:_.createdAt(),updatedAt:_.updatedAt(),learner:_.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),quiz:_.belongsTo("Quiz",["quizId"],["id"],{onDelete:"Cascade"})},indexes:[C.on(["learnerId","quizId"]),C.on(["learnerId","status"]),C.on(["quizId","status"])],enums:[Tj]}),rZ=R({name:"SkillAssessment",description:"Assessment of a skill based on quiz performance.",schema:"lssm_learning",map:"skill_assessment",fields:{id:_.id({description:"Unique assessment identifier"}),learnerId:_.foreignKey({description:"Learner"}),skillId:_.string({description:"Skill identifier"}),skillName:_.string({description:"Skill name"}),level:_.int({default:1,description:"Proficiency level (1-5)"}),score:_.int({default:0,description:"Assessment score (0-100)"}),confidence:_.decimal({default:0.5,description:"Confidence in assessment"}),questionsAnswered:_.int({default:0,description:"Total questions answered"}),questionsCorrect:_.int({default:0,description:"Total correct"}),assessedAt:_.dateTime({description:"Last assessment time"}),createdAt:_.createdAt(),updatedAt:_.updatedAt(),learner:_.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[C.unique(["learnerId","skillId"],{name:"skill_assessment_unique"}),C.on(["learnerId","level"]),C.on(["skillId"])]}),oj=[oZ,uZ,yZ,SZ,rZ],uj=[wj,sj,Tj];var cZ=[...Fj,...xj,...vj,...Uj,...oj,...Cj,...zj],mZ=[...Xj,...Nj,...Rj,...Gj,...uj,...Lj,...Dj],t1={moduleId:"@contractspec/module.learning-journey",entities:cZ,enums:mZ};import{defineEvent as U}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as G,ScalarTypeEnum as V}from"@contractspec/lib.schema";var EZ=G({name:"CoursePublishedEventPayload",description:"Payload when a course is published",fields:{courseId:{type:V.String_unsecure(),isOptional:!1},title:{type:V.String_unsecure(),isOptional:!1},authorId:{type:V.String_unsecure(),isOptional:!1},publishedAt:{type:V.DateTime(),isOptional:!1}}}),tZ=U({meta:{key:"course.published",version:"1.0.0",description:"A course has been published.",stability:"stable",owners:[...J],tags:["learning","course"]},payload:EZ}),fZ=G({name:"EnrollmentCreatedEventPayload",description:"Payload when a learner enrolls in a course",fields:{enrollmentId:{type:V.String_unsecure(),isOptional:!1},learnerId:{type:V.String_unsecure(),isOptional:!1},courseId:{type:V.String_unsecure(),isOptional:!1},enrolledAt:{type:V.DateTime(),isOptional:!1}}}),aZ=U({meta:{key:"enrollment.created",version:"1.0.0",description:"A learner has enrolled in a course.",stability:"stable",owners:[...J],tags:["learning","enrollment"]},payload:fZ}),nZ=G({name:"LessonCompletedEventPayload",description:"Payload when a lesson is completed",fields:{learnerId:{type:V.String_unsecure(),isOptional:!1},lessonId:{type:V.String_unsecure(),isOptional:!1},courseId:{type:V.String_unsecure(),isOptional:!1},score:{type:V.Int_unsecure(),isOptional:!0},xpEarned:{type:V.Int_unsecure(),isOptional:!1},timeSpent:{type:V.Int_unsecure(),isOptional:!1},completedAt:{type:V.DateTime(),isOptional:!1}}}),lZ=U({meta:{key:"lesson.completed",version:"1.0.0",description:"A learner has completed a lesson.",stability:"stable",owners:[...J],tags:["learning","progress","lesson"]},payload:nZ}),dZ=G({name:"CourseCompletedEventPayload",description:"Payload when a course is completed",fields:{learnerId:{type:V.String_unsecure(),isOptional:!1},courseId:{type:V.String_unsecure(),isOptional:!1},enrollmentId:{type:V.String_unsecure(),isOptional:!1},score:{type:V.Int_unsecure(),isOptional:!0},xpEarned:{type:V.Int_unsecure(),isOptional:!1},certificateId:{type:V.String_unsecure(),isOptional:!0},completedAt:{type:V.DateTime(),isOptional:!1}}}),iZ=U({meta:{key:"course.completed",version:"1.0.0",description:"A learner has completed a course.",stability:"stable",owners:[...J],tags:["learning","progress","course"]},payload:dZ}),eZ=G({name:"OnboardingStartedEventPayload",description:"Payload when onboarding starts",fields:{learnerId:{type:V.String_unsecure(),isOptional:!1},trackId:{type:V.String_unsecure(),isOptional:!1},productId:{type:V.String_unsecure(),isOptional:!1},startedAt:{type:V.DateTime(),isOptional:!1}}}),j0=U({meta:{key:"onboarding.started",version:"1.0.0",description:"A learner has started onboarding.",stability:"stable",owners:[...J],tags:["learning","onboarding"]},payload:eZ}),Z0=G({name:"OnboardingStepCompletedEventPayload",description:"Payload when an onboarding step is completed",fields:{learnerId:{type:V.String_unsecure(),isOptional:!1},trackId:{type:V.String_unsecure(),isOptional:!1},stepId:{type:V.String_unsecure(),isOptional:!1},triggeringEvent:{type:V.String_unsecure(),isOptional:!0},xpEarned:{type:V.Int_unsecure(),isOptional:!1},completedAt:{type:V.DateTime(),isOptional:!1}}}),$0=U({meta:{key:"onboarding.step_completed",version:"1.0.0",description:"An onboarding step has been completed.",stability:"stable",owners:[...J],tags:["learning","onboarding"]},payload:Z0}),H0=G({name:"OnboardingCompletedEventPayload",description:"Payload when onboarding is completed",fields:{learnerId:{type:V.String_unsecure(),isOptional:!1},trackId:{type:V.String_unsecure(),isOptional:!1},productId:{type:V.String_unsecure(),isOptional:!1},xpEarned:{type:V.Int_unsecure(),isOptional:!1},completedAt:{type:V.DateTime(),isOptional:!1}}}),V0=U({meta:{key:"onboarding.completed",version:"1.0.0",description:"A learner has completed onboarding.",stability:"stable",owners:[...J],tags:["learning","onboarding"]},payload:H0}),_0=G({name:"CardReviewedEventPayload",description:"Payload when a flashcard is reviewed",fields:{learnerId:{type:V.String_unsecure(),isOptional:!1},cardId:{type:V.String_unsecure(),isOptional:!1},deckId:{type:V.String_unsecure(),isOptional:!1},rating:{type:V.String_unsecure(),isOptional:!1},responseTimeMs:{type:V.Int_unsecure(),isOptional:!0},reviewedAt:{type:V.DateTime(),isOptional:!1}}}),I0=U({meta:{key:"flashcard.reviewed",version:"1.0.0",description:"A flashcard has been reviewed.",stability:"stable",owners:[...J],tags:["learning","flashcards"]},payload:_0}),K0=G({name:"QuizStartedEventPayload",description:"Payload when a quiz is started",fields:{learnerId:{type:V.String_unsecure(),isOptional:!1},quizId:{type:V.String_unsecure(),isOptional:!1},attemptId:{type:V.String_unsecure(),isOptional:!1},attemptNumber:{type:V.Int_unsecure(),isOptional:!1},startedAt:{type:V.DateTime(),isOptional:!1}}}),O0=U({meta:{key:"quiz.started",version:"1.0.0",description:"A quiz attempt has started.",stability:"stable",owners:[...J],tags:["learning","quiz"]},payload:K0}),q0=G({name:"QuizCompletedEventPayload",description:"Payload when a quiz is completed",fields:{learnerId:{type:V.String_unsecure(),isOptional:!1},quizId:{type:V.String_unsecure(),isOptional:!1},attemptId:{type:V.String_unsecure(),isOptional:!1},score:{type:V.Int_unsecure(),isOptional:!1},percentageScore:{type:V.Int_unsecure(),isOptional:!1},passed:{type:V.Boolean(),isOptional:!1},xpEarned:{type:V.Int_unsecure(),isOptional:!1},timeSpent:{type:V.Int_unsecure(),isOptional:!1},completedAt:{type:V.DateTime(),isOptional:!1}}}),B0=U({meta:{key:"quiz.completed",version:"1.0.0",description:"A quiz attempt has been completed.",stability:"stable",owners:[...J],tags:["learning","quiz"]},payload:q0}),z0=G({name:"XpEarnedEventPayload",description:"Payload when XP is earned",fields:{learnerId:{type:V.String_unsecure(),isOptional:!1},amount:{type:V.Int_unsecure(),isOptional:!1},source:{type:V.String_unsecure(),isOptional:!1},sourceId:{type:V.String_unsecure(),isOptional:!0},totalXp:{type:V.Int_unsecure(),isOptional:!1},earnedAt:{type:V.DateTime(),isOptional:!1}}}),D0=U({meta:{key:"xp.earned",version:"1.0.0",description:"XP has been earned.",stability:"stable",owners:[...J],tags:["learning","gamification","xp"]},payload:z0}),Q0=G({name:"LevelUpEventPayload",description:"Payload when a learner levels up",fields:{learnerId:{type:V.String_unsecure(),isOptional:!1},previousLevel:{type:V.Int_unsecure(),isOptional:!1},newLevel:{type:V.Int_unsecure(),isOptional:!1},totalXp:{type:V.Int_unsecure(),isOptional:!1},leveledUpAt:{type:V.DateTime(),isOptional:!1}}}),W0=U({meta:{key:"level.up",version:"1.0.0",description:"A learner has leveled up.",stability:"stable",owners:[...J],tags:["learning","gamification","level"]},payload:Q0}),Y0=G({name:"StreakUpdatedEventPayload",description:"Payload when a streak is updated",fields:{learnerId:{type:V.String_unsecure(),isOptional:!1},previousStreak:{type:V.Int_unsecure(),isOptional:!1},currentStreak:{type:V.Int_unsecure(),isOptional:!1},longestStreak:{type:V.Int_unsecure(),isOptional:!1},freezeUsed:{type:V.Boolean(),isOptional:!1},updatedAt:{type:V.DateTime(),isOptional:!1}}}),J0=U({meta:{key:"streak.updated",version:"1.0.0",description:"A streak has been updated.",stability:"stable",owners:[...J],tags:["learning","gamification","streak"]},payload:Y0}),F0=G({name:"AchievementUnlockedEventPayload",description:"Payload when an achievement is unlocked",fields:{learnerId:{type:V.String_unsecure(),isOptional:!1},achievementId:{type:V.String_unsecure(),isOptional:!1},achievementKey:{type:V.String_unsecure(),isOptional:!1},achievementName:{type:V.String_unsecure(),isOptional:!1},xpEarned:{type:V.Int_unsecure(),isOptional:!1},unlockedAt:{type:V.DateTime(),isOptional:!1}}}),X0=U({meta:{key:"achievement.unlocked",version:"1.0.0",description:"An achievement has been unlocked.",stability:"stable",owners:[...J],tags:["learning","gamification","achievement"]},payload:F0}),k0=G({name:"DailyGoalCompletedEventPayload",description:"Payload when a daily goal is completed",fields:{learnerId:{type:V.String_unsecure(),isOptional:!1},date:{type:V.String_unsecure(),isOptional:!1},targetXp:{type:V.Int_unsecure(),isOptional:!1},actualXp:{type:V.Int_unsecure(),isOptional:!1},completedAt:{type:V.DateTime(),isOptional:!1}}}),U0=U({meta:{key:"daily_goal.completed",version:"1.0.0",description:"A daily goal has been completed.",stability:"stable",owners:[...J],tags:["learning","gamification","goal"]},payload:k0}),G0=G({name:"CertificateIssuedEventPayload",description:"Payload when a certificate is issued",fields:{certificateId:{type:V.String_unsecure(),isOptional:!1},learnerId:{type:V.String_unsecure(),isOptional:!1},courseId:{type:V.String_unsecure(),isOptional:!1},certificateNumber:{type:V.String_unsecure(),isOptional:!1},issuedAt:{type:V.DateTime(),isOptional:!1}}}),M0=U({meta:{key:"certificate.issued",version:"1.0.0",description:"A certificate has been issued.",stability:"stable",owners:[...J],tags:["learning","certificate"]},payload:G0}),V4={CoursePublishedEvent:tZ,EnrollmentCreatedEvent:aZ,LessonCompletedEvent:lZ,CourseCompletedEvent:iZ,OnboardingStartedEvent:j0,OnboardingStepCompletedEvent:$0,OnboardingCompletedEvent:V0,CardReviewedEvent:I0,QuizStartedEvent:O0,QuizCompletedEvent:B0,XpEarnedEvent:D0,LevelUpEvent:W0,StreakUpdatedEvent:J0,AchievementUnlockedEvent:X0,DailyGoalCompletedEvent:U0,CertificateIssuedEvent:M0};import{defineFeature as P0}from"@contractspec/lib.contracts-spec";var K4=P0({meta:{key:"learning-journey",version:"1.0.0",title:"Learning Journey",description:"Learning platform with courses, onboarding, flashcards, and gamification",domain:"learning",owners:["@platform.learning-journey"],tags:["learning","onboarding","courses","flashcards","gamification"],stability:"stable"},operations:[{key:"learning.onboarding.recordEvent",version:"1.0.0"},{key:"learning.onboarding.listTracks",version:"1.0.0"},{key:"learning.onboarding.getProgress",version:"1.0.0"},{key:"learning.enroll",version:"1.0.0"},{key:"learning.completeLesson",version:"1.0.0"},{key:"learning.submitCardReview",version:"1.0.0"},{key:"learning.getDueCards",version:"1.0.0"},{key:"learning.getDashboard",version:"1.0.0"}],events:[{key:"course.published",version:"1.0.0"},{key:"course.completed",version:"1.0.0"},{key:"enrollment.created",version:"1.0.0"},{key:"lesson.completed",version:"1.0.0"},{key:"onboarding.started",version:"1.0.0"},{key:"onboarding.step_completed",version:"1.0.0"},{key:"onboarding.completed",version:"1.0.0"},{key:"flashcard.reviewed",version:"1.0.0"},{key:"quiz.started",version:"1.0.0"},{key:"quiz.completed",version:"1.0.0"},{key:"xp.earned",version:"1.0.0"},{key:"level.up",version:"1.0.0"},{key:"streak.updated",version:"1.0.0"},{key:"achievement.unlocked",version:"1.0.0"},{key:"daily_goal.completed",version:"1.0.0"},{key:"certificate.issued",version:"1.0.0"}],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{provides:[{key:"learning-journey",version:"1.0.0"},{key:"onboarding",version:"1.0.0"},{key:"gamification",version:"1.0.0"}],requires:[{key:"identity",version:"1.0.0"}]}});export{k1 as xpEngine,$1 as streakEngine,j1 as srsEngine,uj as quizEnums,oj as quizEntities,Rj as onboardingEnums,vj as onboardingEntities,t1 as learningJourneySchemaContribution,mZ as learningJourneyEnums,cZ as learningJourneyEntities,Nj as learnerEnums,xj as learnerEntities,X1 as getXpSourceLabel,Lj as gamificationEnums,Cj as gamificationEntities,Gj as flashcardEnums,Uj as flashcardEntities,Xj as courseEnums,Fj as courseEntities,Dj as aiEnums,zj as aiEntities,D0 as XpEarnedEvent,hZ as XPTransactionEntity,Kj as XPEngine,N as SuccessOutput,f as SubmitCardReviewInput,c0 as SubmitCardReviewContract,J0 as StreakUpdatedEvent,PZ as StreakEntity,$j as StreakEngine,OZ as SkillMapEntity,rZ as SkillAssessmentEntity,Zj as SRSEngine,s0 as RecordOnboardingEventContract,Bj as RecommendationTypeEnum,BZ as RecommendationEntity,sj as QuizStatusEnum,O0 as QuizStartedEvent,oZ as QuizEntity,B0 as QuizCompletedEvent,SZ as QuizAttemptEntity,wj as QuestionTypeEnum,yZ as QuestionOptionEntity,uZ as QuestionEntity,bj as ProgressStatusEnum,L0 as ProgressModel,tj as OnboardingTrackModel,RZ as OnboardingTrackEntity,pj as OnboardingStepStatusEnum,fj as OnboardingStepProgressModel,Ej as OnboardingStepModel,wZ as OnboardingStepEntity,TZ as OnboardingStepCompletionEntity,$0 as OnboardingStepCompletedEvent,j0 as OnboardingStartedEvent,e as OnboardingProgressModel,sZ as OnboardingProgressEntity,V0 as OnboardingCompletedEvent,NZ as ModuleCompletionEntity,R0 as ListOnboardingTracksContract,W0 as LevelUpEvent,Yj as LessonTypeEnum,xZ as LessonProgressEntity,WZ as LessonEntity,YZ as LessonContentEntity,lZ as LessonCompletedEvent,qj as LearningStyleEnum,qZ as LearningPathEntity,K4 as LearningJourneyFeature,V4 as LearningJourneyEvents,zZ as LearningGapEntity,KZ as LearnerProfileEntity,yj as LearnerModel,gZ as LearnerEntity,d as LearnerDashboardModel,MZ as LearnerAchievementEntity,Aj as LeaderboardPeriodEnum,CZ as LeaderboardEntryEntity,J as LEARNING_JOURNEY_OWNERS,LZ as HeartEntity,w0 as GetOnboardingProgressContract,l as GetLearnerDashboardInput,E0 as GetLearnerDashboardContract,n as GetDueCardsOutput,a as GetDueCardsInput,m0 as GetDueCardsContract,gj as EnrollmentStatusEnum,S as EnrollmentModel,bZ as EnrollmentEntity,aZ as EnrollmentCreatedEvent,E as EnrollInCourseInput,S0 as EnrollInCourseContract,h0 as DeckModel,FZ as DeckEntity,AZ as DailyGoalEntity,U0 as DailyGoalCompletedEvent,w as DEFAULT_XP_CONFIG,ZZ as DEFAULT_STREAK_CONFIG,jZ as DEFAULT_SRS_CONFIG,Wj as CourseStatusEnum,tZ as CoursePublishedEvent,QZ as CourseModuleEntity,C0 as CourseModel,DZ as CourseEntity,Qj as CourseDifficultyEnum,iZ as CourseCompletedEvent,Jj as ContentTypeEnum,t as CompleteLessonInput,r0 as CompleteLessonContract,M0 as CertificateIssuedEvent,pZ as CertificateEntity,UZ as CardScheduleEntity,I0 as CardReviewedEvent,kZ as CardReviewEntity,kj as CardRatingEnum,Sj as CardModel,XZ as CardEntity,Tj as AttemptStatusEnum,X0 as AchievementUnlockedEvent,Pj as AchievementTypeEnum,rj as AchievementModel,GZ as AchievementEntity};
+- Use Feature Flags to trial new tracks or reward rules; default safe/off.`}];Bt(jt);var it={learningSteps:[1,10],graduatingInterval:1,easyInterval:4,relearningSteps:[10],minEaseFactor:1.3,maxInterval:365,intervalModifier:1,newIntervalModifier:0.5,hardIntervalModifier:1.2,easyBonus:1.3};class Dr{config;constructor(r={}){this.config={...it,...r}}calculateNextReview(r,t,o=new Date){if(!r.isGraduated&&!r.isRelearning)return this.handleLearningCard(r,t,o);if(r.isRelearning)return this.handleRelearningCard(r,t,o);return this.handleReviewCard(r,t,o)}getInitialState(){return{interval:0,easeFactor:2.5,repetitions:0,learningStep:0,isGraduated:!1,isRelearning:!1,lapses:0}}isDue(r,t=new Date){return r<=t}getOverdueDays(r,t=new Date){let o=t.getTime()-r.getTime();return Math.floor(o/86400000)}handleLearningCard(r,t,o){let s=this.config.learningSteps,c=r.learningStep,A=!1,I=0,O;switch(t){case"AGAIN":c=0,I=s[0]??1,O=this.addMinutes(o,I);break;case"HARD":I=s[c]??s[0]??1,O=this.addMinutes(o,I);break;case"GOOD":if(c++,c>=s.length)A=!0,I=this.config.graduatingInterval,O=this.addDays(o,I);else I=s[c]??10,O=this.addMinutes(o,I);break;case"EASY":A=!0,I=this.config.easyInterval,O=this.addDays(o,I);break}return{interval:A?I:0,easeFactor:r.easeFactor,repetitions:A?1:0,nextReviewAt:O,learningStep:c,isGraduated:A,isRelearning:!1,lapses:r.lapses}}handleRelearningCard(r,t,o){let s=this.config.relearningSteps,c=r.learningStep,A=!0,I=0,O;switch(t){case"AGAIN":c=0,I=s[0]??10,O=this.addMinutes(o,I);break;case"HARD":I=s[c]??s[0]??10,O=this.addMinutes(o,I);break;case"GOOD":if(c++,c>=s.length)A=!1,I=Math.max(1,Math.floor(r.interval*this.config.newIntervalModifier)),O=this.addDays(o,I);else I=s[c]??10,O=this.addMinutes(o,I);break;case"EASY":A=!1,I=Math.max(1,Math.floor(r.interval*this.config.newIntervalModifier*1.5)),O=this.addDays(o,I);break}return{interval:A?r.interval:I,easeFactor:r.easeFactor,repetitions:A?r.repetitions:r.repetitions+1,nextReviewAt:O,learningStep:c,isGraduated:!0,isRelearning:A,lapses:r.lapses}}handleReviewCard(r,t,o){let s,c=r.easeFactor,A=r.repetitions,I=!1,O=0,j=r.lapses;switch(t){case"AGAIN":return j++,I=!0,O=0,c=Math.max(this.config.minEaseFactor,c-0.2),s=r.interval,{interval:s,easeFactor:c,repetitions:A,nextReviewAt:this.addMinutes(o,this.config.relearningSteps[0]??10),learningStep:O,isGraduated:!0,isRelearning:!0,lapses:j};case"HARD":c=Math.max(this.config.minEaseFactor,c-0.15),s=Math.max(r.interval+1,r.interval*this.config.hardIntervalModifier);break;case"GOOD":s=r.interval*c*this.config.intervalModifier,A++;break;case"EASY":c=c+0.15,s=r.interval*c*this.config.easyBonus*this.config.intervalModifier,A++;break}return s=Math.min(Math.round(s),this.config.maxInterval),s=Math.max(1,s),{interval:s,easeFactor:c,repetitions:A,nextReviewAt:this.addDays(o,s),learningStep:O,isGraduated:!0,isRelearning:I,lapses:j}}addMinutes(r,t){return new Date(r.getTime()+t*60*1000)}addDays(r,t){return new Date(r.getTime()+t*24*60*60*1000)}}var Vo=new Dr;var Kt={timezone:"UTC",freezesPerMonth:2,maxFreezes:5,gracePeriodHours:4};class U{config;constructor(r={}){this.config={...Kt,...r}}update(r,t=new Date){let o=this.getDateString(t),s={state:{...r},streakMaintained:!1,streakLost:!1,freezeUsed:!1,newStreak:!1,daysMissed:0};if(!r.lastActivityDate)return s.state.currentStreak=1,s.state.longestStreak=Math.max(1,r.longestStreak),s.state.lastActivityAt=t,s.state.lastActivityDate=o,s.newStreak=!0,s.streakMaintained=!0,s;if(r.lastActivityDate===o)return s.state.lastActivityAt=t,s.streakMaintained=!0,s;let c=this.getDaysBetween(r.lastActivityDate,o);if(c===1)return s.state.currentStreak=r.currentStreak+1,s.state.longestStreak=Math.max(s.state.currentStreak,r.longestStreak),s.state.lastActivityAt=t,s.state.lastActivityDate=o,s.streakMaintained=!0,s;s.daysMissed=c-1;let A=s.daysMissed;if(A<=r.freezesRemaining)return s.state.freezesRemaining=r.freezesRemaining-A,s.state.freezeUsedAt=t,s.state.currentStreak=r.currentStreak+1,s.state.longestStreak=Math.max(s.state.currentStreak,r.longestStreak),s.state.lastActivityAt=t,s.state.lastActivityDate=o,s.freezeUsed=!0,s.streakMaintained=!0,s;return s.streakLost=!0,s.state.currentStreak=1,s.state.lastActivityAt=t,s.state.lastActivityDate=o,s.newStreak=!0,s}checkStatus(r,t=new Date){if(!r.lastActivityDate)return{isActive:!1,willExpireAt:null,canUseFreeze:!1,daysUntilExpiry:0};let o=this.getDateString(t),s=this.getDaysBetween(r.lastActivityDate,o);if(s===0){let A=this.addDays(t,1);return A.setHours(23,59,59,999),{isActive:!0,willExpireAt:A,canUseFreeze:r.freezesRemaining>0,daysUntilExpiry:1}}if(s===1){let A=new Date(t);return A.setHours(23+this.config.gracePeriodHours,59,59,999),{isActive:!0,willExpireAt:A,canUseFreeze:r.freezesRemaining>0,daysUntilExpiry:0}}let c=s-1;return{isActive:c<=r.freezesRemaining,willExpireAt:null,canUseFreeze:c<=r.freezesRemaining,daysUntilExpiry:-c}}useFreeze(r,t=new Date){if(r.freezesRemaining<=0)return null;return{...r,freezesRemaining:r.freezesRemaining-1,freezeUsedAt:t}}awardMonthlyFreezes(r){return{...r,freezesRemaining:Math.min(r.freezesRemaining+this.config.freezesPerMonth,this.config.maxFreezes)}}getInitialState(){return{currentStreak:0,longestStreak:0,lastActivityAt:null,lastActivityDate:null,freezesRemaining:this.config.freezesPerMonth,freezeUsedAt:null}}getMilestones(r){let t=[3,7,14,30,60,90,180,365,500,1000],o=t.filter((c)=>r>=c),s=t.find((c)=>r<c)??null;return{achieved:o,next:s}}getDateString(r){let t=r.getFullYear(),o=String(r.getMonth()+1).padStart(2,"0"),s=String(r.getDate()).padStart(2,"0");return`${t}-${o}-${s}`}getDaysBetween(r,t){let o=new Date(r),c=new Date(t).getTime()-o.getTime();return Math.floor(c/86400000)}addDays(r,t){return new Date(r.getTime()+t*24*60*60*1000)}}var Zo=new U;import{defineTranslation as Ct}from"@contractspec/lib.contracts-spec/translations";var Br=Ct({meta:{key:"learning-journey.messages",version:"1.0.0",domain:"learning-journey",description:"XP source labels for the learning-journey module",owners:["platform"],stability:"experimental"},locale:"en",fallback:"en",messages:{"xp.source.base":{value:"Base",description:"XP breakdown label for base XP"},"xp.source.scoreBonus":{value:"Score Bonus",description:"XP breakdown label for score-based bonus"},"xp.source.perfectScore":{value:"Perfect Score",description:"XP breakdown label for perfect score bonus"},"xp.source.firstAttempt":{value:"First Attempt",description:"XP breakdown label for first attempt bonus"},"xp.source.retryPenalty":{value:"Retry Penalty",description:"XP breakdown label for retry penalty"},"xp.source.streakBonus":{value:"Streak Bonus",description:"XP breakdown label for streak bonus"}}});import{defineTranslation as yt}from"@contractspec/lib.contracts-spec/translations";var jr=yt({meta:{key:"learning-journey.messages",version:"1.0.0",domain:"learning-journey",description:"XP source labels (Spanish)",owners:["platform"],stability:"experimental"},locale:"es",fallback:"en",messages:{"xp.source.base":{value:"Base",description:"XP breakdown label for base XP"},"xp.source.scoreBonus":{value:"Bonificaci\xF3n por puntuaci\xF3n",description:"XP breakdown label for score-based bonus"},"xp.source.perfectScore":{value:"Puntuaci\xF3n perfecta",description:"XP breakdown label for perfect score bonus"},"xp.source.firstAttempt":{value:"Primer intento",description:"XP breakdown label for first attempt bonus"},"xp.source.retryPenalty":{value:"Penalizaci\xF3n por reintento",description:"XP breakdown label for retry penalty"},"xp.source.streakBonus":{value:"Bonificaci\xF3n por racha",description:"XP breakdown label for streak bonus"}}});import{defineTranslation as _t}from"@contractspec/lib.contracts-spec/translations";var ir=_t({meta:{key:"learning-journey.messages",version:"1.0.0",domain:"learning-journey",description:"XP source labels (French)",owners:["platform"],stability:"experimental"},locale:"fr",fallback:"en",messages:{"xp.source.base":{value:"Base",description:"XP breakdown label for base XP"},"xp.source.scoreBonus":{value:"Bonus de score",description:"XP breakdown label for score-based bonus"},"xp.source.perfectScore":{value:"Score parfait",description:"XP breakdown label for perfect score bonus"},"xp.source.firstAttempt":{value:"Premier essai",description:"XP breakdown label for first attempt bonus"},"xp.source.retryPenalty":{value:"P\xE9nalit\xE9 de r\xE9essai",description:"XP breakdown label for retry penalty"},"xp.source.streakBonus":{value:"Bonus de s\xE9rie",description:"XP breakdown label for streak bonus"}}});import{createI18nFactory as qt}from"@contractspec/lib.contracts-spec/translations";var tr=qt({specKey:"learning-journey.messages",catalogs:[Br,ir,jr]}),Kr=tr.create,Yo=tr.getDefault,Go=tr.resetRegistry;var w={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,journey_step:5,journey_complete:50},scoreThresholds:[{min:90,multiplier:1.5},{min:80,multiplier:1.25},{min:70,multiplier:1},{min:60,multiplier:0.75},{min:0,multiplier:0.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:0.5,speedBonusMultiplier:1.2,speedBonusThreshold:0.8};class v{config;constructor(r={}){this.config={...w,...r,baseValues:{...w.baseValues,...r.baseValues},scoreThresholds:r.scoreThresholds||w.scoreThresholds,streakTiers:r.streakTiers||w.streakTiers}}calculate(r){let t=[],o=r.baseXp??this.config.baseValues[r.activity],s=o;if(t.push({source:"base",amount:o}),r.score!==void 0){let c=this.getScoreMultiplier(r.score);if(c!==1){let A=Math.round(o*(c-1));s+=A,t.push({source:"score_bonus",amount:A,multiplier:c})}if(r.score===100){let A=Math.round(o*(this.config.perfectScoreMultiplier-1));s+=A,t.push({source:"perfect_score",amount:A,multiplier:this.config.perfectScoreMultiplier})}}if(r.attemptNumber===1&&!r.isRetry)s+=this.config.firstAttemptBonus,t.push({source:"first_attempt",amount:this.config.firstAttemptBonus});if(r.isRetry){let c=Math.round(s*(1-this.config.retryPenalty));s-=c,t.push({source:"retry_penalty",amount:-c,multiplier:this.config.retryPenalty})}if(r.currentStreak&&r.currentStreak>0){let c=this.getStreakBonus(r.currentStreak);if(c>0)s+=c,t.push({source:"streak_bonus",amount:c})}if(o>0)s=Math.max(1,s);return{totalXp:Math.round(s),baseXp:o,breakdown:t}}calculateStreakBonus(r){let t=this.getStreakBonus(r);return{totalXp:t,baseXp:t,breakdown:[{source:"streak_bonus",amount:t}]}}getXpForLevel(r){if(r<=1)return 0;return Math.round(100*Math.pow(r-1,1.5))}getLevelFromXp(r){let t=1,o=this.getXpForLevel(t+1);while(r>=o&&t<1000)t++,o=this.getXpForLevel(t+1);let s=this.getXpForLevel(t),c=this.getXpForLevel(t+1);return{level:t,xpInLevel:r-s,xpForNextLevel:c-s}}getScoreMultiplier(r){for(let t of this.config.scoreThresholds)if(r>=t.min)return t.multiplier;return 1}getStreakBonus(r){for(let t of this.config.streakTiers)if(r>=t.days)return t.bonus;return 0}}var Ht={base:"xp.source.base",score_bonus:"xp.source.scoreBonus",perfect_score:"xp.source.perfectScore",first_attempt:"xp.source.firstAttempt",retry_penalty:"xp.source.retryPenalty",streak_bonus:"xp.source.streakBonus"};function No(r,t){let o=Kr(t),s=Ht[r];return s?o.t(s):r}var To=new v;import{defineEntity as z,defineEntityEnum as Cr,field as e,index as H}from"@contractspec/lib.schema";var yr=Cr({name:"LearningStyle",values:["VISUAL","AUDITORY","READING","KINESTHETIC","MIXED"],schema:"lssm_learning",description:"Preferred learning style."}),_r=Cr({name:"RecommendationType",values:["COURSE","LESSON","REVIEW","PRACTICE","ASSESSMENT","DECK"],schema:"lssm_learning",description:"Type of learning recommendation."}),xt=z({name:"LearnerProfile",description:"AI personalization profile for a learner.",schema:"lssm_learning",map:"learner_profile",fields:{id:e.id({description:"Unique profile identifier"}),learnerId:e.foreignKey({description:"Learner"}),learningStyle:e.enum("LearningStyle",{default:"MIXED",description:"Preferred learning style"}),preferredDifficulty:e.string({default:'"adaptive"',description:"Difficulty preference"}),preferredSessionLength:e.int({default:30,description:"Preferred session length in minutes"}),interests:e.json({isOptional:!0,description:"Topic interests"}),goals:e.json({isOptional:!0,description:"Learning goals"}),pacePreference:e.string({default:'"normal"',description:"Learning pace: slow, normal, fast"}),bestTimeOfDay:e.string({isOptional:!0,description:"Best time for learning"}),averageSessionLength:e.int({isOptional:!0,description:"Average session length"}),daysActivePerWeek:e.int({isOptional:!0,description:"Days active per week"}),avgQuizScore:e.int({isOptional:!0,description:"Average quiz score"}),avgLessonCompletionTime:e.int({isOptional:!0,description:"Avg lesson completion time"}),strengths:e.json({isOptional:!0,description:"Identified strengths"}),weaknesses:e.json({isOptional:!0,description:"Areas for improvement"}),lastAnalyzedAt:e.dateTime({isOptional:!0,description:"Last AI analysis"}),metadata:e.json({isOptional:!0,description:"Additional metadata"}),createdAt:e.createdAt(),updatedAt:e.updatedAt(),learner:e.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[H.unique(["learnerId"],{name:"learner_profile_unique"}),H.on(["learningStyle"])],enums:[yr]}),Vt=z({name:"SkillMap",description:"Maps learner proficiency across skills.",schema:"lssm_learning",map:"skill_map",fields:{id:e.id({description:"Unique skill map identifier"}),learnerId:e.foreignKey({description:"Learner"}),skillId:e.string({description:"Skill identifier"}),skillName:e.string({description:"Skill name"}),skillCategory:e.string({isOptional:!0,description:"Skill category"}),level:e.int({default:0,description:"Proficiency level (0-100)"}),confidence:e.decimal({default:0.5,description:"Confidence in assessment"}),lessonsCompleted:e.int({default:0,description:"Related lessons completed"}),quizzesCompleted:e.int({default:0,description:"Related quizzes completed"}),practiceTime:e.int({default:0,description:"Practice time in minutes"}),lastPracticedAt:e.dateTime({isOptional:!0,description:"Last practice time"}),learningVelocity:e.decimal({isOptional:!0,description:"Learning speed for this skill"}),predictedTimeToMastery:e.int({isOptional:!0,description:"Predicted time to mastery (minutes)"}),createdAt:e.createdAt(),updatedAt:e.updatedAt(),learner:e.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[H.unique(["learnerId","skillId"],{name:"skill_map_unique"}),H.on(["skillId","level"]),H.on(["learnerId","level"])]}),Lt=z({name:"LearningPath",description:"AI-generated personalized learning path.",schema:"lssm_learning",map:"learning_path",fields:{id:e.id({description:"Unique path identifier"}),learnerId:e.foreignKey({description:"Learner"}),name:e.string({description:"Path name"}),description:e.string({isOptional:!0,description:"Path description"}),goal:e.string({isOptional:!0,description:"Path goal"}),steps:e.json({description:"Ordered list of learning steps"}),currentStepIndex:e.int({default:0,description:"Current step index"}),progress:e.int({default:0,description:"Completion percentage"}),completedSteps:e.int({default:0,description:"Steps completed"}),totalSteps:e.int({default:0,description:"Total steps"}),generatedAt:e.dateTime({description:"When path was generated"}),adaptedFrom:e.string({isOptional:!0,description:"Original path ID if adapted"}),generationParams:e.json({isOptional:!0,description:"AI generation parameters"}),adaptationHistory:e.json({isOptional:!0,description:"Path adaptation history"}),isActive:e.boolean({default:!0,description:"Whether path is active"}),isCompleted:e.boolean({default:!1,description:"Whether path is completed"}),startedAt:e.dateTime({isOptional:!0,description:"When started"}),completedAt:e.dateTime({isOptional:!0,description:"When completed"}),estimatedCompletionDate:e.dateTime({isOptional:!0,description:"Estimated completion"}),createdAt:e.createdAt(),updatedAt:e.updatedAt(),learner:e.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[H.on(["learnerId","isActive"]),H.on(["generatedAt"])]}),Zt=z({name:"Recommendation",description:"AI-powered learning recommendation.",schema:"lssm_learning",map:"recommendation",fields:{id:e.id({description:"Unique recommendation identifier"}),learnerId:e.foreignKey({description:"Learner"}),type:e.enum("RecommendationType",{description:"Recommendation type"}),itemId:e.string({description:"Recommended item ID"}),itemType:e.string({description:"Item type (course, lesson, deck, etc.)"}),score:e.decimal({description:"Recommendation score (0-1)"}),confidence:e.decimal({description:"Confidence in recommendation"}),reason:e.string({description:"Human-readable reason"}),factors:e.json({isOptional:!0,description:"Factors that contributed to recommendation"}),status:e.string({default:'"pending"',description:"Status: pending, viewed, accepted, dismissed"}),viewedAt:e.dateTime({isOptional:!0,description:"When viewed"}),acceptedAt:e.dateTime({isOptional:!0,description:"When accepted"}),dismissedAt:e.dateTime({isOptional:!0,description:"When dismissed"}),feedback:e.string({isOptional:!0,description:"User feedback"}),feedbackRating:e.int({isOptional:!0,description:"Feedback rating (1-5)"}),expiresAt:e.dateTime({isOptional:!0,description:"When recommendation expires"}),createdAt:e.createdAt(),updatedAt:e.updatedAt(),learner:e.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[H.on(["learnerId","status","score"]),H.on(["type","status"]),H.on(["expiresAt"])],enums:[_r]}),$t=z({name:"LearningGap",description:"Identified learning gap.",schema:"lssm_learning",map:"learning_gap",fields:{id:e.id({description:"Unique gap identifier"}),learnerId:e.foreignKey({description:"Learner"}),skillId:e.string({description:"Skill with gap"}),skillName:e.string({description:"Skill name"}),severity:e.string({default:'"moderate"',description:"Gap severity: minor, moderate, major"}),confidence:e.decimal({description:"Confidence in gap detection"}),evidence:e.json({isOptional:!0,description:"Evidence for gap"}),relatedQuestions:e.json({isOptional:!0,description:"Questions that revealed gap"}),suggestedRemediation:e.json({isOptional:!0,description:"Suggested remediation"}),remediationProgress:e.int({default:0,description:"Remediation progress"}),status:e.string({default:'"open"',description:"Status: open, in_progress, resolved"}),resolvedAt:e.dateTime({isOptional:!0,description:"When resolved"}),detectedAt:e.dateTime({description:"When gap was detected"}),createdAt:e.createdAt(),updatedAt:e.updatedAt(),learner:e.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[H.on(["learnerId","status"]),H.on(["skillId","status"]),H.on(["severity","status"])]}),qr=[xt,Vt,Lt,Zt,$t],Hr=[yr,_r];import{defineEntity as Y,defineEntityEnum as G,field as b,index as Z}from"@contractspec/lib.schema";var xr=G({name:"CourseDifficulty",values:["BEGINNER","INTERMEDIATE","ADVANCED","EXPERT"],schema:"lssm_learning",description:"Difficulty level of a course."}),Vr=G({name:"CourseStatus",values:["DRAFT","PUBLISHED","ARCHIVED"],schema:"lssm_learning",description:"Publication status of a course."}),Lr=G({name:"LessonType",values:["CONTENT","VIDEO","INTERACTIVE","QUIZ","PRACTICE","PROJECT"],schema:"lssm_learning",description:"Type of lesson content."}),Zr=G({name:"ContentType",values:["MARKDOWN","VIDEO","AUDIO","EMBED","SCORM","CUSTOM"],schema:"lssm_learning",description:"Type of lesson content format."}),Mt=Y({name:"Course",description:"A structured learning course.",schema:"lssm_learning",map:"course",fields:{id:b.id({description:"Unique course identifier"}),title:b.string({description:"Course title"}),slug:b.string({isUnique:!0,description:"URL-friendly slug"}),description:b.string({isOptional:!0,description:"Course description"}),summary:b.string({isOptional:!0,description:"Short summary"}),difficulty:b.enum("CourseDifficulty",{default:"BEGINNER",description:"Difficulty level"}),category:b.string({isOptional:!0,description:"Course category"}),tags:b.json({isOptional:!0,description:"Tags for discovery"}),prerequisites:b.json({isOptional:!0,description:"Required course IDs"}),requiredSkills:b.json({isOptional:!0,description:"Required skill levels"}),estimatedDuration:b.int({isOptional:!0,description:"Estimated duration in minutes"}),thumbnailUrl:b.string({isOptional:!0,description:"Thumbnail image URL"}),coverImageUrl:b.string({isOptional:!0,description:"Cover image URL"}),promoVideoUrl:b.string({isOptional:!0,description:"Promo video URL"}),status:b.enum("CourseStatus",{default:"DRAFT",description:"Publication status"}),publishedAt:b.dateTime({isOptional:!0,description:"When published"}),authorId:b.string({description:"Author user ID"}),orgId:b.string({isOptional:!0,description:"Organization scope"}),isPublic:b.boolean({default:!1,description:"Whether course is publicly accessible"}),isFeatured:b.boolean({default:!1,description:"Whether course is featured"}),certificateEnabled:b.boolean({default:!1,description:"Award certificate on completion"}),metadata:b.json({isOptional:!0,description:"Additional metadata"}),createdAt:b.createdAt(),updatedAt:b.updatedAt(),modules:b.hasMany("CourseModule"),enrollments:b.hasMany("Enrollment")},indexes:[Z.on(["orgId","status"]),Z.on(["category"]),Z.on(["difficulty"]),Z.on(["authorId"])],enums:[xr,Vr]}),Wt=Y({name:"CourseModule",description:"A module (section) within a course.",schema:"lssm_learning",map:"course_module",fields:{id:b.id({description:"Unique module identifier"}),courseId:b.foreignKey({description:"Parent course"}),title:b.string({description:"Module title"}),description:b.string({isOptional:!0,description:"Module description"}),order:b.int({default:0,description:"Display order"}),unlockCondition:b.json({isOptional:!0,description:"Conditions to unlock module"}),prerequisiteModuleIds:b.json({isOptional:!0,description:"Required modules to complete first"}),estimatedDuration:b.int({isOptional:!0,description:"Estimated duration in minutes"}),createdAt:b.createdAt(),updatedAt:b.updatedAt(),course:b.belongsTo("Course",["courseId"],["id"],{onDelete:"Cascade"}),lessons:b.hasMany("Lesson"),completions:b.hasMany("ModuleCompletion")},indexes:[Z.on(["courseId","order"])]}),mt=Y({name:"Lesson",description:"An individual lesson within a module.",schema:"lssm_learning",map:"lesson",fields:{id:b.id({description:"Unique lesson identifier"}),moduleId:b.foreignKey({description:"Parent module"}),title:b.string({description:"Lesson title"}),description:b.string({isOptional:!0,description:"Lesson description"}),type:b.enum("LessonType",{default:"CONTENT",description:"Lesson type"}),order:b.int({default:0,description:"Display order"}),estimatedDuration:b.int({isOptional:!0,description:"Estimated duration in minutes"}),xpReward:b.int({default:10,description:"XP awarded on completion"}),isFree:b.boolean({default:!1,description:"Whether lesson is free preview"}),isRequired:b.boolean({default:!0,description:"Whether lesson is required for completion"}),metadata:b.json({isOptional:!0,description:"Additional metadata"}),createdAt:b.createdAt(),updatedAt:b.updatedAt(),module:b.belongsTo("CourseModule",["moduleId"],["id"],{onDelete:"Cascade"}),contents:b.hasMany("LessonContent"),progress:b.hasMany("LessonProgress"),quizzes:b.hasMany("Quiz")},indexes:[Z.on(["moduleId","order"]),Z.on(["type"])],enums:[Lr]}),Xt=Y({name:"LessonContent",description:"Content block within a lesson.",schema:"lssm_learning",map:"lesson_content",fields:{id:b.id({description:"Unique content identifier"}),lessonId:b.foreignKey({description:"Parent lesson"}),contentType:b.enum("ContentType",{description:"Content format"}),content:b.string({isOptional:!0,description:"Text content (markdown, etc.)"}),mediaUrl:b.string({isOptional:!0,description:"Media URL for video/audio"}),embedData:b.json({isOptional:!0,description:"Embed data for external content"}),order:b.int({default:0,description:"Display order"}),duration:b.int({isOptional:!0,description:"Content duration in seconds"}),metadata:b.json({isOptional:!0,description:"Additional metadata"}),createdAt:b.createdAt(),updatedAt:b.updatedAt(),lesson:b.belongsTo("Lesson",["lessonId"],["id"],{onDelete:"Cascade"})},indexes:[Z.on(["lessonId","order"])],enums:[Zr]}),$r=[Mt,Wt,mt,Xt],Mr=[xr,Vr,Lr,Zr];import{defineEntity as S,defineEntityEnum as zt,field as a,index as V}from"@contractspec/lib.schema";var Wr=zt({name:"CardRating",values:["AGAIN","HARD","GOOD","EASY"],schema:"lssm_learning",description:"Rating for a flashcard review."}),Ft=S({name:"Deck",description:"A collection of flashcards.",schema:"lssm_learning",map:"deck",fields:{id:a.id({description:"Unique deck identifier"}),ownerId:a.foreignKey({description:"Deck owner (learner)"}),title:a.string({description:"Deck title"}),description:a.string({isOptional:!0,description:"Deck description"}),category:a.string({isOptional:!0,description:"Deck category"}),tags:a.json({isOptional:!0,description:"Tags for discovery"}),isPublic:a.boolean({default:!1,description:"Whether deck is publicly visible"}),cardCount:a.int({default:0,description:"Number of cards"}),coverImageUrl:a.string({isOptional:!0,description:"Cover image URL"}),orgId:a.string({isOptional:!0,description:"Organization scope"}),newCardsPerDay:a.int({default:20,description:"New cards to introduce per day"}),reviewsPerDay:a.int({default:100,description:"Maximum reviews per day"}),metadata:a.json({isOptional:!0,description:"Additional metadata"}),createdAt:a.createdAt(),updatedAt:a.updatedAt(),owner:a.belongsTo("Learner",["ownerId"],["id"],{onDelete:"Cascade"}),cards:a.hasMany("Card")},indexes:[V.on(["ownerId"]),V.on(["isPublic","category"]),V.on(["orgId"])]}),Qt=S({name:"Card",description:"An individual flashcard.",schema:"lssm_learning",map:"card",fields:{id:a.id({description:"Unique card identifier"}),deckId:a.foreignKey({description:"Parent deck"}),front:a.string({description:"Front of card (question)"}),back:a.string({description:"Back of card (answer)"}),hints:a.json({isOptional:!0,description:"Hints for the card"}),explanation:a.string({isOptional:!0,description:"Detailed explanation"}),frontMediaUrl:a.string({isOptional:!0,description:"Media for front"}),backMediaUrl:a.string({isOptional:!0,description:"Media for back"}),audioUrl:a.string({isOptional:!0,description:"Audio pronunciation"}),tags:a.json({isOptional:!0,description:"Card tags"}),difficulty:a.int({default:0,description:"Card difficulty (0-5)"}),order:a.int({default:0,description:"Card order in deck"}),isSuspended:a.boolean({default:!1,description:"Whether card is suspended"}),metadata:a.json({isOptional:!0,description:"Additional metadata"}),createdAt:a.createdAt(),updatedAt:a.updatedAt(),deck:a.belongsTo("Deck",["deckId"],["id"],{onDelete:"Cascade"}),reviews:a.hasMany("CardReview"),schedules:a.hasMany("CardSchedule")},indexes:[V.on(["deckId","order"]),V.on(["isSuspended"])]}),Ut=S({name:"CardReview",description:"A single review of a flashcard.",schema:"lssm_learning",map:"card_review",fields:{id:a.id({description:"Unique review identifier"}),learnerId:a.foreignKey({description:"Reviewer"}),cardId:a.foreignKey({description:"Reviewed card"}),rating:a.enum("CardRating",{description:"Review rating"}),responseTimeMs:a.int({isOptional:!0,description:"Time to respond in ms"}),intervalBefore:a.int({description:"Interval before review (days)"}),easeFactorBefore:a.decimal({description:"Ease factor before review"}),intervalAfter:a.int({description:"Interval after review (days)"}),easeFactorAfter:a.decimal({description:"Ease factor after review"}),reviewType:a.string({default:'"review"',description:"Type: new, learning, review, relearning"}),reviewedAt:a.dateTime({description:"When reviewed"}),createdAt:a.createdAt(),learner:a.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),card:a.belongsTo("Card",["cardId"],["id"],{onDelete:"Cascade"})},indexes:[V.on(["learnerId","reviewedAt"]),V.on(["cardId","reviewedAt"]),V.on(["rating"])],enums:[Wr]}),wt=S({name:"CardSchedule",description:"SRS schedule for a learner/card pair.",schema:"lssm_learning",map:"card_schedule",fields:{id:a.id({description:"Unique schedule identifier"}),learnerId:a.foreignKey({description:"Learner"}),cardId:a.foreignKey({description:"Card"}),interval:a.int({default:0,description:"Current interval in days"}),easeFactor:a.decimal({default:2.5,description:"Ease factor (SM-2)"}),repetitions:a.int({default:0,description:"Number of successful repetitions"}),nextReviewAt:a.dateTime({description:"When next review is due"}),lastReviewAt:a.dateTime({isOptional:!0,description:"When last reviewed"}),learningStep:a.int({default:0,description:"Current learning step"}),isGraduated:a.boolean({default:!1,description:"Whether card has graduated"}),isRelearning:a.boolean({default:!1,description:"Whether card is being relearned"}),lapses:a.int({default:0,description:"Number of times card was forgotten"}),reviewCount:a.int({default:0,description:"Total review count"}),createdAt:a.createdAt(),updatedAt:a.updatedAt(),learner:a.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),card:a.belongsTo("Card",["cardId"],["id"],{onDelete:"Cascade"})},indexes:[V.unique(["learnerId","cardId"],{name:"card_schedule_unique"}),V.on(["learnerId","nextReviewAt"]),V.on(["nextReviewAt"])]}),mr=[Ft,Qt,Ut,wt],Xr=[Wr];import{defineEntity as W,defineEntityEnum as zr,field as n,index as i}from"@contractspec/lib.schema";var Fr=zr({name:"AchievementType",values:["MILESTONE","STREAK","SKILL","SOCIAL","SPECIAL","SEASONAL"],schema:"lssm_learning",description:"Type of achievement."}),Qr=zr({name:"LeaderboardPeriod",values:["DAILY","WEEKLY","MONTHLY","ALL_TIME"],schema:"lssm_learning",description:"Leaderboard time period."}),vt=W({name:"Achievement",description:"An achievement that can be unlocked.",schema:"lssm_learning",map:"achievement",fields:{id:n.id({description:"Unique achievement identifier"}),key:n.string({isUnique:!0,description:"Achievement key"}),name:n.string({description:"Achievement name"}),description:n.string({description:"Achievement description"}),icon:n.string({isOptional:!0,description:"Icon name or URL"}),color:n.string({isOptional:!0,description:"Display color"}),badgeUrl:n.string({isOptional:!0,description:"Badge image URL"}),type:n.enum("AchievementType",{default:"MILESTONE",description:"Achievement type"}),category:n.string({isOptional:!0,description:"Achievement category"}),rarity:n.string({default:'"common"',description:"Rarity: common, rare, epic, legendary"}),xpReward:n.int({default:50,description:"XP awarded"}),condition:n.json({description:"Unlock condition"}),order:n.int({default:0,description:"Display order"}),isHidden:n.boolean({default:!1,description:"Hide until unlocked"}),isActive:n.boolean({default:!0,description:"Whether achievement is active"}),orgId:n.string({isOptional:!0,description:"Organization scope"}),metadata:n.json({isOptional:!0,description:"Additional metadata"}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),learnerAchievements:n.hasMany("LearnerAchievement")},indexes:[i.on(["type"]),i.on(["category"]),i.on(["isActive"]),i.on(["orgId"])],enums:[Fr]}),Yt=W({name:"LearnerAchievement",description:"An achievement unlocked by a learner.",schema:"lssm_learning",map:"learner_achievement",fields:{id:n.id({description:"Unique record identifier"}),learnerId:n.foreignKey({description:"Learner"}),achievementId:n.foreignKey({description:"Achievement"}),xpEarned:n.int({default:0,description:"XP earned"}),progress:n.int({default:100,description:"Progress percentage"}),currentValue:n.int({isOptional:!0,description:"Current value towards goal"}),targetValue:n.int({isOptional:!0,description:"Target value for completion"}),unlockedAt:n.dateTime({description:"When unlocked"}),createdAt:n.createdAt(),learner:n.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),achievement:n.belongsTo("Achievement",["achievementId"],["id"],{onDelete:"Cascade"})},indexes:[i.unique(["learnerId","achievementId"],{name:"learner_achievement_unique"}),i.on(["learnerId","unlockedAt"]),i.on(["achievementId"])]}),Gt=W({name:"Streak",description:"Tracks daily learning streaks.",schema:"lssm_learning",map:"streak",fields:{id:n.id({description:"Unique streak identifier"}),learnerId:n.foreignKey({description:"Learner"}),currentStreak:n.int({default:0,description:"Current streak days"}),longestStreak:n.int({default:0,description:"Longest streak ever"}),lastActivityAt:n.dateTime({isOptional:!0,description:"Last learning activity"}),lastActivityDate:n.string({isOptional:!0,description:"Last activity date (YYYY-MM-DD)"}),freezesRemaining:n.int({default:0,description:"Streak freezes available"}),freezeUsedAt:n.dateTime({isOptional:!0,description:"When last freeze was used"}),streakHistory:n.json({isOptional:!0,description:"Historical streak data"}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),learner:n.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[i.unique(["learnerId"],{name:"streak_learner_unique"}),i.on(["currentStreak"]),i.on(["longestStreak"])]}),St=W({name:"DailyGoal",description:"Daily XP goal tracking.",schema:"lssm_learning",map:"daily_goal",fields:{id:n.id({description:"Unique goal identifier"}),learnerId:n.foreignKey({description:"Learner"}),date:n.string({description:"Date (YYYY-MM-DD)"}),targetXp:n.int({description:"Target XP for the day"}),currentXp:n.int({default:0,description:"XP earned today"}),isCompleted:n.boolean({default:!1,description:"Whether goal was met"}),completedAt:n.dateTime({isOptional:!0,description:"When goal was completed"}),xpBreakdown:n.json({isOptional:!0,description:"XP sources breakdown"}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),learner:n.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[i.unique(["learnerId","date"],{name:"daily_goal_unique"}),i.on(["date","isCompleted"])]}),Rt=W({name:"LeaderboardEntry",description:"Leaderboard entry for a learner.",schema:"lssm_learning",map:"leaderboard_entry",fields:{id:n.id({description:"Unique entry identifier"}),learnerId:n.foreignKey({description:"Learner"}),periodType:n.enum("LeaderboardPeriod",{description:"Period type"}),periodKey:n.string({description:"Period key (e.g., 2024-W01)"}),xp:n.int({default:0,description:"XP earned in period"}),rank:n.int({isOptional:!0,description:"Rank in leaderboard"}),lessonsCompleted:n.int({default:0,description:"Lessons completed"}),quizzesPassed:n.int({default:0,description:"Quizzes passed"}),cardsReviewed:n.int({default:0,description:"Cards reviewed"}),streakDays:n.int({default:0,description:"Streak days in period"}),league:n.string({isOptional:!0,description:"League tier"}),orgId:n.string({isOptional:!0,description:"Organization scope"}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),learner:n.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[i.unique(["learnerId","periodType","periodKey"],{name:"leaderboard_entry_unique"}),i.on(["periodType","periodKey","xp"]),i.on(["orgId","periodType","periodKey","xp"])],enums:[Qr]}),Nt=W({name:"Heart",description:"Lives/hearts system for quiz attempts.",schema:"lssm_learning",map:"heart",fields:{id:n.id({description:"Unique heart record identifier"}),learnerId:n.foreignKey({description:"Learner"}),current:n.int({default:5,description:"Current hearts"}),max:n.int({default:5,description:"Maximum hearts"}),lastRefillAt:n.dateTime({isOptional:!0,description:"Last refill time"}),nextRefillAt:n.dateTime({isOptional:!0,description:"Next refill time"}),refillIntervalMinutes:n.int({default:240,description:"Minutes between refills"}),infiniteUntil:n.dateTime({isOptional:!0,description:"Infinite hearts until"}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),learner:n.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[i.unique(["learnerId"],{name:"heart_learner_unique"}),i.on(["nextRefillAt"])]}),Tt=W({name:"XPTransaction",description:"Record of XP earned or spent.",schema:"lssm_learning",map:"xp_transaction",fields:{id:n.id({description:"Unique transaction identifier"}),learnerId:n.foreignKey({description:"Learner"}),amount:n.int({description:"XP amount (positive = earned, negative = spent)"}),type:n.string({description:"Transaction type (lesson, quiz, streak, achievement, etc.)"}),sourceType:n.string({isOptional:!0,description:"Source entity type"}),sourceId:n.string({isOptional:!0,description:"Source entity ID"}),description:n.string({isOptional:!0,description:"Human-readable description"}),balanceAfter:n.int({description:"Total XP after transaction"}),createdAt:n.createdAt(),learner:n.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[i.on(["learnerId","createdAt"]),i.on(["type"]),i.on(["sourceType","sourceId"])]}),Ur=[vt,Yt,Gt,St,Rt,Nt,Tt],wr=[Fr,Qr];import{defineEntity as F,defineEntityEnum as vr,field as p,index as _}from"@contractspec/lib.schema";var Yr=vr({name:"EnrollmentStatus",values:["ENROLLED","IN_PROGRESS","COMPLETED","DROPPED","EXPIRED"],schema:"lssm_learning",description:"Status of a course enrollment."}),Gr=vr({name:"ProgressStatus",values:["NOT_STARTED","IN_PROGRESS","COMPLETED","SKIPPED"],schema:"lssm_learning",description:"Status of lesson progress."}),dt=F({name:"Learner",description:"A learner profile.",schema:"lssm_learning",map:"learner",fields:{id:p.id({description:"Unique learner identifier"}),userId:p.string({isUnique:!0,description:"Associated user ID"}),displayName:p.string({isOptional:!0,description:"Display name"}),avatarUrl:p.string({isOptional:!0,description:"Avatar URL"}),bio:p.string({isOptional:!0,description:"Short bio"}),level:p.int({default:1,description:"Current level"}),totalXp:p.int({default:0,description:"Total XP earned"}),currentStreak:p.int({default:0,description:"Current streak days"}),longestStreak:p.int({default:0,description:"Longest streak ever"}),lastActivityAt:p.dateTime({isOptional:!0,description:"Last learning activity"}),locale:p.string({isOptional:!0,description:'Preferred locale for learning content (e.g. "en", "fr", "es")'}),timezone:p.string({default:'"UTC"',description:"Learner timezone"}),dailyGoalXp:p.int({default:50,description:"Daily XP goal"}),reminderEnabled:p.boolean({default:!0,description:"Enable reminders"}),reminderTime:p.string({isOptional:!0,description:"Preferred reminder time"}),orgId:p.string({isOptional:!0,description:"Organization scope"}),metadata:p.json({isOptional:!0,description:"Additional metadata"}),createdAt:p.createdAt(),updatedAt:p.updatedAt(),enrollments:p.hasMany("Enrollment"),lessonProgress:p.hasMany("LessonProgress"),achievements:p.hasMany("LearnerAchievement"),decks:p.hasMany("Deck"),profile:p.hasOne("LearnerProfile")},indexes:[_.on(["orgId"]),_.on(["totalXp"]),_.on(["level"]),_.on(["currentStreak"])]}),Et=F({name:"Enrollment",description:"A learner enrollment in a course.",schema:"lssm_learning",map:"enrollment",fields:{id:p.id({description:"Unique enrollment identifier"}),learnerId:p.foreignKey({description:"Enrolled learner"}),courseId:p.foreignKey({description:"Enrolled course"}),status:p.enum("EnrollmentStatus",{default:"ENROLLED",description:"Enrollment status"}),progress:p.int({default:0,description:"Completion percentage (0-100)"}),completedLessons:p.int({default:0,description:"Number of completed lessons"}),totalLessons:p.int({default:0,description:"Total lessons in course"}),xpEarned:p.int({default:0,description:"XP earned in this course"}),startedAt:p.dateTime({isOptional:!0,description:"When learner started"}),completedAt:p.dateTime({isOptional:!0,description:"When learner completed"}),lastAccessedAt:p.dateTime({isOptional:!0,description:"Last access time"}),certificateId:p.string({isOptional:!0,description:"Issued certificate ID"}),metadata:p.json({isOptional:!0,description:"Additional metadata"}),createdAt:p.createdAt(),updatedAt:p.updatedAt(),learner:p.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),course:p.belongsTo("Course",["courseId"],["id"],{onDelete:"Cascade"})},indexes:[_.unique(["learnerId","courseId"],{name:"enrollment_unique"}),_.on(["learnerId","status"]),_.on(["courseId","status"])],enums:[Yr]}),ft=F({name:"LessonProgress",description:"Progress tracking for a lesson.",schema:"lssm_learning",map:"lesson_progress",fields:{id:p.id({description:"Unique progress identifier"}),learnerId:p.foreignKey({description:"Learner"}),lessonId:p.foreignKey({description:"Lesson"}),status:p.enum("ProgressStatus",{default:"NOT_STARTED",description:"Progress status"}),progress:p.int({default:0,description:"Completion percentage (0-100)"}),score:p.int({isOptional:!0,description:"Score achieved (for quizzes)"}),attempts:p.int({default:0,description:"Number of attempts"}),bestScore:p.int({isOptional:!0,description:"Best score across attempts"}),timeSpent:p.int({default:0,description:"Time spent in seconds"}),xpEarned:p.int({default:0,description:"XP earned from this lesson"}),startedAt:p.dateTime({isOptional:!0,description:"When started"}),completedAt:p.dateTime({isOptional:!0,description:"When completed"}),lastAccessedAt:p.dateTime({isOptional:!0,description:"Last access time"}),bookmarks:p.json({isOptional:!0,description:"Content bookmarks"}),notes:p.string({isOptional:!0,description:"Learner notes"}),createdAt:p.createdAt(),updatedAt:p.updatedAt(),learner:p.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),lesson:p.belongsTo("Lesson",["lessonId"],["id"],{onDelete:"Cascade"})},indexes:[_.unique(["learnerId","lessonId"],{name:"lesson_progress_unique"}),_.on(["learnerId","status"]),_.on(["lessonId"])],enums:[Gr]}),lt=F({name:"ModuleCompletion",description:"Module completion record.",schema:"lssm_learning",map:"module_completion",fields:{id:p.id({description:"Unique completion identifier"}),learnerId:p.foreignKey({description:"Learner"}),moduleId:p.foreignKey({description:"Module"}),score:p.int({isOptional:!0,description:"Average score"}),xpEarned:p.int({default:0,description:"XP earned"}),timeSpent:p.int({default:0,description:"Time spent in seconds"}),completedAt:p.dateTime({description:"When completed"}),createdAt:p.createdAt(),learner:p.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),module:p.belongsTo("CourseModule",["moduleId"],["id"],{onDelete:"Cascade"})},indexes:[_.unique(["learnerId","moduleId"],{name:"module_completion_unique"}),_.on(["learnerId","completedAt"])]}),rs=F({name:"Certificate",description:"Course completion certificate.",schema:"lssm_learning",map:"certificate",fields:{id:p.id({description:"Unique certificate identifier"}),learnerId:p.foreignKey({description:"Certificate holder"}),courseId:p.foreignKey({description:"Completed course"}),enrollmentId:p.foreignKey({description:"Associated enrollment"}),certificateNumber:p.string({isUnique:!0,description:"Unique certificate number"}),title:p.string({description:"Certificate title"}),description:p.string({isOptional:!0,description:"Certificate description"}),score:p.int({isOptional:!0,description:"Final score"}),grade:p.string({isOptional:!0,description:"Grade awarded"}),issuedAt:p.dateTime({description:"When issued"}),validUntil:p.dateTime({isOptional:!0,description:"Expiration date"}),verificationUrl:p.string({isOptional:!0,description:"Verification URL"}),credentialHash:p.string({isOptional:!0,description:"Credential hash for verification"}),isRevoked:p.boolean({default:!1,description:"Whether certificate is revoked"}),revokedAt:p.dateTime({isOptional:!0,description:"When revoked"}),revokedReason:p.string({isOptional:!0,description:"Revocation reason"}),metadata:p.json({isOptional:!0,description:"Additional metadata"}),createdAt:p.createdAt(),learner:p.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),course:p.belongsTo("Course",["courseId"],["id"],{onDelete:"Cascade"})},indexes:[_.on(["learnerId"]),_.on(["courseId"]),_.on(["issuedAt"])]}),Sr=[dt,Et,ft,lt,rs],Rr=[Yr,Gr];import{defineEntity as R,defineEntityEnum as ts,field as J,index as $}from"@contractspec/lib.schema";var ss=ts({name:"JourneyStepStatus",values:["LOCKED","AVAILABLE","COMPLETED","MISSED","SKIPPED","BLOCKED"],schema:"lssm_learning",description:"Adaptive runtime status of a journey step."}),os=R({name:"JourneyTrack",description:"Adaptive journey track definition.",schema:"lssm_learning",map:"journey_track",fields:{id:J.id({description:"Unique track identifier"}),productId:J.string({isOptional:!0,description:"Product scope"}),name:J.string({description:"Track name"}),description:J.string({isOptional:!0,description:"Track description"}),targetUserSegment:J.string({isOptional:!0,description:"Target learner segment"}),targetRole:J.string({isOptional:!0,description:"Target learner role"}),isActive:J.boolean({default:!0,description:"Whether the track is active"}),isRequired:J.boolean({default:!1,description:"Whether the track must be completed"}),canSkip:J.boolean({default:!1,description:"Whether steps can be skipped"}),totalXp:J.int({default:0,description:"Declared XP ceiling for the track"}),streakRule:J.json({isOptional:!0,description:"Tempo rule used for streak-based rewards"}),completionRewards:J.json({isOptional:!0,description:"Reward applied when the track is completed"}),metadata:J.json({isOptional:!0,description:"Additional track metadata"}),createdAt:J.createdAt(),updatedAt:J.updatedAt(),steps:J.hasMany("JourneyStep"),progress:J.hasMany("JourneyProgress")},indexes:[$.on(["productId","isActive"]),$.unique(["productId","targetUserSegment","targetRole"],{name:"journey_track_target"})]}),es=R({name:"JourneyStep",description:"Adaptive journey step definition.",schema:"lssm_learning",map:"journey_step",fields:{id:J.id({description:"Unique step identifier"}),trackId:J.foreignKey({description:"Parent journey track"}),title:J.string({description:"Step title"}),description:J.string({isOptional:!0,description:"Step description"}),instructions:J.string({isOptional:!0,description:"How the learner should complete the step"}),helpUrl:J.string({isOptional:!0,description:"Help or destination URL"}),order:J.int({default:0,description:"Display order"}),completion:J.json({description:"Structured completion condition for this step"}),availability:J.json({isOptional:!0,description:"Unlock and due-window configuration"}),prerequisites:J.json({isOptional:!0,description:"Prerequisites that must be satisfied to unlock the step"}),prerequisiteMode:J.string({isOptional:!0,description:"How to combine prerequisites (all|any)"}),branches:J.json({isOptional:!0,description:"Branch outcomes evaluated when the step completes"}),reward:J.json({isOptional:!0,description:"Reward granted by this step"}),xpReward:J.int({isOptional:!0,description:"Legacy XP reward field"}),isRequired:J.boolean({default:!0,description:"Whether the step is required"}),canSkip:J.boolean({default:!1,description:"Whether the step can be skipped"}),actionUrl:J.string({isOptional:!0,description:"Manual completion action URL"}),actionLabel:J.string({isOptional:!0,description:"Manual action label"}),metadata:J.json({isOptional:!0,description:"Additional step metadata"}),createdAt:J.createdAt(),updatedAt:J.updatedAt(),track:J.belongsTo("JourneyTrack",["trackId"],["id"],{onDelete:"Cascade"})},indexes:[$.on(["trackId","order"])]}),ns=R({name:"JourneyProgress",description:"Persisted learner progress through an adaptive journey.",schema:"lssm_learning",map:"journey_progress",fields:{id:J.id({description:"Unique progress identifier"}),learnerId:J.foreignKey({description:"Learner owning this journey state"}),trackId:J.foreignKey({description:"Journey track"}),progressPercent:J.int({default:0,description:"Completion percentage"}),isCompleted:J.boolean({default:!1,description:"Whether the track is completed"}),nextStepId:J.string({isOptional:!0,description:"Next actionable step projected by the engine"}),xpEarned:J.int({default:0,description:"Total XP earned so far"}),badges:J.json({default:"[]",description:"Unlocked badge keys"}),streakState:J.json({default:"{}",description:"Serialized streak engine state"}),eventLog:J.json({default:"[]",description:"Recorded events used to evaluate adaptive progress"}),completionRewardApplied:J.boolean({default:!1,description:"Whether track completion rewards were already applied"}),startedAt:J.dateTime({isOptional:!0,description:"Track start timestamp"}),completedAt:J.dateTime({isOptional:!0,description:"Track completion timestamp"}),lastActivityAt:J.dateTime({isOptional:!0,description:"Latest event or manual advancement timestamp"}),createdAt:J.createdAt(),updatedAt:J.updatedAt(),learner:J.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),track:J.belongsTo("JourneyTrack",["trackId"],["id"],{onDelete:"Cascade"}),stepProgress:J.hasMany("JourneyStepProgress")},indexes:[$.unique(["learnerId","trackId"],{name:"journey_progress_unique"}),$.on(["learnerId","isCompleted"]),$.on(["trackId"])]}),ps=R({name:"JourneyStepProgress",description:"Persisted step-level state for an adaptive journey.",schema:"lssm_learning",map:"journey_step_progress",fields:{id:J.id({description:"Unique step-progress identifier"}),progressId:J.foreignKey({description:"Parent journey progress record"}),stepId:J.foreignKey({description:"Referenced journey step"}),status:J.enum("JourneyStepStatus",{description:"Current step status"}),selectedBranchKey:J.string({isOptional:!0,description:"Selected branch outcome for this step"}),xpEarned:J.int({default:0,description:"XP earned from this step"}),occurrences:J.int({default:0,description:"Matching event occurrences"}),masteryCount:J.int({default:0,description:"Accumulated mastery hits"}),availableAt:J.dateTime({isOptional:!0,description:"When the step unlocked"}),dueAt:J.dateTime({isOptional:!0,description:"When the step expires"}),completedAt:J.dateTime({isOptional:!0,description:"When the step completed"}),skippedAt:J.dateTime({isOptional:!0,description:"When the step was skipped"}),blockedAt:J.dateTime({isOptional:!0,description:"When the step was blocked"}),missedAt:J.dateTime({isOptional:!0,description:"When the step was missed"}),triggeringEvent:J.string({isOptional:!0,description:"Event that completed the step"}),eventPayload:J.json({isOptional:!0,description:"Event payload snapshot"}),createdAt:J.createdAt(),updatedAt:J.updatedAt(),progress:J.belongsTo("JourneyProgress",["progressId"],["id"],{onDelete:"Cascade"}),step:J.belongsTo("JourneyStep",["stepId"],["id"],{onDelete:"Cascade"})},indexes:[$.unique(["progressId","stepId"],{name:"journey_step_progress_unique"}),$.on(["status"])]}),Nr=[os,es,ns,ps],Tr=[ss];import{defineEntity as Q,defineEntityEnum as sr,field as g,index as x}from"@contractspec/lib.schema";var dr=sr({name:"QuestionType",values:["MULTIPLE_CHOICE","TRUE_FALSE","FILL_BLANK","MATCHING","SHORT_ANSWER","CODE"],schema:"lssm_learning",description:"Type of quiz question."}),Er=sr({name:"QuizStatus",values:["DRAFT","PUBLISHED","ARCHIVED"],schema:"lssm_learning",description:"Publication status of a quiz."}),fr=sr({name:"AttemptStatus",values:["IN_PROGRESS","COMPLETED","TIMED_OUT","ABANDONED"],schema:"lssm_learning",description:"Status of a quiz attempt."}),us=Q({name:"Quiz",description:"A quiz assessment.",schema:"lssm_learning",map:"quiz",fields:{id:g.id({description:"Unique quiz identifier"}),lessonId:g.foreignKey({isOptional:!0,description:"Associated lesson"}),title:g.string({description:"Quiz title"}),description:g.string({isOptional:!0,description:"Quiz description"}),instructions:g.string({isOptional:!0,description:"Quiz instructions"}),passingScore:g.int({default:70,description:"Passing score percentage"}),timeLimit:g.int({isOptional:!0,description:"Time limit in seconds"}),maxAttempts:g.int({isOptional:!0,description:"Maximum attempts allowed"}),shuffleQuestions:g.boolean({default:!1,description:"Shuffle question order"}),shuffleOptions:g.boolean({default:!1,description:"Shuffle answer options"}),showCorrectAnswers:g.boolean({default:!0,description:"Show correct answers after"}),showExplanations:g.boolean({default:!0,description:"Show explanations after"}),status:g.enum("QuizStatus",{default:"DRAFT",description:"Publication status"}),totalPoints:g.int({default:0,description:"Total points available"}),xpReward:g.int({default:20,description:"XP for passing"}),orgId:g.string({isOptional:!0,description:"Organization scope"}),metadata:g.json({isOptional:!0,description:"Additional metadata"}),createdAt:g.createdAt(),updatedAt:g.updatedAt(),lesson:g.belongsTo("Lesson",["lessonId"],["id"],{onDelete:"Cascade"}),questions:g.hasMany("Question"),attempts:g.hasMany("QuizAttempt")},indexes:[x.on(["lessonId"]),x.on(["status"]),x.on(["orgId"])],enums:[Er]}),cs=Q({name:"Question",description:"A quiz question.",schema:"lssm_learning",map:"question",fields:{id:g.id({description:"Unique question identifier"}),quizId:g.foreignKey({description:"Parent quiz"}),type:g.enum("QuestionType",{description:"Question type"}),content:g.string({description:"Question text"}),mediaUrl:g.string({isOptional:!0,description:"Question media"}),points:g.int({default:1,description:"Points for correct answer"}),codeLanguage:g.string({isOptional:!0,description:"Programming language"}),codeTemplate:g.string({isOptional:!0,description:"Starter code template"}),testCases:g.json({isOptional:!0,description:"Test cases for code validation"}),explanation:g.string({isOptional:!0,description:"Explanation of correct answer"}),hint:g.string({isOptional:!0,description:"Hint for the question"}),order:g.int({default:0,description:"Display order"}),skillId:g.string({isOptional:!0,description:"Associated skill"}),metadata:g.json({isOptional:!0,description:"Additional metadata"}),createdAt:g.createdAt(),updatedAt:g.updatedAt(),quiz:g.belongsTo("Quiz",["quizId"],["id"],{onDelete:"Cascade"}),options:g.hasMany("QuestionOption")},indexes:[x.on(["quizId","order"]),x.on(["type"]),x.on(["skillId"])],enums:[dr]}),gs=Q({name:"QuestionOption",description:"An answer option for a question.",schema:"lssm_learning",map:"question_option",fields:{id:g.id({description:"Unique option identifier"}),questionId:g.foreignKey({description:"Parent question"}),content:g.string({description:"Option text"}),matchContent:g.string({isOptional:!0,description:"Match pair content"}),isCorrect:g.boolean({default:!1,description:"Whether option is correct"}),feedback:g.string({isOptional:!0,description:"Feedback when selected"}),order:g.int({default:0,description:"Display order"}),metadata:g.json({isOptional:!0,description:"Additional metadata"}),createdAt:g.createdAt(),updatedAt:g.updatedAt(),question:g.belongsTo("Question",["questionId"],["id"],{onDelete:"Cascade"})},indexes:[x.on(["questionId","order"])]}),ks=Q({name:"QuizAttempt",description:"A learner quiz attempt.",schema:"lssm_learning",map:"quiz_attempt",fields:{id:g.id({description:"Unique attempt identifier"}),learnerId:g.foreignKey({description:"Learner"}),quizId:g.foreignKey({description:"Quiz"}),status:g.enum("AttemptStatus",{default:"IN_PROGRESS",description:"Attempt status"}),score:g.int({isOptional:!0,description:"Score achieved"}),percentageScore:g.int({isOptional:!0,description:"Percentage score"}),passed:g.boolean({isOptional:!0,description:"Whether passed"}),totalQuestions:g.int({default:0,description:"Total questions"}),answeredQuestions:g.int({default:0,description:"Questions answered"}),correctAnswers:g.int({default:0,description:"Correct answers"}),answers:g.json({isOptional:!0,description:"Submitted answers"}),xpEarned:g.int({default:0,description:"XP earned"}),timeSpent:g.int({default:0,description:"Time spent in seconds"}),startedAt:g.dateTime({description:"When started"}),completedAt:g.dateTime({isOptional:!0,description:"When completed"}),attemptNumber:g.int({default:1,description:"Which attempt this is"}),metadata:g.json({isOptional:!0,description:"Additional metadata"}),createdAt:g.createdAt(),updatedAt:g.updatedAt(),learner:g.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"}),quiz:g.belongsTo("Quiz",["quizId"],["id"],{onDelete:"Cascade"})},indexes:[x.on(["learnerId","quizId"]),x.on(["learnerId","status"]),x.on(["quizId","status"])],enums:[fr]}),Js=Q({name:"SkillAssessment",description:"Assessment of a skill based on quiz performance.",schema:"lssm_learning",map:"skill_assessment",fields:{id:g.id({description:"Unique assessment identifier"}),learnerId:g.foreignKey({description:"Learner"}),skillId:g.string({description:"Skill identifier"}),skillName:g.string({description:"Skill name"}),level:g.int({default:1,description:"Proficiency level (1-5)"}),score:g.int({default:0,description:"Assessment score (0-100)"}),confidence:g.decimal({default:0.5,description:"Confidence in assessment"}),questionsAnswered:g.int({default:0,description:"Total questions answered"}),questionsCorrect:g.int({default:0,description:"Total correct"}),assessedAt:g.dateTime({description:"Last assessment time"}),createdAt:g.createdAt(),updatedAt:g.updatedAt(),learner:g.belongsTo("Learner",["learnerId"],["id"],{onDelete:"Cascade"})},indexes:[x.unique(["learnerId","skillId"],{name:"skill_assessment_unique"}),x.on(["learnerId","level"]),x.on(["skillId"])]}),lr=[us,cs,gs,ks,Js],rt=[dr,Er,fr];var hs=[...$r,...Sr,...Nr,...mr,...lr,...Ur,...qr],bs=[...Mr,...Rr,...Tr,...Xr,...rt,...wr,...Hr],Ke={moduleId:"@contractspec/module.learning-journey",entities:hs,enums:bs};import{defineEvent as K}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as C,ScalarTypeEnum as u}from"@contractspec/lib.schema";var as=C({name:"CoursePublishedEventPayload",description:"Payload when a course is published",fields:{courseId:{type:u.String_unsecure(),isOptional:!1},title:{type:u.String_unsecure(),isOptional:!1},authorId:{type:u.String_unsecure(),isOptional:!1},publishedAt:{type:u.DateTime(),isOptional:!1}}}),Is=K({meta:{key:"course.published",version:"1.0.0",description:"A course has been published.",stability:"stable",owners:[...P],tags:["learning","course"]},payload:as}),As=C({name:"EnrollmentCreatedEventPayload",description:"Payload when a learner enrolls in a course",fields:{enrollmentId:{type:u.String_unsecure(),isOptional:!1},learnerId:{type:u.String_unsecure(),isOptional:!1},courseId:{type:u.String_unsecure(),isOptional:!1},enrolledAt:{type:u.DateTime(),isOptional:!1}}}),Os=K({meta:{key:"enrollment.created",version:"1.0.0",description:"A learner has enrolled in a course.",stability:"stable",owners:[...P],tags:["learning","enrollment"]},payload:As}),Ps=C({name:"LessonCompletedEventPayload",description:"Payload when a lesson is completed",fields:{learnerId:{type:u.String_unsecure(),isOptional:!1},lessonId:{type:u.String_unsecure(),isOptional:!1},courseId:{type:u.String_unsecure(),isOptional:!1},score:{type:u.Int_unsecure(),isOptional:!0},xpEarned:{type:u.Int_unsecure(),isOptional:!1},timeSpent:{type:u.Int_unsecure(),isOptional:!1},completedAt:{type:u.DateTime(),isOptional:!1}}}),Ds=K({meta:{key:"lesson.completed",version:"1.0.0",description:"A learner has completed a lesson.",stability:"stable",owners:[...P],tags:["learning","progress","lesson"]},payload:Ps}),Bs=C({name:"CourseCompletedEventPayload",description:"Payload when a course is completed",fields:{learnerId:{type:u.String_unsecure(),isOptional:!1},courseId:{type:u.String_unsecure(),isOptional:!1},enrollmentId:{type:u.String_unsecure(),isOptional:!1},score:{type:u.Int_unsecure(),isOptional:!0},xpEarned:{type:u.Int_unsecure(),isOptional:!1},certificateId:{type:u.String_unsecure(),isOptional:!0},completedAt:{type:u.DateTime(),isOptional:!1}}}),js=K({meta:{key:"course.completed",version:"1.0.0",description:"A learner has completed a course.",stability:"stable",owners:[...P],tags:["learning","progress","course"]},payload:Bs}),is=C({name:"OnboardingStartedEventPayload",description:"Payload when onboarding starts",fields:{learnerId:{type:u.String_unsecure(),isOptional:!1},trackId:{type:u.String_unsecure(),isOptional:!1},productId:{type:u.String_unsecure(),isOptional:!1},startedAt:{type:u.DateTime(),isOptional:!1}}}),Ks=K({meta:{key:"onboarding.started",version:"1.0.0",description:"A learner has started onboarding.",stability:"stable",owners:[...P],tags:["learning","onboarding"]},payload:is}),Cs=C({name:"OnboardingStepCompletedEventPayload",description:"Payload when an onboarding step is completed",fields:{learnerId:{type:u.String_unsecure(),isOptional:!1},trackId:{type:u.String_unsecure(),isOptional:!1},stepId:{type:u.String_unsecure(),isOptional:!1},triggeringEvent:{type:u.String_unsecure(),isOptional:!0},xpEarned:{type:u.Int_unsecure(),isOptional:!1},completedAt:{type:u.DateTime(),isOptional:!1}}}),ys=K({meta:{key:"onboarding.step_completed",version:"1.0.0",description:"An onboarding step has been completed.",stability:"stable",owners:[...P],tags:["learning","onboarding"]},payload:Cs}),_s=C({name:"OnboardingCompletedEventPayload",description:"Payload when onboarding is completed",fields:{learnerId:{type:u.String_unsecure(),isOptional:!1},trackId:{type:u.String_unsecure(),isOptional:!1},productId:{type:u.String_unsecure(),isOptional:!1},xpEarned:{type:u.Int_unsecure(),isOptional:!1},completedAt:{type:u.DateTime(),isOptional:!1}}}),qs=K({meta:{key:"onboarding.completed",version:"1.0.0",description:"A learner has completed onboarding.",stability:"stable",owners:[...P],tags:["learning","onboarding"]},payload:_s}),Hs=C({name:"CardReviewedEventPayload",description:"Payload when a flashcard is reviewed",fields:{learnerId:{type:u.String_unsecure(),isOptional:!1},cardId:{type:u.String_unsecure(),isOptional:!1},deckId:{type:u.String_unsecure(),isOptional:!1},rating:{type:u.String_unsecure(),isOptional:!1},responseTimeMs:{type:u.Int_unsecure(),isOptional:!0},reviewedAt:{type:u.DateTime(),isOptional:!1}}}),xs=K({meta:{key:"flashcard.reviewed",version:"1.0.0",description:"A flashcard has been reviewed.",stability:"stable",owners:[...P],tags:["learning","flashcards"]},payload:Hs}),Vs=C({name:"QuizStartedEventPayload",description:"Payload when a quiz is started",fields:{learnerId:{type:u.String_unsecure(),isOptional:!1},quizId:{type:u.String_unsecure(),isOptional:!1},attemptId:{type:u.String_unsecure(),isOptional:!1},attemptNumber:{type:u.Int_unsecure(),isOptional:!1},startedAt:{type:u.DateTime(),isOptional:!1}}}),Ls=K({meta:{key:"quiz.started",version:"1.0.0",description:"A quiz attempt has started.",stability:"stable",owners:[...P],tags:["learning","quiz"]},payload:Vs}),Zs=C({name:"QuizCompletedEventPayload",description:"Payload when a quiz is completed",fields:{learnerId:{type:u.String_unsecure(),isOptional:!1},quizId:{type:u.String_unsecure(),isOptional:!1},attemptId:{type:u.String_unsecure(),isOptional:!1},score:{type:u.Int_unsecure(),isOptional:!1},percentageScore:{type:u.Int_unsecure(),isOptional:!1},passed:{type:u.Boolean(),isOptional:!1},xpEarned:{type:u.Int_unsecure(),isOptional:!1},timeSpent:{type:u.Int_unsecure(),isOptional:!1},completedAt:{type:u.DateTime(),isOptional:!1}}}),$s=K({meta:{key:"quiz.completed",version:"1.0.0",description:"A quiz attempt has been completed.",stability:"stable",owners:[...P],tags:["learning","quiz"]},payload:Zs}),Ms=C({name:"XpEarnedEventPayload",description:"Payload when XP is earned",fields:{learnerId:{type:u.String_unsecure(),isOptional:!1},amount:{type:u.Int_unsecure(),isOptional:!1},source:{type:u.String_unsecure(),isOptional:!1},sourceId:{type:u.String_unsecure(),isOptional:!0},totalXp:{type:u.Int_unsecure(),isOptional:!1},earnedAt:{type:u.DateTime(),isOptional:!1}}}),Ws=K({meta:{key:"xp.earned",version:"1.0.0",description:"XP has been earned.",stability:"stable",owners:[...P],tags:["learning","gamification","xp"]},payload:Ms}),ms=C({name:"LevelUpEventPayload",description:"Payload when a learner levels up",fields:{learnerId:{type:u.String_unsecure(),isOptional:!1},previousLevel:{type:u.Int_unsecure(),isOptional:!1},newLevel:{type:u.Int_unsecure(),isOptional:!1},totalXp:{type:u.Int_unsecure(),isOptional:!1},leveledUpAt:{type:u.DateTime(),isOptional:!1}}}),Xs=K({meta:{key:"level.up",version:"1.0.0",description:"A learner has leveled up.",stability:"stable",owners:[...P],tags:["learning","gamification","level"]},payload:ms}),zs=C({name:"StreakUpdatedEventPayload",description:"Payload when a streak is updated",fields:{learnerId:{type:u.String_unsecure(),isOptional:!1},previousStreak:{type:u.Int_unsecure(),isOptional:!1},currentStreak:{type:u.Int_unsecure(),isOptional:!1},longestStreak:{type:u.Int_unsecure(),isOptional:!1},freezeUsed:{type:u.Boolean(),isOptional:!1},updatedAt:{type:u.DateTime(),isOptional:!1}}}),Fs=K({meta:{key:"streak.updated",version:"1.0.0",description:"A streak has been updated.",stability:"stable",owners:[...P],tags:["learning","gamification","streak"]},payload:zs}),Qs=C({name:"AchievementUnlockedEventPayload",description:"Payload when an achievement is unlocked",fields:{learnerId:{type:u.String_unsecure(),isOptional:!1},achievementId:{type:u.String_unsecure(),isOptional:!1},achievementKey:{type:u.String_unsecure(),isOptional:!1},achievementName:{type:u.String_unsecure(),isOptional:!1},xpEarned:{type:u.Int_unsecure(),isOptional:!1},unlockedAt:{type:u.DateTime(),isOptional:!1}}}),Us=K({meta:{key:"achievement.unlocked",version:"1.0.0",description:"An achievement has been unlocked.",stability:"stable",owners:[...P],tags:["learning","gamification","achievement"]},payload:Qs}),ws=C({name:"DailyGoalCompletedEventPayload",description:"Payload when a daily goal is completed",fields:{learnerId:{type:u.String_unsecure(),isOptional:!1},date:{type:u.String_unsecure(),isOptional:!1},targetXp:{type:u.Int_unsecure(),isOptional:!1},actualXp:{type:u.Int_unsecure(),isOptional:!1},completedAt:{type:u.DateTime(),isOptional:!1}}}),vs=K({meta:{key:"daily_goal.completed",version:"1.0.0",description:"A daily goal has been completed.",stability:"stable",owners:[...P],tags:["learning","gamification","goal"]},payload:ws}),Ys=C({name:"CertificateIssuedEventPayload",description:"Payload when a certificate is issued",fields:{certificateId:{type:u.String_unsecure(),isOptional:!1},learnerId:{type:u.String_unsecure(),isOptional:!1},courseId:{type:u.String_unsecure(),isOptional:!1},certificateNumber:{type:u.String_unsecure(),isOptional:!1},issuedAt:{type:u.DateTime(),isOptional:!1}}}),Gs=K({meta:{key:"certificate.issued",version:"1.0.0",description:"A certificate has been issued.",stability:"stable",owners:[...P],tags:["learning","certificate"]},payload:Ys}),We={CoursePublishedEvent:Is,EnrollmentCreatedEvent:Os,LessonCompletedEvent:Ds,CourseCompletedEvent:js,OnboardingStartedEvent:Ks,OnboardingStepCompletedEvent:ys,OnboardingCompletedEvent:qs,CardReviewedEvent:xs,QuizStartedEvent:Ls,QuizCompletedEvent:$s,XpEarnedEvent:Ws,LevelUpEvent:Xs,StreakUpdatedEvent:Fs,AchievementUnlockedEvent:Us,DailyGoalCompletedEvent:vs,CertificateIssuedEvent:Gs};import{defineFeature as Ss}from"@contractspec/lib.contracts-spec/features";var ze=Ss({meta:{key:"modules.learning-journey",version:"1.0.0",title:"Learning Journey",description:"Comprehensive learning journey engine - onboarding, LMS, flashcards, gamification, and AI personalization",domain:"learning-journey",owners:["@contractspec-core"],tags:["package","modules","learning-journey"],stability:"experimental"},operations:[{key:"learning.journey.listTracks",version:"1.0.0"},{key:"learning.journey.getProgress",version:"1.0.0"},{key:"learning.journey.recordEvent",version:"1.0.0"},{key:"learning.enroll",version:"1.0.0"},{key:"learning.completeLesson",version:"1.0.0"},{key:"learning.submitCardReview",version:"1.0.0"},{key:"learning.getDueCards",version:"1.0.0"},{key:"learning.getDashboard",version:"1.0.0"}],events:[{key:"course.published",version:"1.0.0"},{key:"enrollment.created",version:"1.0.0"},{key:"lesson.completed",version:"1.0.0"},{key:"course.completed",version:"1.0.0"},{key:"onboarding.started",version:"1.0.0"},{key:"onboarding.step_completed",version:"1.0.0"},{key:"onboarding.completed",version:"1.0.0"},{key:"flashcard.reviewed",version:"1.0.0"},{key:"quiz.started",version:"1.0.0"},{key:"quiz.completed",version:"1.0.0"},{key:"xp.earned",version:"1.0.0"},{key:"level.up",version:"1.0.0"},{key:"streak.updated",version:"1.0.0"},{key:"achievement.unlocked",version:"1.0.0"},{key:"daily_goal.completed",version:"1.0.0"},{key:"certificate.issued",version:"1.0.0"}]});var or=(r,t)=>{if(!r)return!0;if(!t)return!1;return Object.entries(r).every(([o,s])=>t[o]===s)},N=(r,t)=>{if(r.eventName!==t.name)return!1;if(r.eventVersion!==void 0&&t.version!==void 0&&r.eventVersion!==t.version)return!1;if(r.sourceModule&&t.sourceModule&&r.sourceModule!==t.sourceModule)return!1;return or(r.payloadFilter,t.payload)},T=(r,t,o,s)=>{if(r.kind==="count"){if(!N(r,t))return{matched:!1};let c=o.occurrences+1;return{matched:(r.withinHours===void 0||s!==void 0&&t.occurredAt!==void 0&&(t.occurredAt.getTime()-s.getTime())/3600000<=r.withinHours)&&c>=r.atLeast,occurrences:c}}if(r.kind==="time_window"){if(!N(r,t))return{matched:!1};if(r.availableAfterHours!==void 0&&s!==void 0&&t.occurredAt!==void 0&&(t.occurredAt.getTime()-s.getTime())/3600000<r.availableAfterHours)return{matched:!1};if(r.withinHoursOfStart!==void 0&&s!==void 0&&t.occurredAt!==void 0&&(t.occurredAt.getTime()-s.getTime())/3600000>r.withinHoursOfStart)return{matched:!1};return{matched:!0}}if(r.kind==="mastery"){if(t.name!==r.eventName)return{matched:!1};if(!or(r.payloadFilter,t.payload))return{matched:!1};let c=r.masteryField??"mastery",A=t.payload?.[c];if(typeof A!=="number")return{matched:!1};if(A<r.minimumMastery)return{matched:!1};let I=o.masteryCount+1;return{masteryCount:I,matched:I>=(r.requiredCount??1)}}return{matched:N(r,t)}},er=(r,t)=>{if(!r||!t)return{};let o=t.getTime(),s=o;if(r.unlockOnDay!==void 0)s=o+(r.unlockOnDay-1)*24*60*60*1000;if(r.unlockAfterHours!==void 0)s=o+r.unlockAfterHours*60*60*1000;let c=new Date(s),A=r.dueWithinHours!==void 0?new Date(c.getTime()+r.dueWithinHours*60*60*1000):void 0;return{availableAt:c,dueAt:A}},nr=(r,t)=>{let o=t.steps.find((s)=>s.stepId===r.stepId);if(!o)return!1;if(r.kind==="step_completed")return o.status==="COMPLETED"||o.status==="SKIPPED";return o.selectedBranchKey===r.branchKey},pr=(r,t,o,s)=>{if(!r.branches?.length)return;if(!t)return r.branches.find((c)=>c.when===void 0);for(let c of r.branches){if(!c.when)continue;if(T(c.when,t,o,s).matched)return c}return r.branches.find((c)=>c.when===void 0)};var Rs=(r)=>r.map((t)=>({...t})),Ns=(r,t)=>{let o=new Map;for(let s of r.steps){let c=t.steps.find((I)=>I.stepId===s.id),A=s.branches?.find((I)=>I.key===c?.selectedBranchKey);if(!A?.blockStepIds?.length)continue;for(let I of A.blockStepIds)o.set(I,{blockedByBranchKey:A.key,blockedByStepId:s.id})}return o},M=(r,t,o={})=>{let s=o.now??new Date,c={...t,badges:[...t.badges],eventLog:[...t.eventLog],steps:Rs(t.steps),streak:{...t.streak}},A=Ns(r,c);for(let I of r.steps){let O=c.steps.find((X)=>X.stepId===I.id);if(!O)continue;let{availableAt:j,dueAt:D}=er(I.availability,c.startedAt);if(O.availableAt=j,O.dueAt=D,O.status==="COMPLETED"||O.status==="SKIPPED")continue;let q=A.get(I.id);if(q){O.blockedAt??=s,O.blockedByBranchKey=q.blockedByBranchKey,O.blockedByStepId=q.blockedByStepId,O.status="BLOCKED";continue}let m=I.prerequisites??[],B=I.prerequisiteMode==="any"?m.some((X)=>nr(X,c)):m.every((X)=>nr(X,c)),ut=(m.length===0?!0:B)&&(!j||s.getTime()>=j.getTime());if(D&&s.getTime()>D.getTime()){O.missedAt??=s,O.status="MISSED";continue}O.status=ut?"AVAILABLE":"LOCKED"}return c},d=(r)=>{let t=r.steps.filter((o)=>o.status!=="BLOCKED");return t.length>0&&t.every((o)=>o.status==="COMPLETED"||o.status==="SKIPPED")},ur=(r,t,o={})=>{let s=M(r,t,o),c=s.steps.filter((B)=>B.status!=="BLOCKED"),A=s.steps.filter((B)=>B.status==="COMPLETED"),I=s.steps.filter((B)=>B.status==="AVAILABLE").map((B)=>B.stepId),O=s.steps.filter((B)=>B.status==="BLOCKED").map((B)=>B.stepId),j=s.steps.filter((B)=>B.status==="MISSED").map((B)=>B.stepId),D=c.filter((B)=>B.status==="COMPLETED"||B.status==="SKIPPED").length,q=c.length>0?Math.round(D/c.length*100):0,m=I[0]??null;return{activeStepCount:c.length,availableStepIds:I,badges:[...s.badges],blockedStepIds:O,completedAt:s.completedAt,completedStepCount:D,completedStepIds:A.map((B)=>B.stepId),currentStepId:m,isCompleted:d(s),lastActivityAt:s.lastActivityAt,learnerId:s.learnerId,missedStepIds:j,nextStepId:m,progressPercent:q,startedAt:s.startedAt,steps:s.steps,streakDays:s.streak.currentStreak,totalSteps:r.steps.length,trackId:s.trackId,xpEarned:s.xpEarned}};var cr=new U,tt=new v,st=(r)=>({...r,badges:[...r.badges],eventLog:[...r.eventLog],steps:r.steps.map((t)=>({...t})),streak:{...r.streak}}),Ts=(r)=>r.reward?.xp??r.xpReward??0,ot=(r,t)=>r.steps.find((o)=>o.stepId===t),et=(r,t)=>{if(t&&!r.badges.includes(t))r.badges.push(t)},nt=(r,t,o,s)=>{if(!d(t)||t.completionRewardApplied)return t;let c=r.completionRewards?.xp??0;if(c>0)t.xpEarned+=s.calculate({activity:"journey_complete",baseXp:c,currentStreak:t.streak.currentStreak}).totalXp;return et(t,r.completionRewards?.badgeKey),t.completedAt=o,t.completionRewardApplied=!0,t},pt=(r,t,o,s,c,A,I,O)=>{if(s.status==="COMPLETED")return;let j=Ts(o);if(j>0)t.xpEarned+=O.calculate({activity:"journey_step",baseXp:j,currentStreak:t.streak.currentStreak}).totalXp;s.completedAt=c,s.eventPayload=A?.payload,s.manual=I,s.status="COMPLETED",s.triggeringEvent=A?.name??"journey.step.manual",s.xpEarned=j;let D=pr(o,A,s,t.startedAt);if(!D)return;if(s.selectedBranchKey=D.key,D.reward?.xp)t.xpEarned+=D.reward.xp;et(t,D.reward?.badgeKey)},ds=(r,t={})=>M(r,{badges:[],completionRewardApplied:!1,eventLog:[],learnerId:t.learnerId,startedAt:t.now,steps:r.steps.map((o)=>({masteryCount:0,occurrences:0,status:"LOCKED",stepId:o.id,xpEarned:0})),streak:cr.getInitialState(),trackId:r.id,xpEarned:0},{now:t.now}),Es=(r,t,o,s={})=>{let c=s.streakEngine??cr,A=s.xpEngine??tt,I=o.occurredAt??new Date,O=M(r,st(t),{now:I});O.eventLog.push({...o,occurredAt:I,trackId:r.id}),O.lastActivityAt=I,O.startedAt??=I,O.streak=c.update(O.streak,I).state;for(let j of r.steps){let D=ot(O,j.id);if(!D||D.status!=="AVAILABLE")continue;let q=T(j.completion,o,D,O.startedAt);if(q.occurrences!==void 0)D.occurrences=q.occurrences;if(q.masteryCount!==void 0)D.masteryCount=q.masteryCount;if(!q.matched)continue;pt(r,O,j,D,I,o,!1,A)}return nt(r,M(r,O,{now:I}),I,A)},fs=(r,t,o,s={})=>{let c=s.streakEngine??cr,A=s.xpEngine??tt,I=s.now??new Date,O=M(r,st(t),{now:I}),j=r.steps.find((q)=>q.id===o),D=ot(O,o);if(!j||!D||D.status!=="AVAILABLE")return O;return O.eventLog.push({name:"journey.step.manual",occurredAt:I,trackId:r.id}),O.lastActivityAt=I,O.startedAt??=I,O.streak=c.update(O.streak,I).state,pt(r,O,j,D,I,{name:"journey.step.manual",occurredAt:I},!0,A),nt(r,M(r,O,{now:I}),I,A)},ls=(r,t,o={})=>ur(r,t,o);export{To as xpEngine,M as synchronizeJourneyProgressState,Zo as streakEngine,Vo as srsEngine,pr as resolveJourneyBranch,er as resolveJourneyAvailability,Es as recordJourneyEvent,rt as quizEnums,lr as quizEntities,ls as projectJourneyProgress,or as matchesPayloadFilter,T as matchesJourneyCondition,N as matchesBaseJourneyEvent,Ke as learningJourneySchemaContribution,bs as learningJourneyEnums,hs as learningJourneyEntities,Rr as learnerEnums,Sr as learnerEntities,Tr as journeyEnums,Nr as journeyEntities,d as isJourneyComplete,No as getXpSourceLabel,wr as gamificationEnums,Ur as gamificationEntities,Xr as flashcardEnums,mr as flashcardEntities,ds as createJourneyProgressState,Mr as courseEnums,$r as courseEntities,fs as completeJourneyStep,ur as buildJourneyProgressSnapshot,Hr as aiEnums,qr as aiEntities,Ws as XpEarnedEvent,Tt as XPTransactionEntity,v as XPEngine,l as SuccessOutput,br as SubmitCardReviewInput,Do as SubmitCardReviewContract,Fs as StreakUpdatedEvent,Gt as StreakEntity,U as StreakEngine,Vt as SkillMapEntity,Js as SkillAssessmentEntity,Dr as SRSEngine,uo as RecordJourneyEventContract,_r as RecommendationTypeEnum,Zt as RecommendationEntity,Er as QuizStatusEnum,Ls as QuizStartedEvent,us as QuizEntity,$s as QuizCompletedEvent,ks as QuizAttemptEntity,dr as QuestionTypeEnum,gs as QuestionOptionEntity,cs as QuestionEntity,Gr as ProgressStatusEnum,Jo as ProgressModel,ys as OnboardingStepCompletedEvent,Ks as OnboardingStartedEvent,qs as OnboardingCompletedEvent,lt as ModuleCompletionEntity,no as ListJourneyTracksContract,Xs as LevelUpEvent,Lr as LessonTypeEnum,ft as LessonProgressEntity,mt as LessonEntity,Xt as LessonContentEntity,Ds as LessonCompletedEvent,yr as LearningStyleEnum,Lt as LearningPathEntity,ze as LearningJourneyFeature,We as LearningJourneyEvents,$t as LearningGapEntity,xt as LearnerProfileEntity,Ot as LearnerModel,dt as LearnerEntity,Or as LearnerDashboardModel,Yt as LearnerAchievementEntity,Qr as LeaderboardPeriodEnum,Rt as LeaderboardEntryEntity,P as LEARNING_JOURNEY_OWNERS,Jt as JourneyTrackModel,os as JourneyTrackEntity,ss as JourneyStepStatusEnum,ps as JourneyStepProgressEntity,es as JourneyStepEntity,E as JourneyProgressModel,ns as JourneyProgressEntity,Nt as HeartEntity,Ar as GetLearnerDashboardInput,jo as GetLearnerDashboardContract,po as GetJourneyProgressContract,Ir as GetDueCardsOutput,ar as GetDueCardsInput,Bo as GetDueCardsContract,Yr as EnrollmentStatusEnum,f as EnrollmentModel,Et as EnrollmentEntity,Os as EnrollmentCreatedEvent,Jr as EnrollInCourseInput,Oo as EnrollInCourseContract,ho as DeckModel,Ft as DeckEntity,St as DailyGoalEntity,vs as DailyGoalCompletedEvent,w as DEFAULT_XP_CONFIG,Kt as DEFAULT_STREAK_CONFIG,it as DEFAULT_SRS_CONFIG,Vr as CourseStatusEnum,Is as CoursePublishedEvent,Wt as CourseModuleEntity,ko as CourseModel,Mt as CourseEntity,xr as CourseDifficultyEnum,js as CourseCompletedEvent,Zr as ContentTypeEnum,hr as CompleteLessonInput,Po as CompleteLessonContract,Gs as CertificateIssuedEvent,rs as CertificateEntity,wt as CardScheduleEntity,xs as CardReviewedEvent,Ut as CardReviewEntity,Wr as CardRatingEnum,Pt as CardModel,Qt as CardEntity,fr as AttemptStatusEnum,Us as AchievementUnlockedEvent,Fr as AchievementTypeEnum,Dt as AchievementModel,vt as AchievementEntity};

package/dist/learning-journey.feature.d.ts

@@ -1,5 +1 @@
-/**
- * Learning Journey feature module that bundles course enrollment,
- * onboarding tracks, flashcard review, and gamification capabilities.
- */
 export declare const LearningJourneyFeature: import("@contractspec/lib.contracts-spec").FeatureModuleSpec;

package/dist/learning-journey.feature.js

@@ -1,2 +1,2 @@
 // @bun
-import{defineFeature as g}from"@contractspec/lib.contracts-spec";var j=g({meta:{key:"learning-journey",version:"1.0.0",title:"Learning Journey",description:"Learning platform with courses, onboarding, flashcards, and gamification",domain:"learning",owners:["@platform.learning-journey"],tags:["learning","onboarding","courses","flashcards","gamification"],stability:"stable"},operations:[{key:"learning.onboarding.recordEvent",version:"1.0.0"},{key:"learning.onboarding.listTracks",version:"1.0.0"},{key:"learning.onboarding.getProgress",version:"1.0.0"},{key:"learning.enroll",version:"1.0.0"},{key:"learning.completeLesson",version:"1.0.0"},{key:"learning.submitCardReview",version:"1.0.0"},{key:"learning.getDueCards",version:"1.0.0"},{key:"learning.getDashboard",version:"1.0.0"}],events:[{key:"course.published",version:"1.0.0"},{key:"course.completed",version:"1.0.0"},{key:"enrollment.created",version:"1.0.0"},{key:"lesson.completed",version:"1.0.0"},{key:"onboarding.started",version:"1.0.0"},{key:"onboarding.step_completed",version:"1.0.0"},{key:"onboarding.completed",version:"1.0.0"},{key:"flashcard.reviewed",version:"1.0.0"},{key:"quiz.started",version:"1.0.0"},{key:"quiz.completed",version:"1.0.0"},{key:"xp.earned",version:"1.0.0"},{key:"level.up",version:"1.0.0"},{key:"streak.updated",version:"1.0.0"},{key:"achievement.unlocked",version:"1.0.0"},{key:"daily_goal.completed",version:"1.0.0"},{key:"certificate.issued",version:"1.0.0"}],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{provides:[{key:"learning-journey",version:"1.0.0"},{key:"onboarding",version:"1.0.0"},{key:"gamification",version:"1.0.0"}],requires:[{key:"identity",version:"1.0.0"}]}});export{j as LearningJourneyFeature};
+import{defineFeature as g}from"@contractspec/lib.contracts-spec/features";var j=g({meta:{key:"modules.learning-journey",version:"1.0.0",title:"Learning Journey",description:"Comprehensive learning journey engine - onboarding, LMS, flashcards, gamification, and AI personalization",domain:"learning-journey",owners:["@contractspec-core"],tags:["package","modules","learning-journey"],stability:"experimental"},operations:[{key:"learning.journey.listTracks",version:"1.0.0"},{key:"learning.journey.getProgress",version:"1.0.0"},{key:"learning.journey.recordEvent",version:"1.0.0"},{key:"learning.enroll",version:"1.0.0"},{key:"learning.completeLesson",version:"1.0.0"},{key:"learning.submitCardReview",version:"1.0.0"},{key:"learning.getDueCards",version:"1.0.0"},{key:"learning.getDashboard",version:"1.0.0"}],events:[{key:"course.published",version:"1.0.0"},{key:"enrollment.created",version:"1.0.0"},{key:"lesson.completed",version:"1.0.0"},{key:"course.completed",version:"1.0.0"},{key:"onboarding.started",version:"1.0.0"},{key:"onboarding.step_completed",version:"1.0.0"},{key:"onboarding.completed",version:"1.0.0"},{key:"flashcard.reviewed",version:"1.0.0"},{key:"quiz.started",version:"1.0.0"},{key:"quiz.completed",version:"1.0.0"},{key:"xp.earned",version:"1.0.0"},{key:"level.up",version:"1.0.0"},{key:"streak.updated",version:"1.0.0"},{key:"achievement.unlocked",version:"1.0.0"},{key:"daily_goal.completed",version:"1.0.0"},{key:"certificate.issued",version:"1.0.0"}]});export{j as LearningJourneyFeature};