@patch-adams/core 1.3.3 → 1.3.6

package/dist/index.cjs

@@ -397,10 +397,11 @@ function generateLrsBridgeCode(options) {
   const employeeApiEndpoint = options.employeeApiEndpoint || "";
   return `
   // ==========================================================================
-  // PATCH-ADAMS LRS BRIDGE v2.1.0
+  // PATCH-ADAMS LRS BRIDGE v2.2.0
   // Full xAPI support with direct LRS communication for Rise courses
-  // ALL statements use COURSE as main object for Analytics searchability
+  // ALL statements use DOCUMENT as main object for Bravais aggregation
   // Activity type (video, assessment, etc.) stored in object.definition.type
+  // Page/lesson info stored in context.extensions for navigation tracking
   // ==========================================================================
   (function() {
     'use strict';
@@ -1569,6 +1570,132 @@ function generateLrsBridgeCode(options) {
       return null;
     }
 
+    // Store for document API data
+    var documentApiData = null;
+    var documentApiFetched = false;
+
+    /**
+     * Fetch document metadata from Bravais API to get GUIDs
+     * Endpoint: /api/v3/documents/{documentId}
+     */
+    function fetchDocumentMetadata(documentId, callback) {
+      if (!documentId) {
+        callback(null);
+        return;
+      }
+
+      if (documentApiFetched) {
+        callback(documentApiData);
+        return;
+      }
+
+      // Detect Bravais core URL
+      var coreUrl = null;
+      var urlsToCheck = [window.location.href, document.referrer];
+
+      try {
+        var win = window;
+        for (var i = 0; i < 10; i++) {
+          if (win.parent && win.parent !== win) {
+            win = win.parent;
+            try {
+              urlsToCheck.push(win.location.href);
+            } catch (e) { break; }
+          } else { break; }
+        }
+      } catch (e) {}
+
+      for (var j = 0; j < urlsToCheck.length; j++) {
+        var match = urlsToCheck[j].match(/(https?:\\/\\/core-[a-zA-Z0-9_-]+\\.bravais\\.com)/);
+        if (match) {
+          coreUrl = match[1];
+          break;
+        }
+      }
+
+      if (!coreUrl) {
+        log('No Bravais core URL detected for document metadata fetch');
+        documentApiFetched = true;
+        callback(null);
+        return;
+      }
+
+      var apiUrl = coreUrl + '/api/v3/documents/' + documentId;
+      log('Fetching document metadata from:', apiUrl);
+
+      var xhr = new XMLHttpRequest();
+      xhr.open('GET', apiUrl, true);
+      xhr.withCredentials = true;
+      xhr.setRequestHeader('Accept', 'application/json');
+
+      xhr.onreadystatechange = function() {
+        if (xhr.readyState === 4) {
+          documentApiFetched = true;
+          log('Document API response status:', xhr.status);
+          if (xhr.status >= 200 && xhr.status < 300) {
+            try {
+              documentApiData = JSON.parse(xhr.responseText);
+              log('Document metadata received:', documentApiData);
+              callback(documentApiData);
+            } catch (e) {
+              warn('Error parsing document metadata:', e);
+              callback(null);
+            }
+          } else {
+            log('Document metadata fetch failed. Status:', xhr.status);
+            callback(null);
+          }
+        }
+      };
+
+      xhr.onerror = function() {
+        documentApiFetched = true;
+        log('Network error fetching document metadata');
+        callback(null);
+      };
+
+      try {
+        xhr.send();
+      } catch (e) {
+        documentApiFetched = true;
+        warn('Error sending document request:', e);
+        callback(null);
+      }
+    }
+
+    /**
+     * Update course info with data from document API
+     */
+    function updateCourseInfoFromApi(docData) {
+      if (!docData || !LRS.courseInfo) return;
+
+      // Document GUID
+      if (docData.guid && !LRS.courseInfo.guid) {
+        LRS.courseInfo.guid = docData.guid;
+        LRS.courseInfo.id = 'http://xyleme.com/bravais/document/' + docData.guid;
+        log('Updated course guid from API:', docData.guid);
+      }
+
+      // Version GUID from latestVersion
+      if (docData.latestVersion && docData.latestVersion.guid && !LRS.courseInfo.versionGuid) {
+        LRS.courseInfo.versionGuid = docData.latestVersion.guid;
+        log('Updated version guid from API:', docData.latestVersion.guid);
+      }
+
+      // Other metadata
+      if (docData.name && LRS.courseInfo.title === 'Rise Course') {
+        LRS.courseInfo.title = docData.name;
+      }
+      if (docData.format) {
+        LRS.courseInfo.format = docData.format;
+      }
+      if (docData.resourceType) {
+        LRS.courseInfo.resourceType = docData.resourceType;
+      }
+
+      log('Course info updated from API:', LRS.courseInfo);
+    }
+
     /**
      * Extract Bravais document ID from URL
      * Pattern: /api/shared/.../files/{documentId}/scormcontent/
@@ -2269,24 +2396,41 @@ function generateLrsBridgeCode(options) {
       sendStatement(statement);
     };
 
-    // Content/Page viewed
+    // Content/Page viewed - uses document as object for Bravais aggregation
     LRS.contentOpened = function(data) {
       if (!TRACK_NAVIGATION) return;
 
-      // Build page-level activity object for Xyleme format
-      var pageObject = buildPageActivityObject({
-        pageGuid: data.pageGuid || data.lessonId,
-        name: data.title || 'Page',
-        type: 'page'
-      });
-
       var result = null;
       if (data.duration) {
         result = { duration: data.duration };
       }
 
-      // Use 'opened' verb for Xyleme compatibility (ActivityStrea.ms)
-      var statement = buildStatementXyleme('opened', pageObject, result);
+      // Extract clean page/lesson ID from Rise hash paths
+      var lessonId = data.pageGuid || data.lessonId || '';
+      if (lessonId.indexOf('#/lessons/') === 0) {
+        lessonId = lessonId.substring(10);  // Remove '#/lessons/'
+      } else if (lessonId.indexOf('#/') === 0) {
+        lessonId = lessonId.substring(2);   // Remove '#/'
+      }
+
+      // Add page info to context extensions (not as main object)
+      var additionalContext = {
+        extensions: {
+          pageId: lessonId || 'home',
+          pageTitle: data.title || 'Page',
+          pageUrl: data.url || window.location.href
+        }
+      };
+
+      // Use document as main object (required for Bravais aggregation)
+      // Use 'experienced' verb which is standard xAPI for viewing content
+      var statement = buildStatement(
+        'experienced',
+        'http://xyleme.com/bravais/activities/document',
+        { event: 'page_viewed', pageId: lessonId },
+        result,
+        additionalContext
+      );
       sendStatement(statement);
     };
 
@@ -2786,7 +2930,7 @@ function generateLrsBridgeCode(options) {
     // ========================================================================
 
     function init() {
-      log('Initializing LRS bridge v2.0.0...');
+      log('Initializing LRS bridge v2.2.0...');
 
       // Extract course info early
       extractCourseInfo();
@@ -2820,8 +2964,11 @@ function generateLrsBridgeCode(options) {
       setupQuizInterceptors();
       setupInteractionInterceptors();
 
-      // Send course launched event after a short delay to allow actor fetch
-      setTimeout(function() {
+      // Fetch document metadata from API to get GUIDs (async)
+      // Then send course launched event
+      var documentId = LRS.courseInfo ? LRS.courseInfo.documentId : null;
+
+      function sendLaunchEvents() {
         if (TRACK_NAVIGATION) {
           LRS.courseLaunched();
           LRS.contentOpened({
@@ -2830,7 +2977,21 @@ function generateLrsBridgeCode(options) {
             action: 'launched'
           });
         }
-      }, 500);
+      }
+
+      if (documentId && !LRS.courseInfo.guid) {
+        // Try to fetch GUIDs from API before sending statements
+        fetchDocumentMetadata(documentId, function(docData) {
+          if (docData) {
+            updateCourseInfoFromApi(docData);
+          }
+          // Send launch events after API fetch (success or failure)
+          setTimeout(sendLaunchEvents, 100);
+        });
+      } else {
+        // Already have GUID or no document ID - send after short delay
+        setTimeout(sendLaunchEvents, 500);
+      }
 
       // Setup beforeunload to send terminated
       window.addEventListener('beforeunload', function() {