@contractspec/module.learning-journey 1.57.0 → 1.58.0

package/dist/node/learning-journey.capability.js

@@ -0,0 +1,40 @@
+// src/learning-journey.capability.ts
+import { defineCapability, StabilityEnum } from "@contractspec/lib.contracts";
+var LearningJourneyCapability = defineCapability({
+  meta: {
+    key: "learning-journey",
+    version: "1.0.0",
+    kind: "ui",
+    stability: StabilityEnum.Experimental,
+    description: "Guided learning paths and progress tracking",
+    owners: ["platform.core"],
+    tags: ["learning", "onboarding", "ui"]
+  }
+});
+var OnboardingCapability = defineCapability({
+  meta: {
+    key: "onboarding",
+    version: "1.0.0",
+    kind: "ui",
+    stability: StabilityEnum.Experimental,
+    description: "User onboarding and first-time experience flows",
+    owners: ["platform.core"],
+    tags: ["onboarding", "ux", "ui"]
+  }
+});
+var GamificationCapability = defineCapability({
+  meta: {
+    key: "gamification",
+    version: "1.0.0",
+    kind: "ui",
+    stability: StabilityEnum.Experimental,
+    description: "Gamification elements like badges, points, and achievements",
+    owners: ["platform.core"],
+    tags: ["gamification", "engagement", "ui"]
+  }
+});
+export {
+  OnboardingCapability,
+  LearningJourneyCapability,
+  GamificationCapability
+};

package/dist/node/learning-journey.feature.js

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

package/dist/track-spec.d.ts

