@idlebox/logger 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 GongT<admin@gongt.me>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/config/rig.json

@@ -0,0 +1,5 @@
+{
+	"$schema": "https://developer.microsoft.com/json-schemas/rig-package/rig.schema.json",
+	"rigPackageName": "@internal/local-rig",
+	"rigProfile": "default"
+}

package/lib/common/colors.d.ts

@@ -0,0 +1,13 @@
+export declare enum LogLevel {
+    fatal = 0,
+    error = 1,
+    success = 2,
+    warn = 3,
+    info = 4,
+    log = 5,
+    debug = 6,
+    verbose = 7
+}
+export declare const logTagColor: Record<LogLevel, string>;
+export declare const logLevelPaddingStr: Record<LogLevel, string>;
+//# sourceMappingURL=colors.d.ts.map

package/lib/common/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/common/colors.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IACnB,KAAK,IAAI;IACT,KAAK,IAAI;IACT,OAAO,IAAI;IACX,IAAI,IAAI;IACR,IAAI,IAAI;IACR,GAAG,IAAI;IAEP,KAAK,IAAI;IACT,OAAO,IAAI;CACX;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAShD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CASvD,CAAC"}

package/lib/common/colors.js

@@ -0,0 +1,33 @@
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["fatal"] = 0] = "fatal";
+    LogLevel[LogLevel["error"] = 1] = "error";
+    LogLevel[LogLevel["success"] = 2] = "success";
+    LogLevel[LogLevel["warn"] = 3] = "warn";
+    LogLevel[LogLevel["info"] = 4] = "info";
+    LogLevel[LogLevel["log"] = 5] = "log";
+    //
+    LogLevel[LogLevel["debug"] = 6] = "debug";
+    LogLevel[LogLevel["verbose"] = 7] = "verbose";
+})(LogLevel || (LogLevel = {}));
+export const logTagColor = {
+    [LogLevel.fatal]: '38;5;9;1',
+    [LogLevel.error]: '38;5;9',
+    [LogLevel.warn]: '38;5;11',
+    [LogLevel.log]: '0',
+    [LogLevel.info]: '38;5;14',
+    [LogLevel.success]: '38;5;10',
+    [LogLevel.debug]: '38;5;243',
+    [LogLevel.verbose]: '38;5;234',
+};
+export const logLevelPaddingStr = {
+    [LogLevel.fatal]: 'fatal  ',
+    [LogLevel.error]: 'error  ',
+    [LogLevel.success]: 'success',
+    [LogLevel.warn]: 'warn   ',
+    [LogLevel.info]: 'info   ',
+    [LogLevel.log]: 'log    ',
+    [LogLevel.debug]: 'debug  ',
+    [LogLevel.verbose]: 'verbose',
+};
+//# sourceMappingURL=colors.js.map

package/lib/common/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/common/colors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,QAUX;AAVD,WAAY,QAAQ;IACnB,yCAAS,CAAA;IACT,yCAAS,CAAA;IACT,6CAAW,CAAA;IACX,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,qCAAO,CAAA;IACP,EAAE;IACF,yCAAS,CAAA;IACT,6CAAW,CAAA;AACZ,CAAC,EAVW,QAAQ,KAAR,QAAQ,QAUnB;AAED,MAAM,CAAC,MAAM,WAAW,GAA6B;IACpD,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU;IAC5B,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ;IAC1B,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS;IAC1B,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG;IACnB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS;IAC1B,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;IAC7B,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU;IAC5B,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU;CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IAC3D,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;IAC3B,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;IAC3B,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;IAC7B,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS;IAC1B,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS;IAC1B,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS;IACzB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;IAC3B,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;CAC7B,CAAC"}

package/lib/common/create.d.ts

