Feature request: export LogLevel values as object

[adityamatt]

Summary

LogLevel for the lambda is currently a type

type LogLevelDebug = 'DEBUG';
type LogLevelInfo = 'INFO';
type LogLevelWarn = 'WARN';
type LogLevelError = 'ERROR';
type LogLevelSilent = 'SILENT';
type LogLevelCritical = 'CRITICAL';

type LogLevel = LogLevelDebug | Lowercase<LogLevelDebug> | LogLevelInfo | Lowercase<LogLevelInfo> | LogLevelWarn | Lowercase<LogLevelWarn> | LogLevelError | Lowercase<LogLevelError> | LogLevelSilent | Lowercase<LogLevelSilent> | LogLevelCritical | Lowercase<LogLevelCritical>;

Can we turn this into an enum and export it ?

Why is this needed?

We can import this enum and use it

Which area does this relate to?

Logger

Solution

enum LogLevel {
    DEBUG = "DEBUG",
    INFO = "INFO",
    ERROR = "ERROR",
    SILENT = "SILENT",
    CRITICAL= "CRITICAL"
}


type LogLevelType = LogLevel | Lowercase<LogLevel>

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.

[boring-cyborg]

Thanks for opening your first issue here! We'll come back to you as soon as we can.
In the meantime, check out the #typescript channel on our Powertools for AWS Lambda Discord: Invite link

[am29d]

Hey @adityamatt , thanks for raising the issue. What is the problem you are trying to solve? Can you share a bit more of context and info why it has to be enum and why it does not work with the current implementation?

[adityamatt]

Hi @am29d ,
There is no blocking problem, for now , we need to define a common variable in our codebase and use it as default log level, We add the type check by importing the types from the library. but it could be improved if we could import the enum itself rather than the type and then create the value ourself, it seems too verbose.

Our current use:

const DEFAULT_LOG_LEVEL: LogLevel = 'ERROR'


const logger = new Logger({
  logLevel : DEFAULT_LOG_LEVEL
});

I propose rather than importing a type and defining a variable, if we can import the enum itself, it would simplify things

const logger = new Logger({
  logLevel :  LogLevel.ERROR
});

[dreamorosi]

Thank you for providing the additional info, I think adding the log levels in a similar way to the one you describe is valid.

As a project, we have been trying to move away from enums and instead use objects with the as const notation (see here as for why).

For this specific feature, I would like to see the following:

• Add a LogLevel object in packages/logger/src/constants.ts like this:

const LogLevel = {
  DEBUG: 'DEBUG',
  INFO: 'INFO',
  WARN: 'WARN',
  ERROR: 'ERROR',
  SILENT: 'SILENT',
  CRITICAL: 'CRITICAL',
} as const;

• Import that constant in packages/logger/src/types/Log.ts and replace the existing types with this:

+ import { LogLevel } from '../constants.js';

- type LogLevelDebug = 'DEBUG';
- type LogLevelInfo = 'INFO';
- type LogLevelWarn = 'WARN';
- type LogLevelError = 'ERROR';
- type LogLevelSilent = 'SILENT';
- type LogLevelCritical = 'CRITICAL';

type LogLevel =
-   | LogLevelDebug
-   | Lowercase<LogLevelDebug>
-   | LogLevelInfo
-   | Lowercase<LogLevelInfo>
-   | LogLevelWarn
-   | Lowercase<LogLevelWarn>
-   | LogLevelError
-   | Lowercase<LogLevelError>
-   | LogLevelSilent
-   | Lowercase<LogLevelSilent>
-   | LogLevelCritical
-   | Lowercase<LogLevelCritical>;
+   | (typeof LogLevel)[keyof typeof LogLevel]
+   | Lowercase<(typeof LogLevel)[keyof typeof LogLevel]>;

• Export the newly added LogLevel constant in the packages/logger/src/index.ts file
• Modify this test case here to use the new LogLevel.DEBUG value (this will require importing it here and modifying import { LogLevelThresholds, LogLevel } from '../../src/types/Log.js'; to something like LogLevel as LogLevelType so that they don't clash.

---

I'm adding the help-wanted and good-first-issue labels to the issue, if anyone is interested in contributing with a PR, please leave a comment here so I can assign the issue to you.