feat: add profiler class and measure API

[BioPhoton]

Related to #1197

This PR includes:

• Add Profiler class
• Add API methods setEnabled, isEnabled, tracks, marker, measure, measureAsync

const profiler = new Profiler({
  prefix: 'cp',
  track: 'Main',
  trackGroup: `<✓> Code PushUp - ${serializeCommandWithArgs({
        command: process.argv[2] || 'unknown',
        args: process.argv.slice(3),
 })}`,
 color: 'primary-dark',
 error: e => ({
    properties: [['Stack Track', (e as Error)?.stack || 'Unknown']],
  }),
 tracks: {
   main: {
      track: 'Main',
    },
    pluginEslint: {
      track: 'Plugins Eslint',
      ...pluginColors,
    },
    pluginCoverage: {
      track: 'Plugins Coverage',
      ...pluginColors,
    },
    pluginAxe: {
      track: 'Plugins Axe',
      ...pluginColors,
    },
  },
});

profiler.marker('Start Profiling', {
  tooltipText: 'Cache cleared due to stale data'
});

const result = profiler.measure('plugin-eslint:merge-results', () => eslintPlugin.mergeResults(results), {
    ...profiler.tracks.eslintPlugin
    color: 'secondary'
  });

const asyncResult = await profiler.measureAsync('cli:load-rc-file',
  () => api.saveData(data), {
    ...profiler.tracks.main
    color: 'primary'
  }
);

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 64457f3

Command	Status	Duration	Result
nx run ci:code-pushup -- merge-diffs --files=/h...	✅ Succeeded	5s	View ↗
nx run-many --targets=code-pushup --parallel=fa...	✅ Succeeded	1m 23s	View ↗
nx run-many --targets=code-pushup --parallel=fa...	✅ Succeeded	12m 22s	View ↗
nx run-many -t unit-test,int-test	✅ Succeeded	1m 17s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-01-14 22:22:20 UTC

[pkg-pr-new]

Open in StackBlitz

@code-pushup/ci

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

@code-pushup/cli

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

@code-pushup/core

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

@code-pushup/create-cli

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

@code-pushup/models

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

@code-pushup/nx-plugin

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

@code-pushup/axe-plugin

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

@code-pushup/eslint-plugin

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

@code-pushup/coverage-plugin

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

@code-pushup/js-packages-plugin

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

@code-pushup/jsdocs-plugin

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

@code-pushup/lighthouse-plugin

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

@code-pushup/typescript-plugin

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

@code-pushup/utils

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

commit: 64457f3

[github-actions]

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit 8db4c55 with previous commit 316407b.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Categories

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Documentation	🔴 34	🔴 38
Performance	🔴 35	🔴 33
Code coverage	🟢 92	🟢 93
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	–

👍 2 groups improved, 👎 1 group regressed, 👍 8 audits improved, 👎 4 audits regressed, 15 audits changed without impacting score

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
JSDocs coverage	Documentation coverage	🔴 34	🔴 38
Lighthouse	Performance	🔴 35	🔴 33
Code coverage	Code coverage metrics	🟢 92	🟢 93

31 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
Lighthouse	Speed Index	🟥 6.5 s	🟥 7.4 s
JSDocs coverage	Methods coverage	🟥 13 undocumented methods	🟨 13 undocumented methods
Lighthouse	First Contentful Paint	🟥 3.1 s	🟥 3.4 s
JSDocs coverage	Types coverage	🟥 265 undocumented types	🟥 265 undocumented types
JSDocs coverage	Classes coverage	🟥 7 undocumented classes	🟥 7 undocumented classes
JSDocs coverage	Variables coverage	🟥 275 undocumented variables	🟥 276 undocumented variables
Lighthouse	Total Blocking Time	🟥 2,280 ms	🟥 2,470 ms
Lighthouse	Time to Interactive	🟥 14.0 s	🟥 14.1 s
Code coverage	Line coverage	🟩 92.7 %	🟩 92.8 %
JSDocs coverage	Functions coverage	🟥 591 undocumented functions	🟥 591 undocumented functions
Code coverage	Function coverage	🟩 94.2 %	🟩 94.3 %
Code coverage	Branch coverage	🟨 89 %	🟨 89 %
Lighthouse	Minimizes main-thread work	🟥 10.8 s	🟥 12.3 s
Lighthouse	JavaScript execution time	🟥 5.7 s	🟥 6.3 s
Lighthouse	Reduce unused CSS	🟥 Potential savings of 95 KiB	🟥 Potential savings of 95 KiB
Lighthouse	Reduce unused JavaScript	🟥 Potential savings of 220 KiB	🟥 Potential savings of 223 KiB
Lighthouse	Max Potential First Input Delay	🟥 1,470 ms	🟥 1,730 ms
Lighthouse	Largest Contentful Paint	🟥 12.3 s	🟥 12.5 s
Lighthouse	Avoids enormous network payloads	🟩 Total size was 2,114 KiB	🟩 Total size was 2,114 KiB
Lighthouse	Uses efficient cache policy on static assets	🟨 31 resources found	🟨 31 resources found
Lighthouse	Remove duplicate modules in JavaScript bundles	🟥 Potential savings of 91 KiB	🟥 Potential savings of 99 KiB
Lighthouse	Metrics	🟩 100%	🟩 100%
Lighthouse	Server Backend Latencies	🟩 1,400 ms	🟩 1,320 ms
Lighthouse	Initial server response time was short	🟥 Root document took 670 ms	🟥 Root document took 630 ms
Lighthouse	Network Round Trip Times	🟩 70 ms	🟩 70 ms
JSDocs coverage	Properties coverage	🟥 23 undocumented properties	🟥 27 undocumented properties
JS packages	Vulnerabilities for npm dev dependencies.	🟥 40 vulnerabilities (3 critical, 23 high, 8 moderate, 6 low)	🟥 43 vulnerabilities (3 critical, 23 high, 8 moderate, 9 low)

652 other audits are unchanged.

[github-actions]

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit 8db4c55 with previous commit 316407b.

💼 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	🔴 37	🔴 44
Code coverage	🟢 95	🟢 95

4 other categories are unchanged.

👍 2 groups improved, 👍 7 audits improved, 👎 1 audit regressed, 1 audit changed without impacting score

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
JSDocs coverage	Documentation coverage	🔴 37	🔴 44
Code coverage	Code coverage metrics	🟢 95	🟢 95

13 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
JSDocs coverage	Variables coverage	🟥 47 undocumented variables	🟥 48 undocumented variables
JSDocs coverage	Types coverage	🟥 64 undocumented types	🟥 64 undocumented types
JSDocs coverage	Methods coverage	🟥 13 undocumented methods	🟨 13 undocumented methods
JSDocs coverage	Classes coverage	🟥 4 undocumented classes	🟥 4 undocumented classes
JSDocs coverage	Functions coverage	🟥 240 undocumented functions	🟥 240 undocumented functions
Code coverage	Function coverage	🟩 96 %	🟩 96.2 %
Code coverage	Line coverage	🟩 97.6 %	🟩 97.8 %
Code coverage	Branch coverage	🟩 92 %	🟩 91.9 %
JSDocs coverage	Properties coverage	🟥 23 undocumented properties	🟥 27 undocumented properties

435 other audits are unchanged.

---

13 other projects are unchanged.