@contractspec/example.learning-journey-registry 1.57.0 → 1.58.0

package/dist/api.js

@@ -1,171 +1,271 @@
-import { learningJourneyTracks } from "./tracks.js";
-import { getLearnerTracks, getTrackResolver, initProgress } from "./progress-store.js";
+// @bun
+// src/tracks.ts
+import { crmLearningTracks } from "@contractspec/example.learning-journey-crm-onboarding/track";
+import { drillTracks } from "@contractspec/example.learning-journey-duo-drills/track";
+import { ambientCoachTracks } from "@contractspec/example.learning-journey-ambient-coach/track";
+import { questTracks } from "@contractspec/example.learning-journey-quest-challenges/track";
+import { platformLearningTracks } from "@contractspec/example.learning-journey-platform-tour/track";
+import { studioLearningTracks } from "@contractspec/example.learning-journey-studio-onboarding/track";
+var mapStep = (step) => ({
+  id: step.id,
+  title: step.title,
+  description: step.description,
+  completionEvent: step.completion.eventName,
+  completionCondition: step.completion,
+  xpReward: step.xpReward,
+  isRequired: step.isRequired,
+  canSkip: step.canSkip,
+  actionUrl: step.actionUrl,
+  actionLabel: step.actionLabel,
+  availability: step.availability,
+  metadata: step.metadata
+});
+var mapTrackSpecToDto = (track) => ({
+  id: track.id,
+  name: track.name,
+  description: track.description,
+  productId: track.productId,
+  targetUserSegment: track.targetUserSegment,
+  targetRole: track.targetRole,
+  totalXp: track.totalXp,
+  streakRule: track.streakRule,
+  completionRewards: track.completionRewards,
+  steps: track.steps.map(mapStep),
+  metadata: track.metadata
+});
+var learningJourneyTracks = [
+  ...studioLearningTracks,
+  ...platformLearningTracks,
+  ...crmLearningTracks,
+  ...drillTracks,
+  ...ambientCoachTracks,
+  ...questTracks
+];
+var onboardingTrackCatalog = learningJourneyTracks.map(mapTrackSpecToDto);
+// src/progress-store.ts
+var progressStore = new Map;
+var getTrackResolver = (tracks) => (trackId) => tracks.find((t) => t.id === trackId);
+var getLearnerTracks = (learnerId) => {
+  const existing = progressStore.get(learnerId);
+  if (existing)
+    return existing;
+  const map = new Map;
+  progressStore.set(learnerId, map);
+  return map;
+};
+var initProgress = (learnerId, track) => ({
+  learnerId,
+  trackId: track.id,
+  progress: 0,
+  isCompleted: false,
+  xpEarned: 0,
+  steps: track.steps.map((step) => ({
+    id: step.id,
+    status: "PENDING",
+    xpEarned: 0,
+    occurrences: 0,
+    masteryCount: 0
+  })),
+  startedAt: undefined,
+  completedAt: undefined,
+  lastActivityAt: undefined
+});
 