@@ -0,0 +1,4 @@
+import { EnableLogLevel, type IMyLogger } from './types.js';
+export declare let all_logger_names: ReadonlySet<string>;
+export declare function create(tag: string, color_enabled: undefined | boolean, stream: NodeJS.ReadWriteStream, defaultLevel?: EnableLogLevel): IMyLogger;
+//# sourceMappingURL=create.d.ts.map

package/lib/common/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/common/create.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAA4B,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAGtF,eAAO,IAAI,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAgB,CAAC;AAEhE,wBAAgB,MAAM,CACrB,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,SAAS,GAAG,OAAO,EAClC,MAAM,EAAE,MAAM,CAAC,eAAe,EAC9B,YAAY,iBAAsB,GAChC,SAAS,CAgDX"}

package/lib/common/create.js

@@ -0,0 +1,93 @@
+import { shutdown } from '@idlebox/node';
+import { LogLevel } from './colors.js';
+import { createDebug } from './debug-fn.js';
+import { defaultLogLevel, detectColorEnable } from './helpers.js';
+import { EnableLogLevel } from './types.js';
+const seen_loggers = new Set();
+export let all_logger_names = seen_loggers;
+export function create(tag, color_enabled, stream, defaultLevel = EnableLogLevel.auto) {
+    let currentLevel = defaultLevel;
+    seen_loggers.add(tag);
+    if (color_enabled === undefined)
+        color_enabled = detectColorEnable(stream);
+    const log_fatal = createDebug({ tag, color_enabled, level: LogLevel.fatal, stream, color_entire_line: true });
+    const error = createDebug({ tag, color_enabled, level: LogLevel.error, stream });
+    const success = createDebug({ tag, color_enabled, level: LogLevel.success, stream });
+    const warn = createDebug({ tag, color_enabled, level: LogLevel.warn, stream });
+    const info = createDebug({ tag, color_enabled, level: LogLevel.info, stream });
+    const log = createDebug({ tag, color_enabled, level: LogLevel.log, stream });
+    const debug = createDebug({ tag, color_enabled, level: LogLevel.debug, stream, color_entire_line: true });
+    const verbose = createDebug({ tag, color_enabled, level: LogLevel.verbose, stream, color_entire_line: true });
+    syncEnabled({ error, warn, info, log, success, debug, verbose }, tag, currentLevel);
+    return {
+        tag,
+        stream,
+        fatal: (messages, ...args) => {
+            log_fatal(messages, ...args);
+            shutdown(1);
+        },
+        error,
+        warn,
+        info,
+        log,
+        success,
+        debug,
+        verbose,
+        colorEnabled: color_enabled,
+        enable(newMaxLevel) {
+            currentLevel = newMaxLevel;
+            syncEnabled({ error, warn, info, log, success, debug, verbose }, tag, currentLevel);
+        },
+        extend: (newTag) => {
+            if (tag) {
+                return create(`${tag}:${newTag}`, color_enabled, stream, currentLevel);
+            }
+            else {
+                return create(newTag, color_enabled, stream, currentLevel);
+            }
+        },
+    };
+}
+function syncEnabled(opt, tag, currentLevel) {
+    if (currentLevel === EnableLogLevel.auto) {
+        /**
+         * 如果自动探测，如何认定一个log启用
+         * - fatal永远启用
+         * - tag为空时，认为DEBUG中存在tag
+         * - 如果DEBUG中存在-tag:$level，则禁用 tag:$level 单个级别
+         * - 如果DEBUG中存在tag
+         *        - 如果有DEBUG_LEVEL，则启用 >=DEBUG_LEVEL 级别
+         *        - 否则启用 >log 级别
+         *    否则启用 >warn 级别
+         * - 如果DEBUG中存在tag:$level，则启用 tag:$level 单个级别
+         *
+         * TODO !!
+         */
+        +tag;
+        currentLevel = defaultLogLevel;
+    }
+    // 手动控制（root-logger默认是手动控制）
+    for (const i of [opt.error, opt.warn, opt.info, opt.log, opt.success, opt.debug, opt.verbose]) {
+        i.enable();
+    }
+    if (currentLevel < EnableLogLevel.error) {
+        opt.error.disable();
+        opt.success.disable();
+    }
+    if (currentLevel < EnableLogLevel.warn) {
+        opt.warn.disable();
+    }
+    if (currentLevel < EnableLogLevel.info) {
+        opt.info.disable();
+    }
+    if (currentLevel < EnableLogLevel.log) {
+        opt.log.disable();
+    }
+    if (currentLevel < EnableLogLevel.debug) {
+        opt.debug.disable();
+    }
+    if (currentLevel < EnableLogLevel.verbose) {
+        opt.verbose.disable();
+    }
+}
+//# sourceMappingURL=create.js.map

