@holz/console-backend 0.9.1-rc.9 → 0.9.2-rc.0.sha-87f4046

package/dist/holz-console-backend.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e={fatal:60,error:50,warn:40,info:30,debug:20,trace:10},t=1e3,n=60*t,r=60*n,i=24*r,a=(e,a=e)=>{let o=e.getTime()-a.getTime(),s=Math.abs(o),c=o<0?``:`+`;return s>=i?`${c}${Math.round(o/i)}d`:s>=r?`${c}${Math.round(o/r)}h`:s>=n?`${c}${Math.round(o/n)}m`:s>=t?`${c}${Math.round(o/t)}s`:`${c}${o}ms`},o=(e={})=>{let t=e.console??console,n;return e=>{let r=new Date(e.timestamp),{error:i,...o}=e.context,c=[{include:!0,format:`%s`,values:[e.message]},{include:Object.keys(o).length>0,format:`%o`,values:[o]},{include:!0,format:`%c%s`,values:[`color: gray`,a(r,n)]},{include:e.origin.length>0,format:`%c%s`,values:[`color: rgba(128, 128, 128, 0.6); font-style: italic`,e.origin.join(`:`)]},{include:i,format:`%o`,values:[i]}].filter(e=>e.include),l=c.map(e=>e.format).join(` `),u=c.flatMap(e=>e.values);t[s[e.level]](l,...u),n=r}},s={[e.trace]:`trace`,[e.debug]:`debug`,[e.info]:`info`,[e.warn]:`warn`,[e.error]:`error`,[e.fatal]:`error`};exports.createConsoleBackend=o;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@holz/core");var t=1e3,n=60*t,r=60*n,i=24*r,a=(e,a=e)=>{let o=e.getTime()-a.getTime(),s=Math.abs(o),c=o<0?``:`+`;return s>=i?`${c}${Math.round(o/i)}d`:s>=r?`${c}${Math.round(o/r)}h`:s>=n?`${c}${Math.round(o/n)}m`:s>=t?`${c}${Math.round(o/t)}s`:`${c}${o}ms`},o=(e={})=>{let t=e.console??console,n;return e=>{let r=new Date(e.timestamp),{error:i,...o}=e.context,c=[{include:!0,format:`%s`,values:[e.message]},{include:Object.keys(o).length>0,format:`%o`,values:[o]},{include:!0,format:`%c%s`,values:[`color: gray`,a(r,n)]},{include:e.origin.length>0,format:`%c%s`,values:[`color: rgba(128, 128, 128, 0.6); font-style: italic`,e.origin.join(`:`)]},{include:i,format:`%o`,values:[i]}].filter(e=>e.include),l=c.map(e=>e.format).join(` `),u=c.flatMap(e=>e.values);t[s[e.level]](l,...u),n=r}},s={[e.level.trace]:`trace`,[e.level.debug]:`debug`,[e.level.info]:`info`,[e.level.warn]:`warn`,[e.level.error]:`error`,[e.level.fatal]:`error`};exports.createConsoleBackend=o;

package/dist/holz-console-backend.js

@@ -1,12 +1,6 @@
-//#region ../holz-core/dist/holz-core.js
-var e = {
-	fatal: 60,
-	error: 50,
-	warn: 40,
-	info: 30,
-	debug: 20,
-	trace: 10
-}, t = 1e3, n = 60 * t, r = 60 * n, i = 24 * r, a = (e, a = e) => {
+import { level as e } from "@holz/core";
+//#region src/time-delta.ts
+var t = 1e3, n = 60 * t, r = 60 * n, i = 24 * r, a = (e, a = e) => {
 	let o = e.getTime() - a.getTime(), s = Math.abs(o), c = o < 0 ? "" : "+";
 	return s >= i ? `${c}${Math.round(o / i)}d` : s >= r ? `${c}${Math.round(o / r)}h` : s >= n ? `${c}${Math.round(o / n)}m` : s >= t ? `${c}${Math.round(o / t)}s` : `${c}${o}ms`;
 }, o = (e = {}) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holz/console-backend",
-  "version": "0.9.1-rc.9+7993ae6",
+  "version": "0.9.2-rc.0.sha-87f4046",
   "description": "A console backend for Holz",
   "type": "module",
   "repository": {
@@ -10,6 +10,7 @@
   },
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/holz-console-backend.d.ts",
       "require": "./dist/holz-console-backend.cjs",
       "import": "./dist/holz-console-backend.js"
@@ -22,7 +23,9 @@
   "license": "MIT",
   "sideEffects": false,
   "files": [
-    "dist"
+    "dist",
+    "src",
+    "!src/**/__tests__"
   ],
   "keywords": [
     "holz-backend",
@@ -37,18 +40,18 @@
     "test:types": "tsc"
   },
   "peerDependencies": {
-    "@holz/core": "^0.8.0"
+    "@holz/core": "^0.8.0 || ^0.9.0"
   },
   "devDependencies": {
-    "@holz/core": "^0.9.1-rc.9+7993ae6",
+    "@holz/core": "^0.9.2-rc.0.sha-87f4046",
     "@microsoft/api-extractor": "^7.58.8",
     "@types/node": "^24.0.0",
-    "@vitest/coverage-v8": "^4.0.0",
+    "@vitest/coverage-v8": "^5.0.0",
     "typescript": "^6.0.0",
     "vite": "^8.0.0",
     "vite-plugin-dts": "^5.0.0",
     "vite-tsconfig-paths": "^6.0.0",
-    "vitest": "^4.0.0"
+    "vitest": "^5.0.0"
   },
-  "gitHead": "7993ae6757f530d908f8ce2fdd0654767dd3b595"
+  "gitHead": "87f40467fe9aa798fa894c04a208751403c45e8c"
 }

