@patch-adams/core 1.4.19 → 1.4.21

package/dist/index.d.cts

@@ -32,6 +32,8 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     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>;
+    /** Employee API endpoint URL for user identity lookup (e.g., https://node.example.com/admin_api/users/employees/) */
+    employeeApiEndpoint: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     enabled: boolean;
     trackMedia: boolean;
@@ -46,6 +48,7 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     courseHomepage?: string | undefined;
     lrsAuth?: string | undefined;
     lrsProxyEndpoint?: string | undefined;
+    employeeApiEndpoint?: string | undefined;
 }, {
     enabled?: boolean | undefined;
     trackMedia?: boolean | undefined;
@@ -60,6 +63,7 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     autoDetectLrs?: boolean | undefined;
     lrsAuth?: string | undefined;
     lrsProxyEndpoint?: string | undefined;
+    employeeApiEndpoint?: string | undefined;
 }>;
 /**
  * Configuration for a blocking asset (CSS before, JS before)
@@ -227,6 +231,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         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>;
+        /** Employee API endpoint URL for user identity lookup (e.g., https://node.example.com/admin_api/users/employees/) */
+        employeeApiEndpoint: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
         trackMedia: boolean;
@@ -241,6 +247,7 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         courseHomepage?: string | undefined;
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
+        employeeApiEndpoint?: string | undefined;
     }, {
         enabled?: boolean | undefined;
         trackMedia?: boolean | undefined;
@@ -255,6 +262,7 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         autoDetectLrs?: boolean | undefined;
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
+        employeeApiEndpoint?: string | undefined;
     }>>;
     /** Plugin configurations - each plugin is keyed by its name */
     plugins: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -309,6 +317,7 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         courseHomepage?: string | undefined;
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
+        employeeApiEndpoint?: string | undefined;
     };
     plugins: Record<string, z.objectOutputType<{
         /** Whether this plugin is enabled */
@@ -356,6 +365,7 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         autoDetectLrs?: boolean | undefined;
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
+        employeeApiEndpoint?: string | undefined;
     } | undefined;
     plugins?: Record<string, z.objectInputType<{
         /** Whether this plugin is enabled */

package/dist/index.d.ts

@@ -32,6 +32,8 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     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>;
+    /** Employee API endpoint URL for user identity lookup (e.g., https://node.example.com/admin_api/users/employees/) */
+    employeeApiEndpoint: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     enabled: boolean;
     trackMedia: boolean;
@@ -46,6 +48,7 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     courseHomepage?: string | undefined;
     lrsAuth?: string | undefined;
     lrsProxyEndpoint?: string | undefined;
+    employeeApiEndpoint?: string | undefined;
 }, {
     enabled?: boolean | undefined;
     trackMedia?: boolean | undefined;
@@ -60,6 +63,7 @@ declare const LrsBridgeConfigSchema: z.ZodObject<{
     autoDetectLrs?: boolean | undefined;
     lrsAuth?: string | undefined;
     lrsProxyEndpoint?: string | undefined;
+    employeeApiEndpoint?: string | undefined;
 }>;
 /**
  * Configuration for a blocking asset (CSS before, JS before)
@@ -227,6 +231,8 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         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>;
+        /** Employee API endpoint URL for user identity lookup (e.g., https://node.example.com/admin_api/users/employees/) */
+        employeeApiEndpoint: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
         trackMedia: boolean;
@@ -241,6 +247,7 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         courseHomepage?: string | undefined;
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
+        employeeApiEndpoint?: string | undefined;
     }, {
         enabled?: boolean | undefined;
         trackMedia?: boolean | undefined;
@@ -255,6 +262,7 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         autoDetectLrs?: boolean | undefined;
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
+        employeeApiEndpoint?: string | undefined;
     }>>;
     /** Plugin configurations - each plugin is keyed by its name */
     plugins: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -309,6 +317,7 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         courseHomepage?: string | undefined;
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
+        employeeApiEndpoint?: string | undefined;
     };
     plugins: Record<string, z.objectOutputType<{
         /** Whether this plugin is enabled */
@@ -356,6 +365,7 @@ declare const PatchAdamsConfigSchema: z.ZodObject<{
         autoDetectLrs?: boolean | undefined;
         lrsAuth?: string | undefined;
         lrsProxyEndpoint?: string | undefined;
+        employeeApiEndpoint?: string | undefined;
     } | undefined;
     plugins?: Record<string, z.objectInputType<{
         /** Whether this plugin is enabled */

package/dist/index.js

@@ -35,7 +35,9 @@ var LrsBridgeConfigSchema = z.object({
   /** 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()
+  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()
 });
 var BlockingAssetConfigSchema = z.object({
   /** Filename for the asset */
@@ -1270,12 +1272,32 @@ function generateLrsBridgeCode(options) {
         return;
       }
 
-      // Cache check
+      // In-memory cache check
       if (employeeLookupFetched && employeeLookupData) {
         callback(employeeLookupData);
         return;
       }
 
+      // localStorage cache check (persists across page loads / sessions)
+      var cacheKey = 'pa_employee_' + employeeId;
+      try {
+        var cached = localStorage.getItem(cacheKey);
+        if (cached) {
+          var parsed = JSON.parse(cached);
+          // TTL: 7 days = 604800000 ms
+          if (parsed.timestamp && (Date.now() - parsed.timestamp) < 604800000) {
+            log('Employee data from localStorage cache');
+            employeeLookupData = parsed;
+            employeeLookupFetched = true;
+            callback(parsed);
+            return;
+          }
+          localStorage.removeItem(cacheKey);
+        }
+      } catch (e) {
+        // localStorage unavailable (private browsing, iframe restrictions)
+      }
+
       // Build URL: endpoint should end with ? or include query param structure
       var apiUrl = EMPLOYEE_API_ENDPOINT + (EMPLOYEE_API_ENDPOINT.indexOf('?') >= 0 ? '&' : '?') + 'q=' + encodeURIComponent(employeeId);
       log('Fetching employee data from:', apiUrl);
@@ -1307,6 +1329,14 @@ function generateLrsBridgeCode(options) {
                   employeeId: employee.emp_id || employee.employeeId || employee.employee_id || employeeId
                 };
                 log('Parsed employee data:', employeeLookupData);
+                // Persist to localStorage for cross-session caching
+                try {
+                  var cacheData = {};
+                  for (var k in employeeLookupData) { if (employeeLookupData.hasOwnProperty(k)) cacheData[k] = employeeLookupData[k]; }
+                  cacheData.timestamp = Date.now();
+                  localStorage.setItem(cacheKey, JSON.stringify(cacheData));
+                  log('Employee data cached in localStorage');
+                } catch (e) { /* localStorage unavailable */ }
                 callback(employeeLookupData);
               } else {
                 callback(null);
@@ -3251,6 +3281,34 @@ function generateLrsBridgeCode(options) {
       sendStatement(statement);
     };
 
+    /**
+     * Re-extract actor from SCORM after LMSInitialize has been called.
+     * Call this from the SCORM wrapper after scormInit() succeeds,
+     * because the bridge initializes in <head> before LMSInitialize runs.
+     */
+    LRS.refreshActor = function(callback) {
+      log('refreshActor called - re-extracting from SCORM...');
+      var previousName = LRS.actor ? LRS.actor.name : 'none';
+
+      // Re-run sync extraction (SCORM data should now be available)
+      var newActor = extractActor();
+
+      if (isValidActor(newActor) && newActor.account && newActor.account.name !== 'unknown') {
+        log('refreshActor: got valid actor:', newActor.name, newActor.account ? newActor.account.name : '');
+        // Enhance with email lookup (async)
+        extractActorAsync(function(enhancedActor) {
+          if (window.console && window.console.info) {
+            console.info('[PA-LRS] Actor refreshed: ' + previousName + ' -> ' + enhancedActor.name +
+              (enhancedActor.mbox ? ' (' + enhancedActor.mbox + ')' : ''));
+          }
+          if (callback) callback(enhancedActor);
+        });
+      } else {
+        log('refreshActor: no valid actor found after re-extraction');
+        if (callback) callback(LRS.actor);
+      }
+    };
+
     // Course terminated/exited
     LRS.courseTerminated = function() {
       // Calculate duration
@@ -4255,7 +4313,8 @@ function buildJsBeforeOptions(config, metadata) {
     courseHomepage: lrsBridgeConfig.courseHomepage,
     autoDetectLrs: lrsBridgeConfig.autoDetectLrs,
     lrsAuth: lrsBridgeConfig.lrsAuth,
-    lrsProxyEndpoint: lrsBridgeConfig.lrsProxyEndpoint
+    lrsProxyEndpoint: lrsBridgeConfig.lrsProxyEndpoint,
+    employeeApiEndpoint: lrsBridgeConfig.employeeApiEndpoint
   };
   return {
     remoteUrl: `${config.remoteDomain}/${config.localFolders.js}/${config.jsBefore.filename}`,