@logtape/logtape 2.2.0-dev.759 → 2.2.0-dev.760

package/dist/logger.cjs

@@ -7,6 +7,9 @@ const require_level = require('./level.cjs');
 */
 const lazySymbol = Symbol.for("logtape.lazy");
 const throttlingSummaryRecordSymbol = Symbol.for("LogTape.throttlingSummaryRecord");
+const immediateSinkSymbol = Symbol.for("LogTape.sinkSnapshotPolicy.immediate");
+const internalStringLogRecords = /* @__PURE__ */ new WeakSet();
+const resolvedStringLogRecords = /* @__PURE__ */ new WeakSet();
 /**
 * Checks if a value is a lazy value.
 *
@@ -82,7 +85,18 @@ function logStringMessage(logger, level, message, props) {
 	logger.log(level, message, result);
 }
 function snapshotLogRecordProperties(record) {
+	if (resolvedStringLogRecords.has(record)) return record;
 	const properties = resolveProperties(record.properties);
+	if (internalStringLogRecords.has(record)) return {
+		category: record.category,
+		level: record.level,
+		get message() {
+			return record.message;
+		},
+		rawMessage: record.rawMessage,
+		timestamp: record.timestamp,
+		properties
+	};
 	const descriptors = Object.getOwnPropertyDescriptors(record);
 	descriptors.properties = {
 		value: properties,
@@ -91,6 +105,13 @@ function snapshotLogRecordProperties(record) {
 	};
 	return Object.defineProperties({}, descriptors);
 }
+function hasEnumerableProperties(properties) {
+	if (properties == null || typeof properties !== "object") return false;
+	return Object.keys(properties).length > 0 || Object.prototype.propertyIsEnumerable.call(properties, throttlingSummaryRecordSymbol);
+}
+function shouldSnapshotForSink(sink) {
+	return sink[immediateSinkSymbol] !== true;
+}
 /**
 * Get a logger with the given category.
 *
@@ -122,10 +143,11 @@ var LoggerImpl = class LoggerImpl {
 	children;
 	category;
 	sinks;
-	parentSinks = "inherit";
 	filters;
-	lowestLevel = "trace";
 	contextLocalStorage;
+	#parentSinks = "inherit";
+	#lowestLevel = "trace";
+	#sinkPlanCache = {};
 	static getLogger(category = []) {
 		let rootLogger = globalRootLoggerSymbol in globalThis ? globalThis[globalRootLoggerSymbol] ?? null : null;
 		if (rootLogger == null) {
@@ -153,6 +175,20 @@ var LoggerImpl = class LoggerImpl {
 		this.sinks = [];
 		this.filters = [];
 	}
+	get parentSinks() {
+		return this.#parentSinks;
+	}
+	set parentSinks(value) {
+		if (this.#parentSinks === value) return;
+		this.#parentSinks = value;
+	}
+	get lowestLevel() {
+		return this.#lowestLevel;
+	}
+	set lowestLevel(value) {
+		if (this.#lowestLevel === value) return;
+		this.#lowestLevel = value;
+	}
 	getChild(subcategory) {
 		const name = typeof subcategory === "string" ? subcategory : subcategory[0];
 		const childRef = this.children[name];
@@ -193,9 +229,72 @@ var LoggerImpl = class LoggerImpl {
 		return true;
 	}
 	*getSinks(level) {
-		if (this.lowestLevel === null || require_level.compareLogLevel(level, this.lowestLevel) < 0) return;
-		if (this.parent != null && this.parentSinks === "inherit") for (const sink of this.parent.getSinks(level)) yield sink;
-		for (const sink of this.sinks) yield sink;
+		const plan = this.getSinkDispatchPlan(level);
+		switch (plan.kind) {
+			case "none": return;
+			case "one":
+				yield plan.sink;
+				return;
+			case "many":
+				yield* plan.sinks;
+				return;
+		}
+	}
+	getSinkDispatchPlan(level) {
+		const cached = this.#sinkPlanCache[level];
+		if (cached != null && this.isSinkDispatchPlanFresh(level, cached)) return cached;
+		const parentPlan = this.parent != null && this.parentSinks === "inherit" ? this.parent.getSinkDispatchPlan(level) : void 0;
+		const plan = this.createSinkDispatchPlan(level, parentPlan);
+		this.#sinkPlanCache[level] = plan;
+		return plan;
+	}
+	isSinkDispatchPlanFresh(level, plan) {
+		if (plan.lowestLevel !== this.lowestLevel || plan.parentSinks !== this.parentSinks || plan.localSinks.length !== this.sinks.length) return false;
+		for (let i = 0; i < plan.localSinks.length; i++) if (plan.localSinks[i] !== this.sinks[i]) return false;
+		const parentPlan = this.parent != null && this.parentSinks === "inherit" ? this.parent.getSinkDispatchPlan(level) : void 0;
+		return plan.parentPlan === parentPlan;
+	}
+	createSinkDispatchPlan(level, parentPlan) {
+		const state = {
+			localSinks: [...this.sinks],
+			parentSinks: this.parentSinks,
+			lowestLevel: this.lowestLevel,
+			parentPlan
+		};
+		if (state.lowestLevel === null) return {
+			...state,
+			kind: "none"
+		};
+		if (require_level.compareLogLevel(level, state.lowestLevel) < 0) return {
+			...state,
+			kind: "none"
+		};
+		let firstSink;
+		let sinks;
+		const appendSink = (sink) => {
+			if (sinks != null) sinks.push(sink);
+			else if (firstSink == null) firstSink = sink;
+			else sinks = [firstSink, sink];
+		};
+		if (parentPlan != null) {
+			if (parentPlan.kind === "one") firstSink = parentPlan.sink;
+			else if (parentPlan.kind === "many") sinks = [...parentPlan.sinks];
+		}
+		for (const sink of state.localSinks) appendSink(sink);
+		if (sinks != null) return {
+			...state,
+			kind: "many",
+			sinks
+		};
+		if (firstSink != null) return {
+			...state,
+			kind: "one",
+			sink: firstSink
+		};
+		return {
+			...state,
+			kind: "none"
+		};
 	}
 	isEnabledFor(level) {
 		const categoryPrefix = isMetaLoggerCategory(this.category) ? [] : require_context.getCategoryPrefix();
@@ -203,14 +302,17 @@ var LoggerImpl = class LoggerImpl {
 		return dispatcher.isEnabledForResolved(level);
 	}
 	isEnabledForResolved(level) {
-		if (this.lowestLevel === null || require_level.compareLogLevel(level, this.lowestLevel) < 0) return false;
-		for (const _ of this.getSinks(level)) return true;
-		return false;
+		return this.getSinkDispatchPlan(level).kind !== "none";
 	}
 	emit(record, bypassSinks) {
-		const baseCategory = "category" in record ? record.category : this.category;
+		const hasCategory = "category" in record;
+		const baseCategory = hasCategory ? record.category : this.category;
 		const categoryPrefix = isMetaLoggerCategory(baseCategory) ? [] : require_context.getCategoryPrefix();
 		const fullCategory = categoryPrefix.length > 0 ? [...categoryPrefix, ...baseCategory] : baseCategory;
+		if (categoryPrefix.length < 1 && Object.prototype.hasOwnProperty.call(record, "category")) {
+			this.emitResolved(record, bypassSinks);
+			return;
+		}
 		const descriptors = Object.getOwnPropertyDescriptors(record);
 		descriptors.category = {
 			value: fullCategory,
@@ -223,14 +325,36 @@ var LoggerImpl = class LoggerImpl {
 	}
 	emitResolved(record, bypassSinks) {
 		if (this.lowestLevel === null || require_level.compareLogLevel(record.level, this.lowestLevel) < 0 || !this.filter(record)) return;
-		const sinks = [...this.getSinks(record.level)];
-		if (sinks.length < 1) return;
+		const plan = this.getSinkDispatchPlan(record.level);
+		if (plan.kind === "none") return;
 		let snapshot;
 		let snapshotFailed = false;
-		for (const sink of sinks) {
+		if (plan.kind === "one") {
+			const sink = plan.sink;
+			if (bypassSinks?.has(sink)) return;
+			try {
+				if (shouldSnapshotForSink(sink)) try {
+					snapshot = snapshotLogRecordProperties(record);
+				} catch {
+					snapshotFailed = true;
+					snapshot = record;
+				}
+				sink(snapshot ?? record);
+			} catch (error) {
+				const bypassSinks2 = new Set(bypassSinks);
+				bypassSinks2.add(sink);
+				metaLogger.log("fatal", "Failed to emit a log record to sink {sink}: {error}", {
+					sink,
+					error,
+					record
+				}, bypassSinks2);
+			}
+			return;
+		}
+		for (const sink of plan.sinks) {
 			if (bypassSinks?.has(sink)) continue;
 			try {
-				if (snapshot == null && !snapshotFailed) try {
+				if (snapshot == null && !snapshotFailed && shouldSnapshotForSink(sink)) try {
 					snapshot = snapshotLogRecordProperties(record);
 				} catch {
 					snapshotFailed = true;
@@ -249,7 +373,20 @@ var LoggerImpl = class LoggerImpl {
 		}
 	}
 	log(level, rawMessage, properties, bypassSinks) {
-		const implicitContext = require_context.getImplicitContext();
+		const implicitContext = require_context.getImplicitContextIfAny();
+		if (typeof properties !== "function" && implicitContext == null && !rawMessage.includes("{") && !hasEnumerableProperties(properties)) {
+			const record$1 = {
+				category: this.category,
+				level,
+				message: [rawMessage],
+				rawMessage,
+				timestamp: Date.now(),
+				properties: {}
+			};
+			resolvedStringLogRecords.add(record$1);
+			this.emit(record$1, bypassSinks);
+			return;
+		}
 		let cachedProps = void 0;
 		let cachedMessage = void 0;
 		const record = typeof properties === "function" ? {
@@ -263,7 +400,7 @@ var LoggerImpl = class LoggerImpl {
 			rawMessage,
 			get properties() {
 				if (cachedProps == null) cachedProps = resolveProperties({
-					...implicitContext,
+					...implicitContext ?? {},
 					...properties()
 				});
 				return cachedProps;
@@ -279,16 +416,17 @@ var LoggerImpl = class LoggerImpl {
 			rawMessage,
 			get properties() {
 				if (cachedProps == null) cachedProps = resolveProperties({
-					...implicitContext,
+					...implicitContext ?? {},
 					...properties
 				});
 				return cachedProps;
 			}
 		};
+		internalStringLogRecords.add(record);
 		this.emit(record, bypassSinks);
 	}
 	logLazily(level, callback, properties = {}) {
-		const implicitContext = require_context.getImplicitContext();
+		const implicitContext = require_context.getImplicitContextIfAny();
 		let rawMessage = void 0;
 		let msg = void 0;
 		function realizeMessage() {
@@ -312,13 +450,13 @@ var LoggerImpl = class LoggerImpl {
 			},
 			timestamp: Date.now(),
 			properties: {
-				...implicitContext,
+				...implicitContext ?? {},
 				...properties
 			}
 		});
 	}
 	logTemplate(level, messageTemplate, values, properties = {}) {
-		const implicitContext = require_context.getImplicitContext();
+		const implicitContext = require_context.getImplicitContextIfAny();
 		this.emit({
 			category: this.category,
 			level,
@@ -326,7 +464,7 @@ var LoggerImpl = class LoggerImpl {
 			rawMessage: messageTemplate,
 			timestamp: Date.now(),
 			properties: {
-				...implicitContext,
+				...implicitContext ?? {},
 				...properties
 			}
 		});

package/dist/logger.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.cts","names":[],"sources":["../src/logger.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"logger.d.cts","names":[],"sources":["../src/logger.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","names":[],"sources":["../src/logger.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"logger.d.ts","names":[],"sources":["../src/logger.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/logger.js

@@ -1,4 +1,4 @@
-import { getCategoryPrefix, getImplicitContext } from "./context.js";
+import { getCategoryPrefix, getImplicitContextIfAny } from "./context.js";
 import { compareLogLevel } from "./level.js";
 
 //#region src/logger.ts
@@ -7,6 +7,9 @@ import { compareLogLevel } from "./level.js";
 */
 const lazySymbol = Symbol.for("logtape.lazy");
 const throttlingSummaryRecordSymbol = Symbol.for("LogTape.throttlingSummaryRecord");
