jet-logger 2.2.2 → 3.0.0

package/README.md

@@ -1,12 +1,41 @@
-# Jet-Logger ✈️
+# ✈️🪵 Jet-Logger 
 
-> Super fast, zero-dependency logging for Node.js and TypeScript projects.
+> A super quick, easy to setup TypeScript first logging tool for NodeJS and browsers.
 
 [![npm version](https://img.shields.io/npm/v/jet-logger?logo=npm&label=npm)](https://www.npmjs.com/package/jet-logger)
 [![npm downloads](https://img.shields.io/npm/dm/jet-logger?color=orange)](https://www.npmjs.com/package/jet-logger)
-[![License](https://img.shields.io/npm/l/jet-logger)](https://github.com/seanpmaxwell/jet-logger/blob/master/LICENSE)
+[![License](https://img.shields.io/npm/l/jet-logger)](https://github.com/seanpmaxwell/jet-logger/blob/main/LICENSE)
 [![TypeScript definitions](https://img.shields.io/badge/TypeScript-ready-3178c6?logo=typescript&logoColor=white)](https://www.npmjs.com/package/jet-logger)
 
-Jet-Logger is an easy-to-configure logger that can print to the console, write to disk, or forward events to your own transport. Configure it entirely through environment variables or in code, and get colorized output, timestamps, and JSON log formatting out-of-the-box.
+<p align="center">· · ·</p>
+
+## 👀 Preview
+
+![Four log calls are typed into app.ts, then running it prints four color-coded lines, each starting with the time: a green INFO, an underlined magenta IMPORTANT, a yellow WARNING, and a red ERROR](https://raw.githubusercontent.com/seanpmaxwell/jet-logger/HEAD/assets/demo.gif)
+
+<p align="center">· · ·</p>
+
+## Features ✨
+
+- Works locally and in browsers
+- Zero dependencies, written in TypeScript
+- Configure programmatically or through environment variables
+- Tiny: **8 kB** packed
+- Logs can be sent to the console or a file
+- Both plain-text `line` and `json` (JSON Lines) formats supported
+- Color-coded `info`, `imp`, `warn`, and `err` levels in terminals
+
+<p align="center">· · ·</p>
+
+## 📦 Installation
+
+```bash
+npm install jet-logger
+```
+
+> Requires Node.js 20.16+ or 22.3+. Jet-Logger is an ES module; CommonJS projects can `require()` it on Node.js 20.19+ and 22.12+.
+
+
+<p align="center">· · ·</p>
 
 Please refer to the official <a href="https://github.com/seanpmaxwell/jet-logger">github repo</a> for the most up-to-date documentation.

package/lib/index.d.ts

@@ -0,0 +1,106 @@
+// Generated by dts-bundle-generator v9.5.1
+
+type Enum<O extends BaseTypes> = {
+	[K in keyof O]: O[K] extends string | number ? O[K] : never;
+}[keyof O];
+type BaseTypes = Record<string, number> | Record<string, string>;
+declare const EModes: {
+	readonly CONSOLE: "console";
+	readonly FILE: "file";
+	readonly BROWSER: "browser";
+	readonly CUSTOM: "custom";
+	readonly OFF: "off";
+};
+declare const Modes: {
+	readonly is: (val: unknown) => val is "console" | "file" | "browser" | "custom" | "off";
+	readonly enum: () => {
+		readonly CONSOLE: "console";
+		readonly FILE: "file";
+		readonly BROWSER: "browser";
+		readonly CUSTOM: "custom";
+		readonly OFF: "off";
+	};
+	readonly CONSOLE: "console";
+	readonly FILE: "file";
+	readonly BROWSER: "browser";
+	readonly CUSTOM: "custom";
+	readonly OFF: "off";
+};
+type EModes$1 = typeof EModes;
+type Modes = Enum<EModes$1>;
+declare const EFormats: {
+	readonly LINE: "line";
+	readonly JSON: "json";
+};
+declare const Formats: {
+	readonly is: (val: unknown) => val is "line" | "json";
+	readonly enum: () => {
+		readonly LINE: "line";
+		readonly JSON: "json";
+	};
+	readonly LINE: "line";
+	readonly JSON: "json";
+};
+type EFormats$1 = typeof EFormats;
+type Formats = Enum<EFormats$1>;
+type Labels = "INFO" | "WARNING" | "ERROR" | "IMPORTANT";
+type IOptions = {
+	format: Formats;
+	showTime: boolean;
+	prependTimeToFilename: boolean;
+	filepath: string;
+} & ({
+	mode: Exclude<Modes, "custom">;
+	customTransport: null;
+} | {
+	mode: Modes;
+	customTransport: CustomTransportFn;
+});
+export interface CustomTransportContext {
+	time: string;
+	level: Labels | null;
+	msg: string;
+}
+export interface CustomTransportFn {
+	(context: CustomTransportContext): void | Promise<void>;
+}
+type APIOptions = Partial<IOptions>;
+export type JetLoggerOptions = APIOptions;
+export type JetLoggerInstance = Readonly<{
+	info(...args: unknown[]): void;
+	warn(...args: unknown[]): void;
+	err(...args: unknown[]): void;
+	imp(...args: unknown[]): void;
+	line(): void;
+	out(...args: unknown[]): void;
+	catch(cb: () => unknown): void;
+	flush(): Promise<void>;
+	close(): Promise<void>;
+}>;
+/**
+ * Throw this when the property on an object is invalid.
+ */
+declare class InvalidOptionErr extends Error {
+	readonly property: string;
+	readonly value: unknown;
+	protected constructor(message: string, property: string, value: unknown);
+	/**
+	 * Factory-Function. Setup the message and return a new instance.
+	 */
+	static of(property: string, value: unknown, additionalMsg?: string): InvalidOptionErr;
+}
+interface JetLogger {
+	(options?: JetLoggerOptions): JetLoggerInstance;
+	readonly Modes: EModes$1;
+	readonly Formats: EFormats$1;
+}
+declare const DefaultLogger: JetLoggerInstance;
+declare const JetLogger$1: JetLogger;
+
+export {
+	DefaultLogger as default,
+	InvalidOptionErr as InvalidOptionError,
+	JetLogger$1 as JetLogger,
+};
+
+export {};

package/lib/index.js

@@ -0,0 +1,12 @@
+function gt(t){return typeof t=="boolean"}function ht(t){return typeof t=="number"}function wt(t){return typeof t=="string"}function St(t){return typeof t=="string"&&t.length>0}function yt(t){return t!==void 0}function Et(t){return typeof t=="object"&&t!==null}function Tt(t){return typeof t=="function"}function Ot(t){return t===null||typeof t=="function"}function Lt(t){if(typeof t=="boolean")return t;if(typeof t=="string"){let e=t.toLowerCase();if(e==="true")return!0;if(e==="false")return!1}}var c={is:{def:yt,bool:gt,num:ht,str:wt,neStr:St,obj:Et,fn:Tt,nul:{fn:Ot}},parse:{bool:Lt}};function v(t){let e=Object.values(t);e=e.filter(n=>c.is.str(n)||c.is.num(n));let o=new Set(e);return{is:n=>o.has(n),enum:()=>({...t})}}var U={CONSOLE:"console",FILE:"file",BROWSER:"browser",CUSTOM:"custom",OFF:"off"},p={...U,...v(U)},Y={LINE:"line",JSON:"json"},f={...Y,...v(Y)};var K=/^\s+at /;function M(t){return t instanceof Error?t.message:String(t)}function z(t){if(!t.stack)return;let e=t.stack.split(`
+`),o=e.findIndex(s=>K.test(s));return(o>=0?e.slice(o):e).map(s=>s.trim()).filter(s=>s!=="")}function L(t){let e=String(t),{stack:o}=t;return o?o.startsWith(e)||o.split(`
+`).some(r=>K.test(r))?o:`${e}
+${o}`:e}function bt(t,e,o){let r=i=>{try{e(i)}catch{}},s;try{s=t()}catch(i){return r(i)}if(!Ft(s))return;let n=Promise.resolve(s).then(void 0,r).finally(()=>o?.delete(n));o?.add(n)}function Ft(t){return(typeof t=="object"||typeof t=="function")&&t!==null&&typeof t.then=="function"}var O=bt;function xt(t,e){let o=[],r=function(s,n){for(;o.length>0&&o[o.length-1].holder!==this;)o.pop();if(typeof n=="bigint")return`${n}n`;if(typeof n!="object"||n===null)return n;if(o.some(l=>l.original===n))return"[Circular]";let i=kt(n);return o.push({holder:i,original:n}),i};try{return JSON.stringify(t,r,e)??String(t)}catch{return String(t)}}function kt(t){return t instanceof Error?{name:t.name,message:t.message,stack:t.stack}:t instanceof Map||t instanceof Set?Array.from(t):t}var b=xt;var It="Node.js built-in modules aren't available in this environment";function Rt(){let t=globalThis.process;if(typeof t?.getBuiltinModule!="function")return{IS_BROWSER:!0,IS_LOCAL:!1,nodeModules:()=>{throw new Error(It)}};let e={fs:t.getBuiltinModule("fs"),path:t.getBuiltinModule("path"),util:t.getBuiltinModule("util")};return{IS_BROWSER:!1,IS_LOCAL:!0,nodeModules:()=>e}}var a=Rt();var Pt=(()=>{if(a.IS_LOCAL){let{util:t}=a.nodeModules();return(e,o)=>t.inspect(e,{depth:null,colors:o})}return t=>t instanceof Error?L(t):b(t,2)})(),V=Pt;function vt(t,e){return t.map(o=>c.is.str(o)?o:c.is.obj(o)?V(o,e):String(o)).join(" ")}var m=vt;var Mt={Green:{SGR:"32",CSS:"color: #008000"},LightGreen:{SGR:"2;32",CSS:"color: #006B00"},Yellow:{SGR:"33",CSS:"color: #DAA520"},Red:{SGR:"31",CSS:"color: #FF0000"},Magenta:{SGR:"35",CSS:"color: #FF00FF"},White:{SGR:"38;5;248",CSS:"color: #808080"}},w=Mt;var Ct={Bold:{SGR:"1",CSS:"font-weight: bold"},Underline:{SGR:"4",CSS:"text-decoration: underline"}},C=Ct;var X="\x1B[0m",F=S(w.LightGreen),x=S(w.White),y={Info:{label:"INFO",consoleFn:"info",...S(w.Green)},Important:{label:"IMPORTANT",consoleFn:"info",...S(w.Magenta,C.Bold,C.Underline)},Warning:{label:"WARNING",consoleFn:"warn",...S(w.Yellow)},Error:{label:"ERROR",consoleFn:"error",...S(w.Red)}};function S(...t){return{ansi:`\x1B[${t.map(e=>e.SGR).join(";")}m`,css:t.map(e=>e.CSS).join("; ")}}var k=t=>t,q=(t,e)=>`${e.ansi}${t}${X}`;function I(t,e){let{level:o,args:r}=t,{showTime:s,showDate:n,paint:i}=e,l=i(o.label,o),u=i(m(r,!1),x);return s?`${i(N(n),F)} ${l}: ${u}`:`${l}: ${u}`}function N(t,e=new Date){let o=E(e.getHours()),r=E(e.getMinutes()),s=E(e.getSeconds()),n=E(e.getMilliseconds(),3),i=`${o}:${r}:${s}.${n}`;if(!t)return`[${i}]`;let l=e.getFullYear(),u=E(e.getMonth()+1),h=E(e.getDate());return`[${l}-${u}-${h} ${i}]`}function E(t,e=2){return String(t).padStart(e,"0")}function T(t,e){let o=[],r=[],s;for(let u of t.args)u instanceof Error&&!s?(s=u,o.push(u.message)):typeof u=="object"&&u!==null?r.push(u):o.push(String(u));let n=t.level.label,i=o.join(" "),l=e?{time:new Date().toISOString(),level:n,msg:i}:{level:n,msg:i};return r.length>0&&(l.data=r.length===1?r[0]:r),s&&(l.stack=z(s)),b(l)}function Q(t,e){let o=e instanceof Error?L(e):String(e),r=`jet-logger: ${t}: ${o}`;a.IS_LOCAL?process.stderr.write(r+`
+`):console.error(r)}var A=class t{#t;constructor(e){this.#t=e}static of(e){let{format:o,showTime:r}=e;return o===f.JSON?new t(s=>["%s",T(s,r)]):new t(s=>Nt(s,r))}writeLog(e){let o=this.#t(e);console[e.level.consoleFn](...o)}writeRaw(e){let o=m(e,!1);console.info("%s",o)}flush(){return Promise.resolve()}close(){return Promise.resolve()}};function Nt(t,e){let{level:o,args:r}=t,s=m(r,!1),n=[o.css,o.label,x.css,s];return e?["%c%s %c%s: %c%s",...[F.css,N(!1)],...n]:["%c%s: %c%s",...n]}var Z=A;var J=class t{#t;#e;#o;constructor(e){this.#t=e,this.#e=tt(process.stdout),this.#o=tt(process.stderr)}static of(e){let{format:o,showTime:r}=e;return o===f.JSON?new t(s=>T(s,r)):new t((s,n)=>I(s,{showTime:r,showDate:!1,paint:n?q:k}))}writeLog(e){if(e.level.consoleFn==="info"){let o=this.#t(e,this.#e);process.stdout.write(o+`
+`)}else{let o=this.#t(e,this.#o);process.stderr.write(o+`
+`)}}writeRaw(e){let o=m(e,this.#e);process.stdout.write(o+`
+`)}async flush(){let e=et(process.stdout),o=et(process.stderr);await Promise.all([e,o])}close(){return this.flush()}};function tt(t){let{FORCE_COLOR:e,NO_COLOR:o}=process.env;if(e!==void 0){let r=e.toLowerCase();return!["0","false"].includes(r)}return o?!1:t.isTTY===!0&&(t.hasColors?.()??!0)}function et(t){return new Promise(e=>t.write("",()=>e()))}var ot=J;function At(t,e){let{path:o}=a.nodeModules(),r=o.parse(t);return o.format({...r,base:void 0,ext:"."+e})}var nt=At;function Jt(t,e=new Date){let{path:o}=a.nodeModules(),r=o.parse(t),s=`${_t(e)}_${r.base}`;return o.format({...r,base:s})}function _t(t){return t.toISOString().replace(/[-:]/g,"").replace(/\.\d{3}/,"")}var rt=Jt;var _="jet-logger.log",R=()=>({mode:p.CONSOLE,format:f.LINE,filepath:_,prependTimeToFilename:!1,showTime:!0,customTransport:null});var Wt=["SIGINT","SIGTERM"],st=!1,W=new Set;function it(t){W.add(t),!st&&(st=!0,process.on("exit",ut),Wt.forEach(e=>process.on(e,lt)))}function lt(t){ut(),!(process.listenerCount(t)>1)&&(process.off(t,lt),process.kill(process.pid,t))}function ut(){W.forEach(t=>t.flushSync())}function at(t){W.delete(t)}var Gt=1e3;function jt(t,e){let{fs:o}=a.nodeModules(),r=0;for(;e.length>0;)try{e=e.subarray(o.writeSync(t,e)),r=0}catch(s){if(!(s.code==="EAGAIN")||++r>Gt)throw s;Bt(1)}}function Bt(t){Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,t)}var ct=jt;var $t=2,Dt=64*1024,G=new Map,j=class t{#t;#e;#o="";#n;#r=0;constructor(e,o){this.#t=e,this.#e=o}static open(e){let{fs:o,path:r}=a.nodeModules(),s=r.resolve(e),n=G.get(s);if(!n){o.mkdirSync(r.dirname(s),{recursive:!0});let i=o.openSync(s,"a");n=new t(s,i),G.set(s,n),it(n)}return n.#r++,n}write(e){this.#o+=e,this.#o.length>=Dt?this.flushSync():this.#n??=setImmediate(()=>this.flushSync())}flush(){return this.flushSync(),Promise.resolve()}flushSync(){if(this.#n&&(clearImmediate(this.#n),this.#n=void 0),this.#o.length===0)return;let e=this.#o;this.#o="",Ht(this.#e,e)}async release(){await this.flush(),this.#r--,!(this.#r>0)&&(G.delete(this.#t),at(this),a.nodeModules().fs.closeSync(this.#e))}};function Ht(t,e){try{ct(t,Buffer.from(e,"utf8"))}catch(o){Ut(o)}}function Ut(t){let e=t instanceof Error?t.message:String(t);try{a.nodeModules().fs.writeSync($t,`jet-logger: file write failed: ${e}
+`)}catch{}}var ft=j;var B=class t{#t;#e;constructor(e,o){this.#t=e,this.#e=o}static of(e){let{format:o,showTime:r}=e,s=Yt(e),n=ft.open(s);return o===f.JSON?new t(n,i=>T(i,r)):new t(n,i=>I(i,{showTime:r,showDate:!0,paint:k}))}writeLog(e){this.#t.write(this.#e(e)+`
+`)}writeRaw(e){this.#t.write(m(e,!1)+`
+`)}flush(){return this.#t.flush()}close(){return this.#t.release()}};function Yt(t){let{filepath:e}=t;return t.format===f.JSON&&Kt(e)&&(e=nt(e,"jsonl")),t.prependTimeToFilename&&(e=rt(e)),e}function Kt(t){let{path:e}=a.nodeModules();return e.basename(t)===_}var pt=B;function zt(){let t=globalThis.process?.env;if(!t)return{};let{JET_LOGGER_MODE:e,JET_LOGGER_FILEPATH:o,JET_LOGGER_PREPEND_TIME_TO_FILENAME:r,JET_LOGGER_SHOW_TIME:s,JET_LOGGER_FORMAT:n}=t,i={},l=e?.toLowerCase();p.is(l)&&(i.mode=l),c.is.neStr(o)&&(i.filepath=o);let u=c.parse.bool(r);c.is.def(u)&&(i.prependTimeToFilename=u);let h=c.parse.bool(s);c.is.def(h)&&(i.showTime=h);let H=n?.toLowerCase();return f.is(H)&&(i.format=H),i}var mt=zt;var $=class t extends Error{property;value;constructor(e,o,r){super(e),this.name="InvalidOptionError",this.property=o,this.value=r}static of(e,o,r){let s=`Invalid option "${e}": ${Vt(o)}`;return r&&(s+=`. ${r}`),new t(s,e,o)}};function Vt(t){if(typeof t=="function")return`[Function ${t.name||"anonymous"}]`;try{return JSON.stringify(t)??String(t)}catch{return String(t)}}var d=$;var Xt='The mode is set to "custom". The "customTransport" must be a valid function type.',qt=Object.keys(R()),Qt=new Set(qt);function Zt(t){if(typeof t!="object"||t===null)throw d.of("options",t);for(let[l,u]of Object.entries(t))if(!Qt.has(l))throw d.of(l,u,"Unknown option");let{mode:e,format:o,showTime:r,prependTimeToFilename:s,filepath:n,customTransport:i}=t;if(!p.is(e))throw d.of("mode",e);if(!f.is(o))throw d.of("format",o);if(!c.is.bool(r))throw d.of("showTime",r);if(!c.is.bool(s))throw d.of("prependTimeToFilename",s);if(!c.is.neStr(n))throw d.of("filepath",n);if(!c.is.nul.fn(i))throw d.of("customTransport",i);if(e===p.CUSTOM&&!c.is.fn(i))throw d.of("customTransport",i,Xt)}var dt=Zt;function te(t){let e={...R(),...mt(),...se(t)};return dt(e),e.mode===p.OFF?ne():e.mode===p.CUSTOM?re(e.customTransport):ee(e)}function ee(t){let e=oe(t),o=new Set,r=!1,s,n=(i,l)=>{r||e.writeLog({level:i,args:l})};return{info:(...i)=>n(y.Info,i),warn:(...i)=>n(y.Warning,i),imp:(...i)=>n(y.Important,i),err:(...i)=>n(y.Error,i),line:()=>{r||e.writeRaw([])},out:(...i)=>{r||e.writeRaw(i)},catch:i=>{O(i,u=>n(y.Error,[M(u)]),o)},flush:async()=>{await P(o),await e.flush()},close:()=>s??=(async()=>{await P(o),r=!0,await e.close()})()}}function oe(t){return a.IS_BROWSER||t.mode===p.BROWSER?Z.of(t):t.mode===p.FILE?pt.of(t):ot.of(t)}function ne(){let t=()=>{};return{info:t,warn:t,imp:t,err:t,line:t,out:t,catch:e=>O(e,t),flush:()=>Promise.resolve(),close:()=>Promise.resolve()}}function re(t){let e=new Set,o=!1,r,s=(n,i)=>{if(o)return;let l={time:new Date().toISOString(),level:n,msg:m(i,!1)};O(()=>t(l),h=>Q("customTransport failed",h),e)};return{info:(...n)=>s("INFO",n),warn:(...n)=>s("WARNING",n),imp:(...n)=>s("IMPORTANT",n),err:(...n)=>s("ERROR",n),line:()=>s(null,[`
+`]),out:(...n)=>s(null,n),catch:n=>{O(n,l=>s("ERROR",[M(l)]),e)},flush:()=>P(e),close:()=>r??=P(e).then(()=>{o=!0})}}function se(t){if(!t)return{};let e=Object.entries(t).filter(([,o])=>o!==void 0);return Object.fromEntries(e)}async function P(t){for(;t.size>0;)await Promise.all(t)}var D=te;var ie=Object.assign(D,{Modes:p.enum(),Formats:f.enum()}),le,g=()=>le??=D(),ue=Object.freeze({info:(...t)=>g().info(...t),warn:(...t)=>g().warn(...t),err:(...t)=>g().err(...t),imp:(...t)=>g().imp(...t),line:()=>g().line(),out:(...t)=>g().out(...t),catch:t=>g().catch(t),flush:()=>g().flush(),close:()=>g().close()}),Uo=ie,Yo=ue;export{d as InvalidOptionError,Uo as JetLogger,Yo as default};

package/package.json

@@ -1,31 +1,43 @@
 {
   "name": "jet-logger",
-  "version": "2.2.2",
-  "description": "A super quick, easy to setup logging tool for NodeJS/TypeScript.",
+  "version": "3.0.0",
+  "description": "A super quick, easy to setup TypeScript first logging tool for NodeJS and browsers.",
   "type": "module",
-  "main": "./dist/cjs/index.js",
-  "module": "./dist/esm/index.js",
-  "browser": "./dist/esm/index.js",
-  "types": "./dist/types/index.d.ts",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js",
-      "types": "./dist/types/index.d.ts"
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
     }
   },
   "files": [
-    "dist"
+    "lib"
   ],
+  "engines": {
+    "node": ">=20.16.0 <21 || >=22.3.0"
+  },
   "scripts": {
-    "build": "rm -rf ./dist && tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json && tsc -p tsconfig.types.json",
-    "clean-install": "rm -rf ./node_modules && rm -r package-lock.json && npm i",
-    "lint": "eslint .",
-    "format": "eslint --fix .",
-    "playground": "tsx ./test/playground.ts",
-    "pre-publish": "mv README.md README-git && mv README-npm README.md",
-    "post-publish": "mv README.md README-npm && mv README-git README.md",
-    "test": "NODE_ENV=test vitest"
+    "benchmark": "tsx scripts/benchmark.ts",
+    "build": "tsx scripts/build.ts",
+    "commit": "npm run format && git add -A && git commit -m \"dev commit\"",
+    "commit:push": "npm run commit && git push",
+    "demo:gif": "bash demo-studio/start.sh",
+    "install:clean": "rm -rf node_modules && rm -f package-lock.json && npm i",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "npm-data": "npm run build && npm pack --dry-run --json",
+    "prepack": "npm run readme:swap",
+    "prepublishOnly": "npm run build && tsc && npm run lint && npm run format:check && npm test && npm run test:browser && npm run verify:package",
+    "postpack": "npm run readme:restore",
+    "readme:swap": "tsx scripts/readme.ts swap",
+    "readme:restore": "tsx scripts/readme.ts restore",
+    "test": "vitest run",
+    "test:browser": "vitest run --config vitest.browser.config.ts",
+    "typecheck": "tsc",
+    "verify:package": "tsx scripts/verifyPackage.ts"
   },
   "repository": {
     "type": "git",
@@ -58,23 +70,24 @@
     "url": "https://github.com/seanpmaxwell/jet-logger/issues"
   },
   "homepage": "https://github.com/seanpmaxwell/jet-logger#readme",
-  "dependencies": {
-    "colors": "1.4.0"
-  },
   "devDependencies": {
-    "@eslint/js": "^9.26.0",
-    "@stylistic/eslint-plugin": "^5.6.1",
-    "@trivago/prettier-plugin-sort-imports": "^6.0.1",
-    "@types/node": "^22.8.1",
-    "eslint": "^9.26.0",
+    "@eslint/js": "^10.0.1",
+    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
+    "@types/node": "^20.19.43",
+    "@vitest/browser": "^4.1.11",
+    "@vitest/browser-playwright": "^4.1.11",
+    "chalk": "^6.0.0",
+    "dts-bundle-generator": "^9.5.1",
+    "esbuild": "^0.28.2",
+    "eslint": "^10.7.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-n": "^17.17.0",
-    "eslint-plugin-prettier": "^5.5.4",
-    "jiti": "^2.3.3",
-    "prettier": "^3.7.4",
-    "typescript": "~5.9.3",
-    "tsx": "^4.19.1",
-    "typescript-eslint": "^8.50.0",
-    "vitest": "^4.0.15"
+    "globals": "^17.7.0",
+    "jiti": "^2.7.0",
+    "playwright": "^1.63.0",
+    "prettier": "^3.9.5",
+    "tsx": "^4.23.11",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.65.0",
+    "vitest": "^4.1.10"
   }
 }

package/dist/cjs/index.js

@@ -1 +0,0 @@
-export { JetLogger, jetLogger, default, } from './jetLogger.js';

package/dist/cjs/jetLogger.js

@@ -1,219 +0,0 @@
-import colors from 'colors';
-import fs from 'fs';
-import util from 'util';
-const LOGGER_MODES = {
-    Console: 'CONSOLE',
-    File: 'FILE',
-    Custom: 'CUSTOM',
-    Off: 'OFF',
-};
-const FORMATS = {
-    Line: 'LINE',
-    Json: 'JSON',
-};
-const LEVELS = {
-    Info: {
-        Color: 'green',
-        Prefix: 'INFO',
-    },
-    Important: {
-        Color: 'magenta',
-        Prefix: 'IMPORTANT',
-    },
-    Warning: {
-        Color: 'yellow',
-        Prefix: 'WARNING',
-    },
-    Error: {
-        Color: 'red',
-        Prefix: 'ERROR',
-    },
-};
-const DEFAULTS = {
-    mode: LOGGER_MODES.Console,
-    filePath: 'jet-logger.log',
-    timestamp: true,
-    format: FORMATS.Line,
-    customLogFn: () => ({}),
-};
-const Errors = {
-    CustomLogger: 'Custom logger mode set to true, but no custom logger was provided.',
-    Mode: 'The correct logger mode was not specified: Must be "CUSTOM", "FILE", ' +
-        '"OFF", or "CONSOLE".',
-};
-export const JetLogger = {
-    Modes: LOGGER_MODES,
-    Formats: FORMATS,
-};
-export function jetLogger(options) {
-    let mode = DEFAULTS.mode, filePath = DEFAULTS.filePath, timestamp = DEFAULTS.timestamp, format = DEFAULTS.format, customLogFn = DEFAULTS.customLogFn;
-    if (options?.mode !== undefined) {
-        mode = options.mode;
-    }
-    else if (!!process.env.JET_LOGGER_MODE) {
-        mode = process.env.JET_LOGGER_MODE.toUpperCase();
-    }
-    if (mode === LOGGER_MODES.Off) {
-        return {
-            info: (_, __) => ({}),
-            imp: (_, __) => ({}),
-            warn: (_, __) => ({}),
-            err: (_, __) => ({}),
-        };
-    }
-    if (mode === LOGGER_MODES.Custom) {
-        if (options?.customLogger !== undefined) {
-            customLogFn = options.customLogger;
-        }
-        if (!customLogFn) {
-            throw Error(Errors.CustomLogger);
-        }
-        return {
-            info: setupPrintWithCustomLogger(LEVELS.Info, customLogFn),
-            imp: setupPrintWithCustomLogger(LEVELS.Important, customLogFn),
-            warn: setupPrintWithCustomLogger(LEVELS.Warning, customLogFn),
-            err: setupPrintWithCustomLogger(LEVELS.Error, customLogFn),
-        };
-    }
-    if (options?.filepath !== undefined) {
-        filePath = options.filepath;
-    }
-    else if (!!process.env.JET_LOGGER_FILEPATH) {
-        filePath = process.env.JET_LOGGER_FILEPATH;
-    }
-    if (options?.timestamp !== undefined) {
-        timestamp = options.timestamp;
-    }
-    else if (!!process.env.JET_LOGGER_TIMESTAMP) {
-        const envVar = process.env.JET_LOGGER_TIMESTAMP;
-        timestamp = envVar.toUpperCase() === 'TRUE';
-    }
-    if (options?.format !== undefined) {
-        format = options.format;
-    }
-    else if (!!process.env.JET_LOGGER_FORMAT) {
-        format = process.env.JET_LOGGER_FORMAT.toUpperCase();
-    }
-    let formatter = () => '';
-    if (format === FORMATS.Line) {
-        formatter = setupLineFormatter(timestamp);
-    }
-    else if (format === FORMATS.Json) {
-        formatter = setupJsonFormatter(timestamp);
-    }
-    if (mode === LOGGER_MODES.File) {
-        let filePathDatetime = true;
-        if (options?.filepathDatetimeParam !== undefined) {
-            filePathDatetime = options.filepathDatetimeParam;
-        }
-        else if (!!process.env.JET_LOGGER_FILEPATH_DATETIME) {
-            const envVar = process.env.JET_LOGGER_FILEPATH_DATETIME;
-            filePathDatetime = envVar.toUpperCase() === 'TRUE';
-        }
-        if (filePathDatetime) {
-            filePath = addDatetimeToFileName(filePath);
-        }
-        return {
-            info: setupPrintToFile(LEVELS.Info, formatter, filePath),
-            imp: setupPrintToFile(LEVELS.Important, formatter, filePath),
-            warn: setupPrintToFile(LEVELS.Warning, formatter, filePath),
-            err: setupPrintToFile(LEVELS.Error, formatter, filePath),
-        };
-    }
-    return {
-        info: setupPrintToConsole(LEVELS.Info, formatter),
-        imp: setupPrintToConsole(LEVELS.Important, formatter),
-        warn: setupPrintToConsole(LEVELS.Warning, formatter),
-        err: setupPrintToConsole(LEVELS.Error, formatter),
-    };
-}
-function setupPrintWithCustomLogger(level, customLogFn) {
-    return (content, printFull) => {
-        let contentNew;
-        if (printFull) {
-            contentNew = util.inspect(content);
-        }
-        else {
-            contentNew = String(content);
-        }
-        return customLogFn(new Date(), level.Prefix, contentNew);
-    };
-}
-function setupLineFormatter(timestamp) {
-    if (timestamp) {
-        return (content, level) => {
-            const contentNew = level.Prefix + ': ' + content, time = '[' + new Date().toISOString() + '] ';
-            return time + contentNew;
-        };
-    }
-    else {
-        return (content, level) => {
-            return level.Prefix + ': ' + content;
-        };
-    }
-}
-function setupJsonFormatter(timestamp) {
-    if (timestamp) {
-        return (content, level) => {
-            const json = {
-                level: level.Prefix,
-                message: content,
-            };
-            json.timestamp = new Date().toISOString();
-            return JSON.stringify(json);
-        };
-    }
-    else {
-        return (content, level) => {
-            const json = {
-                level: level.Prefix,
-                message: content,
-            };
-            return JSON.stringify(json);
-        };
-    }
-}
-function setupPrintToFile(level, formatter, filePath) {
-    return (content, printFull) => {
-        let contentNew;
-        if (!!printFull) {
-            contentNew = util.inspect(content);
-        }
-        else {
-            contentNew = String(content);
-        }
-        contentNew = formatter(contentNew, level);
-        fs.appendFile(filePath, contentNew, (err) => {
-            if (!!err) {
-                console.error(err);
-            }
-        });
-    };
-}
-function setupPrintToConsole(level, formatter) {
-    return (content, printFull) => {
-        let contentNew;
-        if (!!printFull) {
-            contentNew = util.inspect(content);
-        }
-        else {
-            contentNew = String(content);
-        }
-        const colorFn = colors[level.Color];
-        contentNew = formatter(contentNew, level);
-        console.log(colorFn(contentNew));
-    };
-}
-function addDatetimeToFileName(filePath) {
-    const dateStr = new Date()
-        .toISOString()
-        .split('-')
-        .join('')
-        .split(':')
-        .join('')
-        .slice(0, 15);
-    const filePathArr = filePath.split('/'), lastIdx = filePathArr.length - 1, fileName = filePathArr[lastIdx], fileNameNew = dateStr + '_' + fileName;
-    filePathArr[lastIdx] = fileNameNew;
-    return filePathArr.join('/');
-}
-export default jetLogger();

package/dist/esm/index.js

@@ -1 +0,0 @@
-export { JetLogger, jetLogger, default, } from './jetLogger.js';

package/dist/esm/jetLogger.js

@@ -1,219 +0,0 @@
-import colors from 'colors';
-import fs from 'fs';
-import util from 'util';
-const LOGGER_MODES = {
-    Console: 'CONSOLE',
-    File: 'FILE',
-    Custom: 'CUSTOM',
-    Off: 'OFF',
-};
-const FORMATS = {
-    Line: 'LINE',
-    Json: 'JSON',
-};
-const LEVELS = {
-    Info: {
-        Color: 'green',
-        Prefix: 'INFO',
-    },
-    Important: {
-        Color: 'magenta',
-        Prefix: 'IMPORTANT',
-    },
-    Warning: {
-        Color: 'yellow',
-        Prefix: 'WARNING',
-    },
-    Error: {
-        Color: 'red',
-        Prefix: 'ERROR',
-    },
-};
-const DEFAULTS = {
-    mode: LOGGER_MODES.Console,
-    filePath: 'jet-logger.log',
-    timestamp: true,
-    format: FORMATS.Line,
-    customLogFn: () => ({}),
-};
-const Errors = {
-    CustomLogger: 'Custom logger mode set to true, but no custom logger was provided.',
-    Mode: 'The correct logger mode was not specified: Must be "CUSTOM", "FILE", ' +
-        '"OFF", or "CONSOLE".',
-};
-export const JetLogger = {
-    Modes: LOGGER_MODES,
-    Formats: FORMATS,
-};
-export function jetLogger(options) {
-    let mode = DEFAULTS.mode, filePath = DEFAULTS.filePath, timestamp = DEFAULTS.timestamp, format = DEFAULTS.format, customLogFn = DEFAULTS.customLogFn;
-    if (options?.mode !== undefined) {
-        mode = options.mode;
-    }
-    else if (!!process.env.JET_LOGGER_MODE) {
-        mode = process.env.JET_LOGGER_MODE.toUpperCase();
-    }
-    if (mode === LOGGER_MODES.Off) {
-        return {
-            info: (_, __) => ({}),
-            imp: (_, __) => ({}),
-            warn: (_, __) => ({}),
-            err: (_, __) => ({}),
-        };
-    }
-    if (mode === LOGGER_MODES.Custom) {
-        if (options?.customLogger !== undefined) {
-            customLogFn = options.customLogger;
-        }
-        if (!customLogFn) {
-            throw Error(Errors.CustomLogger);
-        }
-        return {
-            info: setupPrintWithCustomLogger(LEVELS.Info, customLogFn),
-            imp: setupPrintWithCustomLogger(LEVELS.Important, customLogFn),
-            warn: setupPrintWithCustomLogger(LEVELS.Warning, customLogFn),
-            err: setupPrintWithCustomLogger(LEVELS.Error, customLogFn),
-        };
-    }
-    if (options?.filepath !== undefined) {
-        filePath = options.filepath;
-    }
-    else if (!!process.env.JET_LOGGER_FILEPATH) {
-        filePath = process.env.JET_LOGGER_FILEPATH;
-    }
-    if (options?.timestamp !== undefined) {
-        timestamp = options.timestamp;
-    }
-    else if (!!process.env.JET_LOGGER_TIMESTAMP) {
-        const envVar = process.env.JET_LOGGER_TIMESTAMP;
-        timestamp = envVar.toUpperCase() === 'TRUE';
-    }
-    if (options?.format !== undefined) {
-        format = options.format;
-    }
-    else if (!!process.env.JET_LOGGER_FORMAT) {
-        format = process.env.JET_LOGGER_FORMAT.toUpperCase();
-    }
-    let formatter = () => '';
-    if (format === FORMATS.Line) {
-        formatter = setupLineFormatter(timestamp);
-    }
-    else if (format === FORMATS.Json) {
-        formatter = setupJsonFormatter(timestamp);
-    }
-    if (mode === LOGGER_MODES.File) {
-        let filePathDatetime = true;
-        if (options?.filepathDatetimeParam !== undefined) {
-            filePathDatetime = options.filepathDatetimeParam;
-        }
-        else if (!!process.env.JET_LOGGER_FILEPATH_DATETIME) {
-            const envVar = process.env.JET_LOGGER_FILEPATH_DATETIME;
-            filePathDatetime = envVar.toUpperCase() === 'TRUE';
-        }
-        if (filePathDatetime) {
-            filePath = addDatetimeToFileName(filePath);
-        }
-        return {
-            info: setupPrintToFile(LEVELS.Info, formatter, filePath),
-            imp: setupPrintToFile(LEVELS.Important, formatter, filePath),
-            warn: setupPrintToFile(LEVELS.Warning, formatter, filePath),
-            err: setupPrintToFile(LEVELS.Error, formatter, filePath),
-        };
-    }
-    return {
-        info: setupPrintToConsole(LEVELS.Info, formatter),
-        imp: setupPrintToConsole(LEVELS.Important, formatter),
-        warn: setupPrintToConsole(LEVELS.Warning, formatter),
-        err: setupPrintToConsole(LEVELS.Error, formatter),
-    };
-}
-function setupPrintWithCustomLogger(level, customLogFn) {
-    return (content, printFull) => {
-        let contentNew;
-        if (printFull) {
-            contentNew = util.inspect(content);
-        }
-        else {
-            contentNew = String(content);
-        }
-        return customLogFn(new Date(), level.Prefix, contentNew);
-    };
-}
-function setupLineFormatter(timestamp) {
-    if (timestamp) {
-        return (content, level) => {
-            const contentNew = level.Prefix + ': ' + content, time = '[' + new Date().toISOString() + '] ';
-            return time + contentNew;
-        };
-    }
-    else {
-        return (content, level) => {
-            return level.Prefix + ': ' + content;
-        };
-    }
-}
-function setupJsonFormatter(timestamp) {
-    if (timestamp) {
-        return (content, level) => {
-            const json = {
-                level: level.Prefix,
-                message: content,
-            };
-            json.timestamp = new Date().toISOString();
-            return JSON.stringify(json);
-        };
-    }
-    else {
-        return (content, level) => {
-            const json = {
-                level: level.Prefix,
-                message: content,
-            };
-            return JSON.stringify(json);
-        };
-    }
-}
-function setupPrintToFile(level, formatter, filePath) {
-    return (content, printFull) => {
-        let contentNew;
-        if (!!printFull) {
-            contentNew = util.inspect(content);
-        }
-        else {
-            contentNew = String(content);
-        }
-        contentNew = formatter(contentNew, level);
-        fs.appendFile(filePath, contentNew, (err) => {
-            if (!!err) {
-                console.error(err);
-            }
-        });
-    };
-}
-function setupPrintToConsole(level, formatter) {
-    return (content, printFull) => {
-        let contentNew;
-        if (!!printFull) {
-            contentNew = util.inspect(content);
-        }
-        else {
-            contentNew = String(content);
-        }
-        const colorFn = colors[level.Color];
-        contentNew = formatter(contentNew, level);
-        console.log(colorFn(contentNew));
-    };
-}
-function addDatetimeToFileName(filePath) {
-    const dateStr = new Date()
-        .toISOString()
-        .split('-')
-        .join('')
-        .split(':')
-        .join('')
-        .slice(0, 15);
-    const filePathArr = filePath.split('/'), lastIdx = filePathArr.length - 1, fileName = filePathArr[lastIdx], fileNameNew = dateStr + '_' + fileName;
-    filePathArr[lastIdx] = fileNameNew;
-    return filePathArr.join('/');
-}
-export default jetLogger();

package/dist/types/index.d.ts

@@ -1 +0,0 @@
-export { type CustomLogger, JetLogger, jetLogger, default, } from './jetLogger.js';

package/dist/types/jetLogger.d.ts

@@ -1,62 +0,0 @@
-/******************************************************************************
-                                 Constants
-******************************************************************************/
-declare const LOGGER_MODES: {
-    readonly Console: "CONSOLE";
-    readonly File: "FILE";
-    readonly Custom: "CUSTOM";
-    readonly Off: "OFF";
-};
-declare const FORMATS: {
-    readonly Line: "LINE";
-    readonly Json: "JSON";
-};
-export declare const JetLogger: {
-    readonly Modes: {
-        readonly Console: "CONSOLE";
-        readonly File: "FILE";
-        readonly Custom: "CUSTOM";
-        readonly Off: "OFF";
-    };
-    readonly Formats: {
-        readonly Line: "LINE";
-        readonly Json: "JSON";
-    };
-};
-/******************************************************************************
-                                  Types
-******************************************************************************/
-type LoggerModes = (typeof LOGGER_MODES)[keyof typeof LOGGER_MODES];
-type Formats = (typeof FORMATS)[keyof typeof FORMATS];
-type LogFunction = (content: unknown, printFull?: boolean) => void;
-export type CustomLogger = (timestamp: Date, prefix: string, content: unknown) => void;
-interface Options {
-    mode?: LoggerModes;
-    filepath?: string;
-    filepathDatetimeParam?: boolean;
-    timestamp?: boolean;
-    format?: Formats;
-    customLogger?: CustomLogger;
-}
-/******************************************************************************
-                               Functions
-******************************************************************************/
-/**
- * Default function
- */
-export declare function jetLogger(options?: Options): {
-    readonly info: LogFunction;
-    readonly imp: LogFunction;
-    readonly warn: LogFunction;
-    readonly err: LogFunction;
-};
-/******************************************************************************
-                                  Export
-******************************************************************************/
-declare const _default: {
-    readonly info: LogFunction;
-    readonly imp: LogFunction;
-    readonly warn: LogFunction;
-    readonly err: LogFunction;
-};
-export default _default;