package/src/console-backend.ts

@@ -0,0 +1,81 @@
+import { level, type LogLevel, type Log, type LogProcessor } from '@holz/core';
+import { timeDelta } from './time-delta';
+
+/**
+ * A backend that pretty-prints logs to a browser console, or any
+ * remote-attached console.
+ */
+export const createConsoleBackend = (options: Options = {}): LogProcessor => {
+  const output = options.console ?? console;
+  let lastTimestamp: Date;
+
+  return (log: Log) => {
+    const time = new Date(log.timestamp);
+    const { error, ...plainContext } = log.context;
+
+    const segments = [
+      {
+        include: true,
+        format: '%s',
+        values: [log.message],
+      },
+      {
+        include: Object.keys(plainContext).length > 0,
+        format: '%o', // Chrome hides object content with `%O`.
+        values: [plainContext],
+      },
+      {
+        include: true,
+        format: '%c%s',
+        values: ['color: gray', timeDelta(time, lastTimestamp)],
+      },
+      {
+        include: log.origin.length > 0,
+        format: '%c%s',
+        values: [
+          'color: rgba(128, 128, 128, 0.6); font-style: italic',
+          log.origin.join(':'),
+        ],
+      },
+      {
+        include: error,
+        format: '%o',
+        values: [error],
+      },
+    ].filter((segment) => segment.include);
+
+    const format = segments.map((segment) => segment.format).join(' ');
+    const values = segments.flatMap<unknown>((segment) => segment.values);
+
+    // Browsers have UIs for filtering by log level. Leverage that.
+    output[sink[log.level]](format, ...values);
+
+    // Track the time spent between logs.
+    lastTimestamp = time;
+  };
+};
+
+const sink: Record<LogLevel, keyof MinimalConsole> = {
+  [level.trace]: 'trace',
+  [level.debug]: 'debug',
+  [level.info]: 'info',
+  [level.warn]: 'warn',
+  [level.error]: 'error',
+  [level.fatal]: 'error',
+};
+
+interface Options {
+  console?: MinimalConsole;
+}
+
+/**
+ * A subset of the Console interface. Must support printf-style interpolation.
+ * @see https://console.spec.whatwg.org/#formatting-specifiers
+ *
+ * Note that `fatal` has no corresponding equivalent. It will be downgraded to
+ * `error` when printed.
+ */
+export type MinimalConsole = Pick<
+  Console,
+  'trace' | 'debug' | 'info' | 'warn' | 'error'
+>;

package/src/index.ts

@@ -0,0 +1 @@
+export { createConsoleBackend } from './console-backend';

package/src/time-delta.ts

@@ -0,0 +1,33 @@
+const second = 1_000;
+const minute = 60 * second;
+const hour = 60 * minute;
+const day = 24 * hour;
+
+/**
+ * Formats the difference between two dates in human-readable time.
+ *
+ * Inspired by the `ms` package. Thanks TJ.
+ */
+export const timeDelta = (now: Date, then: Date = now) => {
+  const offset = now.getTime() - then.getTime();
+  const distance = Math.abs(offset);
+  const sign = offset < 0 ? '' : '+';
+
+  if (distance >= day) {
+    return `${sign}${Math.round(offset / day)}d`;
+  }
+
+  if (distance >= hour) {
+    return `${sign}${Math.round(offset / hour)}h`;
+  }
+
+  if (distance >= minute) {
+    return `${sign}${Math.round(offset / minute)}m`;
+  }
+
+  if (distance >= second) {
+    return `${sign}${Math.round(offset / second)}s`;
+  }
+
+  return `${sign}${offset}ms`;
+};