@adtrackify/at-tracking-event-types 4.64.13 → 4.65.0

package/dist/esm/types/event/session-event.d.ts

@@ -1,323 +1,323 @@
-import { SESSION_END_REASON } from '../api/analytics/analytics-enums.js';
-import type { CloudflareCfData } from './context/event-context-cloudflare.js';
-import type { EventContext, PageInfo } from './context/event-context.js';
-import type { InternalEvent } from './base/event.js';
-import { INTERNAL_EVENT_TYPE } from './base/event.js';
-import { SESSION_EVENT_NAME } from './base/event-name-enum.js';
-export interface EdgeContext {
-    ipAddress: string;
-    userAgent: string;
-    requestHeaders: Record<string, string>;
-    cf: CloudflareCfData;
-}
-export declare enum RETURN_TIER {
-    NEW = "new",
-    RECENT_RETURN = "recent_return",
-    WARM_RETURN = "warm_return",
-    COLD_RETURN = "cold_return"
-}
-export declare enum FUNNEL_STAGE {
-    LANDING = 0,
-    BROWSE = 1,
-    PRODUCT_VIEW = 2,
-    CART = 3,
-    CHECKOUT = 4,
-    PAYMENT = 5,
-    PURCHASE = 6
-}
-export declare enum SESSION_ENGAGEMENT_CLASS {
-    BOUNCE_NO_ENGAGEMENT = "bounce_no_engagement",
-    ENGAGED_SINGLE_PAGE = "engaged_single_page",
-    BOUNCE_FRUSTRATED = "bounce_frustrated",
-    BOUNCE_QUALIFIED = "bounce_qualified",
-    LOW_ENGAGEMENT_MULTI_PAGE = "low_engagement_multi_page",
-    ENGAGED = "engaged",
-    HIGH_INTENT = "high_intent"
-}
-export declare enum FRUSTRATION_SIGNAL {
-    RAGE_CLICKS = "rage_clicks",
-    EXCESSIVE_SCROLL_UPS = "excessive_scroll_ups",
-    VERY_SHORT_DURATION = "very_short_duration",
-    NO_SCROLL_WITH_TIME = "no_scroll_with_time"
-}
-export declare enum INTENT_SIGNAL {
-    FORM_INTERACTION = "form_interaction",
-    CONTENT_COPIED = "content_copied",
-    PRODUCT_VIEWED = "product_viewed",
-    REACHED_CART = "reached_cart",
-    DEEP_SCROLL = "deep_scroll",
-    HIGH_ACTIVE_TIME = "high_active_time",
-    RETURNING_VISITOR = "returning_visitor",
-    MULTIPLE_PAGES = "multiple_pages"
-}
-export declare enum ELEMENT_INTERACTION_TYPE {
-    CTA_CLICK = "cta_click",
-    DEAD_CLICK = "dead_click",
-    RAGE_CLICK = "rage_click",
-    IMG_INTERACT = "img_interact",
-    SECTION_VIEW = "section_view",
-    FORM_FIELD = "form_field"
-}
-export interface ElementInteractionEntry {
-    type: ELEMENT_INTERACTION_TYPE;
-    selector?: string;
-    text?: string;
-    href?: string;
-    ts: number;
-    pageX?: number;
-    pageY?: number;
-    duration?: number;
-    dwellTime?: number;
-    viewDuration?: number;
-    fieldName?: string;
-    fieldType?: string;
-    imgSrc?: string;
-    imgAlt?: string;
-    deadClick?: boolean;
-    rageClick?: boolean;
-    clickCount?: number;
-}
-export interface PageContextData {
-    viewportWidth: number;
-    viewportHeight: number;
-    pageHeight: number;
-    devicePixelRatio: number;
-}
-export interface ScrollPositionSample {
-    y: number;
-    ts: number;
-}
-export interface SessionEvent extends InternalEvent {
-    type: INTERNAL_EVENT_TYPE.SESSION;
-    name: SESSION_EVENT_NAME;
-    sessionId: string;
-}
-export interface SessionInitEvent extends SessionEvent {
-    name: SESSION_EVENT_NAME.SESSION_INIT;
-    data: SessionInitData;
-}
-export interface SessionInitData {
-    userAgent: string;
-    isReturning: boolean;
-    visitCount: number;
-    daysSinceLastVisit?: number | null;
-    messageId?: string;
-    sessionStartAt?: string;
-    returnTier?: RETURN_TIER;
-    landingPage?: string;
-    pageSequence?: PageSequenceEntry[];
-}
-export interface SessionHeartbeatEvent extends SessionEvent {
-    name: SESSION_EVENT_NAME.SESSION_HEARTBEAT;
-    data: SessionHeartbeatData;
-}
-export interface SessionHeartbeatData {
-    pagePath: string;
-    activeTimeDelta: number;
-    interactionDelta: number;
-    scrollDepth: number;
-    intentScore: number;
-    resumed?: boolean;
-    page?: PageInfo;
-}
-export interface SessionPageEndEvent extends SessionEvent {
-    name: SESSION_EVENT_NAME.SESSION_PAGE_END;
-    data: SessionPageEndData;
-}
-export interface SessionPageEndData {
-    pagePath: string;
-    timeOnPage: number;
-    activeTime: number;
-    idleTime: number;
-    interactionCount: number;
-    clickCount: number;
-    keyPressCount: number;
-    swipeCount: number;
-    pinchZoomCount: number;
-    scrollDepth: number;
-    exitScrollDepth: number;
-    timeToFirstInteraction?: number;
-    timeToFirstScroll?: number;
-    scrollUpCount: number;
-    inputFieldFocusCount: number;
-    copyCount: number;
-    rapidClickCount: number;
-    pageScore: number;
-    intentScore: number;
-    intentSignals: string[];
-    elementInteractions: ElementInteractionEntry[];
-    scrollPositions: ScrollPositionSample[];
-    sessionScore?: number;
-    pageCount?: number;
-    totalActiveTime?: number;
-    landingPage?: string;
-    returnTier?: RETURN_TIER;
-    maxFunnelStage?: number;
-}
-export interface SessionRecordEvent extends SessionEvent {
-    name: SESSION_EVENT_NAME.SESSION_START | SESSION_EVENT_NAME.SESSION_END | SESSION_EVENT_NAME.SESSION_UPDATE;
-    data: SessionRecordData;
-}
-export interface SessionRecordData {
-    messageId: string;
-    pixelId_sessionId: string;
-    isFinal: boolean;
-    sessionStartAt: string;
-    sessionEndAt: string;
-    sessionDuration: number;
-    totalActiveTime: number;
-    totalIdleTime: number;
-    pageCount: number;
-    eventCount: number;
-    maxScrollDepth: number;
-    isBounce: boolean;
-    isBounceNoInteraction: boolean;
-    engagementClass?: SESSION_ENGAGEMENT_CLASS;
-    isEngagedSession?: boolean;
-    frustrationSignals?: FRUSTRATION_SIGNAL[];
-    detectedIntentSignals?: INTENT_SIGNAL[];
-    resumeCount: number;
-    sessionScore: number;
-    avgPageScore: number;
-    intentScore: number;
-    peakIntentScore: number;
-    intentSignals: string[];
-    totalInteractionCount: number;
-    totalClickCount: number;
-    totalKeyPressCount: number;
-    totalScrollUpCount: number;
-    totalInputFieldFocusCount: number;
-    totalCopyCount: number;
-    totalRapidClickCount: number;
-    totalSwipeCount: number;
-    totalPinchZoomCount: number;
-    landingPage: string;
-    exitPage: string;
-    maxFunnelStage?: number;
-    distinctProductsViewed?: number;
-    hasPurchase: boolean;
-    conversionValue: number;
-    endReason?: SESSION_END_REASON;
-    pageSequence: PageSequenceEntry[];
-    visitCount?: number;
-    daysSinceLastVisit?: number | null;
-    returnTier?: RETURN_TIER;
-}
-export interface HeartbeatResponse {
-    sessionScore: number;
-    intentScore: number;
-    sessionExpired: boolean;
-    isReturning?: boolean;
-}
-export interface SessionInitResponse {
-    sessionScore: number;
-    intentScore: number;
-    isReturning?: boolean;
-    sessionExpired?: boolean;
-    returnTier?: string;
-}
-export interface PageSequenceEntry {
-    pagePath: string;
-    enteredAt: string;
-    activeTime: number;
-    idleTime: number;
-    interactionCount: number;
-    clickCount: number;
-    keyPressCount: number;
-    swipeCount: number;
-    pinchZoomCount: number;
-    scrollDepth: number;
-    exitScrollDepth: number;
-    timeToFirstInteraction: number;
-    timeToFirstScroll: number;
-    scrollUpCount: number;
-    inputFieldFocusCount: number;
-    copyCount: number;
-    rapidClickCount: number;
-    pageScore: number;
-    intentScore: number;
-    intentSignals: string[];
-}
-export interface SessionState {
-    initialized: boolean;
-    flushed: boolean;
-    pixelId: string;
-    sessionId: string;
-    identityId?: string;
-    pixelId_sessionId: string;
-    sessionStartAt: string;
-    lastHeartbeatAt: number;
-    lastActiveHeartbeatAt: number;
-    lastSnapshotAt: number;
-    activeTimeSinceLastSnapshot: number;
-    stateChangedSinceLastSnapshot: boolean;
-    totalActiveTime: number;
-    totalIdleTime: number;
-    pageCount: number;
-    eventCount: number;
-    maxScrollDepth: number;
-    resumeCount: number;
-    sessionScore: number;
-    avgPageScore: number;
-    pageScoreSum: number;
-    pageScoreCount: number;
-    intentScore: number;
-    peakIntentScore: number;
-    intentSignals: string[];
-    totalInteractionCount: number;
-    totalClickCount: number;
-    totalKeyPressCount: number;
-    totalScrollUpCount: number;
-    totalInputFieldFocusCount: number;
-    totalCopyCount: number;
-    totalRapidClickCount: number;
-    totalSwipeCount: number;
-    totalPinchZoomCount: number;
-    landingPage: string;
-    exitPage: string;
-    referrer?: string;
-    mktSource?: string;
-    mktMedium?: string;
-    mktCampaign?: string;
-    maxFunnelStage: number;
-    distinctProductsViewed: number;
-    productPaths: string[];
-    isReturning?: boolean;
-    visitCount?: number;
-    daysSinceLastVisit?: number | null;
-    returnTier?: RETURN_TIER;
-    country?: string;
-    region?: string;
-    city?: string;
-    latitude?: number;
-    longitude?: number;
-    cfData?: CloudflareCfData;
-    requestHeaders?: Record<string, string>;
-    context?: EventContext;
-    pageSequence: PageSequenceEntry[];
-    edgeContext?: EdgeContext;
-}
-export interface SessionBounceResult {
-    isBounce: boolean;
-    isBounceNoInteraction: boolean;
-    engagementClass: SESSION_ENGAGEMENT_CLASS;
-    frustrationSignals: FRUSTRATION_SIGNAL[];
-    intentSignals: INTENT_SIGNAL[];
-    isEngagedSession: boolean;
-}
-export interface HeartbeatUpdateResult {
-    snapshotDue: boolean;
-}
-export declare enum SessionEndpoint {
-    Init = "init",
-    Heartbeat = "heartbeat",
-    Page = "page"
-}
-export declare type PixelSessionEvent = SessionInitEvent | SessionHeartbeatEvent | SessionPageEndEvent;
-export interface SessionEnvelope {
-    pixelId: string;
-    id: string;
-    sessionEvent?: PixelSessionEvent | SessionRecordEvent;
-    edgeContext?: EdgeContext;
-    _encrypted?: string;
-}
+import { SESSION_END_REASON } from '../api/analytics/analytics-enums.js';
+import type { CloudflareCfData } from './context/event-context-cloudflare.js';
+import type { EventContext, PageInfo } from './context/event-context.js';
+import type { InternalEvent } from './base/event.js';
+import { INTERNAL_EVENT_TYPE } from './base/event.js';
+import { SESSION_EVENT_NAME } from './base/event-name-enum.js';
+export interface EdgeContext {
+    ipAddress: string;
+    userAgent: string;
+    requestHeaders: Record<string, string>;
+    cf: CloudflareCfData;
+}
+export declare enum RETURN_TIER {
+    NEW = "new",
+    RECENT_RETURN = "recent_return",
+    WARM_RETURN = "warm_return",
+    COLD_RETURN = "cold_return"
+}
+export declare enum FUNNEL_STAGE {
+    LANDING = 0,
+    BROWSE = 1,
+    PRODUCT_VIEW = 2,
+    CART = 3,
+    CHECKOUT = 4,
+    PAYMENT = 5,
+    PURCHASE = 6
+}
+export declare enum SESSION_ENGAGEMENT_CLASS {
+    BOUNCE_NO_ENGAGEMENT = "bounce_no_engagement",
+    ENGAGED_SINGLE_PAGE = "engaged_single_page",
+    BOUNCE_FRUSTRATED = "bounce_frustrated",
+    BOUNCE_QUALIFIED = "bounce_qualified",
+    LOW_ENGAGEMENT_MULTI_PAGE = "low_engagement_multi_page",
+    ENGAGED = "engaged",
+    HIGH_INTENT = "high_intent"
+}
+export declare enum FRUSTRATION_SIGNAL {
+    RAGE_CLICKS = "rage_clicks",
+    EXCESSIVE_SCROLL_UPS = "excessive_scroll_ups",
+    VERY_SHORT_DURATION = "very_short_duration",
+    NO_SCROLL_WITH_TIME = "no_scroll_with_time"
+}
+export declare enum INTENT_SIGNAL {
+    FORM_INTERACTION = "form_interaction",
+    CONTENT_COPIED = "content_copied",
+    PRODUCT_VIEWED = "product_viewed",
+    REACHED_CART = "reached_cart",
+    DEEP_SCROLL = "deep_scroll",
+    HIGH_ACTIVE_TIME = "high_active_time",
+    RETURNING_VISITOR = "returning_visitor",
+    MULTIPLE_PAGES = "multiple_pages"
+}
+export declare enum ELEMENT_INTERACTION_TYPE {
+    CTA_CLICK = "cta_click",
+    DEAD_CLICK = "dead_click",
+    RAGE_CLICK = "rage_click",
+    IMG_INTERACT = "img_interact",
+    SECTION_VIEW = "section_view",
+    FORM_FIELD = "form_field"
+}
+export interface ElementInteractionEntry {
+    type: ELEMENT_INTERACTION_TYPE;
+    selector?: string;
+    text?: string;
+    href?: string;
+    ts: number;
+    pageX?: number;
+    pageY?: number;
+    duration?: number;
+    dwellTime?: number;
+    viewDuration?: number;
+    fieldName?: string;
+    fieldType?: string;
+    imgSrc?: string;
+    imgAlt?: string;
+    deadClick?: boolean;
+    rageClick?: boolean;
+    clickCount?: number;
+}
+export interface PageContextData {
+    viewportWidth: number;
+    viewportHeight: number;
+    pageHeight: number;
+    devicePixelRatio: number;
+}
+export interface ScrollPositionSample {
+    y: number;
+    ts: number;
+}
+export interface SessionEvent extends InternalEvent {
+    type: INTERNAL_EVENT_TYPE.SESSION;
+    name: SESSION_EVENT_NAME;
+    sessionId: string;
+}
+export interface SessionInitEvent extends SessionEvent {
+    name: SESSION_EVENT_NAME.SESSION_INIT;
+    data: SessionInitData;
+}
+export interface SessionInitData {
+    userAgent: string;
+    isReturning: boolean;
+    visitCount: number;
+    daysSinceLastVisit?: number | null;
+    messageId?: string;
+    sessionStartAt?: string;
+    returnTier?: RETURN_TIER;
+    landingPage?: string;
+    pageSequence?: PageSequenceEntry[];
+}
+export interface SessionHeartbeatEvent extends SessionEvent {
+    name: SESSION_EVENT_NAME.SESSION_HEARTBEAT;
+    data: SessionHeartbeatData;
+}
+export interface SessionHeartbeatData {
+    pagePath: string;
+    activeTimeDelta: number;
+    interactionDelta: number;
+    scrollDepth: number;
+    intentScore: number;
+    resumed?: boolean;
+    page?: PageInfo;
+}
+export interface SessionPageEndEvent extends SessionEvent {
+    name: SESSION_EVENT_NAME.SESSION_PAGE_END;
+    data: SessionPageEndData;
+}
+export interface SessionPageEndData {
+    pagePath: string;
+    timeOnPage: number;
+    activeTime: number;
+    idleTime: number;
+    interactionCount: number;
+    clickCount: number;
+    keyPressCount: number;
+    swipeCount: number;
+    pinchZoomCount: number;
+    scrollDepth: number;
+    exitScrollDepth: number;
+    timeToFirstInteraction?: number;
+    timeToFirstScroll?: number;
+    scrollUpCount: number;
+    inputFieldFocusCount: number;
+    copyCount: number;
+    rapidClickCount: number;
+    pageScore: number;
+    intentScore: number;
+    intentSignals: string[];
+    elementInteractions: ElementInteractionEntry[];
+    scrollPositions: ScrollPositionSample[];
+    sessionScore?: number;
+    pageCount?: number;
+    totalActiveTime?: number;
+    landingPage?: string;
+    returnTier?: RETURN_TIER;
+    maxFunnelStage?: number;
+}
+export interface SessionRecordEvent extends SessionEvent {
+    name: SESSION_EVENT_NAME.SESSION_START | SESSION_EVENT_NAME.SESSION_END | SESSION_EVENT_NAME.SESSION_UPDATE;
+    data: SessionRecordData;
+}
+export interface SessionRecordData {
+    messageId: string;
+    pixelId_sessionId: string;
+    isFinal: boolean;
+    sessionStartAt: string;
+    sessionEndAt: string;
+    sessionDuration: number;
+    totalActiveTime: number;
+    totalIdleTime: number;
+    pageCount: number;
+    eventCount: number;
+    maxScrollDepth: number;
+    isBounce: boolean;
+    isBounceNoInteraction: boolean;
+    engagementClass?: SESSION_ENGAGEMENT_CLASS;
+    isEngagedSession?: boolean;
+    frustrationSignals?: FRUSTRATION_SIGNAL[];
+    detectedIntentSignals?: INTENT_SIGNAL[];
+    resumeCount: number;
+    sessionScore: number;
+    avgPageScore: number;
+    intentScore: number;
+    peakIntentScore: number;
+    intentSignals: string[];
+    totalInteractionCount: number;
+    totalClickCount: number;
+    totalKeyPressCount: number;
+    totalScrollUpCount: number;
+    totalInputFieldFocusCount: number;
+    totalCopyCount: number;
+    totalRapidClickCount: number;
+    totalSwipeCount: number;
+    totalPinchZoomCount: number;
+    landingPage: string;
+    exitPage: string;
+    maxFunnelStage?: number;
+    distinctProductsViewed?: number;
+    hasPurchase: boolean;
+    conversionValue: number;
+    endReason?: SESSION_END_REASON;
+    pageSequence: PageSequenceEntry[];
+    visitCount?: number;
+    daysSinceLastVisit?: number | null;
+    returnTier?: RETURN_TIER;
+}
+export interface HeartbeatResponse {
+    sessionScore: number;
+    intentScore: number;
+    sessionExpired: boolean;
+    isReturning?: boolean;
+}
+export interface SessionInitResponse {
+    sessionScore: number;
+    intentScore: number;
+    isReturning?: boolean;
+    sessionExpired?: boolean;
+    returnTier?: string;
+}
+export interface PageSequenceEntry {
+    pagePath: string;
+    enteredAt: string;
+    activeTime: number;
+    idleTime: number;
+    interactionCount: number;
+    clickCount: number;
+    keyPressCount: number;
+    swipeCount: number;
+    pinchZoomCount: number;
+    scrollDepth: number;
+    exitScrollDepth: number;
+    timeToFirstInteraction: number;
+    timeToFirstScroll: number;
+    scrollUpCount: number;
+    inputFieldFocusCount: number;
+    copyCount: number;
+    rapidClickCount: number;
+    pageScore: number;
+    intentScore: number;
+    intentSignals: string[];
+}
+export interface SessionState {
+    initialized: boolean;
+    flushed: boolean;
+    pixelId: string;
+    sessionId: string;
+    identityId?: string;
+    pixelId_sessionId: string;
+    sessionStartAt: string;
+    lastHeartbeatAt: number;
+    lastActiveHeartbeatAt: number;
+    lastSnapshotAt: number;
+    activeTimeSinceLastSnapshot: number;
+    stateChangedSinceLastSnapshot: boolean;
+    totalActiveTime: number;
+    totalIdleTime: number;
+    pageCount: number;
+    eventCount: number;
+    maxScrollDepth: number;
+    resumeCount: number;
+    sessionScore: number;
+    avgPageScore: number;
+    pageScoreSum: number;
+    pageScoreCount: number;
+    intentScore: number;
+    peakIntentScore: number;
+    intentSignals: string[];
+    totalInteractionCount: number;
+    totalClickCount: number;
+    totalKeyPressCount: number;
+    totalScrollUpCount: number;
+    totalInputFieldFocusCount: number;
+    totalCopyCount: number;
+    totalRapidClickCount: number;
+    totalSwipeCount: number;
+    totalPinchZoomCount: number;
+    landingPage: string;
+    exitPage: string;
+    referrer?: string;
+    mktSource?: string;
+    mktMedium?: string;
+    mktCampaign?: string;
+    maxFunnelStage: number;
+    distinctProductsViewed: number;
+    productPaths: string[];
+    isReturning?: boolean;
+    visitCount?: number;
+    daysSinceLastVisit?: number | null;
+    returnTier?: RETURN_TIER;
+    country?: string;
+    region?: string;
+    city?: string;
+    latitude?: number;
+    longitude?: number;
+    cfData?: CloudflareCfData;
+    requestHeaders?: Record<string, string>;
+    context?: EventContext;
+    pageSequence: PageSequenceEntry[];
+    edgeContext?: EdgeContext;
+}
+export interface SessionBounceResult {
+    isBounce: boolean;
+    isBounceNoInteraction: boolean;
+    engagementClass: SESSION_ENGAGEMENT_CLASS;
+    frustrationSignals: FRUSTRATION_SIGNAL[];
+    intentSignals: INTENT_SIGNAL[];
+    isEngagedSession: boolean;
+}
+export interface HeartbeatUpdateResult {
+    snapshotDue: boolean;
+}
+export declare enum SessionEndpoint {
+    Init = "init",
+    Heartbeat = "heartbeat",
+    Page = "page"
+}
+export declare type PixelSessionEvent = SessionInitEvent | SessionHeartbeatEvent | SessionPageEndEvent;
+export interface SessionEnvelope {
+    pixelId: string;
+    id: string;
+    sessionEvent?: PixelSessionEvent | SessionRecordEvent;
+    edgeContext?: EdgeContext;
+    _encrypted?: string;
+}