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

package/dist/contracts/onboarding.js

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

@@ -1,151 +1 @@
-import { defineCommand, defineQuery } from "../libs/contracts/dist/spec.js";
-import "../libs/contracts/dist/index.js";
-import { LEARNING_JOURNEY_OWNERS } from "./shared.js";
-import { CompleteLessonInput, EnrollInCourseInput, EnrollmentModel, GetDueCardsInput, GetDueCardsOutput, GetLearnerDashboardInput, LearnerDashboardModel, SubmitCardReviewInput, SuccessOutput } from "./models.js";
-
-//#region src/contracts/operations.ts
-/**
-* Enroll in a course.
-*/
-const EnrollInCourseContract = defineCommand({
-	meta: {
-		name: "learning.enroll",
-		version: 1,
-		stability: "stable",
-		owners: [...LEARNING_JOURNEY_OWNERS],
-		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: EnrollInCourseInput,
-		output: EnrollmentModel,
-		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" }
-});
-/**
-* Complete a lesson.
-*/
-const CompleteLessonContract = defineCommand({
-	meta: {
-		name: "learning.completeLesson",
-		version: 1,
-		stability: "stable",
-		owners: [...LEARNING_JOURNEY_OWNERS],
-		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: CompleteLessonInput,
-		output: SuccessOutput,
-		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" }
-});
-/**
-* Submit a card review.
-*/
-const SubmitCardReviewContract = defineCommand({
-	meta: {
-		name: "learning.submitCardReview",
-		version: 1,
-		stability: "stable",
-		owners: [...LEARNING_JOURNEY_OWNERS],
-		tags: ["learning", "flashcards"],
-		description: "Submit a flashcard review.",
-		goal: "Record review and update SRS schedule.",
-		context: "Called when reviewing flashcards."
-	},
-	io: {
-		input: SubmitCardReviewInput,
-		output: SuccessOutput,
-		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" }
-});
-/**
-* Get cards due for review.
-*/
-const GetDueCardsContract = defineQuery({
-	meta: {
-		name: "learning.getDueCards",
-		version: 1,
-		stability: "stable",
-		owners: [...LEARNING_JOURNEY_OWNERS],
-		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: GetDueCardsInput,
-		output: GetDueCardsOutput
-	},
-	policy: { auth: "user" }
-});
-/**
-* Get learner dashboard.
-*/
-const GetLearnerDashboardContract = defineQuery({
-	meta: {
-		name: "learning.getDashboard",
-		version: 1,
-		stability: "stable",
-		owners: [...LEARNING_JOURNEY_OWNERS],
-		tags: ["learning", "dashboard"],
-		description: "Get learner dashboard data.",
-		goal: "Display learner progress and stats.",
-		context: "Called when viewing the learning dashboard."
-	},
-	io: {
-		input: GetLearnerDashboardInput,
-		output: LearnerDashboardModel
-	},
-	policy: { auth: "user" }
-});
-
-//#endregion
-export { CompleteLessonContract, EnrollInCourseContract, GetDueCardsContract, GetLearnerDashboardContract, 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/contracts/shared.js

@@ -1,5 +1 @@
-//#region src/contracts/shared.ts
-const LEARNING_JOURNEY_OWNERS = ["modules.learning-journey"];
-
-//#endregion
-export { LEARNING_JOURNEY_OWNERS };
+const e=[`modules.learning-journey`];export{e as LEARNING_JOURNEY_OWNERS};

package/dist/docs/index.js

@@ -1 +1 @@
-import "./learning-journey.docblock.js";
+import"./learning-journey.docblock.js";

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

@@ -1,22 +1,4 @@
-import { registerDocBlocks } from "../libs/contracts/dist/docs/registry.js";
-import "../libs/contracts/dist/docs/index.js";
-
-//#region src/docs/learning-journey.docblock.ts
-registerDocBlocks([
-	{
-		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.
@@ -60,17 +42,7 @@ const updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });
 - 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\`.
-`
-	},
-	{
-		id: "docs.learning-journey.goal",
-		title: "Learning Journey — 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
+`},{id:`docs.learning-journey.goal`,title:`Learning Journey — 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.
 
@@ -80,17 +52,7 @@ const updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });
 
 ## Success criteria
 - Journey changes regenerate UI/API/events without drift.
-- Analytics/audit hooks exist for completions and streaks.`
-	},
-	{
-		id: "docs.learning-journey.usage",
-		title: "Learning Journey — Usage",
-		summary: "How to compose, bind, and regenerate journeys safely.",
-		kind: "usage",
-		visibility: "public",
-		route: "/docs/learning-journey/usage",
-		tags: ["learning", "usage"],
-		body: `## Setup
+- Analytics/audit hooks exist for completions and streaks.`},{id:`docs.learning-journey.usage`,title:`Learning Journey — 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 \`@lssm/module.learning-journey\`.
 3) Bind steps to real product events (e.g., deal.created, run.completed).
@@ -103,21 +65,7 @@ const updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });
 ## Guardrails
 - Avoid hardcoded progression; keep engines 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 — 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
+- Keep content free of PII; scope learners by org/tenant.`},{id:`docs.learning-journey.constraints`,title:`Learning Journey — 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.
 - Events to emit: learner.enrolled, step.completed, quiz.scored, streak.reset, xp.awarded.
 - Regeneration should not change scoring/streak rules without explicit spec change.
@@ -129,8 +77,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.`
-	}
-]);
-
-//#endregion
+- Use Feature Flags to trial new tracks or reward rules; default safe/off.`}]);

package/dist/engines/index.js

@@ -1,5 +1 @@
-import { DEFAULT_SRS_CONFIG, SRSEngine, srsEngine } from "./srs.js";
-import { DEFAULT_XP_CONFIG, XPEngine, xpEngine } from "./xp.js";
-import { DEFAULT_STREAK_CONFIG, StreakEngine, streakEngine } from "./streak.js";
-
-export { DEFAULT_SRS_CONFIG, DEFAULT_STREAK_CONFIG, DEFAULT_XP_CONFIG, SRSEngine, StreakEngine, XPEngine, srsEngine, streakEngine, xpEngine };
+import{DEFAULT_SRS_CONFIG as e,SRSEngine as t,srsEngine as n}from"./srs.js";import{DEFAULT_XP_CONFIG as r,XPEngine as i,xpEngine as a}from"./xp.js";import{DEFAULT_STREAK_CONFIG as o,StreakEngine as s,streakEngine as c}from"./streak.js";export{e as DEFAULT_SRS_CONFIG,o as DEFAULT_STREAK_CONFIG,r as DEFAULT_XP_CONFIG,t as SRSEngine,s as StreakEngine,i as XPEngine,n as srsEngine,c as streakEngine,a as xpEngine};