@lssm/module.learning-journey 0.0.0-canary-20251217062139 → 0.0.0-canary-20251217060834

package/dist/contracts/onboarding.js

@@ -1 +1 @@
-import{l as e}from"../libs/schema/dist/ScalarTypeEnum.js";import{n as t}from"../libs/schema/dist/SchemaModel.js";import"../libs/schema/dist/index.js";import{n,t as r}from"../libs/contracts/dist/spec.js";import"../libs/contracts/dist/index.js";import{LEARNING_JOURNEY_OWNERS as i}from"./shared.js";import{SuccessOutput as a}from"./models.js";const o=t({name:`OnboardingStepCondition`,description:`Structured completion condition for onboarding steps.`,fields:{eventName:{type:e.String_unsecure(),isOptional:!1},eventVersion:{type:e.Int_unsecure(),isOptional:!0},sourceModule:{type:e.String_unsecure(),isOptional:!0},payloadFilter:{type:e.JSON(),isOptional:!0}}}),s=t({name:`OnboardingStep`,description:`Declarative onboarding step definition.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},trackId:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},instructions:{type:e.String_unsecure(),isOptional:!0},helpUrl:{type:e.String_unsecure(),isOptional:!0},order:{type:e.Int_unsecure(),isOptional:!1},completionEvent:{type:e.String_unsecure(),isOptional:!1},completionCondition:{type:o,isOptional:!0},xpReward:{type:e.Int_unsecure(),isOptional:!0},isRequired:{type:e.Boolean(),isOptional:!0},canSkip:{type:e.Boolean(),isOptional:!0},actionUrl:{type:e.String_unsecure(),isOptional:!0},actionLabel:{type:e.String_unsecure(),isOptional:!0},metadata:{type:e.JSON(),isOptional:!0}}}),c=t({name:`OnboardingTrack`,description:`Onboarding track metadata and steps.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},productId:{type:e.String_unsecure(),isOptional:!0},name:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},targetUserSegment:{type:e.String_unsecure(),isOptional:!0},targetRole:{type:e.String_unsecure(),isOptional:!0},isActive:{type:e.Boolean(),isOptional:!0},isRequired:{type:e.Boolean(),isOptional:!0},canSkip:{type:e.Boolean(),isOptional:!0},totalXp:{type:e.Int_unsecure(),isOptional:!0},completionXpBonus:{type:e.Int_unsecure(),isOptional:!0},completionBadgeKey:{type:e.String_unsecure(),isOptional:!0},streakHoursWindow:{type:e.Int_unsecure(),isOptional:!0},streakBonusXp:{type:e.Int_unsecure(),isOptional:!0},metadata:{type:e.JSON(),isOptional:!0},steps:{type:s,isArray:!0,isOptional:!1}}}),l=t({name:`OnboardingStepProgress`,description:`Progress for a specific onboarding step.`,fields:{stepId:{type:e.String_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},xpEarned:{type:e.Int_unsecure(),isOptional:!0},triggeringEvent:{type:e.String_unsecure(),isOptional:!0},eventPayload:{type:e.JSON(),isOptional:!0},completedAt:{type:e.DateTime(),isOptional:!0}}}),u=t({name:`OnboardingProgress`,description:`Aggregated progress for an onboarding track.`,fields:{learnerId:{type:e.String_unsecure(),isOptional:!0},trackId:{type:e.String_unsecure(),isOptional:!1},progress:{type:e.Int_unsecure(),isOptional:!1},isCompleted:{type:e.Boolean(),isOptional:!1},xpEarned:{type:e.Int_unsecure(),isOptional:!0},startedAt:{type:e.DateTime(),isOptional:!0},completedAt:{type:e.DateTime(),isOptional:!0},lastActivityAt:{type:e.DateTime(),isOptional:!0},steps:{type:l,isArray:!0,isOptional:!0}}}),d=t({name:`ListOnboardingTracksInput`,description:`Filters for listing onboarding tracks.`,fields:{learnerId:{type:e.String_unsecure(),isOptional:!0},productId:{type:e.String_unsecure(),isOptional:!0},trackIds:{type:e.String_unsecure(),isArray:!0,isOptional:!0},includeProgress:{type:e.Boolean(),isOptional:!0}}}),f=t({name:`ListOnboardingTracksOutput`,description:`Available onboarding tracks with optional progress.`,fields:{tracks:{type:c,isArray:!0,isOptional:!1},progress:{type:u,isArray:!0,isOptional:!0}}}),p=t({name:`GetOnboardingProgressInput`,description:`Input for fetching onboarding progress for a track.`,fields:{trackId:{type:e.String_unsecure(),isOptional:!1},learnerId:{type:e.String_unsecure(),isOptional:!0}}}),m=t({name:`RecordOnboardingEventInput`,description:`Record a domain event to advance onboarding progress via completion conditions.`,fields:{learnerId:{type:e.String_unsecure(),isOptional:!1},trackId:{type:e.String_unsecure(),isOptional:!0},eventName:{type:e.String_unsecure(),isOptional:!1},eventVersion:{type:e.Int_unsecure(),isOptional:!0},eventPayload:{type:e.JSON(),isOptional:!0},occurredAt:{type:e.DateTime(),isOptional:!0}}}),h=n({meta:{name:`learning.onboarding.listTracks`,version:1,stability:`stable`,owners:[...i],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:d,output:f},policy:{auth:`user`}}),g=n({meta:{name:`learning.onboarding.getProgress`,version:1,stability:`stable`,owners:[...i],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:p,output:u},policy:{auth:`user`}}),_=r({meta:{name:`learning.onboarding.recordEvent`,version:1,stability:`stable`,owners:[...i],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:m,output:a,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`}});export{g as GetOnboardingProgressContract,h as ListOnboardingTracksContract,u as OnboardingProgressModel,s as OnboardingStepModel,l as OnboardingStepProgressModel,c as OnboardingTrackModel,_ as RecordOnboardingEventContract};
+import{LEARNING_JOURNEY_OWNERS as e}from"./shared.js";import{SuccessOutput as t}from"./models.js";import{ScalarTypeEnum as n,defineSchemaModel as r}from"@lssm/lib.schema";import{defineCommand as i,defineQuery as a}from"@lssm/lib.contracts";const o=r({name:`OnboardingStepCondition`,description:`Structured completion condition for onboarding steps.`,fields:{eventName:{type:n.String_unsecure(),isOptional:!1},eventVersion:{type:n.Int_unsecure(),isOptional:!0},sourceModule:{type:n.String_unsecure(),isOptional:!0},payloadFilter:{type:n.JSON(),isOptional:!0}}}),s=r({name:`OnboardingStep`,description:`Declarative onboarding step definition.`,fields:{id:{type:n.String_unsecure(),isOptional:!1},trackId:{type:n.String_unsecure(),isOptional:!1},title:{type:n.String_unsecure(),isOptional:!1},description:{type:n.String_unsecure(),isOptional:!0},instructions:{type:n.String_unsecure(),isOptional:!0},helpUrl:{type:n.String_unsecure(),isOptional:!0},order:{type:n.Int_unsecure(),isOptional:!1},completionEvent:{type:n.String_unsecure(),isOptional:!1},completionCondition:{type:o,isOptional:!0},xpReward:{type:n.Int_unsecure(),isOptional:!0},isRequired:{type:n.Boolean(),isOptional:!0},canSkip:{type:n.Boolean(),isOptional:!0},actionUrl:{type:n.String_unsecure(),isOptional:!0},actionLabel:{type:n.String_unsecure(),isOptional:!0},metadata:{type:n.JSON(),isOptional:!0}}}),c=r({name:`OnboardingTrack`,description:`Onboarding track metadata and steps.`,fields:{id:{type:n.String_unsecure(),isOptional:!1},productId:{type:n.String_unsecure(),isOptional:!0},name:{type:n.String_unsecure(),isOptional:!1},description:{type:n.String_unsecure(),isOptional:!0},targetUserSegment:{type:n.String_unsecure(),isOptional:!0},targetRole:{type:n.String_unsecure(),isOptional:!0},isActive:{type:n.Boolean(),isOptional:!0},isRequired:{type:n.Boolean(),isOptional:!0},canSkip:{type:n.Boolean(),isOptional:!0},totalXp:{type:n.Int_unsecure(),isOptional:!0},completionXpBonus:{type:n.Int_unsecure(),isOptional:!0},completionBadgeKey:{type:n.String_unsecure(),isOptional:!0},streakHoursWindow:{type:n.Int_unsecure(),isOptional:!0},streakBonusXp:{type:n.Int_unsecure(),isOptional:!0},metadata:{type:n.JSON(),isOptional:!0},steps:{type:s,isArray:!0,isOptional:!1}}}),l=r({name:`OnboardingStepProgress`,description:`Progress for a specific onboarding step.`,fields:{stepId:{type:n.String_unsecure(),isOptional:!1},status:{type:n.String_unsecure(),isOptional:!1},xpEarned:{type:n.Int_unsecure(),isOptional:!0},triggeringEvent:{type:n.String_unsecure(),isOptional:!0},eventPayload:{type:n.JSON(),isOptional:!0},completedAt:{type:n.DateTime(),isOptional:!0}}}),u=r({name:`OnboardingProgress`,description:`Aggregated progress for an onboarding track.`,fields:{learnerId:{type:n.String_unsecure(),isOptional:!0},trackId:{type:n.String_unsecure(),isOptional:!1},progress:{type:n.Int_unsecure(),isOptional:!1},isCompleted:{type:n.Boolean(),isOptional:!1},xpEarned:{type:n.Int_unsecure(),isOptional:!0},startedAt:{type:n.DateTime(),isOptional:!0},completedAt:{type:n.DateTime(),isOptional:!0},lastActivityAt:{type:n.DateTime(),isOptional:!0},steps:{type:l,isArray:!0,isOptional:!0}}}),d=r({name:`ListOnboardingTracksInput`,description:`Filters for listing onboarding tracks.`,fields:{learnerId:{type:n.String_unsecure(),isOptional:!0},productId:{type:n.String_unsecure(),isOptional:!0},trackIds:{type:n.String_unsecure(),isArray:!0,isOptional:!0},includeProgress:{type:n.Boolean(),isOptional:!0}}}),f=r({name:`ListOnboardingTracksOutput`,description:`Available onboarding tracks with optional progress.`,fields:{tracks:{type:c,isArray:!0,isOptional:!1},progress:{type:u,isArray:!0,isOptional:!0}}}),p=r({name:`GetOnboardingProgressInput`,description:`Input for fetching onboarding progress for a track.`,fields:{trackId:{type:n.String_unsecure(),isOptional:!1},learnerId:{type:n.String_unsecure(),isOptional:!0}}}),m=r({name:`RecordOnboardingEventInput`,description:`Record a domain event to advance onboarding progress via completion conditions.`,fields:{learnerId:{type:n.String_unsecure(),isOptional:!1},trackId:{type:n.String_unsecure(),isOptional:!0},eventName:{type:n.String_unsecure(),isOptional:!1},eventVersion:{type:n.Int_unsecure(),isOptional:!0},eventPayload:{type:n.JSON(),isOptional:!0},occurredAt:{type:n.DateTime(),isOptional:!0}}}),h=a({meta:{name:`learning.onboarding.listTracks`,version:1,stability:`stable`,owners:[...e],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:d,output:f},policy:{auth:`user`}}),g=a({meta:{name:`learning.onboarding.getProgress`,version:1,stability:`stable`,owners:[...e],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:p,output:u},policy:{auth:`user`}}),_=i({meta:{name:`learning.onboarding.recordEvent`,version:1,stability:`stable`,owners:[...e],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:m,output:t,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`}});export{g as GetOnboardingProgressContract,h as ListOnboardingTracksContract,u as OnboardingProgressModel,s as OnboardingStepModel,l as OnboardingStepProgressModel,c as OnboardingTrackModel,_ as RecordOnboardingEventContract};

