feat(utils): add WriteAheadLog classes

[BioPhoton]

Related: #1197

This PR includes:

• types for source sink flows
• wal.ts - general WriteAheadLog and sharded WAL inc format and filenames
• 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.
It could also be used as file output for the logger

Warning

All filesystem operations in WAL—and indirectly in the profiler—are synchronous by design.
The eslint rules are disables over file 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 a3641d3

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

---

☁️ Nx Cloud last updated this comment at 2026-01-18 23:17:23 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/coverage-plugin

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

@code-pushup/eslint-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/eslint-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: a3641d3

[github-actions]

Code PushUp

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

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Categories

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Documentation	🔴 42	🔴 46
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	–
Performance	🔴 37	🔴 37	–
Accessibility	🟢 92	🟢 92	–
Best Practices	🟢 100	🟢 100	–
SEO	🟢 92	🟢 92	–

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

🗃️ Groups

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

32 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
JSDocs coverage	Classes coverage	🟥 6 undocumented classes	🟨 6 undocumented classes
JSDocs coverage	Properties coverage	🟥 30 undocumented properties	🟥 40 undocumented properties
Lighthouse	Speed Index	🟥 6.0 s	🟨 5.7 s
Lighthouse	Time to Interactive	🟥 13.0 s	🟥 12.5 s
Lighthouse	Total Blocking Time	🟥 1,890 ms	🟥 2,080 ms
JSDocs coverage	Functions coverage	🟥 577 undocumented functions	🟥 580 undocumented functions
JSDocs coverage	Types coverage	🟥 268 undocumented types	🟥 258 undocumented types
JSDocs coverage	Variables coverage	🟥 268 undocumented variables	🟥 276 undocumented variables
Lighthouse	First Contentful Paint	🟥 3.1 s	🟥 3.1 s
JSDocs coverage	Methods coverage	🟨 13 undocumented methods	🟨 15 undocumented methods
Code coverage	Function coverage	🟩 94.4 %	🟩 94.6 %
Code coverage	Line coverage	🟩 92.7 %	🟩 92.9 %
Code coverage	Branch coverage	🟨 89 %	🟨 89.2 %
Lighthouse	Avoids enormous network payloads	🟩 Total size was 2,104 KiB	🟩 Total size was 2,102 KiB
Lighthouse	Largest Contentful Paint	🟥 11.5 s	🟥 10.6 s
Lighthouse	Uses efficient cache policy on static assets	🟨 31 resources found	🟨 31 resources found
Lighthouse	Metrics	🟩 100%	🟩 100%
Lighthouse	Minimizes main-thread work	🟥 9.2 s	🟥 8.8 s
Lighthouse	Reduce unused CSS	🟥 Potential savings of 95 KiB	🟥 Potential savings of 95 KiB
Lighthouse	Reduce unused JavaScript	🟥 Potential savings of 224 KiB	🟥 Potential savings of 225 KiB
Lighthouse	Server Backend Latencies	🟩 1,200 ms	🟩 930 ms
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 390 ms
Lighthouse	Max Potential First Input Delay	🟥 980 ms	🟥 900 ms
Lighthouse	JavaScript execution time	🟥 4.3 s	🟥 4.3 s
TypeScript	Semantic errors	🟥 25 errors	🟥 26 errors
Lighthouse	Network Round Trip Times	🟩 10 ms	🟩 10 ms

652 other audits are unchanged.

[github-actions]

Code PushUp

🥳 Code PushUp report has improved – compared current commit f5a0e21 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	🟥 37 undocumented properties
JSDocs coverage	Types coverage	🟥 66 undocumented types	🟨 56 undocumented types
JSDocs coverage	Functions coverage	🟥 239 undocumented functions	🟥 242 undocumented functions
JSDocs coverage	Variables coverage	🟥 49 undocumented variables	🟥 57 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.