@lessonkit/lxpack 1.5.0 → 1.7.0

package/README.md

@@ -50,6 +50,20 @@ Prefer the CLI: `lessonkit package --target scorm12` reads `lessonkit.json` and
 | `single-spa` | One Vite SPA for the whole course (CLI default) |
 | `per-lesson-spa` | One dist per lesson (advanced; see packaging reference) |
 
+## Portable interchange (1.6.0)
+
+Export a `.lkcourse` archive for team handoff (not LMS upload):
+
+```typescript
+import { exportLkcourse, validateLkcourse, importLkcourse } from "@lessonkit/lxpack";
+
+await exportLkcourse({ projectRoot, manifest, includeBlockTree: true });
+validateLkcourse("course.lkcourse");
+await importLkcourse({ archivePath: "course.lkcourse", targetDir: "./restored" });
+```
+
+Schemas: `@lessonkit/lxpack/lkcourse-format.v1.json`, `@lessonkit/lxpack/block-tree.v1.json`. See [Portable interchange](https://lessonkit.readthedocs.io/en/latest/reference/interchange.html).
+
 ## Browser bridge
 
 When embedded in an LXPack iframe, `@lessonkit/react` forwards completion events to `window.parent.lxpackBridge.v1`:
@@ -70,7 +84,7 @@ Production builds require `allowedParentOrigins` when `bridge: "auto"`.
 
 ## Docs
 
-[Packaging reference](https://lessonkit.readthedocs.io/en/latest/reference/packaging.html) · [LXPack bridge](https://lessonkit.readthedocs.io/en/latest/reference/lxpack-bridge.html) · [Manifest](https://lessonkit.readthedocs.io/en/latest/reference/manifest.html) · [Golden example](https://github.com/eddiethedean/lessonkit/tree/main/examples/lxpack-golden) · [TypeDoc API index](https://lessonkit.readthedocs.io/en/latest/reference/api.html)
+[5-minute guide](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/getting-started-in-5-minutes.html) · [LMS Go-Live](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/lms-go-live.html) · [Packaging reference](https://lessonkit.readthedocs.io/en/latest/reference/packaging.html) · [TypeDoc API index](https://lessonkit.readthedocs.io/en/latest/reference/api.html)
 
 ## License
 

package/block-tree.v1.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://lessonkit.dev/schemas/block-tree.v1.json",
+  "title": "BlockTreeV1",
+  "description": "Best-effort static JSX block inventory for a LessonKit course",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "blocks", "sources"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "sources": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "blocks": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/BlockTreeNode" }
+    }
+  },
+  "$defs": {
+    "BlockTreeNode": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type"],
+      "properties": {
+        "type": { "type": "string", "minLength": 1 },
+        "rawTag": { "type": "string" },
+        "courseId": { "type": "string" },
+        "lessonId": { "type": "string" },
+        "checkId": { "type": "string" },
+        "blockId": { "type": "string" },
+        "nodeId": { "type": "string" },
+        "children": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/BlockTreeNode" }
+        }
+      }
+    }
+  }
+}

package/dist/bridge.cjs

