jet-logger 2.2.3 → 3.0.1

package/README.md

@@ -1,12 +1,194 @@
-# 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>
 
-Please refer to the official <a href="https://github.com/seanpmaxwell/jet-logger">github repo</a> for the most up-to-date documentation.
+## 👀 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>
+
+## ⚡ Quick Start
+
+```ts
+import logger from 'jet-logger';
+
+logger.info('Server started on port', 3000);
+logger.imp('Connected to the database');
+logger.warn('Slow response:', { route: '/users', ms: 1200 });
+logger.err('Payment failed:', 'card declined');
+```
+
+With the default options, that prints (colors not shown):
+
+```text
+[14:03:21.045] INFO: hello jet-logger
+[14:03:21.046] IMPORTANT: hello jet-logger
+[14:03:21.046] WARNING: hello jet-logger
+[14:03:21.046] ERROR: hello jet-logger
+```
+
+The default export is a ready-made logger configured from environment variables. To create your own, call `JetLogger()`:
+
+```ts
+import { JetLogger } from 'jet-logger';
+
+const fileLogger = JetLogger({
+  mode: JetLogger.Modes.FILE,
+  filepath: './logs/app.log',
+  format: JetLogger.Formats.JSON,
+});
+
+fileLogger.info('Written to disk');
+```
+
+<p align="center">· · ·</p>
+
+## 📘 Log Methods
+
+| Method          | Description                                                                         |
+| --------------- | ----------------------------------------------------------------------------------- |
+| `info(...args)` | Log at `INFO` level                                                                 |
+| `imp(...args)`  | Log at `IMPORTANT` level                                                            |
+| `warn(...args)` | Log at `WARNING` level (stderr in console mode)                                     |
+| `err(...args)`  | Log at `ERROR` level (stderr in console mode)                                       |
+| `out(...args)`  | Print the arguments as their own line, without a label or timestamp                 |
+| `line()`        | Print an empty line                                                                 |
+| `catch(fn)`     | Call `fn` and log its error message if it throws or returns a rejected promise      |
+| `flush()`       | Returns a promise that resolves once everything logged so far has been written      |
+| `close()`       | Flush, then release the log file. Later calls on this logger are ignored            |
+
+Arguments are joined with a space. Objects are printed in full (`util.inspect` in Node, JSON in the browser).
+
+<p align="center">· · ·</p>
+
+## ⚙️ Configuration
+
+Every option can be passed to `JetLogger()` or set with an environment variable. Options passed in code take priority over environment variables, which take priority over the defaults.
+
+| Option                  | Environment variable                  | Values                                         | Default          |
+| ----------------------- | ------------------------------------- | ---------------------------------------------- | ---------------- |
+| `mode`                  | `JET_LOGGER_MODE`                     | `console`, `file`, `browser`, `custom`, `off`  | `console`        |
+| `format`                | `JET_LOGGER_FORMAT`                   | `line`, `json`                                 | `line`           |
+| `filepath`              | `JET_LOGGER_FILEPATH`                 | Path of the log file (file mode)               | `jet-logger.log` |
+| `prependTimeToFilename` | `JET_LOGGER_PREPEND_TIME_TO_FILENAME` | `true`, `false`                                | `false`          |
+| `showTime`              | `JET_LOGGER_SHOW_TIME`                | `true`, `false`                                | `true`           |
+| `customTransport`       | —                                     | Your function (required when mode is `custom`) | —                |
+
+- `JetLogger.Modes` and `JetLogger.Formats` hold the mode and format values.
+- Environment variables are read when a logger is created. The default logger is created the first time you use it, so variables set after importing (e.g. by a `.env` loader) still apply.
+- Environment values are case-insensitive (except `JET_LOGGER_FILEPATH`); unrecognized values are ignored.
+- Options set to `undefined` use the default. Invalid or unknown options throw an `InvalidOptionError`, which is exported.
+
+---
+
+### Output formats
+
+`line` uses local time. The console shows just the time of day; files also include the date:
+
+```text
+[14:03:21.045] WARNING: something happened               <- console
+[2026-09-24 14:03:21.045] WARNING: something happened    <- file
+```
+
+Colors are used only when the output is a terminal. Set `NO_COLOR` to turn them off or `FORCE_COLOR` to force them on.
+
+`json` writes one object per line with an ISO timestamp in `time`. Text is joined into `msg`, objects go into `data` (an array if there are several), and the first `Error` adds its message to `msg` and its stack frames to `stack`:
+
+```ts
+logger.warn('payment failed:', new Error('card declined'), { orderId: 42 });
+```
+
+```json
+{"time":"2026-09-25T01:04:01.247Z","level":"WARNING","msg":"payment failed: card declined","data":{"orderId":42},"stack":["at charge (/app/pay.js:10:11)"]}
+```
+
+`line` prints messages as-is, so text from users could add fake log lines or terminal escape codes. Use `json` for untrusted input; its values are escaped.
+
+---
+
+### File mode
+
+- Logs are appended to `filepath`. Missing directories are created automatically.
+- Loggers writing to the same file share it, so their lines stay in order.
+- Lines logged in the same tick are written together in one synchronous write at the end of the tick, or as soon as 64 KB are waiting, so memory use stays small even when logging in bursts.
+- Anything not yet written is flushed when the process exits, crashes, or receives `SIGINT` or `SIGTERM`. If your app handles those signals itself, jet-logger flushes and leaves exiting to your handler.
+- `await logger.flush()` makes sure everything is on disk; `await logger.close()` also closes the file.
+- `prependTimeToFilename` starts a new file each run: `logs/app.log` → `logs/20260925T010401Z_app.log`.
+- With the `json` format, the default file name becomes `jet-logger.jsonl`.
+- Files are created with your process's default permissions, which usually lets other users read them. Use a stricter `umask` or directory if your logs hold sensitive data.
+
+---
+
+### Browser
+
+In browsers and web workers, `console` and `file` modes switch to `browser` mode automatically, which prints styled logs with `console.info`, `console.warn`, and `console.error`.
+
+<p align="center">· · ·</p>
+
+## 🚚 Custom Transports
+
+Set `mode` to `custom` to send every log to your own function, e.g. to forward it to Datadog, Splunk, or an HTTP collector:
+
+```ts
+import { JetLogger, type CustomTransportFn } from 'jet-logger';
+
+const sendToSplunk: CustomTransportFn = async ({ time, level, msg }) => {
+  await splunkClient.emit({ time, level, msg });
+};
+
+const remoteLogger = JetLogger({
+  mode: JetLogger.Modes.CUSTOM,
+  customTransport: sendToSplunk,
+});
+
+remoteLogger.imp('Sent to Splunk');
+await remoteLogger.flush(); // e.g. before exiting: waits for pending sends
+```
+
+The function can be async. If it throws or its promise rejects, the error is reported on stderr (`console.error` in browsers) instead of crashing your app.
+
+It receives a `CustomTransportContext`:
+
+```ts
+interface CustomTransportContext {
+  time: string; // ISO 8601
+  level: 'INFO' | 'IMPORTANT' | 'WARNING' | 'ERROR' | null; // null for out() and line()
+  msg: string; // all arguments joined into one string
+}
+```
+
+<p align="center">· · ·</p>
+
+## License
+
+[MIT](./LICENSE) © seanpmaxwell

