@lessonkit/core 1.3.1 → 1.4.0

package/dist/index.js

@@ -1,3 +1,33 @@
+import {
+  SESSION_STORAGE_KEY,
+  buildCourseStartedTelemetryEvent,
+  buildTelemetryEvent,
+  completeCourseWithTelemetry,
+  completeLessonWithTelemetry,
+  createDefaultClock,
+  createGlobalTimer,
+  createNoopStorage,
+  createSessionId,
+  createSessionStoragePort,
+  getTabSessionId,
+  hasCourseStarted,
+  hasCourseStartedEmittedToTracking,
+  hasCourseStartedPipelineDelivered,
+  isDevEnvironment,
+  markCourseStarted,
+  markCourseStartedEmittedToTracking,
+  markCourseStartedPipelineDelivered,
+  migrateCourseStartedMark,
+  nowIso,
+  resetSharedVolatileSessionIdForTests,
+  resetStoragePortForTests,
+  resetTelemetryBuilderWarningsForTests,
+  resolveSessionId,
+  tryBuildTelemetryEvent,
+  tryEmitCourseStarted,
+  warnDev
+} from "./chunk-PEWFPVQ6.js";
+
 // src/identityTypes.ts
 var ID_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/;
 var ID_MAX_LENGTH = 64;
@@ -184,16 +214,6 @@ function parseCompoundResumeState(raw) {
   };
 }
 
