@patch-adams/core 1.4.21 → 1.4.23

package/dist/index.d.cts

@@ -34,6 +34,10 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     lrsProxyEndpoint: z.ZodOptional<z.ZodString>;
     /** Employee API endpoint URL for user identity lookup (e.g., https://node.example.com/admin_api/users/employees/) */
     employeeApiEndpoint: z.ZodOptional<z.ZodString>;
+    /** Document GUID for xAPI statement aggregation - baked into package at wrap time */
+    documentGuid: z.ZodOptional<z.ZodString>;
+    /** Version GUID for xAPI statement aggregation - unique per export */
+    versionGuid: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     enabled: boolean;
     trackMedia: boolean;
@@ -49,6 +53,8 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     lrsAuth?: string | undefined;
     lrsProxyEndpoint?: string | undefined;
     employeeApiEndpoint?: string | undefined;
+    documentGuid?: string | undefined;
+    versionGuid?: string | undefined;
 }, {
     enabled?: boolean | undefined;
     trackMedia?: boolean | undefined;
@@ -64,6 +70,8 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     lrsAuth?: string | undefined;
     lrsProxyEndpoint?: string | undefined;
     employeeApiEndpoint?: string | undefined;
+    documentGuid?: string | undefined;
+    versionGuid?: string | undefined;
 }>;
 /**
  * Configuration for a blocking asset (CSS before, JS before)
@@ -233,6 +241,10 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsProxyEndpoint: z.ZodOptional<z.ZodString>;
         /** Employee API endpoint URL for user identity lookup (e.g., https://node.example.com/admin_api/users/employees/) */
         employeeApiEndpoint: z.ZodOptional<z.ZodString>;
+        /** Document GUID for xAPI statement aggregation - baked into package at wrap time */
+        documentGuid: z.ZodOptional<z.ZodString>;
+        /** Version GUID for xAPI statement aggregation - unique per export */
+        versionGuid: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
         trackMedia: boolean;
@@ -248,6 +260,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
         employeeApiEndpoint?: string | undefined;
+        documentGuid?: string | undefined;
+        versionGuid?: string | undefined;
     }, {
         enabled?: boolean | undefined;
         trackMedia?: boolean | undefined;
@@ -263,6 +277,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
         employeeApiEndpoint?: string | undefined;
+        documentGuid?: string | undefined;
+        versionGuid?: string | undefined;
     }>>;
     /** Plugin configurations - each plugin is keyed by its name */
     plugins: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -318,6 +334,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
         employeeApiEndpoint?: string | undefined;
+        documentGuid?: string | undefined;
+        versionGuid?: string | undefined;
     };
     plugins: Record<string, z.objectOutputType<{
         /** Whether this plugin is enabled */
@@ -366,6 +384,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
         employeeApiEndpoint?: string | undefined;
+        documentGuid?: string | undefined;
+        versionGuid?: string | undefined;
     } | undefined;
     plugins?: Record<string, z.objectInputType<{
         /** Whether this plugin is enabled */
@@ -984,6 +1004,10 @@ interface LrsBridgeOptions {
     lrsAuth?: string;
     /** LRS proxy endpoint URL - statements are sent here instead of direct LRS, proxy handles auth server-side */
     lrsProxyEndpoint?: string;
+    /** Document GUID for xAPI statement aggregation - baked into package at wrap time */
+    documentGuid?: string;
+    /** Version GUID for xAPI statement aggregation - unique per export */
+    versionGuid?: string;
 }
 declare const DEFAULT_LRS_OPTIONS: LrsBridgeOptions;
 /**

package/dist/index.d.ts

@@ -34,6 +34,10 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     lrsProxyEndpoint: z.ZodOptional<z.ZodString>;
     /** Employee API endpoint URL for user identity lookup (e.g., https://node.example.com/admin_api/users/employees/) */
     employeeApiEndpoint: z.ZodOptional<z.ZodString>;
+    /** Document GUID for xAPI statement aggregation - baked into package at wrap time */
+    documentGuid: z.ZodOptional<z.ZodString>;
+    /** Version GUID for xAPI statement aggregation - unique per export */
+    versionGuid: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     enabled: boolean;
     trackMedia: boolean;
@@ -49,6 +53,8 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     lrsAuth?: string | undefined;
     lrsProxyEndpoint?: string | undefined;
     employeeApiEndpoint?: string | undefined;
+    documentGuid?: string | undefined;
+    versionGuid?: string | undefined;
 }, {
     enabled?: boolean | undefined;
     trackMedia?: boolean | undefined;
@@ -64,6 +70,8 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     lrsAuth?: string | undefined;
     lrsProxyEndpoint?: string | undefined;
     employeeApiEndpoint?: string | undefined;
+    documentGuid?: string | undefined;
+    versionGuid?: string | undefined;
 }>;
 /**
  * Configuration for a blocking asset (CSS before, JS before)
@@ -233,6 +241,10 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsProxyEndpoint: z.ZodOptional<z.ZodString>;
         /** Employee API endpoint URL for user identity lookup (e.g., https://node.example.com/admin_api/users/employees/) */
         employeeApiEndpoint: z.ZodOptional<z.ZodString>;
