feat: add trace event utils #1215

BioPhoton · 2026-01-13T17:20:24Z

Related: #1197

This PR includes:

bump node version of utils to 18.2.0 as of a lint error The 'perf_hooks.PerformanceMark' is still an experimental feature and is not supported until Node.js 18.2.0 (backported: ^16.17.0). The configured version range is '>=17.0.0'
types for trace events and file
utils for trace events and trace file generation
epoch clock API extension

nx-cloud · 2026-01-13T17:21:48Z

View your CI Pipeline Execution ↗ for commit 878b939

Command	Status	Duration	Result
`nx run ci:code-pushup -- merge-diffs --files=/h...`	✅ Succeeded	4s	View ↗
`nx run-many --targets=code-pushup --parallel=fa...`	✅ Succeeded	1m 20s	View ↗
`nx run-many --targets=code-pushup --parallel=fa...`	✅ Succeeded	11m 34s	View ↗
`nx run-many -t unit-test,int-test`	✅ Succeeded	48s	View ↗

☁️ Nx Cloud last updated this comment at 2026-01-14 05:08:02 UTC

pkg-pr-new · 2026-01-13T17:22:02Z

Open in StackBlitz

@code-pushup/ci

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/ci@1215

@code-pushup/cli

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/cli@1215

@code-pushup/core

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/core@1215

@code-pushup/models

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/models@1215

@code-pushup/create-cli

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/create-cli@1215

@code-pushup/nx-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/nx-plugin@1215

@code-pushup/axe-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/axe-plugin@1215

@code-pushup/coverage-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/coverage-plugin@1215

@code-pushup/eslint-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/eslint-plugin@1215

@code-pushup/js-packages-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/js-packages-plugin@1215

@code-pushup/jsdocs-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/jsdocs-plugin@1215

@code-pushup/lighthouse-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/lighthouse-plugin@1215

@code-pushup/typescript-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/typescript-plugin@1215

@code-pushup/utils

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/utils@1215

commit: 878b939

github-actions · 2026-01-13T17:28:12Z

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit c78f386 with previous commit 7d3681c.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Categories

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Documentation	🔴 34	🔴 35
Performance	🔴 37	🔴 37
Code coverage	🟢 91	🟢 91
Bug prevention	🟡 75	🟡 75
Axe Accessibility	🟡 88	🟡 88
Code style	🟢 99	🟢 99	–
Security	🟡 51	🟡 51	–
Updates	🟡 78	🟡 78	–
Type Safety	🟡 67	🟡 67	–
Miscellaneous	🟡 67	🟡 67	–
Accessibility	🟢 92	🟢 92	–
Best Practices	🟢 100	🟢 100	–
SEO	🟢 92	🟢 92	–

👍 1 group improved, 👎 2 groups regressed, 👍 6 audits improved, 👎 2 audits regressed, 17 audits changed without impacting score

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score
JSDocs coverage	Documentation coverage	🔴 34	🔴 35
Lighthouse	Performance	🔴 37	🔴 37
Code coverage	Code coverage metrics	🟢 91	🟢 91

