@nmakarov/cli-toolkit 0.1.1 → 0.1.2

package/dist/logger.cjs

@@ -0,0 +1,271 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/logger/index.ts
+var logger_exports = {};
+__export(logger_exports, {
+  CliToolkitLogger: () => CliToolkitLogger
+});
+module.exports = __toCommonJS(logger_exports);
+var import_chalk = __toESM(require("chalk"), 1);
+var import_util = __toESM(require("util"), 1);
+
+// src/logger/transports.ts
+var ConsoleTransport = class {
+  write(payload) {
+    console.info(payload);
+  }
+};
+var ParentProcessTransport = class {
+  write(payload) {
+    if (typeof process.send === "function") {
+      process.send(payload);
+    } else {
+      console.info(payload);
+    }
+  }
+};
+
+// src/logger/index.ts
+var ALL_LEVELS = [
+  "silly",
+  "debug",
+  "logic",
+  "info",
+  "notice",
+  "warn",
+  "error",
+  "results",
+  "request",
+  "response",
+  "progress"
+];
+var LEVEL_COLORS = {
+  error: import_chalk.default.red.bold,
+  warn: import_chalk.default.rgb(255, 165, 0),
+  notice: import_chalk.default.cyan,
+  info: import_chalk.default.white.bold,
+  logic: import_chalk.default.gray,
+  debug: import_chalk.default.gray,
+  silly: import_chalk.default.gray,
+  request: import_chalk.default.green,
+  response: import_chalk.default.yellow,
+  progress: import_chalk.default.green,
+  results: import_chalk.default.magenta
+};
+var CliToolkitLogger = class {
+  options;
+  transport;
+  startTimes = {};
+  lastProgressTimes = {};
+  constructor(options = {}) {
+    this.options = this.normalizeOptions(options);
+    this.transport = this.options.route === "ipc" ? new ParentProcessTransport() : new ConsoleTransport();
+  }
+  setMode(mode) {
+    if (!this.isValidMode(mode)) {
+      throw new Error(`Unsupported logger mode: ${mode}`);
+    }
+    this.options.mode = mode;
+  }
+  debug(message, ...chunks) {
+    this.out({ level: "debug", message, chunks });
+  }
+  info(message, ...chunks) {
+    this.out({ level: "info", message, chunks });
+  }
+  notice(message, ...chunks) {
+    this.out({ level: "notice", message, chunks });
+  }
+  warn(message, ...chunks) {
+    this.out({ level: "warn", message, chunks });
+  }
+  error(message, ...chunks) {
+    this.out({ level: "error", message, chunks });
+  }
+  logic(message, ...chunks) {
+    this.out({ level: "logic", message, chunks });
+  }
+  silly(message, ...chunks) {
+    this.out({ level: "silly", message, chunks });
+  }
+  results(results) {
+    this.out({ level: "results", message: "results", results });
+  }
+  request(operation, ...chunks) {
+    const message = this.inspectChunks([operation, ...chunks]);
+    this.out({ level: "request", message });
+  }
+  response(operation, ...chunks) {
+    const message = this.inspectChunks([operation, ...chunks]);
+    this.out({ level: "response", message });
+  }
+  progress(message, opts) {
+    const { prefix, count, total } = opts;
+    const paddedTotal = String(total).length;
+    const paddedCount = String(count).padStart(paddedTotal, " ");
+    const payload = {
+      level: "progress",
+      message,
+      count: paddedCount,
+      total,
+      prefix
+    };
+    if (!this.startTimes[prefix ?? ""]) {
+      this.startTimes[prefix ?? ""] = Date.now();
+    }
+    if (this.options.progressTimes) {
+      const elapsedSeconds = (Date.now() - this.startTimes[prefix ?? ""]) / 1e3;
+      let remaining = -1;
+      if (count > 1) {
+        const rate = elapsedSeconds / (count - 1);
+        remaining = (total - count) * rate;
+      }
+      payload.elapsed = this.round(elapsedSeconds, 2);
+      payload.remaining = remaining >= 0 ? this.round(remaining, 2) : remaining;
+    }
+    if (count >= total) {
+      delete this.startTimes[prefix ?? ""];
+      delete this.lastProgressTimes[prefix ?? ""];
+    }
+    if (this.shouldOutputProgress(prefix ?? "", count, total)) {
+      this.out(payload);
+      if (this.options.progressThrottle && prefix) {
+        this.lastProgressTimes[prefix] = Date.now();
+      }
+    }
+  }
+  shouldOutputProgress(prefix, count, total) {
+    if (!this.options.progressThrottle) {
+      return true;
+    }
+    if (count === 1 || count === total || !prefix) {
+      return true;
+    }
+    const lastTime = this.lastProgressTimes[prefix];
+    if (!lastTime) {
+      return true;
+    }
+    return Date.now() - lastTime >= this.options.progressThrottle;
+  }
+  out(struct) {
+    if (this.options.silent) {
+      return;
+    }
+    if (!this.options.levels.includes(struct.level)) {
+      return;
+    }
+    if (this.options.prefix && !struct.prefix) {
+      struct.prefix = this.options.prefix;
+    }
+    const output = this.options.mode === "json" ? struct : this.formatLog(struct);
+    this.transport.write(output);
+  }
+  formatLog(struct) {
+    const parts = [];
+    const now = /* @__PURE__ */ new Date();
+    if (this.options.timestamp) {
+      parts.push(now.toISOString());
+    }
+    if (this.options.showLevel) {
+      parts.push(struct.level.toUpperCase());
+    }
+    if (struct.level === "progress") {
+      if (struct.prefix) {
+        parts.push(LEVEL_COLORS[struct.level].bold(struct.prefix));
+      }
+      if (struct.count !== void 0 && struct.total !== void 0) {
+        parts.push(LEVEL_COLORS[struct.level](`${struct.count}/${struct.total}`));
+      }
+    } else if (struct.prefix) {
+      parts.push(import_chalk.default.cyan(`[${struct.prefix}]`));
+    }
+    if (struct.message) {
+      const formatter = LEVEL_COLORS[struct.level] ?? import_chalk.default.white;
+      parts.push(formatter.bold(struct.message));
+    }
+    if (struct.level === "progress") {
+      if (struct.elapsed !== void 0 && struct.remaining !== void 0) {
+        const formatter = LEVEL_COLORS[struct.level];
+        parts.push(formatter(`${struct.elapsed}/${struct.remaining}`));
+      }
+    }
+    if (struct.chunks && struct.chunks.length) {
+      parts.push(this.inspectChunks(struct.chunks));
+    }
+    if (struct.results) {
+      const formatter = LEVEL_COLORS[struct.level] ?? import_chalk.default.white;
+      parts.push(formatter(JSON.stringify(struct.results, null, 4)));
+    }
+    return parts.join(" ");
+  }
+  inspectChunks(chunks) {
+    return chunks.map((chunk) => import_util.default.inspect(chunk, { colors: true, depth: null })).join(" ");
+  }
+  normalizeOptions(options) {
+    const { route, mode, prefix, silent, showLevel, timestamp, levels, progress } = options;
+    const normalized = {
+      mode: this.isValidMode(mode) ? mode : "text",
+      route: route ?? (typeof process.send === "function" ? "ipc" : "console"),
+      prefix,
+      silent: silent ?? false,
+      showLevel: showLevel ?? true,
+      timestamp: timestamp ?? false,
+      levels: this.normalizeLevels(levels),
+      progressTimes: progress?.withTimes ?? false,
+      progressThrottle: progress?.throttleMs
+    };
+    return normalized;
+  }
+  normalizeLevels(levels) {
+    if (!levels || !levels.length) {
+      return ALL_LEVELS;
+    }
+    const includes = levels.filter((level) => !level.startsWith("-"));
+    const excludes = levels.filter((level) => level.startsWith("-")).map((level) => level.slice(1));
+    const unknown = [...includes, ...excludes].filter((level) => !ALL_LEVELS.includes(level));
+    if (unknown.length) {
+      console.warn(`[Logger] Unknown level(s): ${unknown.join(", ")}`);
+    }
+    const base = includes.length ? includes : ALL_LEVELS;
+    return base.filter((level) => !excludes.includes(level));
+  }
+  isValidMode(mode) {
+    return mode === void 0 || mode === null || mode === "text" || mode === "json";
+  }
+  round(value, places) {
+    const factor = Math.pow(10, places);
+    return Math.round(value * factor) / factor;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CliToolkitLogger
+});
+//# sourceMappingURL=logger.cjs.map