@@ -35,8 +35,8 @@ __export(bridge_exports, {
   mapLessonkitTelemetryToLxpack: () => import_tracking_schema2.mapLessonkitTelemetryToLxpack,
   normalizeAssessmentPassingScore: () => normalizeAssessmentPassingScore,
   normalizeAssessmentScore: () => normalizeAssessmentScore,
-  normalizePassingThreshold: () => import_spa_bridge2.normalizePassingThreshold,
-  normalizeScore: () => import_spa_bridge2.normalizeScore,
+  normalizePassingThreshold: () => normalizePassingThreshold,
+  normalizeScore: () => normalizeScore,
   notifyLxpackAssessment: () => notifyLxpackAssessment,
   notifyLxpackCourseComplete: () => notifyLxpackCourseComplete,
   notifyLxpackLessonComplete: () => notifyLxpackLessonComplete,
@@ -137,14 +137,49 @@ function branchTelemetryToBridgeTrackEvent(event) {
 
 // src/bridge.ts
 var import_meta = {};
+var DEFAULT_BRIDGE_PASSING_SCORE2 = 1;
+function clamp01(value) {
+  return Math.min(1, Math.max(0, value));
+}
+function normalizeScore(raw) {
+  const { score, maxScore } = raw;
+  if (typeof score !== "number" || !Number.isFinite(score)) return null;
+  if (typeof maxScore === "number" && maxScore <= 0) return null;
+  if (typeof maxScore === "number" && maxScore > 0) {
+    return clamp01(score / maxScore);
+  }
+  if (score > 1 && score <= 100) {
+    return clamp01(score / 100);
+  }
+  return clamp01(score);
+}
+function normalizePassingThreshold(raw) {
+  const { passingScore, maxScore } = raw ?? {};
+  if (typeof passingScore !== "number" || !Number.isFinite(passingScore)) {
+    return DEFAULT_BRIDGE_PASSING_SCORE2;
+  }
+  if (typeof maxScore === "number" && maxScore <= 0) {
+    return DEFAULT_BRIDGE_PASSING_SCORE2;
+  }
+  if (typeof maxScore === "number" && maxScore > 1) {
+    return clamp01(passingScore / maxScore);
+  }
+  if (typeof maxScore === "number" && maxScore <= 1) {
+    return clamp01(passingScore);
+  }
+  if (passingScore > 1 && passingScore <= 100) {
+    return clamp01(passingScore / 100);
+  }
+  return clamp01(passingScore);
+}
 function normalizeAssessmentScore(opts) {
   if (typeof opts.score !== "number" || !Number.isFinite(opts.score)) {
     return null;
   }
-  return (0, import_spa_bridge.normalizeScore)({ score: opts.score, maxScore: opts.maxScore });
+  return normalizeScore({ score: opts.score, maxScore: opts.maxScore });
 }
 function normalizeAssessmentPassingScore(opts) {
-  return (0, import_spa_bridge.normalizePassingThreshold)({
+  return normalizePassingThreshold({
     passingScore: opts?.passingScore,
     maxScore: opts?.maxScore
   });
@@ -156,13 +191,7 @@ function resolveParentOrigin(parentWindow) {
   try {
     return parent.location.origin;
   } catch {
-    const referrer = typeof document !== "undefined" ? document.referrer : "";
-    if (!referrer) return null;
-    try {
-      return new URL(referrer).origin;
-    } catch {
-      return null;
-    }
+    return null;
   }
 }
 function isProductionRuntime() {
@@ -230,7 +259,7 @@ function dispatchBridgeActionInner(bridge, action) {
       bridge.completeCourse?.();
       return;
     case "submitAssessment": {
-      const scaled = (0, import_spa_bridge.normalizeScore)({
+      const scaled = normalizeScore({
         score: action.score,
         maxScore: action.maxScore
       });
@@ -238,7 +267,7 @@ function dispatchBridgeActionInner(bridge, action) {
       bridge.submitAssessment?.({
         id: action.id,
         score: scaled,
-        passingScore: (0, import_spa_bridge.normalizePassingThreshold)({
+        passingScore: normalizePassingThreshold({
           passingScore: action.passingScore,
           maxScore: action.maxScore
         }),
@@ -253,13 +282,16 @@ function dispatchBridgeActionInner(bridge, action) {
       return;
   }
 }
-function forwardAssessmentCompletedToBridge(bridge, event) {
+function forwardAssessmentCompletedToBridge(bridge, event, onBridgeMiss) {
   const data = event.data;
   const scaled = normalizeAssessmentScore({
     score: data.score,
     maxScore: data.maxScore
   });
-  if (scaled === null) return;
+  if (scaled === null) {
+    onBridgeMiss?.(event);
+    return;
+  }
   bridge.submitAssessment?.({
     id: data.checkId,
     score: scaled,
@@ -279,7 +311,7 @@ function forwardTelemetryToBridge(event, mode = "auto", parentWindow, opts) {
   if (!bridge) return;
   try {
     if (event.name === "assessment_completed") {
-      forwardAssessmentCompletedToBridge(bridge, event);
+      forwardAssessmentCompletedToBridge(bridge, event, opts?.onBridgeMiss);
       return;
     }
     const answeredTrack = answeredTelemetryToBridgeTrackEvent(event);
@@ -306,20 +338,47 @@ function createLxpackBridge(opts) {
 function notifyLxpackLessonComplete(lessonId, opts) {
   const bridge = getBridge(void 0, opts);
   if (!bridge?.completeLesson) return false;
-  bridge.completeLesson(lessonId);
-  return true;
+  try {
+    bridge.completeLesson(lessonId);
+    return true;
+  } catch (err) {
+    handleBridgeError(err, opts?.onBridgeError);
+    return false;
+  }
 }
 function notifyLxpackCourseComplete(opts) {
   const bridge = getBridge(void 0, opts);
   if (!bridge?.completeCourse) return false;
-  bridge.completeCourse();
-  return true;
+  try {
+    bridge.completeCourse();
+    return true;
+  } catch (err) {
+    handleBridgeError(err, opts?.onBridgeError);
+    return false;
+  }
 }
 function notifyLxpackAssessment(payload, opts) {
   const bridge = getBridge(void 0, opts);
   if (!bridge?.submitAssessment) return false;
-  bridge.submitAssessment(payload);
-  return true;
+  const scaled = normalizeAssessmentScore({
+    score: payload.score,
+    maxScore: payload.maxScore
+  });
+  if (scaled === null) return false;
+  try {
+    bridge.submitAssessment({
+      ...payload,
+      score: scaled,
+      passingScore: normalizeAssessmentPassingScore({
+        passingScore: payload.passingScore,
+        maxScore: payload.maxScore
+      })
+    });
+    return true;
+  } catch (err) {
+    handleBridgeError(err, opts?.onBridgeError);
+    return false;
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/bridge.d.cts

@@ -1,10 +1,24 @@
 import { LmsBridgeMode, TelemetryEvent, CheckId, LessonId } from '@lessonkit/core';
 import { LxpackBridgeV1, LxpackBridgeSubmitAssessmentPayload } from '@lxpack/spa-bridge';
-export { DEFAULT_BRIDGE_PASSING_SCORE, LXPACK_BRIDGE_VERSIONS, LxpackBridgeSubmitAssessmentPayload, LxpackBridgeV1, createLxpackBridgeHost, normalizePassingThreshold, normalizeScore, supportedBridgeVersions } from '@lxpack/spa-bridge';
+export { DEFAULT_BRIDGE_PASSING_SCORE, LXPACK_BRIDGE_VERSIONS, LxpackBridgeSubmitAssessmentPayload, LxpackBridgeV1, createLxpackBridgeHost, supportedBridgeVersions } from '@lxpack/spa-bridge';
 import { mapLessonkitTelemetryToBridgeAction } from '@lxpack/tracking-schema';
 export { LESSONKIT_TELEMETRY_EVENTS, LessonkitBridgeAction, LessonkitTelemetryEvent, LessonkitTelemetryEventName, TrackingSchemaEvent, mapLessonkitTelemetryToBridgeAction, mapLessonkitTelemetryToLxpack } from '@lxpack/tracking-schema';
 export { B as BRANCH_TELEMETRY_EVENTS, b as branchTelemetryToBridgeTrackEvent, t as telemetryEventToLessonkit } from './telemetry-0fIWoomS.cjs';
 
+/**
+ * Scale a raw quiz score to 0–1 for the LXPack parent bridge.
+ * When `maxScore > 1`, always treats `score` as raw points (fixes partial-credit 1/N cases).
+ */
+declare function normalizeScore(raw: {
+    score?: number;
+    maxScore?: number;
+}): number | null;
+/** Scale a raw passing threshold to 0–1 for the LXPack parent bridge. */
+declare function normalizePassingThreshold(raw?: {
+    passingScore?: number;
+    maxScore?: number;
+}): number;
+
 /**
  * Scale a raw quiz score to 0–1 for the LXPack parent bridge.
  * Returns null when `score` is missing or not finite (caller should skip submit).
@@ -15,7 +29,7 @@ declare function normalizeAssessmentScore(opts: {
 }): number | null;
 /**
  * Scale a raw passing threshold to 0–1 for the LXPack parent bridge.
- * Delegates to `@lxpack/spa-bridge` (default 0.7 when omitted).
+ * Default 1.0 (100%) when omitted — matches React SPA default.
  */
 declare function normalizeAssessmentPassingScore(opts?: {
     passingScore?: number;
@@ -26,6 +40,7 @@ type BridgeAccessOptions = {
     allowedParentOrigins?: string[];
     /** LMS bridge mode; `"auto"` in production requires `allowedParentOrigins`. */
     mode?: LxpackBridgeMode;
+    onBridgeError?: (err: unknown) => void;
 };
 /** Resolve the parent frame origin when embedded (same-origin parent or document.referrer fallback). */
 declare function resolveParentOrigin(parentWindow?: Window): string | null;
@@ -41,18 +56,33 @@ declare function dispatchBridgeAction(bridge: LxpackBridgeV1, action: ReturnType
 }): void;
 type ForwardTelemetryToBridgeOptions = {
     onBridgeError?: (err: unknown) => void;
+    /** Called when assessment_completed cannot be forwarded (e.g. missing/invalid score). */
+    onBridgeMiss?: (event: TelemetryEvent) => void;
     allowedParentOrigins?: string[];
 };
+/**
+ * Map a LessonKit telemetry event to LMS bridge actions (`track`, `complete`, assessment score).
+ *
+ * @example
+ * ```ts
+ * import { forwardTelemetryToBridge } from "@lessonkit/lxpack/bridge";
+ *
+ * forwardTelemetryToBridge(event, "auto", window.parent, {
+ *   allowedParentOrigins: ["https://lms.example.com"],
+ *   onBridgeMiss: (e) => console.warn("bridge miss", e.name),
+ * });
+ * ```
+ */
 declare function forwardTelemetryToBridge(event: TelemetryEvent, mode?: LxpackBridgeMode, parentWindow?: Window, opts?: ForwardTelemetryToBridgeOptions): void;
 declare function createLxpackBridge(opts?: BridgeAccessOptions): LxpackBridgeV1 | null;
 declare function notifyLxpackLessonComplete(lessonId: LessonId, opts?: BridgeAccessOptions): boolean;
 declare function notifyLxpackCourseComplete(opts?: BridgeAccessOptions): boolean;
 /**
  * Submit assessment results to the parent LXPack bridge.
- * `score` must already be on a 0–1 scale (use `normalizeAssessmentScore` for raw points).
+ * Raw point scores are normalized to 0–1 before submission.
  */
 declare function notifyLxpackAssessment(payload: LxpackBridgeSubmitAssessmentPayload & {
     id: CheckId;
 }, opts?: BridgeAccessOptions): boolean;
 
-export { type BridgeAccessOptions, type ForwardTelemetryToBridgeOptions, type LxpackBridgeMode, createLxpackBridge, dispatchBridgeAction, forwardTelemetryToBridge, getLxpackBridge, isParentOriginAllowed, normalizeAssessmentPassingScore, normalizeAssessmentScore, notifyLxpackAssessment, notifyLxpackCourseComplete, notifyLxpackLessonComplete, resolveParentOrigin };
+export { type BridgeAccessOptions, type ForwardTelemetryToBridgeOptions, type LxpackBridgeMode, createLxpackBridge, dispatchBridgeAction, forwardTelemetryToBridge, getLxpackBridge, isParentOriginAllowed, normalizeAssessmentPassingScore, normalizeAssessmentScore, normalizePassingThreshold, normalizeScore, notifyLxpackAssessment, notifyLxpackCourseComplete, notifyLxpackLessonComplete, resolveParentOrigin };

package/dist/bridge.d.ts

@@ -1,10 +1,24 @@
 import { LmsBridgeMode, TelemetryEvent, CheckId, LessonId } from '@lessonkit/core';
 import { LxpackBridgeV1, LxpackBridgeSubmitAssessmentPayload } from '@lxpack/spa-bridge';
-export { DEFAULT_BRIDGE_PASSING_SCORE, LXPACK_BRIDGE_VERSIONS, LxpackBridgeSubmitAssessmentPayload, LxpackBridgeV1, createLxpackBridgeHost, normalizePassingThreshold, normalizeScore, supportedBridgeVersions } from '@lxpack/spa-bridge';
+export { DEFAULT_BRIDGE_PASSING_SCORE, LXPACK_BRIDGE_VERSIONS, LxpackBridgeSubmitAssessmentPayload, LxpackBridgeV1, createLxpackBridgeHost, supportedBridgeVersions } from '@lxpack/spa-bridge';
 import { mapLessonkitTelemetryToBridgeAction } from '@lxpack/tracking-schema';
 export { LESSONKIT_TELEMETRY_EVENTS, LessonkitBridgeAction, LessonkitTelemetryEvent, LessonkitTelemetryEventName, TrackingSchemaEvent, mapLessonkitTelemetryToBridgeAction, mapLessonkitTelemetryToLxpack } from '@lxpack/tracking-schema';
 export { B as BRANCH_TELEMETRY_EVENTS, b as branchTelemetryToBridgeTrackEvent, t as telemetryEventToLessonkit } from './telemetry-0fIWoomS.js';
 
+/**
+ * Scale a raw quiz score to 0–1 for the LXPack parent bridge.
+ * When `maxScore > 1`, always treats `score` as raw points (fixes partial-credit 1/N cases).
+ */
+declare function normalizeScore(raw: {
+    score?: number;
+    maxScore?: number;
+}): number | null;
+/** Scale a raw passing threshold to 0–1 for the LXPack parent bridge. */
+declare function normalizePassingThreshold(raw?: {
+    passingScore?: number;
+    maxScore?: number;
+}): number;
+
 /**
  * Scale a raw quiz score to 0–1 for the LXPack parent bridge.
  * Returns null when `score` is missing or not finite (caller should skip submit).
@@ -15,7 +29,7 @@ declare function normalizeAssessmentScore(opts: {
 }): number | null;
 /**
  * Scale a raw passing threshold to 0–1 for the LXPack parent bridge.
- * Delegates to `@lxpack/spa-bridge` (default 0.7 when omitted).
+ * Default 1.0 (100%) when omitted — matches React SPA default.
  */
 declare function normalizeAssessmentPassingScore(opts?: {
     passingScore?: number;
@@ -26,6 +40,7 @@ type BridgeAccessOptions = {
     allowedParentOrigins?: string[];
     /** LMS bridge mode; `"auto"` in production requires `allowedParentOrigins`. */
     mode?: LxpackBridgeMode;
+    onBridgeError?: (err: unknown) => void;
 };
 /** Resolve the parent frame origin when embedded (same-origin parent or document.referrer fallback). */
 declare function resolveParentOrigin(parentWindow?: Window): string | null;
@@ -41,18 +56,33 @@ declare function dispatchBridgeAction(bridge: LxpackBridgeV1, action: ReturnType
 }): void;
 type ForwardTelemetryToBridgeOptions = {
     onBridgeError?: (err: unknown) => void;
+    /** Called when assessment_completed cannot be forwarded (e.g. missing/invalid score). */
+    onBridgeMiss?: (event: TelemetryEvent) => void;
     allowedParentOrigins?: string[];
 };
+/**
+ * Map a LessonKit telemetry event to LMS bridge actions (`track`, `complete`, assessment score).
+ *
+ * @example
+ * ```ts
+ * import { forwardTelemetryToBridge } from "@lessonkit/lxpack/bridge";
+ *
+ * forwardTelemetryToBridge(event, "auto", window.parent, {
+ *   allowedParentOrigins: ["https://lms.example.com"],
+ *   onBridgeMiss: (e) => console.warn("bridge miss", e.name),
+ * });
+ * ```
+ */
 declare function forwardTelemetryToBridge(event: TelemetryEvent, mode?: LxpackBridgeMode, parentWindow?: Window, opts?: ForwardTelemetryToBridgeOptions): void;
 declare function createLxpackBridge(opts?: BridgeAccessOptions): LxpackBridgeV1 | null;
 declare function notifyLxpackLessonComplete(lessonId: LessonId, opts?: BridgeAccessOptions): boolean;
 declare function notifyLxpackCourseComplete(opts?: BridgeAccessOptions): boolean;
 /**
  * Submit assessment results to the parent LXPack bridge.
- * `score` must already be on a 0–1 scale (use `normalizeAssessmentScore` for raw points).
+ * Raw point scores are normalized to 0–1 before submission.
  */
 declare function notifyLxpackAssessment(payload: LxpackBridgeSubmitAssessmentPayload & {
     id: CheckId;
 }, opts?: BridgeAccessOptions): boolean;
 
-export { type BridgeAccessOptions, type ForwardTelemetryToBridgeOptions, type LxpackBridgeMode, createLxpackBridge, dispatchBridgeAction, forwardTelemetryToBridge, getLxpackBridge, isParentOriginAllowed, normalizeAssessmentPassingScore, normalizeAssessmentScore, notifyLxpackAssessment, notifyLxpackCourseComplete, notifyLxpackLessonComplete, resolveParentOrigin };
+export { type BridgeAccessOptions, type ForwardTelemetryToBridgeOptions, type LxpackBridgeMode, createLxpackBridge, dispatchBridgeAction, forwardTelemetryToBridge, getLxpackBridge, isParentOriginAllowed, normalizeAssessmentPassingScore, normalizeAssessmentScore, normalizePassingThreshold, normalizeScore, notifyLxpackAssessment, notifyLxpackCourseComplete, notifyLxpackLessonComplete, resolveParentOrigin };

package/dist/bridge.js

@@ -7,16 +7,12 @@ import {
 
 // src/bridge.ts
 import {
-  getLxpackBridge as getLxpackBridgeFromParent,
-  normalizePassingThreshold,
-  normalizeScore
+  getLxpackBridge as getLxpackBridgeFromParent
 } from "@lxpack/spa-bridge";
 import {
   createLxpackBridgeHost,
   DEFAULT_BRIDGE_PASSING_SCORE,
   LXPACK_BRIDGE_VERSIONS,
-  normalizePassingThreshold as normalizePassingThreshold2,
-  normalizeScore as normalizeScore2,
   supportedBridgeVersions
 } from "@lxpack/spa-bridge";
 import {
@@ -25,6 +21,41 @@ import {
   mapLessonkitTelemetryToLxpack
 } from "@lxpack/tracking-schema";
 import { mapLessonkitTelemetryToBridgeAction as mapLessonkitTelemetryToBridgeAction2 } from "@lxpack/tracking-schema";
+var DEFAULT_BRIDGE_PASSING_SCORE2 = 1;
+function clamp01(value) {
+  return Math.min(1, Math.max(0, value));
+}
+function normalizeScore(raw) {
+  const { score, maxScore } = raw;
+  if (typeof score !== "number" || !Number.isFinite(score)) return null;
+  if (typeof maxScore === "number" && maxScore <= 0) return null;
+  if (typeof maxScore === "number" && maxScore > 0) {
+    return clamp01(score / maxScore);
+  }
+  if (score > 1 && score <= 100) {
+    return clamp01(score / 100);
+  }
+  return clamp01(score);
+}
+function normalizePassingThreshold(raw) {
+  const { passingScore, maxScore } = raw ?? {};
+  if (typeof passingScore !== "number" || !Number.isFinite(passingScore)) {
+    return DEFAULT_BRIDGE_PASSING_SCORE2;
+  }
+  if (typeof maxScore === "number" && maxScore <= 0) {
+    return DEFAULT_BRIDGE_PASSING_SCORE2;
+  }
+  if (typeof maxScore === "number" && maxScore > 1) {
+    return clamp01(passingScore / maxScore);
+  }
+  if (typeof maxScore === "number" && maxScore <= 1) {
+    return clamp01(passingScore);
+  }
+  if (passingScore > 1 && passingScore <= 100) {
+    return clamp01(passingScore / 100);
+  }
+  return clamp01(passingScore);
+}
 function normalizeAssessmentScore(opts) {
   if (typeof opts.score !== "number" || !Number.isFinite(opts.score)) {
     return null;
@@ -44,13 +75,7 @@ function resolveParentOrigin(parentWindow) {
   try {
     return parent.location.origin;
   } catch {
-    const referrer = typeof document !== "undefined" ? document.referrer : "";
-    if (!referrer) return null;
-    try {
-      return new URL(referrer).origin;
-    } catch {
-      return null;
-    }
+    return null;
   }
 }
 function isProductionRuntime() {
@@ -141,13 +166,16 @@ function dispatchBridgeActionInner(bridge, action) {
       return;
   }
 }
-function forwardAssessmentCompletedToBridge(bridge, event) {
+function forwardAssessmentCompletedToBridge(bridge, event, onBridgeMiss) {
   const data = event.data;
   const scaled = normalizeAssessmentScore({
     score: data.score,
     maxScore: data.maxScore
   });
-  if (scaled === null) return;
+  if (scaled === null) {
+    onBridgeMiss?.(event);
+    return;
+  }
   bridge.submitAssessment?.({
     id: data.checkId,
     score: scaled,
@@ -167,7 +195,7 @@ function forwardTelemetryToBridge(event, mode = "auto", parentWindow, opts) {
   if (!bridge) return;
   try {
     if (event.name === "assessment_completed") {
-      forwardAssessmentCompletedToBridge(bridge, event);
+      forwardAssessmentCompletedToBridge(bridge, event, opts?.onBridgeMiss);
       return;
     }
     const answeredTrack = answeredTelemetryToBridgeTrackEvent(event);
@@ -194,20 +222,47 @@ function createLxpackBridge(opts) {
 function notifyLxpackLessonComplete(lessonId, opts) {
   const bridge = getBridge(void 0, opts);
   if (!bridge?.completeLesson) return false;
-  bridge.completeLesson(lessonId);
-  return true;
+  try {
+    bridge.completeLesson(lessonId);
+    return true;
+  } catch (err) {
+    handleBridgeError(err, opts?.onBridgeError);
+    return false;
+  }
 }
 function notifyLxpackCourseComplete(opts) {
   const bridge = getBridge(void 0, opts);
   if (!bridge?.completeCourse) return false;
-  bridge.completeCourse();
-  return true;
+  try {
+    bridge.completeCourse();
+    return true;
+  } catch (err) {
+    handleBridgeError(err, opts?.onBridgeError);
+    return false;
+  }
 }
 function notifyLxpackAssessment(payload, opts) {
   const bridge = getBridge(void 0, opts);
   if (!bridge?.submitAssessment) return false;
-  bridge.submitAssessment(payload);
-  return true;
+  const scaled = normalizeAssessmentScore({
+    score: payload.score,
+    maxScore: payload.maxScore
+  });
+  if (scaled === null) return false;
+  try {
+    bridge.submitAssessment({
+      ...payload,
+      score: scaled,
+      passingScore: normalizeAssessmentPassingScore({
+        passingScore: payload.passingScore,
+        maxScore: payload.maxScore
+      })
+    });
+    return true;
+  } catch (err) {
+    handleBridgeError(err, opts?.onBridgeError);
+    return false;
+  }
 }
 export {
   BRANCH_TELEMETRY_EVENTS,
@@ -225,8 +280,8 @@ export {
   mapLessonkitTelemetryToLxpack,
   normalizeAssessmentPassingScore,
   normalizeAssessmentScore,
-  normalizePassingThreshold2 as normalizePassingThreshold,
-  normalizeScore2 as normalizeScore,
+  normalizePassingThreshold,
+  normalizeScore,
   notifyLxpackAssessment,
   notifyLxpackCourseComplete,
   notifyLxpackLessonComplete,