package/lib/common/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/common/create.ts"],"names":[],"mappings":"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"}

package/lib/common/debug-fn.d.ts

@@ -0,0 +1,13 @@
+import { LogLevel } from './colors.js';
+import type { IMyDebugWithControl } from './types.js';
+interface IDebugOptions {
+    tag: string;
+    level: LogLevel;
+    color_enabled: boolean;
+    color_entire_line?: boolean;
+    stream?: NodeJS.WritableStream;
+    enabled?: boolean;
+}
+export declare function createDebug({ tag, level, color_enabled, color_entire_line, stream, enabled, }: IDebugOptions): IMyDebugWithControl;
+export {};
+//# sourceMappingURL=debug-fn.d.ts.map

package/lib/common/debug-fn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-fn.d.ts","sourceRoot":"","sources":["../../src/common/debug-fn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmC,MAAM,aAAa,CAAC;AAExE,OAAO,KAAK,EAAY,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEhE,UAAU,aAAa;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,QAAQ,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AACD,wBAAgB,WAAW,CAAC,EAC3B,GAAG,EACH,KAAK,EACL,aAAa,EACb,iBAAyB,EACzB,MAAuB,EACvB,OAAc,GACd,EAAE,aAAa,GAAG,mBAAmB,CAmCrC"}

package/lib/common/debug-fn.js

