@patch-adams/core 1.4.16 → 1.4.19

package/dist/index.d.cts

@@ -28,6 +28,10 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     courseHomepage: z.ZodOptional<z.ZodString>;
     /** Auto-detect Bravais LRS endpoint from parent frame URL (default: true) */
     autoDetectLrs: z.ZodDefault<z.ZodBoolean>;
+    /** Basic auth credentials for LRS (Base64 encoded "username:password") - used when no cookie session exists */
+    lrsAuth: z.ZodOptional<z.ZodString>;
+    /** LRS proxy endpoint URL - statements are sent here instead of direct LRS, proxy handles auth server-side */
+    lrsProxyEndpoint: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     enabled: boolean;
     trackMedia: boolean;
@@ -40,6 +44,8 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     autoDetectLrs: boolean;
     lrsEndpoint?: string | undefined;
     courseHomepage?: string | undefined;
+    lrsAuth?: string | undefined;
+    lrsProxyEndpoint?: string | undefined;
 }, {
     enabled?: boolean | undefined;
     trackMedia?: boolean | undefined;
@@ -52,6 +58,8 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     lrsWithCredentials?: boolean | undefined;
     courseHomepage?: string | undefined;
     autoDetectLrs?: boolean | undefined;
+    lrsAuth?: string | undefined;
+    lrsProxyEndpoint?: string | undefined;
 }>;
 /**
  * Configuration for a blocking asset (CSS before, JS before)
@@ -215,6 +223,10 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         courseHomepage: z.ZodOptional<z.ZodString>;
         /** Auto-detect Bravais LRS endpoint from parent frame URL (default: true) */
         autoDetectLrs: z.ZodDefault<z.ZodBoolean>;
+        /** Basic auth credentials for LRS (Base64 encoded "username:password") - used when no cookie session exists */
+        lrsAuth: z.ZodOptional<z.ZodString>;
+        /** LRS proxy endpoint URL - statements are sent here instead of direct LRS, proxy handles auth server-side */
+        lrsProxyEndpoint: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
         trackMedia: boolean;
@@ -227,6 +239,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         autoDetectLrs: boolean;
         lrsEndpoint?: string | undefined;
         courseHomepage?: string | undefined;
+        lrsAuth?: string | undefined;
+        lrsProxyEndpoint?: string | undefined;
     }, {
         enabled?: boolean | undefined;
         trackMedia?: boolean | undefined;
@@ -239,6 +253,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsWithCredentials?: boolean | undefined;
         courseHomepage?: string | undefined;
         autoDetectLrs?: boolean | undefined;
+        lrsAuth?: string | undefined;
+        lrsProxyEndpoint?: string | undefined;
     }>>;
     /** Plugin configurations - each plugin is keyed by its name */
     plugins: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -291,6 +307,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         autoDetectLrs: boolean;
         lrsEndpoint?: string | undefined;
         courseHomepage?: string | undefined;
