@hkdigital/lib-core 0.4.27 → 0.4.29

package/dist/services/service-manager/ServiceManager.js

@@ -51,11 +51,11 @@
  *
  * @example
  * // Logging control
- * // Set global log level
- * manager.setLogLevel('*', 'DEBUG');
+ * // Set manager log level (affects all services)
+ * manager.setManagerLogLevel('DEBUG');
  *
  * // Set specific service log level
- * manager.setLogLevel('database', 'ERROR');
+ * manager.setServiceLogLevel('database', 'ERROR');
  *
  * // Listen to all service logs
  * manager.on('service:log', (logEvent) => {
@@ -64,7 +64,10 @@
  */
 
 import { EventEmitter } from '../../generic/events.js';
-import { Logger, DEBUG, INFO, WARN } from '../../logging/index.js';
+import { Logger, DEBUG, INFO } from '../../logging/index.js';
+
+import { SERVICE_LOG } from './constants.js';
+import { parseServiceLogLevels } from './util.js';
 
 import {
   STATE_NOT_CREATED,
@@ -103,17 +106,27 @@ export class ServiceManager extends EventEmitter {
     /** @type {Map<string, ServiceEntry>} */
     this.services = new Map();
 
+    const defaultLogLevel = config.defaultLogLevel || (config.debug ? DEBUG : INFO);
+    const managerLogLevel = config.managerLogLevel || defaultLogLevel;
+    const serviceLogLevels = config.serviceLogLevels;
+
     /** @type {Logger} */
-    this.logger = new Logger('ServiceManager', config.logLevel || INFO);
+    this.logger = new Logger('ServiceManager', managerLogLevel);
 
     /** @type {ServiceManagerConfig} */
     this.config = {
       debug: config.debug ?? false,
       autoStart: config.autoStart ?? false,
       stopTimeout: config.stopTimeout || 10000,
-      logConfig: config.logConfig || {}
+      defaultLogLevel,
+      managerLogLevel
+      // serviceLogLevels will be set by setServiceLogLevel()
     };
 
+    if (serviceLogLevels) {
+      this.setServiceLogLevel(serviceLogLevels);
+    }
+
     this.#setupLogging();
   }
 
@@ -474,34 +487,68 @@ export class ServiceManager extends EventEmitter {
   }
 
   /**
-   * Set log level for a service or globally
+   * Listen to log messages emitted by individual services
+   *
+   * @param {Function} listener - Log event handler
    *
-   * @param {string} name - Service name or '*' for global
-   * @param {string} level - Log level to set
+   * @returns {Function} Unsubscribe function
    */
-  setLogLevel(name, level) {
-    if (name === '*') {
-      // Global level
-      this.config.logConfig.globalLevel = level;
-
-      // Apply to all existing services
-      // eslint-disable-next-line no-unused-vars
-      for (const [_, entry] of this.services) {
-        if (entry.instance) {
-          entry.instance.setLogLevel(level);
+  onServiceLogEvent(listener) {
+    return this.on(SERVICE_LOG, listener);
+  }
+
+  /**
+   * Set log level for the ServiceManager itself
+   *
+   * @param {string} level - Log level to set for the ServiceManager
+   */
+  setManagerLogLevel(level) {
+    this.config.managerLogLevel = level;
+    this.logger.setLevel(level);
+  }
+
+  /**
+   * Set log level for individual services
+   *
+   * @param {string|Object<string,string>} nameOrConfig
+   *   Service configuration:
+   *   - String with service name: 'auth' (requires level parameter)
+   *   - String with config: 'auth:debug,database:info'
+   *   - Object: { auth: 'debug', database: 'info' }
+   * @param {string} [level] - Log level (required when nameOrConfig is service name)
+   */
+  setServiceLogLevel(nameOrConfig, level) {
+    /** @type {{[name:string]: string}} */
+    let serviceLevels = {};
+
+    if (typeof nameOrConfig === 'string') {
+      if (nameOrConfig.includes(':')) {
+        // Parse string config: 'auth:debug,database:info'
+        serviceLevels = parseServiceLogLevels(nameOrConfig);
+      } else {
+        // Single service name
+        if (!level) {
+          throw new Error(`Level parameter required for service '${nameOrConfig}'`);
         }
+        serviceLevels[nameOrConfig] = level;
       }
     } else {
-      // Service-specific level
-      if (!this.config.logConfig.serviceLevels) {
-        this.config.logConfig.serviceLevels = {};
-      }
-      this.config.logConfig.serviceLevels[name] = level;
+      // Object config: { auth: 'debug', database: 'info' }
+      serviceLevels = nameOrConfig;
+    }
+
+    if (!this.config.serviceLogLevels) {
+      this.config.serviceLogLevels = {};
+    }
+
+    // Apply service-specific log levels
+    for (const [name, logLevel] of Object.entries(serviceLevels)) {
+      this.config.serviceLogLevels[name] = logLevel;
 
       // Apply to existing instance
       const instance = this.get(name);
       if (instance) {
-        instance.setLogLevel(level);
+        instance.setLogLevel(logLevel);
       }
     }
   }
@@ -587,19 +634,19 @@ export class ServiceManager extends EventEmitter {
   }
 
   /**
-   * Setup logging configuration based on config.dev
+   * Setup logging configuration based on config.debug
    */
   #setupLogging() {
-    // Set default log levels based on config.debug flag
-    if (this.config.debug) {
-      this.config.logConfig.defaultLevel = DEBUG;
-    } else {
-      this.config.logConfig.defaultLevel = WARN;
+    // Set default level for services based on debug flag if not explicitly set
+    if (!this.config.defaultLogLevel) {
+      this.config.defaultLogLevel = this.config.debug ? DEBUG : INFO;
     }
 
-    // Apply config
-    if (this.config.logConfig.globalLevel) {
-      this.logger.setLevel(this.config.logConfig.globalLevel);
+    // Set manager log level (use defaultLogLevel as fallback)
+    const managerLevel = this.config.managerLogLevel ||
+                         this.config.defaultLogLevel;
+    if (managerLevel) {
+      this.logger.setLevel(managerLevel);
     }
   }
 
@@ -611,21 +658,20 @@ export class ServiceManager extends EventEmitter {
    * @returns {string|undefined} Log level or undefined
    */
   #getServiceLogLevel(name) {
-    const config = this.config.logConfig;
+    const config = this.config;
 
     // Check in order of precedence:
-    // 1. Global level (overrides everything)
-    if (config.globalLevel) {
-      return config.globalLevel;
+    // 1. Service-specific level
+    if (config.serviceLogLevels?.[name]) {
+      return config.serviceLogLevels[name];
     }
 
-    // 2. Service-specific level
-    if (config.serviceLevels?.[name]) {
-      return config.serviceLevels[name];
+    // 2. Default level fallback
+    if (config.defaultLogLevel) {
+      return config.defaultLogLevel;
     }
 
-    // 3. Don't use defaultLevel as it might be too restrictive
-    // Return undefined to let the service use its own default
+    // 3. No fallback - let service use its own default
     return undefined;
   }
 

package/dist/services/service-manager/constants.d.ts

@@ -2,3 +2,5 @@ export const SERVICE_STATE_CHANGED: "service:state-changed";
 export const SERVICE_HEALTH_CHANGED: "service:health-changed";
 export const SERVICE_ERROR: "service:error";
 export const SERVICE_LOG: "service:log";
+export const ANY_LOG_LEVEL: "*";
+export const ANY_SERVICE_NAME: "*";

package/dist/services/service-manager/constants.js

@@ -3,3 +3,6 @@ export const SERVICE_STATE_CHANGED = 'service:state-changed';
 export const SERVICE_HEALTH_CHANGED = 'service:health-changed';
 export const SERVICE_ERROR = 'service:error';
 export const SERVICE_LOG = 'service:log';
+
+export const ANY_LOG_LEVEL = '*';
+export const ANY_SERVICE_NAME = '*';

package/dist/services/service-manager/typedef.d.ts

@@ -38,30 +38,19 @@ export type ServiceManagerConfig = {
      */
     stopTimeout?: number;
     /**
-     * - Initial log level for ServiceManager
+     * - Default log level for new services
      */
-    logLevel?: string;
+    defaultLogLevel?: string;
     /**
-     * - Logging configuration
-     */
-    logConfig?: LogConfig;
-};
-/**
- * Logging configuration
- */
-export type LogConfig = {
-    /**
-     * - Default log level for services
-     */
-    defaultLevel?: string;
-    /**
-     * - Override level for all services
+     * - Initial log level for ServiceManager
      */
-    globalLevel?: string;
+    managerLogLevel?: string;
     /**
-     * - Per-service log levels
+     * Per-service log levels:
+     * - String: "auth:debug,database:info"
+     * - Object: { auth: "debug", database: "info" }
      */
-    serviceLevels?: {
+    serviceLogLevels?: string | {
         [x: string]: string;
     };
 };

package/dist/services/service-manager/typedef.js

@@ -52,17 +52,12 @@
  * @property {boolean} [debug=false] - Debug mode switch
  * @property {boolean} [autoStart=false] - Auto-start services on registration
  * @property {number} [stopTimeout=10000] - Default timeout for stopping services
- * @property {string} [logLevel] - Initial log level for ServiceManager
- * @property {LogConfig} [logConfig={}] - Logging configuration
- */
-
-/**
- * Logging configuration
- *
- * @typedef {Object} LogConfig
- * @property {string} [defaultLevel] - Default log level for services
- * @property {string} [globalLevel] - Override level for all services
- * @property {Object<string, string>} [serviceLevels] - Per-service log levels
+ * @property {string} [defaultLogLevel] - Default log level for new services
+ * @property {string} [managerLogLevel] - Initial log level for ServiceManager
+ * @property {string|Object<string,string>} [serviceLogLevels]
+ *   Per-service log levels:
+ *   - String: "auth:debug,database:info"
+ *   - Object: { auth: "debug", database: "info" }
  */
 
 /**

package/dist/services/service-manager/util.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Parse comma-separated service:level configuration string
+ *
+ * @param {string} configString
+ *   Comma-separated string like "auth:debug,database:info,cache:warn"
+ *
+ * @returns {Object<string, string>} Service name to log level mapping
+ *
+ * @example
+ * const config = parseServiceLogLevels("auth:debug,database:info");
+ * // Returns: { auth: "debug", database: "info" }
+ */
+export function parseServiceLogLevels(configString: string): {
+    [x: string]: string;
+};
+/**
+ * Expand log levels to include higher severity levels
+ *
+ * @param {{[name:string]: string}} serviceLevels
+ *   Service name to log level mapping
+ *
+ * @returns {Object<string, string[]>} Service name to array of log levels
+ *
+ * @example
+ * const levels = expandLogLevels({ auth: "debug", cache: "warn" });
+ * // Returns: {
+ * //   auth: ["debug", "info", "warn", "error"],
+ * //   cache: ["warn", "error"]
+ * // }
+ */
+export function expandLogLevels(serviceLevels: {
+    [name: string]: string;
+}): {
+    [x: string]: string[];
+};

package/dist/services/service-manager/util.js

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Service Manager utility functions
+ *
+ * Provides utility functions for parsing service configurations, handling
+ * log level hierarchies, and managing service-specific operations.
+ */
+
+import { DEBUG, INFO, WARN, ERROR } from '../../logging/index.js';
+
+/**
+ * Parse comma-separated service:level configuration string
+ *
+ * @param {string} configString
+ *   Comma-separated string like "auth:debug,database:info,cache:warn"
+ *
+ * @returns {Object<string, string>} Service name to log level mapping
+ *
+ * @example
+ * const config = parseServiceLogLevels("auth:debug,database:info");
+ * // Returns: { auth: "debug", database: "info" }
+ */
+export function parseServiceLogLevels(configString) {
+  if (!configString || typeof configString !== 'string') {
+    /** @type {Object<string, string>} */
+    return {};
+  }
+
+  /** @type {Object<string, string>} */
+  const result = {};
+
+  const services = configString.split(',');
+
+  for (const serviceExpression of services) {
+    const trimmed = serviceExpression.trim();
+    if (!trimmed) continue;
+
+    const parts = trimmed.split(':');
+    if (parts.length === 2) {
+      const [serviceName, logLevel] = parts;
+      result[serviceName.trim()] = logLevel.trim();
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Expand log levels to include higher severity levels
+ *
+ * @param {{[name:string]: string}} serviceLevels
+ *   Service name to log level mapping
+ *
+ * @returns {Object<string, string[]>} Service name to array of log levels
+ *
+ * @example
+ * const levels = expandLogLevels({ auth: "debug", cache: "warn" });
+ * // Returns: { 
+ * //   auth: ["debug", "info", "warn", "error"],
+ * //   cache: ["warn", "error"] 
+ * // }
+ */
+export function expandLogLevels(serviceLevels) {
+  /** @type {Object<string, string[]>} */
+  const result = {};
+
+  for (const [serviceName, level] of Object.entries(serviceLevels)) {
+    const levels = [];
+    
+    switch (level.toLowerCase()) {
+      case DEBUG:
+        levels.push(DEBUG, INFO, WARN, ERROR);
+        break;
+      case INFO:
+        levels.push(INFO, WARN, ERROR);
+        break;
+      case WARN:
+        levels.push(WARN, ERROR);
+        break;
+      case ERROR:
+        levels.push(ERROR);
+        break;
+      default:
+        levels.push(level);
+    }
+
+    result[serviceName] = levels;
+  }
+
+  return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-core",
-	"version": "0.4.27",
+	"version": "0.4.29",
 	"author": {
 		"name": "HKdigital",
 		"url": "https://hkdigital.nl"
@@ -52,6 +52,7 @@
 	},
 	"files": [
 		"dist",
+		"CLAUDE.md",
 		"!dist/**/*.test.*",
 		"!dist/**/*.spec.*",
 		"!dist/**/testdata.*",
@@ -76,13 +77,17 @@
 		"@skeletonlabs/skeleton": "^3.1.7",
 		"@steeze-ui/heroicons": "^2.4.2",
 		"@sveltejs/kit": "^2.28.0",
+		"@tailwindcss/postcss": "^4.1.11",
+		"autoprefixer": "^10.4.21",
 		"eslint-plugin-import": "^2.32.0",
 		"jsonwebtoken": "^9.0.0",
 		"pino": "^9.8.0",
 		"pino-pretty": "^13.1.1",
+		"postcss": "^8.5.6",
 		"runed": "^0.31.1",
 		"svelte": "^5.38.1",
 		"svelte-preprocess": "^6.0.3",
+		"tailwindcss": "^4.1.11",
 		"valibot": "^1.1.0",
 		"vite-imagetools": "^8.0.0"
 	},
@@ -98,6 +103,7 @@
 		"@tailwindcss/typography": "^0.5.16",
 		"@testing-library/svelte": "^5.2.8",
 		"@testing-library/user-event": "^14.6.1",
+		"@tailwindcss/postcss": "^4.1.11",
 		"@types/eslint": "^9.6.1",
 		"@types/node": "^24.2.1",
 		"autoprefixer": "^10.4.21",
@@ -128,8 +134,5 @@
 		"vite": "^7.1.2",
 		"vite-imagetools": "^8.0.0",
 		"vitest": "^3.2.4"
-	},
-	"dependencies": {
-		"@tailwindcss/postcss": "^4.1.11"
 	}
 }