@atlaskit/react-ufo 5.1.3 → 5.2.0

package/AGENTS.md

@@ -0,0 +1,426 @@
+# AGENTS.md - React UFO (@atlaskit/react-ufo)
+
+## Overview
+
+React UFO (User-Facing Observability) is a performance instrumentation library that captures key user experience metrics across Atlassian products. It produces structured performance events that are consumed by downstream analytics systems, primarily the **Glance (Performance Portal)** system.
+
+## Team & Product Context
+
+- **Team**: Frontend Observability (FeObs) — provides end-to-end solutions for frontend observability (performance + reliability)
+- **Product**: Glance (formerly Performance Portal) — the one-stop shop for frontend performance data at Atlassian
+- **Mission**: Make performance data available, accountable, and actionable
+- **Support channel**: `#help-devinfra-fe-observability` (Slack)
+- **Jira project**: AFO on `product-fabric.atlassian.net`
+- **Shortlinks**: `go/glance`, `go/feo`
+- **Package**: `@atlaskit/react-ufo`
+
+## Architecture
+
+### Local Package Architecture
+
+```mermaid
+graph TD
+    subgraph "React Application"
+        A[traceUFOPageLoad / traceUFOTransition / traceUFOPress] --> B[InteractionMetrics]
+        C[UFOSegment] --> B
+        D[UFOLoadHold] --> B
+        E[UFOLabel] --> B
+        F[Custom Data/Timings] --> B
+    end
+    
+    subgraph "React UFO Core"
+        B --> G[VCObserver - Visual Completion]
+        B --> H[HoldTracking]
+        B --> I[ReactProfiler]
+        G --> J[createPayload]
+        H --> J
+        I --> J
+    end
+    
+    subgraph "Output"
+        J --> K[GASv3 Analytics Events]
+        K --> L[Performance Portal / Databricks]
+    end
+```
+
+### End-to-End Data Pipeline
+
+React UFO is the **client-side instrumentation** in a larger data pipeline:
+
+```mermaid
+graph LR
+    subgraph "Client Instrumentation"
+        A[React UFO in Products]
+    end
+    
+    subgraph "Transport Layer"
+        B[GASv3 analytics-service]
+        C[StreamHub / Kinesis]
+    end
+    
+    subgraph "Event Processing - perf-portal-monorepo"
+        D[UFO Service - splits events]
+        E[BM Data Pipeline]
+    end
+    
+    subgraph "Data Storage"
+        F[Socrates - data lake]
+        G[Databricks - aggregation]
+    end
+    
+    subgraph "Data Serving"
+        H[Perf Portal GQL]
+        I[Glance UI]
+    end
+    
+    A --> B --> C --> D --> E --> F --> G --> H --> I
+```
+
+**Key Pipeline Details:**
+- **UFO Service** splits root interactions from page segments (e.g., `jira.fe.page-load.issue-view` generates multiple `jira.fe.page-segment-load.*` events)
+- **Databricks** has streaming (high-resolution) and daily aggregation jobs
+- **External dependencies**: Socrates (data lake), Observo (high-cardinality data), SignalFx (metrics/alerting)
+
+## Key Concepts
+
+### Interaction Types
+- **`page_load`**: Initial page rendering measurement
+- **`transition`**: SPA navigation between routes
+- **`press`**: User click/tap interactions
+- **`hover`**: Mouse hover interactions
+- **`typing`**: Keyboard input performance
+
+### Core Metrics
+- **TTI (Time to Interactive)**: Legacy metric from BM3 (Browser Metrics 3)
+- **TTAI (Time to All Interactive)**: When all holds are released
+- **TTVC (Time to Visual Completion)**: When visual changes stabilize at various thresholds (VC50, VC80, VC90, VC99)
+- **FMP (First Meaningful Paint)**: When primary content is visible
+- **Speed Index**: Weighted average of visual progress over time
+
+### TTVC Revisions
+The package supports multiple TTVC calculation algorithms:
+- `fy25.01`, `fy25.02`: Legacy revisions
+- `fy25.03`: Current default revision (`DEFAULT_TTVC_REVISION`)
+- `fy26.04`, `next`: Experimental revisions
+
+## Directory Structure
+
+```
+src/
+├── trace-pageload/        # Page load interaction initialization
+├── trace-transition/      # SPA transition tracking
+├── trace-press/           # Press interaction tracking
+├── trace-interaction/     # Generic interaction tracing
+├── trace-redirect/        # Route redirect tracking
+├── trace-hover/           # Hover interaction tracking
+├── interaction-metrics/   # Core interaction state management
+├── create-payload/        # Analytics payload generation
+├── vc/                    # Visual Completion observer system
+│   ├── vc-observer/       # Legacy VC observer (fy25.01, fy25.02)
+│   └── vc-observer-new/   # New VC observer (fy25.03+)
+├── segment/               # UFOSegment component
+├── load-hold/             # UFOLoadHold component
+├── label/                 # UFOLabel component
+├── config/                # Configuration management
+├── custom-data/           # Custom data injection
+├── custom-cohort-data/    # Cohort data for A/B testing
+├── custom-timings/        # Custom timing tracking
+├── custom-spans/          # Custom span tracking
+├── feature-flags-accessed/ # Feature flag correlation
+├── ssr/                   # SSR timing integration
+├── suspense/              # Instrumented React Suspense
+├── placeholder/           # Lazy loading placeholder integration
+├── report-error/          # Error reporting utilities
+├── set-interaction-error/ # Interaction error handling
+├── set-terminal-error/    # Terminal error handling
+└── common/                # Shared types and utilities
+```
+
+## Key Entry Points
+
+### Interaction Initialization
+- [`traceUFOPageLoad`](./src/trace-pageload/index.ts) - Start page load measurement
+- [`traceUFOTransition`](./src/trace-transition/index.ts) - Start transition measurement
+- [`traceUFOPress`](./src/trace-press/index.ts) - Start press interaction measurement
+- [`traceUFOInteraction`](./src/trace-interaction/index.ts) - Generic interaction from browser events
+- [`traceUFORedirect`](./src/trace-redirect/index.ts) - Track route redirects
+
+### React Components
+- [`UFOSegment`](./src/segment/segment.tsx) - Define measurable page sections
+- [`UFOLoadHold`](./src/load-hold/UFOLoadHold.tsx) - Hold interaction completion during loading
+- [`UFOLabel`](./src/label/UFOLabel.tsx) - Annotate component tree for debugging
+- [`Suspense`](./src/suspense/Suspense.tsx) - Instrumented React Suspense boundary
+- [`UFOCustomData`](./src/custom-data/index.ts) - Add custom data to interactions
+- [`UFOCustomCohortData`](./src/custom-cohort-data/index.ts) - Add cohort data for experiments
+
+### Configuration
+- [`setUFOConfig`](./src/config/index.ts) - Configure UFO behavior, sampling rates, and features
+
+### Payload Generation
+- [`createPayloads`](./src/create-payload/index.ts) - Generate analytics payloads from interaction data
+
+## Payload Schema
+
+Events are sent with `experience:key` of `custom.interaction-metrics` and follow the schema defined in [`react-ufo-payload-schema.ts`](./src/common/react-ufo-payload-schema.ts).
+
+Key payload fields:
+- `experience:name` - The UFO interaction name (e.g., `issue-view`)
+- `interactionMetrics.type` - Interaction type (page_load, transition, press, etc.)
+- `interactionMetrics.start/end` - Timing boundaries
+- `interactionMetrics.segments` - Measured page sections
+- `interactionMetrics.holdInfo` - Loading hold timings
+- `interactionMetrics.errors` - Captured errors during interaction
+- `ufo:vc:rev` - Visual completion revision data
+- `ufo:vc:ratios` - VC percentage at various thresholds
+- `metric:ttai` - Time to All Interactive
+- `metric:fp`, `metric:fcp`, `metric:lcp` - Paint metrics
+
+## Downstream Consumer: Glance (Performance Portal)
+
+The events produced by this package are consumed by the **Glance** system (https://bitbucket.org/atlassian/perf-portal-monorepo):
+
+### perf-portal-monorepo Apps
+
+| App | Purpose | Role in Pipeline |
+|-----|---------|------------------|
+| `apps/ufo` | UFO event processing service | Event Ingestion & Splitting |
+| `apps/bm-data-pipeline` | Browser Metrics data pipeline | Event Processing (BM3) |
+| `apps/databricks-jobs` | Data aggregation notebooks | Data Aggregation |
+| `apps/perf-portal-gql` | GraphQL API server | Data Serving + Alerts |
+| `apps/performance-portal` | React frontend (Glance UI) | Data Visualization |
+
+### Event Flow
+
+```mermaid
+sequenceDiagram
+    participant App as Atlassian Product
+    participant UFO as React UFO
+    participant GAS as GASv3 Analytics
+    participant Stream as StreamHub/Kinesis
+    participant UFOSvc as UFO Service
+    participant DB as Databricks
+    participant GQL as Perf Portal GQL
+    participant UI as Glance UI
+    
+    App->>UFO: traceUFOPageLoad('issue-view')
+    UFO->>UFO: Measure TTAI, TTVC
+    UFO->>GAS: Send interaction-metrics event
+    GAS->>Stream: Forward to Kinesis
+    Stream->>UFOSvc: Process event
+    UFOSvc->>UFOSvc: Split root + segments
+    UFOSvc->>DB: Streaming aggregation
+    DB->>DB: Daily aggregation
+    DB->>GQL: Query aggregated data
+    GQL->>UI: GraphQL response
+    UI->>UI: Display dashboards
+```
+
+### What Glance Provides
+
+1. **Topline Metrics**: FMP, TTVC, TTAI dashboards
+2. **Experience Breakdown**: Per-route performance analysis
+3. **Segment Analysis**: Component-level timing breakdown
+4. **Regression Detection**: Automated performance alerts
+5. **P-BREACH Tickets**: Automatic Jira tickets for regressions
+6. **AI Investigation**: LLM-powered regression analysis
+
+## Feature Flags
+
+The package uses platform feature flags for gradual rollouts. Key flags are defined in [`package.json`](./package.json):
+
+| Flag | Purpose |
+|------|---------|
+| `platform_ufo_enable_ttai_with_3p` | Third-party segment timing |
+| `platform_ufo_enable_vc_raw_data` | Raw VC data inclusion |
+| `platform_ufo_segment_critical_metrics` | Segment-level metrics |
+| `platform_ufo_enable_terminal_errors` | Terminal error tracking |
+| `platform_ufo_raw_data_thirdparty` | Third-party raw data behavior |
+| `platform_ufo_enable_finish_interaction_transition` | Finish interaction on transition |
+
+## Testing
+
+### Unit Tests
+```bash
+cd platform && afm test unit packages/react-ufo/atlaskit/src/<test-file>
+# Or run all:
+cd platform && yarn test packages/react-ufo
+```
+
+### Integration Tests
+```bash
+# Terminal 1: Start dev server
+cd platform && yarn start:rspack react-ufo
+
+# Terminal 2: Run integration tests
+cd platform && yarn test:integration packages/react-ufo/atlaskit/__tests__/ \
+  --retries 0 --reporter list --reuse-dev-server \
+  --project=desktop-chromium --max-failures=0
+```
+
+### Verifying Non-Flaky Tests
+To simulate CI-like environment:
+```bash
+yarn test:integration packages/react-ufo/atlaskit/__tests__/playwright/base.spec.ts \
+  --retries 0 --reporter list --reuse-dev-server \
+  --project=desktop-chromium --max-failures=0 \
+  --repeat-each 50 --workers 50
+```
+
+Integration tests are located in `__tests__/playwright/` and use example pages from `examples/`.
+
+## Common Tasks
+
+### Adding a New Interaction Type
+1. Create trace function in `src/trace-{type}/`
+2. Update `InteractionType` in common types
+3. Add configuration support in `src/config/`
+4. Update payload generation in `src/create-payload/`
+
+### Modifying VC Calculation
+1. VC observers are in `src/vc/vc-observer-new/` (current) and `src/vc/vc-observer/` (legacy)
+2. Revisions are controlled by `enabledVCRevisions` config
+3. Test changes against existing integration tests
+
+### Adding Custom Metrics
+1. Use `addUFOCustomData` for custom attributes
+2. Use `addCustomTiming` for custom timing spans
+3. Custom data appears in payload under `interactionMetrics.customData`
+
+### Adding Feature Flags
+1. Import `fg` from `@atlaskit/platform-feature-flags`
+2. Register flag in `package.json` under `platform-feature-flags`
+3. Put fg check as **last condition** in if statements: `if (a === b && fg('my_fg'))`
+
+## Important Patterns
+
+### Singleton Pattern
+The package uses a singleton pattern for global state:
+```typescript
+// VCObserver is global per interaction
+globalThis.__vcObserver = new VCObserverWrapper(opts);
+
+// Config is module-level singleton
+let config: Config | undefined;
+```
+
+### Hold System
+Holds prevent interaction completion until all loading states resolve:
+```typescript
+// Hold is added when loading starts
+const release = addHold(interactionId, labelStack, 'my-loading');
+
+// Hold is released when loading completes
+release();
+```
+
+### Segment Tree
+Segments are tracked hierarchically for nested measurement:
+```typescript
+// Parent segment
+<UFOSegment name="page">
+  // Child segment
+  <UFOSegment name="sidebar">
+    <Content />
+  </UFOSegment>
+</UFOSegment>
+```
+
+### Third-Party Segments
+For external/plugin content:
+```typescript
+import { UFOThirdPartySegment } from '@atlaskit/react-ufo/segment';
+
+<UFOThirdPartySegment name="external-widget">
+  <ExternalWidget />
+</UFOThirdPartySegment>
+```
+
+## Debugging
+
+### Performance Tracing
+Enable Chrome DevTools performance tracing:
+```typescript
+window.__REACT_UFO_ENABLE_PERF_TRACING = true;
+```
+
+### Event Inspection
+Listen for interaction completion:
+```typescript
+window.addEventListener('UFO_FINISH_INTERACTION', (event) => {
+  console.log('UFO interaction finished:', event.detail);
+});
+```
+
+### Chrome Extension
+Use the **UFO Chrome Extension** (`apps/ufo-chrome-extension` in perf-portal-monorepo) for DevTools integration.
+
+## Related Packages
+
+| Package | Purpose |
+|---------|---------|
+| `@atlaskit/react-ufo` | Core UFO instrumentation (this package) |
+| `ufo-load-hold` | Standalone load hold component |
+| `ufo-apollo-log` | Apollo Client integration |
+| `ufo-resource-router-log` | react-resource-router integration |
+| `ufo-use-layout-effect-safe` | SSR-safe useLayoutEffect |
+
+## Key Confluence References
+
+| Topic | Link |
+|-------|------|
+| Team Home (FeObs) | `go/feo` |
+| Glance Product Page | `go/glance` |
+| Data Architecture Diagram | `go/glance-data-architecture` |
+| UFO Pipeline Architecture | [UFO Design - M1 Pipeline Architecture](https://hello.atlassian.net/wiki/spaces/UFO/pages/1050787866) |
+| Team Onboarding | [Onboarding](https://hello.atlassian.net/wiki/spaces/APD/pages/1386514416) |
+| React UFO Onboarding | [React UFO and UFO Onboarding](https://hello.atlassian.net/wiki/spaces/APD/pages/3615063023) |
+| React UFO v2 Design | [react-ufo UFO v2](https://hello.atlassian.net/wiki/spaces/UFO/pages/2305847386) |
+| Performance Blog | [react-UFO: A deeper understanding of performance](https://hello.atlassian.net/wiki/spaces/UFO/blog/2022/12/16/2280380649) |
+
+## Configuration Reference
+
+Key configuration options in `setUFOConfig`:
+
+```typescript
+interface Config {
+  product: string;              // Product identifier (e.g., 'jira', 'confluence')
+  region: string;               // Deployment region
+  population?: string;          // Event population for segmentation
+  rates?: Record<string, number>;  // Sampling rates per experience
+  kind?: Record<InteractionKind, number>; // Rates by interaction type
+  vc?: {
+    enabled?: boolean;
+    enabledVCRevisions?: {
+      all: TTVCRevision[];
+      byExperience?: Record<string, TTVCRevision[]>;
+    };
+    heatmapSize?: number;
+    selectorConfig?: SelectorConfig;
+  };
+  ssr?: {
+    getSSRTimings?: () => SSRTiming[];
+    getSSRDoneTime?: () => number | undefined;
+  };
+  postInteractionLog?: { enabled?: boolean; rates?: Rates; };
+  experimentalInteractionMetrics?: { enabled?: boolean; rates?: Rates; };
+  terminalErrors?: { enabled?: boolean; };
+}
+```
+
+## Contributing
+
+When making changes:
+1. Run unit tests: `cd platform && yarn test packages/react-ufo`
+2. Run integration tests to verify VC measurement accuracy
+3. Consider impact on downstream Glance/Performance Portal processing
+4. Update sampling rates carefully as they affect data volume
+5. Feature flag new functionality for gradual rollout
+6. Coordinate with the FeObs team (`#help-devinfra-fe-observability`) for major changes
+
+## Dangerous Operations — Never Do These
+
+1. **Never modify sampling rates without approval** — affects data volume and costs
+2. **Never change payload schema without coordination** — breaks downstream processing
+3. **Never remove TTVC revisions** — experiences may depend on specific revisions
+4. **Never disable holds without understanding impact** — affects TTAI accuracy
+5. **Never add blocking operations in hot paths** — affects user performance

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @atlaskit/ufo-interaction-ignore
 
+## 5.2.0
+
+### Minor Changes
+
+- [`b7f9d9f2e93dc`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/b7f9d9f2e93dc) -
+  Detect browser throttling in UFO client
+
+### Patch Changes
+
+- [`03e2c7f2a7b38`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/03e2c7f2a7b38) -
+  Remove `featureFlags` field in the list of fields trimmed in the event of payload size exceeding
+  240KB
+
+## 5.1.4
+
+### Patch Changes
+
+- [`aa7b28d013b4f`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/aa7b28d013b4f) -
+  Add Speed Index metric using TTVC v4 ruleset
+- [`e565e9abbe8fd`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/e565e9abbe8fd) -
+  Added Previous Interaction information to terminal error metric
+
 ## 5.1.3
 
 ### Patch Changes

package/dist/cjs/create-payload/index.js

@@ -9,13 +9,13 @@ try{return acc+item.cssRules.length;}catch(_unused3){return acc;}},0);var styleE
 getInitialPageLoadSSRMetrics=function getInitialPageLoadSSRMetrics(){var _config$ssr;if(!isPageLoad){return{};}var config=(0,_config.getConfig)();var SSRDoneTimeValue=(0,_getSsrDoneTimeValue.default)(config);var SSRDoneTime=SSRDoneTimeValue!==undefined?{SSRDoneTime:Math.round(SSRDoneTimeValue)}:{};var isBM3ConfigSSRDoneAsFmp=interaction.metaData.__legacy__bm3ConfigSSRDoneAsFmp;var isUFOConfigSSRDoneAsFmp=interaction.metaData.__legacy__bm3ConfigSSRDoneAsFmp||!!(config!==null&&config!==void 0&&(_config$ssr=config.ssr)!==null&&_config$ssr!==void 0&&_config$ssr.getSSRDoneTime);if(!experimental&&(isBM3ConfigSSRDoneAsFmp||isUFOConfigSSRDoneAsFmp)&&SSRDoneTimeValue!==undefined){try{performance.mark("FMP",{startTime:SSRDoneTimeValue,detail:{devtools:{dataType:'marker'}}});}catch(_unused6){}}return _objectSpread(_objectSpread({},SSRDoneTime),{},{isBM3ConfigSSRDoneAsFmp:isBM3ConfigSSRDoneAsFmp,isUFOConfigSSRDoneAsFmp:isUFOConfigSSRDoneAsFmp});};pageLoadInteractionMetrics=getInitialPageLoadSSRMetrics();// Detailed payload. Page visibility = visible
 getDetailedInteractionMetrics=function getDetailedInteractionMetrics(resourceTimings){if(experimental||window.__UFO_COMPACT_PAYLOAD__||!isDetailedPayload){return{};}var spans=[].concat((0,_toConsumableArray2.default)(interaction.spans),(0,_toConsumableArray2.default)(_interactionMetrics.interactionSpans));_interactionMetrics.interactionSpans.length=0;var shouldInclude3pHolds=(0,_config.shouldUseRawDataThirdPartyBehavior)(ufoName,type);var basePayload={errors:interaction.errors.map(function(_ref2){var labelStack=_ref2.labelStack,others=(0,_objectWithoutProperties2.default)(_ref2,_excluded);return _objectSpread(_objectSpread({},others),{},{labelStack:labelStack&&(0,_utils.optimizeLabelStack)(labelStack,(0,_getReactUfoPayloadVersion.getReactUFOPayloadVersion)(interaction.type))});}),holdActive:(0,_toConsumableArray2.default)(interaction.holdActive.values()),redirects:optimizeRedirects(interaction.redirects,start),holdInfo:(0,_optimizeHoldInfo.optimizeHoldInfo)(experimental?interaction.holdExpInfo:interaction.holdInfo,start,(0,_getReactUfoPayloadVersion.getReactUFOPayloadVersion)(interaction.type)),spans:(0,_optimizeSpans.optimizeSpans)(spans,start,(0,_getReactUfoPayloadVersion.getReactUFOPayloadVersion)(interaction.type)),requestInfo:(0,_optimizeRequestInfo.optimizeRequestInfo)(interaction.requestInfo,start,(0,_getReactUfoPayloadVersion.getReactUFOPayloadVersion)(interaction.type)),customTimings:(0,_optimizeCustomTimings.optimizeCustomTimings)(interaction.customTimings,start),bundleEvalTimings:objectToArray(getBundleEvalTimings(start)),resourceTimings:objectToArray(resourceTimings)};// Include third-party holds when feature flag is active
 if(shouldInclude3pHolds){var _interaction$hold3pIn;return _objectSpread(_objectSpread({},basePayload),{},{hold3pActive:interaction.hold3pActive?(0,_toConsumableArray2.default)(interaction.hold3pActive.values()):[],hold3pInfo:(0,_optimizeHoldInfo.optimizeHoldInfo)((_interaction$hold3pIn=interaction.hold3pInfo)!==null&&_interaction$hold3pIn!==void 0?_interaction$hold3pIn:[],start,(0,_getReactUfoPayloadVersion.getReactUFOPayloadVersion)(interaction.type))});}return basePayload;};// Page load & detailed payload
-getPageLoadDetailedInteractionMetrics=function getPageLoadDetailedInteractionMetrics(){var _config$ssr2,_config$ssr2$getSSRTi;if(!isPageLoad||!isDetailedPayload){return{};}var initialPageLoadExtraTimings=objectToArray(initialPageLoadExtraTiming.getTimings());var config=(0,_config.getConfig)();var defaultSSRTimings=objectToArray(ssr.getSSRTimings());var ssrTimingsFromConfig=config===null||config===void 0||(_config$ssr2=config.ssr)===null||_config$ssr2===void 0||(_config$ssr2$getSSRTi=_config$ssr2.getSSRTimings)===null||_config$ssr2$getSSRTi===void 0?void 0:_config$ssr2$getSSRTi.call(_config$ssr2);return{initialPageLoadExtraTimings:initialPageLoadExtraTimings,SSRTimings:ssrTimingsFromConfig?[].concat((0,_toConsumableArray2.default)(ssrTimingsFromConfig),(0,_toConsumableArray2.default)(defaultSSRTimings)):defaultSSRTimings};};if(experimental){expTTAI=(0,_getTtai.default)(interaction);}else{regularTTAI=(0,_getTtai.default)(interaction);}newUFOName=(0,_utils.sanitizeUfoName)(ufoName);resourceTimings=getResourceTimings(start,end);_context.t0=Promise;_context.t1=vcMetrics;if(_context.t1){_context.next=29;break;}_context.next=28;return(0,_getVcMetrics.default)(interaction);case 28:_context.t1=_context.sent;case 29:_context.t2=_context.t1;_context.t3=experimental?(0,_createExperimentalInteractionMetricsPayload.getExperimentalVCMetrics)(interaction):Promise.resolve(undefined);_context.t4=(0,_getPaintMetrics.getPaintMetricsToLegacyFormat)(type,end);_context.t5=(0,_getBatteryInfo.getBatteryInfoToLegacyFormat)();_context.t6=[_context.t2,_context.t3,_context.t4,_context.t5];_context.next=36;return _context.t0.all.call(_context.t0,_context.t6);case 36:_yield$Promise$all=_context.sent;_yield$Promise$all2=(0,_slicedToArray2.default)(_yield$Promise$all,4);finalVCMetrics=_yield$Promise$all2[0];experimentalMetrics=_yield$Promise$all2[1];paintMetrics=_yield$Promise$all2[2];batteryInfo=_yield$Promise$all2[3];if(!experimental){(0,_addPerformanceMeasures.addPerformanceMeasures)(interaction.start,(0,_toConsumableArray2.default)((finalVCMetrics===null||finalVCMetrics===void 0?void 0:finalVCMetrics['ufo:vc:rev'])||[]));}getReactHydrationStats=function getReactHydrationStats(){if(!hydration){return{};}return{hydration:hydration};};payload={actionSubject:'experience',action:'measured',eventType:'operational',source:'measured',tags:['observability'],attributes:{properties:_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({// basic
+getPageLoadDetailedInteractionMetrics=function getPageLoadDetailedInteractionMetrics(){var _config$ssr2,_config$ssr2$getSSRTi;if(!isPageLoad||!isDetailedPayload){return{};}var initialPageLoadExtraTimings=objectToArray(initialPageLoadExtraTiming.getTimings());var config=(0,_config.getConfig)();var defaultSSRTimings=objectToArray(ssr.getSSRTimings());var ssrTimingsFromConfig=config===null||config===void 0||(_config$ssr2=config.ssr)===null||_config$ssr2===void 0||(_config$ssr2$getSSRTi=_config$ssr2.getSSRTimings)===null||_config$ssr2$getSSRTi===void 0?void 0:_config$ssr2$getSSRTi.call(_config$ssr2);return{initialPageLoadExtraTimings:initialPageLoadExtraTimings,SSRTimings:ssrTimingsFromConfig?[].concat((0,_toConsumableArray2.default)(ssrTimingsFromConfig),(0,_toConsumableArray2.default)(defaultSSRTimings)):defaultSSRTimings};};if(experimental){expTTAI=(0,_getTtai.default)(interaction);}else{regularTTAI=(0,_getTtai.default)(interaction);}newUFOName=(0,_utils.sanitizeUfoName)(ufoName);resourceTimings=getResourceTimings(start,end);_context.t0=Promise;_context.t1=vcMetrics;if(_context.t1){_context.next=29;break;}_context.next=28;return(0,_getVcMetrics.default)(interaction);case 28:_context.t1=_context.sent;case 29:_context.t2=_context.t1;_context.t3=experimental?(0,_createExperimentalInteractionMetricsPayload.getExperimentalVCMetrics)(interaction):Promise.resolve(undefined);_context.t4=(0,_getPaintMetrics.getPaintMetricsToLegacyFormat)(type,end);_context.t5=(0,_getBatteryInfo.getBatteryInfoToLegacyFormat)();_context.t6=[_context.t2,_context.t3,_context.t4,_context.t5];_context.next=36;return _context.t0.all.call(_context.t0,_context.t6);case 36:_yield$Promise$all=_context.sent;_yield$Promise$all2=(0,_slicedToArray2.default)(_yield$Promise$all,4);finalVCMetrics=_yield$Promise$all2[0];experimentalMetrics=_yield$Promise$all2[1];paintMetrics=_yield$Promise$all2[2];batteryInfo=_yield$Promise$all2[3];if(!experimental){(0,_addPerformanceMeasures.addPerformanceMeasures)(interaction.start,(0,_toConsumableArray2.default)((finalVCMetrics===null||finalVCMetrics===void 0?void 0:finalVCMetrics['ufo:vc:rev'])||[]));}getReactHydrationStats=function getReactHydrationStats(){if(!hydration){return{};}return{hydration:hydration};};payload={actionSubject:'experience',action:'measured',eventType:'operational',source:'measured',tags:['observability'],attributes:{properties:_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({// basic
 'event:hostname':((_window$location=window.location)===null||_window$location===void 0?void 0:_window$location.hostname)||'unknown','event:product':config.product,'event:population':config.population,'event:schema':'1.0.0','event:sizeInKb':0,'event:source':{name:'react-ufo/web',version:(0,_getReactUfoPayloadVersion.getReactUFOPayloadVersion)(interaction.type)},'event:region':config.region||'unknown','experience:key':experimental?'custom.experimental-interaction-metrics':'custom.interaction-metrics','experience:name':newUFOName,// Include CPU usage monitoring data
-'event:cpu:usage':(0,_machineUtilisation.createPressureStateReport)(interaction.start,interaction.end),'event:memory:usage':(0,_machineUtilisation.createMemoryStateReport)(interaction.start,interaction.end)},criticalPayloadCount!==undefined?{'ufo:multipayload':true,'ufo:criticalPayloadCount':criticalPayloadCount}:{}),(0,_platformFeatureFlags.fg)('platform_ufo_browser_backgrounded_abort_timestamp')?{'ufo:pageVisibilityHiddenTimestamp':(0,_hiddenTiming.getEarliestHiddenTiming)(interaction.start,interaction.end)}:{}),{},{'ufo:wasPageHiddenBeforeInit':(0,_hiddenTiming.getHasHiddenTimingBeforeSetup)(),'ufo:isOpenedInBackground':(0,_hiddenTiming.isOpenedInBackground)(interaction.type)},(0,_getBrowserMetadata.getBrowserMetadataToLegacyFormat)()),batteryInfo),getSSRProperties(type)),getAssetsMetrics(interaction,pageLoadInteractionMetrics===null||pageLoadInteractionMetrics===void 0?void 0:pageLoadInteractionMetrics.SSRDoneTime)),getPPSMetrics(interaction)),paintMetrics),(0,_getNavigationMetrics.getNavigationMetricsToLegacyFormat)(type)),finalVCMetrics),experimentalMetrics),(_config$additionalPay=config.additionalPayloadData)===null||_config$additionalPay===void 0?void 0:_config$additionalPay.call(config,interaction)),getTracingContextData(interaction)),getStylesheetMetrics()),getErrorCounts(interaction)),getReactHydrationStats()),{},{interactionMetrics:_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({namePrefix:config.namePrefix||'',segmentPrefix:config.segmentPrefix||'',interactionId:interactionId,pageVisibilityAtTTI:pageVisibilityAtTTI,pageVisibilityAtTTAI:pageVisibilityAtTTAI,experimental__pageVisibilityAtTTI:moreAccuratePageVisibilityAtTTI,experimental__pageVisibilityAtTTAI:moreAccuratePageVisibilityAtTTAI,// raw interaction metrics
+'event:cpu:usage':(0,_machineUtilisation.createPressureStateReport)(interaction.start,interaction.end),'event:memory:usage':(0,_machineUtilisation.createMemoryStateReport)(interaction.start,interaction.end)},criticalPayloadCount!==undefined?{'ufo:multipayload':true,'ufo:criticalPayloadCount':criticalPayloadCount}:{}),(0,_platformFeatureFlags.fg)('platform_ufo_browser_backgrounded_abort_timestamp')?{'ufo:pageVisibilityHiddenTimestamp':(0,_hiddenTiming.getEarliestHiddenTiming)(interaction.start,interaction.end)}:{}),{},{'ufo:wasPageHiddenBeforeInit':(0,_hiddenTiming.getHasHiddenTimingBeforeSetup)(),'ufo:isOpenedInBackground':(0,_hiddenTiming.isOpenedInBackground)(interaction.type)},(0,_platformFeatureFlags.fg)('platform_ufo_is_tab_throttled')?{'ufo:isTabThrottled':(0,_hiddenTiming.isTabThrottled)(start,end)}:{}),(0,_getBrowserMetadata.getBrowserMetadataToLegacyFormat)()),batteryInfo),getSSRProperties(type)),getAssetsMetrics(interaction,pageLoadInteractionMetrics===null||pageLoadInteractionMetrics===void 0?void 0:pageLoadInteractionMetrics.SSRDoneTime)),getPPSMetrics(interaction)),paintMetrics),(0,_getNavigationMetrics.getNavigationMetricsToLegacyFormat)(type)),finalVCMetrics),experimentalMetrics),(_config$additionalPay=config.additionalPayloadData)===null||_config$additionalPay===void 0?void 0:_config$additionalPay.call(config,interaction)),getTracingContextData(interaction)),getStylesheetMetrics()),getErrorCounts(interaction)),getReactHydrationStats()),{},{interactionMetrics:_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({namePrefix:config.namePrefix||'',segmentPrefix:config.segmentPrefix||'',interactionId:interactionId,pageVisibilityAtTTI:pageVisibilityAtTTI,pageVisibilityAtTTAI:pageVisibilityAtTTAI,experimental__pageVisibilityAtTTI:moreAccuratePageVisibilityAtTTI,experimental__pageVisibilityAtTTAI:moreAccuratePageVisibilityAtTTAI,// raw interaction metrics
 rate:rate,routeName:routeName,type:type,abortReason:abortReason,featureFlags:featureFlags,previousInteractionName:previousInteractionName,isPreviousInteractionAborted:isPreviousInteractionAborted,abortedByInteractionName:abortedByInteractionName,// performance
 apdex:(0,_optimizeApdex.optimizeApdex)(interaction.apdex,(0,_getReactUfoPayloadVersion.getReactUFOPayloadVersion)(interaction.type)),end:Math.round(end)},interaction.end3p?{end3p:Math.round(interaction.end3p)}:{}),{},{start:Math.round(start),segments:(0,_getReactUfoPayloadVersion.getReactUFOPayloadVersion)(interaction.type)==='2.0.0'?segmentTree:(0,_utils.getOldSegmentsLabelStack)(segments,interaction.type),marks:(0,_optimizeMarks.optimizeMarks)(interaction.marks,(0,_getReactUfoPayloadVersion.getReactUFOPayloadVersion)(interaction.type)),customData:optimizeCustomData(interaction),reactProfilerTimings:(0,_optimizeReactProfilerTimings.optimizeReactProfilerTimings)(interaction.reactProfilerTimings,start,(0,_getReactUfoPayloadVersion.getReactUFOPayloadVersion)(interaction.type)),minorInteractions:interaction.minorInteractions},responsiveness?{responsiveness:responsiveness}:{}),labelStack),pageLoadInteractionMetrics),getDetailedInteractionMetrics(resourceTimings)),getPageLoadDetailedInteractionMetrics()),getBm3TrackerTimings(interaction)),{},{'metric:ttai':experimental?regularTTAI||expTTAI:undefined,'metric:experimental:ttai':expTTAI},unknownElementName?{unknownElementName:unknownElementName}:{}),unknownElementHierarchy?{unknownElementHierarchy:unknownElementHierarchy}:{}),'ufo:payloadTime':(0,_roundNumber.roundEpsilon)(performance.now()-interactionPayloadStart)})}};if(experimental){regularTTAI=undefined;expTTAI=undefined;}if((0,_platformFeatureFlags.fg)('platform_ufo_enable_vc_raw_data')){size=(0,_getPayloadSize.default)(payload.attributes.properties);vcRev=payload.attributes.properties['ufo:vc:rev'];rawData=vcRev.find(function(item){return item.revision==='raw-handler';});if(rawData){rawDataSize=(0,_getPayloadSize.default)(rawData);payload.attributes.properties['ufo:vc:raw:size']=rawDataSize;if(size>MAX_PAYLOAD_SIZE&&Array.isArray(vcRev)&&vcRev.length>0){payload.attributes.properties['ufo:vc:rev']=vcRev.filter(function(item){return item.revision!=='raw-handler';});payload.attributes.properties['ufo:vc:raw:removed']=true;}}payload.attributes.properties['event:sizeInKb']=(0,_getPayloadSize.default)(payload.attributes.properties);}else{payload.attributes.properties['event:sizeInKb']=(0,_getPayloadSize.default)(payload.attributes.properties);}// in order of importance, first one being least important
 // we can add more fields as necessary
