@lessonkit/react 0.9.1 → 0.9.3

package/README.md

@@ -59,7 +59,7 @@ export default function App() {
 }
 ```
 
-## API (0.9.1)
+## API (0.9.3)
 
 ### Block catalog
 

package/dist/index.cjs

@@ -369,9 +369,15 @@ function createTrackingClientFromConfig(config) {
     batch: config.tracking?.batch
   });
 }
-function disposeTrackingClient(client) {
-  client?.flush?.();
-  client?.dispose?.();
+async function disposeTrackingClient(client) {
+  try {
+    await client?.flush?.();
+  } catch {
+  }
+  try {
+    await client?.dispose?.();
+  } catch {
+  }
 }
 
 // src/context.tsx
@@ -382,6 +388,33 @@ var defaultStorage = createSessionStoragePort();
 function isTrackingActive(tracking) {
   return tracking?.enabled !== false;
 }
+function emitCourseStarted(opts) {
+  const pluginCtx = buildPluginContext({
+    courseId: opts.courseId,
+    sessionId: opts.sessionId,
+    attemptId: opts.attemptId
+  });
+  try {
+    emitTelemetryWithPlugins({
+      pluginHost: opts.pluginHost,
+      tracking: opts.tracking,
+      xapi: opts.xapi,
+      event: buildTrackEvent({
+        name: "course_started",
+        courseId: opts.courseId,
+        sessionId: opts.sessionId,
+        attemptId: opts.attemptId,
+        user: opts.user
+      }),
+      pluginCtx,
+      lxpackBridge: opts.lxpackBridge
+    });
+    markCourseStarted(opts.storage, opts.sessionId, opts.courseId);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function LessonkitProvider(props) {
   const config = props.config;
   const sessionIdRef = (0, import_react.useRef)(resolveSessionId(defaultStorage, config.session?.sessionId));
@@ -428,7 +461,17 @@ function LessonkitProvider(props) {
   const courseId = config.courseId;
   const trackingEnabled = config.tracking?.enabled;
   useIsoLayoutEffect(() => {
-    if (prevXapiCourseIdRef.current !== courseId) {
+    const courseChanged = prevXapiCourseIdRef.current !== courseId;
+    if (courseChanged) {
+      if (config.xapi?.client) {
+        const g = globalThis;
+        if (typeof g.process !== "undefined" && g.process.env?.NODE_ENV !== "production") {
+          console.warn(
+            "[lessonkit] courseId changed while using config.xapi.client; flush the client between courses or use config.xapi.transport so the provider can manage the queue."
+          );
+        }
+        void xapiRef.current?.flush();
+      }
       xapiQueueRef.current = (0, import_xapi3.createInMemoryXAPIQueue)();
       prevXapiCourseIdRef.current = courseId;
     }
@@ -452,7 +495,10 @@ function LessonkitProvider(props) {
               user: userRef.current
             })
           );
-          if (statement) next.send(statement);
+          if (statement) {
+            next.send(statement);
+            markCourseStarted(defaultStorage, sessionId, cid);
+          }
         } catch {
         }
       }
@@ -484,17 +530,24 @@ function LessonkitProvider(props) {
   const batchEnabled = config.tracking?.batch?.enabled;
   const batchFlushIntervalMs = config.tracking?.batch?.flushIntervalMs;
   const batchMaxBatchSize = config.tracking?.batch?.maxBatchSize;
-  useIsoLayoutEffect(() => {
-    const prev = trackingRef.current;
-    const pluginCtx = buildPluginContext({
+  const buildCurrentPluginCtx = (0, import_react.useCallback)(
+    () => buildPluginContext({
       courseId: courseIdRef.current,
       sessionId: sessionIdRef.current,
       attemptId: attemptIdRef.current
-    });
-    const sink = pluginHostRef.current?.composeTrackingSink(config.tracking?.sink, pluginCtx) ?? config.tracking?.sink;
+    }),
+    []
+  );
+  useIsoLayoutEffect(() => {
+    const prev = trackingRef.current;
+    const baseSink = config.tracking?.sink;
+    const sink = pluginHostRef.current && baseSink ? pluginHostRef.current.composeTrackingSink(baseSink, buildCurrentPluginCtx) ?? baseSink : baseSink;
     const batchSink = pluginHostRef.current && config.tracking?.batchSink ? (events) => {
-      const filtered = pluginHostRef.current.runTelemetryBatch(events, pluginCtx);
-      return config.tracking.batchSink(filtered);
+      const delivered = pluginHostRef.current.deliverTelemetryBatch(
+        events,
+        buildCurrentPluginCtx()
+      );
+      return config.tracking.batchSink(delivered);
     } : config.tracking?.batchSink;
     const next = createTrackingClientFromConfig({
       tracking: { ...config.tracking, sink, batchSink }
@@ -508,32 +561,24 @@ function LessonkitProvider(props) {
     if (!trackingActive) {
       courseStartedEmittedToSinkRef.current = false;
     } else if (!courseStartedEmittedToSinkRef.current && !hasCourseStarted(defaultStorage, sessionId, cid)) {
-      markCourseStarted(defaultStorage, sessionId, cid);
-      emitTelemetryWithPlugins({
+      const emitted = emitCourseStarted({
         pluginHost: pluginHostRef.current,
         tracking: next,
         xapi: xapiRef.current,
-        event: buildTrackEvent({
-          name: "course_started",
-          courseId: cid,
-          sessionId,
-          attemptId: attemptIdRef.current,
-          user: userRef.current
-        }),
-        pluginCtx: buildPluginContext({
-          courseId: cid,
-          sessionId,
-          attemptId: attemptIdRef.current
-        }),
+        storage: defaultStorage,
+        sessionId,
+        courseId: cid,
+        attemptId: attemptIdRef.current,
+        user: userRef.current,
         lxpackBridge: lxpackBridgeModeRef.current
       });
-      courseStartedEmittedToSinkRef.current = true;
+      courseStartedEmittedToSinkRef.current = emitted;
     } else if (trackingActive) {
       courseStartedEmittedToSinkRef.current = true;
     }
     return () => {
       if (prev !== trackingRef.current) {
-        disposeTrackingClient(prev);
+        void disposeTrackingClient(prev);
       }
     };
   }, [
@@ -543,7 +588,9 @@ function LessonkitProvider(props) {
     batchEnabled,
     batchFlushIntervalMs,
     batchMaxBatchSize,
-    config.plugins
+    config.plugins,
+    config.courseId,
+    buildCurrentPluginCtx
   ]);
   const emitWithBridge = (0, import_react.useCallback)((trackingClient, event) => {
     emitTelemetryWithPlugins({
@@ -582,28 +629,26 @@ function LessonkitProvider(props) {
     if (!isTrackingActive(config.tracking)) return;
     const sessionId = sessionIdRef.current;
     const cid = courseIdRef.current;
-    if (!courseStartedEmittedToSinkRef.current && !hasCourseStarted(defaultStorage, sessionId, cid)) {
-      markCourseStarted(defaultStorage, sessionId, cid);
-      emitTelemetryWithPlugins({
-        pluginHost: pluginHostRef.current,
-        tracking: trackingRef.current,
-        xapi: xapiRef.current,
-        event: buildTrackEvent({
-          name: "course_started",
-          courseId: cid,
+    void (async () => {
+      try {
+        await trackingRef.current?.flush?.();
+      } catch {
+      }
+      if (!courseStartedEmittedToSinkRef.current && !hasCourseStarted(defaultStorage, sessionId, cid)) {
+        const emitted = emitCourseStarted({
+          pluginHost: pluginHostRef.current,
+          tracking: trackingRef.current,
+          xapi: xapiRef.current,
+          storage: defaultStorage,
           sessionId,
-          attemptId: attemptIdRef.current,
-          user: userRef.current
-        }),
-        pluginCtx: buildPluginContext({
           courseId: cid,
-          sessionId,
-          attemptId: attemptIdRef.current
-        }),
-        lxpackBridge: lxpackBridgeModeRef.current
-      });
-      courseStartedEmittedToSinkRef.current = true;
-    }
+          attemptId: attemptIdRef.current,
+          user: userRef.current,
+          lxpackBridge: lxpackBridgeModeRef.current
+        });
+        courseStartedEmittedToSinkRef.current = emitted;
+      }
+    })();
   }, [config.courseId, config.tracking?.enabled, syncProgress]);
   const emitLessonCompleted = (0, import_react.useCallback)(
     (lessonId, durationMs) => {
@@ -620,25 +665,28 @@ function LessonkitProvider(props) {
       if (!result.didComplete) return;
       syncProgress();
       emitLessonCompleted(lessonId, result.durationMs);
-      void trackingRef.current?.flush?.();
+      void Promise.resolve(trackingRef.current?.flush?.());
     },
     [syncProgress, emitLessonCompleted]
   );
-  const unmountTimerIdsRef = (0, import_react.useRef)([]);
   (0, import_react.useEffect)(() => {
     return () => {
-      for (const id of unmountTimerIdsRef.current) clearTimeout(id);
-      unmountTimerIdsRef.current = [];
       const client = trackingClientForUnmountRef.current;
-      void xapiRef.current?.flush();
-      const flushTimer = setTimeout(() => {
-        client?.flush?.();
-        const disposeTimer = setTimeout(() => {
-          client?.dispose?.();
-        }, 0);
-        unmountTimerIdsRef.current.push(disposeTimer);
-      }, 0);
-      unmountTimerIdsRef.current.push(flushTimer);
+      const xapi2 = xapiRef.current;
+      void (async () => {
+        try {
+          await xapi2?.flush();
+        } catch {
+        }
+        try {
+          await client?.flush?.();
+        } catch {
+        }
+        try {
+          await client?.dispose?.();
+        } catch {
+        }
+      })();
     };
   }, []);
   const setActiveLesson = (0, import_react.useCallback)(
@@ -650,6 +698,7 @@ function LessonkitProvider(props) {
         const completed = progressRef.current.completeLesson(previous, Date.now());
         if (completed.didComplete) {
           emitLessonCompleted(previous, completed.durationMs);
+          void Promise.resolve(trackingRef.current?.flush?.());
         }
       }
       progressRef.current.setActiveLesson(lessonId, Date.now());
@@ -659,12 +708,19 @@ function LessonkitProvider(props) {
     [track, syncProgress, emitLessonCompleted]
   );
   const completeCourse = (0, import_react.useCallback)(() => {
+    const current = progressRef.current.getState();
+    if (current.activeLessonId) {
+      const lessonResult = progressRef.current.completeLesson(current.activeLessonId, Date.now());
+      if (lessonResult.didComplete) {
+        emitLessonCompleted(current.activeLessonId, lessonResult.durationMs);
+      }
+    }
     const result = progressRef.current.completeCourse();
     if (!result.didComplete) return;
     syncProgress();
     track("course_completed");
     void trackingRef.current?.flush?.();
-  }, [track, syncProgress]);
+  }, [track, syncProgress, emitLessonCompleted]);
   const sessionUser = config.session?.user;
   const sessionAttemptId = config.session?.attemptId;
   const sessionConfiguredId = config.session?.sessionId;
@@ -847,20 +903,32 @@ function KnowledgeCheck(props) {
       checkId: props.checkId,
       question: props.question,
       choices: props.choices,
-      answer: props.answer
+      answer: props.answer,
+      passingScore: props.passingScore
     }
   );
 }
 function Quiz(props) {
   warnInvalidComponentId(props.checkId, "checkId");
   const quiz = useQuizState();
+  const { plugins, config, progress, session } = useLessonkit();
   const [selected, setSelected] = (0, import_react3.useState)(null);
+  const [selectionCorrect, setSelectionCorrect] = (0, import_react3.useState)(null);
   const completedRef = (0, import_react3.useRef)(false);
   const questionId = (0, import_react3.useId)();
   (0, import_react3.useEffect)(() => {
     completedRef.current = false;
     setSelected(null);
-  }, [props.checkId, props.answer, props.question]);
+    setSelectionCorrect(null);
+  }, [props.checkId, props.answer, props.question, config.courseId]);
+  const isChoiceCorrect = (choice, custom) => {
+    if (!custom) return choice === props.answer;
+    if (custom.passed !== void 0) return custom.passed;
+    if (custom.maxScore != null && custom.maxScore > 0) {
+      return custom.score / custom.maxScore >= 1;
+    }
+    return choice === props.answer;
+  };
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("section", { "aria-label": "Quiz", "data-lk-check-id": props.checkId, children: [
     /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { id: questionId, children: props.question }),
     /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("fieldset", { "aria-labelledby": questionId, children: [
@@ -875,7 +943,21 @@ function Quiz(props) {
             checked: selected === c,
             onChange: () => {
               setSelected(c);
-              const correct = c === props.answer;
+              const pluginCtx = buildPluginContext({
+                courseId: config.courseId,
+                sessionId: session.sessionId,
+                attemptId: session.attemptId
+              });
+              const custom = plugins?.scoreAssessment(
+                {
+                  checkId: props.checkId,
+                  lessonId: progress.activeLessonId,
+                  response: c
+                },
+                pluginCtx
+              ) ?? null;
+              const correct = isChoiceCorrect(c, custom);
+              setSelectionCorrect(correct);
               quiz.answer({
                 checkId: props.checkId,
                 question: props.question,
@@ -884,7 +966,12 @@ function Quiz(props) {
               });
               if (correct && !completedRef.current) {
                 completedRef.current = true;
-                quiz.complete({ checkId: props.checkId, score: 1, maxScore: 1, passingScore: 1 });
+                quiz.complete({
+                  checkId: props.checkId,
+                  score: custom?.score ?? 1,
+                  maxScore: custom?.maxScore ?? 1,
+                  passingScore: props.passingScore ?? 1
+                });
               }
             }
           }
@@ -892,7 +979,7 @@ function Quiz(props) {
         c
       ] }, `${questionId}-${i}`))
     ] }),
-    selected ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { role: "status", "aria-live": "polite", children: selected === props.answer ? "Correct" : "Try again" }) : null
+    selected && selectionCorrect !== null ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { role: "status", "aria-live": "polite", children: selectionCorrect ? "Correct" : "Try again" }) : null
   ] });
 }
 function ProgressTracker() {

package/dist/index.d.cts

@@ -91,12 +91,14 @@ declare function KnowledgeCheck(props: {
     question: string;
     choices: string[];
     answer: string;
+    passingScore?: number;
 }): react_jsx_runtime.JSX.Element;
 declare function Quiz(props: {
     checkId: CheckId;
     question: string;
     choices: string[];
     answer: string;
+    passingScore?: number;
 }): react_jsx_runtime.JSX.Element;
 declare function ProgressTracker(): react_jsx_runtime.JSX.Element;
 

package/dist/index.d.ts

@@ -91,12 +91,14 @@ declare function KnowledgeCheck(props: {
     question: string;
     choices: string[];
     answer: string;
+    passingScore?: number;
 }): react_jsx_runtime.JSX.Element;
 declare function Quiz(props: {
     checkId: CheckId;
     question: string;
     choices: string[];
     answer: string;
+    passingScore?: number;
 }): react_jsx_runtime.JSX.Element;
 declare function ProgressTracker(): react_jsx_runtime.JSX.Element;
 

package/dist/index.js

@@ -327,9 +327,15 @@ function createTrackingClientFromConfig(config) {
     batch: config.tracking?.batch
   });
 }
-function disposeTrackingClient(client) {
-  client?.flush?.();
-  client?.dispose?.();
+async function disposeTrackingClient(client) {
+  try {
+    await client?.flush?.();
+  } catch {
+  }
+  try {
+    await client?.dispose?.();
+  } catch {
+  }
 }
 
 // src/context.tsx
@@ -340,6 +346,33 @@ var defaultStorage = createSessionStoragePort();
 function isTrackingActive(tracking) {
   return tracking?.enabled !== false;
 }
+function emitCourseStarted(opts) {
+  const pluginCtx = buildPluginContext({
+    courseId: opts.courseId,
+    sessionId: opts.sessionId,
+    attemptId: opts.attemptId
+  });
+  try {
+    emitTelemetryWithPlugins({
+      pluginHost: opts.pluginHost,
+      tracking: opts.tracking,
+      xapi: opts.xapi,
+      event: buildTrackEvent({
+        name: "course_started",
+        courseId: opts.courseId,
+        sessionId: opts.sessionId,
+        attemptId: opts.attemptId,
+        user: opts.user
+      }),
+      pluginCtx,
+      lxpackBridge: opts.lxpackBridge
+    });
+    markCourseStarted(opts.storage, opts.sessionId, opts.courseId);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function LessonkitProvider(props) {
   const config = props.config;
   const sessionIdRef = useRef(resolveSessionId(defaultStorage, config.session?.sessionId));
@@ -386,7 +419,17 @@ function LessonkitProvider(props) {
   const courseId = config.courseId;
   const trackingEnabled = config.tracking?.enabled;
   useIsoLayoutEffect(() => {
-    if (prevXapiCourseIdRef.current !== courseId) {
+    const courseChanged = prevXapiCourseIdRef.current !== courseId;
+    if (courseChanged) {
+      if (config.xapi?.client) {
+        const g = globalThis;
+        if (typeof g.process !== "undefined" && g.process.env?.NODE_ENV !== "production") {
+          console.warn(
+            "[lessonkit] courseId changed while using config.xapi.client; flush the client between courses or use config.xapi.transport so the provider can manage the queue."
+          );
+        }
+        void xapiRef.current?.flush();
+      }
       xapiQueueRef.current = createInMemoryXAPIQueue();
       prevXapiCourseIdRef.current = courseId;
     }
@@ -410,7 +453,10 @@ function LessonkitProvider(props) {
               user: userRef.current
             })
           );
-          if (statement) next.send(statement);
+          if (statement) {
+            next.send(statement);
+            markCourseStarted(defaultStorage, sessionId, cid);
+          }
         } catch {
         }
       }
@@ -442,17 +488,24 @@ function LessonkitProvider(props) {
   const batchEnabled = config.tracking?.batch?.enabled;
   const batchFlushIntervalMs = config.tracking?.batch?.flushIntervalMs;
   const batchMaxBatchSize = config.tracking?.batch?.maxBatchSize;
-  useIsoLayoutEffect(() => {
-    const prev = trackingRef.current;
-    const pluginCtx = buildPluginContext({
+  const buildCurrentPluginCtx = useCallback(
+    () => buildPluginContext({
       courseId: courseIdRef.current,
       sessionId: sessionIdRef.current,
       attemptId: attemptIdRef.current
-    });
-    const sink = pluginHostRef.current?.composeTrackingSink(config.tracking?.sink, pluginCtx) ?? config.tracking?.sink;
+    }),
+    []
+  );
+  useIsoLayoutEffect(() => {
+    const prev = trackingRef.current;
+    const baseSink = config.tracking?.sink;
+    const sink = pluginHostRef.current && baseSink ? pluginHostRef.current.composeTrackingSink(baseSink, buildCurrentPluginCtx) ?? baseSink : baseSink;
     const batchSink = pluginHostRef.current && config.tracking?.batchSink ? (events) => {
-      const filtered = pluginHostRef.current.runTelemetryBatch(events, pluginCtx);
-      return config.tracking.batchSink(filtered);
+      const delivered = pluginHostRef.current.deliverTelemetryBatch(
+        events,
+        buildCurrentPluginCtx()
+      );
+      return config.tracking.batchSink(delivered);
     } : config.tracking?.batchSink;
     const next = createTrackingClientFromConfig({
       tracking: { ...config.tracking, sink, batchSink }
@@ -466,32 +519,24 @@ function LessonkitProvider(props) {
     if (!trackingActive) {
       courseStartedEmittedToSinkRef.current = false;
     } else if (!courseStartedEmittedToSinkRef.current && !hasCourseStarted(defaultStorage, sessionId, cid)) {
-      markCourseStarted(defaultStorage, sessionId, cid);
-      emitTelemetryWithPlugins({
+      const emitted = emitCourseStarted({
         pluginHost: pluginHostRef.current,
         tracking: next,
         xapi: xapiRef.current,
-        event: buildTrackEvent({
-          name: "course_started",
-          courseId: cid,
-          sessionId,
-          attemptId: attemptIdRef.current,
-          user: userRef.current
-        }),
-        pluginCtx: buildPluginContext({
-          courseId: cid,
-          sessionId,
-          attemptId: attemptIdRef.current
-        }),
+        storage: defaultStorage,
+        sessionId,
+        courseId: cid,
+        attemptId: attemptIdRef.current,
+        user: userRef.current,
         lxpackBridge: lxpackBridgeModeRef.current
       });
-      courseStartedEmittedToSinkRef.current = true;
+      courseStartedEmittedToSinkRef.current = emitted;
     } else if (trackingActive) {
       courseStartedEmittedToSinkRef.current = true;
     }
     return () => {
       if (prev !== trackingRef.current) {
-        disposeTrackingClient(prev);
+        void disposeTrackingClient(prev);
       }
     };
   }, [
@@ -501,7 +546,9 @@ function LessonkitProvider(props) {
     batchEnabled,
     batchFlushIntervalMs,
     batchMaxBatchSize,
-    config.plugins
+    config.plugins,
+    config.courseId,
+    buildCurrentPluginCtx
   ]);
   const emitWithBridge = useCallback((trackingClient, event) => {
     emitTelemetryWithPlugins({
@@ -540,28 +587,26 @@ function LessonkitProvider(props) {
     if (!isTrackingActive(config.tracking)) return;
     const sessionId = sessionIdRef.current;
     const cid = courseIdRef.current;
-    if (!courseStartedEmittedToSinkRef.current && !hasCourseStarted(defaultStorage, sessionId, cid)) {
-      markCourseStarted(defaultStorage, sessionId, cid);
-      emitTelemetryWithPlugins({
-        pluginHost: pluginHostRef.current,
-        tracking: trackingRef.current,
-        xapi: xapiRef.current,
-        event: buildTrackEvent({
-          name: "course_started",
-          courseId: cid,
+    void (async () => {
+      try {
+        await trackingRef.current?.flush?.();
+      } catch {
+      }
+      if (!courseStartedEmittedToSinkRef.current && !hasCourseStarted(defaultStorage, sessionId, cid)) {
+        const emitted = emitCourseStarted({
+          pluginHost: pluginHostRef.current,
+          tracking: trackingRef.current,
+          xapi: xapiRef.current,
+          storage: defaultStorage,
           sessionId,
-          attemptId: attemptIdRef.current,
-          user: userRef.current
-        }),
-        pluginCtx: buildPluginContext({
           courseId: cid,
-          sessionId,
-          attemptId: attemptIdRef.current
-        }),
-        lxpackBridge: lxpackBridgeModeRef.current
-      });
-      courseStartedEmittedToSinkRef.current = true;
-    }
+          attemptId: attemptIdRef.current,
+          user: userRef.current,
+          lxpackBridge: lxpackBridgeModeRef.current
+        });
+        courseStartedEmittedToSinkRef.current = emitted;
+      }
+    })();
   }, [config.courseId, config.tracking?.enabled, syncProgress]);
   const emitLessonCompleted = useCallback(
     (lessonId, durationMs) => {
@@ -578,25 +623,28 @@ function LessonkitProvider(props) {
       if (!result.didComplete) return;
       syncProgress();
       emitLessonCompleted(lessonId, result.durationMs);
-      void trackingRef.current?.flush?.();
+      void Promise.resolve(trackingRef.current?.flush?.());
     },
     [syncProgress, emitLessonCompleted]
   );
-  const unmountTimerIdsRef = useRef([]);
   useEffect(() => {
     return () => {
-      for (const id of unmountTimerIdsRef.current) clearTimeout(id);
-      unmountTimerIdsRef.current = [];
       const client = trackingClientForUnmountRef.current;
-      void xapiRef.current?.flush();
-      const flushTimer = setTimeout(() => {
-        client?.flush?.();
-        const disposeTimer = setTimeout(() => {
-          client?.dispose?.();
-        }, 0);
-        unmountTimerIdsRef.current.push(disposeTimer);
-      }, 0);
-      unmountTimerIdsRef.current.push(flushTimer);
+      const xapi2 = xapiRef.current;
+      void (async () => {
+        try {
+          await xapi2?.flush();
+        } catch {
+        }
+        try {
+          await client?.flush?.();
+        } catch {
+        }
+        try {
+          await client?.dispose?.();
+        } catch {
+        }
+      })();
     };
   }, []);
   const setActiveLesson = useCallback(
@@ -608,6 +656,7 @@ function LessonkitProvider(props) {
         const completed = progressRef.current.completeLesson(previous, Date.now());
         if (completed.didComplete) {
           emitLessonCompleted(previous, completed.durationMs);
+          void Promise.resolve(trackingRef.current?.flush?.());
         }
       }
       progressRef.current.setActiveLesson(lessonId, Date.now());
@@ -617,12 +666,19 @@ function LessonkitProvider(props) {
     [track, syncProgress, emitLessonCompleted]
   );
   const completeCourse = useCallback(() => {
+    const current = progressRef.current.getState();
+    if (current.activeLessonId) {
+      const lessonResult = progressRef.current.completeLesson(current.activeLessonId, Date.now());
+      if (lessonResult.didComplete) {
+        emitLessonCompleted(current.activeLessonId, lessonResult.durationMs);
+      }
+    }
     const result = progressRef.current.completeCourse();
     if (!result.didComplete) return;
     syncProgress();
     track("course_completed");
     void trackingRef.current?.flush?.();
-  }, [track, syncProgress]);
+  }, [track, syncProgress, emitLessonCompleted]);
   const sessionUser = config.session?.user;
   const sessionAttemptId = config.session?.attemptId;
   const sessionConfiguredId = config.session?.sessionId;
@@ -805,20 +861,32 @@ function KnowledgeCheck(props) {
       checkId: props.checkId,
       question: props.question,
       choices: props.choices,
-      answer: props.answer
+      answer: props.answer,
+      passingScore: props.passingScore
     }
   );
 }
 function Quiz(props) {
   warnInvalidComponentId(props.checkId, "checkId");
   const quiz = useQuizState();
+  const { plugins, config, progress, session } = useLessonkit();
   const [selected, setSelected] = useState2(null);
+  const [selectionCorrect, setSelectionCorrect] = useState2(null);
   const completedRef = useRef2(false);
   const questionId = useId();
   useEffect2(() => {
     completedRef.current = false;
     setSelected(null);
-  }, [props.checkId, props.answer, props.question]);
+    setSelectionCorrect(null);
+  }, [props.checkId, props.answer, props.question, config.courseId]);
+  const isChoiceCorrect = (choice, custom) => {
+    if (!custom) return choice === props.answer;
+    if (custom.passed !== void 0) return custom.passed;
+    if (custom.maxScore != null && custom.maxScore > 0) {
+      return custom.score / custom.maxScore >= 1;
+    }
+    return choice === props.answer;
+  };
   return /* @__PURE__ */ jsxs("section", { "aria-label": "Quiz", "data-lk-check-id": props.checkId, children: [
     /* @__PURE__ */ jsx2("p", { id: questionId, children: props.question }),
     /* @__PURE__ */ jsxs("fieldset", { "aria-labelledby": questionId, children: [
@@ -833,7 +901,21 @@ function Quiz(props) {
             checked: selected === c,
             onChange: () => {
               setSelected(c);
-              const correct = c === props.answer;
+              const pluginCtx = buildPluginContext({
+                courseId: config.courseId,
+                sessionId: session.sessionId,
+                attemptId: session.attemptId
+              });
+              const custom = plugins?.scoreAssessment(
+                {
+                  checkId: props.checkId,
+                  lessonId: progress.activeLessonId,
+                  response: c
+                },
+                pluginCtx
+              ) ?? null;
+              const correct = isChoiceCorrect(c, custom);
+              setSelectionCorrect(correct);
               quiz.answer({
                 checkId: props.checkId,
                 question: props.question,
@@ -842,7 +924,12 @@ function Quiz(props) {
               });
               if (correct && !completedRef.current) {
                 completedRef.current = true;
-                quiz.complete({ checkId: props.checkId, score: 1, maxScore: 1, passingScore: 1 });
+                quiz.complete({
+                  checkId: props.checkId,
+                  score: custom?.score ?? 1,
+                  maxScore: custom?.maxScore ?? 1,
+                  passingScore: props.passingScore ?? 1
+                });
               }
             }
           }
@@ -850,7 +937,7 @@ function Quiz(props) {
         c
       ] }, `${questionId}-${i}`))
     ] }),
-    selected ? /* @__PURE__ */ jsx2("p", { role: "status", "aria-live": "polite", children: selected === props.answer ? "Correct" : "Try again" }) : null
+    selected && selectionCorrect !== null ? /* @__PURE__ */ jsx2("p", { role: "status", "aria-live": "polite", children: selectionCorrect ? "Correct" : "Try again" }) : null
   ] });
 }
 function ProgressTracker() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lessonkit/react",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "private": false,
   "description": "React components and hooks for building learning experiences with LessonKit.",
   "license": "Apache-2.0",
@@ -54,11 +54,11 @@
     "react-dom": ">=18"
   },
   "dependencies": {
-    "@lessonkit/accessibility": "0.9.1",
-    "@lessonkit/core": "0.9.1",
-    "@lessonkit/lxpack": "0.9.1",
-    "@lessonkit/themes": "0.9.1",
-    "@lessonkit/xapi": "0.9.1"
+    "@lessonkit/accessibility": "0.9.3",
+    "@lessonkit/core": "0.9.3",
+    "@lessonkit/lxpack": "0.9.3",
+    "@lessonkit/themes": "0.9.3",
+    "@lessonkit/xapi": "0.9.3"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.0",