@patch-adams/core 1.5.10 → 1.5.11

package/dist/index.cjs

@@ -3403,6 +3403,48 @@ function generateLrsBridgeCode(options) {
       sendStatement(statement);
     };
 
+    // Send a course completion statement \u2014 called by skin or auto-detected via SCORM
+    LRS.sendCompletionStatement = function(data) {
+      data = data || {};
+      if (scormCompletionSent) {
+        log('Completion statement already sent (SCORM auto-detected). Skipping duplicate.');
+        return;
+      }
+      scormCompletionSent = true;
+
+      var status = data.status || 'completed';
+      var courseTitle = data.courseTitle || (LRS.courseInfo && LRS.courseInfo.title ? decodeEntities(LRS.courseInfo.title) : decodeEntities(document.title) || 'Course');
+
+      var verbKey = 'completed';
+      if (status === 'passed') verbKey = 'passed';
+      if (status === 'failed') verbKey = 'failed';
+
+      var result = { completion: true, success: (status === 'passed') };
+
+      if (typeof data.score === 'number') {
+        var max = data.scoreMax || 100;
+        var min = data.scoreMin || 0;
+        result.score = {
+          raw: data.score,
+          max: max,
+          min: min,
+          scaled: max > min ? (data.score - min) / (max - min) : 0
+        };
+      }
+
+      var activityDetails = {
+        courseTitle: courseTitle,
+        completionStatus: status,
+        employeeEmail: data.email || (LRS.actor && LRS.actor.mbox ? LRS.actor.mbox.replace('mailto:', '') : undefined),
+        employeeId: data.employeeId || LRS.employeeId || undefined
+      };
+      if (data.employeeName) activityDetails.employeeName = data.employeeName;
+
+      log('Sending completion statement:', verbKey, 'score:', result.score, 'title:', courseTitle);
+      var statement = buildStatement(verbKey, ACTIVITY_TYPES.course, activityDetails, result, null);
+      sendStatement(statement);
+    };
+
     /**
      * Re-extract actor from SCORM after LMSInitialize has been called.
      * Call this from the SCORM wrapper after scormInit() succeeds,
@@ -4073,9 +4115,37 @@ function generateLrsBridgeCode(options) {
     var scormInteractions = {};  // Pending interactions keyed by index N
     var scormInteractionsSent = {};  // Track which interactions were already sent
     var scormTrackerActive = false;  // Set true when SCORM tracker wraps SetValue \u2014 KC handler defers
+    var scormCourseData = {};  // Accumulates course-level SCORM data (score, status)
+    var scormCompletionSent = false;  // Prevent duplicate completion statements
 
     function interceptScormSetValue(key, value) {
       if (typeof key !== 'string') return;
+
+      // ---- Course-level SCORM data (score, status, completion) ----
+      // SCORM 1.2
+      if (key === 'cmi.core.score.raw') { scormCourseData.scoreRaw = parseFloat(value); }
+      if (key === 'cmi.core.score.max') { scormCourseData.scoreMax = parseFloat(value); }
+      if (key === 'cmi.core.score.min') { scormCourseData.scoreMin = parseFloat(value); }
+      if (key === 'cmi.core.lesson_status') { scormCourseData.status = String(value).toLowerCase(); }
+      // SCORM 2004
+      if (key === 'cmi.score.raw') { scormCourseData.scoreRaw = parseFloat(value); }
+      if (key === 'cmi.score.max') { scormCourseData.scoreMax = parseFloat(value); }
+      if (key === 'cmi.score.min') { scormCourseData.scoreMin = parseFloat(value); }
+      if (key === 'cmi.score.scaled') { scormCourseData.scoreScaled = parseFloat(value); }
+      if (key === 'cmi.completion_status') { scormCourseData.completionStatus = String(value).toLowerCase(); }
+      if (key === 'cmi.success_status') { scormCourseData.successStatus = String(value).toLowerCase(); }
+
+      // Fire course completion statement when status indicates pass/fail/complete
+      if ((key === 'cmi.core.lesson_status' || key === 'cmi.success_status' || key === 'cmi.completion_status') && !scormCompletionSent) {
+        var status = String(value).toLowerCase();
+        if (status === 'passed' || status === 'failed' || status === 'completed') {
+          scormCompletionSent = true;
+          // Slight delay to let score values arrive (Rise often sets score just before status)
+          setTimeout(function() { sendCourseCompletionStatement(status); }, 200);
+        }
+      }
+
+      // ---- Interaction-level tracking (existing) ----
       var interactionPattern = /^cmi\\.interactions\\.(\\d+)\\.(.+)$/;
       var match = key.match(interactionPattern);
       if (!match) return;
@@ -4175,6 +4245,51 @@ function generateLrsBridgeCode(options) {
       }
     }
 
+    function sendCourseCompletionStatement(status) {
+      logGroup('Course Completion');
+      log('Status:', status);
+      log('SCORM course data:', scormCourseData);
+
+      var courseTitle = (LRS.courseInfo && LRS.courseInfo.title) ? decodeEntities(LRS.courseInfo.title) : decodeEntities(document.title) || 'Course';
+
+      // Determine verb
+      var verbKey = 'completed';
+      if (status === 'passed') verbKey = 'passed';
+      if (status === 'failed') verbKey = 'failed';
+
+      // Build result with score
+      var result = { completion: true };
+
+      var raw = scormCourseData.scoreRaw;
+      var max = scormCourseData.scoreMax || 100;
+      var min = scormCourseData.scoreMin || 0;
+
+      if (typeof raw === 'number' && !isNaN(raw)) {
+        result.score = {
+          raw: raw,
+          max: max,
+          min: min,
+          scaled: scormCourseData.scoreScaled != null ? scormCourseData.scoreScaled : (max > min ? (raw - min) / (max - min) : 0)
+        };
+      }
+
+      result.success = (status === 'passed');
+
+      var activityDetails = {
+        courseTitle: courseTitle,
+        completionStatus: status,
+        employeeEmail: LRS.actor && LRS.actor.mbox ? LRS.actor.mbox.replace('mailto:', '') : undefined,
+        employeeId: LRS.employeeId || undefined
+      };
+
+      log('Sending course completion:', verbKey, 'score:', result.score, 'title:', courseTitle);
+
+      var statement = buildStatement(verbKey, ACTIVITY_TYPES.course, activityDetails, result, null);
+      sendStatement(statement);
+
+      logGroupEnd();
+    }
+
     function setupScormInteractionTracker() {
       if (!TRACK_QUIZZES) return;