package/dist/contracts/operations.d.ts

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

package/dist/contracts/operations.js

@@ -1 +1 @@
-import{n as e,t}from"../libs/contracts/dist/spec.js";import"../libs/contracts/dist/index.js";import{LEARNING_JOURNEY_OWNERS as n}from"./shared.js";import{CompleteLessonInput as r,EnrollInCourseInput as i,EnrollmentModel as a,GetDueCardsInput as o,GetDueCardsOutput as s,GetLearnerDashboardInput as c,LearnerDashboardModel as l,SubmitCardReviewInput as u,SuccessOutput as d}from"./models.js";const f=t({meta:{name:`learning.enroll`,version:1,stability:`stable`,owners:[...n],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:i,output:a,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`}}),p=t({meta:{name:`learning.completeLesson`,version:1,stability:`stable`,owners:[...n],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:r,output:d,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`}}),m=t({meta:{name:`learning.submitCardReview`,version:1,stability:`stable`,owners:[...n],tags:[`learning`,`flashcards`],description:`Submit a flashcard review.`,goal:`Record review and update SRS schedule.`,context:`Called when reviewing flashcards.`},io:{input:u,output:d,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`}}),h=e({meta:{name:`learning.getDueCards`,version:1,stability:`stable`,owners:[...n],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:o,output:s},policy:{auth:`user`}}),g=e({meta:{name:`learning.getDashboard`,version:1,stability:`stable`,owners:[...n],tags:[`learning`,`dashboard`],description:`Get learner dashboard data.`,goal:`Display learner progress and stats.`,context:`Called when viewing the learning dashboard.`},io:{input:c,output:l},policy:{auth:`user`}});export{p as CompleteLessonContract,f as EnrollInCourseContract,h as GetDueCardsContract,g as GetLearnerDashboardContract,m as SubmitCardReviewContract};
+import{LEARNING_JOURNEY_OWNERS as e}from"./shared.js";import{CompleteLessonInput as t,EnrollInCourseInput as n,EnrollmentModel as r,GetDueCardsInput as i,GetDueCardsOutput as a,GetLearnerDashboardInput as o,LearnerDashboardModel as s,SubmitCardReviewInput as c,SuccessOutput as l}from"./models.js";import{defineCommand as u,defineQuery as d}from"@lssm/lib.contracts";const f=u({meta:{name:`learning.enroll`,version:1,stability:`stable`,owners:[...e],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:n,output:r,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`}}),p=u({meta:{name:`learning.completeLesson`,version:1,stability:`stable`,owners:[...e],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: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`}}),m=u({meta:{name:`learning.submitCardReview`,version:1,stability:`stable`,owners:[...e],tags:[`learning`,`flashcards`],description:`Submit a flashcard review.`,goal:`Record review and update SRS schedule.`,context:`Called when reviewing flashcards.`},io:{input:c,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`}}),h=d({meta:{name:`learning.getDueCards`,version:1,stability:`stable`,owners:[...e],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:i,output:a},policy:{auth:`user`}}),g=d({meta:{name:`learning.getDashboard`,version:1,stability:`stable`,owners:[...e],tags:[`learning`,`dashboard`],description:`Get learner dashboard data.`,goal:`Display learner progress and stats.`,context:`Called when viewing the learning dashboard.`},io:{input:o,output:s},policy:{auth:`user`}});export{p as CompleteLessonContract,f as EnrollInCourseContract,h as GetDueCardsContract,g as GetLearnerDashboardContract,m as SubmitCardReviewContract};

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

@@ -1,4 +1,4 @@
-import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";e([{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
+import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{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
 
 - **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.