Initial source added.

Author: Giedrius Grabauskas

.gitignore

@@ -0,0 +1 @@
+node_modules

@types/abstractions.d.ts

@@ -0,0 +1,2 @@
+export { LogLevel } from "./abstractions/log-level";
+export { MessageHandlerBase } from "./abstractions/message-handler-base";

@types/abstractions/log-level.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Defines logging severity levels.
+ */
+export declare enum LogLevel {
+    /**
+     * Not used for writing log messages. Specifies that a logging category should not write any messages.
+     */
+    None = 0,
+    /**
+     * Logs that describe an unrecoverable application or system crash,
+     * or a catastrophic failure that requires immediate attention.
+     */
+    Critical = 1,
+    /**
+     * Logs that highlight when the current flow of execution is stopped due to a failure.
+     * These should indicate a failure in the current activity, not an application-wide failure.
+     */
+    Error = 2,
+    /**
+     * Logs that highlight an abnormal or unexpected event in the application flow,
+     * but do not otherwise cause the application execution to stop.
+     */
+    Warning = 4,
+    /**
+     * Logs that track the general flow of the application. These logs should have long-term value.
+     */
+    Information = 8,
+    /**
+     * Logs that are used for interactive investigation during development.
+     * These logs should primarily contain information useful for debugging and have no long-term value.
+     */
+    Debug = 16,
+    /**
+     * Logs that contain the most detailed messages. These messages may contain sensitive application data.
+     * These messages are disabled by default and should never be enabled in a production environment.
+     */
+    Trace = 32,
+}

@types/abstractions/message-handler-base.d.ts

@@ -0,0 +1,4 @@
+import { LogLevel } from "./log-level";
+export declare abstract class MessageHandlerBase {
+    abstract HandleMessage(level: LogLevel, isLevelEnabled: boolean, timestamp: number, messages: any[]): void;
+}

@types/builders/logger-builder.d.ts

@@ -0,0 +1,50 @@
+import { LoggerConfiguration } from "./logger-configuration-builder";
+import { LogLevel } from "../abstractions/log-level";
+export declare class LoggerBuilder {
+    private configuration;
+    constructor(configuration?: LoggerConfiguration);
+    /**
+     * Writes a log entries with specified log level.
+     *
+     * @param level Entries will be written on this level.
+     * @param messages Messages to be written.
+     */
+    Log: (level: LogLevel, ...messages: any[]) => number;
+    /**
+     * Write a log entries with debug log level.
+     *
+     * @param messages Messages to be written.
+     */
+    Debug: (...messages: any[]) => number;
+    /**
+     * Write a log entries with information log level.
+     *
+     * @param messages Messages to be written.
+     */
+    Info: (...messages: any[]) => number;
+    /**
+     * Write a log entries with warning log level.
+     *
+     * @param messages Messages to be written.
+     */
+    Warn: (...messages: any[]) => number;
+    /**
+     * Write a log entries with error log level.
+     *
+     * @param messages Messages to be written.
+     */
+    Error: (...messages: any[]) => number;
+    /**
+     * Write a log entries with critical log level.
+     *
+     * @param messages Messages to be written.
+     */
+    Critical: (...messages: any[]) => number;
+    /**
+     * Check if log level is enabled.
+     *
+     * @param level Log level value.
+     */
+    IsEnabled(level: LogLevel): boolean;
+    private log(level, ...messages);
+}

@types/builders/logger-configuration-builder.d.ts

@@ -0,0 +1,37 @@
+import { MessageHandlerBase } from "../abstractions/message-handler-base";
+import { LogLevel } from "../abstractions/log-level";
+export interface LoggerConfiguration {
+    WriteMessageHandler: MessageHandlerBase;
+    LogLevel: LogLevel;
+    CustomLogLevels?: boolean;
+}
+/**
+ * Logger configuration builder.
+ */
+export declare class LoggerConfigurationBuilder {
+    constructor(initConfiguration?: Partial<LoggerConfiguration>);
+    private configuration;
+    private defaultConfiguration();
+    /**
+     * Set custom message handler.
+     *
+     * @param handler Log messages handler.
+     */
+    SetWriteMessageHandler(handler: MessageHandlerBase): this;
+    /**
+     * Set log level.
+     *
+     * @param logLevel LogLevel value or bit mask values.
+     */
+    SetLogLevel(logLevel: LogLevel): this;
+    /**
+     * Set custom log levels.
+     *
+     * @param logLevels List of log level.
+     */
+    SetCustomLogLevels(logLevels: LogLevel[]): this;
+    /**
+     * Build configuration result object.
+     */
+    Build(): LoggerConfiguration;
+}

@types/handlers.d.ts

@@ -0,0 +1 @@
+export { ConsoleMessageHandler } from "./handlers/console-message-handler";

@types/handlers/console-message-handler.d.ts

@@ -0,0 +1,7 @@
+import { LogLevel } from "../abstractions/log-level";
+import { MessageHandlerBase } from "../abstractions/message-handler-base";
+export declare class ConsoleMessageHandler extends MessageHandlerBase {
+    private useShortPrefix;
+    constructor(useShortPrefix?: boolean);
+    HandleMessage(level: LogLevel, isEnabled: boolean, timestamp: number, messages: any[]): void;
+}

@types/index.d.ts

@@ -0,0 +1,6 @@
+export { LoggerBuilder } from "./builders/logger-builder";
+export { LoggerConfigurationBuilder, LoggerConfiguration } from "./builders/logger-configuration-builder";
+export { LogLevel } from "./abstractions/log-level";
+export { MessageHandlerBase } from "./abstractions/message-handler-base";
+import * as Handlers from "./handlers";
+export { Handlers };