@@ -0,0 +1,141 @@
+import { LogLevel, logLevelPaddingStr, logTagColor } from './colors.js';
+import { call_debug_command, nodeFormat } from './debug.commands.js';
+export function createDebug({ tag, level, color_enabled, color_entire_line = false, stream = process.stdout, enabled = true, }) {
+    const color = logTagColor[level];
+    const lineOpt = {
+        tag: tag ? tag : `${LogLevel[level]}`,
+        stream,
+        color,
+        level,
+    };
+    let write_line;
+    if (!color_enabled) {
+        write_line = write_line_monolithic(lineOpt);
+    }
+    else if (color_entire_line) {
+        write_line = write_line_colored_line(lineOpt);
+    }
+    else {
+        write_line = write_line_colored_tag(lineOpt);
+    }
+    const r = Object.assign((m, ...args) => {
+        if (!r.isEnabled)
+            return;
+        write_line(m, ...args);
+    }, {
+        enable: () => {
+            r.isEnabled = true;
+        },
+        disable: () => {
+            r.isEnabled = false;
+        },
+        isEnabled: enabled,
+    });
+    return r;
+}
+function format_template(messages, args, color) {
+    const result_messages = messages.slice();
+    const result_args = [];
+    for (const [index, arg] of args.entries()) {
+        const prefix = result_messages[index] || '';
+        const postfix = result_messages[index + 1] || '';
+        if (prefix.endsWith('<') && postfix.startsWith('>')) {
+            const command = prefix.slice(prefix.lastIndexOf(' ') + 1, -1);
+            const result = call_debug_command(command, arg, color);
+            result_messages[index] = prefix.slice(0, prefix.lastIndexOf(' ') + 1);
+            if (result_messages[index + 1]) {
+                result_messages[index + 1] = postfix.slice(1);
+            }
+            result_args.push(result);
+        }
+        else if (typeof arg === 'string') {
+            result_args.push(call_debug_command('stripe', arg, color));
+        }
+        else if (typeof arg === 'number' ||
+            typeof arg === 'boolean' ||
+            typeof arg === 'bigint' ||
+            typeof arg === 'symbol') {
+            result_args.push(arg.toString());
+        }
+        else if (arg === null || arg === undefined) {
+            if (color) {
+                result_args.push(`\x1B[2m${arg}\x1B[22m`);
+            }
+            else {
+                result_args.push(String(arg));
+            }
+        }
+        else {
+            result_args.push(call_debug_command('inspect', arg, color));
+        }
+    }
+    let ret = '';
+    while (result_messages.length || result_args.length) {
+        const message = result_messages.shift();
+        if (message)
+            ret += message;
+        const arg = result_args.shift();
+        if (arg)
+            ret += arg;
+    }
+    return ret;
+}
+/**
+ * TAG带颜色
+ */
+function write_line_colored_tag({ tag, stream, color }) {
+    return (messages, ...args) => {
+        const head = `[\x1b[${color}m${tag}\x1b[0m]`;
+        let body;
+        if (typeof messages === 'string') {
+            body = nodeFormat(messages, args, true);
+        }
+        else {
+            body = format_template(messages, args, true);
+        }
+        write(stream, head, body);
+    };
+}
+/**
+ * 整行带颜色
+ */
+function write_line_colored_line({ tag, stream, color }) {
+    return (messages, ...args) => {
+        const head = `\x1B[${color}m[${tag}]`;
+        let body;
+        if (typeof messages === 'string') {
+            body = nodeFormat(messages, args, false);
+        }
+        else {
+            body = format_template(messages, args, false);
+        }
+        body += '\x1B[0m';
+        write(stream, head, body);
+    };
+}
+/**
+ * 不带颜色
+ */
+function write_line_monolithic({ tag, level, stream }) {
+    const lvlStr = logLevelPaddingStr[level];
+    return (messages, ...args) => {
+        const head = `[${tag}:${lvlStr}]`;
+        let body;
+        if (typeof messages === 'string') {
+            body = nodeFormat(messages, args, false);
+        }
+        else {
+            body = format_template(messages, args, false);
+        }
+        write(stream, head, body);
+    };
+}
+function write(stream, head, body) {
+    if (body[0] === '[') {
+        stream.write(`${head}${body}\n`);
+    }
+    else {
+        stream.write(`${head} ${body}\n`);
+    }
+}
+//# sourceMappingURL=debug-fn.js.map

package/lib/common/debug-fn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-fn.js","sourceRoot":"","sources":["../../src/common/debug-fn.ts"],"names":[],"mappings":"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"}

package/lib/common/debug.commands.d.ts

@@ -0,0 +1,13 @@
+export declare function nodeFormat(message: string, object: readonly unknown[], color: boolean): string;
+export declare function nodeInspect(object: unknown, color: boolean): string;
+declare const debug_commands: {
+    inspect(object: unknown, color: boolean): string;
+    stripe(s: unknown, color: boolean): string;
+    list(items: unknown, color: boolean): string;
+    commandline(cmds: unknown, color: boolean): string;
+    long(s: unknown, color: boolean): unknown;
+    relative(s: unknown, color: boolean): string;
+};
+export declare function call_debug_command(command: keyof typeof debug_commands | string, arg: unknown, color: boolean): string;
+export {};
+//# sourceMappingURL=debug.commands.d.ts.map

package/lib/common/debug.commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.commands.d.ts","sourceRoot":"","sources":["../../src/common/debug.commands.ts"],"names":[],"mappings":"AAuBA,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAE9F;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnE;AAMD,QAAA,MAAM,cAAc;oBACH,OAAO,SAAS,OAAO;cAG7B,OAAO,SAAS,OAAO;gBAcrB,OAAO,SAAS,OAAO;sBAgCjB,OAAO,SAAS,OAAO;YAajC,OAAO,SAAS,OAAO;gBAcnB,OAAO,SAAS,OAAO;CAMnC,CAAC;AAGF,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,MAAM,OAAO,cAAc,GAAG,MAAM,EAC7C,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,OAAO,GACZ,MAAM,CAMR"}

