@spinajs/log 2.0.481 → 2.0.484

package/lib/mjs/perf/LogMetricSink.js

@@ -0,0 +1,151 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Singleton, Injectable } from "@spinajs/di";
+import { Config } from "@spinajs/configuration";
+import { Logger, Log, PerfSink } from "@spinajs/log-common";
+/**
+ * Default {@link PerfSink}: renders perf measurements as structured log entries
+ * through the normal targets/filters/rules pipeline, on a dedicated `perf`
+ * logger. Spans over their per-name threshold log at `warn`; under-threshold
+ * spans log at `trace` ( kept for on-demand visibility, cheaply gated out when
+ * trace routing is off ). Rollups log one `info` line.
+ */
+let LogMetricSink = class LogMetricSink extends PerfSink {
+    logsUnderThreshold(name) {
+        const setting = this.LogUnderThreshold ?? false;
+        return Array.isArray(setting) ? setting.includes(name) : setting === true;
+    }
+    thresholdFor(name) {
+        const t = this.Thresholds ?? {};
+        return t[name] ?? t.default ?? 0;
+    }
+    /**
+     * Renders the statement into the message. The `sql` field is already attached to
+     * the entry, but most console layouts print only `${message}`, so
+     * "Slow orm.query: 251.1ms" on its own gives no way to tell WHICH query it was.
+     *
+     * Bindings are deliberately left out of the message - they routinely hold
+     * passwords, tokens and personal data. They stay in the structured fields, where a
+     * target can opt into them.
+     */
+    sqlSuffix(fields) {
+        const sql = fields.sql;
+        if (typeof sql !== "string" || sql.trim().length === 0) {
+            return "";
+        }
+        const flattened = sql.replace(/\s+/g, " ").trim();
+        const max = this.SqlMaxLength ?? 2000;
+        const clipped = flattened.length > max ? `${flattened.slice(0, max)}...` : flattened;
+        return ` - ${clipped}`;
+    }
+    collect(metric) {
+        if (!this.Enabled)
+            return;
+        if (metric.kind === "span") {
+            const dur = metric.durationMs ?? 0;
+            // `metric.fields` already carries `error` for a failed span ( set by the
+            // facade ), so the log's error serializer runs when this object is logged.
+            const fields = { durationMs: dur, ...(metric.labels ?? {}), ...(metric.fields ?? {}) };
+            if (metric.error !== undefined) {
+                this.emitAt("error", `${metric.name} failed after ${dur.toFixed(1)}ms${this.sqlSuffix(fields)}`, fields);
+                return;
+            }
+            const threshold = this.thresholdFor(metric.name);
+            const slow = threshold > 0 && dur >= threshold;
+            if (!slow && !this.logsUnderThreshold(metric.name)) {
+                return;
+            }
+            const level = slow ? this.OverLevel : this.UnderLevel;
+            this.emitAt(level, `${slow ? "Slow " : ""}${metric.name}: ${dur.toFixed(1)}ms${this.sqlSuffix(fields)}`, fields);
+            return;
+        }
+        if (this.LogCounters && (metric.kind === "counter" || metric.kind === "value")) {
+            this.emitAt("trace", `${metric.name}=${metric.value}`, { ...(metric.labels ?? {}) });
+        }
+    }
+    onScopeEnd(rollup) {
+        if (!this.Enabled)
+            return;
+        const parts = Object.entries(rollup.byName)
+            .map(([n, e]) => `${n} x${e.count} ${e.totalMs.toFixed(0)}ms`)
+            .join(", ");
+        const tag = rollup.requestId ? ` [${rollup.requestId}]` : "";
+        this.emitAt("info", `perf rollup${tag}: ${parts || "no measurements"}`, {
+            requestId: rollup.requestId,
+            totalMs: rollup.totalMs,
+            byName: rollup.byName,
+            ...(rollup.labels ?? {}),
+        });
+    }
+    /**
+     * Emit through the log's MERGING-OBJECT form ( fields object FIRST, then the
+     * message string ) so the structured variables ( durationMs, labels, sql,
+     * error ) are attached to the entry. The `@spinajs/log` API treats a trailing
+     * object as a printf argument, so passing fields last would silently drop
+     * them. See the `warn(fields, message?)` overload on the `Log` base class.
+     */
+    emitAt(level, message, fields) {
+        switch (level) {
+            case "error":
+                this.Log.error(fields, message);
+                break;
+            case "warn":
+                this.Log.warn(fields, message);
+                break;
+            case "info":
+                this.Log.info(fields, message);
+                break;
+            case "debug":
+                this.Log.debug(fields, message);
+                break;
+            default:
+                this.Log.trace(fields, message);
+                break;
+        }
+    }
+};
+__decorate([
+    Logger("perf"),
+    __metadata("design:type", Log)
+], LogMetricSink.prototype, "Log", void 0);
+__decorate([
+    Config("logger.perf.enabled", { defaultValue: true }),
+    __metadata("design:type", Boolean)
+], LogMetricSink.prototype, "Enabled", void 0);
+__decorate([
+    Config("logger.perf.thresholds", { defaultValue: { "orm.query": 200, "http.request": 1000, default: 0 } }),
+    __metadata("design:type", Object)
+], LogMetricSink.prototype, "Thresholds", void 0);
+__decorate([
+    Config("logger.perf.overThresholdLevel", { defaultValue: "warn" }),
+    __metadata("design:type", String)
+], LogMetricSink.prototype, "OverLevel", void 0);
+__decorate([
+    Config("logger.perf.underThresholdLevel", { defaultValue: "trace" }),
+    __metadata("design:type", String)
+], LogMetricSink.prototype, "UnderLevel", void 0);
+__decorate([
+    Config("logger.perf.logCounters", { defaultValue: false }),
+    __metadata("design:type", Boolean)
+], LogMetricSink.prototype, "LogCounters", void 0);
+__decorate([
+    Config("logger.perf.sqlMaxLength", { defaultValue: 2000 }),
+    __metadata("design:type", Number)
+], LogMetricSink.prototype, "SqlMaxLength", void 0);
+__decorate([
+    Config("logger.perf.logUnderThreshold", { defaultValue: false }),
+    __metadata("design:type", Object)
+], LogMetricSink.prototype, "LogUnderThreshold", void 0);
+LogMetricSink = __decorate([
+    Singleton(),
+    Injectable(PerfSink)
+], LogMetricSink);
+export { LogMetricSink };
+//# sourceMappingURL=LogMetricSink.js.map