package/lib/index.d.ts

@@ -0,0 +1,111 @@
+// Generated by dts-bundle-generator v9.5.1
+
+type BaseTypes = Record<string, number> | Record<string, string>;
+type Enum<O extends BaseTypes> = {
+	[K in keyof O]: O[K] extends string | number ? O[K] : never;
+}[keyof O];
+interface EnumUtils<T> {
+	is: (val: unknown) => val is T[keyof T];
+	table: () => T;
+}
+type EnumTable<T> = T extends EnumUtils<infer P> ? P : never;
+declare const ModesTable: {
+	readonly CONSOLE: "console";
+	readonly FILE: "file";
+	readonly BROWSER: "browser";
+	readonly CUSTOM: "custom";
+	readonly OFF: "off";
+};
+type ModesTable = typeof ModesTable;
+declare const Modes: {
+	readonly is: (val: unknown) => val is "console" | "file" | "browser" | "custom" | "off";
+	readonly table: () => {
+		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 Modes = Enum<ModesTable>;
+declare const FormatsTable: {
+	readonly LINE: "line";
+	readonly JSON: "json";
+};
+type FormatsTable = typeof FormatsTable;
+declare const Formats: {
+	readonly is: (val: unknown) => val is "line" | "json";
+	readonly table: () => {
+		readonly LINE: "line";
+		readonly JSON: "json";
+	};
+	readonly LINE: "line";
+	readonly JSON: "json";
+};
+type Formats = Enum<FormatsTable>;
+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: EnumTable<typeof Modes>;
+	readonly Formats: EnumTable<typeof Formats>;
+}
+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 Tt(t){return typeof t=="object"&&t!==null}function Et(t){return typeof t=="function"}function bt(t){return t===null||typeof t=="function"}function Ot(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:Tt,fn:Et,nul:{fn:bt}},parse:{bool:Ot}};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),table:()=>({...t})}}var H={CONSOLE:"console",FILE:"file",BROWSER:"browser",CUSTOM:"custom",OFF:"off"},p={...H,...v(H)},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(n=>K.test(n));return(o>=0?e.slice(o):e).map(n=>n.trim()).filter(n=>n!=="")}function O(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 Lt(t,e,o){let r=i=>{try{e(i)}catch{}},n;try{n=t()}catch(i){return r(i)}if(!Ft(n))return;let s=Promise.resolve(n).then(void 0,r).finally(()=>o?.delete(s));o?.add(s)}function Ft(t){return(typeof t=="object"||typeof t=="function")&&t!==null&&typeof t.then=="function"}var b=Lt;function xt(t,e){let o=[],r=function(n,s){for(;o.length>0&&o[o.length-1].holder!==this;)o.pop();if(typeof s=="bigint")return`${s}n`;if(typeof s!="object"||s===null)return s;if(o.some(l=>l.original===s))return"[Circular]";let i=kt(s);return o.push({holder:i,original:s}),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 L=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 u=Rt();var Pt=(()=>{if(u.IS_LOCAL){let{util:t}=u.nodeModules();return(e,o)=>t.inspect(e,{depth:null,colors:o})}return t=>t instanceof Error?O(t):L(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:n,showDate:s,paint:i}=e,l=i(o.label,o),a=i(m(r,!1),x);return n?`${i(N(s),F)} ${l}: ${a}`:`${l}: ${a}`}function N(t,e=new Date){let o=T(e.getHours()),r=T(e.getMinutes()),n=T(e.getSeconds()),s=T(e.getMilliseconds(),3),i=`${o}:${r}:${n}.${s}`;if(!t)return`[${i}]`;let l=e.getFullYear(),a=T(e.getMonth()+1),h=T(e.getDate());return`[${l}-${a}-${h} ${i}]`}function T(t,e=2){return String(t).padStart(e,"0")}function E(t,e){let o=[],r=[],n;for(let a of t.args)a instanceof Error&&!n?(n=a,o.push(a.message)):typeof a=="object"&&a!==null?r.push(a):o.push(String(a));let s=t.level.label,i=o.join(" "),l=e?{time:new Date().toISOString(),level:s,msg:i}:{level:s,msg:i};return r.length>0&&(l.data=r.length===1?r[0]:r),n&&(l.stack=z(n)),L(l)}function Q(t,e){let o=e instanceof Error?O(e):String(e),r=`jet-logger: ${t}: ${o}`;u.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(n=>["%s",E(n,r)]):new t(n=>Nt(n,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,n=m(r,!1),s=[o.css,o.label,x.css,n];return e?["%c%s %c%s: %c%s",...[F.css,N(!1)],...s]:["%c%s: %c%s",...s]}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(n=>E(n,r)):new t((n,s)=>I(n,{showTime:r,showDate:!1,paint:s?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}=u.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}=u.nodeModules(),r=o.parse(t),n=`${_t(e)}_${r.base}`;return o.format({...r,base:n})}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",at),Wt.forEach(e=>process.on(e,lt)))}function lt(t){at(),!(process.listenerCount(t)>1)&&(process.off(t,lt),process.kill(process.pid,t))}function at(){W.forEach(t=>t.flushSync())}function ut(t){W.delete(t)}var Gt=1e3;function jt(t,e){let{fs:o}=u.nodeModules(),r=0;for(;e.length>0;)try{e=e.subarray(o.writeSync(t,e)),r=0}catch(n){if(!(n.code==="EAGAIN")||++r>Gt)throw n;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}=u.nodeModules(),n=r.resolve(e),s=G.get(n);if(!s){o.mkdirSync(r.dirname(n),{recursive:!0});let i=o.openSync(n,"a");s=new t(n,i),G.set(n,s),it(s)}return s.#r++,s}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="",Ut(this.#e,e)}async release(){await this.flush(),this.#r--,!(this.#r>0)&&(G.delete(this.#t),ut(this),u.nodeModules().fs.closeSync(this.#e))}};function Ut(t,e){try{ct(t,Buffer.from(e,"utf8"))}catch(o){Ht(o)}}function Ht(t){let e=t instanceof Error?t.message:String(t);try{u.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,n=Yt(e),s=ft.open(n);return o===f.JSON?new t(s,i=>E(i,r)):new t(s,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}=u.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:n,JET_LOGGER_FORMAT:s}=t,i={},l=e?.toLowerCase();p.is(l)&&(i.mode=l),c.is.neStr(o)&&(i.filepath=o);let a=c.parse.bool(r);c.is.def(a)&&(i.prependTimeToFilename=a);let h=c.parse.bool(n);c.is.def(h)&&(i.showTime=h);let U=s?.toLowerCase();return f.is(U)&&(i.format=U),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 n=`Invalid option "${e}": ${Vt(o)}`;return r&&(n+=`. ${r}`),new t(n,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,a]of Object.entries(t))if(!Qt.has(l))throw d.of(l,a,"Unknown option");let{mode:e,format:o,showTime:r,prependTimeToFilename:n,filepath:s,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(n))throw d.of("prependTimeToFilename",n);if(!c.is.neStr(s))throw d.of("filepath",s);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,n,s=(i,l)=>{r||e.writeLog({level:i,args:l})};return{info:(...i)=>s(y.Info,i),warn:(...i)=>s(y.Warning,i),imp:(...i)=>s(y.Important,i),err:(...i)=>s(y.Error,i),line:()=>{r||e.writeRaw([])},out:(...i)=>{r||e.writeRaw(i)},catch:i=>{b(i,a=>s(y.Error,[M(a)]),o)},flush:async()=>{await P(o),await e.flush()},close:()=>n??=(async()=>{await P(o),r=!0,await e.close()})()}}function oe(t){return u.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=>b(e,t),flush:()=>Promise.resolve(),close:()=>Promise.resolve()}}function re(t){let e=new Set,o=!1,r,n=(s,i)=>{if(o)return;let l={time:new Date().toISOString(),level:s,msg:m(i,!1)};b(()=>t(l),h=>Q("customTransport failed",h),e)};return{info:(...s)=>n("INFO",s),warn:(...s)=>n("WARNING",s),imp:(...s)=>n("IMPORTANT",s),err:(...s)=>n("ERROR",s),line:()=>n(null,[`
+`]),out:(...s)=>n(null,s),catch:s=>{b(s,l=>n("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.table(),Formats:f.table()}),le,g=()=>le??=D(),ae=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()}),Do=ie,Uo=ae;export{d as InvalidOptionError,Do as JetLogger,Uo as default};

package/package.json

@@ -1,31 +1,39 @@
 {
   "name": "jet-logger",
-  "version": "2.2.3",
-  "description": "A super quick, easy to setup logging tool for NodeJS/TypeScript.",
+  "version": "3.0.1",
+  "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",
+    "prepublishOnly": "npm run build && tsc && npm run lint && npm run format:check && npm test && npm run test:browser && npm run verify:package",
+    "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 +66,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 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: Modes.CONSOLE,
-    FILE_PATH: 'jet-logger.log',
-    TIMESTAMP: true,
-    FORMAT: Formats.LINE,
-    CUSTOM_LOGGER_FUNCTION: () => ({}),
-};
-const Errors = {
-    CUSTOM_LOGGER: '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,
-    Formats,
-};
-export function jetLogger(options) {
-    let mode = Defaults.MODE, filePath = Defaults.FILE_PATH, timestamp = Defaults.TIMESTAMP, format = Defaults.FORMAT, customLogFn = Defaults.CUSTOM_LOGGER_FUNCTION;
-    if (options?.mode !== undefined) {
-        mode = options.mode;
-    }
-    else if (!!process.env.JET_LOGGER_MODE) {
-        mode = process.env.JET_LOGGER_MODE.toLowerCase();
-    }
-    if (mode === Modes.OFF) {
-        return {
-            info: (_, __) => ({}),
-            imp: (_, __) => ({}),
-            warn: (_, __) => ({}),
-            err: (_, __) => ({}),
-        };
-    }
-    if (mode === Modes.CUSTOM) {
-        if (options?.customLogger !== undefined) {
-            customLogFn = options.customLogger;
-        }
-        if (!customLogFn) {
-            throw Error(Errors.CUSTOM_LOGGER);
-        }
-        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.toLowerCase() === 'true';
-    }
-    if (options?.format !== undefined) {
-        format = options.format;
-    }
-    else if (!!process.env.JET_LOGGER_FORMAT) {
-        format = process.env.JET_LOGGER_FORMAT.toLowerCase();
-    }
-    let formatter = () => '';
-    if (format === Formats.LINE) {
-        formatter = setupLineFormatter(timestamp);
-    }
-    else if (format === Formats.JSON) {
-        formatter = setupJsonFormatter(timestamp);
-    }
-    if (mode === 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.toLowerCase() === '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 + '\n', (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 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: Modes.CONSOLE,
-    FILE_PATH: 'jet-logger.log',
-    TIMESTAMP: true,
-    FORMAT: Formats.LINE,
-    CUSTOM_LOGGER_FUNCTION: () => ({}),
-};
-const Errors = {
-    CUSTOM_LOGGER: '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,
-    Formats,
-};
-export function jetLogger(options) {
-    let mode = Defaults.MODE, filePath = Defaults.FILE_PATH, timestamp = Defaults.TIMESTAMP, format = Defaults.FORMAT, customLogFn = Defaults.CUSTOM_LOGGER_FUNCTION;
-    if (options?.mode !== undefined) {
-        mode = options.mode;
-    }
-    else if (!!process.env.JET_LOGGER_MODE) {
-        mode = process.env.JET_LOGGER_MODE.toLowerCase();
-    }
-    if (mode === Modes.OFF) {
-        return {
-            info: (_, __) => ({}),
-            imp: (_, __) => ({}),
-            warn: (_, __) => ({}),
-            err: (_, __) => ({}),
-        };
-    }
-    if (mode === Modes.CUSTOM) {
-        if (options?.customLogger !== undefined) {
-            customLogFn = options.customLogger;
-        }
-        if (!customLogFn) {
-            throw Error(Errors.CUSTOM_LOGGER);
-        }
-        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.toLowerCase() === 'true';
-    }
-    if (options?.format !== undefined) {
-        format = options.format;
-    }
-    else if (!!process.env.JET_LOGGER_FORMAT) {
-        format = process.env.JET_LOGGER_FORMAT.toLowerCase();
-    }
-    let formatter = () => '';
-    if (format === Formats.LINE) {
-        formatter = setupLineFormatter(timestamp);
-    }
-    else if (format === Formats.JSON) {
-        formatter = setupJsonFormatter(timestamp);
-    }
-    if (mode === 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.toLowerCase() === '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 + '\n', (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 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 Modes = (typeof Modes)[keyof typeof 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?: Modes;
-    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;