import { LogLevel } from "slf4ts-api";
 
interface LoggerImplementation {
    log(...args: any[]): Promise<any>;
    getImplementation<T>(): T;
    setConfig<T>(config: T, group: string, name: string): void;
    setLogLevel(logLevel: LogLevel, group: string, name: string): void;
    setMetadata(metadata: any, group: string, name: string): void;
}
 
interface LoggerBinding {
    getLoggerImplementation(): LoggerImplementation;
    getVendor(): string;
    getVersion(): string;
}

import { LoggerBindings } from "slf4ts-api";
 
export default function(bindings: LoggerBindings) {
    bindings.registerBinding({
        getLoggerImplementation: () => { ... },
        getVendor: () => "My Logger Binding Implementation",
        getVersion: () => "1.0.0"
    });
}
 

import { LoggerConfiguration, LogLevel, LoggerFactory } from "slf4ts-api";
 
// gets the root logger (group "" and name "")
const ROOT_LOGGER = LoggerFactory.getLogger();
 
class X {
 
    // gets a logger with group "my-lib" and name "X"
    private static LOG = LoggerFactory.getLogger("my-lib", "X");
 
    public async something(value: any) {
        // log with debug level and some metadata
        X.LOG.debug(`a message with ${value}`, { additionalData: "Testvalue" });
 
        try {
            ...
        } catch(error: Error) {
            // logs an error without metadata
            X.LOG.error('Error!', error);
        }
    }
 
}
 
// sets the log level of all loggers
LoggerConfiguration.setLogLevel(LogLevel.INFO);
 
// sets the log level of all loggers within group "my-lib"
LoggerConfiguration.setLogLevel(LogLevel.WARN, "my-lib");
 
// sets the log level of the logger with group "my-lib" and name "X"
LoggerConfiguration.setLogLevel(LogLevel.ERROR, "my-lib", "X");
 
const config = {
    transports: [...],
    events: [...],
    postProcessor: () => { ... }
};
 
// sets the config of all loggers
LoggerConfiguration.setConfig(config);
 
// sets the config of all loggers within group "my-lib"
LoggerConfiguration.setConfig(config, "my-lib");
 
// sets the config of the logger with group "my-lib" and name "X"
LoggerConfiguration.setConfig(config, "my-lib", "X");