package/lib/common/debug.commands.js

@@ -0,0 +1,129 @@
+import { relative } from 'node:path';
+import { formatWithOptions, inspect } from 'node:util';
+const STRING_MAX_LENGTH = 128;
+function color_error(message, color) {
+    if (color) {
+        return `\x1B[38;5;9m<inspect**${message}**>\x1B[39m`;
+    }
+    else {
+        return `<inspect**${message}**>`;
+    }
+}
+function options(color) {
+    return {
+        depth: 5,
+        compact: true,
+        colors: color,
+        maxArrayLength: 3,
+        maxStringLength: STRING_MAX_LENGTH,
+    };
+}
+export function nodeFormat(message, object, color) {
+    return formatWithOptions(options(color), message, ...object);
+}
+export function nodeInspect(object, color) {
+    return inspect(object, options(color));
+}
+function isSyncIterable(obj) {
+    return typeof obj === 'object' && obj !== null && Symbol.iterator in obj;
+}
+const debug_commands = {
+    inspect(object, color) {
+        return inspect(object, options(color));
+    },
+    stripe(s, color) {
+        if (typeof s !== 'string') {
+            return color_error(`can not stripe ${typeof s}`, color);
+        }
+        if (s.length > 100) {
+            if (color) {
+                return `\x1B[38;5;10m"${s.slice(0, STRING_MAX_LENGTH - 3)}..."\x1B[39m`;
+            }
+            else {
+                return `"${s.slice(0, STRING_MAX_LENGTH - 3)}..."`;
+            }
+        }
+        else {
+            return s;
+        }
+    },
+    list(items, color) {
+        if (!isSyncIterable(items)) {
+            return color_error(`list<> need iterable value, not ${typeof items}(${items?.constructor?.name})`, color);
+        }
+        const postfix = color ? '\x1B[0m' : '';
+        let index = 0;
+        const lines = [];
+        const prefix = color ? '\x1B[2m' : '';
+        for (const item of items) {
+            if (Array.isArray(item)) {
+                if (item.length === 2) {
+                    const [key, value] = item;
+                    if (typeof key === 'number') {
+                        lines.push(`  - ${prefix}${item}${postfix}`);
+                    }
+                    else {
+                        lines.push(`  * ${prefix}${key}: ${value.toString()}${postfix}`);
+                    }
+                }
+                else {
+                    return color_error(`list<> item ${index} is array with length ${item.length}, expected 2`, color);
+                }
+            }
+            else {
+                lines.push(`  - ${prefix}${item}${postfix}`);
+            }
+            index++;
+        }
+        if (lines.length === 0) {
+            const prefix = color ? '\x1B[3;2m' : '';
+            return ':\n' + prefix + '  - <list is empty>' + postfix;
+        }
+        return ':\n' + lines.join('\n');
+    },
+    commandline(cmds, color) {
+        if (Array.isArray(cmds)) {
+            const prefix = color ? '\x1B[2m' : '';
+            const postfix = color ? '\x1B[0m' : '';
+            return prefix + cmds.map((s) => JSON.stringify(s)).join(' ') + postfix;
+        }
+        else if (typeof cmds === 'string') {
+            const prefix = color ? '\x1B[2;3m' : '';
+            const postfix = color ? '\x1B[0m' : '';
+            return prefix + cmds + postfix;
+        }
+        else {
+            return color_error(`commandline<> need string or array, not ${typeof cmds}`, color);
+        }
+    },
+    long(s, color) {
+        if (typeof s !== 'string') {
+            if (Array.isArray(s)) {
+                s = `[${s.join(', ')}]`;
+            }
+            else {
+                return color_error(`long<> need string, not ${typeof s}(${s?.constructor?.name})`, color);
+            }
+        }
+        if (color) {
+            return `\x1B[3m${s}\x1B[23m`;
+        }
+        else {
+            return s;
+        }
+    },
+    relative(s, color) {
+        if (typeof s !== 'string') {
+            return color_error(`relative<> need string, not ${typeof s}(${s?.constructor?.name})`, color);
+        }
+        return relative(process.cwd(), s);
+    },
+};
+export function call_debug_command(command, arg, color) {
+    const fn = debug_commands[command];
+    if (!fn) {
+        return color_error(`unknown command ${command}`, color);
+    }
+    return fn(arg, color);
+}
+//# sourceMappingURL=debug.commands.js.map

