@patch-adams/core 1.4.9 → 1.4.11

package/dist/index.cjs

@@ -2535,6 +2535,15 @@ function generateLrsBridgeCode(options) {
       ctx.extensions['http://xyleme.com/bravais/extensions/statement-schema'] = 'xyleme_10';
       ctx.extensions['http://xyleme.com/bravais/extensions/protect_pii'] = false;
 
+      // Add parent course activity for document-level aggregation in Bravais
+      // This allows statements with activity-specific objects to still be found
+      // when searching by document name in Analytics
+      var parentActivity = buildParentCourseActivity();
+      if (parentActivity) {
+        ctx.contextActivities = ctx.contextActivities || {};
+        ctx.contextActivities.parent = [parentActivity];
+      }
+
       return ctx;
     }
 
@@ -2579,18 +2588,110 @@ function generateLrsBridgeCode(options) {
 
     /**
      * Build activity object for questions in Xyleme format
+     * Name format: "Assessment Name - Q#: Question text..."
      */
     function buildQuestionActivityObject(questionInfo) {
       var questionGuid = questionInfo.questionGuid || questionInfo.id || generateUUID();
 
+      // Build human-readable display name
+      var displayName = (questionInfo.assessmentName || 'Knowledge Check');
+      if (questionInfo.questionNumber) {
+        displayName += ' - Q' + questionInfo.questionNumber;
+      }
+      var questionText = questionInfo.text || questionInfo.questionText || '';
+      if (questionText.length > 50) {
+        displayName += ': ' + questionText.substring(0, 47) + '...';
+      } else if (questionText.length > 0) {
+        displayName += ': ' + questionText;
+      }
+
       return {
         objectType: 'Activity',
         id: 'http://xyleme.com/bravais/question/' + questionGuid,
         definition: {
           type: XYLEME_ACTIVITY_TYPES.question,
-          name: { 'en-US': questionInfo.text || questionInfo.questionText || 'Question' },
+          name: { 'en-US': displayName },
+          description: { 'en-US': questionText || 'Question' },
+          extensions: {
+            resourceType: 'Question',
+            questionNumber: questionInfo.questionNumber || null
+          }
+        }
+      };
+    }
+
+    /**
+     * Build activity object for media (video/audio) with human-readable name
+     * Name format: "Video: Title" or "Audio: Title"
+     */
+    function buildMediaActivityObject(mediaInfo) {
+      var mediaGuid = mediaInfo.mediaGuid || generateUUID();
+      var mediaType = mediaInfo.type === 'audio' ? ACTIVITY_TYPES.audio : ACTIVITY_TYPES.video;
+      var resourceType = mediaInfo.type === 'audio' ? 'Audio' : 'Video';
+
+      // Build human-readable display name
+      var displayName = mediaInfo.name || '';
+      if (!displayName || displayName === 'video' || displayName === 'audio' || displayName === 'Media') {
+        displayName = resourceType + ': ' + (mediaInfo.lessonName || 'Media');
+      } else {
+        displayName = resourceType + ': ' + displayName;
+      }
+
+      return {
+        objectType: 'Activity',
+        id: 'http://xyleme.com/bravais/media/' + mediaGuid,
+        definition: {
+          type: mediaType,
+          name: { 'en-US': displayName },
+          extensions: {
+            resourceType: resourceType,
+            mediaSrc: mediaInfo.src || '',
+            mediaType: mediaInfo.type || 'video',
+            duration: mediaInfo.duration || 0
+          }
+        }
+      };
+    }
+
+    /**
+     * Build activity object for interactions (tabs, accordions, flashcards, etc.)
+     * Name format: "Tab: Label" or "Accordion: Label"
+     */
+    function buildInteractionActivityObject(interactionInfo) {
+      var typeLabels = {
+        'tab': 'Tab',
+        'accordion': 'Accordion',
+        'flashcard': 'Flashcard',
+        'hotspot': 'Hotspot',
+        'process-step': 'Process Step',
+        'process': 'Process Step',
+        'sorting': 'Sorting Activity',
+        'button': 'Button',
+        'labeled-graphic': 'Labeled Graphic',
+        'timeline': 'Timeline',
+        'scenario': 'Scenario',
+        'checklist': 'Checklist',
+        'marker': 'Marker'
+      };
+
+      var interactionType = interactionInfo.type || interactionInfo.interactionType || 'interaction';
+      var typeLabel = typeLabels[interactionType] || 'Interaction';
+
+      // Build human-readable display name
+      var displayName = interactionInfo.name;
+      if (!displayName) {
+        displayName = typeLabel + ': ' + (interactionInfo.label || interactionInfo.id || 'Item');
+      }
+
+      return {
+        objectType: 'Activity',
+        id: 'http://xyleme.com/bravais/interaction/' + (interactionInfo.id || generateUUID()),
+        definition: {
+          type: ACTIVITY_TYPES.interaction,
+          name: { 'en-US': displayName },
           extensions: {
-            resourceType: 'Question'
+            resourceType: 'Interaction',
+            interactionType: interactionType
           }
         }
       };
@@ -2797,7 +2898,8 @@ function generateLrsBridgeCode(options) {
       sendStatement(statement);
     };
 
-    // Content/Page viewed - uses document as object for Bravais aggregation
+    // Content/Page viewed - uses page-specific object for human-readable display
+    // Object shows page/lesson title, parent context maintains document aggregation
     LRS.contentOpened = function(data) {
       if (!TRACK_NAVIGATION) return;
 
@@ -2817,63 +2919,62 @@ function generateLrsBridgeCode(options) {
         lessonId = lessonId.substring(2);   // Remove '#/'
       }
 
-      // Add page info to context extensions (not as main object)
+      // Get the page title - prefer lesson name from DOM
+      var pageTitle = data.title || lessonInfo.name || 'Page';
+
+      // Build page activity object with human-readable name
+      // This shows the page/lesson title in the Object column
+      var pageObject = buildPageActivityObject({
+        pageGuid: lessonId,
+        name: pageTitle,
+        resourceType: 'Lesson'
+      });
+
+      // Add page info to context extensions
       var additionalContext = {
         extensions: {
           pageId: lessonId || 'home',
-          pageTitle: data.title || lessonInfo.name || 'Page',
+          pageTitle: pageTitle,
           lessonName: lessonInfo.name,
           sectionName: lessonInfo.sectionName,
           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,
-          lessonName: lessonInfo.name,
-          sectionName: lessonInfo.sectionName
-        },
-        result,
-        additionalContext
-      );
+      // Use 'experienced' verb for viewing content
+      // Parent course activity added by buildXylemeContext ensures document aggregation
+      var statement = buildStatementXyleme('experienced', pageObject, result, additionalContext);
       sendStatement(statement);
     };
 
-    // Media events
+    // Media events - uses activity-specific object with human-readable name
+    // Parent context (added by buildXylemeContext) ensures document aggregation
     LRS.mediaPlayed = function(data) {
       if (!TRACK_MEDIA) return;
 
       // Get current lesson context
       var lessonInfo = getCachedLessonInfo();
 
-      var mediaType = data.type === 'audio' ? ACTIVITY_TYPES.audio : ACTIVITY_TYPES.video;
       var verbKey = data.action === 'play' ? 'played' :
                     data.action === 'pause' ? 'paused' :
                     data.action === 'completed' ? 'completed' : 'played';
 
-      // Activity type is video/audio, details include media info
-      var activityDetails = {
-        mediaSrc: data.src || 'media-' + Date.now(),
-        mediaName: data.name || (data.type || 'Media'),
-        mediaType: data.type || 'video',
-        'https://w3id.org/xapi/video/extensions/length': data.duration || 0,
-        // Include lesson/section context
-        lessonId: lessonInfo.id,
-        lessonName: lessonInfo.name,
-        sectionName: lessonInfo.sectionName
-      };
+      // Build activity-specific object with human-readable name
+      // e.g., "Video: Introduction" or "Audio: Podcast Episode 1"
+      var mediaObject = buildMediaActivityObject({
+        type: data.type,
+        src: data.src,
+        name: data.name,
+        duration: data.duration,
+        lessonName: lessonInfo.name
+      });
 
       var result = {
         extensions: {
           'https://w3id.org/xapi/video/extensions/time': data.currentTime || 0,
           'https://w3id.org/xapi/video/extensions/progress': data.duration > 0 ?
-            Math.round((data.currentTime / data.duration) * 100) / 100 : 0
+            Math.round((data.currentTime / data.duration) * 100) / 100 : 0,
+          'https://w3id.org/xapi/video/extensions/length': data.duration || 0
         }
       };
 
@@ -2881,7 +2982,16 @@ function generateLrsBridgeCode(options) {
         result.completion = true;
       }
 
-      var statement = buildStatement(verbKey, mediaType, activityDetails, result);
+      // Context includes lesson info; parent course activity added by buildXylemeContext
+      var additionalContext = {
+        extensions: {
+          lessonId: lessonInfo.id,
+          lessonName: lessonInfo.name,
+          sectionName: lessonInfo.sectionName
+        }
+      };
+
+      var statement = buildStatementXyleme(verbKey, mediaObject, result, additionalContext);
       sendStatement(statement);
     };
 
@@ -3013,27 +3123,35 @@ function generateLrsBridgeCode(options) {
       LRS.assessmentEnded(data);
     };
 
-    // Interactions (tabs, accordions, etc.)
+    // Interactions (tabs, accordions, etc.) - uses activity-specific object
+    // Object name shows the interaction type and label, e.g., "Tab: Overview"
+    // Parent context ensures these appear in document search results
     LRS.interacted = function(data) {
       if (!TRACK_INTERACTIONS) return;
 
       // Get current lesson context
       var lessonInfo = getCachedLessonInfo();
 
-      // Activity type is interaction, details include interaction ID and type
-      var statement = buildStatement(
-        'interacted',
-        ACTIVITY_TYPES.interaction,
-        {
+      // Build activity-specific object with human-readable name
+      // e.g., "Tab: Getting Started", "Accordion: FAQ"
+      var interactionObject = buildInteractionActivityObject({
+        type: data.type || data.interactionType,
+        id: data.id,
+        name: data.name,
+        label: data.name || data.type
+      });
+
+      // Context includes lesson info; parent course activity added by buildXylemeContext
+      var additionalContext = {
+        extensions: {
           interactionId: data.id || 'interaction-' + Date.now(),
-          interactionName: data.name || data.type || 'Interaction',
-          interactionType: data.interactionType || data.type || 'other',
-          // Include lesson/section context
           lessonId: lessonInfo.id,
           lessonName: lessonInfo.name,
           sectionName: lessonInfo.sectionName
         }
-      );
+      };
+
+      var statement = buildStatementXyleme('interacted', interactionObject, null, additionalContext);
       sendStatement(statement);
     };