halua 0.0.5 → 1.1.0

package/lib/index.d.cts

@@ -0,0 +1,148 @@
+interface Handler {
+    skipDeepCopyWhenSendingLog?: boolean;
+    level?: LogLevel;
+    exact?: Array<LogLevel>;
+    log: (log: Log) => void;
+}
+interface Log {
+    timestamp: number | string;
+    level: LogLevel;
+    leveling?: [Level, number];
+    args: Array<any>;
+    messageFormat?: string;
+    assertion?: boolean;
+    withArgs?: null | Array<any>;
+}
+declare enum Level {
+    Trace = "TRACE",
+    Debug = "DEBUG",
+    Info = "INFO",
+    Notice = "NOTICE",
+    Warn = "WARN",
+    Error = "ERROR",
+    Fatal = "FATAL"
+}
+type LogLevel = string;
+
+interface HaluaOptions {
+    level?: LogLevel;
+    withArgs?: Array<any>;
+    messageFormat?: string;
+    errorPolicy?: "throw" | "pass";
+}
+interface HaluaLogger {
+    New: {
+        (handler: PassedHandler): HaluaLogger;
+        (options: HaluaOptions): HaluaLogger;
+        (arg1?: PassedHandler | HaluaOptions, arg2?: HaluaOptions): HaluaLogger;
+    };
+    With: (...args: any[]) => HaluaLogger;
+    withMessageFormat: (format: string) => HaluaLogger;
+    setHandler: (handler: PassedHandler) => void;
+    appendHandler: (handler: () => Handler) => void;
+    logTo: (level: LogLevel, ...args: any[]) => void;
+    trace: (...args: any[]) => void;
+    debug: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    notice: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    fatal: (...args: any[]) => void;
+    assert: (assertion: boolean, ...args: any[]) => void;
+}
+type PassedHandler = (() => Handler) | Array<() => Handler>;
+
+declare class Halua implements HaluaLogger {
+    private options;
+    private handlers;
+    private readonly passedHandlers;
+    private balancer;
+    constructor(passed: PassedHandler, options?: HaluaOptions);
+    New(arg1?: PassedHandler | HaluaOptions, arg2?: HaluaOptions | undefined): HaluaLogger;
+    With(...args: any[]): HaluaLogger;
+    withMessageFormat(f: string): HaluaLogger;
+    setHandler(handler: PassedHandler): void;
+    appendHandler(handler: () => Handler): void;
+    logTo(level: LogLevel, ...args: any[]): void;
+    trace(...args: any[]): void;
+    debug(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+    notice(...args: any[]): void;
+    error(...args: any[]): void;
+    fatal(...args: any[]): void;
+    assert(assertion: boolean, ...args: any[]): void;
+    private updateBalancer;
+    private sendToHandler;
+    private composeLog;
+    private validateHandlers;
+    private supposeIsHandler;
+    private unlinkInheritance;
+    private buildHandlers;
+}
+
+type ColorKey = "grey" | "green" | "blue" | "purple" | "orange" | "red";
+type Colors = Map<ColorKey, string>;
+
+interface WebConsoleLogHandler extends Handler {
+    setDateGetter: (getter: (timestamp: number) => string) => void;
+    messageFormat: Array<string>;
+}
+interface ConsoleLogHandlerConsole {
+    debug: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+}
+interface WebConsoleHandlerOptions {
+    /** customize date output */
+    dateGetter?: (timestamp: number) => string;
+    /** turn prettification on, adds colors to console output */
+    pretty?: boolean;
+    linkArguments?: boolean;
+    /** default: true, get browser theme with window.matchMedia */
+    fetchBrowserThemeOnInstanceCreation?: boolean;
+    /** provide custom colors map */
+    customColors?: Colors;
+    messageFormat?: string;
+    useWarn?: boolean;
+    useError?: boolean;
+    level?: LogLevel;
+    exact?: LogLevel | Array<LogLevel>;
+}
+declare function NewWebConsoleHandler(c?: ConsoleLogHandlerConsole, options?: WebConsoleHandlerOptions): () => WebConsoleLogHandler;
+
+interface JSONLogHandler extends Handler {
+    setDateGetter: (getter: (timestamp: number) => string) => void;
+}
+interface JSONLogHandlerOptions {
+    /** change timestamp output */
+    dateGetter?: (timestamp: number) => string;
+    /** replace value during stringify, return null to fallback on JSONHandler replacer */
+    replaceBeforeStringify?: (value: any) => any;
+    stringifier?: (value: any, replace: (value: any) => any) => string;
+    linkArguments?: boolean;
+    level?: LogLevel;
+    exact?: LogLevel | Array<LogLevel>;
+}
+declare function NewJSONHandler(send: (data: string) => void, options?: JSONLogHandlerOptions): () => JSONLogHandler;
+
+interface TextLogHandler extends Handler {
+}
+interface TextLogHandlerOptions {
+    linkArguments?: boolean;
+    dateGetter?: (t: number) => string;
+    /** @deprecated will be removed in version 2.0.0 */
+    messageFormat?: string;
+    /** replace value during stringify, return null to fallback on JSONHandler replacer */
+    replaceBeforeStringify?: (value: any) => any;
+    /** func to stringify a value */
+    stringifier?: (value: any) => string;
+    level?: LogLevel;
+    exact?: LogLevel | Array<LogLevel>;
+}
+declare function NewTextHandler(send: (data: string) => void, options?: TextLogHandlerOptions): () => TextLogHandler;
+
+declare const halua: Halua;
+
+export { type HaluaLogger, type Handler, Level, type Log, NewJSONHandler, NewTextHandler, NewWebConsoleHandler, halua };

package/lib/index.d.ts

@@ -1,56 +1,148 @@
 interface Handler {
-    debug: (msg: string) => void;
-    info: (msg: string) => void;
-    warn: (msg: string) => void;
-    error: (msg: string) => void;
-}
-type LoggerFn = (msg: string, ...args: any[]) => void;
-interface Logger {
-    debug: LoggerFn;
-    info: LoggerFn;
-    warn: LoggerFn;
-    err: LoggerFn;
-    assert: (value: boolean, msg: string, ...args: any[]) => void;
-    setHandler: (handler: Handler) => void;
-    setDateGetter: (getter: (() => string | number)) => void;
-}
-interface LoggerOptions {
-    minLevel?: Level;
-    postfix?: string;
-    dateGetter?: (() => string | number) | null | undefined;
+    skipDeepCopyWhenSendingLog?: boolean;
+    level?: LogLevel;
+    exact?: Array<LogLevel>;
+    log: (log: Log) => void;
+}
+interface Log {
+    timestamp: number | string;
+    level: LogLevel;
+    leveling?: [Level, number];
+    args: Array<any>;
+    messageFormat?: string;
+    assertion?: boolean;
+    withArgs?: null | Array<any>;
 }
 declare enum Level {
+    Trace = "TRACE",
     Debug = "DEBUG",
     Info = "INFO",
+    Notice = "NOTICE",
     Warn = "WARN",
-    Error = "ERR"
-}
-
-declare class LoggerCore implements Logger {
-    private handler;
-    private dateGetter;
-    private readonly options;
-    private readonly levelMapping;
-    constructor(handler?: Handler | null | undefined, options?: LoggerOptions);
-    New(handler?: Handler, options?: LoggerOptions): Logger;
-    With(msg: string, ...args: any[]): Logger;
-    debug(msg: string, ...args: any[]): void;
-    info(msg: string, ...args: any[]): void;
-    warn(msg: string, ...args: any[]): void;
-    err(msg: string, ...args: any[]): void;
-    assert(value: boolean, msg: string, ...args: any[]): void;
-    setHandler(handler: Handler): void;
-    setDateGetter(getter: () => string | number): void;
-    private log;
-    private composeMsgWithArgs;
-    private formatWithLevel;
-    private formatWithDate;
-    private shiftValue;
-    private appendValue;
-    private getDateInLocaleString;
-    private canLogByMinLevelRestriction;
-}
-
-declare const halua: LoggerCore;
-
-export { type Handler, Level, halua };
+    Error = "ERROR",
+    Fatal = "FATAL"
+}
+type LogLevel = string;
+
+interface HaluaOptions {
+    level?: LogLevel;
+    withArgs?: Array<any>;
+    messageFormat?: string;
+    errorPolicy?: "throw" | "pass";
+}
+interface HaluaLogger {
+    New: {
+        (handler: PassedHandler): HaluaLogger;
+        (options: HaluaOptions): HaluaLogger;
+        (arg1?: PassedHandler | HaluaOptions, arg2?: HaluaOptions): HaluaLogger;
+    };
+    With: (...args: any[]) => HaluaLogger;
+    withMessageFormat: (format: string) => HaluaLogger;
+    setHandler: (handler: PassedHandler) => void;
+    appendHandler: (handler: () => Handler) => void;
+    logTo: (level: LogLevel, ...args: any[]) => void;
+    trace: (...args: any[]) => void;
+    debug: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    notice: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    fatal: (...args: any[]) => void;
+    assert: (assertion: boolean, ...args: any[]) => void;
+}
+type PassedHandler = (() => Handler) | Array<() => Handler>;
+
+declare class Halua implements HaluaLogger {
+    private options;
+    private handlers;
+    private readonly passedHandlers;
+    private balancer;
+    constructor(passed: PassedHandler, options?: HaluaOptions);
+    New(arg1?: PassedHandler | HaluaOptions, arg2?: HaluaOptions | undefined): HaluaLogger;
+    With(...args: any[]): HaluaLogger;
+    withMessageFormat(f: string): HaluaLogger;
+    setHandler(handler: PassedHandler): void;
+    appendHandler(handler: () => Handler): void;
+    logTo(level: LogLevel, ...args: any[]): void;
+    trace(...args: any[]): void;
+    debug(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+    notice(...args: any[]): void;
+    error(...args: any[]): void;
+    fatal(...args: any[]): void;
+    assert(assertion: boolean, ...args: any[]): void;
+    private updateBalancer;
+    private sendToHandler;
+    private composeLog;
+    private validateHandlers;
+    private supposeIsHandler;
+    private unlinkInheritance;
+    private buildHandlers;
+}
+
+type ColorKey = "grey" | "green" | "blue" | "purple" | "orange" | "red";
+type Colors = Map<ColorKey, string>;
+
+interface WebConsoleLogHandler extends Handler {
+    setDateGetter: (getter: (timestamp: number) => string) => void;
+    messageFormat: Array<string>;
+}
+interface ConsoleLogHandlerConsole {
+    debug: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+}
+interface WebConsoleHandlerOptions {
+    /** customize date output */
+    dateGetter?: (timestamp: number) => string;
+    /** turn prettification on, adds colors to console output */
+    pretty?: boolean;
+    linkArguments?: boolean;
+    /** default: true, get browser theme with window.matchMedia */
+    fetchBrowserThemeOnInstanceCreation?: boolean;
+    /** provide custom colors map */
+    customColors?: Colors;
+    messageFormat?: string;
+    useWarn?: boolean;
+    useError?: boolean;
+    level?: LogLevel;
+    exact?: LogLevel | Array<LogLevel>;
+}
+declare function NewWebConsoleHandler(c?: ConsoleLogHandlerConsole, options?: WebConsoleHandlerOptions): () => WebConsoleLogHandler;
+
+interface JSONLogHandler extends Handler {
+    setDateGetter: (getter: (timestamp: number) => string) => void;
+}
+interface JSONLogHandlerOptions {
+    /** change timestamp output */
+    dateGetter?: (timestamp: number) => string;
+    /** replace value during stringify, return null to fallback on JSONHandler replacer */
+    replaceBeforeStringify?: (value: any) => any;
+    stringifier?: (value: any, replace: (value: any) => any) => string;
+    linkArguments?: boolean;
+    level?: LogLevel;
+    exact?: LogLevel | Array<LogLevel>;
+}
+declare function NewJSONHandler(send: (data: string) => void, options?: JSONLogHandlerOptions): () => JSONLogHandler;
+
+interface TextLogHandler extends Handler {
+}
+interface TextLogHandlerOptions {
+    linkArguments?: boolean;
+    dateGetter?: (t: number) => string;
+    /** @deprecated will be removed in version 2.0.0 */
+    messageFormat?: string;
+    /** replace value during stringify, return null to fallback on JSONHandler replacer */
+    replaceBeforeStringify?: (value: any) => any;
+    /** func to stringify a value */
+    stringifier?: (value: any) => string;
+    level?: LogLevel;
+    exact?: LogLevel | Array<LogLevel>;
+}
+declare function NewTextHandler(send: (data: string) => void, options?: TextLogHandlerOptions): () => TextLogHandler;
+
+declare const halua: Halua;
+
+export { type HaluaLogger, type Handler, Level, type Log, NewJSONHandler, NewTextHandler, NewWebConsoleHandler, halua };