@helzady/zady 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HelzadyDev
+
+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,78 @@
+# zady
+
+Biblioteca leve para logs no Node.js com suporte a cores, prefixos, timestamp e controle de erros.
+
+---
+
+## 📦 Instalação
+
+```bash
+npm install zady
+```
+
+---
+
+## 🚀 Uso básico
+
+```ts
+// Importa funções da biblioteca
+import { log, warn, error, success, crash } from "@helzady/logger"
+
+// Log padrão
+log("Mensagem simples")
+
+// Aviso
+warn("Atenção")
+
+// Erro
+error("Algo deu errado")
+
+// Sucesso
+success("Operação concluída")
+
+// Erro fatal (encerra o processo)
+crash("Erro crítico")
+```
+
+---
+
+## ⚙️ Opções do crash
+
+```ts
+crash("Erro crítico", {
+  code: 1, // Código de saída do processo
+  prefix: "FATAL", // Prefixo da mensagem
+  showStack: true, // Mostrar stack trace
+  timestamp: true, // Mostrar data/hora
+  error: new Error("Detalhes do erro") // Objeto de erro
+})
+```
+
+---
+
+## 🎨 Recursos
+
+* Logs coloridos (ANSI)
+* Prefixos personalizados
+* Timestamp formatado (DD/MM/YYYY HH:mm)
+* Stack trace opcional
+* Encerramento seguro do processo
+
+---
+
+## 📁 Estrutura
+
+```
+src/
+ ├── core/        # Núcleo (formatter, colors, types)
+ ├── functions/   # Funções principais (log, error, etc)
+ ├── utils/       # Utilitários internos
+ ├── config/      # Configurações padrão
+ └── index.ts     # Entry point
+```
+
+---
+
+## 📄 Licença
+
+MIT License

package/build/config/defaults.d.ts

@@ -0,0 +1,6 @@
+export declare const defaults: {
+    prefix: string;
+    code: number;
+    showStack: boolean;
+    timeStamp: boolean;
+};

package/build/config/defaults.js

@@ -0,0 +1,6 @@
+export const defaults = {
+    prefix: "LOGGER",
+    code: 1,
+    showStack: true,
+    timeStamp: true,
+};

package/build/config/index.d.ts

@@ -0,0 +1 @@
+export * from "./defaults.js";

package/build/config/index.js

@@ -0,0 +1 @@
+export * from "./defaults.js";

package/build/core/colors.d.ts

@@ -0,0 +1,21 @@
+export declare const colors: {
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    gray: string;
+};
+export declare const bgColors: {
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+};

package/build/core/colors.js

@@ -0,0 +1,22 @@
+// Define cores ANSI para terminal
+export const colors = {
+    "black": "\x1b[30",
+    "red": "\x1b[31m",
+    "green": "\x1b[32m",
+    "yellow": "\x1b[33m",
+    "blue": "\x1b[34m",
+    "magenta": "\x1b[35",
+    "cyan": "\x1b[36",
+    "white": "\x1b[37m",
+    "gray": "\x1b[90m",
+};
+export const bgColors = {
+    "black": "\x1b[40m",
+    "red": "\x1b[41m",
+    "green": "\x1b[42m",
+    "yellow": "\x1b[43m",
+    "blue": "\x1b[44m",
+    "magenta": "\x1b[45m",
+    "cyan": "\x1b[46m",
+    "white": "\x1b[47m",
+};

package/build/core/formatter.d.ts

@@ -0,0 +1 @@
+export declare function formatMenssage(message: string, prefix: string, color: string, useTimestamp: boolean): string;

package/build/core/formatter.js

@@ -0,0 +1,9 @@
+import { colors, terminalStyle } from "#core";
+import { getTimestamp } from "#utils";
+// Função responsavel por montar a mensagem fatal
+export function formatMenssage(message, prefix, color, useTimestamp) {
+    const time = useTimestamp
+        ? `${colors.gray}[${getTimestamp()}]${terminalStyle.reset}`
+        : "";
+    return `${time}${color}[${prefix}]${terminalStyle.reset} ${message}`;
+}

package/build/core/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./colors.js";
+export * from "./types.js";
+export * from "./formatter.js";
+export * from "./terminalStyle.js";

package/build/core/index.js

@@ -0,0 +1,4 @@
+export * from "./colors.js";
+export * from "./types.js";
+export * from "./formatter.js";
+export * from "./terminalStyle.js";

package/build/core/terminalStyle.d.ts

@@ -0,0 +1,8 @@
+export declare const terminalStyle: {
+    reset: string;
+    negrito: string;
+    fraco: string;
+    italico: string;
+    sublinhado: string;
+    riscado: string;
+};

package/build/core/terminalStyle.js

@@ -0,0 +1,8 @@
+export const terminalStyle = {
+    "reset": "\x1b[0m", // Reseta cor
+    "negrito": "\x1b[1m", // Formata o texto em negrito
+    "fraco": "\x1b[2m",
+    "italico": "\x1b[3m",
+    "sublinhado": "\x1b[4m",
+    "riscado": "\x1b[9m",
+};

package/build/core/types.d.ts

@@ -0,0 +1,7 @@
+export interface ErrorOptions {
+    code?: number;
+    prefix?: string;
+    showStack?: boolean;
+    timestamp?: boolean;
+    error?: unknown;
+}

package/build/core/types.js

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

package/build/functions/error.d.ts

@@ -0,0 +1,2 @@
+import { ErrorOptions } from "#core";
+export declare function error(message: string, options?: ErrorOptions): never;

package/build/functions/error.js