31 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value
Lighthouse	First Contentful Paint	🟥 3.0 s	🟥 3.3 s
JSDocs coverage	Types coverage	🟥 260 undocumented types	🟥 265 undocumented types
JSDocs coverage	Variables coverage	🟥 271 undocumented variables	🟥 275 undocumented variables
Lighthouse	Total Blocking Time	🟥 1,990 ms	🟥 1,860 ms
Code coverage	Line coverage	🟨 86.2 %	🟨 85.4 %
JSDocs coverage	Functions coverage	🟥 597 undocumented functions	🟥 598 undocumented functions
Code coverage	Function coverage	🟩 93.4 %	🟩 93.5 %
Code coverage	Branch coverage	🟨 87.3 %	🟨 87.3 %
Lighthouse	Avoids enormous network payloads	🟩 Total size was 2,113 KiB	🟩 Total size was 2,123 KiB
Lighthouse	Uses efficient cache policy on static assets	🟨 31 resources found	🟨 31 resources found
Lighthouse	Minimizes main-thread work	🟥 8.9 s	🟥 8.4 s
Lighthouse	JavaScript execution time	🟥 4.4 s	🟥 4.0 s
Lighthouse	Largest Contentful Paint	🟥 11.4 s	🟥 11.2 s
Lighthouse	Max Potential First Input Delay	🟥 1,040 ms	🟥 830 ms
Lighthouse	Initial server response time was short	🟩 Root document took 400 ms	🟩 Root document took 560 ms
Lighthouse	Time to Interactive	🟥 13.0 s	🟥 13.2 s
Lighthouse	Metrics	🟩 100%	🟩 100%
Lighthouse	Remove duplicate modules in JavaScript bundles	🟥 Potential savings of 103 KiB	🟥 Potential savings of 105 KiB
Lighthouse	Reduce unused CSS	🟥 Potential savings of 95 KiB	🟥 Potential savings of 95 KiB
Lighthouse	Reduce unused JavaScript	🟥 Potential savings of 200 KiB	🟥 Potential savings of 223 KiB
Lighthouse	Server Backend Latencies	🟩 1,050 ms	🟩 1,140 ms
Lighthouse	Network Round Trip Times	🟩 0 ms	🟩 50 ms
Lighthouse	Speed Index	🟥 5.9 s	🟥 5.9 s
JS packages	Outdated npm dev dependencies.	🟨 55 outdated package versions (29 major, 19 minor, 7 patch)	🟨 56 outdated package versions (29 major, 19 minor, 8 patch)
JSDocs coverage	Properties coverage	🟥 24 undocumented properties	🟥 23 undocumented properties

654 other audits are unchanged.

github-actions · 2026-01-13T20:24:50Z

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit c78f386 with previous commit 7d3681c.

💼 Project `utils`

🤨 Code PushUp report has both improvements and regressions.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Documentation	🔴 36	🔴 39
Code coverage	🟢 94	🟢 94

4 other categories are unchanged.

👍 1 group improved, 👎 1 group regressed, 👍 4 audits improved, 👎 2 audits regressed, 1 audit changed without impacting score

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
JSDocs coverage	Documentation coverage	🔴 36	🔴 39
Code coverage	Code coverage metrics	🟢 94	🟢 94

13 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value
JSDocs coverage	Variables coverage	🟥 43 undocumented variables	🟥 47 undocumented variables
JSDocs coverage	Types coverage	🟥 59 undocumented types	🟥 64 undocumented types
Code coverage	Line coverage	🟩 93.8 %	🟨 89.9 %
JSDocs coverage	Functions coverage	🟥 246 undocumented functions	🟥 247 undocumented functions
Code coverage	Function coverage	🟩 95.8 %	🟩 96 %
Code coverage	Branch coverage	🟩 91.8 %	🟩 91.7 %
JSDocs coverage	Properties coverage	🟥 24 undocumented properties	🟥 23 undocumented properties

437 other audits are unchanged.

💼 Project `plugin-lighthouse`

😟 Code PushUp report has regressed.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Code coverage	🟢 99	🟢 99

5 other categories are unchanged.

👎 1 group regressed, 👎 1 audit regressed

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
Code coverage	Code coverage metrics	🟢 99	🟢 99

14 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
Code coverage	Branch coverage	🟩 96.2 %	🟩 96.2 %

443 other audits are unchanged.

12 other projects are unchanged.

hanna-skryl · 2026-01-14T16:17:59Z

packages/utils/src/lib/clock-epoch.ts

+  const fromEntry = (entry: PerformanceEntry, useEndTime = false) =>
+    defaultClock.fromPerfMs(
+      entry.startTime +
+        (entry.entryType === 'measure' && useEndTime ? entry.duration : 0),
+    );


Why does fromEntry use defaultClock.fromPerfMs instead of the local fromPerfMs?

hanna-skryl · 2026-01-14T16:36:27Z

packages/utils/src/lib/clock-epoch.unit.test.ts