package/lib/common/debug.commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.commands.js","sourceRoot":"","sources":["../../src/common/debug.commands.ts"],"names":[],"mappings":"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"}

package/lib/common/helpers.d.ts

@@ -0,0 +1,56 @@
+import { EnableLogLevel } from './types.js';
+/**
+ * 判断 字符串是否为“真值”
+ *  * 1 / 0
+ *  * true / false
+ *  * on / off
+ *  * yes / no
+ *  * enabled / disabled
+ *
+ * 其他内容会导致一个警告，并返回 false
+ */
+export declare function is_string_truthy(value: string | undefined): boolean;
+interface IWritableStream extends NodeJS.WritableStream {
+    colorEnabled?: boolean;
+    isTTY?: boolean;
+}
+export declare function detectColorEnable(stream?: IWritableStream): boolean;
+export declare function escapeRegExp(str: string): string;
+/**
+ *
+ * @param tag tag to match, e.g. "app:db:insert"
+ * @returns a RegExp, eg. /(^|\s)(\\*|app:\\*|app:db:\\*|app:db:insert)($|\s)/
+ */
+export declare function compile_match_regex(tag: string, invert?: boolean): RegExp;
+/**
+ * 从字符串中匹配指定的tag是否启用，不完全模拟 debug 模块的功能，不处理反义匹配（需用match_disabled）
+ * @param tag 类似 "app:db:insert" 的tag
+ * @param env 环境变量内容，默认 process.env.DEBUG
+ * @returns 冒号数量
+ */
+export declare function match_enabled(tag: string, env?: string): number;
+/**
+ * 从字符串中匹配指定的tag是否禁用，不完全模拟 debug 模块的功能，tag前面不要加-
+ * @param tag 类似 "app:db:insert" 的tag
+ * @param env 环境变量内容，默认 process.env.DEBUG
+ * @returns 冒号数量 - 1
+ */
+export declare function match_disabled(tag: string, env?: string): number;
+/**
+ * 调用debug模块的debug.enabled方法
+ */
+export declare function debug_enabled(tag: string): boolean;
+/**
+ * 当指定tag开启时，应该输出它的什么级别
+ * tag关闭时始终默认error
+ *
+ * 只有新创建的受此影响，且不影响root-logger，也不影响.extend
+ */
+export declare let defaultLogLevel: EnableLogLevel;
+/**
+ * 手动设置默认日志级别
+ * root-logger 和 已经创建的 不受此影响
+ */
+export declare function set_default_log_level(level: EnableLogLevel): void;
+export {};
+//# sourceMappingURL=helpers.d.ts.map

package/lib/common/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/common/helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,WAYzD;AAED,UAAU,eAAgB,SAAQ,MAAM,CAAC,cAAc;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AA+BD,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,eAAgC,GAAG,OAAO,CAKnF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,UAEvC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,CAavE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAA0B,GAAG,MAAM,CAKhF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAA0B,GAAG,MAAM,CAKjF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,WAExC;AAED;;;;;GAKG;AACH,eAAO,IAAI,eAAe,gBA0CtB,CAAC;AAEL;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,QAE1D"}