@release-change/logger 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Victor Brito
+
+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/README.md

@@ -0,0 +1,34 @@
+# @release-change/logger
+
+Print messages in the terminal for release-change
+
+![License: MIT](https://img.shields.io/github/license/release-change/release-change)
+[![ESM-only package](https://img.shields.io/badge/package-ESM--only-ffe536)](https://nodejs.org/api/esm.html)
+[![Conventional Commits 1.0.0](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits&logoColor=white)](https://conventionalcommits.org)
+[![Formatted with Biome](https://img.shields.io/badge/Formatted_with-Biome-60a5fa?style=flat&logo=biome)](https://biomejs.dev/)
+![NPM latest version](https://img.shields.io/npm/v/%40release-change%2Flogger/latest)
+![Node support](https://img.shields.io/node/v/%40release-change%2Flogger)
+![Build status](https://img.shields.io/github/actions/workflow/status/release-change/release-change/run-tests.yml)
+
+## Usage
+
+```ts
+import { setLogger } from "@release-change/logger";
+
+const logger = setLogger();
+logger.logSuccess("Everything done successfully.");
+```
+
+## `setLogger` methods
+
+- `setScope`: to print the scope concerned by any non-debug messages,
+- `setDebugScope`: to print the scope concerned by any debug messages,
+- `logDebug`: to print debug messages (`setLogger()` must be called with the `isDebug` argument set to `true`),
+- `logInfo`: to print informational messages,
+- `logError`: to print error messages,
+- `logWarn`: to print warning messages,
+- `logSuccess`: to assert to users that their instructions have completed successfully.
+
+## Copyright & licence
+
+© 2025-present Victor Brito — Released under the [MIT licence](./LICENSE).

package/dist/add-error-to-context.d.ts

@@ -0,0 +1,8 @@
+import type { Context, ContextBase } from "@release-change/shared";
+/**
+ * Adds an error to the context.
+ * @param error - The error to add.
+ * @param context - The context where the CLI is running.
+ */
+export declare const addErrorToContext: (error: unknown, context: Context | ContextBase) => void;
+//# sourceMappingURL=add-error-to-context.d.ts.map

package/dist/add-error-to-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-error-to-context.d.ts","sourceRoot":"","sources":["../src/add-error-to-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAInE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,EAAE,SAAS,OAAO,GAAG,WAAW,KAAG,IAYlF,CAAC"}

package/dist/add-error-to-context.js

@@ -0,0 +1,20 @@
+import { isDetailedError } from "./is-detailed-error.js";
+/**
+ * Adds an error to the context.
+ * @param error - The error to add.
+ * @param context - The context where the CLI is running.
+ */
+export const addErrorToContext = (error, context) => {
+    if (error instanceof Error) {
+        const { cause } = error;
+        if (cause && isDetailedError(cause)) {
+            const { title, message, details } = cause;
+            context.errors.push({
+                title,
+                message,
+                details
+            });
+        }
+    }
+};
+//# sourceMappingURL=add-error-to-context.js.map

package/dist/add-error-to-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-error-to-context.js","sourceRoot":"","sources":["../src/add-error-to-context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAE,OAA8B,EAAQ,EAAE;IACxF,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;QACxB,IAAI,KAAK,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;YAC1C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;gBAClB,KAAK;gBACL,OAAO;gBACP,OAAO;aACR,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

package/dist/check-error-type.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Checks the error type.
+ * @param error - The error caught.
+ * @return The message from the `message` property if `error` is an instance of `Error`, the error itself within a string otherwise.
+ */
+export declare const checkErrorType: (error: unknown) => string;
+//# sourceMappingURL=check-error-type.d.ts.map

package/dist/check-error-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-error-type.d.ts","sourceRoot":"","sources":["../src/check-error-type.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,MAG/C,CAAC"}

package/dist/check-error-type.js

@@ -0,0 +1,11 @@
+/**
+ * Checks the error type.
+ * @param error - The error caught.
+ * @return The message from the `message` property if `error` is an instance of `Error`, the error itself within a string otherwise.
+ */
+export const checkErrorType = (error) => {
+    if (error instanceof Error)
+        return error.message;
+    return `Unknown error: ${error}`;
+};
+//# sourceMappingURL=check-error-type.js.map

package/dist/check-error-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-error-type.js","sourceRoot":"","sources":["../src/check-error-type.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAc,EAAU,EAAE;IACvD,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,OAAO,kBAAkB,KAAK,EAAE,CAAC;AACnC,CAAC,CAAC"}

package/dist/format-message.d.ts

@@ -0,0 +1,15 @@
+import type { LoggerContext } from "./logger.types.js";
+/**
+ * Formats the message according to the context provided by `loggerContext`:
+ * - if the debug mode is activated, the message is formatted with the prefix;
+ * - otherwise, the message is formatted with the prefix and the appropriate symbol according to its type:
+ *   - `\u2139` if the message is of type `info`,
+ *   - `\u2718` if the message is of type `error`,
+ *   - `\u26a0` if the message is of type `warn`,
+ *   - `\u2714` if the message is of type `success`.
+ * @param message - The message to format.
+ * @param loggerContext - The logger context: whether the debug mode is activated or not, what scope is concerned (optional) and the message type (optional).
+ * @return The formatted message.
+ */
+export declare const formatMessage: (message: string, loggerContext: LoggerContext) => string;
+//# sourceMappingURL=format-message.d.ts.map

package/dist/format-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-message.d.ts","sourceRoot":"","sources":["../src/format-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,mBAAmB,CAAC;AAI3E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,eAAe,aAAa,KAAG,MAU7E,CAAC"}

package/dist/format-message.js

@@ -0,0 +1,25 @@
+import { setPrefix } from "./set-prefix.js";
+/**
+ * Formats the message according to the context provided by `loggerContext`:
+ * - if the debug mode is activated, the message is formatted with the prefix;
+ * - otherwise, the message is formatted with the prefix and the appropriate symbol according to its type:
+ *   - `\u2139` if the message is of type `info`,
+ *   - `\u2718` if the message is of type `error`,
+ *   - `\u26a0` if the message is of type `warn`,
+ *   - `\u2714` if the message is of type `success`.
+ * @param message - The message to format.
+ * @param loggerContext - The logger context: whether the debug mode is activated or not, what scope is concerned (optional) and the message type (optional).
+ * @return The formatted message.
+ */
+export const formatMessage = (message, loggerContext) => {
+    const prefix = setPrefix(Date.now(), loggerContext);
+    const symbols = {
+        info: "\u2139",
+        error: "\u2718",
+        warn: "\u26a0",
+        success: "\u2714"
+    };
+    const { type } = loggerContext;
+    return type ? `${prefix} ${symbols[type]} ${message}` : `${prefix} ${message}`;
+};
+//# sourceMappingURL=format-message.js.map

package/dist/format-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-message.js","sourceRoot":"","sources":["../src/format-message.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,aAA4B,EAAU,EAAE;IACrF,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,CAAC;IACpD,MAAM,OAAO,GAAuB;QAClC,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,QAAQ;KAClB,CAAC;IACF,MAAM,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC;IAC/B,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;AACjF,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { Logger } from "./logger.types.js";
+export { addErrorToContext } from "./add-error-to-context.js";
+export { checkErrorType } from "./check-error-type.js";
+export { isDetailedError } from "./is-detailed-error.js";
+export { setLogger } from "./set-logger.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { addErrorToContext } from "./add-error-to-context.js";
+export { checkErrorType } from "./check-error-type.js";
+export { isDetailedError } from "./is-detailed-error.js";
+export { setLogger } from "./set-logger.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/is-detailed-error.d.ts

@@ -0,0 +1,8 @@
+import type { DetailedError } from "@release-change/shared";
+/**
+ * Checks if an unknown value satisfies the `DetailedError` type.
+ * @param value - The value to check.
+ * @return `true` if the value is of type `DetailedError`, `false` otherwise.
+ */
+export declare const isDetailedError: (value: unknown) => value is DetailedError;
+//# sourceMappingURL=is-detailed-error.d.ts.map

package/dist/is-detailed-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-detailed-error.d.ts","sourceRoot":"","sources":["../src/is-detailed-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,aAazD,CAAC"}

package/dist/is-detailed-error.js

@@ -0,0 +1,19 @@
+/**
+ * Checks if an unknown value satisfies the `DetailedError` type.
+ * @param value - The value to check.
+ * @return `true` if the value is of type `DetailedError`, `false` otherwise.
+ */
+export const isDetailedError = (value) => {
+    if (!value || typeof value !== "object")
+        return false;
+    const candidate = value;
+    const { title, message, details } = candidate;
+    return (typeof title === "string" &&
+        typeof message === "string" &&
+        typeof details === "object" &&
+        details !== null &&
+        typeof candidate.details.output === "string" &&
+        (typeof candidate.details.command === "string" ||
+            candidate.details.command === undefined));
+};
+//# sourceMappingURL=is-detailed-error.js.map

package/dist/is-detailed-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-detailed-error.js","sourceRoot":"","sources":["../src/is-detailed-error.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAc,EAA0B,EAAE;IACxE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,OAAQ,SAAS,CAAC,OAAmC,CAAC,MAAM,KAAK,QAAQ;QACzE,CAAC,OAAQ,SAAS,CAAC,OAAmC,CAAC,OAAO,KAAK,QAAQ;YACxE,SAAS,CAAC,OAAmC,CAAC,OAAO,KAAK,SAAS,CAAC,CACxE,CAAC;AACJ,CAAC,CAAC"}

package/dist/logger.types.d.ts

@@ -0,0 +1,22 @@
+type ScopeFunction = (scope: string) => string;
+type LoggerFunction = (message: string) => void;
+export type LoggerContext = {
+    isDebug: boolean;
+    scope?: string;
+    debugScope?: string;
+    type?: MessageType;
+};
+type MessageType = "info" | "error" | "warn" | "success";
+export type MessageTypeSymbols = Record<MessageType, string>;
+export type Logger = {
+    setScope: ScopeFunction;
+    setDebugScope: ScopeFunction;
+    logDebug: LoggerFunction;
+    logInfo: LoggerFunction;
+    logError: LoggerFunction;
+    logWarn: LoggerFunction;
+    logSuccess: LoggerFunction;
+    logWithoutFormatting: LoggerFunction;
+};
+export {};
+//# sourceMappingURL=logger.types.d.ts.map

package/dist/logger.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.types.d.ts","sourceRoot":"","sources":["../src/logger.types.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAC/C,KAAK,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAChD,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB,CAAC;AACF,KAAK,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AACzD,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAC7D,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,cAAc,CAAC;IAC3B,oBAAoB,EAAE,cAAc,CAAC;CACtC,CAAC"}

package/dist/logger.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.types.js.map

package/dist/logger.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.types.js","sourceRoot":"","sources":["../src/logger.types.ts"],"names":[],"mappings":""}

package/dist/set-logger.d.ts

@@ -0,0 +1,8 @@
+import type { Logger } from "./logger.types.js";
+/**
+ * Sets the logger object.
+ * @param [isDebug] - Whether the debug mode is activated or not.
+ * @return The logger object.
+ */
+export declare const setLogger: (isDebug?: boolean) => Logger;
+//# sourceMappingURL=set-logger.d.ts.map

package/dist/set-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-logger.d.ts","sourceRoot":"","sources":["../src/set-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIhD;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,iBAAe,KAAG,MA2C3C,CAAC"}

package/dist/set-logger.js

@@ -0,0 +1,42 @@
+import { formatMessage } from "./format-message.js";
+/**
+ * Sets the logger object.
+ * @param [isDebug] - Whether the debug mode is activated or not.
+ * @return The logger object.
+ */
+export const setLogger = (isDebug = false) => {
+    const loggerContext = {
+        isDebug
+    };
+    let normalScope = "";
+    let debugScope = "";
+    return {
+        setScope: (scope) => {
+            normalScope = scope;
+            return scope;
+        },
+        setDebugScope: (scope) => {
+            debugScope = scope;
+            return scope;
+        },
+        logDebug: (message) => {
+            console.debug(formatMessage(message, { ...loggerContext, debugScope: debugScope }));
+        },
+        logInfo: (message) => {
+            console.info(formatMessage(message, { ...loggerContext, scope: normalScope, type: "info" }));
+        },
+        logError: (message) => {
+            console.error("\x1b[1;31m%s\x1b[0m", formatMessage(message, { ...loggerContext, scope: normalScope, type: "error" }));
+        },
+        logWarn: (message) => {
+            console.warn("\x1b[33m%s\x1b[0m", formatMessage(message, { ...loggerContext, scope: normalScope, type: "warn" }));
+        },
+        logSuccess: (message) => {
+            console.log("\x1b[32m%s\x1b[0m", formatMessage(message, { ...loggerContext, scope: normalScope, type: "success" }));
+        },
+        logWithoutFormatting: (message) => {
+            console.log(message);
+        }
+    };
+};
+//# sourceMappingURL=set-logger.js.map

package/dist/set-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-logger.js","sourceRoot":"","sources":["../src/set-logger.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAO,GAAG,KAAK,EAAU,EAAE;IACnD,MAAM,aAAa,GAAG;QACpB,OAAO;KACR,CAAC;IACF,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,OAAO;QACL,QAAQ,EAAE,CAAC,KAAa,EAAU,EAAE;YAClC,WAAW,GAAG,KAAK,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,aAAa,EAAE,CAAC,KAAa,EAAU,EAAE;YACvC,UAAU,GAAG,KAAK,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,QAAQ,EAAE,CAAC,OAAe,EAAQ,EAAE;YAClC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,GAAG,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,EAAE,CAAC,OAAe,EAAQ,EAAE;YACjC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,GAAG,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAC/F,CAAC;QACD,QAAQ,EAAE,CAAC,OAAe,EAAQ,EAAE;YAClC,OAAO,CAAC,KAAK,CACX,qBAAqB,EACrB,aAAa,CAAC,OAAO,EAAE,EAAE,GAAG,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAChF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,CAAC,OAAe,EAAQ,EAAE;YACjC,OAAO,CAAC,IAAI,CACV,mBAAmB,EACnB,aAAa,CAAC,OAAO,EAAE,EAAE,GAAG,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAC/E,CAAC;QACJ,CAAC;QACD,UAAU,EAAE,CAAC,OAAe,EAAQ,EAAE;YACpC,OAAO,CAAC,GAAG,CACT,mBAAmB,EACnB,aAAa,CAAC,OAAO,EAAE,EAAE,GAAG,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAClF,CAAC;QACJ,CAAC;QACD,oBAAoB,EAAE,CAAC,OAAe,EAAQ,EAAE;YAC9C,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/set-prefix.d.ts

@@ -0,0 +1,15 @@
+import type { LoggerContext } from "./logger.types.js";
+/**
+ * Sets prefix for messages logged to the console according to the context provided by `loggerContext`:
+ * - if the debug mode is activated and `debugScope` is defined as a string (even empty), the prefix uses one of the following formats:
+ *   -`\x1b[1;34m[debug] <package name>\x1b[0m`,
+ *   -`\x1b[1;34m[debug] <package name>:<scope name>\x1b[0m`;
+ * - otherwise, the prefix uses one of the following formats:
+ *   -`[HH:MM:SS] [<package name>] \u203a`,
+ *   -`[HH:MM:SS] [<package name>] [@<package name>/<scope name>] \u203a`.
+ * @param timestamp - The timestamp when the message is logged.
+ * @param loggerContext - The logger context (whether the debug mode is activated or not, what scope is concerned).
+ * @return The prefix in the appropriate format.
+ */
+export declare const setPrefix: (timestamp: number, loggerContext: LoggerContext) => string;
+//# sourceMappingURL=set-prefix.d.ts.map

package/dist/set-prefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-prefix.d.ts","sourceRoot":"","sources":["../src/set-prefix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,GAAI,WAAW,MAAM,EAAE,eAAe,aAAa,KAAG,MAe3E,CAAC"}

package/dist/set-prefix.js

@@ -0,0 +1,32 @@
+import { WORKSPACE_NAME } from "@release-change/shared";
+/**
+ * Sets prefix for messages logged to the console according to the context provided by `loggerContext`:
+ * - if the debug mode is activated and `debugScope` is defined as a string (even empty), the prefix uses one of the following formats:
+ *   -`\x1b[1;34m[debug] <package name>\x1b[0m`,
+ *   -`\x1b[1;34m[debug] <package name>:<scope name>\x1b[0m`;
+ * - otherwise, the prefix uses one of the following formats:
+ *   -`[HH:MM:SS] [<package name>] \u203a`,
+ *   -`[HH:MM:SS] [<package name>] [@<package name>/<scope name>] \u203a`.
+ * @param timestamp - The timestamp when the message is logged.
+ * @param loggerContext - The logger context (whether the debug mode is activated or not, what scope is concerned).
+ * @return The prefix in the appropriate format.
+ */
+export const setPrefix = (timestamp, loggerContext) => {
+    const { isDebug, scope, debugScope } = loggerContext;
+    if (isDebug && typeof debugScope === "string") {
+        if (debugScope)
+            return `\x1b[1;34m[debug] ${WORKSPACE_NAME}:${debugScope}\x1b[0m`;
+        return `\x1b[1;34m[debug] ${WORKSPACE_NAME}\x1b[0m`;
+    }
+    const time = Intl.DateTimeFormat(undefined, {
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hour12: false,
+        timeZone: "UTC"
+    }).format(timestamp);
+    if (scope)
+        return `[${time}] [${WORKSPACE_NAME}] [@${WORKSPACE_NAME}/${scope}] \u203a`;
+    return `[${time}] [${WORKSPACE_NAME}] \u203a`;
+};
+//# sourceMappingURL=set-prefix.js.map

package/dist/set-prefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-prefix.js","sourceRoot":"","sources":["../src/set-prefix.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAiB,EAAE,aAA4B,EAAU,EAAE;IACnF,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,aAAa,CAAC;IACrD,IAAI,OAAO,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC9C,IAAI,UAAU;YAAE,OAAO,qBAAqB,cAAc,IAAI,UAAU,SAAS,CAAC;QAClF,OAAO,qBAAqB,cAAc,SAAS,CAAC;IACtD,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE;QAC1C,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACrB,IAAI,KAAK;QAAE,OAAO,IAAI,IAAI,MAAM,cAAc,OAAO,cAAc,IAAI,KAAK,UAAU,CAAC;IACvF,OAAO,IAAI,IAAI,MAAM,cAAc,UAAU,CAAC;AAChD,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@release-change/logger",
+  "version": "0.1.0",
+  "description": "Print messages in the terminal for release-change",
+  "keywords": [],
+  "homepage": "https://github.com/release-change/release-change",
+  "bugs": {
+    "url": "https://github.com/release-change/release-change/issues"
+  },
+  "author": "Victor Brito (https://victor-brito.dev)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/release-change/release-change.git"
+  },
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    "import": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "engines": {
+    "node": "^20.18.3 || ^22.12.0 || ^24.0.0",
+    "npm": ">=10.8.2",
+    "pnpm": ">=10.28.0"
+  },
+  "dependencies": {
+    "@release-change/shared": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch --preserveWatchOutput & vitest"
+  }
+}