package/lib/mjs/perf/LogMetricSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogMetricSink.js","sourceRoot":"","sources":["../../../src/perf/LogMetricSink.ts"],"names":[],"mappings":"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"}

package/lib/mjs/perf/measure.d.ts

@@ -0,0 +1,9 @@
+import { IMeasureOpts } from "@spinajs/log-common";
+/**
+ * Method decorator that times the wrapped method via {@link Perf.measure}. Name
+ * defaults to `${ClassName}.${method}`. Works for sync and async methods ( the
+ * facade awaits a returned thenable ). Uses the same legacy-decorator signature
+ * as the rest of the framework ( `experimentalDecorators` ).
+ */
+export declare function Measure(name?: string, opts?: IMeasureOpts): (target: object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=measure.d.ts.map

package/lib/mjs/perf/measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../../src/perf/measure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,IACvC,QAAQ,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,EAAE,YAAY,kBAAkB,KAAG,kBAAkB,CAQnH"}

package/lib/mjs/perf/measure.js

@@ -0,0 +1,18 @@
+import { Perf } from "@spinajs/log-common";
+/**
+ * Method decorator that times the wrapped method via {@link Perf.measure}. Name
+ * defaults to `${ClassName}.${method}`. Works for sync and async methods ( the
+ * facade awaits a returned thenable ). Uses the same legacy-decorator signature
+ * as the rest of the framework ( `experimentalDecorators` ).
+ */
+export function Measure(name, opts) {
+    return function (target, propertyKey, descriptor) {
+        const original = descriptor.value;
+        const metricName = name ?? `${target.constructor.name}.${String(propertyKey)}`;
+        descriptor.value = function (...args) {
+            return Perf.measure(metricName, () => original.apply(this, args), opts);
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=measure.js.map

package/lib/mjs/perf/measure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.js","sourceRoot":"","sources":["../../../src/perf/measure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgB,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAa,EAAE,IAAmB;IACxD,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,UAA8B;QAC3F,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAwC,CAAC;QACrE,MAAM,UAAU,GAAG,IAAI,IAAI,GAAI,MAA4C,CAAC,WAAW,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACtH,UAAU,CAAC,KAAK,GAAG,UAAyB,GAAG,IAAe;YAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAC1E,CAAC,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/lib/mjs/perf.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Install the per-request perf-scope backend for the node runtime. Reads the
+ * `perf` accumulator off the ambient async store ( which IS `req.storage` when
+ * http runs an action, so the scope created by the http PerfRollup middleware
+ * and mutated during the action is one and the same object ). Called from
+ * {@link LogBotstrapper.bootstrap}.
+ */
+export declare function wirePerfScope(): void;
+//# sourceMappingURL=perf.d.ts.map

package/lib/mjs/perf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf.d.ts","sourceRoot":"","sources":["../../src/perf.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAIpC"}

package/lib/mjs/perf.js

@@ -0,0 +1,15 @@
+import { setPerfScopeBackend } from "@spinajs/log-common";
+import { LogContext } from "./context.js";
+/**
+ * Install the per-request perf-scope backend for the node runtime. Reads the
+ * `perf` accumulator off the ambient async store ( which IS `req.storage` when
+ * http runs an action, so the scope created by the http PerfRollup middleware
+ * and mutated during the action is one and the same object ). Called from
+ * {@link LogBotstrapper.bootstrap}.
+ */
+export function wirePerfScope() {
+    setPerfScopeBackend({
+        get: () => LogContext.active().perf ?? null,
+    });
+}
+//# sourceMappingURL=perf.js.map

package/lib/mjs/perf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf.js","sourceRoot":"","sources":["../../src/perf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAc,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa;IAC3B,mBAAmB,CAAC;QAClB,GAAG,EAAE,GAAG,EAAE,CAAE,UAAU,CAAC,MAAM,EAAE,CAAC,IAA+B,IAAI,IAAI;KACxE,CAAC,CAAC;AACL,CAAC"}

package/lib/mjs/schemas/log.configuration.d.ts

@@ -24,29 +24,153 @@ declare const CONFIGURATION_SCHEMA: {
                     enabled: {
                         type: string;
                     };
-                    path: {
-                        type: string;
-                    };
-                    archivePath: {
-                        type: string;
-                    };
-                    maxSize: {
-                        type: string;
-                        minimum: number;
-                    };
-                    compress: {
-                        type: string;
-                    };
-                    rotate: {
+                    filters: {
+                        description: string;
                         type: string;
+                        items: {
+                            type: string;
+                            properties: {
+                                type: {
+                                    description: string;
+                                    type: string;
+                                };
+                            };
+                            required: string[];
+                        };
                     };
-                    maxArchiveFiles: {
+                    options: {
                         type: string;
-                        minimum: number;
+                        properties: {
+                            path: {
+                                description: string;
+                                type: string;
+                            };
+                            archivePath: {
+                                description: string;
+                                type: string;
+                            };
+                            fs: {
+                                description: string;
+                                type: string;
+                            };
+                            archiveFs: {
+                                description: string;
+                                type: string;
+                            };
+                            archiveStrategy: {
+                                description: string;
+                                type: string;
+                            };
+                            retentionStrategies: {
+                                description: string;
+                                type: string;
+                                items: {
+                                    type: string;
+                                };
+                            };
+                            maxSize: {
+                                description: string;
+                                type: string;
+                                minimum: number;
+                            };
+                            compress: {
+                                description: string;
+                                type: string;
+                            };
+                            rotate: {
+                                description: string;
+                                type: string;
+                            };
+                            maxBufferSize: {
+                                description: string;
+                                type: string;
+                                minimum: number;
+                            };
+                            maxQueueSize: {
+                                description: string;
+                                type: string;
+                                minimum: number;
+                            };
+                            maxArchiveFiles: {
+                                description: string;
+                                type: string;
+                                minimum: number;
+                            };
+                            maxAge: {
+                                description: string;
+                                type: string;
+                                minimum: number;
+                            };
+                            archiveInterval: {
+                                description: string;
+                                type: string;
+                                minimum: number;
+                            };
+                            flushInterval: {
+                                description: string;
+                                type: string;
+                                minimum: number;
+                            };
+                        };
+                        required: string[];
                     };
-                    bufferSize: {
+                };
+                required: string[];
+            };
+        };
+        file: {
+            description: string;
+            type: string;
+        };
+        perf: {
+            description: string;
+            type: string;
+            properties: {
+                enabled: {
+                    type: string;
+                };
+                thresholds: {
+                    description: string;
+                    type: string;
+                };
+                overThresholdLevel: {
+                    type: string;
+                    enum: string[];
+                };
+                underThresholdLevel: {
+                    type: string;
+                    enum: string[];
+                };
+                logCounters: {
+                    type: string;
+                };
+            };
+        };
+        whenRepeated: {
+            description: string;
+            type: string;
+            properties: {
+                timeout: {
+                    description: string;
+                    type: string;
+                    minimum: number;
+                };
+                maxKeys: {
+                    description: string;
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        filters: {
+            description: string;
+            type: string;
+            items: {
+                type: string;
+                properties: {
+                    type: {
+                        description: string;
                         type: string;
-                        minimum: number;
                     };
                 };
                 required: string[];
@@ -67,6 +191,11 @@ declare const CONFIGURATION_SCHEMA: {
                         type: string;
                         enum: string[];
                     };
+                    maxLevel: {
+                        description: string;
+                        type: string;
+                        enum: string[];
+                    };
                     target: {
                         oneOf: ({
                             type: string;
@@ -78,6 +207,10 @@ declare const CONFIGURATION_SCHEMA: {
                             };
                         })[];
                     };
+                    final: {
+                        description: string;
+                        type: string;
+                    };
                 };
                 required: string[];
             };

package/lib/mjs/schemas/log.configuration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log.configuration.d.ts","sourceRoot":"","sources":["../../../src/schemas/log.configuration.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiGzB,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"log.configuration.d.ts","sourceRoot":"","sources":["../../../src/schemas/log.configuration.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0PzB,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/lib/mjs/schemas/log.configuration.js

@@ -24,32 +24,147 @@ const CONFIGURATION_SCHEMA = {
                     enabled: {
                         type: "boolean",
                     },
-                    path: {
-                        type: "string",
-                    },
-                    archivePath: {
-                        type: "string",
-                    },
-                    maxSize: {
-                        type: "integer",
-                        minimum: 10000,
+                    filters: {
+                        description: "Per-target filter pipeline, applied only when writing to THIS target ( after the logger-level filters ). Each item is { type, ...opts } where `type` is the DI name of a LogFilter. Any returning null drops the entry for this target only.",
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                type: {
+                                    description: "DI string name of the registered LogFilter.",
+                                    type: "string",
+                                },
+                            },
+                            required: ["type"],
+                        },
                     },
-                    compress: {
-                        type: "boolean",
+                    // FileTarget options ( nested under `options` )
+                    options: {
+                        type: "object",
+                        properties: {
+                            path: {
+                                description: "Active log path, relative to the `fs` provider base path. Variables allowed.",
+                                type: "string",
+                            },
+                            archivePath: {
+                                description: "Archive directory, relative to the `archiveFs` provider base path. Variables allowed.",
+                                type: "string",
+                            },
+                            fs: {
+                                description: "Registered @spinajs/fs provider for the active log. Defaults to 'fs-log-default'.",
+                                type: "string",
+                            },
+                            archiveFs: {
+                                description: "Registered @spinajs/fs provider archives are moved to. Defaults to `fs`.",
+                                type: "string",
+                            },
+                            archiveStrategy: {
+                                description: "LogArchiveStrategy class name deciding WHEN to rotate. Default 'SizeLogArchiveStrategy'.",
+                                type: "string",
+                            },
+                            retentionStrategies: {
+                                description: "LogRetentionStrategy class names applied in order after rotation. Default ['CountLogRetentionStrategy'].",
+                                type: "array",
+                                items: {
+                                    type: "string",
+                                },
+                            },
+                            maxSize: {
+                                description: "Max active log size in bytes before rotation.",
+                                type: "integer",
+                                minimum: 1,
+                            },
+                            compress: {
+                                description: "Zip the archived file when moved to the archive.",
+                                type: "boolean",
+                            },
+                            rotate: {
+                                description: "Cron expression for CronLogArchiveStrategy ( 6-field with seconds ).",
+                                type: "string",
+                            },
+                            maxBufferSize: {
+                                description: "Max buffered messages before a flush.",
+                                type: "integer",
+                                minimum: 1,
+                            },
+                            maxQueueSize: {
+                                description: "Hard cap on buffered messages; oldest are dropped past this so a down sink cannot OOM.",
+                                type: "integer",
+                                minimum: 1,
+                            },
+                            maxArchiveFiles: {
+                                description: "How many archives to keep ( CountLogRetentionStrategy ). Oldest are deleted.",
+                                type: "integer",
+                                minimum: 1,
+                            },
+                            maxAge: {
+                                description: "Max archive age in seconds ( AgeLogRetentionStrategy ).",
+                                type: "integer",
+                                minimum: 1,
+                            },
+                            archiveInterval: {
+                                description: "Interval in seconds SizeLogArchiveStrategy checks the active log size.",
+                                type: "integer",
+                                minimum: 1,
+                            },
+                            flushInterval: {
+                                description: "Periodic flush tick in milliseconds for a partially filled buffer.",
+                                type: "integer",
+                                minimum: 1,
+                            },
+                        },
+                        required: ["path"],
                     },
-                    rotate: {
+                },
+                required: ["name", "type"],
+            },
+        },
+        file: {
+            description: "Default FileTarget options ( buffer / rotation / retention tunables ) merged UNDER every file target's own `options`. Shipped by @spinajs/log ( see logger.file defaults ) and overridable by user config.",
+            type: "object",
+        },
+        perf: {
+            description: "Performance-instrumentation ( Perf facade ) options for the default LogMetricSink.",
+            type: "object",
+            properties: {
+                enabled: { type: "boolean" },
+                thresholds: {
+                    description: "Per-metric-name slow threshold in ms. A name not present falls back to `default`; 0 means never slow.",
+                    type: "object",
+                },
+                overThresholdLevel: { type: "string", enum: ["trace", "debug", "info", "warn", "error"] },
+                underThresholdLevel: { type: "string", enum: ["trace", "debug", "info", "warn", "error"] },
+                logCounters: { type: "boolean" },
+            },
+        },
+        whenRepeated: {
+            description: "Opt-in dedup filter. Collapses identical repeated log entries within a timeout window into one, emitting a (xN) count when logging resumes. Off when absent; global for now.",
+            type: "object",
+            properties: {
+                timeout: {
+                    description: "Suppression window in SECONDS. Identical entries within this window are collapsed. Default 10.",
+                    type: "integer",
+                    minimum: 1,
+                },
+                maxKeys: {
+                    description: "Hard cap on tracked keys; the map self-prunes ( expired first, then oldest ) so memory stays bounded. Default 1024.",
+                    type: "integer",
+                    minimum: 1,
+                },
+            },
+        },
+        filters: {
+            description: "Composable per-logger filter pipeline. Each item is { type, ...opts } where `type` is the DI name of a LogFilter ( eg. LevelFilter, MatchFilter, RateLimitFilter, WhenRepeatedFilter ). Filters run in order in write(); any returning null drops the entry.",
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    type: {
+                        description: "DI string name of the registered LogFilter.",
                         type: "string",
                     },
-                    maxArchiveFiles: {
-                        type: "integer",
-                        minimum: 1,
-                    },
-                    bufferSize: {
-                        type: "integer",
-                        minimum: 1000,
-                    },
                 },
-                required: ["name", "type"],
+                required: ["type"],
             },
         },
         rules: {
@@ -76,6 +191,20 @@ const CONFIGURATION_SCHEMA = {
                             "success",
                         ],
                     },
+                    maxLevel: {
+                        description: "Optional INCLUSIVE upper bound of the level window this rule routes. With `level` as the lower bound, only entries in [level, maxLevel] are routed. Defaults to the highest level ( security ).",
+                        type: "string",
+                        enum: [
+                            "trace",
+                            "debug",
+                            "warn",
+                            "info",
+                            "error",
+                            "fatal",
+                            "security",
+                            "success",
+                        ],
+                    },
                     target: {
                         oneOf: [
                             {
@@ -89,6 +218,10 @@ const CONFIGURATION_SCHEMA = {
                             },
                         ],
                     },
+                    final: {
+                        description: "Stop evaluating further rules for a logger once this matching rule is applied ( NLog-style ). Earlier matched rules and this one still apply.",
+                        type: "boolean",
+                    },
                 },
                 required: ["name", "level", "target"],
             },

package/lib/mjs/schemas/log.configuration.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.configuration.js","sourceRoot":"","sources":["../../../src/schemas/log.configuration.ts"],"names":[],"mappings":"AAAA,MAAM,oBAAoB,GAAG;IAC3B,GAAG,EAAE,uCAAuC;IAC5C,oBAAoB,EAAE,QAAQ;IAC9B,WAAW,EAAE,wCAAwC;IACrD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,OAAO,EAAE;YACP,WAAW,EACT,wEAAwE;YAC1E,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;qBACf;oBACD,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;qBACf;oBACD,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;qBACf;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,SAAS;qBAChB;oBACD,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;qBACf;oBACD,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;qBACf;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,KAAK;qBACf;oBACD,QAAQ,EAAE;wBACR,IAAI,EAAE,SAAS;qBAChB;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;qBACf;oBACD,eAAe,EAAE;wBACf,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,CAAC;qBACX;oBACD,UAAU,EAAE;wBACV,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,IAAI;qBACd;iBACF;gBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;aAC3B;SACF;QACD,KAAK,EAAE;YACL,WAAW,EAAE,2CAA2C;YACxD,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;qBACf;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE;4BACJ,OAAO;4BACP,OAAO;4BACP,MAAM;4BACN,MAAM;4BACN,OAAO;4BACP,OAAO;4BACP,UAAU;4BACV,SAAS;yBACV;qBACF;oBACD,MAAM,EAAE;wBACN,KAAK,EAAE;4BACL;gCACE,IAAI,EAAE,QAAQ;6BACf;4BACD;gCACE,IAAI,EAAE,OAAO;gCACb,KAAK,EAAE;oCACL,IAAI,EAAE,QAAQ;iCACf;6BACF;yBACF;qBACF;iBACF;gBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;aACtC;SACF;KACF;CACF,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"log.configuration.js","sourceRoot":"","sources":["../../../src/schemas/log.configuration.ts"],"names":[],"mappings":"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"}