@@ -0,0 +1,19 @@
+// import { colors, formatMenssage } from "#core";
+// // log de erro
+// export function error(message: string): void {
+//     console.error(formatMenssage(message, "ERROR", colors.red, true))
+// }
+import { colors, formatMenssage } from "#core";
+import { defaults } from "#config";
+// função fatal que encerra o processo
+export function error(message, options = {}) {
+    const { code = defaults.code, prefix = "FATAL", showStack = defaults.showStack, timestamp = defaults.timeStamp, error, } = options;
+    // Exibe mensagen formatada
+    console.error(formatMenssage(message, prefix, colors.red, timestamp));
+    // Exibe stack trace se existir
+    if (showStack && error instanceof Error) {
+        console.error(error.stack);
+    }
+    // Encerra o processo
+    process.exit(code);
+}

package/build/functions/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./error.js";
+export * from "./log.js";
+export * from "./success.js";
+export * from "./warn.js";

package/build/functions/index.js

@@ -0,0 +1,4 @@
+export * from "./error.js";
+export * from "./log.js";
+export * from "./success.js";
+export * from "./warn.js";

package/build/functions/log.d.ts

@@ -0,0 +1 @@
+export declare function log(message: string): void;

package/build/functions/log.js

@@ -0,0 +1,5 @@
+import { colors, formatMenssage } from "#core";
+// Log padrão (info)
+export function log(message) {
+    console.log(formatMenssage(message, "INFO", colors.blue, true));
+}

package/build/functions/success.d.ts

@@ -0,0 +1 @@
+export declare function success(message: string): void;

package/build/functions/success.js

@@ -0,0 +1,5 @@
+import { colors, formatMenssage } from "#core";
+// Log de sucesso
+export function success(message) {
+    console.log(formatMenssage(message, "SUCCESS", colors.green, true));
+}

package/build/functions/warn.d.ts

@@ -0,0 +1 @@
+export declare function warn(message: string): void;

package/build/functions/warn.js

@@ -0,0 +1,5 @@
+import { colors, formatMenssage } from "#core";
+// log de aviso
+export function warn(message) {
+    console.log(formatMenssage(message, "WARN", colors.yellow, true));
+}

package/build/index.d.ts

@@ -0,0 +1,38 @@
+declare const logger: {
+    style: {
+        bgColors: {
+            black: string;
+            red: string;
+            green: string;
+            yellow: string;
+            blue: string;
+            magenta: string;
+            cyan: string;
+            white: string;
+        };
+        colors: {
+            black: string;
+            red: string;
+            green: string;
+            yellow: string;
+            blue: string;
+            magenta: string;
+            cyan: string;
+            white: string;
+            gray: string;
+        };
+        terminalStyle: {
+            reset: string;
+            negrito: string;
+            fraco: string;
+            italico: string;
+            sublinhado: string;
+            riscado: string;
+        };
+    };
+    error(message: string, options?: import("#core").ErrorOptions): never;
+    log(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+};
+export default logger;

package/build/index.js

@@ -0,0 +1,11 @@
+import * as functions from "#functions";
+import { bgColors, colors, terminalStyle } from "#core";
+const logger = {
+    ...functions,
+    style: {
+        bgColors,
+        colors,
+        terminalStyle
+    }
+};
+export default logger;

package/build/utils/formatDate.d.ts

@@ -0,0 +1 @@
+export declare function getTimestamp(): string;

package/build/utils/formatDate.js

@@ -0,0 +1,10 @@
+// Retorna data no formato DD/MM/YYYY HH:mm
+export function getTimestamp() {
+    const now = new Date();
+    const day = String(now.getDate()).padStart(2, "0");
+    const month = String(now.getMonth() + 1).padStart(2, "0");
+    const year = now.getFullYear();
+    const hours = String(now.getHours()).padStart(2, "0");
+    const minutes = String(now.getMinutes()).padStart(2, "0");
+    return `${day}/${month}/${year} ${hours}:${minutes}`;
+}

package/build/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./formatDate.js";
+export * from "./precess.js";

package/build/utils/index.js

@@ -0,0 +1,2 @@
+export * from "./formatDate.js";
+export * from "./precess.js";

package/build/utils/precess.d.ts

@@ -0,0 +1 @@
+export declare function exitProcess(code: string): never;

package/build/utils/precess.js

@@ -0,0 +1,4 @@
+// wrapper do proces.exit
+export function exitProcess(code) {
+    process.exit(code);
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@helzady/zady",
+  "version": "1.0.0",
+  "description": "um logger simples e poderoso para Node.js, com saídas formatadas no console, tratamento de erros e utilitários focados no desenvolvedor.",
+  "homepage": "https://github.com/HelzadyDev/zady#readme",
+  "bugs": {
+    "url": "https://github.com/HelzadyDev/zady/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HelzadyDev/zady.git"
+  },
+  "license": "MIT",
+  "author": "Helzady",
+  "type": "module",
+  "files": [
+    "build"
+  ],
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "scripts": {
+    "build": "rimraf ./build && tsc",
+    "dev": "tsx ./src/index.ts"
+  },
+  "keywords": [
+    "logger",
+    "log",
+    "console",
+    "nodejs",
+    "utils",
+    "logging",
+    "degub",
+    "error",
+    "terminal",
+    "developer",
+    "cli",
+    "typescript"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3"
+  },
+  "imports": {
+    "#functions": [
+      "./build/functions/index.js"
+    ],
+    "#utils": [
+      "./build/utils/index.js"
+    ],
+    "#core": [
+      "./build/core/index.js"
+    ],
+    "#config": [
+      "./build/config/index.js"
+    ]
+  }
+}