+  it('should convert performance mark to microseconds', () => {
+    const markEntry = {
+      name: 'test-mark',
+      entryType: 'mark',
+      startTime: 1000,
+      duration: 0,
+    } as PerformanceMark;
+
+    expect(defaultClock.fromEntry(markEntry)).toBe(
+      defaultClock.fromPerfMs(1000),
+    );
+    expect(defaultClock.fromEntry(markEntry, true)).toBe(
+      defaultClock.fromPerfMs(1000),
+    );
+  });
+
+  it('should convert performance measure to microseconds', () => {
+    const measureEntry = {
+      name: 'test-measure',
+      entryType: 'measure',
+      startTime: 1000,
+      duration: 500,
+    } as PerformanceMeasure;
+
+    expect(defaultClock.fromEntry(measureEntry)).toBe(
+      defaultClock.fromPerfMs(1000),
+    );
+    expect(defaultClock.fromEntry(measureEntry, false)).toBe(
+      defaultClock.fromPerfMs(1000),
+    );
+    expect(defaultClock.fromEntry(measureEntry, true)).toBe(
+      defaultClock.fromPerfMs(1500),
+    );
+  });


There's a type mismatch - fromEntry expects PerformanceEntry but only uses some of its properties. The type assertion doesn't help here.

Narrowing the signature to what's actually needed fixes it: Pick<PerformanceEntry, 'duration' | 'startTime' | 'entryType'>.

Then, tests can use satisfies instead of type casting.

refactor: add trace event utils

a86caac

github-actions bot assigned BioPhoton Jan 13, 2026

github-actions bot added 🔬 testing writing tests 🧩 utils labels Jan 13, 2026

BioPhoton mentioned this pull request Jan 13, 2026

Implement performance profiling and trace file generation #1197

Open

refactor: wip trace helper

510566f

github-actions bot added the 🛠️ tooling label Jan 13, 2026

John Doe added 8 commits January 13, 2026 22:54

refactor: fix typing

03c8484

refactor: fix build

e4f326b

refactor: wip

313a489

refactor: adjust clock helper

a3e839d

refactor: wip

a931a3a

refactor: wip

dd79da4

refactor: wip

81bac90

refactor: wip

af7647f

BioPhoton marked this pull request as ready for review January 13, 2026 22:27

BioPhoton requested a review from hanna-skryl January 13, 2026 22:41

John Doe added 2 commits January 14, 2026 05:36

refactor: add js-docs

5ec026d

refactor: fix lint

878b939

hanna-skryl reviewed Jan 14, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: add trace event utils #1215

feat: add trace event utils #1215

BioPhoton commented Jan 13, 2026 •

edited

Loading

Uh oh!

nx-cloud bot commented Jan 13, 2026 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Jan 13, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Jan 13, 2026 •

edited

Loading

🗃️ Groups

🛡️ Audits

Uh oh!

github-actions bot commented Jan 13, 2026 •

edited

Loading

🗃️ Groups

🛡️ Audits

🗃️ Groups

🛡️ Audits

Uh oh!

hanna-skryl Jan 14, 2026

Uh oh!

hanna-skryl Jan 14, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

feat: add trace event utils #1215

Are you sure you want to change the base?

feat: add trace event utils #1215

Conversation

BioPhoton commented Jan 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

nx-cloud bot commented Jan 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-new bot commented Jan 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Code PushUp

🏷️ Categories

🗃️ Groups

🛡️ Audits

Uh oh!

github-actions bot commented Jan 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Code PushUp

💼 Project utils

🗃️ Groups

🛡️ Audits

💼 Project plugin-lighthouse

🗃️ Groups

🛡️ Audits

Uh oh!

hanna-skryl Jan 14, 2026

Choose a reason for hiding this comment

Uh oh!

hanna-skryl Jan 14, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

BioPhoton commented Jan 13, 2026 •

edited

Loading

nx-cloud bot commented Jan 13, 2026 •

edited

Loading

pkg-pr-new bot commented Jan 13, 2026 •

edited

Loading

github-actions bot commented Jan 13, 2026 •

edited

Loading

github-actions bot commented Jan 13, 2026 •

edited

Loading

💼 Project `utils`

💼 Project `plugin-lighthouse`