Maintenance: refactor `Logger` types and interfaces to improve consistency and clarity

[dreamorosi]

Summary

Review all type and interface definitions and usage throughout the codebase to identify opportunities for refactoring and clean up. This will help improve consistency in naming, structure, and usage of types across the project.

Specific areas to investigate:

• Inconsistent naming (plural vs singular, capitalization, abbreviations, etc.)
• Misnamed types that are not actually types but constants or enums
• Usage of any where more specific types could be defined
• Opportunities to convert usage of enums to as const types
• Inheritance hierarchies that could be simplified
• Re-organization of types into more logical modules/namespaces

Why is this needed?

As the project has grown organically, inconsistencies in how types are defined and used have emerged. By refactoring and cleaning these up, we can improve maintainability, clarity, and reliability of the codebase.

More consistent and intention-revealing names will also improve onboarding and comprehension as well as DX.

Converting usage to proper types where applicable will enable stronger compiler checking and editor tooling support. Overall, this refactoring will leave the code in better shape for continued development and maintenance.

Which area does this relate to?

No response

Solution

Examples of types/interfaces/objects that could be improved:

• ClassThatLogs (here) might be converted to an interface, renamed, and made to include all methods
• ConstructorOptions (here) could be renamed to something more explanatory like LoggerOptions or similar (check other utilities)
• LogJsonIndent (here) should be moved out of this file and into a constants.ts file similar to what done in other utilities, also it should be converted to an object as we are moving away from enums.

---

Important

Before starting to work on a PR for this issue, the assignee should do an investigation of the code and propose an action plan under this issue.

Once the plan has been discussed and agreed upon with at least one maintainer work on the PR can start.

Acknowledgment

• This request meets Powertools for AWS Lambda (TypeScript) Tenets
• Should this be considered in other Powertools for AWS Lambda languages? i.e. Python, Java, and .NET

Future readers

Please react with 👍 and your use case to help us understand customer demand.

[codyfrisch]

Another task, though simple, is to relocate type HandlerMethodDecorator to commonso/utils/lambda. It appears to be duplicated in the core modules

This has the added benefit that we can add commons as a dev dependency for modules that will implement handler decorators but don't need anything from logger (though obviously as dev dependency and declaring the import as a type it doesn't matter a whole lot). Just seems cleaner to me.

[dreamorosi]

Hi @codyfrisch, you're right and making this change makes sense.

We have already moved that type in the v2 branch and switched to using it in some of the utilities.

I haven't switched Logger to use it yet because I wanted to see if #1744 would be merged first, but I'm planning to.