@lessonkit/cli 1.4.0 → 1.6.0

package/template/vite-react/src/App.tsx

@@ -1,12 +1,12 @@
 import React from "react";
 import { Course, Lesson, Quiz, Scenario, ThemeProvider } from "@lessonkit/react";
-import { createCourseConfig } from "./courseConfig";
+import { createCourseConfig, COURSE_THEME_PRESET } from "./courseConfig";
 
 const courseConfig = createCourseConfig();
 
 export default function App() {
   return (
-    <ThemeProvider preset="default" mode="light">
+    <ThemeProvider preset={COURSE_THEME_PRESET} mode="light">
       <div className="app-shell">
         <Course title="{{courseTitle}}" courseId="my-course" config={courseConfig}>
           <Lesson title="My first lesson" lessonId="lesson-1">

package/template/vite-react/src/courseConfig.test.ts

@@ -44,6 +44,8 @@ describe("createCourseConfig", () => {
       courseId: "my-course",
     } as TelemetryEvent);
     config.observability?.onXapiTransportError?.(new Error("transport"));
+    config.observability?.onXapiMappingError?.(new Error("mapping"));
+    config.observability?.onLxpackBridgeError?.(new Error("bridge"));
 
     expect(warn).toHaveBeenCalled();
     warn.mockRestore();

package/template/vite-react/src/courseConfig.ts

@@ -31,7 +31,9 @@ function createObservability(): NonNullable<LessonkitConfig["observability"]> {
     },
     onXapiQueueCap: () => report("xapi-queue-cap", {}),
     onLxpackBridgeMiss: (event) => report("lxpack-bridge-miss", { event: event.name }),
+    onLxpackBridgeError: (err) => report("lxpack-bridge-error", { err }),
     onXapiTransportError: (err) => report("xapi-transport", { err }),
+    onXapiMappingError: (err) => report("xapi-mapping", { err }),
   };
 }
 
@@ -98,13 +100,21 @@ function productionXapi(xapiProxyUrl: string | undefined): LessonkitConfig["xapi
   };
 }
 
+/** Theme preset — keep in sync with lessonkit.json `course.theme.preset`. */
+export const COURSE_THEME_PRESET = "default" as const;
+
 export function createCourseConfig(): LessonkitConfig {
   const { xapiProxyUrl, analyticsUrl } = readProxyUrls();
   const useProductionTransports = import.meta.env.PROD || (xapiProxyUrl && analyticsUrl);
 
   const config: LessonkitConfig = {
     courseId: "my-course",
-    lxpack: { bridge: "off" },
+    lxpack: {
+      // Set bridge: "auto" when packaging for LMS (SCORM/xAPI/cmi5). In production, allowedParentOrigins
+      // is required — see https://lessonkit.readthedocs.io/en/latest/guides/react-developers/production-checklist.html
+      bridge: "off",
+      // allowedParentOrigins: ["https://your-lms.example"],
+    },
     observability: createObservability(),
     tracking: useProductionTransports ? productionTracking(analyticsUrl) : devConsoleTracking(),
     xapi: useProductionTransports ? productionXapi(xapiProxyUrl) : devConsoleXapi(),

package/template/vite-react/src/vite-env.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="vite/client" />
+
+declare module "*.css";