package/dist/logger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logger/index.ts","../src/logger/transports.ts"],"sourcesContent":["import chalk from \"chalk\";\nimport util from \"util\";\n\nimport {\n    Logger,\n    LoggerOptions,\n    LoggerProgressOptions,\n    LogPayload,\n    LevelName,\n    LoggerTransport,\n    LoggerMode\n} from \"./types.js\";\nimport { ConsoleTransport, ParentProcessTransport } from \"./transports.js\";\n\nconst ALL_LEVELS: LevelName[] = [\n    \"silly\",\n    \"debug\",\n    \"logic\",\n    \"info\",\n    \"notice\",\n    \"warn\",\n    \"error\",\n    \"results\",\n    \"request\",\n    \"response\",\n    \"progress\"\n];\n\nconst LEVEL_COLORS: Record<LevelName, chalk.Chalk> = {\n    error: chalk.red.bold,\n    warn: chalk.rgb(255, 165, 0),\n    notice: chalk.cyan,\n    info: chalk.white.bold,\n    logic: chalk.gray,\n    debug: chalk.gray,\n    silly: chalk.gray,\n    request: chalk.green,\n    response: chalk.yellow,\n    progress: chalk.green,\n    results: chalk.magenta\n};\n\ninterface NormalizedOptions {\n    mode: LoggerMode;\n    route: \"console\" | \"ipc\";\n    prefix?: string;\n    silent: boolean;\n    showLevel: boolean;\n    timestamp: boolean;\n    levels: LevelName[];\n    progressTimes: boolean;\n    progressThrottle?: number;\n}\n\nexport class CliToolkitLogger implements Logger {\n    private readonly options: NormalizedOptions;\n    private transport: LoggerTransport;\n    private readonly startTimes: Record<string, number> = {};\n    private readonly lastProgressTimes: Record<string, number> = {};\n\n    constructor(options: LoggerOptions = {}) {\n        this.options = this.normalizeOptions(options);\n        this.transport = this.options.route === \"ipc\"\n            ? new ParentProcessTransport()\n            : new ConsoleTransport();\n    }\n\n    setMode(mode: LoggerMode): void {\n        if (!this.isValidMode(mode)) {\n            throw new Error(`Unsupported logger mode: ${mode}`);\n        }\n        this.options.mode = mode;\n    }\n\n    debug(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"debug\", message, chunks });\n    }\n\n    info(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"info\", message, chunks });\n    }\n\n    notice(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"notice\", message, chunks });\n    }\n\n    warn(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"warn\", message, chunks });\n    }\n\n    error(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"error\", message, chunks });\n    }\n\n    logic(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"logic\", message, chunks });\n    }\n\n    silly(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"silly\", message, chunks });\n    }\n\n    results(results: unknown): void {\n        this.out({ level: \"results\", message: \"results\", results });\n    }\n\n    request(operation: string, ...chunks: any[]): void {\n        const message = this.inspectChunks([operation, ...chunks]);\n        this.out({ level: \"request\", message });\n    }\n\n    response(operation: string, ...chunks: any[]): void {\n        const message = this.inspectChunks([operation, ...chunks]);\n        this.out({ level: \"response\", message });\n    }\n\n    progress(message: string, opts: LoggerProgressOptions): void {\n        const { prefix, count, total } = opts;\n        const paddedTotal = String(total).length;\n        const paddedCount = String(count).padStart(paddedTotal, \" \");\n        const payload: LogPayload = {\n            level: \"progress\",\n            message,\n            count: paddedCount,\n            total,\n            prefix\n        };\n\n        if (!this.startTimes[prefix ?? \"\"]) {\n            this.startTimes[prefix ?? \"\"] = Date.now();\n        }\n        if (this.options.progressTimes) {\n            const elapsedSeconds = (Date.now() - this.startTimes[prefix ?? \"\"]) / 1000;\n            let remaining = -1;\n            if (count > 1) {\n                const rate = elapsedSeconds / (count - 1);\n                remaining = (total - count) * rate;\n            }\n            payload.elapsed = this.round(elapsedSeconds, 2);\n            payload.remaining = remaining >= 0 ? this.round(remaining, 2) : remaining;\n        }\n\n        if (count >= total) {\n            delete this.startTimes[prefix ?? \"\"];\n            delete this.lastProgressTimes[prefix ?? \"\"];\n        }\n\n        if (this.shouldOutputProgress(prefix ?? \"\", count, total)) {\n            this.out(payload);\n            if (this.options.progressThrottle && prefix) {\n                this.lastProgressTimes[prefix] = Date.now();\n            }\n        }\n    }\n\n    private shouldOutputProgress(prefix: string, count: number, total: number): boolean {\n        if (!this.options.progressThrottle) {\n            return true;\n        }\n        if (count === 1 || count === total || !prefix) {\n            return true;\n        }\n        const lastTime = this.lastProgressTimes[prefix];\n        if (!lastTime) {\n            return true;\n        }\n        return Date.now() - lastTime >= this.options.progressThrottle;\n    }\n\n    private out(struct: LogPayload): void {\n        if (this.options.silent) {\n            return;\n        }\n        if (!this.options.levels.includes(struct.level)) {\n            return;\n        }\n\n        if (this.options.prefix && !struct.prefix) {\n            struct.prefix = this.options.prefix;\n        }\n\n        const output = this.options.mode === \"json\"\n            ? struct\n            : this.formatLog(struct);\n\n        this.transport.write(output);\n    }\n\n    private formatLog(struct: LogPayload): string {\n        const parts: string[] = [];\n        const now = new Date();\n\n        if (this.options.timestamp) {\n            parts.push(now.toISOString());\n        }\n\n        if (this.options.showLevel) {\n            parts.push(struct.level.toUpperCase());\n        }\n\n        if (struct.level === \"progress\") {\n            if (struct.prefix) {\n                parts.push(LEVEL_COLORS[struct.level].bold(struct.prefix));\n            }\n            if (struct.count !== undefined && struct.total !== undefined) {\n                parts.push(LEVEL_COLORS[struct.level](`${struct.count}/${struct.total}`));\n            }\n        } else if (struct.prefix) {\n            parts.push(chalk.cyan(`[${struct.prefix}]`));\n        }\n\n        if (struct.message) {\n            const formatter = LEVEL_COLORS[struct.level] ?? chalk.white;\n            parts.push(formatter.bold(struct.message));\n        }\n\n        if (struct.level === \"progress\") {\n            if (struct.elapsed !== undefined && struct.remaining !== undefined) {\n                const formatter = LEVEL_COLORS[struct.level];\n                parts.push(formatter(`${struct.elapsed}/${struct.remaining}`));\n            }\n        }\n\n        if (struct.chunks && struct.chunks.length) {\n            parts.push(this.inspectChunks(struct.chunks));\n        }\n\n        if (struct.results) {\n            const formatter = LEVEL_COLORS[struct.level] ?? chalk.white;\n            parts.push(formatter(JSON.stringify(struct.results, null, 4)));\n        }\n\n        return parts.join(\" \");\n    }\n\n    private inspectChunks(chunks: any[]): string {\n        return chunks\n            .map(chunk => util.inspect(chunk, { colors: true, depth: null }))\n            .join(\" \");\n    }\n\n    private normalizeOptions(options: LoggerOptions): NormalizedOptions {\n        const { route, mode, prefix, silent, showLevel, timestamp, levels, progress } = options;\n        const normalized: NormalizedOptions = {\n            mode: this.isValidMode(mode) ? mode! : \"text\",\n            route: route ?? (typeof process.send === \"function\" ? \"ipc\" : \"console\"),\n            prefix,\n            silent: silent ?? false,\n            showLevel: showLevel ?? true,\n            timestamp: timestamp ?? false,\n            levels: this.normalizeLevels(levels),\n            progressTimes: progress?.withTimes ?? false,\n            progressThrottle: progress?.throttleMs\n        };\n        return normalized;\n    }\n\n    private normalizeLevels(levels?: string[]): LevelName[] {\n        if (!levels || !levels.length) {\n            return ALL_LEVELS;\n        }\n\n        const includes = levels.filter(level => !level.startsWith(\"-\")) as LevelName[];\n        const excludes = levels\n            .filter(level => level.startsWith(\"-\"))\n            .map(level => level.slice(1)) as LevelName[];\n\n        const unknown = [...includes, ...excludes].filter(level => !ALL_LEVELS.includes(level));\n        if (unknown.length) {\n            console.warn(`[Logger] Unknown level(s): ${unknown.join(\", \")}`);\n        }\n\n        const base = includes.length ? includes : ALL_LEVELS;\n        return base.filter(level => !excludes.includes(level));\n    }\n\n    private isValidMode(mode?: string | null): mode is LoggerMode | undefined {\n        return mode === undefined || mode === null || mode === \"text\" || mode === \"json\";\n    }\n\n    private round(value: number, places: number): number {\n        const factor = Math.pow(10, places);\n        return Math.round(value * factor) / factor;\n    }\n}\n\n\n","import { LoggerTransport } from \"./types.js\";\n\nexport class ConsoleTransport implements LoggerTransport {\n    write(payload: any): void {\n        console.info(payload);\n    }\n}\n\nexport class ParentProcessTransport implements LoggerTransport {\n    write(payload: any): void {\n        if (typeof process.send === \"function\") {\n            process.send(payload);\n        } else {\n            console.info(payload);\n        }\n    }\n}\n\n\n"],"mappings":"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","names":["chalk","util"]}