+const immediateSinkSymbol = Symbol.for("LogTape.sinkSnapshotPolicy.immediate");
+const internalStringLogRecords = /* @__PURE__ */ new WeakSet();
+const resolvedStringLogRecords = /* @__PURE__ */ new WeakSet();
 /**
 * Checks if a value is a lazy value.
 *
@@ -82,7 +85,18 @@ function logStringMessage(logger, level, message, props) {
 	logger.log(level, message, result);
 }
 function snapshotLogRecordProperties(record) {
+	if (resolvedStringLogRecords.has(record)) return record;
 	const properties = resolveProperties(record.properties);
+	if (internalStringLogRecords.has(record)) return {
+		category: record.category,
+		level: record.level,
+		get message() {
+			return record.message;
+		},
+		rawMessage: record.rawMessage,
+		timestamp: record.timestamp,
+		properties
+	};
 	const descriptors = Object.getOwnPropertyDescriptors(record);
 	descriptors.properties = {
 		value: properties,
@@ -91,6 +105,13 @@ function snapshotLogRecordProperties(record) {
 	};
 	return Object.defineProperties({}, descriptors);
 }
+function hasEnumerableProperties(properties) {
+	if (properties == null || typeof properties !== "object") return false;
+	return Object.keys(properties).length > 0 || Object.prototype.propertyIsEnumerable.call(properties, throttlingSummaryRecordSymbol);
+}
+function shouldSnapshotForSink(sink) {
+	return sink[immediateSinkSymbol] !== true;
+}
 /**
 * Get a logger with the given category.
 *
@@ -122,10 +143,11 @@ var LoggerImpl = class LoggerImpl {
 	children;
 	category;
 	sinks;
-	parentSinks = "inherit";
 	filters;
-	lowestLevel = "trace";
 	contextLocalStorage;
+	#parentSinks = "inherit";
+	#lowestLevel = "trace";
+	#sinkPlanCache = {};
 	static getLogger(category = []) {
 		let rootLogger = globalRootLoggerSymbol in globalThis ? globalThis[globalRootLoggerSymbol] ?? null : null;
 		if (rootLogger == null) {
@@ -153,6 +175,20 @@ var LoggerImpl = class LoggerImpl {
 		this.sinks = [];
 		this.filters = [];
 	}
+	get parentSinks() {
+		return this.#parentSinks;
+	}
+	set parentSinks(value) {
+		if (this.#parentSinks === value) return;
+		this.#parentSinks = value;
+	}
+	get lowestLevel() {
+		return this.#lowestLevel;
+	}
+	set lowestLevel(value) {
+		if (this.#lowestLevel === value) return;
+		this.#lowestLevel = value;
+	}
 	getChild(subcategory) {
 		const name = typeof subcategory === "string" ? subcategory : subcategory[0];
 		const childRef = this.children[name];
@@ -193,9 +229,72 @@ var LoggerImpl = class LoggerImpl {
 		return true;
 	}
 	*getSinks(level) {
-		if (this.lowestLevel === null || compareLogLevel(level, this.lowestLevel) < 0) return;
-		if (this.parent != null && this.parentSinks === "inherit") for (const sink of this.parent.getSinks(level)) yield sink;
-		for (const sink of this.sinks) yield sink;
+		const plan = this.getSinkDispatchPlan(level);
+		switch (plan.kind) {
+			case "none": return;
+			case "one":
+				yield plan.sink;
+				return;
+			case "many":
+				yield* plan.sinks;
+				return;
+		}
+	}
+	getSinkDispatchPlan(level) {
+		const cached = this.#sinkPlanCache[level];
+		if (cached != null && this.isSinkDispatchPlanFresh(level, cached)) return cached;
+		const parentPlan = this.parent != null && this.parentSinks === "inherit" ? this.parent.getSinkDispatchPlan(level) : void 0;
+		const plan = this.createSinkDispatchPlan(level, parentPlan);
+		this.#sinkPlanCache[level] = plan;
+		return plan;
+	}
+	isSinkDispatchPlanFresh(level, plan) {
+		if (plan.lowestLevel !== this.lowestLevel || plan.parentSinks !== this.parentSinks || plan.localSinks.length !== this.sinks.length) return false;
+		for (let i = 0; i < plan.localSinks.length; i++) if (plan.localSinks[i] !== this.sinks[i]) return false;
+		const parentPlan = this.parent != null && this.parentSinks === "inherit" ? this.parent.getSinkDispatchPlan(level) : void 0;
+		return plan.parentPlan === parentPlan;
+	}
+	createSinkDispatchPlan(level, parentPlan) {
+		const state = {
+			localSinks: [...this.sinks],
+			parentSinks: this.parentSinks,
+			lowestLevel: this.lowestLevel,
+			parentPlan
+		};
+		if (state.lowestLevel === null) return {
+			...state,
+			kind: "none"
+		};
+		if (compareLogLevel(level, state.lowestLevel) < 0) return {
+			...state,
+			kind: "none"
+		};
+		let firstSink;
+		let sinks;
+		const appendSink = (sink) => {
+			if (sinks != null) sinks.push(sink);
+			else if (firstSink == null) firstSink = sink;
+			else sinks = [firstSink, sink];
+		};
+		if (parentPlan != null) {
+			if (parentPlan.kind === "one") firstSink = parentPlan.sink;
+			else if (parentPlan.kind === "many") sinks = [...parentPlan.sinks];
+		}
+		for (const sink of state.localSinks) appendSink(sink);
+		if (sinks != null) return {
+			...state,
+			kind: "many",
+			sinks
+		};
+		if (firstSink != null) return {
+			...state,
+			kind: "one",
+			sink: firstSink
+		};
+		return {
+			...state,
+			kind: "none"
+		};
 	}
 	isEnabledFor(level) {
 		const categoryPrefix = isMetaLoggerCategory(this.category) ? [] : getCategoryPrefix();
@@ -203,14 +302,17 @@ var LoggerImpl = class LoggerImpl {
 		return dispatcher.isEnabledForResolved(level);
 	}
 	isEnabledForResolved(level) {
-		if (this.lowestLevel === null || compareLogLevel(level, this.lowestLevel) < 0) return false;
-		for (const _ of this.getSinks(level)) return true;
-		return false;
+		return this.getSinkDispatchPlan(level).kind !== "none";
 	}
 	emit(record, bypassSinks) {
-		const baseCategory = "category" in record ? record.category : this.category;
+		const hasCategory = "category" in record;
+		const baseCategory = hasCategory ? record.category : this.category;
 		const categoryPrefix = isMetaLoggerCategory(baseCategory) ? [] : getCategoryPrefix();
 		const fullCategory = categoryPrefix.length > 0 ? [...categoryPrefix, ...baseCategory] : baseCategory;
+		if (categoryPrefix.length < 1 && Object.prototype.hasOwnProperty.call(record, "category")) {
+			this.emitResolved(record, bypassSinks);
+			return;
+		}
 		const descriptors = Object.getOwnPropertyDescriptors(record);
 		descriptors.category = {
 			value: fullCategory,
@@ -223,14 +325,36 @@ var LoggerImpl = class LoggerImpl {
 	}
 	emitResolved(record, bypassSinks) {
 		if (this.lowestLevel === null || compareLogLevel(record.level, this.lowestLevel) < 0 || !this.filter(record)) return;
-		const sinks = [...this.getSinks(record.level)];
-		if (sinks.length < 1) return;
+		const plan = this.getSinkDispatchPlan(record.level);
+		if (plan.kind === "none") return;
 		let snapshot;
 		let snapshotFailed = false;
-		for (const sink of sinks) {
+		if (plan.kind === "one") {
+			const sink = plan.sink;
+			if (bypassSinks?.has(sink)) return;
+			try {
+				if (shouldSnapshotForSink(sink)) try {
+					snapshot = snapshotLogRecordProperties(record);
+				} catch {
+					snapshotFailed = true;
+					snapshot = record;
+				}
+				sink(snapshot ?? record);
+			} catch (error) {
+				const bypassSinks2 = new Set(bypassSinks);
+				bypassSinks2.add(sink);
+				metaLogger.log("fatal", "Failed to emit a log record to sink {sink}: {error}", {
+					sink,
+					error,
+					record
+				}, bypassSinks2);
+			}
+			return;
+		}
+		for (const sink of plan.sinks) {
 			if (bypassSinks?.has(sink)) continue;
 			try {
-				if (snapshot == null && !snapshotFailed) try {
+				if (snapshot == null && !snapshotFailed && shouldSnapshotForSink(sink)) try {
 					snapshot = snapshotLogRecordProperties(record);
 				} catch {
 					snapshotFailed = true;
@@ -249,7 +373,20 @@ var LoggerImpl = class LoggerImpl {
 		}
 	}
 	log(level, rawMessage, properties, bypassSinks) {
-		const implicitContext = getImplicitContext();
+		const implicitContext = getImplicitContextIfAny();
+		if (typeof properties !== "function" && implicitContext == null && !rawMessage.includes("{") && !hasEnumerableProperties(properties)) {
+			const record$1 = {
+				category: this.category,
+				level,
+				message: [rawMessage],
+				rawMessage,
+				timestamp: Date.now(),
+				properties: {}
+			};
+			resolvedStringLogRecords.add(record$1);
+			this.emit(record$1, bypassSinks);
+			return;
+		}
 		let cachedProps = void 0;
 		let cachedMessage = void 0;
 		const record = typeof properties === "function" ? {
@@ -263,7 +400,7 @@ var LoggerImpl = class LoggerImpl {
 			rawMessage,
 			get properties() {
 				if (cachedProps == null) cachedProps = resolveProperties({
-					...implicitContext,
+					...implicitContext ?? {},
 					...properties()
 				});
 				return cachedProps;
@@ -279,16 +416,17 @@ var LoggerImpl = class LoggerImpl {
 			rawMessage,
 			get properties() {
 				if (cachedProps == null) cachedProps = resolveProperties({
-					...implicitContext,
+					...implicitContext ?? {},
 					...properties
 				});
 				return cachedProps;
 			}
 		};
+		internalStringLogRecords.add(record);
 		this.emit(record, bypassSinks);
 	}
 	logLazily(level, callback, properties = {}) {
-		const implicitContext = getImplicitContext();
+		const implicitContext = getImplicitContextIfAny();
 		let rawMessage = void 0;
 		let msg = void 0;
 		function realizeMessage() {
@@ -312,13 +450,13 @@ var LoggerImpl = class LoggerImpl {
 			},
 			timestamp: Date.now(),
 			properties: {
-				...implicitContext,
+				...implicitContext ?? {},
 				...properties
 			}
 		});
 	}
 	logTemplate(level, messageTemplate, values, properties = {}) {
-		const implicitContext = getImplicitContext();
+		const implicitContext = getImplicitContextIfAny();
 		this.emit({
 			category: this.category,
 			level,
@@ -326,7 +464,7 @@ var LoggerImpl = class LoggerImpl {
 			rawMessage: messageTemplate,
 			timestamp: Date.now(),
 			properties: {
-				...implicitContext,
+				...implicitContext ?? {},
 				...properties
 			}
 		});