@kyvrixon/utils 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kyvrixon
+
+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 @@
+General utility files I use for alot of projects! Does not include any larger scale items, just the little things

package/dist/index.js

@@ -0,0 +1 @@
+export * from "./lib/Logger";

package/dist/lib/Logger.js

@@ -0,0 +1,104 @@
+import { env } from "bun";
+import chalk from "chalk";
+const { cyan, yellow, red, magenta, dim, gray, bold } = chalk;
+const formatter = new Intl.DateTimeFormat("en-AU", {
+    weekday: "short",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: false,
+});
+/**
+ * To enable debuging make the env variable `__DEBUG_MODE` equal to "1"
+ */
+export class Logger {
+    colors = {
+        notif: cyan,
+        alert: yellow,
+        error: red,
+        debug: magenta,
+    };
+    logMethods = {
+        notif: "log",
+        alert: "warn",
+        error: "error",
+        debug: "debug",
+    };
+    getTimestamp() {
+        const now = new Date();
+        const ms = now.getMilliseconds().toString().padStart(3, "0");
+        const base = formatter.format(now).replace(",", " @");
+        return `${base}:${ms}`;
+    }
+    formatMessage(level, message) {
+        const timestamp = gray(`[${this.getTimestamp()}]`);
+        const levelLabel = bold(this.colors[level](level.toUpperCase().padEnd(5)));
+        const content = message instanceof Error
+            ? `${red(message.message)}\n${dim(this.sanitizeStack(message.stack || ""))}`
+            : message;
+        return `${timestamp} ${levelLabel} ${dim("»")} ${content}`;
+    }
+    sanitizeStack(stack) {
+        return stack
+            .split("\n")
+            .filter((line) => !line.includes("(native") && line.includes(":"))
+            .map((line, index) => {
+            if (index === 0)
+                return false;
+            return (line
+                .trim()
+                // .replace(/\\/g, "/")
+                // .replace(
+                // 	/(.*):(\d+):(\d+)/,
+                // 	(_, f, l, c) => `${dim(f)} ${bold(`(L${l} C${c})`)}`,
+                // )
+                .replace(/at\s+/, "  └─ "));
+        })
+            .filter(Boolean)
+            .join("\n");
+    }
+    log(level, message, forceError) {
+        if (forceError)
+            return void console.error(message);
+        void console[this.logMethods[level]](this.formatMessage(level, message));
+    }
+    /**
+     * Pring a regular (info) message
+     *
+     * @param m Message to display
+     */
+    notif(m) {
+        this.log("notif", m);
+    }
+    /**
+     * Print an alert (warning)
+     *
+     * @param m Message to display
+     */
+    alert(m) {
+        this.log("alert", m);
+    }
+    /**
+     * Print an error
+     *
+     * @param m Message to display
+     * @param e Error (optional)
+     * @param f Force error - directly calls `console.error()`
+     */
+    error(m, e, f) {
+        this.log("error", e ?? m, f);
+    }
+    /**
+     * Print a debug message
+     *
+     * @param m Message to display
+     */
+    debug(m) {
+        if ("__DEBUG_MODE" in env && env.__DEBUG_MODE === "1")
+            this.log("debug", m);
+    }
+    divider(text) {
+        const line = dim("─".repeat(Math.max(0, (50 - text.length - 2) / 2)));
+        console.log(`\n${line} ${bold(text.trim())} ${line}`);
+    }
+}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./lib/Logger";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/types/lib/Logger.d.ts

@@ -0,0 +1,39 @@
+/**
+ * To enable debuging make the env variable `__DEBUG_MODE` equal to "1"
+ */
+export declare class Logger {
+    private readonly colors;
+    private readonly logMethods;
+    private getTimestamp;
+    private formatMessage;
+    private sanitizeStack;
+    private log;
+    /**
+     * Pring a regular (info) message
+     *
+     * @param m Message to display
+     */
+    notif(m: unknown): void;
+    /**
+     * Print an alert (warning)
+     *
+     * @param m Message to display
+     */
+    alert(m: unknown): void;
+    /**
+     * Print an error
+     *
+     * @param m Message to display
+     * @param e Error (optional)
+     * @param f Force error - directly calls `console.error()`
+     */
+    error(m: unknown, e?: Error, f?: boolean): void;
+    /**
+     * Print a debug message
+     *
+     * @param m Message to display
+     */
+    debug(m: unknown): void;
+    divider(text: string): void;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/types/lib/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../lib/Logger.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,qBAAa,MAAM;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAKrB;IAEF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAQzB;IAEF,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,GAAG;IAOX;;;;OAIG;IACI,KAAK,CAAC,CAAC,EAAE,OAAO;IAIvB;;;;OAIG;IACI,KAAK,CAAC,CAAC,EAAE,OAAO;IAIvB;;;;;;OAMG;IACI,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO;IAI/C;;;;OAIG;IACI,KAAK,CAAC,CAAC,EAAE,OAAO;IAIhB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAIlC"}

package/package.json

@@ -0,0 +1,20 @@
+{
+	"name": "@kyvrixon/utils",
+	"module": "index.js",
+	"version": "0.0.1",
+	"type": "module",
+	"private": false,
+	"files": [
+		"dist"
+	],
+	"packageManager": "bun@1.3.6",
+	"devDependencies": {
+		"@types/bun": "1.3.6"
+	},
+	"peerDependencies": {
+		"typescript": "^5.9.3"
+	},
+	"dependencies": {
+		"chalk": "^5.6.2"
+	}
+}