-// src/internal/env.ts
-function isDevEnvironment() {
-  const g = globalThis;
-  return typeof g.process !== "undefined" && g.process.env?.NODE_ENV !== "production";
-}
-function warnDev(message, err) {
-  if (!isDevEnvironment()) return;
-  console.warn(message, err instanceof Error ? err.message : err);
-}
-
 // src/compoundState.ts
 var COMPOUND_STATE_PREFIX = "lessonkit:compound:";
 function compoundStateStorageKey(courseId, compoundId) {
@@ -224,10 +244,23 @@ function clearCompoundState(storage, courseId, compoundId) {
 }
 
 // src/compoundAllowlists.ts
+var PAGE_AND_SLIDE_14_BLOCKS = [
+  "Video",
+  "Summary",
+  "ImagePairing",
+  "ImageSequencing",
+  "MemoryGame",
+  "InformationWall",
+  "ParallaxSlideshow",
+  "Questionnaire",
+  "Essay",
+  "ArithmeticQuiz"
+];
 var PAGE_ALLOWED_CHILD_TYPES = [
   "Text",
   "Heading",
   "Image",
+  "Video",
   "Scenario",
   "Reflection",
   "Quiz",
@@ -237,6 +270,15 @@ var PAGE_ALLOWED_CHILD_TYPES = [
   "DragAndDrop",
   "DragTheWords",
   "MarkTheWords",
+  "Summary",
+  "ImagePairing",
+  "ImageSequencing",
+  "MemoryGame",
+  "InformationWall",
+  "ParallaxSlideshow",
+  "Questionnaire",
+  "Essay",
+  "ArithmeticQuiz",
   "Accordion",
   "DialogCards",
   "Flashcards",
@@ -251,6 +293,7 @@ var SLIDE_ALLOWED_CHILD_TYPES = [
   "Text",
   "Heading",
   "Image",
+  "Video",
   "Scenario",
   "Reflection",
   "Quiz",
@@ -260,6 +303,15 @@ var SLIDE_ALLOWED_CHILD_TYPES = [
   "DragAndDrop",
   "DragTheWords",
   "MarkTheWords",
+  "Summary",
+  "ImagePairing",
+  "ImageSequencing",
+  "MemoryGame",
+  "InformationWall",
+  "ParallaxSlideshow",
+  "Questionnaire",
+  "Essay",
+  "ArithmeticQuiz",
   "Accordion",
   "DialogCards",
   "Flashcards",
@@ -269,6 +321,22 @@ var SLIDE_ALLOWED_CHILD_TYPES = [
   "ImageSlider"
 ];
 var SLIDE_DECK_ALLOWED_CHILD_TYPES = ["Slide"];
+var TIMED_CUE_ALLOWED_CHILD_TYPES = [
+  "Text",
+  "Heading",
+  "Image",
+  "Quiz",
+  "TrueFalse",
+  "FillInTheBlanks",
+  "Summary",
+  "ImagePairing",
+  "ImageSequencing",
+  "MemoryGame",
+  "Questionnaire",
+  "Essay",
+  "ArithmeticQuiz"
+];
+var INTERACTIVE_VIDEO_ALLOWED_CHILD_TYPES = ["TimedCue"];
 var ASSESSMENT_SEQUENCE_ALLOWED_CHILD_TYPES = [
   "TrueFalse",
   "FillInTheBlanks",
@@ -278,13 +346,20 @@ var ASSESSMENT_SEQUENCE_ALLOWED_CHILD_TYPES = [
   "Quiz",
   "KnowledgeCheck",
   "FindHotspot",
-  "FindMultipleHotspots"
+  "FindMultipleHotspots",
+  "Summary",
+  "ImagePairing",
+  "ImageSequencing",
+  "ArithmeticQuiz",
+  "Essay"
 ];
 var ALLOWLISTS = {
   Page: PAGE_ALLOWED_CHILD_TYPES,
   InteractiveBook: INTERACTIVE_BOOK_ALLOWED_CHILD_TYPES,
   Slide: SLIDE_ALLOWED_CHILD_TYPES,
   SlideDeck: SLIDE_DECK_ALLOWED_CHILD_TYPES,
+  TimedCue: TIMED_CUE_ALLOWED_CHILD_TYPES,
+  InteractiveVideo: INTERACTIVE_VIDEO_ALLOWED_CHILD_TYPES,
   AssessmentSequence: ASSESSMENT_SEQUENCE_ALLOWED_CHILD_TYPES
 };
 var COMPOUND_MAX_NESTING_DEPTH = {
@@ -292,6 +367,8 @@ var COMPOUND_MAX_NESTING_DEPTH = {
   InteractiveBook: 2,
   Slide: 1,
   SlideDeck: 2,
+  TimedCue: 1,
+  InteractiveVideo: 2,
   AssessmentSequence: 1
 };
 function getAllowedChildTypes(parent) {
@@ -301,6 +378,7 @@ function isChildTypeAllowed(parent, childType) {
   return ALLOWLISTS[parent].includes(childType);
 }
 var ACCORDION_FORBIDDEN_CHILD_TYPES = ["Accordion"];
+var BLOCKS_14_PAGE_SLIDE = PAGE_AND_SLIDE_14_BLOCKS;
 
 // src/telemetryCatalog.ts
 var telemetryCatalogVersion = 1;
@@ -456,6 +534,54 @@ var TELEMETRY_EVENT_CATALOG_V3 = [
     dataFields: ["blockId", "slideIndex"],
     xapiVerb: "http://adlnet.gov/expapi/verbs/experienced",
     urnPattern: "urn:lessonkit:course:{courseId}:lesson:{lessonId}:block:{blockId}"
+  },
+  {
+    name: "video_cue_reached",
+    description: "Learner reached a timed cue in an Interactive Video",
+    requiredFields: ["courseId", "lessonId", "sessionId", "timestamp"],
+    dataFields: ["blockId", "cueIndex", "atSeconds", "cueLabel"],
+    xapiVerb: "http://adlnet.gov/expapi/verbs/experienced",
+    urnPattern: "urn:lessonkit:course:{courseId}:lesson:{lessonId}:block:{blockId}"
+  },
+  {
+    name: "video_segment_completed",
+    description: "Learner completed a timed segment in an Interactive Video",
+    requiredFields: ["courseId", "lessonId", "sessionId", "timestamp"],
+    dataFields: ["blockId", "segmentIndex", "atSeconds", "segmentLabel"],
+    xapiVerb: "http://adlnet.gov/expapi/verbs/completed",
+    urnPattern: "urn:lessonkit:course:{courseId}:lesson:{lessonId}:block:{blockId}"
+  },
+  {
+    name: "memory_card_flipped",
+    description: "Learner flipped a memory game card",
+    requiredFields: ["courseId", "sessionId", "timestamp"],
+    dataFields: ["blockId", "cardIndex", "face"],
+    xapiVerb: "http://adlnet.gov/expapi/verbs/experienced",
+    urnPattern: "urn:lessonkit:course:{courseId}:lesson:{lessonId}:block:{blockId}"
+  },
+  {
+    name: "information_wall_search",
+    description: "Learner searched an information wall",
+    requiredFields: ["courseId", "sessionId", "timestamp"],
+    dataFields: ["blockId", "query", "resultCount"],
+    xapiVerb: "http://adlnet.gov/expapi/verbs/experienced",
+    urnPattern: "urn:lessonkit:course:{courseId}:lesson:{lessonId}:block:{blockId}"
+  },
+  {
+    name: "parallax_slide_viewed",
+    description: "Learner viewed a slide in a parallax slideshow",
+    requiredFields: ["courseId", "sessionId", "timestamp"],
+    dataFields: ["blockId", "slideIndex"],
+    xapiVerb: "http://adlnet.gov/expapi/verbs/experienced",
+    urnPattern: "urn:lessonkit:course:{courseId}:lesson:{lessonId}:block:{blockId}"
+  },
+  {
+    name: "questionnaire_submitted",
+    description: "Learner submitted an unscored questionnaire",
+    requiredFields: ["courseId", "lessonId", "sessionId", "timestamp"],
+    dataFields: ["blockId", "fieldCount"],
+    xapiVerb: "http://adlnet.gov/expapi/verbs/completed",
+    urnPattern: "urn:lessonkit:course:{courseId}:lesson:{lessonId}:block:{blockId}"
   }
 ];
 function buildTelemetryCatalogV3() {
@@ -463,6 +589,18 @@ function buildTelemetryCatalogV3() {
 }
 
 // src/internal/sinkInvoke.ts
+async function invokeTrackingSinkWithResult(sink, event) {
+  try {
+    const result = sink(event);
+    if (result != null && typeof result.then === "function") {
+      await result;
+    }
+    return true;
+  } catch (err) {
+    warnDev("[lessonkit] tracking sink failed:", err);
+    return false;
+  }
+}
 function invokeTrackingSink(sink, event) {
   let result;
   try {
@@ -509,7 +647,17 @@ function createTrackingClient(opts) {
     return {
       track: (event) => {
         if (disposed2) return;
-        if (sink) invokeTrackingSink(sink, event);
+        if (sink) {
+          try {
+            invokeTrackingSink(sink, event);
+          } catch {
+          }
+        }
+      },
+      deliver: async (event) => {
+        if (disposed2) return false;
+        if (!sink) return true;
+        return invokeTrackingSinkWithResult(sink, event);
       },
       dispose: () => {
         disposed2 = true;
@@ -586,21 +734,26 @@ function createTrackingClient(opts) {
   };
   intervalId = flushIntervalMs > 0 ? globalThis.setInterval(() => void flush(), flushIntervalMs) : void 0;
   intervalId?.unref?.();
-  return {
-    track: (event) => {
-      if (disposed || disposing) return;
-      if (buffer.length >= maxBufferSize) {
-        opts?.onBufferDrop?.();
-        if (!warnedBufferCap && isDevEnvironment()) {
-          warnedBufferCap = true;
-          console.warn(
-            `[lessonkit] telemetry batch buffer capped at ${maxBufferSize} events; new events are dropped until the buffer drains.`
-          );
-        }
-        return;
+  const track = (event) => {
+    if (disposed || disposing) return;
+    if (buffer.length >= maxBufferSize) {
+      opts?.onBufferDrop?.();
+      if (!warnedBufferCap && isDevEnvironment()) {
+        warnedBufferCap = true;
+        console.warn(
+          `[lessonkit] telemetry batch buffer capped at ${maxBufferSize} events; new events are dropped until the buffer drains.`
+        );
       }
-      buffer.push(event);
-      if (buffer.length >= maxBatchSize) void flush();
+      return;
+    }
+    buffer.push(event);
+    if (buffer.length >= maxBatchSize) void flush();
+  };
+  return {
+    track,
+    deliver: async (event) => {
+      track(event);
+      return flush();
     },
     flush,
     flushOnExit: opts?.exitBatchSink ? () => {
@@ -634,266 +787,6 @@ function createTrackingClient(opts) {
   };
 }
 
-// src/ids.ts
-function createSessionId() {
-  const g = globalThis;
-  if (g.crypto?.randomUUID) return g.crypto.randomUUID();
-  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 11)}`;
-}
-
-// src/time.ts
-function nowIso() {
-  return (/* @__PURE__ */ new Date()).toISOString();
-}
-
-// src/telemetry/eventRegistry.ts
-function resolveLessonId(opts, eventName) {
-  const lessonId = opts.lessonId ?? opts.data?.lessonId;
-  if (!lessonId) throw new Error(`${eventName} requires lessonId`);
-  return lessonId;
-}
-function withLessonScopedData(name, base, lessonId, data) {
-  return { name, ...base, lessonId, data: { ...data, lessonId } };
-}
-var TELEMETRY_EVENT_REGISTRY = {
-  course_started: {
-    build: (_opts, base) => ({ name: "course_started", ...base })
-  },
-  course_completed: {
-    build: (_opts, base) => ({ name: "course_completed", ...base })
-  },
-  lesson_started: {
-    requiresLessonId: true,
-    build: (opts, base) => {
-      if (opts.name !== "lesson_started") throw new Error("unexpected event");
-      const lessonId = resolveLessonId(opts, "lesson_started");
-      return withLessonScopedData("lesson_started", base, lessonId, opts.data);
-    }
-  },
-  lesson_completed: {
-    requiresLessonId: true,
-    build: (opts, base) => {
-      if (opts.name !== "lesson_completed") throw new Error("unexpected event");
-      const lessonId = resolveLessonId(opts, opts.name);
-      return withLessonScopedData(opts.name, base, lessonId, opts.data);
-    }
-  },
-  lesson_time_on_task: {
-    requiresLessonId: true,
-    build: (opts, base) => {
-      if (opts.name !== "lesson_time_on_task") throw new Error("unexpected event");
-      const lessonId = resolveLessonId(opts, opts.name);
-      return withLessonScopedData(opts.name, base, lessonId, opts.data);
-    }
-  },
-  quiz_answered: {
-    requiresLessonId: true,
-    tryBuildMissingLessonWarning: "quiz",
-    build: (opts, base) => {
-      if (opts.name !== "quiz_answered") throw new Error("unexpected event");
-      const lessonId = opts.lessonId;
-      if (!lessonId) throw new Error("quiz_answered requires active lessonId");
-      return {
-        name: "quiz_answered",
-        ...base,
-        lessonId,
-        data: opts.data
-      };
-    }
-  },
-  quiz_completed: {
-    requiresLessonId: true,
-    tryBuildMissingLessonWarning: "quiz",
-    build: (opts, base) => {
-      if (opts.name !== "quiz_completed") throw new Error("unexpected event");
-      const lessonId = opts.lessonId;
-      if (!lessonId) throw new Error("quiz_completed requires active lessonId");
-      return {
-        name: "quiz_completed",
-        ...base,
-        lessonId,
-        data: opts.data
-      };
-    }
-  },
-  assessment_answered: {
-    requiresLessonId: true,
-    tryBuildMissingLessonWarning: "assessment",
-    build: (opts, base) => {
-      if (opts.name !== "assessment_answered") throw new Error("unexpected event");
-      const lessonId = opts.lessonId;
-      if (!lessonId) throw new Error("assessment_answered requires active lessonId");
-      return {
-        name: "assessment_answered",
-        ...base,
-        lessonId,
-        data: opts.data
-      };
-    }
-  },
-  assessment_completed: {
-    requiresLessonId: true,
-    tryBuildMissingLessonWarning: "assessment",
-    build: (opts, base) => {
-      if (opts.name !== "assessment_completed") throw new Error("unexpected event");
-      const lessonId = opts.lessonId;
-      if (!lessonId) throw new Error("assessment_completed requires active lessonId");
-      return {
-        name: "assessment_completed",
-        ...base,
-        lessonId,
-        data: opts.data
-      };
-    }
-  },
-  interaction: {
-    build: (opts, base) => {
-      if (opts.name !== "interaction") throw new Error("unexpected event");
-      return {
-        name: "interaction",
-        ...base,
-        lessonId: opts.lessonId,
-        data: opts.data
-      };
-    }
-  },
-  book_page_viewed: {
-    requiresLessonId: true,
-    build: (opts, base) => {
-      if (opts.name !== "book_page_viewed") throw new Error("unexpected event");
-      const lessonId = opts.lessonId;
-      if (!lessonId) throw new Error("book_page_viewed requires active lessonId");
-      return {
-        name: "book_page_viewed",
-        ...base,
-        lessonId,
-        data: opts.data
-      };
-    }
-  },
-  slide_viewed: {
-    requiresLessonId: true,
-    build: (opts, base) => {
-      if (opts.name !== "slide_viewed") throw new Error("unexpected event");
-      const lessonId = opts.lessonId;
-      if (!lessonId) throw new Error("slide_viewed requires active lessonId");
-      return {
-        name: "slide_viewed",
-        ...base,
-        lessonId,
-        data: opts.data
-      };
-    }
-  },
-  compound_page_viewed: {
-    requiresLessonId: true,
-    build: (opts, base) => {
-      if (opts.name !== "compound_page_viewed") throw new Error("unexpected event");
-      const lessonId = opts.lessonId;
-      if (!lessonId) throw new Error("compound_page_viewed requires active lessonId");
-      return {
-        name: "compound_page_viewed",
-        ...base,
-        lessonId,
-        data: opts.data
-      };
-    }
-  },
-  hotspot_opened: {
-    build: (opts, base) => {
-      if (opts.name !== "hotspot_opened") throw new Error("unexpected event");
-      return {
-        name: "hotspot_opened",
-        ...base,
-        lessonId: opts.lessonId,
-        data: opts.data
-      };
-    }
-  },
-  accordion_section_toggled: {
-    build: (opts, base) => {
-      if (opts.name !== "accordion_section_toggled") throw new Error("unexpected event");
-      return {
-        name: "accordion_section_toggled",
-        ...base,
-        lessonId: opts.lessonId,
-        data: opts.data
-      };
-    }
-  },
-  flashcard_flipped: {
-    build: (opts, base) => {
-      if (opts.name !== "flashcard_flipped") throw new Error("unexpected event");
-      return {
-        name: "flashcard_flipped",
-        ...base,
-        lessonId: opts.lessonId,
-        data: opts.data
-      };
-    }
-  },
-  image_slider_changed: {
-    build: (opts, base) => {
-      if (opts.name !== "image_slider_changed") throw new Error("unexpected event");
-      return {
-        name: "image_slider_changed",
-        ...base,
-        lessonId: opts.lessonId,
-        data: opts.data
-      };
-    }
-  }
-};
-function buildTelemetryEventFromRegistry(opts) {
-  const entry = TELEMETRY_EVENT_REGISTRY[opts.name];
-  if (!entry) {
-    throw new Error("Unexpected value");
-  }
-  const base = {
-    timestamp: opts.timestamp ?? nowIso(),
-    courseId: opts.courseId,
-    sessionId: opts.sessionId,
-    attemptId: opts.attemptId,
-    user: opts.user
-  };
-  return entry.build(opts, base);
-}
-function getTelemetryEventRegistryEntry(name) {
-  return TELEMETRY_EVENT_REGISTRY[name];
-}
-
-// src/telemetryBuilder.ts
-var warnedMissingQuizLesson = false;
-var warnedMissingAssessmentLesson = false;
-function resetTelemetryBuilderWarningsForTests() {
-  warnedMissingQuizLesson = false;
-  warnedMissingAssessmentLesson = false;
-}
-function buildTelemetryEvent(opts) {
-  return buildTelemetryEventFromRegistry(opts);
-}
-function tryBuildTelemetryEvent(opts) {
-  const entry = getTelemetryEventRegistryEntry(opts.name);
-  if (entry.requiresLessonId && !opts.lessonId && entry.tryBuildMissingLessonWarning) {
-    if (isDevEnvironment()) {
-      if (entry.tryBuildMissingLessonWarning === "quiz" && !warnedMissingQuizLesson) {
-        warnedMissingQuizLesson = true;
-        console.warn(
-          `[lessonkit] ${opts.name} skipped: wrap <Quiz> in <Lesson> so an active lessonId is available`
-        );
-      }
-      if (entry.tryBuildMissingLessonWarning === "assessment" && !warnedMissingAssessmentLesson) {
-        warnedMissingAssessmentLesson = true;
-        console.warn(
-          `[lessonkit] ${opts.name} skipped: wrap assessment blocks in <Lesson> so an active lessonId is available`
-        );
-      }
-    }
-    return null;
-  }
-  return buildTelemetryEvent(opts);
-}
-
 // src/telemetryPipeline.ts
 function invokeSink(sink, event, emitCtx) {
   invokePipelineSink(sink.id, () => sink.emit(event, emitCtx));
@@ -923,109 +816,6 @@ function createTrackingPipelineSink(id, track) {
   };
 }
 
-// src/ports.ts
-function createDefaultClock() {
-  return {
-    nowMs: () => Date.now(),
-    nowIso: () => (/* @__PURE__ */ new Date()).toISOString()
-  };
-}
-function createNoopStorage() {
-  return {
-    getItem: () => null,
-    setItem: () => true
-  };
-}
-function createMemoryBackedSessionStorage(session) {
-  const memory = /* @__PURE__ */ new Map();
-  let warnedPersistFailure = false;
-  const warnPersistFailure = () => {
-    if (warnedPersistFailure) return;
-    warnedPersistFailure = true;
-    const g = globalThis;
-    if (typeof g.process !== "undefined" && g.process.env?.NODE_ENV === "development") {
-      console.warn(
-        "[lessonkit] sessionStorage is unavailable or failed; using in-memory session dedupe for this tab (may reset on full reload)."
-      );
-    }
-  };
-  return {
-    getItem: (key) => {
-      if (memory.has(key)) return memory.get(key);
-      try {
-        const value = session.getItem(key);
-        if (value !== null) memory.set(key, value);
-        return value;
-      } catch {
-        return memory.get(key) ?? null;
-      }
-    },
-    setItem: (key, value) => {
-      memory.set(key, value);
-      try {
-        session.setItem(key, value);
-        return true;
-      } catch {
-        warnPersistFailure();
-        return false;
-      }
-    },
-    removeItem: (key) => {
-      memory.delete(key);
-      try {
-        session.removeItem(key);
-      } catch {
-        warnPersistFailure();
-      }
-    },
-    resetForTests: () => {
-      memory.clear();
-    }
-  };
-}
-function resetStoragePortForTests(storage) {
-  storage.resetForTests?.();
-}
-function createInMemorySessionStoragePort() {
-  const memory = /* @__PURE__ */ new Map();
-  return {
-    getItem: (key) => memory.get(key) ?? null,
-    setItem: (key, value) => {
-      memory.set(key, value);
-      return true;
-    },
-    removeItem: (key) => {
-      memory.delete(key);
-    },
-    resetForTests: () => {
-      memory.clear();
-    }
-  };
-}
-function resolveBrowserSessionStorage() {
-  try {
-    if (typeof sessionStorage === "undefined" || sessionStorage == null) {
-      return null;
-    }
-    return sessionStorage;
-  } catch {
-    return null;
-  }
-}
-function createSessionStoragePort() {
-  const session = resolveBrowserSessionStorage();
-  if (!session) {
-    return createInMemorySessionStoragePort();
-  }
-  return createMemoryBackedSessionStorage(session);
-}
-function createGlobalTimer() {
-  return {
-    setInterval: (fn, ms) => globalThis.setInterval(fn, ms),
-    clearInterval: (id) => globalThis.clearInterval(id)
-  };
-}
-
 // src/progress.ts
 function createProgressController() {
   let activeLessonId;
@@ -1068,153 +858,6 @@ function createProgressController() {
   };
 }
 
-// src/session.ts
-var SESSION_STORAGE_KEY = "lessonkit:sessionId";
-var volatileSessionIds = /* @__PURE__ */ new WeakMap();
-var sharedVolatileSessionId = null;
-function isDevEnvironment2() {
-  const g = globalThis;
-  return typeof g.process !== "undefined" && g.process.env?.NODE_ENV !== "production";
-}
-function getTabSessionId(storage) {
-  return storage.getItem(SESSION_STORAGE_KEY);
-}
-var COURSE_STARTED_PREFIX = "lessonkit:course_started:";
-var COURSE_STARTED_TRACKING_PREFIX = "lessonkit:course_started_tracking:";
-var COURSE_STARTED_PIPELINE_PREFIX = "lessonkit:course_started_pipeline:";
-function resolveSessionId(storage, provided) {
-  if (provided !== void 0) {
-    const trimmed = provided.trim();
-    if (trimmed.length > 0) return trimmed;
-  }
-  const existing = storage.getItem(SESSION_STORAGE_KEY);
-  if (existing) return existing;
-  const volatile = volatileSessionIds.get(storage);
-  if (volatile) return volatile;
-  const id = createSessionId();
-  const persisted = storage.setItem(SESSION_STORAGE_KEY, id);
-  if (!persisted) {
-    if (!sharedVolatileSessionId) {
-      sharedVolatileSessionId = id;
-    }
-    volatileSessionIds.set(storage, sharedVolatileSessionId);
-    if (isDevEnvironment2()) {
-      console.warn(
-        "[lessonkit] session id could not be persisted; reusing in-memory id for this tab."
-      );
-    }
-    return sharedVolatileSessionId;
-  }
-  return id;
-}
-function courseStartedStorageKey(sessionId, courseId) {
-  return `${COURSE_STARTED_PREFIX}${sessionId}:${courseId ?? ""}`;
-}
-function courseStartedTrackingStorageKey(sessionId, courseId) {
-  return `${COURSE_STARTED_TRACKING_PREFIX}${sessionId}:${courseId ?? ""}`;
-}
-function courseStartedPipelineStorageKey(sessionId, courseId) {
-  return `${COURSE_STARTED_PIPELINE_PREFIX}${sessionId}:${courseId ?? ""}`;
-}
-function hasCourseStarted(storage, sessionId, courseId) {
-  if (!courseId) return false;
-  return storage.getItem(courseStartedStorageKey(sessionId, courseId)) === "1";
-}
-function markCourseStarted(storage, sessionId, courseId) {
-  if (!courseId) return false;
-  return storage.setItem(courseStartedStorageKey(sessionId, courseId), "1");
-}
-function hasCourseStartedEmittedToTracking(storage, sessionId, courseId) {
-  if (!courseId) return false;
-  return storage.getItem(courseStartedTrackingStorageKey(sessionId, courseId)) === "1";
-}
-function markCourseStartedEmittedToTracking(storage, sessionId, courseId) {
-  if (!courseId) return false;
-  return storage.setItem(courseStartedTrackingStorageKey(sessionId, courseId), "1");
-}
-function hasCourseStartedPipelineDelivered(storage, sessionId, courseId) {
-  if (!courseId) return false;
-  return storage.getItem(courseStartedPipelineStorageKey(sessionId, courseId)) === "1";
-}
-function markCourseStartedPipelineDelivered(storage, sessionId, courseId) {
-  if (!courseId) return false;
-  return storage.setItem(courseStartedPipelineStorageKey(sessionId, courseId), "1");
-}
-function resetSharedVolatileSessionIdForTests() {
-  sharedVolatileSessionId = null;
-}
-function migrateCourseStartedMark(storage, fromSessionId, toSessionId, courseId) {
-  if (!courseId || fromSessionId === toSessionId) return;
-  if (hasCourseStarted(storage, fromSessionId, courseId)) {
-    markCourseStarted(storage, toSessionId, courseId);
-    storage.removeItem?.(courseStartedStorageKey(fromSessionId, courseId));
-  }
-  if (hasCourseStartedEmittedToTracking(storage, fromSessionId, courseId)) {
-    markCourseStartedEmittedToTracking(storage, toSessionId, courseId);
-    storage.removeItem?.(courseStartedTrackingStorageKey(fromSessionId, courseId));
-  }
-  if (hasCourseStartedPipelineDelivered(storage, fromSessionId, courseId)) {
-    markCourseStartedPipelineDelivered(storage, toSessionId, courseId);
-    storage.removeItem?.(courseStartedPipelineStorageKey(fromSessionId, courseId));
-  }
-}
-
-// src/runtime/courseLifecycle.ts
-var courseStartedEmitFlights = /* @__PURE__ */ new Set();
-function tryEmitCourseStarted(ctx, deps, alreadyEmittedToSink) {
-  const flightKey = `${ctx.sessionId}:${ctx.courseId}`;
-  const marked = hasCourseStarted(ctx.storage, ctx.sessionId, ctx.courseId);
-  if (alreadyEmittedToSink) {
-    return { emitted: true, marked };
-  }
-  if (courseStartedEmitFlights.has(flightKey)) {
-    return { emitted: false, marked };
-  }
-  courseStartedEmitFlights.add(flightKey);
-  try {
-    const emitted = deps.emitCourseStartedEvent(ctx);
-    if (emitted && !marked) {
-      markCourseStarted(ctx.storage, ctx.sessionId, ctx.courseId);
-    }
-    return {
-      emitted,
-      marked: hasCourseStarted(ctx.storage, ctx.sessionId, ctx.courseId)
-    };
-  } finally {
-    courseStartedEmitFlights.delete(flightKey);
-  }
-}
-function buildCourseStartedTelemetryEvent(ctx) {
-  return buildTelemetryEvent({
-    name: "course_started",
-    courseId: ctx.courseId,
-    sessionId: ctx.sessionId,
-    attemptId: ctx.attemptId,
-    user: ctx.user
-  });
-}
-function completeLessonWithTelemetry(opts) {
-  const result = opts.progress.completeLesson(opts.lessonId, opts.nowMs);
-  if (!result.didComplete) return false;
-  opts.emitLessonCompleted(opts.lessonId, result.durationMs);
-  return true;
-}
-function completeCourseWithTelemetry(opts) {
-  const current = opts.progress.getState();
-  if (current.activeLessonId) {
-    completeLessonWithTelemetry({
-      progress: opts.progress,
-      lessonId: current.activeLessonId,
-      nowMs: opts.nowMs,
-      emitLessonCompleted: opts.emitLessonCompleted
-    });
-  }
-  const result = opts.progress.completeCourse();
-  if (!result.didComplete) return false;
-  opts.emitCourseCompleted();
-  return true;
-}
-
 // src/plugins/context.ts
 function buildPluginContext(opts) {
   return {
@@ -1420,11 +1063,13 @@ function createLessonkitRuntime(config, ports = {}) {
       if (next.courseId !== void 0 && next.courseId !== previousCourseId) {
         progress = createProgressController();
       }
-      if (next.plugins !== void 0 && next.plugins !== pluginHost) {
+      if (next.plugins !== void 0 && next.plugins !== configSnapshot.plugins) {
         pluginHost?.disposeAll();
         configSnapshot.plugins = next.plugins;
         pluginHost = resolvePluginHost(configSnapshot.plugins);
-        pluginHost?.setupAll(getPluginCtx());
+        if (!configSnapshot.deferPluginSetup) {
+          pluginHost?.setupAll(getPluginCtx());
+        }
       } else if (next.session !== void 0 && sessionKeyBefore !== sessionKeyAfter && pluginHost && !configSnapshot.deferPluginSetup) {
         pluginHost.disposeAll();
         pluginHost.setupAll(getPluginCtx());
@@ -1434,17 +1079,17 @@ function createLessonkitRuntime(config, ports = {}) {
       const wrapped = wrapEmitFn(emitFn);
       const current = progress.getState();
       if (current.activeLessonId === lessonId) return;
-      if (current.completedLessonIds.has(lessonId)) {
-        progress.setActiveLesson(lessonId, clock.nowMs());
-        return;
-      }
       const previous = current.activeLessonId;
-      if (previous && previous !== lessonId) {
+      if (previous && previous !== lessonId && !current.completedLessonIds.has(previous)) {
         const completed = progress.completeLesson(previous, clock.nowMs());
         if (completed.didComplete) {
           emitLessonCompletedEvents(previous, completed.durationMs, wrapped);
         }
       }
+      if (current.completedLessonIds.has(lessonId)) {
+        progress.setActiveLesson(lessonId, clock.nowMs());
+        return;
+      }
       progress.setActiveLesson(lessonId, clock.nowMs());
       wrapped("lesson_started", { lessonId }, lessonId);
     },
@@ -1465,9 +1110,12 @@ function createLessonkitRuntime(config, ports = {}) {
       });
     },
     track,
-    scoreAssessment(input, _lessonId) {
+    scoreAssessment(input, lessonId) {
       if (!pluginHost) return null;
-      return pluginHost.scoreAssessment(input, getPluginCtx());
+      return pluginHost.scoreAssessment(
+        { ...input, lessonId: input.lessonId ?? lessonId },
+        getPluginCtx()
+      );
     },
     resetForCourseChange(nextCourseId) {
       configSnapshot.courseId = nextCourseId;
@@ -1493,11 +1141,13 @@ function defineLifecyclePlugin(plugin) {
 export {
   ACCORDION_FORBIDDEN_CHILD_TYPES,
   ASSESSMENT_SEQUENCE_ALLOWED_CHILD_TYPES,
+  BLOCKS_14_PAGE_SLIDE,
   COMPOUND_MAX_NESTING_DEPTH,
   COMPOUND_RESUME_SCHEMA_VERSION,
   ID_MAX_LENGTH,
   ID_PATTERN,
   INTERACTIVE_BOOK_ALLOWED_CHILD_TYPES,
+  INTERACTIVE_VIDEO_ALLOWED_CHILD_TYPES,
   PAGE_ALLOWED_CHILD_TYPES,
   SESSION_STORAGE_KEY,
   SLIDE_ALLOWED_CHILD_TYPES,
@@ -1505,6 +1155,7 @@ export {
   TELEMETRY_EVENT_CATALOG,
   TELEMETRY_EVENT_CATALOG_V2,
   TELEMETRY_EVENT_CATALOG_V3,
+  TIMED_CUE_ALLOWED_CHILD_TYPES,
   assertNever,
   assertValidId,
   buildCourseStartedTelemetryEvent,