+        lrsAuth?: string | undefined;
+        lrsProxyEndpoint?: string | undefined;
     };
     plugins: Record<string, z.objectOutputType<{
         /** Whether this plugin is enabled */
@@ -336,6 +354,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsWithCredentials?: boolean | undefined;
         courseHomepage?: string | undefined;
         autoDetectLrs?: boolean | undefined;
+        lrsAuth?: string | undefined;
+        lrsProxyEndpoint?: string | undefined;
     } | undefined;
     plugins?: Record<string, z.objectInputType<{
         /** Whether this plugin is enabled */
@@ -950,6 +970,10 @@ interface LrsBridgeOptions {
     autoDetectLrs?: boolean;
     /** Employee API endpoint for user lookup (e.g., https://node.example.com/admin_api/users/employees/) */
     employeeApiEndpoint?: string;
+    /** Basic auth credentials for LRS (Base64 encoded "username:password") - used when no cookie session exists */
+    lrsAuth?: string;
+    /** LRS proxy endpoint URL - statements are sent here instead of direct LRS, proxy handles auth server-side */
+    lrsProxyEndpoint?: string;
 }
 declare const DEFAULT_LRS_OPTIONS: LrsBridgeOptions;
 /**

package/dist/index.d.ts

@@ -28,6 +28,10 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     courseHomepage: z.ZodOptional<z.ZodString>;
     /** Auto-detect Bravais LRS endpoint from parent frame URL (default: true) */
     autoDetectLrs: z.ZodDefault<z.ZodBoolean>;
+    /** Basic auth credentials for LRS (Base64 encoded "username:password") - used when no cookie session exists */
+    lrsAuth: z.ZodOptional<z.ZodString>;
+    /** LRS proxy endpoint URL - statements are sent here instead of direct LRS, proxy handles auth server-side */
+    lrsProxyEndpoint: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     enabled: boolean;
     trackMedia: boolean;
@@ -40,6 +44,8 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     autoDetectLrs: boolean;
     lrsEndpoint?: string | undefined;
     courseHomepage?: string | undefined;
+    lrsAuth?: string | undefined;
+    lrsProxyEndpoint?: string | undefined;
 }, {
     enabled?: boolean | undefined;
     trackMedia?: boolean | undefined;
@@ -52,6 +58,8 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     lrsWithCredentials?: boolean | undefined;
     courseHomepage?: string | undefined;
     autoDetectLrs?: boolean | undefined;
+    lrsAuth?: string | undefined;
+    lrsProxyEndpoint?: string | undefined;
 }>;
 /**
  * Configuration for a blocking asset (CSS before, JS before)
@@ -215,6 +223,10 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         courseHomepage: z.ZodOptional<z.ZodString>;
         /** Auto-detect Bravais LRS endpoint from parent frame URL (default: true) */
         autoDetectLrs: z.ZodDefault<z.ZodBoolean>;
+        /** Basic auth credentials for LRS (Base64 encoded "username:password") - used when no cookie session exists */
+        lrsAuth: z.ZodOptional<z.ZodString>;
+        /** LRS proxy endpoint URL - statements are sent here instead of direct LRS, proxy handles auth server-side */
+        lrsProxyEndpoint: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
         trackMedia: boolean;
@@ -227,6 +239,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         autoDetectLrs: boolean;
         lrsEndpoint?: string | undefined;
         courseHomepage?: string | undefined;
+        lrsAuth?: string | undefined;
+        lrsProxyEndpoint?: string | undefined;
     }, {
         enabled?: boolean | undefined;
         trackMedia?: boolean | undefined;
@@ -239,6 +253,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsWithCredentials?: boolean | undefined;
         courseHomepage?: string | undefined;
         autoDetectLrs?: boolean | undefined;
+        lrsAuth?: string | undefined;
+        lrsProxyEndpoint?: string | undefined;
     }>>;
     /** Plugin configurations - each plugin is keyed by its name */
     plugins: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -291,6 +307,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         autoDetectLrs: boolean;
         lrsEndpoint?: string | undefined;
         courseHomepage?: string | undefined;