-interactionMetricsFieldsToTrim=['requestInfo','featureFlags','resourceTimings'];properties=payload.attributes.properties;interactionMetrics=properties.interactionMetrics;if(!interactionMetrics){_context.next=74;break;}_iterator=_createForOfIteratorHelper(interactionMetricsFieldsToTrim);_context.prev=52;_iterator.s();case 54:if((_step=_iterator.n()).done){_context.next=66;break;}field=_step.value;if(!((0,_getPayloadSize.default)(properties)<=MAX_PAYLOAD_SIZE)){_context.next=58;break;}return _context.abrupt("continue",64);case 58:interactionMetrics[field]=undefined;properties['event:isTrimmed']=true;trimmedFields=properties['event:trimmedFields'];if(!Array.isArray(trimmedFields)){trimmedFields=[];}trimmedFields.push("interactionMetrics.".concat(field));properties['event:trimmedFields']=trimmedFields;case 64:_context.next=54;break;case 66:_context.next=71;break;case 68:_context.prev=68;_context.t7=_context["catch"](52);_iterator.e(_context.t7);case 71:_context.prev=71;_iterator.f();return _context.finish(71);case 74:return _context.abrupt("return",payload);case 75:case"end":return _context.stop();}},_callee,null,[[52,68,71,74]]);}));return _createInteractionMetricsPayload.apply(this,arguments);}function createPayloads(_x6,_x7){return _createPayloads.apply(this,arguments);}function _createPayloads(){_createPayloads=(0,_asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee2(interactionId,interaction){var ufoNameOverride,modifiedInteraction,payloads,isCriticalMetricsEnabled,vcMetrics,criticalMetricsPayloads,criticalPayloadCount,interactionMetricsPayload;return _regenerator.default.wrap(function _callee2$(_context2){while(1)switch(_context2.prev=_context2.next){case 0:ufoNameOverride=getUfoNameOverride(interaction);modifiedInteraction=_objectSpread(_objectSpread({},interaction),{},{ufoName:ufoNameOverride});payloads=[];isCriticalMetricsEnabled=(0,_platformFeatureFlags.fg)('platform_ufo_critical_metrics_payload');// Calculate VC metrics once to avoid duplicate expensive calculations
+interactionMetricsFieldsToTrim=(0,_platformFeatureFlags.fg)('ufo_remove_featureflags_from_trimmed_fields')?['requestInfo','resourceTimings']:['requestInfo','featureFlags','resourceTimings'];properties=payload.attributes.properties;interactionMetrics=properties.interactionMetrics;if(!interactionMetrics){_context.next=74;break;}_iterator=_createForOfIteratorHelper(interactionMetricsFieldsToTrim);_context.prev=52;_iterator.s();case 54:if((_step=_iterator.n()).done){_context.next=66;break;}field=_step.value;if(!((0,_getPayloadSize.default)(properties)<=MAX_PAYLOAD_SIZE)){_context.next=58;break;}return _context.abrupt("continue",64);case 58:interactionMetrics[field]=undefined;properties['event:isTrimmed']=true;trimmedFields=properties['event:trimmedFields'];if(!Array.isArray(trimmedFields)){trimmedFields=[];}trimmedFields.push("interactionMetrics.".concat(field));properties['event:trimmedFields']=trimmedFields;case 64:_context.next=54;break;case 66:_context.next=71;break;case 68:_context.prev=68;_context.t7=_context["catch"](52);_iterator.e(_context.t7);case 71:_context.prev=71;_iterator.f();return _context.finish(71);case 74:return _context.abrupt("return",payload);case 75:case"end":return _context.stop();}},_callee,null,[[52,68,71,74]]);}));return _createInteractionMetricsPayload.apply(this,arguments);}function createPayloads(_x6,_x7){return _createPayloads.apply(this,arguments);}function _createPayloads(){_createPayloads=(0,_asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee2(interactionId,interaction){var ufoNameOverride,modifiedInteraction,payloads,isCriticalMetricsEnabled,vcMetrics,criticalMetricsPayloads,criticalPayloadCount,interactionMetricsPayload;return _regenerator.default.wrap(function _callee2$(_context2){while(1)switch(_context2.prev=_context2.next){case 0:ufoNameOverride=getUfoNameOverride(interaction);modifiedInteraction=_objectSpread(_objectSpread({},interaction),{},{ufoName:ufoNameOverride});payloads=[];isCriticalMetricsEnabled=(0,_platformFeatureFlags.fg)('platform_ufo_critical_metrics_payload');// Calculate VC metrics once to avoid duplicate expensive calculations
 _context2.next=6;return(0,_getVcMetrics.default)(interaction);case 6:vcMetrics=_context2.sent;if(!isCriticalMetricsEnabled){_context2.next=13;break;}_context2.next=10;return(0,_criticalMetricsPayload.createCriticalMetricsPayloads)(interactionId,interaction,vcMetrics);case 10:_context2.t0=_context2.sent;_context2.next=14;break;case 13:_context2.t0=[];case 14:criticalMetricsPayloads=_context2.t0;payloads.push.apply(payloads,(0,_toConsumableArray2.default)(criticalMetricsPayloads));criticalPayloadCount=isCriticalMetricsEnabled?criticalMetricsPayloads.length:undefined;_context2.next=19;return createInteractionMetricsPayload(modifiedInteraction,interactionId,undefined,criticalPayloadCount,vcMetrics);case 19:interactionMetricsPayload=_context2.sent;payloads.push(interactionMetricsPayload);return _context2.abrupt("return",payloads.filter(Boolean));case 22:case"end":return _context2.stop();}},_callee2);}));return _createPayloads.apply(this,arguments);}function createExperimentalMetricsPayload(_x8,_x9){return _createExperimentalMetricsPayload.apply(this,arguments);}function _createExperimentalMetricsPayload(){_createExperimentalMetricsPayload=(0,_asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee3(interactionId,interaction){var config,ufoName,rate,pageVisibilityState,result;return _regenerator.default.wrap(function _callee3$(_context3){while(1)switch(_context3.prev=_context3.next){case 0:config=(0,_config.getConfig)();if(config){_context3.next=3;break;}throw Error('UFO Configuration not provided');case 3:ufoName=(0,_utils.sanitizeUfoName)(interaction.ufoName);rate=(0,_config.getExperimentalInteractionRate)(ufoName,interaction.type);if((0,_coinflip.default)(rate)){_context3.next=7;break;}return _context3.abrupt("return",null);case 7:pageVisibilityState=(0,_hiddenTiming.getPageVisibilityState)(interaction.start,interaction.end);if(!(pageVisibilityState!=='visible')){_context3.next=10;break;}return _context3.abrupt("return",null);case 10:_context3.next=12;return createInteractionMetricsPayload(interaction,interactionId,true);case 12:result=_context3.sent;return _context3.abrupt("return",result);case 14:case"end":return _context3.stop();}},_callee3);}));return _createExperimentalMetricsPayload.apply(this,arguments);}function createExtraSearchPageInteractionPayload(_x0,_x1){return _createExtraSearchPageInteractionPayload.apply(this,arguments);}function _createExtraSearchPageInteractionPayload(){_createExtraSearchPageInteractionPayload=(0,_asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee4(interactionId,interaction){var SAIN_HOLD_NAMES,NAME_OVERRIDE,SEARCH_PAGE_SMART_ANSWERS_SEGMENT_LABEL,newInteractionId,newEnd,holdInfo,reactProfilerTimings,lastHold,isLastHoldSAIN,lastFilteredTime,filteredReactProfilerTimings,lastTiming,modifiedInteraction,payloads,vcMetrics,interactionMetricsPayload;return _regenerator.default.wrap(function _callee4$(_context4){while(1)switch(_context4.prev=_context4.next){case 0:SAIN_HOLD_NAMES=['search-ai-dialog-visible-text-loading','search-ai-dialog-all-text-loading'];NAME_OVERRIDE='search-page-ignoring-smart-answers';SEARCH_PAGE_SMART_ANSWERS_SEGMENT_LABEL='search-page-smart-answers';newInteractionId="".concat(interactionId,"-ignoring-smart-answers");// Calculate a new end time which excludes SAIN holds
 holdInfo=interaction.holdInfo,reactProfilerTimings=interaction.reactProfilerTimings;lastHold=holdInfo.at(-1);isLastHoldSAIN=Boolean(lastHold&&SAIN_HOLD_NAMES.includes(lastHold.name));// A new end time is only calculated if the last hold is a SAIN hold
 if(isLastHoldSAIN){lastFilteredTime=null;filteredReactProfilerTimings=reactProfilerTimings.filter(function(timing){if(timing.commitTime===lastFilteredTime){return false;}var isTimingSmartAnswersInSearch=timing.labelStack.some(function(label){return label.name===SEARCH_PAGE_SMART_ANSWERS_SEGMENT_LABEL;});if(isTimingSmartAnswersInSearch){lastFilteredTime=timing.commitTime;return false;}return true;});lastTiming=filteredReactProfilerTimings.at(-1);if(lastTiming){newEnd=lastTiming.commitTime;}}modifiedInteraction=_objectSpread(_objectSpread({},interaction),{},{end:newEnd!==null&&newEnd!==void 0?newEnd:interaction.end,holdInfo:[],knownSegments:[],reactProfilerTimings:[],ufoName:NAME_OVERRIDE});payloads=[];_context4.next=12;return(0,_getVcMetrics.default)(interaction,false,true);case 12:vcMetrics=_context4.sent;_context4.next=15;return createInteractionMetricsPayload(modifiedInteraction,newInteractionId,undefined,undefined,vcMetrics);case 15:interactionMetricsPayload=_context4.sent;payloads.push(interactionMetricsPayload);return _context4.abrupt("return",payloads.filter(Boolean));case 18:case"end":return _context4.stop();}},_callee4);}));return _createExtraSearchPageInteractionPayload.apply(this,arguments);}

