feat(utils): add WriteAheadLog classes

[BioPhoton]

Related: #1197

This PR includes:

• types for source sink flows
• wal.ts - general WriteAheadLog
• wal-trace-json.ts traceEvent specific login for a WAL
• profiler constants to control WAL leader
• moved trace utils into profiler

Note

This PR addresses a comment related to logging.

Warning

All filesystem operations in WAL—and indirectly in the profiler—are synchronous by design.
The eslint rules are disables over fine name pattern

Why synchronous fs is used for WAL code?

• Profilers are side-channels, not business logic
• Data must never be lost, reordered, or partially written
• process.on('exit') cannot safely run async I/O
• Sync writes guarantee ordering + durability
• Profiler I/O volume is small → overhead is negligible
• Crash-safety > throughput

[nx-cloud]

View your CI Pipeline Execution ↗ for commit bc86d08

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 27s	View ↗
nx run-many --targets=code-pushup --parallel=fa...	✅ Succeeded	12m 30s	View ↗
nx run-many -t unit-test,int-test	✅ Succeeded	9s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-01-18 02:39:47 UTC

[pkg-pr-new]

Open in StackBlitz

@code-pushup/ci

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

@code-pushup/cli

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

@code-pushup/core

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

@code-pushup/create-cli

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

@code-pushup/models

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

@code-pushup/nx-plugin

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

@code-pushup/axe-plugin

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

@code-pushup/eslint-plugin

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

@code-pushup/coverage-plugin

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

@code-pushup/js-packages-plugin

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

@code-pushup/jsdocs-plugin

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

@code-pushup/lighthouse-plugin

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

@code-pushup/typescript-plugin

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

@code-pushup/utils

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

commit: bc86d08

[github-actions]

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit 894a5d8 with previous commit 270b474.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Categories

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Documentation	🔴 42	🔴 46
Performance	🔴 37	🔴 34
Code coverage	🟢 93	🟢 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, 👍 9 audits improved, 👎 4 audits regressed, 14 audits changed without impacting score

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
JSDocs coverage	Documentation coverage	🔴 42	🔴 46
Lighthouse	Performance	🔴 37	🔴 34
Code coverage	Code coverage metrics	🟢 93	🟢 93

31 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
Lighthouse	Speed Index	🟥 6.0 s	🟥 7.1 s
JSDocs coverage	Classes coverage	🟥 6 undocumented classes	🟨 6 undocumented classes
JSDocs coverage	Properties coverage	🟥 30 undocumented properties	🟥 37 undocumented properties
Lighthouse	First Contentful Paint	🟥 3.1 s	🟥 3.2 s
Lighthouse	Total Blocking Time	🟥 1,890 ms	🟥 2,350 ms
Lighthouse	Time to Interactive	🟥 13.0 s	🟥 14.1 s
JSDocs coverage	Types coverage	🟥 268 undocumented types	🟥 258 undocumented types
JSDocs coverage	Functions coverage	🟥 577 undocumented functions	🟥 578 undocumented functions
JSDocs coverage	Variables coverage	🟥 268 undocumented variables	🟥 275 undocumented variables
JSDocs coverage	Methods coverage	🟨 13 undocumented methods	🟨 15 undocumented methods
Code coverage	Function coverage	🟩 94.4 %	🟩 94.6 %
Code coverage	Branch coverage	🟨 89 %	🟨 89.3 %
Code coverage	Line coverage	🟩 92.7 %	🟩 92.9 %
Lighthouse	Avoids enormous network payloads	🟩 Total size was 2,104 KiB	🟩 Total size was 2,092 KiB
Lighthouse	Minimizes main-thread work	🟥 9.2 s	🟥 11.2 s
Lighthouse	JavaScript execution time	🟥 4.3 s	🟥 5.7 s
Lighthouse	Metrics	🟩 100%	🟩 100%
Lighthouse	Server Backend Latencies	🟩 1,200 ms	🟩 250 ms
Lighthouse	Max Potential First Input Delay	🟥 980 ms	🟥 1,510 ms
Lighthouse	Uses efficient cache policy on static assets	🟨 31 resources found	🟨 31 resources found
Lighthouse	Reduce unused JavaScript	🟥 Potential savings of 224 KiB	🟥 Potential savings of 225 KiB
Lighthouse	Largest Contentful Paint	🟥 11.5 s	🟥 11.3 s
Lighthouse	Remove duplicate modules in JavaScript bundles	🟥 Potential savings of 93 KiB	🟥 Potential savings of 93 KiB
Lighthouse	Initial server response time was short	🟩 Root document took 540 ms	🟩 Root document took 500 ms
Lighthouse	Reduce unused CSS	🟥 Potential savings of 95 KiB	🟥 Potential savings of 95 KiB
Lighthouse	Network Round Trip Times	🟩 10 ms	🟩 20 ms
TypeScript	Semantic errors	🟥 25 errors	🟥 26 errors

652 other audits are unchanged.

[github-actions]

Code PushUp

🥳 Code PushUp report has improved – compared current commit 894a5d8 with previous commit 270b474.

💼 Project utils

🥳 Code PushUp report has improved.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Documentation	🔴 45	🟡 51
Code coverage	🟢 95	🟢 95

4 other categories are unchanged.

👍 2 groups improved, 👍 9 audits improved

🗃️ Groups

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

13 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
JSDocs coverage	Classes coverage	🟨 3 undocumented classes	🟨 3 undocumented classes
JSDocs coverage	Properties coverage	🟥 27 undocumented properties	🟥 34 undocumented properties
JSDocs coverage	Types coverage	🟥 66 undocumented types	🟨 56 undocumented types
JSDocs coverage	Functions coverage	🟥 239 undocumented functions	🟥 240 undocumented functions
JSDocs coverage	Variables coverage	🟥 49 undocumented variables	🟥 56 undocumented variables
JSDocs coverage	Methods coverage	🟨 13 undocumented methods	🟨 15 undocumented methods
Code coverage	Function coverage	🟩 96.2 %	🟩 96.6 %
Code coverage	Branch coverage	🟩 91.8 %	🟩 92.2 %
Code coverage	Line coverage	🟩 97.8 %	🟩 98 %

435 other audits are unchanged.

---

13 other projects are unchanged.