Update decorator types to be correct

[feedmypixel]

• The code currently allows any value to be added as a decorator, but the types do not. This work allows any value to be added to a decorator by updating the types to reflect what the code does
• Add relevant tests
• Update inline docs
• Create and export DecorationValue type
• Fixes Incorrect Types for decorators #4524

[feedmypixel]

@kanongil when you have a min let me know your thoughts on this. Thanks 🙏

[kanongil]

This implementation will remove the typing from an inline method declaration, as X | any will be reduced to any. I believe it should work better if additional declarations for decorate are added with method: any (or maybe even value: any).

[feedmypixel]

This implementation will remove the typing from an inline method declaration, as X | any will be reduced to any. I believe it should work better if additional declarations for decorate are added with method: any (or maybe even value: any).

Understood. I'll have a look at adding other value specific overloads. I was also wondering on changing the name of the arg to signify that any value can be passed. I'll refactor and push a commit later today

[damusix]

@feedmypixel Agreed with Gil. Perhaps you can type this to be a value from Request | Toolkit | Server interface? I imagine it'd be some utility type that removes internal, reserved keys so that it can pickup whatever you extend via declare module:

https://github.com/hapijs/hapi/blob/master/lib/request.js#L18
https://github.com/hapijs/hapi/blob/master/lib/toolkit.js#L11
https://github.com/hapijs/hapi/blob/master/lib/response.js#L25
https://github.com/hapijs/hapi/blob/master/lib/server.js#L174

Can you also add type tests? This should guarantee that nothing breaks, and you can see it in your editor in the tests if your intended types are producing any, errors, or not. Feel free to add missing tests related to this as well. It's your place to verify your changes.

https://github.com/hapijs/hapi/blob/master/test/types/index.ts

This is a good fix, though. I'm always typing around it with X as never.

[feedmypixel]

@damusix Cheers - will look into this ASAP