package/dist/cjs/hidden-timing/index.js

@@ -3,11 +3,16 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.__injectThrottleMeasurementForTesting = __injectThrottleMeasurementForTesting;
 exports.getEarliestHiddenTiming = getEarliestHiddenTiming;
 exports.getHasHiddenTimingBeforeSetup = getHasHiddenTimingBeforeSetup;
 exports.getPageVisibilityState = getPageVisibilityState;
+exports.getThrottleMeasurements = getThrottleMeasurements;
 exports.isOpenedInBackground = isOpenedInBackground;
+exports.isTabThrottled = isTabThrottled;
 exports.setupHiddenTimingCapture = setupHiddenTimingCapture;
+exports.setupThrottleDetection = setupThrottleDetection;
+exports.stopThrottleDetection = stopThrottleDetection;
 var _bindEventListener = require("bind-event-listener");
 var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
 var timings = [];
@@ -161,4 +166,134 @@ function getPageVisibilityState(start, end) {
     hiddenState = timings[startIdx].hidden ? 'hidden' : 'visible';
   }
   return hiddenState;
+}
+
+// Throttle detection configuration
+// Expected interval for timer checks (in milliseconds)
+var THROTTLE_CHECK_INTERVAL_MS = 1000;
+// Threshold for considering a timer as throttled (50% drift tolerance)
+var THROTTLE_DRIFT_THRESHOLD = 1.5;
+// Maximum number of throttle measurements to store (circular buffer)
+var THROTTLE_BUFFER_SIZE = 120;
+// Circular buffer to store throttle measurements
+var throttleMeasurements = [];
+var throttleInsertIndex = 0;
+var throttleIntervalId = null;
+var lastThrottleCheckTime = null;
+var throttleSetupDone = false;
+function recordThrottleMeasurement(expectedElapsed, actualElapsed) {
+  var isThrottled = actualElapsed > expectedElapsed * THROTTLE_DRIFT_THRESHOLD;
+  throttleMeasurements[throttleInsertIndex] = {
+    time: performance.now(),
+    expectedElapsed: expectedElapsed,
+    actualElapsed: actualElapsed,
+    isThrottled: isThrottled
+  };
+  throttleInsertIndex = (throttleInsertIndex + 1) % THROTTLE_BUFFER_SIZE;
+}
+function throttleCheckCallback() {
+  var currentTime = performance.now();
+  if (lastThrottleCheckTime !== null) {
+    var actualElapsed = currentTime - lastThrottleCheckTime;
+    recordThrottleMeasurement(THROTTLE_CHECK_INTERVAL_MS, actualElapsed);
+  }
+  lastThrottleCheckTime = currentTime;
+}
+
+/**
+ * Sets up the throttle detection mechanism.
+ * This should be called early in the page lifecycle.
+ * Uses a periodic timer to detect browser throttling by measuring timer drift.
+ */
+function setupThrottleDetection() {
+  if (throttleSetupDone) {
+    return;
+  }
+  throttleSetupDone = true;
+
+  // Record the initial timestamp
+  lastThrottleCheckTime = performance.now();
+
+  // Start the periodic timer for throttle detection
+  throttleIntervalId = setInterval(throttleCheckCallback, THROTTLE_CHECK_INTERVAL_MS);
+}
+
+/**
+ * Stops the throttle detection mechanism.
+ * Useful for cleanup in tests or when the feature is no longer needed.
+ */
+function stopThrottleDetection() {
+  if (throttleIntervalId !== null) {
+    clearInterval(throttleIntervalId);
+    throttleIntervalId = null;
+  }
+  lastThrottleCheckTime = null;
+  throttleSetupDone = false;
+  throttleMeasurements.length = 0;
+  throttleInsertIndex = 0;
+}
+
+/**
+ * Checks if the tab was throttled at any point during the specified time window.
+ * Returns true if any timer measurement showed significant drift (throttling).
+ *
+ * @param startTime - The start timestamp of the window to check (DOMHighResTimeStamp)
+ * @param endTime - The end timestamp of the window to check (DOMHighResTimeStamp)
+ * @returns boolean - true if throttling was detected during the time window, false otherwise
+ */
+function isTabThrottled(startTime, endTime) {
+  // Input validation
+  if (!Number.isFinite(startTime) || !Number.isFinite(endTime) || startTime >= endTime) {
+    return false;
+  }
+
+  // No measurements available
+  if (throttleMeasurements.length === 0) {
+    return false;
+  }
+
+  // Check if any measurement within the time window indicates throttling
+  for (var i = 0; i < throttleMeasurements.length; i++) {
+    var measurement = throttleMeasurements[i];
+    if (measurement && measurement.time >= startTime && measurement.time <= endTime && measurement.isThrottled) {
+      return true;
+    }
+  }
+  return false;
+}
+
+/**
+ * Gets detailed throttle information for debugging purposes.
+ * Returns all throttle measurements within the specified time window.
+ *
+ * @param startTime - The start timestamp of the window to check
+ * @param endTime - The end timestamp of the window to check
+ * @returns Array of throttle measurements within the time window
+ */
+function getThrottleMeasurements(startTime, endTime) {
+  // Input validation
+  if (!Number.isFinite(startTime) || !Number.isFinite(endTime) || startTime >= endTime) {
+    return [];
+  }
+  return throttleMeasurements.filter(function (measurement) {
+    return measurement && measurement.time >= startTime && measurement.time <= endTime;
+  });
+}
+
+/**
+ * Injects a fake throttle measurement for testing purposes.
+ * This allows integration tests to simulate throttling scenarios.
+ *
+ * @param measurement - The throttle measurement to inject
+ */
+function __injectThrottleMeasurementForTesting(measurement) {
+  throttleMeasurements[throttleInsertIndex] = measurement;
+  throttleInsertIndex = (throttleInsertIndex + 1) % THROTTLE_BUFFER_SIZE;
+}
+
+// Expose testing API on window for integration tests
+if (typeof window !== 'undefined') {
+  window.__reactUfoHiddenTiming = {
+    __injectThrottleMeasurementForTesting: __injectThrottleMeasurementForTesting
+  };
 }