package/dist/logger.js

@@ -0,0 +1,236 @@
+// src/logger/index.ts
+import chalk from "chalk";
+import util from "util";
+
+// src/logger/transports.ts
+var ConsoleTransport = class {
+  write(payload) {
+    console.info(payload);
+  }
+};
+var ParentProcessTransport = class {
+  write(payload) {
+    if (typeof process.send === "function") {
+      process.send(payload);
+    } else {
+      console.info(payload);
+    }
+  }
+};
+
+// src/logger/index.ts
+var ALL_LEVELS = [
+  "silly",
+  "debug",
+  "logic",
+  "info",
+  "notice",
+  "warn",
+  "error",
+  "results",
+  "request",
+  "response",
+  "progress"
+];
+var LEVEL_COLORS = {
+  error: chalk.red.bold,
+  warn: chalk.rgb(255, 165, 0),
+  notice: chalk.cyan,
+  info: chalk.white.bold,
+  logic: chalk.gray,
+  debug: chalk.gray,
+  silly: chalk.gray,
+  request: chalk.green,
+  response: chalk.yellow,
+  progress: chalk.green,
+  results: chalk.magenta
+};
+var CliToolkitLogger = class {
+  options;
+  transport;
+  startTimes = {};
+  lastProgressTimes = {};
+  constructor(options = {}) {
+    this.options = this.normalizeOptions(options);
+    this.transport = this.options.route === "ipc" ? new ParentProcessTransport() : new ConsoleTransport();
+  }
+  setMode(mode) {
+    if (!this.isValidMode(mode)) {
+      throw new Error(`Unsupported logger mode: ${mode}`);
+    }
+    this.options.mode = mode;
+  }
+  debug(message, ...chunks) {
+    this.out({ level: "debug", message, chunks });
+  }
+  info(message, ...chunks) {
+    this.out({ level: "info", message, chunks });
+  }
+  notice(message, ...chunks) {
+    this.out({ level: "notice", message, chunks });
+  }
+  warn(message, ...chunks) {
+    this.out({ level: "warn", message, chunks });
+  }
+  error(message, ...chunks) {
+    this.out({ level: "error", message, chunks });
+  }
+  logic(message, ...chunks) {
+    this.out({ level: "logic", message, chunks });
+  }
+  silly(message, ...chunks) {
+    this.out({ level: "silly", message, chunks });
+  }
+  results(results) {
+    this.out({ level: "results", message: "results", results });
+  }
+  request(operation, ...chunks) {
+    const message = this.inspectChunks([operation, ...chunks]);
+    this.out({ level: "request", message });
+  }
+  response(operation, ...chunks) {
+    const message = this.inspectChunks([operation, ...chunks]);
+    this.out({ level: "response", message });
+  }
+  progress(message, opts) {
+    const { prefix, count, total } = opts;
+    const paddedTotal = String(total).length;
+    const paddedCount = String(count).padStart(paddedTotal, " ");
+    const payload = {
+      level: "progress",
+      message,
+      count: paddedCount,
+      total,
+      prefix
+    };
+    if (!this.startTimes[prefix ?? ""]) {
+      this.startTimes[prefix ?? ""] = Date.now();
+    }
+    if (this.options.progressTimes) {
+      const elapsedSeconds = (Date.now() - this.startTimes[prefix ?? ""]) / 1e3;
+      let remaining = -1;
+      if (count > 1) {
+        const rate = elapsedSeconds / (count - 1);
+        remaining = (total - count) * rate;
+      }
+      payload.elapsed = this.round(elapsedSeconds, 2);
+      payload.remaining = remaining >= 0 ? this.round(remaining, 2) : remaining;
+    }
+    if (count >= total) {
+      delete this.startTimes[prefix ?? ""];
+      delete this.lastProgressTimes[prefix ?? ""];
+    }
+    if (this.shouldOutputProgress(prefix ?? "", count, total)) {
+      this.out(payload);
+      if (this.options.progressThrottle && prefix) {
+        this.lastProgressTimes[prefix] = Date.now();
+      }
+    }
+  }
+  shouldOutputProgress(prefix, count, total) {
+    if (!this.options.progressThrottle) {
+      return true;
+    }
+    if (count === 1 || count === total || !prefix) {
+      return true;
+    }
+    const lastTime = this.lastProgressTimes[prefix];
+    if (!lastTime) {
+      return true;
+    }
+    return Date.now() - lastTime >= this.options.progressThrottle;
+  }
+  out(struct) {
+    if (this.options.silent) {
+      return;
+    }
+    if (!this.options.levels.includes(struct.level)) {
+      return;
+    }
+    if (this.options.prefix && !struct.prefix) {
+      struct.prefix = this.options.prefix;
+    }
+    const output = this.options.mode === "json" ? struct : this.formatLog(struct);
+    this.transport.write(output);
+  }
+  formatLog(struct) {
+    const parts = [];
+    const now = /* @__PURE__ */ new Date();
+    if (this.options.timestamp) {
+      parts.push(now.toISOString());
+    }
+    if (this.options.showLevel) {
+      parts.push(struct.level.toUpperCase());
+    }
+    if (struct.level === "progress") {
+      if (struct.prefix) {
+        parts.push(LEVEL_COLORS[struct.level].bold(struct.prefix));
+      }
+      if (struct.count !== void 0 && struct.total !== void 0) {
+        parts.push(LEVEL_COLORS[struct.level](`${struct.count}/${struct.total}`));
+      }
+    } else if (struct.prefix) {
+      parts.push(chalk.cyan(`[${struct.prefix}]`));
+    }
+    if (struct.message) {
+      const formatter = LEVEL_COLORS[struct.level] ?? chalk.white;
+      parts.push(formatter.bold(struct.message));
+    }
+    if (struct.level === "progress") {
+      if (struct.elapsed !== void 0 && struct.remaining !== void 0) {
+        const formatter = LEVEL_COLORS[struct.level];
+        parts.push(formatter(`${struct.elapsed}/${struct.remaining}`));
+      }
+    }
+    if (struct.chunks && struct.chunks.length) {
+      parts.push(this.inspectChunks(struct.chunks));
+    }
+    if (struct.results) {
+      const formatter = LEVEL_COLORS[struct.level] ?? chalk.white;
+      parts.push(formatter(JSON.stringify(struct.results, null, 4)));
+    }
+    return parts.join(" ");
+  }
+  inspectChunks(chunks) {
+    return chunks.map((chunk) => util.inspect(chunk, { colors: true, depth: null })).join(" ");
+  }
+  normalizeOptions(options) {
+    const { route, mode, prefix, silent, showLevel, timestamp, levels, progress } = options;
+    const normalized = {
+      mode: this.isValidMode(mode) ? mode : "text",
+      route: route ?? (typeof process.send === "function" ? "ipc" : "console"),
+      prefix,
+      silent: silent ?? false,
+      showLevel: showLevel ?? true,
+      timestamp: timestamp ?? false,
+      levels: this.normalizeLevels(levels),
+      progressTimes: progress?.withTimes ?? false,
+      progressThrottle: progress?.throttleMs
+    };
+    return normalized;
+  }
+  normalizeLevels(levels) {
+    if (!levels || !levels.length) {
+      return ALL_LEVELS;
+    }
+    const includes = levels.filter((level) => !level.startsWith("-"));
+    const excludes = levels.filter((level) => level.startsWith("-")).map((level) => level.slice(1));
+    const unknown = [...includes, ...excludes].filter((level) => !ALL_LEVELS.includes(level));
+    if (unknown.length) {
+      console.warn(`[Logger] Unknown level(s): ${unknown.join(", ")}`);
+    }
+    const base = includes.length ? includes : ALL_LEVELS;
+    return base.filter((level) => !excludes.includes(level));
+  }
+  isValidMode(mode) {
+    return mode === void 0 || mode === null || mode === "text" || mode === "json";
+  }
+  round(value, places) {
+    const factor = Math.pow(10, places);
+    return Math.round(value * factor) / factor;
+  }
+};
+export {
+  CliToolkitLogger
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logger/index.ts","../src/logger/transports.ts"],"sourcesContent":["import chalk from \"chalk\";\nimport util from \"util\";\n\nimport {\n    Logger,\n    LoggerOptions,\n    LoggerProgressOptions,\n    LogPayload,\n    LevelName,\n    LoggerTransport,\n    LoggerMode\n} from \"./types.js\";\nimport { ConsoleTransport, ParentProcessTransport } from \"./transports.js\";\n\nconst ALL_LEVELS: LevelName[] = [\n    \"silly\",\n    \"debug\",\n    \"logic\",\n    \"info\",\n    \"notice\",\n    \"warn\",\n    \"error\",\n    \"results\",\n    \"request\",\n    \"response\",\n    \"progress\"\n];\n\nconst LEVEL_COLORS: Record<LevelName, chalk.Chalk> = {\n    error: chalk.red.bold,\n    warn: chalk.rgb(255, 165, 0),\n    notice: chalk.cyan,\n    info: chalk.white.bold,\n    logic: chalk.gray,\n    debug: chalk.gray,\n    silly: chalk.gray,\n    request: chalk.green,\n    response: chalk.yellow,\n    progress: chalk.green,\n    results: chalk.magenta\n};\n\ninterface NormalizedOptions {\n    mode: LoggerMode;\n    route: \"console\" | \"ipc\";\n    prefix?: string;\n    silent: boolean;\n    showLevel: boolean;\n    timestamp: boolean;\n    levels: LevelName[];\n    progressTimes: boolean;\n    progressThrottle?: number;\n}\n\nexport class CliToolkitLogger implements Logger {\n    private readonly options: NormalizedOptions;\n    private transport: LoggerTransport;\n    private readonly startTimes: Record<string, number> = {};\n    private readonly lastProgressTimes: Record<string, number> = {};\n\n    constructor(options: LoggerOptions = {}) {\n        this.options = this.normalizeOptions(options);\n        this.transport = this.options.route === \"ipc\"\n            ? new ParentProcessTransport()\n            : new ConsoleTransport();\n    }\n\n    setMode(mode: LoggerMode): void {\n        if (!this.isValidMode(mode)) {\n            throw new Error(`Unsupported logger mode: ${mode}`);\n        }\n        this.options.mode = mode;\n    }\n\n    debug(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"debug\", message, chunks });\n    }\n\n    info(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"info\", message, chunks });\n    }\n\n    notice(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"notice\", message, chunks });\n    }\n\n    warn(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"warn\", message, chunks });\n    }\n\n    error(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"error\", message, chunks });\n    }\n\n    logic(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"logic\", message, chunks });\n    }\n\n    silly(message?: any, ...chunks: any[]): void {\n        this.out({ level: \"silly\", message, chunks });\n    }\n\n    results(results: unknown): void {\n        this.out({ level: \"results\", message: \"results\", results });\n    }\n\n    request(operation: string, ...chunks: any[]): void {\n        const message = this.inspectChunks([operation, ...chunks]);\n        this.out({ level: \"request\", message });\n    }\n\n    response(operation: string, ...chunks: any[]): void {\n        const message = this.inspectChunks([operation, ...chunks]);\n        this.out({ level: \"response\", message });\n    }\n\n    progress(message: string, opts: LoggerProgressOptions): void {\n        const { prefix, count, total } = opts;\n        const paddedTotal = String(total).length;\n        const paddedCount = String(count).padStart(paddedTotal, \" \");\n        const payload: LogPayload = {\n            level: \"progress\",\n            message,\n            count: paddedCount,\n            total,\n            prefix\n        };\n\n        if (!this.startTimes[prefix ?? \"\"]) {\n            this.startTimes[prefix ?? \"\"] = Date.now();\n        }\n        if (this.options.progressTimes) {\n            const elapsedSeconds = (Date.now() - this.startTimes[prefix ?? \"\"]) / 1000;\n            let remaining = -1;\n            if (count > 1) {\n                const rate = elapsedSeconds / (count - 1);\n                remaining = (total - count) * rate;\n            }\n            payload.elapsed = this.round(elapsedSeconds, 2);\n            payload.remaining = remaining >= 0 ? this.round(remaining, 2) : remaining;\n        }\n\n        if (count >= total) {\n            delete this.startTimes[prefix ?? \"\"];\n            delete this.lastProgressTimes[prefix ?? \"\"];\n        }\n\n        if (this.shouldOutputProgress(prefix ?? \"\", count, total)) {\n            this.out(payload);\n            if (this.options.progressThrottle && prefix) {\n                this.lastProgressTimes[prefix] = Date.now();\n            }\n        }\n    }\n\n    private shouldOutputProgress(prefix: string, count: number, total: number): boolean {\n        if (!this.options.progressThrottle) {\n            return true;\n        }\n        if (count === 1 || count === total || !prefix) {\n            return true;\n        }\n        const lastTime = this.lastProgressTimes[prefix];\n        if (!lastTime) {\n            return true;\n        }\n        return Date.now() - lastTime >= this.options.progressThrottle;\n    }\n\n    private out(struct: LogPayload): void {\n        if (this.options.silent) {\n            return;\n        }\n        if (!this.options.levels.includes(struct.level)) {\n            return;\n        }\n\n        if (this.options.prefix && !struct.prefix) {\n            struct.prefix = this.options.prefix;\n        }\n\n        const output = this.options.mode === \"json\"\n            ? struct\n            : this.formatLog(struct);\n\n        this.transport.write(output);\n    }\n\n    private formatLog(struct: LogPayload): string {\n        const parts: string[] = [];\n        const now = new Date();\n\n        if (this.options.timestamp) {\n            parts.push(now.toISOString());\n        }\n\n        if (this.options.showLevel) {\n            parts.push(struct.level.toUpperCase());\n        }\n\n        if (struct.level === \"progress\") {\n            if (struct.prefix) {\n                parts.push(LEVEL_COLORS[struct.level].bold(struct.prefix));\n            }\n            if (struct.count !== undefined && struct.total !== undefined) {\n                parts.push(LEVEL_COLORS[struct.level](`${struct.count}/${struct.total}`));\n            }\n        } else if (struct.prefix) {\n            parts.push(chalk.cyan(`[${struct.prefix}]`));\n        }\n\n        if (struct.message) {\n            const formatter = LEVEL_COLORS[struct.level] ?? chalk.white;\n            parts.push(formatter.bold(struct.message));\n        }\n\n        if (struct.level === \"progress\") {\n            if (struct.elapsed !== undefined && struct.remaining !== undefined) {\n                const formatter = LEVEL_COLORS[struct.level];\n                parts.push(formatter(`${struct.elapsed}/${struct.remaining}`));\n            }\n        }\n\n        if (struct.chunks && struct.chunks.length) {\n            parts.push(this.inspectChunks(struct.chunks));\n        }\n\n        if (struct.results) {\n            const formatter = LEVEL_COLORS[struct.level] ?? chalk.white;\n            parts.push(formatter(JSON.stringify(struct.results, null, 4)));\n        }\n\n        return parts.join(\" \");\n    }\n\n    private inspectChunks(chunks: any[]): string {\n        return chunks\n            .map(chunk => util.inspect(chunk, { colors: true, depth: null }))\n            .join(\" \");\n    }\n\n    private normalizeOptions(options: LoggerOptions): NormalizedOptions {\n        const { route, mode, prefix, silent, showLevel, timestamp, levels, progress } = options;\n        const normalized: NormalizedOptions = {\n            mode: this.isValidMode(mode) ? mode! : \"text\",\n            route: route ?? (typeof process.send === \"function\" ? \"ipc\" : \"console\"),\n            prefix,\n            silent: silent ?? false,\n            showLevel: showLevel ?? true,\n            timestamp: timestamp ?? false,\n            levels: this.normalizeLevels(levels),\n            progressTimes: progress?.withTimes ?? false,\n            progressThrottle: progress?.throttleMs\n        };\n        return normalized;\n    }\n\n    private normalizeLevels(levels?: string[]): LevelName[] {\n        if (!levels || !levels.length) {\n            return ALL_LEVELS;\n        }\n\n        const includes = levels.filter(level => !level.startsWith(\"-\")) as LevelName[];\n        const excludes = levels\n            .filter(level => level.startsWith(\"-\"))\n            .map(level => level.slice(1)) as LevelName[];\n\n        const unknown = [...includes, ...excludes].filter(level => !ALL_LEVELS.includes(level));\n        if (unknown.length) {\n            console.warn(`[Logger] Unknown level(s): ${unknown.join(\", \")}`);\n        }\n\n        const base = includes.length ? includes : ALL_LEVELS;\n        return base.filter(level => !excludes.includes(level));\n    }\n\n    private isValidMode(mode?: string | null): mode is LoggerMode | undefined {\n        return mode === undefined || mode === null || mode === \"text\" || mode === \"json\";\n    }\n\n    private round(value: number, places: number): number {\n        const factor = Math.pow(10, places);\n        return Math.round(value * factor) / factor;\n    }\n}\n\n\n","import { LoggerTransport } from \"./types.js\";\n\nexport class ConsoleTransport implements LoggerTransport {\n    write(payload: any): void {\n        console.info(payload);\n    }\n}\n\nexport class ParentProcessTransport implements LoggerTransport {\n    write(payload: any): void {\n        if (typeof process.send === \"function\") {\n            process.send(payload);\n        } else {\n            console.info(payload);\n        }\n    }\n}\n\n\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nmakarov/cli-toolkit",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "A comprehensive toolkit for building CLI applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -36,6 +36,11 @@
       "types": "./dist/errors.d.ts",
       "import": "./dist/errors.js",
       "require": "./dist/errors.cjs"
+    },
+    "./logger": {
+      "types": "./dist/logger.d.ts",
+      "import": "./dist/logger.js",
+      "require": "./dist/logger.cjs"
     }
   },
   "scripts": {