+        lrsAuth?: string | undefined;
+        lrsProxyEndpoint?: string | undefined;
     };
     plugins: Record<string, z.objectOutputType<{
         /** Whether this plugin is enabled */
@@ -336,6 +354,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         lrsWithCredentials?: boolean | undefined;
         courseHomepage?: string | undefined;
         autoDetectLrs?: boolean | undefined;
+        lrsAuth?: string | undefined;
+        lrsProxyEndpoint?: string | undefined;
     } | undefined;
     plugins?: Record<string, z.objectInputType<{
         /** Whether this plugin is enabled */
@@ -950,6 +970,10 @@ interface LrsBridgeOptions {
     autoDetectLrs?: boolean;
     /** Employee API endpoint for user lookup (e.g., https://node.example.com/admin_api/users/employees/) */
     employeeApiEndpoint?: string;
+    /** Basic auth credentials for LRS (Base64 encoded "username:password") - used when no cookie session exists */
+    lrsAuth?: string;
+    /** LRS proxy endpoint URL - statements are sent here instead of direct LRS, proxy handles auth server-side */
+    lrsProxyEndpoint?: string;
 }
 declare const DEFAULT_LRS_OPTIONS: LrsBridgeOptions;
 /**

package/dist/index.js

@@ -31,7 +31,11 @@ var LrsBridgeConfigSchema = z.object({
   /** Course homepage IRI for xAPI context */
   courseHomepage: z.string().optional(),
   /** Auto-detect Bravais LRS endpoint from parent frame URL (default: true) */
-  autoDetectLrs: z.boolean().default(true)
+  autoDetectLrs: z.boolean().default(true),
+  /** Basic auth credentials for LRS (Base64 encoded "username:password") - used when no cookie session exists */
+  lrsAuth: z.string().optional(),
+  /** LRS proxy endpoint URL - statements are sent here instead of direct LRS, proxy handles auth server-side */
+  lrsProxyEndpoint: z.string().optional()
 });
 var BlockingAssetConfigSchema = z.object({
   /** Filename for the asset */
@@ -374,7 +378,9 @@ var DEFAULT_LRS_OPTIONS = {
   lrsWithCredentials: true,
   courseHomepage: "",
   autoDetectLrs: true,
-  employeeApiEndpoint: ""
+  employeeApiEndpoint: "",
+  lrsAuth: "",
+  lrsProxyEndpoint: ""
 };
 function generateLrsBridgeCode(options) {
   if (!options.enabled) {
@@ -386,6 +392,8 @@ function generateLrsBridgeCode(options) {
   const lrsEndpoint = options.lrsEndpoint || "";
   const courseHomepage = options.courseHomepage || "";
   const employeeApiEndpoint = options.employeeApiEndpoint || "";
+  const lrsAuth = options.lrsAuth || "";
+  const lrsProxyEndpoint = options.lrsProxyEndpoint || "";
   return `
   // ==========================================================================
   // PATCH-ADAMS LRS BRIDGE v2.2.0
@@ -398,6 +406,12 @@ function generateLrsBridgeCode(options) {
     'use strict';
 
     var DEBUG = ${options.debug};
+    // Allow URL-based debug toggle: ?pa_debug=1 or #pa_debug
+    try {
+      if (window.location.search.indexOf('pa_debug') > -1 || window.location.hash.indexOf('pa_debug') > -1) {
+        DEBUG = true;
+      }
+    } catch (e) {}
     var TRACK_MEDIA = ${options.trackMedia};
     var TRACK_NAVIGATION = ${options.trackNavigation};
     var TRACK_QUIZZES = ${options.trackQuizzes};
@@ -408,6 +422,8 @@ function generateLrsBridgeCode(options) {
     var COURSE_HOMEPAGE = '${courseHomepage}';
     var AUTO_DETECT_LRS = ${options.autoDetectLrs ?? true};
     var EMPLOYEE_API_ENDPOINT = '${employeeApiEndpoint}';
+    var LRS_AUTH = '${lrsAuth}';
+    var LRS_PROXY_ENDPOINT = '${lrsProxyEndpoint}';
 
     // Bravais LRS endpoint pattern: https://lrs-{tenant}.bravais.com/XAPI/statements
     // Example: core-acme.bravais.com -> lrs-acme.bravais.com
@@ -2767,6 +2783,17 @@ function generateLrsBridgeCode(options) {
     function sendStatement(statement) {
       log('Sending statement:', statement.verb.display['en-US'] || statement.verb.id, statement);
 
+      // Log first statement visibly (not gated by DEBUG) for production diagnostics
+      if (LRS.stats.statementsSent === 0 && LRS.stats.statementsFailed === 0 && LRS.stats.statementsQueued === 0) {
+        if (window.console && window.console.info) {
+          var verb = statement.verb.display ? (statement.verb.display['en-US'] || statement.verb.id) : statement.verb.id;
+          console.info('[PA-LRS] First statement: verb=' + verb +
+            ', endpoint=' + (LRS_ENDPOINT || 'NONE') +
+            ', proxy=' + (LRS_PROXY_ENDPOINT ? 'yes' : 'no') +
+            ', mode=' + LRS.mode);
+        }
+      }
+
       // Store in event log
       LRS.eventLog.push({
         statement: statement,
@@ -2837,24 +2864,41 @@ function generateLrsBridgeCode(options) {
     }
 
     function sendViaDirectLRS(statement) {
+      // Use proxy endpoint if configured, otherwise direct LRS
+      var useProxy = LRS_PROXY_ENDPOINT && LRS_PROXY_ENDPOINT.length > 0;
+      var endpoint = useProxy ? LRS_PROXY_ENDPOINT : LRS_ENDPOINT;
+
+      if (!endpoint || endpoint.length === 0) {
+        warn('No LRS endpoint available');
+        LRS.stats.statementsFailed++;
+        return Promise.reject(new Error('No LRS endpoint'));
+      }
+
       return new Promise(function(resolve, reject) {
         var xhr = new XMLHttpRequest();
-        xhr.open('POST', LRS_ENDPOINT, true);
+        // POST to proxy (proxy handles PUT to LRS), POST to direct LRS
+        xhr.open('POST', endpoint, true);
 
-        // xAPI required headers (Bravais LRS requires version 1.0)
+        // xAPI required headers
         xhr.setRequestHeader('Content-Type', 'application/json');
         xhr.setRequestHeader('X-Experience-API-Version', '1.0');
 
-        if (LRS_WITH_CREDENTIALS) {
+        if (useProxy) {
+          // Proxy handles auth server-side, no auth headers needed
+          log('Sending via LRS proxy:', endpoint);
+        } else if (LRS_AUTH && LRS_AUTH.length > 0) {
+          xhr.setRequestHeader('Authorization', 'Basic ' + LRS_AUTH);
+          log('Using Basic Auth for LRS request');
+        } else if (LRS_WITH_CREDENTIALS) {
           xhr.withCredentials = true;
         }
 
         xhr.onreadystatechange = function() {
           if (xhr.readyState === 4) {
             if (xhr.status >= 200 && xhr.status < 300) {
-              log('Statement sent successfully:', statement.verb.display['en-US']);
+              log('Statement sent successfully:', statement.verb.display['en-US'], useProxy ? '(via proxy)' : '(direct)');
               LRS.stats.statementsSent++;
-              resolve({ sent: true, via: 'directLRS', status: xhr.status });
+              resolve({ sent: true, via: useProxy ? 'proxy' : 'directLRS', status: xhr.status });
             } else {
               warn('Statement send failed:', xhr.status, xhr.statusText);
               LRS.stats.statementsFailed++;
@@ -3929,6 +3973,15 @@ function generateLrsBridgeCode(options) {
         LRS.mode = 'offline';
       }
 
+      // 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 +
+          ', endpoint=' + (LRS_ENDPOINT ? LRS_ENDPOINT.substring(0, 30) + '...' : 'NONE') +
+          ', proxy=' + (LRS_PROXY_ENDPOINT ? 'yes' : 'no') +
+          ', actor=' + (LRS.actor ? (LRS.actor.name || 'anonymous') : 'none'));
+      }
+
       // Set up event interceptors
       setupMediaInterceptors();
       setupNavigationInterceptors();
@@ -4200,7 +4253,9 @@ function buildJsBeforeOptions(config, metadata) {
     lrsEndpoint: lrsBridgeConfig.lrsEndpoint,
     lrsWithCredentials: lrsBridgeConfig.lrsWithCredentials,
     courseHomepage: lrsBridgeConfig.courseHomepage,
-    autoDetectLrs: lrsBridgeConfig.autoDetectLrs
+    autoDetectLrs: lrsBridgeConfig.autoDetectLrs,
+    lrsAuth: lrsBridgeConfig.lrsAuth,
+    lrsProxyEndpoint: lrsBridgeConfig.lrsProxyEndpoint
   };
   return {
     remoteUrl: `${config.remoteDomain}/${config.localFolders.js}/${config.jsBefore.filename}`,