@elliemae/pui-logrocket 1.1.16 → 1.1.18

package/dist/types/lib/logrocket.d.ts

@@ -21,10 +21,11 @@ export type LROptions = Parameters<typeof LogRocket.init>[1] & {
  * This function checks for user consent using multiple strategies, in the following order:
  * 1. Checks for a manual override via `window.emui.dangerouslyOverrideSessionRecordingConsent`.
  * 2. If OneTrust is loaded, checks if `window.OnetrustActiveGroups` contains the session recording group ID ('C0003').
- * 3. If OneTrust is not loaded, checks the `analyticsConsent` query parameter in the URL.
- * 4. Defaults to `false` if no consent can be determined.
+ * 3. If OneTrust is not loaded, checks the `analyticsConsent` query parameter in the current URL.
+ * 4. If running in an iframe, checks the `analyticsConsent` query parameter in the iframe's src URL.
+ * 5. Defaults to `false` if no consent can be determined.
  *
- * Note: When OneTrust is present, the OneTrust consent groups take precedence over the URL parameter.
+ * Note: When OneTrust is present, the OneTrust consent groups take precedence over URL parameters.
  * The `analyticsConsent` URL parameter only applies when OneTrust is not loaded.
  * @returns {boolean} `true` if the user has consented to session recording, `false` otherwise.
  */
@@ -43,9 +44,11 @@ declare const buildLogRocketQueryParams: () => string;
  * Initialize LogRocket with optional OneTrust integration
  *
  * This function handles LogRocket initialization with support for OneTrust consent management.
- * The initialization behavior depends on the `window.hasOneTrust` flag:
- * - If `window.hasOneTrust` is true, initialization is deferred until OneTrust SDK calls `window.onetrustCallback`
+ * The initialization behavior depends on the `window.hasOneTrust` flag and consent banner state:
+ * - If `window.hasOneTrust` is true and the consent banner hasn't been seen, waits for 'OTConsentApplied' event (until user interacts with banner)
+ * - If `window.hasOneTrust` is true and the banner was already seen, initializes immediately
  * - If `window.hasOneTrust` is false or undefined, LogRocket initializes immediately
+ * - Prevents duplicate initialization by checking `window.emui.isLogRocketInitialized`
  * @example
  * // With OneTrust (when window.hasOneTrust is true)
  * initLogRocket({