@eventuras/fides-auth 0.3.1 → 0.4.0

package/README.md

@@ -231,15 +231,22 @@ import {
 
 ### Pluggable Logging (`/logger`)
 
-The library uses console logging by default. Plug in your preferred logger at startup:
+The library writes newline-delimited JSON to `console.<level>` by default — interoperable with Loki, Grafana, Datadog, and other log shippers without any setup. Plug in a richer logger at startup if you want OpenTelemetry, redaction, or shared formatting with the rest of your app:
 
 ```typescript
 import { configureLogger } from "@eventuras/fides-auth/logger";
 
-// Example: plug in pino
+// Example: plug in @eventuras/logger
+import { Logger } from "@eventuras/logger";
+configureLogger({
+  create(options) {
+    return Logger.create(options);
+  },
+});
+
+// Or plug in pino directly
 import pino from "pino";
 const pinoInstance = pino();
-
 configureLogger({
   create({ namespace, context }) {
     return pinoInstance.child({ namespace, ...context });
@@ -249,6 +256,12 @@ configureLogger({
 
 Any object implementing `{ debug, info, warn, error }` works — pino, winston, bunyan, or your own.
 
+The default JSONL output looks like:
+
+```json
+{"level":"info","time":"2026-04-15T19:40:57.300Z","namespace":"fides-auth:oauth","msg":"PKCE parameters generated"}
+```
+
 ### Vipps Login Provider (`/providers/vipps`)
 
 ```typescript

package/dist/logger.d.ts

@@ -1,14 +1,17 @@
 /**
  * Pluggable logger for fides-auth.
  *
- * By default, uses a console-based logger. Users can provide their own
- * implementation (pino, winston, etc.) via `configureLogger()`.
+ * The default writes newline-delimited JSON to `console.<level>` so output
+ * is interoperable with Loki / Grafana / Datadog out of the box, even when
+ * the consumer hasn't wired in a structured logger. Users can plug their
+ * own backend (pino, winston, @eventuras/logger, ...) via `configureLogger()`.
  *
  * @example
- * // Use default console logger (no setup needed)
+ * // Use default JSONL console logger (no setup needed)
  * import { createLogger } from '@eventuras/fides-auth/logger';
  * const logger = createLogger({ namespace: 'my-app:auth' });
  * logger.info('Authentication successful');
+ * // → {"level":"info","time":"…","namespace":"my-app:auth","msg":"Authentication successful"}
  *
  * @example
  * // Plug in pino

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpE;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,gGAAgG;AAChG,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC;CAClD;AAkED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAGjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAkBrE"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpE;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,gGAAgG;AAChG,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC;CAClD;AAkID;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAGjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAkBrE"}

package/dist/logger.js

@@ -1,46 +1,91 @@
 //#region src/logger.ts
-var e = class {
-	prefix;
+function e(e) {
+	return e instanceof Error ? {
+		name: e.name,
+		message: e.message,
+		stack: e.stack
+	} : e;
+}
+var t = new Set([
+	"level",
+	"time",
+	"namespace"
+]);
+function n(t) {
+	let n = /* @__PURE__ */ new WeakSet();
+	try {
+		return JSON.stringify(t, (t, r) => {
+			if (r instanceof Error) return e(r);
+			if (typeof r == "bigint") return r.toString();
+			if (typeof r == "object" && r) {
+				if (n.has(r)) return "[Circular]";
+				n.add(r);
+			}
+			return r;
+		});
+	} catch {
+		return JSON.stringify({
+			level: t.level,
+			time: t.time,
+			namespace: t.namespace,
+			msg: typeof t.msg == "string" ? t.msg : "[unserializable log entry]",
+			_serializeError: !0
+		});
+	}
+}
+var r = class {
 	constructor(e, t) {
-		this.prefix = `[${e}]${t && Object.keys(t).length > 0 ? ` ${JSON.stringify(t)}` : ""}`;
+		this.namespace = e, this.context = t;
+	}
+	write(r, i, a, o) {
+		if (a === void 0 && o === void 0) return;
+		let s = {
+			level: i,
+			time: (/* @__PURE__ */ new Date()).toISOString(),
+			namespace: this.namespace
+		};
+		if (this.context) for (let [e, n] of Object.entries(this.context)) t.has(e) || (s[e] = n);
+		if (typeof a == "string") s.msg = a;
+		else if (o !== void 0 && (s.msg = o), a) for (let [e, n] of Object.entries(a)) t.has(e) || (s[e] = n);
+		s.error !== void 0 && (s.error = e(s.error)), console[r](n(s));
 	}
 	debug(e, t) {
-		typeof e == "string" ? console.debug(this.prefix, e) : t ? console.debug(this.prefix, t, e) : e && console.debug(this.prefix, e);
+		this.write("debug", "debug", e, t);
 	}
 	info(e, t) {
-		typeof e == "string" ? console.info(this.prefix, e) : t ? console.info(this.prefix, t, e) : e && console.info(this.prefix, e);
+		this.write("info", "info", e, t);
 	}
 	warn(e, t) {
-		typeof e == "string" ? console.warn(this.prefix, e) : t ? console.warn(this.prefix, t, e) : e && console.warn(this.prefix, e);
+		this.write("warn", "warn", e, t);
 	}
 	error(e, t) {
-		typeof e == "string" ? console.error(this.prefix, e) : t ? console.error(this.prefix, t, e) : e && console.error(this.prefix, e);
+		this.write("error", "error", e, t);
 	}
-}, t = { create({ namespace: t, context: n }) {
-	return new e(t, n);
-} }, n = 0;
-function r(e) {
-	t = e, n++;
+}, i = { create({ namespace: e, context: t }) {
+	return new r(e, t);
+} }, a = 0;
+function o(e) {
+	i = e, a++;
 }
-function i(e) {
-	let r = null, i = -1;
-	function a() {
-		return (r === null || i !== n) && (r = t.create(e), i = n), r;
+function s(e) {
+	let t = null, n = -1;
+	function r() {
+		return (t === null || n !== a) && (t = i.create(e), n = a), t;
 	}
 	return {
 		debug(e, t) {
-			a().debug(e, t);
+			r().debug(e, t);
 		},
 		info(e, t) {
-			a().info(e, t);
+			r().info(e, t);
 		},
 		warn(e, t) {
-			a().warn(e, t);
+			r().warn(e, t);
 		},
 		error(e, t) {
-			a().error(e, t);
+			r().error(e, t);
 		}
 	};
 }
 //#endregion
-export { r as configureLogger, i as createLogger };
+export { o as configureLogger, s as createLogger };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eventuras/fides-auth",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Framework-agnostic OAuth/OIDC authentication library with PKCE, session management, and pluggable logging",
   "keywords": [
     "oauth",