@loglayer/log-level-manager-one-way 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Theo Gravity
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# One Way Log Level Manager for LogLayer
+
+[![NPM Version](https://img.shields.io/npm/v/%40loglayer%2Flog-level-manager-one-way)](https://www.npmjs.com/package/@loglayer/log-level-manager-one-way)
+[![NPM Downloads](https://img.shields.io/npm/dm/%40loglayer%2Flog-level-manager-one-way)](https://www.npmjs.com/package/@loglayer/log-level-manager-one-way)
+[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
+
+A log level manager for [LogLayer](https://loglayer.dev) that keeps log levels synchronized between parent and children. Parent changes affect children, but child changes do not affect parents.
+
+## Installation
+
+```bash
+npm install @loglayer/log-level-manager-one-way
+```
+
+## Usage
+
+```typescript
+import { LogLayer, ConsoleTransport, LogLevel } from "loglayer";
+import { OneWayLogLevelManager } from '@loglayer/log-level-manager-one-way';
+
+const parentLog = new LogLayer({
+  transport: new ConsoleTransport({
+    logger: console
+  }),
+}).withLogLevelManager(new OneWayLogLevelManager());
+
+const childLog = parentLog.child();
+
+// Parent changes affect children
+parentLog.setLevel(LogLevel.warn);
+childLog.info('This will not be logged'); // Not logged (affected by parent)
+
+// Child changes do not affect parent
+childLog.setLevel(LogLevel.debug);
+parentLog.debug('This will not be logged'); // Not logged (parent still at warn)
+childLog.debug('This will be logged'); // Logged (child changed to debug)
+```
+
+## Documentation
+
+For more details, visit [https://loglayer.dev/log-level-managers/one-way](https://loglayer.dev/log-level-managers/one-way)
+

package/dist/index.cjs

@@ -0,0 +1,130 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let __loglayer_log_level_manager = require("@loglayer/log-level-manager");
+__loglayer_log_level_manager = __toESM(__loglayer_log_level_manager);
+
+//#region src/OneWayLogLevelManager.ts
+/**
+* A log level manager that keeps log levels synchronized between parent and children.
+* Parent changes affect children, but child changes do not affect parents.
+* Changes only apply to a parent and their children (not separate instances).
+*/
+var OneWayLogLevelManager = class OneWayLogLevelManager {
+	logLevelContainer = { status: {
+		info: true,
+		warn: true,
+		error: true,
+		debug: true,
+		trace: true,
+		fatal: true
+	} };
+	parentManager = null;
+	childManagers = /* @__PURE__ */ new Set();
+	/**
+	* Sets the minimum log level to be used by the logger. Only messages with
+	* this level or higher severity will be logged.
+	* If this is a parent, the change applies to all its children.
+	* If this is a child, the change only applies to this instance.
+	*/
+	setLevel(logLevel) {
+		const minLogValue = __loglayer_log_level_manager.LogLevelPriority[logLevel];
+		for (const level of Object.values(__loglayer_log_level_manager.LogLevel)) {
+			const levelKey = level;
+			const levelValue = __loglayer_log_level_manager.LogLevelPriority[level];
+			this.logLevelContainer.status[levelKey] = levelValue >= minLogValue;
+		}
+		if (this.childManagers.size > 0) for (const child of this.childManagers) child.setLevel(logLevel);
+	}
+	/**
+	* Enables a specific log level.
+	* If this is a parent, the change applies to all its children.
+	* If this is a child, the change only applies to this instance.
+	*/
+	enableIndividualLevel(logLevel) {
+		const level = logLevel;
+		if (level in this.logLevelContainer.status) this.logLevelContainer.status[level] = true;
+		if (this.childManagers.size > 0) for (const child of this.childManagers) child.enableIndividualLevel(logLevel);
+	}
+	/**
+	* Disables a specific log level.
+	* If this is a parent, the change applies to all its children.
+	* If this is a child, the change only applies to this instance.
+	*/
+	disableIndividualLevel(logLevel) {
+		const level = logLevel;
+		if (level in this.logLevelContainer.status) this.logLevelContainer.status[level] = false;
+		if (this.childManagers.size > 0) for (const child of this.childManagers) child.disableIndividualLevel(logLevel);
+	}
+	/**
+	* Checks if a specific log level is enabled
+	*/
+	isLevelEnabled(logLevel) {
+		const level = logLevel;
+		return this.logLevelContainer.status[level];
+	}
+	/**
+	* Enable sending logs to the logging library.
+	* If this is a parent, the change applies to all its children.
+	* If this is a child, the change only applies to this instance.
+	*/
+	enableLogging() {
+		for (const level of Object.keys(this.logLevelContainer.status)) this.logLevelContainer.status[level] = true;
+		if (this.childManagers.size > 0) for (const child of this.childManagers) child.enableLogging();
+	}
+	/**
+	* All logging inputs are dropped and stops sending logs to the logging library.
+	* If this is a parent, the change applies to all its children.
+	* If this is a child, the change only applies to this instance.
+	*/
+	disableLogging() {
+		for (const level of Object.keys(this.logLevelContainer.status)) this.logLevelContainer.status[level] = false;
+		if (this.childManagers.size > 0) for (const child of this.childManagers) child.disableLogging();
+	}
+	/**
+	* Links the child log level manager to the parent.
+	* The child gets its own container initialized from the parent's status.
+	* Parent changes will propagate to children, but child changes won't affect the parent.
+	*/
+	onChildLoggerCreated({ parentLogLevelManager, childLogLevelManager }) {
+		if (childLogLevelManager instanceof OneWayLogLevelManager && parentLogLevelManager instanceof OneWayLogLevelManager) {
+			const child = childLogLevelManager;
+			const parent = parentLogLevelManager;
+			child.logLevelContainer.status = { ...parent.logLevelContainer.status };
+			child.parentManager = parent;
+			parent.childManagers.add(child);
+		}
+	}
+	/**
+	* Creates a new instance of the log level manager with its own container.
+	* The clone is independent and not linked to the original.
+	*/
+	clone() {
+		const clone = new OneWayLogLevelManager();
+		clone.logLevelContainer.status = { ...this.logLevelContainer.status };
+		return clone;
+	}
+};
+
+//#endregion
+exports.OneWayLogLevelManager = OneWayLogLevelManager;

package/dist/index.d.cts

@@ -0,0 +1,65 @@
+import { ILogLevelManager, LogLevelType, OnChildLogLevelManagerCreatedParams } from "@loglayer/log-level-manager";
+
+//#region src/OneWayLogLevelManager.d.ts
+
+/**
+ * A log level manager that keeps log levels synchronized between parent and children.
+ * Parent changes affect children, but child changes do not affect parents.
+ * Changes only apply to a parent and their children (not separate instances).
+ */
+declare class OneWayLogLevelManager implements ILogLevelManager {
+  private logLevelContainer;
+  private parentManager;
+  private childManagers;
+  /**
+   * Sets the minimum log level to be used by the logger. Only messages with
+   * this level or higher severity will be logged.
+   * If this is a parent, the change applies to all its children.
+   * If this is a child, the change only applies to this instance.
+   */
+  setLevel(logLevel: LogLevelType): void;
+  /**
+   * Enables a specific log level.
+   * If this is a parent, the change applies to all its children.
+   * If this is a child, the change only applies to this instance.
+   */
+  enableIndividualLevel(logLevel: LogLevelType): void;
+  /**
+   * Disables a specific log level.
+   * If this is a parent, the change applies to all its children.
+   * If this is a child, the change only applies to this instance.
+   */
+  disableIndividualLevel(logLevel: LogLevelType): void;
+  /**
+   * Checks if a specific log level is enabled
+   */
+  isLevelEnabled(logLevel: LogLevelType): boolean;
+  /**
+   * Enable sending logs to the logging library.
+   * If this is a parent, the change applies to all its children.
+   * If this is a child, the change only applies to this instance.
+   */
+  enableLogging(): void;
+  /**
+   * All logging inputs are dropped and stops sending logs to the logging library.
+   * If this is a parent, the change applies to all its children.
+   * If this is a child, the change only applies to this instance.
+   */
+  disableLogging(): void;
+  /**
+   * Links the child log level manager to the parent.
+   * The child gets its own container initialized from the parent's status.
+   * Parent changes will propagate to children, but child changes won't affect the parent.
+   */
+  onChildLoggerCreated({
+    parentLogLevelManager,
+    childLogLevelManager
+  }: OnChildLogLevelManagerCreatedParams): void;
+  /**
+   * Creates a new instance of the log level manager with its own container.
+   * The clone is independent and not linked to the original.
+   */
+  clone(): ILogLevelManager;
+}
+//#endregion
+export { OneWayLogLevelManager };

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+import { ILogLevelManager, LogLevelType, OnChildLogLevelManagerCreatedParams } from "@loglayer/log-level-manager";
+
+//#region src/OneWayLogLevelManager.d.ts
+
+/**
+ * A log level manager that keeps log levels synchronized between parent and children.
+ * Parent changes affect children, but child changes do not affect parents.
+ * Changes only apply to a parent and their children (not separate instances).
+ */
+declare class OneWayLogLevelManager implements ILogLevelManager {
+  private logLevelContainer;
+  private parentManager;
+  private childManagers;
+  /**
+   * Sets the minimum log level to be used by the logger. Only messages with
+   * this level or higher severity will be logged.
+   * If this is a parent, the change applies to all its children.
+   * If this is a child, the change only applies to this instance.
+   */
+  setLevel(logLevel: LogLevelType): void;
+  /**
+   * Enables a specific log level.
+   * If this is a parent, the change applies to all its children.
+   * If this is a child, the change only applies to this instance.
+   */
+  enableIndividualLevel(logLevel: LogLevelType): void;
+  /**
+   * Disables a specific log level.
+   * If this is a parent, the change applies to all its children.
+   * If this is a child, the change only applies to this instance.
+   */
+  disableIndividualLevel(logLevel: LogLevelType): void;
+  /**
+   * Checks if a specific log level is enabled
+   */
+  isLevelEnabled(logLevel: LogLevelType): boolean;
+  /**
+   * Enable sending logs to the logging library.
+   * If this is a parent, the change applies to all its children.
+   * If this is a child, the change only applies to this instance.
+   */
+  enableLogging(): void;
+  /**
+   * All logging inputs are dropped and stops sending logs to the logging library.
+   * If this is a parent, the change applies to all its children.
+   * If this is a child, the change only applies to this instance.
+   */
+  disableLogging(): void;
+  /**
+   * Links the child log level manager to the parent.
+   * The child gets its own container initialized from the parent's status.
+   * Parent changes will propagate to children, but child changes won't affect the parent.
+   */
+  onChildLoggerCreated({
+    parentLogLevelManager,
+    childLogLevelManager
+  }: OnChildLogLevelManagerCreatedParams): void;
+  /**
+   * Creates a new instance of the log level manager with its own container.
+   * The clone is independent and not linked to the original.
+   */
+  clone(): ILogLevelManager;
+}
+//#endregion
+export { OneWayLogLevelManager };

package/dist/index.js

@@ -0,0 +1,106 @@
+import { LogLevel, LogLevelPriority } from "@loglayer/log-level-manager";
+
+//#region src/OneWayLogLevelManager.ts
+/**
+* A log level manager that keeps log levels synchronized between parent and children.
+* Parent changes affect children, but child changes do not affect parents.
+* Changes only apply to a parent and their children (not separate instances).
+*/
+var OneWayLogLevelManager = class OneWayLogLevelManager {
+	logLevelContainer = { status: {
+		info: true,
+		warn: true,
+		error: true,
+		debug: true,
+		trace: true,
+		fatal: true
+	} };
+	parentManager = null;
+	childManagers = /* @__PURE__ */ new Set();
+	/**
+	* Sets the minimum log level to be used by the logger. Only messages with
+	* this level or higher severity will be logged.
+	* If this is a parent, the change applies to all its children.
+	* If this is a child, the change only applies to this instance.
+	*/
+	setLevel(logLevel) {
+		const minLogValue = LogLevelPriority[logLevel];
+		for (const level of Object.values(LogLevel)) {
+			const levelKey = level;
+			const levelValue = LogLevelPriority[level];
+			this.logLevelContainer.status[levelKey] = levelValue >= minLogValue;
+		}
+		if (this.childManagers.size > 0) for (const child of this.childManagers) child.setLevel(logLevel);
+	}
+	/**
+	* Enables a specific log level.
+	* If this is a parent, the change applies to all its children.
+	* If this is a child, the change only applies to this instance.
+	*/
+	enableIndividualLevel(logLevel) {
+		const level = logLevel;
+		if (level in this.logLevelContainer.status) this.logLevelContainer.status[level] = true;
+		if (this.childManagers.size > 0) for (const child of this.childManagers) child.enableIndividualLevel(logLevel);
+	}
+	/**
+	* Disables a specific log level.
+	* If this is a parent, the change applies to all its children.
+	* If this is a child, the change only applies to this instance.
+	*/
+	disableIndividualLevel(logLevel) {
+		const level = logLevel;
+		if (level in this.logLevelContainer.status) this.logLevelContainer.status[level] = false;
+		if (this.childManagers.size > 0) for (const child of this.childManagers) child.disableIndividualLevel(logLevel);
+	}
+	/**
+	* Checks if a specific log level is enabled
+	*/
+	isLevelEnabled(logLevel) {
+		const level = logLevel;
+		return this.logLevelContainer.status[level];
+	}
+	/**
+	* Enable sending logs to the logging library.
+	* If this is a parent, the change applies to all its children.
+	* If this is a child, the change only applies to this instance.
+	*/
+	enableLogging() {
+		for (const level of Object.keys(this.logLevelContainer.status)) this.logLevelContainer.status[level] = true;
+		if (this.childManagers.size > 0) for (const child of this.childManagers) child.enableLogging();
+	}
+	/**
+	* All logging inputs are dropped and stops sending logs to the logging library.
+	* If this is a parent, the change applies to all its children.
+	* If this is a child, the change only applies to this instance.
+	*/
+	disableLogging() {
+		for (const level of Object.keys(this.logLevelContainer.status)) this.logLevelContainer.status[level] = false;
+		if (this.childManagers.size > 0) for (const child of this.childManagers) child.disableLogging();
+	}
+	/**
+	* Links the child log level manager to the parent.
+	* The child gets its own container initialized from the parent's status.
+	* Parent changes will propagate to children, but child changes won't affect the parent.
+	*/
+	onChildLoggerCreated({ parentLogLevelManager, childLogLevelManager }) {
+		if (childLogLevelManager instanceof OneWayLogLevelManager && parentLogLevelManager instanceof OneWayLogLevelManager) {
+			const child = childLogLevelManager;
+			const parent = parentLogLevelManager;
+			child.logLevelContainer.status = { ...parent.logLevelContainer.status };
+			child.parentManager = parent;
+			parent.childManagers.add(child);
+		}
+	}
+	/**
+	* Creates a new instance of the log level manager with its own container.
+	* The clone is independent and not linked to the original.
+	*/
+	clone() {
+		const clone = new OneWayLogLevelManager();
+		clone.logLevelContainer.status = { ...this.logLevelContainer.status };
+		return clone;
+	}
+};
+
+//#endregion
+export { OneWayLogLevelManager };

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@loglayer/log-level-manager-one-way",
+  "description": "Log level manager for loglayer that keeps log levels synchronized between parent and children (parent changes affect children, but child changes don't affect parents).",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "exports": {
+    "import": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "require": {
+      "types": "./dist/index.d.cts",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/loglayer/loglayer.git",
+    "directory": "packages/log-level-managers/one-way"
+  },
+  "author": "Theo Gravity <theo@suteki.nu>",
+  "keywords": [
+    "logging",
+    "log",
+    "loglayer",
+    "log level",
+    "one-way",
+    "log level manager"
+  ],
+  "dependencies": {
+    "@loglayer/log-level-manager": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.1",
+    "tsdown": "0.15.12",
+    "typescript": "5.9.3",
+    "vitest": "4.0.9",
+    "@internal/tsconfig": "2.1.0",
+    "loglayer": "8.0.0"
+  },
+  "bugs": "https://github.com/loglayer/loglayer/issues",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "homepage": "https://loglayer.dev",
+  "scripts": {
+    "build": "tsdown src/index.ts",
+    "test": "vitest --run",
+    "clean": "rm -rf .turbo node_modules dist",
+    "lint": "biome check --no-errors-on-unmatched --write --unsafe src",
+    "lint:staged": "biome check --no-errors-on-unmatched --write --unsafe --staged src",
+    "verify-types": "tsc --noEmit"
+  }
+}