feat(returner): add new type

[ivangelus]

https://make.atlassian.net/browse/CDM-13296

add new returner type to proto lib

this type will be used to return data from scenarios

[github-actions]

	Messages
✅	Your PR title & description are valid

_{Generated 8. 2. 2025 12:03:12 GMT+1 for 2eaecb3}

[make-coverage]

Unit Test Coverage Report

Metric	master	CDM-13296-returner-type	Status
Statements	85.13%	84.85%	💔
Branches	45.35%	45.35%	✔️
Functions	64.86%	64.60%	💔

[matejmichnak]

LGTM, but I've also requested @dominikkadera review just to have a look whether we are not forgetting something.

[dominikkadera]

Thanks for the ping -- looks great to me as well 👌

One small detail I'd probably suggest is expanding the Legacy Compatibility Test -- https://github.com/integromat/imt-proto/blob/63bebd88c9653c18d470242b81293b5b2e0507c1/test/legacy-compatibility.test.ts -- to cover also for the Returner. If I remember correctly, there are still Services (for example the WebAPI), which use the @integromat/proto/global implementation, and therefore adding a test which ensures that the global.IMTReturner is indeed set correctly could be a good safety-net costing us just a couple of more lines of a test code 🙏

From technical point of view, I'd say all the needs are covered 😁

[ivangelus]

Thank you all for review 🙏
extended legacy comp test 👍

[dominikkadera]

Thanks a lot for the tweaks, looks perfect now 👌 🚀