feat(api chart): allow customizing api chart with query or body parameters

[arnaud-moncel]

Definition of Done

General

• Write an explicit title for the Pull Request, following Conventional Commits specification
• Test manually the implemented changes
• Validate the code quality (indentation, syntax, style, simplicity, readability)

Security

• Consider the security impact of the changes made

Note

Allow passing query and body parameters to API chart handlers

• Adds QueryStringParser.parseChartParameters in query-string.ts to merge context.request.query and context.request.body into a flat Record<string, string>, with body values taking precedence.
• Passes the parsed parameters as an additional argument to renderChart in both collection and datasource chart routes.
• Extends CollectionChartContext and the new DataSourceChartContext to expose an immutable parameters object to chart handler callbacks.
• Updates renderChart signatures across datasource-toolkit interfaces, decorators, and datasource-customizer to thread the optional parameters argument through the full call chain.
• DataSourceChartContext is a new context class; CollectionChartDefinition and DataSourceChartDefinition are now exported from datasource-customizer.

^{Macroscope summarized 5cdd942.}

[qltysh]

4 new issues

Tool	Category	Rule	Count
qlty	Structure	Function with many parameters (count = 4): renderChart	4

[qltysh]

Coverage Impact

This PR will not change total coverage.

Modified Files with Diff Coverage (9)

Rating	File	% Diff	Uncovered Line #s
	packages/datasource-customizer/src/decorators/chart/collection.ts	100.0%
	...s/datasource-customizer/src/decorators/composite-datasource.ts	100.0%
	packages/datasource-customizer/src/decorators/chart/datasource.ts	100.0%
	...ages/datasource-toolkit/src/decorators/datasource-decorator.ts	100.0%
	...ages/datasource-toolkit/src/decorators/collection-decorator.ts	100.0%
	packages/agent/src/utils/query-string.ts	100.0%
	packages/datasource-customizer/src/index.ts	100.0%
	packages/datasource-customizer/src/decorators/chart/context.ts	100.0%
	...ce-customizer/src/decorators/chart/datasource-chart-context.ts	100.0%
	Total	100.0%

🚦 See full report on Qlty Cloud »

🛟 Help

• Diff Coverage: Coverage for added or modified lines of code (excludes deleted files). Learn more.

• Total Coverage: Coverage for the whole repository, calculated as the sum of all File Coverage. Learn more.

• File Coverage: Covered Lines divided by Covered Lines plus Missed Lines. (Excludes non-executable lines including blank lines and comments.)

  • Indirect Changes: Changes to File Coverage for files that were not modified in this PR. Learn more.

[matthv]

LGTM 🚀