@@ -1,129 +1,126 @@
-//#region src/track-spec.d.ts
-interface BaseEventConditionSpec {
-  /**
-   * Required event name to satisfy the condition.
-   */
-  eventName: string;
-  /**
-   * Optional event version to match.
-   */
-  eventVersion?: number;
-  /**
-   * Optional source module to match (for disambiguation).
-   */
-  sourceModule?: string;
-  /**
-   * Optional payload filter (shallow equality on keys).
-   */
-  payloadFilter?: Record<string, unknown>;
+export interface BaseEventConditionSpec {
+    /**
+     * Required event name to satisfy the condition.
+     */
+    eventName: string;
+    /**
+     * Optional event version to match.
+     */
+    eventVersion?: number;
+    /**
+     * Optional source module to match (for disambiguation).
+     */
+    sourceModule?: string;
+    /**
+     * Optional payload filter (shallow equality on keys).
+     */
+    payloadFilter?: Record<string, unknown>;
 }
-interface EventCompletionConditionSpec extends BaseEventConditionSpec {
-  kind?: 'event';
+export interface EventCompletionConditionSpec extends BaseEventConditionSpec {
+    kind?: 'event';
 }
-interface CountCompletionConditionSpec extends BaseEventConditionSpec {
-  kind: 'count';
-  /**
-   * Minimum number of matching events required to complete the step.
-   */
-  atLeast: number;
-  /**
-   * Optional time window (hours) from track start for counting.
-   */
-  withinHours?: number;
+export interface CountCompletionConditionSpec extends BaseEventConditionSpec {
+    kind: 'count';
+    /**
+     * Minimum number of matching events required to complete the step.
+     */
+    atLeast: number;
+    /**
+     * Optional time window (hours) from track start for counting.
+     */
+    withinHours?: number;
 }
-interface TimeWindowCompletionConditionSpec extends BaseEventConditionSpec {
-  kind: 'time_window';
-  /**
-   * Must be completed within this window (hours) from track start.
-   */
-  withinHoursOfStart?: number;
-  /**
-   * Optional additional delay before the step becomes available (hours).
-   */
-  availableAfterHours?: number;
+export interface TimeWindowCompletionConditionSpec extends BaseEventConditionSpec {
+    kind: 'time_window';
+    /**
+     * Must be completed within this window (hours) from track start.
+     */
+    withinHoursOfStart?: number;
+    /**
+     * Optional additional delay before the step becomes available (hours).
+     */
+    availableAfterHours?: number;
 }
-interface SrsMasteryCompletionConditionSpec {
-  kind: 'srs_mastery';
-  /**
-   * Event carrying mastery info (defaults to drill/flashcard mastery events).
-   */
-  eventName: string;
-  /**
-   * Payload key containing skill identifier; defaults to `skillId`.
-   */
-  skillIdField?: string;
-  /**
-   * Payload key containing mastery value; defaults to `mastery`.
-   */
-  masteryField?: string;
-  /**
-   * Minimum mastery value required (e.g., 0-1 or a numeric level).
-   */
-  minimumMastery: number;
-  /**
-   * Optional number of mastered cards required to complete step.
-   */
-  requiredCount?: number;
-  /**
-   * Optional payload filter.
-   */
-  payloadFilter?: Record<string, unknown>;
+export interface SrsMasteryCompletionConditionSpec {
+    kind: 'srs_mastery';
+    /**
+     * Event carrying mastery info (defaults to drill/flashcard mastery events).
+     */
+    eventName: string;
+    /**
+     * Payload key containing skill identifier; defaults to `skillId`.
+     */
+    skillIdField?: string;
+    /**
+     * Payload key containing mastery value; defaults to `mastery`.
+     */
+    masteryField?: string;
+    /**
+     * Minimum mastery value required (e.g., 0-1 or a numeric level).
+     */
+    minimumMastery: number;
+    /**
+     * Optional number of mastered cards required to complete step.
+     */
+    requiredCount?: number;
+    /**
+     * Optional payload filter.
+     */
+    payloadFilter?: Record<string, unknown>;
 }
-type StepCompletionConditionSpec = EventCompletionConditionSpec | CountCompletionConditionSpec | TimeWindowCompletionConditionSpec | SrsMasteryCompletionConditionSpec;
-interface StepAvailabilitySpec {
-  /**
-   * Unlock step after a delay (hours) from track start.
-   */
-  unlockAfterHours?: number;
-  /**
-   * Unlock on a specific day from track start (day 1 = start day).
-   */
-  unlockOnDay?: number;
-  /**
-   * Optional due window (hours) from unlock; if exceeded, step is considered missed.
-   */
-  dueWithinHours?: number;
+export type StepCompletionConditionSpec = EventCompletionConditionSpec | CountCompletionConditionSpec | TimeWindowCompletionConditionSpec | SrsMasteryCompletionConditionSpec;
+export interface StepAvailabilitySpec {
+    /**
+     * Unlock step after a delay (hours) from track start.
+     */
+    unlockAfterHours?: number;
+    /**
+     * Unlock on a specific day from track start (day 1 = start day).
+     */
+    unlockOnDay?: number;
+    /**
+     * Optional due window (hours) from unlock; if exceeded, step is considered missed.
+     */
+    dueWithinHours?: number;
 }
-interface StreakRuleSpec {
-  hoursWindow?: number;
-  bonusXp?: number;
+export interface StreakRuleSpec {
+    hoursWindow?: number;
+    bonusXp?: number;
 }
-interface CompletionRewardsSpec {
-  xpBonus?: number;
-  badgeKey?: string;
+export interface CompletionRewardsSpec {
+    xpBonus?: number;
+    badgeKey?: string;
 }
-interface LearningJourneyStepSpec {
-  id: string;
-  title: string;
-  description?: string;
-  instructions?: string;
-  helpUrl?: string;
-  order?: number;
-  completion: StepCompletionConditionSpec;
-  availability?: StepAvailabilitySpec;
-  xpReward?: number;
-  isRequired?: boolean;
-  canSkip?: boolean;
-  actionUrl?: string;
-  actionLabel?: string;
-  metadata?: Record<string, unknown>;
+export interface LearningJourneyStepSpec {
+    id: string;
+    title: string;
+    description?: string;
+    instructions?: string;
+    helpUrl?: string;
+    order?: number;
+    completion: StepCompletionConditionSpec;
+    availability?: StepAvailabilitySpec;
+    xpReward?: number;
+    isRequired?: boolean;
+    canSkip?: boolean;
+    actionUrl?: string;
+    actionLabel?: string;
+    metadata?: Record<string, unknown>;
 }
-interface LearningJourneyTrackSpec {
-  id: string;
-  productId?: string;
-  name: string;
-  description?: string;
-  targetUserSegment?: string;
-  targetRole?: string;
-  totalXp?: number;
-  isActive?: boolean;
-  isRequired?: boolean;
-  canSkip?: boolean;
-  streakRule?: StreakRuleSpec;
-  completionRewards?: CompletionRewardsSpec;
-  steps: LearningJourneyStepSpec[];
-  metadata?: Record<string, unknown>;
+export interface LearningJourneyTrackSpec {
+    id: string;
+    productId?: string;
+    name: string;
+    description?: string;
+    targetUserSegment?: string;
+    targetRole?: string;
+    totalXp?: number;
+    isActive?: boolean;
+    isRequired?: boolean;
+    canSkip?: boolean;
+    streakRule?: StreakRuleSpec;
+    completionRewards?: CompletionRewardsSpec;
+    steps: LearningJourneyStepSpec[];
+    metadata?: Record<string, unknown>;
 }
-//#endregion
-export { BaseEventConditionSpec, CompletionRewardsSpec, CountCompletionConditionSpec, EventCompletionConditionSpec, LearningJourneyStepSpec, LearningJourneyTrackSpec, SrsMasteryCompletionConditionSpec, StepAvailabilitySpec, StepCompletionConditionSpec, StreakRuleSpec, TimeWindowCompletionConditionSpec };
 //# sourceMappingURL=track-spec.d.ts.map

package/dist/track-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"track-spec.d.ts","names":[],"sources":["../src/track-spec.ts"],"mappings":";UAAiB,sBAAA;EAAA;;;EAIf,SAAA;EAAA;;;EAIA,YAAA;EAQgB;;;EAJhB,YAAA;EAO4C;;;EAH5C,aAAA,GAAgB,MAAA;AAAA;AAAA,UAGD,4BAAA,SAAqC,sBAAA;EACpD,IAAA;AAAA;AAAA,UAGe,4BAAA,SAAqC,sBAAA;EACpD,IAAA;EAIA;;;EAAA,OAAA;EAOe;;;EAHf,WAAA;AAAA;AAAA,UAGe,iCAAA,SAA0C,sBAAA;EACzD,IAAA;EAQA;;;EAJA,kBAAA;EAOgD;;;EAHhD,mBAAA;AAAA;AAAA,UAGe,iCAAA;EACf,IAAA;EAgBA;;;EAZA,SAAA;EAoBsB;;AAGxB;EAnBE,YAAA;;;;EAIA,YAAA;EAmBE;;;EAfF,cAAA;EAaE;;;EATF,aAAA;EAWmC;AAErC;;EATE,aAAA,GAAgB,MAAA;AAAA;AAAA,KAGN,2BAAA,GACR,4BAAA,GACA,4BAAA,GACA,iCAAA,GACA,iCAAA;AAAA,UAEa,oBAAA;EAYf;;;EARA,gBAAA;EAW6B;;;EAP7B,WAAA;EAYe;;;EARf,cAAA;AAAA;AAAA,UAGe,cAAA;EACf,WAAA;EACA,OAAA;AAAA;AAAA,UAGe,qBAAA;EACf,OAAA;EACA,QAAA;AAAA;AAAA,UAGe,uBAAA;EACf,EAAA;EACA,KAAA;EACA,WAAA;EACA,YAAA;EACA,OAAA;EACA,KAAA;EACA,UAAA,EAAY,2BAAA;EACZ,YAAA,GAAe,oBAAA;EACf,QAAA;EACA,UAAA;EACA,OAAA;EACA,SAAA;EACA,WAAA;EACA,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,wBAAA;EACf,EAAA;EACA,SAAA;EACA,IAAA;EACA,WAAA;EACA,iBAAA;EACA,UAAA;EACA,OAAA;EACA,QAAA;EACA,UAAA;EACA,OAAA;EACA,UAAA,GAAa,cAAA;EACb,iBAAA,GAAoB,qBAAA;EACpB,KAAA,EAAO,uBAAA;EACP,QAAA,GAAW,MAAA;AAAA"}
+{"version":3,"file":"track-spec.d.ts","sourceRoot":"","sources":["../src/track-spec.ts"],"names":[],"mappings":"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"}

package/dist/track-spec.js

@@ -0,0 +1 @@
+// @bun