-//#region src/api.ts
-const getTrack = getTrackResolver(learningJourneyTracks);
-const matchesFilter = (filter, payload) => {
-	if (!filter) return true;
-	if (!payload) return false;
-	return Object.entries(filter).every(([key, value]) => payload[key] === value);
+// src/api.ts
+var getTrack = getTrackResolver(learningJourneyTracks);
+var matchesFilter = (filter, payload) => {
+  if (!filter)
+    return true;
+  if (!payload)
+    return false;
+  return Object.entries(filter).every(([key, value]) => payload[key] === value);
 };
-const matchesBaseEvent = (condition, event) => {
-	if (condition.eventName !== event.name) return false;
-	if (condition.eventVersion !== void 0 && event.version !== void 0) {
-		if (condition.eventVersion !== event.version) return false;
-	}
-	if (condition.sourceModule && event.sourceModule && condition.sourceModule !== event.sourceModule) return false;
-	return matchesFilter(condition.payloadFilter, event.payload);
+var matchesBaseEvent = (condition, event) => {
+  if (condition.eventName !== event.name)
+    return false;
+  if (condition.eventVersion !== undefined && event.version !== undefined) {
+    if (condition.eventVersion !== event.version)
+      return false;
+  }
+  if (condition.sourceModule && event.sourceModule && condition.sourceModule !== event.sourceModule) {
+    return false;
+  }
+  return matchesFilter(condition.payloadFilter, event.payload);
 };
-const matchesCondition = (condition, event, step, trackStartedAt) => {
-	if (condition.kind === "count") {
-		if (!matchesBaseEvent(condition, event)) return { matched: false };
-		const occurrences = (step.occurrences ?? 0) + 1;
-		return {
-			matched: (condition.withinHours === void 0 || Boolean(trackStartedAt && event.occurredAt && (event.occurredAt.getTime() - trackStartedAt.getTime()) / (1e3 * 60 * 60) <= condition.withinHours)) && occurrences >= condition.atLeast,
-			occurrences
-		};
-	}
-	if (condition.kind === "time_window") {
-		if (!matchesBaseEvent(condition, event)) return { matched: false };
-		if (condition.withinHoursOfStart !== void 0 && trackStartedAt && event.occurredAt) {
-			if ((event.occurredAt.getTime() - trackStartedAt.getTime()) / (1e3 * 60 * 60) > condition.withinHoursOfStart) return { matched: false };
-		}
-		return { matched: true };
-	}
-	if (condition.kind === "srs_mastery") {
-		if (event.name !== condition.eventName) return { matched: false };
-		const payload = event.payload;
-		if (!matchesFilter(condition.payloadFilter, payload)) return { matched: false };
-		const skillKey = condition.skillIdField ?? "skillId";
-		const masteryKey = condition.masteryField ?? "mastery";
-		const skillId = payload?.[skillKey];
-		const masteryValue = payload?.[masteryKey];
-		if (skillId === void 0 || masteryValue === void 0) return { matched: false };
-		if (typeof masteryValue !== "number") return { matched: false };
-		if (masteryValue < condition.minimumMastery) return { matched: false };
-		const masteryCount = (step.masteryCount ?? 0) + 1;
-		return {
-			matched: masteryCount >= (condition.requiredCount ?? 1),
-			masteryCount
-		};
-	}
-	return { matched: matchesBaseEvent(condition, event) };
+var matchesCondition = (condition, event, step, trackStartedAt) => {
+  if (condition.kind === "count") {
+    if (!matchesBaseEvent(condition, event))
+      return { matched: false };
+    const occurrences = (step.occurrences ?? 0) + 1;
+    const within = condition.withinHours === undefined || Boolean(trackStartedAt && event.occurredAt && (event.occurredAt.getTime() - trackStartedAt.getTime()) / (1000 * 60 * 60) <= condition.withinHours);
+    return { matched: within && occurrences >= condition.atLeast, occurrences };
+  }
+  if (condition.kind === "time_window") {
+    if (!matchesBaseEvent(condition, event))
+      return { matched: false };
+    if (condition.withinHoursOfStart !== undefined && trackStartedAt && event.occurredAt) {
+      const hoursSinceStart = (event.occurredAt.getTime() - trackStartedAt.getTime()) / (1000 * 60 * 60);
+      if (hoursSinceStart > condition.withinHoursOfStart) {
+        return { matched: false };
+      }
+    }
+    return { matched: true };
+  }
+  if (condition.kind === "srs_mastery") {
+    if (event.name !== condition.eventName)
+      return { matched: false };
+    const payload = event.payload;
+    if (!matchesFilter(condition.payloadFilter, payload)) {
+      return { matched: false };
+    }
+    const skillKey = condition.skillIdField ?? "skillId";
+    const masteryKey = condition.masteryField ?? "mastery";
+    const skillId = payload?.[skillKey];
+    const masteryValue = payload?.[masteryKey];
+    if (skillId === undefined || masteryValue === undefined) {
+      return { matched: false };
+    }
+    if (typeof masteryValue !== "number")
+      return { matched: false };
+    if (masteryValue < condition.minimumMastery)
+      return { matched: false };
+    const masteryCount = (step.masteryCount ?? 0) + 1;
+    const required = condition.requiredCount ?? 1;
+    return { matched: masteryCount >= required, masteryCount };
+  }
+  return { matched: matchesBaseEvent(condition, event) };
 };
-const getAvailability = (availability, startedAt) => {
-	if (!availability || !startedAt) return {};
-	const baseTime = startedAt.getTime();
-	let unlockTime = baseTime;
-	if (availability.unlockOnDay !== void 0) unlockTime = baseTime + (availability.unlockOnDay - 1) * 24 * 60 * 60 * 1e3;
-	if (availability.unlockAfterHours !== void 0) unlockTime = baseTime + availability.unlockAfterHours * 60 * 60 * 1e3;
-	const availableAt = new Date(unlockTime);
-	return {
-		availableAt,
-		dueAt: availability.dueWithinHours !== void 0 ? new Date(availableAt.getTime() + availability.dueWithinHours * 60 * 60 * 1e3) : void 0
-	};
+var getAvailability = (availability, startedAt) => {
+  if (!availability || !startedAt)
+    return {};
+  const baseTime = startedAt.getTime();
+  let unlockTime = baseTime;
+  if (availability.unlockOnDay !== undefined) {
+    unlockTime = baseTime + (availability.unlockOnDay - 1) * 24 * 60 * 60 * 1000;
+  }
+  if (availability.unlockAfterHours !== undefined) {
+    unlockTime = baseTime + availability.unlockAfterHours * 60 * 60 * 1000;
+  }
+  const availableAt = new Date(unlockTime);
+  const dueAt = availability.dueWithinHours !== undefined ? new Date(availableAt.getTime() + availability.dueWithinHours * 60 * 60 * 1000) : undefined;
+  return { availableAt, dueAt };
 };
-const computeProgressPercent = (steps) => {
-	const total = steps.length || 1;
-	const done = steps.filter((s) => s.status === "COMPLETED").length;
-	return Math.round(done / total * 100);
+var computeProgressPercent = (steps) => {
+  const total = steps.length || 1;
+  const done = steps.filter((s) => s.status === "COMPLETED").length;
+  return Math.round(done / total * 100);
 };
-const applyTrackCompletionBonuses = (track, progress) => {
-	if (progress.isCompleted) return progress;
-	const completedAt = /* @__PURE__ */ new Date();
-	const startedAt = progress.startedAt ?? completedAt;
-	const hoursElapsed = (completedAt.getTime() - startedAt.getTime()) / (1e3 * 60 * 60);
-	let xpEarned = progress.xpEarned;
-	const { completionRewards, streakRule } = track;
-	if (completionRewards?.xpBonus) xpEarned += completionRewards.xpBonus;
-	if (streakRule?.hoursWindow !== void 0 && hoursElapsed <= streakRule.hoursWindow && streakRule.bonusXp) xpEarned += streakRule.bonusXp;
-	return {
-		...progress,
-		xpEarned,
-		isCompleted: true,
-		completedAt,
-		lastActivityAt: completedAt
-	};
+var applyTrackCompletionBonuses = (track, progress) => {
+  if (progress.isCompleted)
+    return progress;
+  const completedAt = new Date;
+  const startedAt = progress.startedAt ?? completedAt;
+  const hoursElapsed = (completedAt.getTime() - startedAt.getTime()) / (1000 * 60 * 60);
+  let xpEarned = progress.xpEarned;
+  const { completionRewards, streakRule } = track;
+  if (completionRewards?.xpBonus) {
+    xpEarned += completionRewards.xpBonus;
+  }
+  if (streakRule?.hoursWindow !== undefined && hoursElapsed <= streakRule.hoursWindow && streakRule.bonusXp) {
+    xpEarned += streakRule.bonusXp;
+  }
+  return {
+    ...progress,
+    xpEarned,
+    isCompleted: true,
+    completedAt,
+    lastActivityAt: completedAt
+  };
 };
-const listTracks = (learnerId) => {
-	const progressMap = learnerId ? getLearnerTracks(learnerId) : void 0;
-	return {
-		tracks: learningJourneyTracks,
-		progress: learnerId && progressMap ? Array.from(progressMap.values()) : []
-	};
+var listTracks = (learnerId) => {
+  const progressMap = learnerId ? getLearnerTracks(learnerId) : undefined;
+  const progress = learnerId && progressMap ? Array.from(progressMap.values()) : [];
+  return {
+    tracks: learningJourneyTracks,
+    progress
+  };
 };
-const getProgress = (trackId, learnerId) => {
-	const track = getTrack(trackId);
-	if (!track) return void 0;
-	const map = getLearnerTracks(learnerId);
-	const existing = map.get(trackId) ?? initProgress(learnerId, track);
-	map.set(trackId, existing);
-	return existing;
+var getProgress = (trackId, learnerId) => {
+  const track = getTrack(trackId);
+  if (!track)
+    return;
+  const map = getLearnerTracks(learnerId);
+  const existing = map.get(trackId) ?? initProgress(learnerId, track);
+  map.set(trackId, existing);
+  return existing;
 };
-const recordEvent = (event) => {
-	const targets = event.trackId !== void 0 ? learningJourneyTracks.filter((t) => t.id === event.trackId) : learningJourneyTracks;
-	const updated = [];
-	const eventTime = event.occurredAt ?? /* @__PURE__ */ new Date();
-	for (const track of targets) {
-		const map = getLearnerTracks(event.learnerId);
-		const current = map.get(track.id) ?? initProgress(event.learnerId, track);
-		const startedAt = current.startedAt ?? eventTime;
-		let changed = current.startedAt === void 0;
-		const steps = current.steps.map((step) => {
-			if (step.status === "COMPLETED") return step;
-			const spec = track.steps.find((s) => s.id === step.id);
-			if (!spec) return step;
-			const { availableAt, dueAt } = getAvailability(spec.availability, startedAt);
-			if (availableAt && eventTime < availableAt) return {
-				...step,
-				availableAt,
-				dueAt
-			};
-			if (dueAt && eventTime > dueAt) return {
-				...step,
-				availableAt,
-				dueAt
-			};
-			const result = matchesCondition(spec.completion, event, step, startedAt);
-			if (result.matched) {
-				changed = true;
-				return {
-					...step,
-					status: "COMPLETED",
-					xpEarned: spec.xpReward ?? 0,
-					completedAt: eventTime,
-					triggeringEvent: event.name,
-					eventPayload: event.payload,
-					occurrences: result.occurrences ?? step.occurrences,
-					masteryCount: result.masteryCount ?? step.masteryCount,
-					availableAt,
-					dueAt
-				};
-			}
-			if (result.occurrences !== void 0 || result.masteryCount !== void 0) changed = true;
-			return {
-				...step,
-				occurrences: result.occurrences ?? step.occurrences,
-				masteryCount: result.masteryCount ?? step.masteryCount,
-				availableAt,
-				dueAt
-			};
-		});
-		if (!changed) continue;
-		const xpEarned = steps.reduce((sum, s) => sum + s.xpEarned, 0) + (track.totalXp ?? 0);
-		let progress = {
-			...current,
-			steps,
-			xpEarned,
-			startedAt,
-			lastActivityAt: eventTime,
-			progress: computeProgressPercent(steps)
-		};
-		if (steps.every((s) => s.status === "COMPLETED")) progress = applyTrackCompletionBonuses(track, progress);
-		map.set(track.id, progress);
-		updated.push(progress);
-	}
-	return updated;
+var recordEvent = (event) => {
+  const targets = event.trackId !== undefined ? learningJourneyTracks.filter((t) => t.id === event.trackId) : learningJourneyTracks;
+  const updated = [];
+  const eventTime = event.occurredAt ?? new Date;
+  for (const track of targets) {
+    const map = getLearnerTracks(event.learnerId);
+    const current = map.get(track.id) ?? initProgress(event.learnerId, track);
+    const startedAt = current.startedAt ?? eventTime;
+    let changed = current.startedAt === undefined;
+    const steps = current.steps.map((step) => {
+      if (step.status === "COMPLETED")
+        return step;
+      const spec = track.steps.find((s) => s.id === step.id);
+      if (!spec)
+        return step;
+      const { availableAt, dueAt } = getAvailability(spec.availability, startedAt);
+      if (availableAt && eventTime < availableAt) {
+        return { ...step, availableAt, dueAt };
+      }
+      if (dueAt && eventTime > dueAt) {
+        return { ...step, availableAt, dueAt };
+      }
+      const result = matchesCondition(spec.completion, event, step, startedAt);
+      if (result.matched) {
+        changed = true;
+        return {
+          ...step,
+          status: "COMPLETED",
+          xpEarned: spec.xpReward ?? 0,
+          completedAt: eventTime,
+          triggeringEvent: event.name,
+          eventPayload: event.payload,
+          occurrences: result.occurrences ?? step.occurrences,
+          masteryCount: result.masteryCount ?? step.masteryCount,
+          availableAt,
+          dueAt
+        };
+      }
+      if (result.occurrences !== undefined || result.masteryCount !== undefined) {
+        changed = true;
+      }
+      return {
+        ...step,
+        occurrences: result.occurrences ?? step.occurrences,
+        masteryCount: result.masteryCount ?? step.masteryCount,
+        availableAt,
+        dueAt
+      };
+    });
+    if (!changed) {
+      continue;
+    }
+    const xpEarned = steps.reduce((sum, s) => sum + s.xpEarned, 0) + (track.totalXp ?? 0);
+    let progress = {
+      ...current,
+      steps,
+      xpEarned,
+      startedAt,
+      lastActivityAt: eventTime,
+      progress: computeProgressPercent(steps)
+    };
+    const allDone = steps.every((s) => s.status === "COMPLETED");
+    if (allDone) {
+      progress = applyTrackCompletionBonuses(track, progress);
+    }
+    map.set(track.id, progress);
+    updated.push(progress);
+  }
+  return updated;
+};
+export {
+  recordEvent,
+  listTracks,
+  getProgress
 };
-
-//#endregion
-export { getProgress, listTracks, recordEvent };
-//# sourceMappingURL=api.js.map

package/dist/api.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.test.d.ts.map

package/dist/api.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.test.d.ts","sourceRoot":"","sources":["../src/api.test.ts"],"names":[],"mappings":""}