@amplifyup/sdk 0.1.16 → 0.1.18

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as CDPAdapter, A as AmplifyUpConfig, E as EventProperties, I as IdentifyTraits, a as AmplifyUpTarget, b as EventTrackingConfig$1 } from './types-B2Swk8BW.mjs';
-export { P as PageConfig, Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, c as resolveAmplifyUpUrls } from './types-B2Swk8BW.mjs';
+import { C as CDPAdapter, A as AmplifyUpConfig, E as EventProperties, I as IdentifyTraits, a as AmplifyUpTarget, b as EventTrackingConfig$1 } from './types-Cy5aWQ5c.mjs';
+export { P as PageConfig, Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, c as resolveAmplifyUpUrls } from './types-Cy5aWQ5c.mjs';
 export { i as isComposerPreview, a as isPreviewRequest } from './preview-BMrIgUvp.mjs';
 
 /**
@@ -18,6 +18,8 @@ interface EventTrackingConfig {
     description?: string;
     properties?: string[];
     enabled?: boolean;
+    componentId?: string | null;
+    componentName?: string | null;
 }
 declare class AmplifyUpSDK {
     private adapter;
@@ -54,6 +56,9 @@ declare class AmplifyUpSDK {
     private attachedEventListeners;
     private trackingIntervals;
     private trackingCleanup;
+    private componentViewObservers;
+    private componentViewSeen;
+    private pageEngagementActive;
     constructor(adapter?: CDPAdapter);
     /**
      * Detect if we're running in visual editor mode
@@ -83,6 +88,17 @@ declare class AmplifyUpSDK {
      * Clear all tracking intervals and event listeners
      */
     private clearTrackingIntervals;
+    /** Current page path for engagement attribution. */
+    private currentPath;
+    /**
+     * Automatic page-level Scroll Depth + Time on Page (dwell heartbeat).
+     */
+    private setupPageEngagement;
+    /**
+     * Automatic Component View when component hosts enter the viewport.
+     */
+    setupComponentViewTracking(): void;
+    private cleanupComponentViewTracking;
     /**
      * Track a page view
      */
@@ -203,7 +219,11 @@ declare class AmplifyUpSDK {
      */
     private setupViewTracking;
     /**
-     * Clean up all attached event listeners
+     * Detach listeners/observers without clearing the saved event config.
+     */
+    private detachEventListeners;
+    /**
+     * Clean up all attached event listeners and clear config
      */
     cleanupEventTracking(): void;
     /**
@@ -248,6 +268,8 @@ declare class AmplifyUpSDK {
     /** Document-level drag/drop for cross-iframe drags from Composer sidebar. */
     private setupComposerDragDrop;
     private teardownComposerDragDrop;
+    private clearComposerSelection;
+    private markComposerSelection;
     /** Visual outlines for Composer (direct iframe path — no preview-frame proxy). */
     private injectComposerHighlightStyles;
     /**
@@ -258,9 +280,6 @@ declare class AmplifyUpSDK {
      * Disable component highlighting
      */
     private disableHighlighting;
-    /**
-     * Build component hierarchy for ancestor selection
-     */
     private buildComponentHierarchy;
     /**
      * Send selection message to orchestrator (includes element bounds for overlay positioning).
@@ -314,6 +333,7 @@ declare const fetchPageConfig: (route: string, preview?: boolean) => Promise<any
 declare const setupEventTracking: (config: EventTrackingConfig$1[]) => void;
 declare const cleanupEventTracking: () => void;
 declare const refreshEventTracking: () => void;
+declare const setupComponentViewTracking: () => void;
 declare const getDiagnostics: () => {
     initialized: boolean;
     instanceId: string;
@@ -349,4 +369,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, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };
+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, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CDPAdapter, A as AmplifyUpConfig, E as EventProperties, I as IdentifyTraits, a as AmplifyUpTarget, b as EventTrackingConfig$1 } from './types-B2Swk8BW.js';
-export { P as PageConfig, Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, c as resolveAmplifyUpUrls } from './types-B2Swk8BW.js';
+import { C as CDPAdapter, A as AmplifyUpConfig, E as EventProperties, I as IdentifyTraits, a as AmplifyUpTarget, b as EventTrackingConfig$1 } from './types-Cy5aWQ5c.js';
+export { P as PageConfig, Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, c as resolveAmplifyUpUrls } from './types-Cy5aWQ5c.js';
 export { i as isComposerPreview, a as isPreviewRequest } from './preview-BMrIgUvp.js';
 
 /**
@@ -18,6 +18,8 @@ interface EventTrackingConfig {
     description?: string;
     properties?: string[];
     enabled?: boolean;
+    componentId?: string | null;
+    componentName?: string | null;
 }
 declare class AmplifyUpSDK {
     private adapter;
@@ -54,6 +56,9 @@ declare class AmplifyUpSDK {
     private attachedEventListeners;
     private trackingIntervals;
     private trackingCleanup;
+    private componentViewObservers;
+    private componentViewSeen;
+    private pageEngagementActive;
     constructor(adapter?: CDPAdapter);
     /**
      * Detect if we're running in visual editor mode
@@ -83,6 +88,17 @@ declare class AmplifyUpSDK {
      * Clear all tracking intervals and event listeners
      */
     private clearTrackingIntervals;
+    /** Current page path for engagement attribution. */
+    private currentPath;
+    /**
+     * Automatic page-level Scroll Depth + Time on Page (dwell heartbeat).
+     */
+    private setupPageEngagement;
+    /**
+     * Automatic Component View when component hosts enter the viewport.
+     */
+    setupComponentViewTracking(): void;
+    private cleanupComponentViewTracking;
     /**
      * Track a page view
      */
@@ -203,7 +219,11 @@ declare class AmplifyUpSDK {
      */
     private setupViewTracking;
     /**
-     * Clean up all attached event listeners
+     * Detach listeners/observers without clearing the saved event config.
+     */
+    private detachEventListeners;
+    /**
+     * Clean up all attached event listeners and clear config
      */
     cleanupEventTracking(): void;
     /**
@@ -248,6 +268,8 @@ declare class AmplifyUpSDK {
     /** Document-level drag/drop for cross-iframe drags from Composer sidebar. */
     private setupComposerDragDrop;
     private teardownComposerDragDrop;
+    private clearComposerSelection;
+    private markComposerSelection;
     /** Visual outlines for Composer (direct iframe path — no preview-frame proxy). */
     private injectComposerHighlightStyles;
     /**
@@ -258,9 +280,6 @@ declare class AmplifyUpSDK {
      * Disable component highlighting
      */
     private disableHighlighting;
-    /**
-     * Build component hierarchy for ancestor selection
-     */
     private buildComponentHierarchy;
     /**
      * Send selection message to orchestrator (includes element bounds for overlay positioning).
@@ -314,6 +333,7 @@ declare const fetchPageConfig: (route: string, preview?: boolean) => Promise<any
 declare const setupEventTracking: (config: EventTrackingConfig$1[]) => void;
 declare const cleanupEventTracking: () => void;
 declare const refreshEventTracking: () => void;
+declare const setupComponentViewTracking: () => void;
 declare const getDiagnostics: () => {
     initialized: boolean;
     instanceId: string;
@@ -349,4 +369,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, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };
+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, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };