@reliverse/relinka 1.3.8 → 1.4.0

package/bin/main.js

@@ -1,58 +1,61 @@
+export * from "./deprecated/types.js";
 export {
   LogLevelsDeprecated,
   LogTypesDeprecated
-} from "./core-impl/deprecated/components/levels/levels.js";
+} from "./deprecated/components/levels/levels.js";
 export {
   createRelinkaBaseDeprecated,
   relinkaBasicDeprecated
-} from "./core-impl/deprecated/components/modes/basic.js";
+} from "./deprecated/components/modes/basic.js";
 export {
   createRelinkaBrowserDeprecatedDeprecated,
   relinkaBrowserDeprecated
-} from "./core-impl/deprecated/components/modes/browser.js";
-export { relinkaDeprecated } from "./core-impl/deprecated/components/relinka-deprecated/logger.js";
+} from "./deprecated/components/modes/browser.js";
+export { relinkaDeprecated } from "./deprecated/components/relinka-deprecated/logger.js";
 export {
   createRelinkaSharedDeprecated,
   relinkaInstanceDeprecated
-} from "./core-impl/deprecated/components/relinka-deprecated/mod.js";
+} from "./deprecated/components/relinka-deprecated/mod.js";
 export {
   RelinkaInterface,
   createRelinkaDeprecated
-} from "./core-impl/deprecated/components/relinka-deprecated/relinka.js";
-export { BasicReporter } from "./core-impl/deprecated/components/reporters/basic.js";
-export { BrowserReporter } from "./core-impl/deprecated/components/reporters/browser.js";
+} from "./deprecated/components/relinka-deprecated/relinka.js";
+export { BasicReporter } from "./deprecated/components/reporters/basic.js";
+export { BrowserReporter } from "./deprecated/components/reporters/browser.js";
 export {
   TYPE_COLOR_MAP,
   LEVEL_COLOR_MAP,
   FancyReporter
-} from "./core-impl/deprecated/components/reporters/fancy.js";
-export { box } from "./core-impl/deprecated/utils/box.js";
+} from "./deprecated/components/reporters/fancy.js";
+export { box } from "./deprecated/utils/box.js";
 export {
   colors,
   getColor,
   colorize
-} from "./core-impl/deprecated/utils/deprecatedColors.js";
-export { parseStack } from "./core-impl/deprecated/utils/error.js";
+} from "./deprecated/utils/deprecatedColors.js";
+export { parseStack } from "./deprecated/utils/error.js";
 export {
   compileFormat,
   formatString
-} from "./core-impl/deprecated/utils/format.js";
-export {
-  isPlainObject,
-  isLogObj
-} from "./core-impl/deprecated/utils/log.js";
-export { writeStream } from "./core-impl/deprecated/utils/stream.js";
+} from "./deprecated/utils/format.js";
+export { isPlainObject, isLogObj } from "./deprecated/utils/log.js";
+export { writeStream } from "./deprecated/utils/stream.js";
 export {
   stripAnsi,
   centerAlign,
   rightAlign,
   leftAlign,
   align
-} from "./core-impl/deprecated/utils/string.js";
-export { formatTree } from "./core-impl/deprecated/utils/tree.js";
+} from "./deprecated/utils/string.js";
+export { formatTree } from "./deprecated/utils/tree.js";
 export {
   relinkaConfig,
+  relinkaShutdown,
+  flushAllLogBuffers,
+  shouldNeverHappen,
+  truncateString,
+  casesHandled,
   relinka,
   relinkaAsync,
   defineConfig
-} from "./core-impl/impl-mod.js";
+} from "./impl.js";

package/package.json

@@ -1,9 +1,4 @@
 {
-  "description": "@reliverse/relinka is your next favorite logging library — built to make your terminal (and browser console — soon) output look good, stay clean, and be actually helpful. It’s styled, structured, and smart. Oh, and it works with configs, files, and colors out of the box.",
-  "license": "MIT",
-  "name": "@reliverse/relinka",
-  "type": "module",
-  "version": "1.3.8",
   "dependencies": {
     "@reliverse/relico": "^1.1.0",
     "@reliverse/runtime": "^1.0.3",
@@ -15,7 +10,47 @@
     "std-env": "^3.9.0",
     "string-width": "^7.2.0"
   },
-  "devDependencies": {},
+  "description": "@reliverse/relinka is a modern, minimal logging library that actually feels right. It's not just pretty output — it's a system: smart formatting, file-safe logging, runtime config support, and a fatal mode built for developers who care about correctness.",
+  "homepage": "https://docs.reliverse.org",
+  "license": "MIT",
+  "name": "@reliverse/relinka",
+  "type": "module",
+  "version": "1.4.0",
+  "keywords": [
+    "logger",
+    "consola",
+    "console",
+    "elegant",
+    "clack",
+    "cli",
+    "error",
+    "format",
+    "prompt",
+    "reliverse",
+    "reporter",
+    "stacktrace",
+    "unified",
+    "universal"
+  ],
+  "devDependencies": {
+    "@biomejs/biome": "1.9.4",
+    "@eslint/js": "^9.24.0",
+    "@reliverse/relidler-cfg": "^1.1.3",
+    "@stylistic/eslint-plugin": "^4.2.0",
+    "@total-typescript/ts-reset": "^0.6.1",
+    "@types/bun": "^1.2.9",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.14.1",
+    "@types/sentencer": "^0.2.3",
+    "eslint": "^9.24.0",
+    "eslint-plugin-no-relative-import-paths": "^1.6.1",
+    "eslint-plugin-perfectionist": "^4.11.0",
+    "jiti": "^2.4.2",
+    "knip": "^5.50.2",
+    "sentencer": "^0.2.1",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.29.1"
+  },
   "exports": {
     ".": "./bin/main.js"
   },

package/bin/core-impl/deprecated/components/modes/shared.d.ts

@@ -1,2 +0,0 @@
-export { LogLevelsDeprecated, LogTypesDeprecated, } from "../levels/levels.js";
-export type * from "../../../../core-types.js";

package/bin/core-impl/deprecated/components/modes/shared.js

@@ -1,4 +0,0 @@
-export {
-  LogLevelsDeprecated,
-  LogTypesDeprecated
-} from "../levels/levels.js";

package/bin/core-impl/deprecated/components/relinka-deprecated/relinka.test.d.ts

@@ -1 +0,0 @@
-export {};

package/bin/core-impl/deprecated/components/relinka-deprecated/relinka.test.js

@@ -1,57 +0,0 @@
-import { describe, test, expect } from "vitest";
-import { createRelinkaDeprecated } from "./relinka.js";
-import {
-  LogLevelsDeprecated
-} from "./mod.js";
-describe("relinka", () => {
-  test("can set level", () => {
-    const relinka = createRelinkaDeprecated();
-    expect(relinka.level).toBe(1);
-    for (let i = 0; i <= 5; i++) {
-      relinka.level = i;
-      expect(relinka.level).toBe(i);
-    }
-  });
-  test("silent log level does't print logs", async () => {
-    const logs = [];
-    const TestReporter = {
-      log(logObj) {
-        logs.push(logObj);
-      }
-    };
-    const relinka = createRelinkaDeprecated({
-      throttle: 100,
-      level: LogLevelsDeprecated.silent,
-      reporters: [TestReporter]
-    });
-    for (let i = 0; i < 10; i++) {
-      relinka.log("SPAM");
-    }
-    await wait(200);
-    expect(logs.length).toBe(0);
-  });
-  test("can see spams without ending log", async () => {
-    const logs = [];
-    const TestReporter = {
-      log(logObj) {
-        logs.push(logObj);
-      }
-    };
-    const relinka = createRelinkaDeprecated({
-      throttle: 100,
-      level: LogLevelsDeprecated.info,
-      reporters: [TestReporter]
-    });
-    for (let i = 0; i < 10; i++) {
-      relinka.log("SPAM");
-    }
-    await wait(300);
-    expect(logs.length).toBe(7);
-    expect(logs.at(-1).args).toEqual(["SPAM", "(repeated 4 times)"]);
-  });
-});
-function wait(delay) {
-  return new Promise((resolve) => {
-    setTimeout(resolve, delay);
-  });
-}

package/bin/core-impl/impl-mod.d.ts

@@ -1,19 +0,0 @@
-import type { RelinkaConfig, LogLevel } from "../core-types.js";
-/**
- * Promise that resolves once c12 loads and merges the config.
- */
-export declare const relinkaConfig: Promise<RelinkaConfig>;
-/**
- * Logs a message synchronously using the current config.
- * Skips debug-level logs unless `debug` is true in the config.
- */
-export declare function relinka(type: LogLevel | "clear", message: string, ...args: unknown[]): void;
-/**
- * Logs a message asynchronously, waiting for the config to be fully loaded.
- * Also handles file writing and log cleanup if enabled.
- */
-export declare function relinkaAsync(type: LogLevel, message: string, ...args: unknown[]): Promise<void>;
-/**
- * Type helper for user config files.
- */
-export declare function defineConfig(config: Partial<RelinkaConfig>): Partial<RelinkaConfig>;

package/bin/core-impl/impl-mod.js

@@ -1,321 +0,0 @@
-import { re } from "@reliverse/relico";
-import { loadConfig } from "c12";
-import fs from "fs-extra";
-import path from "pathe";
-const DEV_VERBOSE = false;
-const DEFAULT_RELINKA_CONFIG = {
-  debug: false,
-  dirs: {
-    dailyLogs: false,
-    logDir: ".reliverse/logs",
-    maxLogFiles: 0,
-    specialDirs: {
-      distDirNames: ["dist", "dist-jsr", "dist-npm", "dist-libs"],
-      useParentConfigInDist: true
-    }
-  },
-  disableColors: false,
-  logFilePath: "relinka.log",
-  saveLogsToFile: false,
-  withTimestamp: false
-};
-let currentConfig = { ...DEFAULT_RELINKA_CONFIG };
-let isConfigInitialized = false;
-let resolveRelinkaConfig;
-export const relinkaConfig = new Promise((resolve) => {
-  resolveRelinkaConfig = resolve;
-});
-async function initializeConfig() {
-  try {
-    const result = await loadConfig({
-      name: "relinka",
-      // base name => tries relinka.config.*, .relinkarc, etc.
-      cwd: process.cwd(),
-      // working directory
-      dotenv: false,
-      packageJson: false,
-      rcFile: false,
-      globalRc: false,
-      defaults: DEFAULT_RELINKA_CONFIG
-      // lowest priority
-      // overrides: {},       // highest priority if we would need to forcibly override
-    });
-    currentConfig = result.config;
-    isConfigInitialized = true;
-    if (DEV_VERBOSE) {
-      console.log(
-        "[Relinka Config Debug] Config file used:",
-        result.configFile
-      );
-      console.log("[Relinka Config Debug] All merged layers:", result.layers);
-      console.log("[Relinka Config Debug] Final configuration:", currentConfig);
-    }
-    if (resolveRelinkaConfig) {
-      resolveRelinkaConfig(currentConfig);
-    }
-  } catch (err) {
-    console.error(
-      `[Relinka Config Error] Failed to load config: ${err instanceof Error ? err.message : String(err)}`
-    );
-    currentConfig = { ...DEFAULT_RELINKA_CONFIG };
-    isConfigInitialized = true;
-    if (resolveRelinkaConfig) {
-      resolveRelinkaConfig(currentConfig);
-    }
-  }
-}
-initializeConfig().catch((err) => {
-  console.error(
-    `[Relinka Config Error] Unhandled error: ${err instanceof Error ? err.message : String(err)}`
-  );
-  if (!isConfigInitialized) {
-    currentConfig = { ...DEFAULT_RELINKA_CONFIG };
-    isConfigInitialized = true;
-    if (resolveRelinkaConfig) {
-      resolveRelinkaConfig(currentConfig);
-    }
-  }
-});
-function isDebugEnabled(config) {
-  return config.debug ?? DEFAULT_RELINKA_CONFIG.debug;
-}
-function isColorEnabled(config) {
-  return !(config.disableColors ?? DEFAULT_RELINKA_CONFIG.disableColors);
-}
-function getLogDir(config) {
-  return config.dirs?.logDir ?? DEFAULT_RELINKA_CONFIG.dirs.logDir;
-}
-function isDailyLogsEnabled(config) {
-  return config.dirs?.dailyLogs ?? DEFAULT_RELINKA_CONFIG.dirs.dailyLogs;
-}
-function shouldSaveLogs(config) {
-  return config.saveLogsToFile ?? DEFAULT_RELINKA_CONFIG.saveLogsToFile;
-}
-function getMaxLogFiles(config) {
-  return config.dirs?.maxLogFiles ?? DEFAULT_RELINKA_CONFIG.dirs.maxLogFiles;
-}
-function getBaseLogName(config) {
-  return config.logFilePath ?? DEFAULT_RELINKA_CONFIG.logFilePath;
-}
-function getTimestamp(config) {
-  if (!config.withTimestamp) return "";
-  const now = /* @__PURE__ */ new Date();
-  return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")} ${String(now.getHours()).padStart(2, "0")}:${String(
-    now.getMinutes()
-  ).padStart(2, "0")}:${String(now.getSeconds()).padStart(2, "0")}.${String(now.getMilliseconds()).padStart(3, "0")}`;
-}
-function getLogFilePath(config) {
-  const logDir = getLogDir(config);
-  const daily = isDailyLogsEnabled(config);
-  let finalLogName = getBaseLogName(config);
-  if (daily) {
-    const now = /* @__PURE__ */ new Date();
-    const datePrefix = `${now.getFullYear()}-${String(
-      now.getMonth() + 1
-    ).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}-`;
-    finalLogName = datePrefix + finalLogName;
-  }
-  if (finalLogName && !finalLogName.endsWith(".log")) {
-    finalLogName += ".log";
-  }
-  const effectiveLogName = finalLogName || "relinka.log";
-  return path.resolve(process.cwd(), logDir, effectiveLogName);
-}
-function formatLogMessage(config, level, msg, details) {
-  const timestamp = getTimestamp(config);
-  let detailsStr = "";
-  if (details !== void 0) {
-    if (details instanceof Error) {
-      detailsStr = `
-Stack Trace: ${details.stack || details.message}`;
-    } else if (typeof details === "object" && details !== null) {
-      try {
-        detailsStr = ` ${JSON.stringify(details)}`;
-      } catch {
-        detailsStr = " [object Object]";
-      }
-    } else {
-      detailsStr = ` ${String(details)}`;
-    }
-  }
-  const paddedLevel = level.padEnd(7, " ");
-  return timestamp ? `[${timestamp}] ${paddedLevel} ${msg}${detailsStr}` : `${paddedLevel} ${msg}${detailsStr}`;
-}
-function logToConsole(config, level, formattedMessage) {
-  const COLOR_RESET = "\x1B[0m";
-  if (!isColorEnabled(config)) {
-    if (level === "ERROR") {
-      console.error(formattedMessage);
-    } else {
-      console.log(formattedMessage);
-    }
-  } else {
-    switch (level) {
-      case "ERROR":
-        console.error(re.redBright(formattedMessage) + COLOR_RESET);
-        break;
-      case "WARN":
-        console.warn(re.yellowBright(formattedMessage) + COLOR_RESET);
-        break;
-      case "SUCCESS":
-        console.log(re.greenBright(formattedMessage) + COLOR_RESET);
-        break;
-      case "INFO":
-        console.log(re.cyanBright(formattedMessage) + COLOR_RESET);
-        break;
-      default:
-        console.log(re.dim(formattedMessage) + COLOR_RESET);
-    }
-  }
-}
-async function getLogFilesSortedByDate(config) {
-  const logDirectoryPath = path.resolve(process.cwd(), getLogDir(config));
-  if (!await fs.pathExists(logDirectoryPath)) {
-    if (isDebugEnabled(config)) {
-      console.log(
-        `[Relinka FS Debug] Log directory not found: ${logDirectoryPath}`
-      );
-    }
-    return [];
-  }
-  try {
-    const files = await fs.readdir(logDirectoryPath);
-    const logFilesPromises = files.filter((f) => f.endsWith(".log")).map(async (f) => {
-      const filePath = path.join(logDirectoryPath, f);
-      try {
-        const stats = await fs.stat(filePath);
-        if (stats.isFile()) {
-          return { path: filePath, mtime: stats.mtime.getTime() };
-        }
-        return null;
-      } catch (err) {
-        if (isDebugEnabled(config)) {
-          console.error(
-            `[Relinka FS Debug] Error reading stats for ${filePath}: ${err instanceof Error ? err.message : String(err)}`
-          );
-        }
-        return null;
-      }
-    });
-    const logFiles = (await Promise.all(logFilesPromises)).filter(
-      (f) => Boolean(f)
-    );
-    return logFiles.sort((a, b) => b.mtime - a.mtime);
-  } catch (readErr) {
-    if (isDebugEnabled(config)) {
-      console.error(
-        `[Relinka FS Error] Failed reading log directory ${logDirectoryPath}: ${readErr instanceof Error ? readErr.message : String(readErr)}`
-      );
-    }
-    return [];
-  }
-}
-async function deleteFiles(filePaths, config) {
-  await Promise.all(
-    filePaths.map(async (filePath) => {
-      try {
-        await fs.unlink(filePath);
-      } catch (err) {
-        if (isDebugEnabled(config)) {
-          console.error(
-            `[Relinka FS Error] Failed to delete log file ${filePath}: ${err instanceof Error ? err.message : String(err)}`
-          );
-        }
-      }
-    })
-  );
-}
-async function cleanupOldLogFiles(config) {
-  if (!shouldSaveLogs(config) || getMaxLogFiles(config) <= 0) return;
-  try {
-    const sortedLogFiles = await getLogFilesSortedByDate(config);
-    const maxFiles = getMaxLogFiles(config);
-    if (sortedLogFiles.length > maxFiles) {
-      const filesToDelete = sortedLogFiles.slice(maxFiles).map((f) => f.path);
-      if (filesToDelete.length > 0) {
-        await deleteFiles(filesToDelete, config);
-        if (isDebugEnabled(config)) {
-          console.log(
-            `[Relinka Cleanup] Deleted ${filesToDelete.length} old log file(s). Kept ${maxFiles}.`
-          );
-        }
-      }
-    }
-  } catch (err) {
-    if (isDebugEnabled(config)) {
-      console.error(
-        `[Relinka Cleanup Error] Failed during log cleanup: ${err instanceof Error ? err.message : String(err)}`
-      );
-    }
-  }
-}
-async function appendToLogFile(config, absoluteLogFilePath, logMessage) {
-  try {
-    await fs.ensureDir(path.dirname(absoluteLogFilePath));
-    await fs.appendFile(absoluteLogFilePath, `${logMessage}
-`);
-  } catch (err) {
-    if (isDebugEnabled(config)) {
-      console.error(
-        `[Relinka File Error] Failed to write to log file ${absoluteLogFilePath}: ${err instanceof Error ? err.message : String(err)}`
-      );
-    }
-  }
-}
-export function relinka(type, message, ...args) {
-  if (type === "clear") {
-    console.clear();
-    return;
-  }
-  if (message === "") {
-    console.log();
-    return;
-  }
-  const logLevelLabel = type === "verbose" ? "DEBUG" : type.toUpperCase();
-  if (logLevelLabel === "DEBUG" && !isDebugEnabled(currentConfig)) {
-    return;
-  }
-  const details = args.length > 1 ? args : args[0];
-  const formatted = formatLogMessage(
-    currentConfig,
-    logLevelLabel,
-    message,
-    details
-  );
-  logToConsole(currentConfig, logLevelLabel, formatted);
-}
-export async function relinkaAsync(type, message, ...args) {
-  await relinkaConfig;
-  if (message === "") {
-    console.log();
-    return;
-  }
-  const logLevelLabel = type === "verbose" ? "DEBUG" : type.toUpperCase();
-  if (logLevelLabel === "DEBUG" && !isDebugEnabled(currentConfig)) {
-    return;
-  }
-  const details = args.length > 1 ? args : args[0];
-  const formatted = formatLogMessage(
-    currentConfig,
-    logLevelLabel,
-    message,
-    details
-  );
-  logToConsole(currentConfig, logLevelLabel, formatted);
-  if (shouldSaveLogs(currentConfig)) {
-    const absoluteLogFilePath = getLogFilePath(currentConfig);
-    try {
-      await appendToLogFile(currentConfig, absoluteLogFilePath, formatted);
-      await cleanupOldLogFiles(currentConfig);
-    } catch (err) {
-      if (isDebugEnabled(currentConfig)) {
-        console.error(
-          `[Relinka File Async Error] Error during file logging/cleanup: ${err instanceof Error ? err.message : String(err)}`
-        );
-      }
-    }
-  }
-}
-export function defineConfig(config) {
-  return config;
-}