feat(utils): add file sink classes

[BioPhoton]

Related: #1197

This PR includes:

• types for source sink flows
• file-sink sink class
• file-sink-jsonl sink class
• file-sink-trace-json sink class

[nx-cloud]

View your CI Pipeline Execution ↗ for commit e0c210e

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 33s	View ↗
nx run-many -t unit-test,int-test	✅ Succeeded	8s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-01-16 22:37:14 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: e0c210e

[github-actions]

Code PushUp

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

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Categories

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

👎 3 groups regressed, 👍 1 audit improved, 👎 9 audits regressed, 17 audits changed without impacting score

🗃️ Groups

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

31 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
JSDocs coverage	Methods coverage	🟨 13 undocumented methods	🟥 40 undocumented methods
JSDocs coverage	Classes coverage	🟥 6 undocumented classes	🟥 10 undocumented classes
Lighthouse	Time to Interactive	🟥 13.0 s	🟥 13.0 s
Lighthouse	Speed Index	🟥 6.0 s	🟥 6.1 s
Code coverage	Function coverage	🟩 94.4 %	🟩 93.6 %
Code coverage	Branch coverage	🟨 89 %	🟨 88.8 %
JSDocs coverage	Variables coverage	🟥 268 undocumented variables	🟥 274 undocumented variables
JSDocs coverage	Functions coverage	🟥 577 undocumented functions	🟥 584 undocumented functions
Code coverage	Line coverage	🟩 92.7 %	🟩 92.6 %
JSDocs coverage	Types coverage	🟥 268 undocumented types	🟥 272 undocumented types
Lighthouse	Avoids enormous network payloads	🟩 Total size was 2,104 KiB	🟩 Total size was 2,107 KiB
Lighthouse	Uses efficient cache policy on static assets	🟨 31 resources found	🟨 31 resources found
Lighthouse	Largest Contentful Paint	🟥 11.5 s	🟥 11.1 s
Lighthouse	Server Backend Latencies	🟩 1,200 ms	🟩 920 ms
Lighthouse	Reduce unused JavaScript	🟥 Potential savings of 224 KiB	🟥 Potential savings of 225 KiB
Lighthouse	Reduce unused CSS	🟥 Potential savings of 95 KiB	🟥 Potential savings of 95 KiB
Lighthouse	Remove duplicate modules in JavaScript bundles	🟥 Potential savings of 93 KiB	🟥 Potential savings of 90 KiB
Lighthouse	JavaScript execution time	🟥 4.3 s	🟥 4.4 s
Lighthouse	Metrics	🟩 100%	🟩 100%
Lighthouse	Initial server response time was short	🟩 Root document took 540 ms	🟩 Root document took 490 ms
Lighthouse	Max Potential First Input Delay	🟥 980 ms	🟥 950 ms
Lighthouse	First Contentful Paint	🟥 3.1 s	🟥 3.1 s
Lighthouse	Minimizes main-thread work	🟥 9.2 s	🟥 9.3 s
JSDocs coverage	Properties coverage	🟥 30 undocumented properties	🟥 39 undocumented properties
Lighthouse	Network Round Trip Times	🟩 10 ms	🟩 20 ms
Lighthouse	Total Blocking Time	🟥 1,890 ms	🟥 1,880 ms
TypeScript	Semantic errors	🟥 25 errors	🟥 27 errors

652 other audits are unchanged.

[github-actions]

Code PushUp

😟 Code PushUp report has regressed – compared current commit 8cc3cbb with previous commit 270b474.

💼 Project utils

😟 Code PushUp report has regressed.

🕵️ See full comparison in Code PushUp portal 🔍

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

4 other categories are unchanged.

👎 2 groups regressed, 👎 8 audits regressed, 1 audit changed without impacting score

🗃️ Groups

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

13 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
JSDocs coverage	Methods coverage	🟨 13 undocumented methods	🟥 40 undocumented methods
JSDocs coverage	Classes coverage	🟨 3 undocumented classes	🟥 7 undocumented classes
Code coverage	Function coverage	🟩 96.2 %	🟩 94.1 %
JSDocs coverage	Variables coverage	🟥 49 undocumented variables	🟥 55 undocumented variables
JSDocs coverage	Types coverage	🟥 66 undocumented types	🟥 70 undocumented types
Code coverage	Branch coverage	🟩 91.8 %	🟩 91.1 %
Code coverage	Line coverage	🟩 97.8 %	🟩 97.2 %
JSDocs coverage	Functions coverage	🟥 239 undocumented functions	🟥 246 undocumented functions
JSDocs coverage	Properties coverage	🟥 27 undocumented properties	🟥 36 undocumented properties

435 other audits are unchanged.

---

13 other projects are unchanged.