@contractspec/module.learning-journey 3.7.16 → 3.7.17

package/dist/contracts/index.js

@@ -1,579 +1,2 @@
 // @bun
-// src/contracts/models.ts
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var CourseModel = defineSchemaModel({
-  name: "Course",
-  description: "A learning course",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    difficulty: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    estimatedDuration: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: true
-    },
-    thumbnailUrl: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-var LearnerModel = defineSchemaModel({
-  name: "Learner",
-  description: "A learner profile",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    userId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    displayName: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    level: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    totalXp: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    currentStreak: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    longestStreak: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-var EnrollmentModel = defineSchemaModel({
-  name: "Enrollment",
-  description: "A course enrollment",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    learnerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    courseId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    progress: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
-  }
-});
-var ProgressModel = defineSchemaModel({
-  name: "LessonProgress",
-  description: "Lesson progress",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    learnerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    lessonId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    progress: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    score: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    timeSpent: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
-  }
-});
-var DeckModel = defineSchemaModel({
-  name: "Deck",
-  description: "A flashcard deck",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    cardCount: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: false },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-var CardModel = defineSchemaModel({
-  name: "Card",
-  description: "A flashcard",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    deckId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    front: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    back: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    hints: { type: ScalarTypeEnum.JSON(), isOptional: true },
-    isDue: { type: ScalarTypeEnum.Boolean(), isOptional: false },
-    nextReviewAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
-  }
-});
-var AchievementModel = defineSchemaModel({
-  name: "Achievement",
-  description: "An achievement",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    icon: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    xpReward: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    unlockedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
-  }
-});
-var EnrollInCourseInput = defineSchemaModel({
-  name: "EnrollInCourseInput",
-  description: "Input for enrolling in a course",
-  fields: {
-    courseId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-  }
-});
-var CompleteLessonInput = defineSchemaModel({
-  name: "CompleteLessonInput",
-  description: "Input for completing a lesson",
-  fields: {
-    lessonId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    score: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    timeSpent: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false }
-  }
-});
-var SubmitCardReviewInput = defineSchemaModel({
-  name: "SubmitCardReviewInput",
-  description: "Input for submitting a card review",
-  fields: {
-    cardId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    rating: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    responseTimeMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true }
-  }
-});
-var GetDueCardsInput = defineSchemaModel({
-  name: "GetDueCardsInput",
-  description: "Input for getting due cards",
-  fields: {
-    deckId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    limit: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true }
-  }
-});
-var GetDueCardsOutput = defineSchemaModel({
-  name: "GetDueCardsOutput",
-  description: "Output for getting due cards",
-  fields: {
-    cards: { type: CardModel, isArray: true, isOptional: false },
-    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false }
-  }
-});
-var GetLearnerDashboardInput = defineSchemaModel({
-  name: "GetLearnerDashboardInput",
-  description: "Input for getting learner dashboard",
-  fields: {
-    learnerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-  }
-});
-var LearnerDashboardModel = defineSchemaModel({
-  name: "LearnerDashboard",
-  description: "Learner dashboard data",
-  fields: {
-    learner: { type: LearnerModel, isOptional: false },
-    currentStreak: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    dailyXpGoal: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    dailyXpProgress: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    activeEnrollments: {
-      type: EnrollmentModel,
-      isArray: true,
-      isOptional: false
-    },
-    recentAchievements: {
-      type: AchievementModel,
-      isArray: true,
-      isOptional: false
-    },
-    dueCardCount: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false }
-  }
-});
-var SuccessOutput = defineSchemaModel({
-  name: "SuccessOutput",
-  description: "Generic success output",
-  fields: {
-    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },
-    xpEarned: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true }
-  }
-});
-
-// src/contracts/shared.ts
-var LEARNING_JOURNEY_OWNERS = ["modules.learning-journey"];
-
-// src/contracts/onboarding.ts
-import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
-var OnboardingStepConditionModel = defineSchemaModel2({
-  name: "OnboardingStepCondition",
-  description: "Structured completion condition for onboarding steps.",
-  fields: {
-    eventName: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    eventVersion: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    sourceModule: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    payloadFilter: { type: ScalarTypeEnum2.JSON(), isOptional: true }
-  }
-});
-var OnboardingStepModel = defineSchemaModel2({
-  name: "OnboardingStep",
-  description: "Declarative onboarding step definition.",
-  fields: {
-    id: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    trackId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    title: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    instructions: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    helpUrl: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    order: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
-    completionEvent: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: false
-    },
-    completionCondition: {
-      type: OnboardingStepConditionModel,
-      isOptional: true
-    },
-    xpReward: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: true },
-    isRequired: { type: ScalarTypeEnum2.Boolean(), isOptional: true },
-    canSkip: { type: ScalarTypeEnum2.Boolean(), isOptional: true },
-    actionUrl: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    actionLabel: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    metadata: { type: ScalarTypeEnum2.JSON(), isOptional: true }
-  }
-});
-var OnboardingTrackModel = defineSchemaModel2({
-  name: "OnboardingTrack",
-  description: "Onboarding track metadata and steps.",
-  fields: {
-    id: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    productId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    name: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    targetUserSegment: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: true
-    },
-    targetRole: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    isActive: { type: ScalarTypeEnum2.Boolean(), isOptional: true },
-    isRequired: { type: ScalarTypeEnum2.Boolean(), isOptional: true },
-    canSkip: { type: ScalarTypeEnum2.Boolean(), isOptional: true },
-    totalXp: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: true },
-    completionXpBonus: {
-      type: ScalarTypeEnum2.Int_unsecure(),
-      isOptional: true
-    },
-    completionBadgeKey: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: true
-    },
-    streakHoursWindow: {
-      type: ScalarTypeEnum2.Int_unsecure(),
-      isOptional: true
-    },
-    streakBonusXp: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: true },
-    metadata: { type: ScalarTypeEnum2.JSON(), isOptional: true },
-    steps: { type: OnboardingStepModel, isArray: true, isOptional: false }
-  }
-});
-var OnboardingStepProgressModel = defineSchemaModel2({
-  name: "OnboardingStepProgress",
-  description: "Progress for a specific onboarding step.",
-  fields: {
-    stepId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    status: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    xpEarned: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: true },
-    triggeringEvent: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: true
-    },
-    eventPayload: { type: ScalarTypeEnum2.JSON(), isOptional: true },
-    completedAt: { type: ScalarTypeEnum2.DateTime(), isOptional: true }
-  }
-});
-var OnboardingProgressModel = defineSchemaModel2({
-  name: "OnboardingProgress",
-  description: "Aggregated progress for an onboarding track.",
-  fields: {
-    learnerId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    trackId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    progress: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
-    isCompleted: { type: ScalarTypeEnum2.Boolean(), isOptional: false },
-    xpEarned: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: true },
-    startedAt: { type: ScalarTypeEnum2.DateTime(), isOptional: true },
-    completedAt: { type: ScalarTypeEnum2.DateTime(), isOptional: true },
-    lastActivityAt: { type: ScalarTypeEnum2.DateTime(), isOptional: true },
-    steps: {
-      type: OnboardingStepProgressModel,
-      isArray: true,
-      isOptional: true
-    }
-  }
-});
-var ListOnboardingTracksInput = defineSchemaModel2({
-  name: "ListOnboardingTracksInput",
-  description: "Filters for listing onboarding tracks.",
-  fields: {
-    learnerId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    productId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    trackIds: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isArray: true,
-      isOptional: true
-    },
-    includeProgress: {
-      type: ScalarTypeEnum2.Boolean(),
-      isOptional: true
-    }
-  }
-});
-var ListOnboardingTracksOutput = defineSchemaModel2({
-  name: "ListOnboardingTracksOutput",
-  description: "Available onboarding tracks with optional progress.",
-  fields: {
-    tracks: { type: OnboardingTrackModel, isArray: true, isOptional: false },
-    progress: {
-      type: OnboardingProgressModel,
-      isArray: true,
-      isOptional: true
-    }
-  }
-});
-var GetOnboardingProgressInput = defineSchemaModel2({
-  name: "GetOnboardingProgressInput",
-  description: "Input for fetching onboarding progress for a track.",
-  fields: {
-    trackId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    learnerId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true }
-  }
-});
-var RecordOnboardingEventInput = defineSchemaModel2({
-  name: "RecordOnboardingEventInput",
-  description: "Record a domain event to advance onboarding progress via completion conditions.",
-  fields: {
-    learnerId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    trackId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    eventName: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    eventVersion: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    eventPayload: { type: ScalarTypeEnum2.JSON(), isOptional: true },
-    occurredAt: { type: ScalarTypeEnum2.DateTime(), isOptional: true }
-  }
-});
-var ListOnboardingTracksContract = defineQuery({
-  meta: {
-    key: "learning.onboarding.listTracks",
-    version: "1.0.0",
-    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"
-  }
-});
-var GetOnboardingProgressContract = defineQuery({
-  meta: {
-    key: "learning.onboarding.getProgress",
-    version: "1.0.0",
-    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"
-  }
-});
-var RecordOnboardingEventContract = defineCommand({
-  meta: {
-    key: "learning.onboarding.recordEvent",
-    version: "1.0.0",
-    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"
-  }
-});
-
-// src/contracts/operations.ts
-import { defineCommand as defineCommand2, defineQuery as defineQuery2 } from "@contractspec/lib.contracts-spec";
-var EnrollInCourseContract = defineCommand2({
-  meta: {
-    key: "learning.enroll",
-    version: "1.0.0",
-    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"
-  }
-});
-var CompleteLessonContract = defineCommand2({
-  meta: {
-    key: "learning.completeLesson",
-    version: "1.0.0",
-    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"
-  }
-});
-var SubmitCardReviewContract = defineCommand2({
-  meta: {
-    key: "learning.submitCardReview",
-    version: "1.0.0",
-    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"
-  }
-});
-var GetDueCardsContract = defineQuery2({
-  meta: {
-    key: "learning.getDueCards",
-    version: "1.0.0",
-    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"
-  }
-});
-var GetLearnerDashboardContract = defineQuery2({
-  meta: {
-    key: "learning.getDashboard",
-    version: "1.0.0",
-    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"
-  }
-});
-export {
-  SuccessOutput,
-  SubmitCardReviewInput,
-  SubmitCardReviewContract,
-  RecordOnboardingEventContract,
-  ProgressModel,
-  OnboardingTrackModel,
-  OnboardingStepProgressModel,
-  OnboardingStepModel,
-  OnboardingProgressModel,
-  ListOnboardingTracksContract,
-  LearnerModel,
-  LearnerDashboardModel,
-  LEARNING_JOURNEY_OWNERS,
-  GetOnboardingProgressContract,
-  GetLearnerDashboardInput,
-  GetLearnerDashboardContract,
-  GetDueCardsOutput,
-  GetDueCardsInput,
-  GetDueCardsContract,
-  EnrollmentModel,
-  EnrollInCourseInput,
-  EnrollInCourseContract,
-  DeckModel,
-  CourseModel,
-  CompleteLessonInput,
-  CompleteLessonContract,
-  CardModel,
-  AchievementModel
-};
+import{defineSchemaModel as s,ScalarTypeEnum as e}from"@contractspec/lib.schema";var z=s({name:"Course",description:"A learning course",fields:{id:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!1},slug:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},difficulty:{type:e.String_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},estimatedDuration:{type:e.Int_unsecure(),isOptional:!0},thumbnailUrl:{type:e.String_unsecure(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),x=s({name:"Learner",description:"A learner profile",fields:{id:{type:e.String_unsecure(),isOptional:!1},userId:{type:e.String_unsecure(),isOptional:!1},displayName:{type:e.String_unsecure(),isOptional:!0},level:{type:e.Int_unsecure(),isOptional:!1},totalXp:{type:e.Int_unsecure(),isOptional:!1},currentStreak:{type:e.Int_unsecure(),isOptional:!1},longestStreak:{type:e.Int_unsecure(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),o=s({name:"Enrollment",description:"A course enrollment",fields:{id:{type:e.String_unsecure(),isOptional:!1},learnerId:{type:e.String_unsecure(),isOptional:!1},courseId:{type:e.String_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},progress:{type:e.Int_unsecure(),isOptional:!1},startedAt:{type:e.DateTime(),isOptional:!0},completedAt:{type:e.DateTime(),isOptional:!0}}}),F=s({name:"LessonProgress",description:"Lesson progress",fields:{id:{type:e.String_unsecure(),isOptional:!1},learnerId:{type:e.String_unsecure(),isOptional:!1},lessonId:{type:e.String_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},progress:{type:e.Int_unsecure(),isOptional:!1},score:{type:e.Int_unsecure(),isOptional:!0},timeSpent:{type:e.Int_unsecure(),isOptional:!1},completedAt:{type:e.DateTime(),isOptional:!0}}}),H=s({name:"Deck",description:"A flashcard deck",fields:{id:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},cardCount:{type:e.Int_unsecure(),isOptional:!1},isPublic:{type:e.Boolean(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),y=s({name:"Card",description:"A flashcard",fields:{id:{type:e.String_unsecure(),isOptional:!1},deckId:{type:e.String_unsecure(),isOptional:!1},front:{type:e.String_unsecure(),isOptional:!1},back:{type:e.String_unsecure(),isOptional:!1},hints:{type:e.JSON(),isOptional:!0},isDue:{type:e.Boolean(),isOptional:!1},nextReviewAt:{type:e.DateTime(),isOptional:!0}}}),D=s({name:"Achievement",description:"An achievement",fields:{id:{type:e.String_unsecure(),isOptional:!1},key:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!1},icon:{type:e.String_unsecure(),isOptional:!0},xpReward:{type:e.Int_unsecure(),isOptional:!1},unlockedAt:{type:e.DateTime(),isOptional:!0}}}),l=s({name:"EnrollInCourseInput",description:"Input for enrolling in a course",fields:{courseId:{type:e.String_unsecure(),isOptional:!1}}}),u=s({name:"CompleteLessonInput",description:"Input for completing a lesson",fields:{lessonId:{type:e.String_unsecure(),isOptional:!1},score:{type:e.Int_unsecure(),isOptional:!0},timeSpent:{type:e.Int_unsecure(),isOptional:!1}}}),a=s({name:"SubmitCardReviewInput",description:"Input for submitting a card review",fields:{cardId:{type:e.String_unsecure(),isOptional:!1},rating:{type:e.String_unsecure(),isOptional:!1},responseTimeMs:{type:e.Int_unsecure(),isOptional:!0}}}),f=s({name:"GetDueCardsInput",description:"Input for getting due cards",fields:{deckId:{type:e.String_unsecure(),isOptional:!0},limit:{type:e.Int_unsecure(),isOptional:!0}}}),O=s({name:"GetDueCardsOutput",description:"Output for getting due cards",fields:{cards:{type:y,isArray:!0,isOptional:!1},total:{type:e.Int_unsecure(),isOptional:!1}}}),d=s({name:"GetLearnerDashboardInput",description:"Input for getting learner dashboard",fields:{learnerId:{type:e.String_unsecure(),isOptional:!0}}}),c=s({name:"LearnerDashboard",description:"Learner dashboard data",fields:{learner:{type:x,isOptional:!1},currentStreak:{type:e.Int_unsecure(),isOptional:!1},dailyXpGoal:{type:e.Int_unsecure(),isOptional:!1},dailyXpProgress:{type:e.Int_unsecure(),isOptional:!1},activeEnrollments:{type:o,isArray:!0,isOptional:!1},recentAchievements:{type:D,isArray:!0,isOptional:!1},dueCardCount:{type:e.Int_unsecure(),isOptional:!1}}}),r=s({name:"SuccessOutput",description:"Generic success output",fields:{success:{type:e.Boolean(),isOptional:!1},xpEarned:{type:e.Int_unsecure(),isOptional:!0}}});var i=["modules.learning-journey"];import{defineCommand as A,defineQuery as _}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as n,ScalarTypeEnum as t}from"@contractspec/lib.schema";var k=n({name:"OnboardingStepCondition",description:"Structured completion condition for onboarding steps.",fields:{eventName:{type:t.String_unsecure(),isOptional:!1},eventVersion:{type:t.String_unsecure(),isOptional:!0},sourceModule:{type:t.String_unsecure(),isOptional:!0},payloadFilter:{type:t.JSON(),isOptional:!0}}}),v=n({name:"OnboardingStep",description:"Declarative onboarding step definition.",fields:{id:{type:t.String_unsecure(),isOptional:!1},trackId:{type:t.String_unsecure(),isOptional:!1},title:{type:t.String_unsecure(),isOptional:!1},description:{type:t.String_unsecure(),isOptional:!0},instructions:{type:t.String_unsecure(),isOptional:!0},helpUrl:{type:t.String_unsecure(),isOptional:!0},order:{type:t.Int_unsecure(),isOptional:!1},completionEvent:{type:t.String_unsecure(),isOptional:!1},completionCondition:{type:k,isOptional:!0},xpReward:{type:t.Int_unsecure(),isOptional:!0},isRequired:{type:t.Boolean(),isOptional:!0},canSkip:{type:t.Boolean(),isOptional:!0},actionUrl:{type:t.String_unsecure(),isOptional:!0},actionLabel:{type:t.String_unsecure(),isOptional:!0},metadata:{type:t.JSON(),isOptional:!0}}}),C=n({name:"OnboardingTrack",description:"Onboarding track metadata and steps.",fields:{id:{type:t.String_unsecure(),isOptional:!1},productId:{type:t.String_unsecure(),isOptional:!0},name:{type:t.String_unsecure(),isOptional:!1},description:{type:t.String_unsecure(),isOptional:!0},targetUserSegment:{type:t.String_unsecure(),isOptional:!0},targetRole:{type:t.String_unsecure(),isOptional:!0},isActive:{type:t.Boolean(),isOptional:!0},isRequired:{type:t.Boolean(),isOptional:!0},canSkip:{type:t.Boolean(),isOptional:!0},totalXp:{type:t.Int_unsecure(),isOptional:!0},completionXpBonus:{type:t.Int_unsecure(),isOptional:!0},completionBadgeKey:{type:t.String_unsecure(),isOptional:!0},streakHoursWindow:{type:t.Int_unsecure(),isOptional:!0},streakBonusXp:{type:t.Int_unsecure(),isOptional:!0},metadata:{type:t.JSON(),isOptional:!0},steps:{type:v,isArray:!0,isOptional:!1}}}),w=n({name:"OnboardingStepProgress",description:"Progress for a specific onboarding step.",fields:{stepId:{type:t.String_unsecure(),isOptional:!1},status:{type:t.String_unsecure(),isOptional:!1},xpEarned:{type:t.Int_unsecure(),isOptional:!0},triggeringEvent:{type:t.String_unsecure(),isOptional:!0},eventPayload:{type:t.JSON(),isOptional:!0},completedAt:{type:t.DateTime(),isOptional:!0}}}),g=n({name:"OnboardingProgress",description:"Aggregated progress for an onboarding track.",fields:{learnerId:{type:t.String_unsecure(),isOptional:!0},trackId:{type:t.String_unsecure(),isOptional:!1},progress:{type:t.Int_unsecure(),isOptional:!1},isCompleted:{type:t.Boolean(),isOptional:!1},xpEarned:{type:t.Int_unsecure(),isOptional:!0},startedAt:{type:t.DateTime(),isOptional:!0},completedAt:{type:t.DateTime(),isOptional:!0},lastActivityAt:{type:t.DateTime(),isOptional:!0},steps:{type:w,isArray:!0,isOptional:!0}}}),B=n({name:"ListOnboardingTracksInput",description:"Filters for listing onboarding tracks.",fields:{learnerId:{type:t.String_unsecure(),isOptional:!0},productId:{type:t.String_unsecure(),isOptional:!0},trackIds:{type:t.String_unsecure(),isArray:!0,isOptional:!0},includeProgress:{type:t.Boolean(),isOptional:!0}}}),X=n({name:"ListOnboardingTracksOutput",description:"Available onboarding tracks with optional progress.",fields:{tracks:{type:C,isArray:!0,isOptional:!1},progress:{type:g,isArray:!0,isOptional:!0}}}),h=n({name:"GetOnboardingProgressInput",description:"Input for fetching onboarding progress for a track.",fields:{trackId:{type:t.String_unsecure(),isOptional:!1},learnerId:{type:t.String_unsecure(),isOptional:!0}}}),j=n({name:"RecordOnboardingEventInput",description:"Record a domain event to advance onboarding progress via completion conditions.",fields:{learnerId:{type:t.String_unsecure(),isOptional:!1},trackId:{type:t.String_unsecure(),isOptional:!0},eventName:{type:t.String_unsecure(),isOptional:!1},eventVersion:{type:t.String_unsecure(),isOptional:!0},eventPayload:{type:t.JSON(),isOptional:!0},occurredAt:{type:t.DateTime(),isOptional:!0}}}),G=_({meta:{key:"learning.onboarding.listTracks",version:"1.0.0",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:B,output:X},policy:{auth:"user"}}),b=_({meta:{key:"learning.onboarding.getProgress",version:"1.0.0",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:h,output:g},policy:{auth:"user"}}),Q=A({meta:{key:"learning.onboarding.recordEvent",version:"1.0.0",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:j,output:r,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 p,defineQuery as I}from"@contractspec/lib.contracts-spec";var Y=p({meta:{key:"learning.enroll",version:"1.0.0",stability:"stable",owners:[...i],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:l,output:o,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"}}),R=p({meta:{key:"learning.completeLesson",version:"1.0.0",stability:"stable",owners:[...i],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:u,output:r,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=p({meta:{key:"learning.submitCardReview",version:"1.0.0",stability:"stable",owners:[...i],tags:["learning","flashcards"],description:"Submit a flashcard review.",goal:"Record review and update SRS schedule.",context:"Called when reviewing flashcards."},io:{input:a,output:r,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"}}),N=I({meta:{key:"learning.getDueCards",version:"1.0.0",stability:"stable",owners:[...i],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:f,output:O},policy:{auth:"user"}}),S=I({meta:{key:"learning.getDashboard",version:"1.0.0",stability:"stable",owners:[...i],tags:["learning","dashboard"],description:"Get learner dashboard data.",goal:"Display learner progress and stats.",context:"Called when viewing the learning dashboard."},io:{input:d,output:c},policy:{auth:"user"}});export{r as SuccessOutput,a as SubmitCardReviewInput,m as SubmitCardReviewContract,Q as RecordOnboardingEventContract,F as ProgressModel,C as OnboardingTrackModel,w as OnboardingStepProgressModel,v as OnboardingStepModel,g as OnboardingProgressModel,G as ListOnboardingTracksContract,x as LearnerModel,c as LearnerDashboardModel,i as LEARNING_JOURNEY_OWNERS,b as GetOnboardingProgressContract,d as GetLearnerDashboardInput,S as GetLearnerDashboardContract,O as GetDueCardsOutput,f as GetDueCardsInput,N as GetDueCardsContract,o as EnrollmentModel,l as EnrollInCourseInput,Y as EnrollInCourseContract,H as DeckModel,z as CourseModel,u as CompleteLessonInput,R as CompleteLessonContract,y as CardModel,D as AchievementModel};