@amplifyup/sdk 0.1.20 → 0.1.22

package/dist/index.d.mts

@@ -11,6 +11,11 @@ export { i as isComposerPreview, a as isPreviewRequest } from './preview-BMrIgUv
  * All runtime data (events, profiles, decisions) lives in AWS.
  */
 
+/**
+ * Idle gap that starts a new logical visit when a tab is reactivated.
+ * Must stay aligned with SESSION_GAP_MS in apps/orchestrator/lib/aws-profiles.ts.
+ */
+declare const SESSION_IDLE_GAP_MS: number;
 interface EventTrackingConfig {
     eventName: string;
     eventType: string;
@@ -99,7 +104,10 @@ declare class AmplifyUpSDK {
      * State lives on the instance so SPA route changes can reset milestones.
      */
     private setupPageEngagement;
+    /** Flush dwell then reset — used on SPA route changes. */
     private resetEngagementForNewPage;
+    /** Reset dwell/scroll state without emitting (idle resume already flushed on hide). */
+    private resetEngagementQuiet;
     /**
      * SPA / soft navigation: fire a page view and reset engagement.
      * No-op when the path has not changed. Safe for React Strict Mode remounts.
@@ -386,4 +394,4 @@ declare const verifyAWSConnection: () => {
 
 declare const _default: AmplifyUpSDK;
 
-export { AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, IdentifyTraits, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, getStatus, getTarget, getTrackingId, getUserId, identify, init, page, refreshEventTracking, reset, routeChange, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };
+export { AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, IdentifyTraits, SESSION_IDLE_GAP_MS, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, getStatus, getTarget, getTrackingId, getUserId, identify, init, page, refreshEventTracking, reset, routeChange, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };

package/dist/index.d.ts

@@ -11,6 +11,11 @@ export { i as isComposerPreview, a as isPreviewRequest } from './preview-BMrIgUv
  * All runtime data (events, profiles, decisions) lives in AWS.
  */
 
+/**
+ * Idle gap that starts a new logical visit when a tab is reactivated.
+ * Must stay aligned with SESSION_GAP_MS in apps/orchestrator/lib/aws-profiles.ts.
+ */
+declare const SESSION_IDLE_GAP_MS: number;
 interface EventTrackingConfig {
     eventName: string;
     eventType: string;
@@ -99,7 +104,10 @@ declare class AmplifyUpSDK {
      * State lives on the instance so SPA route changes can reset milestones.
      */
     private setupPageEngagement;
+    /** Flush dwell then reset — used on SPA route changes. */
     private resetEngagementForNewPage;
+    /** Reset dwell/scroll state without emitting (idle resume already flushed on hide). */
+    private resetEngagementQuiet;
     /**
      * SPA / soft navigation: fire a page view and reset engagement.
      * No-op when the path has not changed. Safe for React Strict Mode remounts.
@@ -386,4 +394,4 @@ declare const verifyAWSConnection: () => {
 
 declare const _default: AmplifyUpSDK;
 
-export { AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, IdentifyTraits, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, getStatus, getTarget, getTrackingId, getUserId, identify, init, page, refreshEventTracking, reset, routeChange, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };
+export { AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, IdentifyTraits, SESSION_IDLE_GAP_MS, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, getStatus, getTarget, getTrackingId, getUserId, identify, init, page, refreshEventTracking, reset, routeChange, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };

package/dist/index.js

@@ -304,6 +304,7 @@ function isComposerPreview() {
 }
 
 // src/index.ts
+var SESSION_IDLE_GAP_MS = 30 * 60 * 1e3;
 function readPreviewQueryOverrides() {
   if (typeof window === "undefined") return {};
   const params = new URLSearchParams(window.location.search);
@@ -370,7 +371,9 @@ var AmplifyUpSDK = class {
       reached: /* @__PURE__ */ new Set(),
       visibleMs: 0,
       visibleSince: null,
-      lastDwellSecondsSent: 0
+      lastDwellSecondsSent: 0,
+      /** When the tab last became hidden — used for idle-resume re-page. */
+      hiddenAt: null
     };
     this.adapter = adapter || new AWSAdapter();
     if (typeof window !== "undefined") {
@@ -601,6 +604,7 @@ var AmplifyUpSDK = class {
     state.visibleMs = 0;
     state.visibleSince = document.visibilityState === "visible" ? Date.now() : null;
     state.lastDwellSecondsSent = 0;
+    state.hiddenAt = document.visibilityState === "hidden" ? Date.now() : null;
     let scrollRaf = null;
     const path = () => this.currentPath();
     const measureScrollPercent = () => {
@@ -643,12 +647,12 @@ var AmplifyUpSDK = class {
       state.visibleMs += Date.now() - state.visibleSince;
       state.visibleSince = Date.now();
     };
-    const emitDwell = (force = false) => {
+    const emitDwell = (_force = false) => {
       if (this.isPreviewMode()) return;
       accumulateVisible();
       const seconds = Math.floor(state.visibleMs / 1e3);
       if (seconds <= 0) return;
-      if (!force && seconds <= state.lastDwellSecondsSent) return;
+      if (seconds <= state.lastDwellSecondsSent) return;
       state.lastDwellSecondsSent = seconds;
       this.track("Time on Page", {
         seconds,
@@ -658,14 +662,34 @@ var AmplifyUpSDK = class {
     this._emitPageDwell = emitDwell;
     const onVisibility = () => {
       if (document.visibilityState === "visible") {
+        const idleMs = state.hiddenAt != null ? Date.now() - state.hiddenAt : 0;
+        state.hiddenAt = null;
+        if (idleMs >= SESSION_IDLE_GAP_MS) {
+          this.resetEngagementQuiet();
+          const resumePath = path();
+          this.page(resumePath, { resumed: true });
+          this.lastTrackedPath = resumePath;
+          if (this.config?.debug) {
+            console.log(
+              "[AmplifyUp SDK] Idle resume page view",
+              resumePath,
+              `(hidden ${Math.round(idleMs / 6e4)}m)`
+            );
+          }
+        }
         state.visibleSince = Date.now();
       } else {
         emitDwell(true);
+        state.hiddenAt = Date.now();
         state.visibleSince = null;
       }
     };
     const onPageHide = () => {
       emitDwell(true);
+      if (state.hiddenAt == null) {
+        state.hiddenAt = Date.now();
+      }
+      state.visibleSince = null;
     };
     window.addEventListener("scroll", onScroll, { passive: true });
     document.addEventListener("visibilitychange", onVisibility);
@@ -694,13 +718,19 @@ var AmplifyUpSDK = class {
       console.log("[AmplifyUp SDK] Page engagement tracking enabled");
     }
   }
+  /** Flush dwell then reset — used on SPA route changes. */
   resetEngagementForNewPage() {
     const emit = this._emitPageDwell;
     emit?.(true);
+    this.resetEngagementQuiet();
+  }
+  /** Reset dwell/scroll state without emitting (idle resume already flushed on hide). */
+  resetEngagementQuiet() {
     const state = this.pageEngagementState;
     state.reached = /* @__PURE__ */ new Set();
     state.visibleMs = 0;
     state.lastDwellSecondsSent = 0;
+    state.hiddenAt = null;
     state.visibleSince = typeof document !== "undefined" && document.visibilityState === "visible" ? Date.now() : null;
     this.componentViewSeen.clear();
   }
@@ -2398,6 +2428,7 @@ var verifyAWSConnection = () => {
 var index_default = getSDK();
 
 exports.AmplifyUpSDK = AmplifyUpSDK;
+exports.SESSION_IDLE_GAP_MS = SESSION_IDLE_GAP_MS;
 exports.buildLayoutProviderUrl = buildLayoutProviderUrl;
 exports.buildPageRenderUrl = buildPageRenderUrl;
 exports.cleanupEventTracking = cleanupEventTracking;