+        /** Document GUID for xAPI statement aggregation - baked into package at wrap time */
+        documentGuid: z.ZodOptional<z.ZodString>;
+        /** Version GUID for xAPI statement aggregation - unique per export */
+        versionGuid: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
         trackMedia: boolean;
@@ -248,6 +260,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
         employeeApiEndpoint?: string | undefined;
+        documentGuid?: string | undefined;
+        versionGuid?: string | undefined;
     }, {
         enabled?: boolean | undefined;
         trackMedia?: boolean | undefined;
@@ -263,6 +277,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
         employeeApiEndpoint?: string | undefined;
+        documentGuid?: string | undefined;
+        versionGuid?: string | undefined;
     }>>;
     /** Plugin configurations - each plugin is keyed by its name */
     plugins: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -318,6 +334,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
         employeeApiEndpoint?: string | undefined;
+        documentGuid?: string | undefined;
+        versionGuid?: string | undefined;
     };
     plugins: Record<string, z.objectOutputType<{
         /** Whether this plugin is enabled */
@@ -366,6 +384,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
         employeeApiEndpoint?: string | undefined;
+        documentGuid?: string | undefined;
+        versionGuid?: string | undefined;
     } | undefined;
     plugins?: Record<string, z.objectInputType<{
         /** Whether this plugin is enabled */
@@ -984,6 +1004,10 @@ interface LrsBridgeOptions {
     lrsAuth?: string;
     /** LRS proxy endpoint URL - statements are sent here instead of direct LRS, proxy handles auth server-side */
     lrsProxyEndpoint?: string;
+    /** Document GUID for xAPI statement aggregation - baked into package at wrap time */
+    documentGuid?: string;
+    /** Version GUID for xAPI statement aggregation - unique per export */
+    versionGuid?: string;
 }
 declare const DEFAULT_LRS_OPTIONS: LrsBridgeOptions;
 /**

package/dist/index.js

@@ -37,7 +37,11 @@ var LrsBridgeConfigSchema = z.object({
   /** LRS proxy endpoint URL - statements are sent here instead of direct LRS, proxy handles auth server-side */
   lrsProxyEndpoint: z.string().optional(),
   /** Employee API endpoint URL for user identity lookup (e.g., https://node.example.com/admin_api/users/employees/) */
-  employeeApiEndpoint: z.string().optional()
+  employeeApiEndpoint: z.string().optional(),
+  /** Document GUID for xAPI statement aggregation - baked into package at wrap time */
+  documentGuid: z.string().optional(),
+  /** Version GUID for xAPI statement aggregation - unique per export */
+  versionGuid: z.string().optional()
 });
 var BlockingAssetConfigSchema = z.object({
   /** Filename for the asset */
@@ -382,7 +386,9 @@ var DEFAULT_LRS_OPTIONS = {
   autoDetectLrs: true,
   employeeApiEndpoint: "",
   lrsAuth: "",
-  lrsProxyEndpoint: ""
+  lrsProxyEndpoint: "",
+  documentGuid: "",
+  versionGuid: ""
 };
 function generateLrsBridgeCode(options) {
   if (!options.enabled) {
@@ -396,6 +402,8 @@ function generateLrsBridgeCode(options) {
   const employeeApiEndpoint = options.employeeApiEndpoint || "";
   const lrsAuth = options.lrsAuth || "";
   const lrsProxyEndpoint = options.lrsProxyEndpoint || "";
+  const documentGuid = options.documentGuid || "";
+  const versionGuid = options.versionGuid || "";
   return `
   // ==========================================================================
   // PATCH-ADAMS LRS BRIDGE v2.2.0
@@ -426,6 +434,8 @@ function generateLrsBridgeCode(options) {
     var EMPLOYEE_API_ENDPOINT = '${employeeApiEndpoint}';
     var LRS_AUTH = '${lrsAuth}';
     var LRS_PROXY_ENDPOINT = '${lrsProxyEndpoint}';
+    var DOCUMENT_GUID = '${documentGuid}';
+    var VERSION_GUID = '${versionGuid}';
 
     // Bravais LRS endpoint pattern: https://lrs-{tenant}.bravais.com/XAPI/statements
     // Example: core-acme.bravais.com -> lrs-acme.bravais.com
@@ -2071,6 +2081,17 @@ function generateLrsBridgeCode(options) {
         tenantHomepage: null         // https://{tenant}.bravais.com format
       };
 
+      // 0. Use baked-in GUIDs from Patch-Adams config (highest priority - set at wrap time)
+      if (DOCUMENT_GUID) {
+        info.guid = DOCUMENT_GUID;
+        info.id = 'http://xyleme.com/bravais/document/' + DOCUMENT_GUID;
+        log('Document GUID from baked-in config:', DOCUMENT_GUID);
+      }
+      if (VERSION_GUID) {
+        info.versionGuid = VERSION_GUID;
+        log('Version GUID from baked-in config:', VERSION_GUID);
+      }
+
       // 1. Extract shared link token and document ID from URL
       info.sharedLinkToken = extractSharedLinkToken();
       info.documentId = extractBravaisDocumentId();
@@ -2147,14 +2168,15 @@ function generateLrsBridgeCode(options) {
         info.title = document.title;
       }
 
-      // 7. Get from PA metadata if available
-      if (window.pa_patcher && window.pa_patcher.courseMetadata) {
-        var meta = window.pa_patcher.courseMetadata;
-        info.documentId = meta.documentId || meta.courseId || info.documentId;
-        info.guid = meta.guid || meta.courseGuid || info.guid;
-        info.versionGuid = meta.versionGuid || info.versionGuid;
-        info.title = meta.title || meta.courseTitle || info.title;
-        info.versionId = meta.versionId || info.versionId;
+      // 7. Get from PA metadata if available (check both .courseMetadata and .course)
+      var paMeta = (window.pa_patcher && window.pa_patcher.courseMetadata) ||
+                   (window.pa_patcher && window.pa_patcher.course) || null;
+      if (paMeta) {
+        info.documentId = paMeta.documentId || paMeta.courseId || info.documentId;
+        if (!info.guid) info.guid = paMeta.guid || paMeta.courseGuid || null;
+        if (!info.versionGuid) info.versionGuid = paMeta.versionGuid || null;
+        info.title = (info.title === 'Rise Course') ? (paMeta.title || paMeta.courseTitle || info.title) : info.title;
+        info.versionId = paMeta.versionId || info.versionId;
       }
 
       // 8. Build the course ID in Xyleme IRI format
@@ -3287,6 +3309,24 @@ function generateLrsBridgeCode(options) {
      * because the bridge initializes in <head> before LMSInitialize runs.
      */
     LRS.refreshActor = function(callback) {
+      // Always-visible diagnostic: confirm refreshActor is being called and show SCORM data (TEMPORARY)
+      if (window.console && window.console.info) {
+        var scormId = 'n/a', scormName = 'n/a';
+        if (LRS.scormApi) {
+          try {
+            scormId = LRS.scormApiType === '2004'
+              ? LRS.scormApi.GetValue('cmi.learner_id')
+              : LRS.scormApi.LMSGetValue('cmi.core.student_id');
+            scormName = LRS.scormApiType === '2004'
+              ? LRS.scormApi.GetValue('cmi.learner_name')
+              : LRS.scormApi.LMSGetValue('cmi.core.student_name');
+          } catch(e) { scormId = 'error'; scormName = 'error'; }
+        }
+        console.info('[PA-LRS] refreshActor called. SCORM API=' + (LRS.scormApi ? 'found' : 'MISSING') +
+          ', student_id=' + scormId +
+          ', student_name=' + scormName +
+          ', previous actor=' + (LRS.actor ? LRS.actor.name : 'none'));
+      }
       log('refreshActor called - re-extracting from SCORM...');
       var previousName = LRS.actor ? LRS.actor.name : 'none';
 
@@ -4034,10 +4074,13 @@ function generateLrsBridgeCode(options) {
       // Always-visible bridge summary (not gated by DEBUG)
       // This ensures diagnostics are available even in production builds
       if (window.console && window.console.info) {
-        console.info('[PA-LRS] Bridge: mode=' + LRS.mode +
+        console.info('[PA-LRS] Bridge v' + LRS.version + ': mode=' + LRS.mode +
           ', endpoint=' + (LRS_ENDPOINT ? LRS_ENDPOINT.substring(0, 30) + '...' : 'NONE') +
           ', proxy=' + (LRS_PROXY_ENDPOINT ? 'yes' : 'no') +
-          ', actor=' + (LRS.actor ? (LRS.actor.name || 'anonymous') : 'none'));
+          ', docGuid=' + (DOCUMENT_GUID || 'NONE') +
+          ', verGuid=' + (VERSION_GUID || 'NONE') +
+          ', actor=' + (LRS.actor ? (LRS.actor.name || 'anonymous') : 'none') +
+          ', hasRefreshActor=' + (typeof LRS.refreshActor === 'function'));
       }
 
       // Set up event interceptors
@@ -4314,7 +4357,9 @@ function buildJsBeforeOptions(config, metadata) {
     autoDetectLrs: lrsBridgeConfig.autoDetectLrs,
     lrsAuth: lrsBridgeConfig.lrsAuth,
     lrsProxyEndpoint: lrsBridgeConfig.lrsProxyEndpoint,
-    employeeApiEndpoint: lrsBridgeConfig.employeeApiEndpoint
+    employeeApiEndpoint: lrsBridgeConfig.employeeApiEndpoint,
+    documentGuid: lrsBridgeConfig.documentGuid,
+    versionGuid: lrsBridgeConfig.versionGuid
   };
   return {
     remoteUrl: `${config.remoteDomain}/${config.localFolders.js}/${config.jsBefore.filename}`,