@hkdigital/lib-core 0.4.29 → 0.4.30

package/README.md

@@ -187,10 +187,16 @@ The library includes a comprehensive logging system that provides:
 - **Client-side**: Enhanced console logging with structured data display in browser inspector
 - **Consistent API**: Same logging interface for both server and client environments
 
-For detailed setup guides see:
-- **Design system**: [src/lib/design/README.md](./src/lib/design/README.md)
-- **Vite configuration**: [src/lib/config/README.md](./src/lib/config/README.md)
-- **Logging system**: [src/lib/logging/README.md](./src/lib/logging/README.md)
+## Documentation
+
+For detailed setup guides and configuration:
+- **Project setup**: [docs/setup/new-project.md](./docs/setup/new-project.md) - SvelteKit project setup
+- **Library setup**: [docs/setup/new-lib.md](./docs/setup/new-lib.md) - SvelteKit library setup
+- **Services & logging**: [docs/setup/services-logging.md](./docs/setup/services-logging.md) - Service management architecture
+- **Configuration files**: [docs/config/root-config-files.md](./docs/config/root-config-files.md) - Config file reference
+- **Design system**: [src/lib/design/README.md](./src/lib/design/README.md) - Design tokens and theming
+- **Vite configuration**: [src/lib/config/README.md](./src/lib/config/README.md) - Build configuration
+- **Logging system**: [src/lib/logging/README.md](./src/lib/logging/README.md) - Server and client logging
 
 ### Update
 

package/dist/services/README.md

@@ -237,6 +237,37 @@ const systemHealth = await manager.checkHealth();
 
 ### Error Handling and Recovery
 
+### Logging Configuration
+
+ServiceManager provides centralized logging control for all services:
+
+```javascript
+const manager = new ServiceManager({
+  debug: true,                    // Sets defaultLogLevel to DEBUG
+  defaultLogLevel: 'INFO',        // Default level for all services
+  managerLogLevel: 'DEBUG',       // Level for ServiceManager itself
+  serviceLogLevels: {             // Per-service levels
+    database: 'ERROR',
+    auth: 'DEBUG'
+  }
+});
+
+// Change manager log level at runtime
+manager.setManagerLogLevel('ERROR');
+
+// Change service log levels at runtime
+manager.setServiceLogLevel('database', 'INFO');
+
+// Set multiple service levels at once
+manager.setServiceLogLevel({
+  database: 'INFO',
+  auth: 'DEBUG'
+});
+
+// Parse string format
+manager.setServiceLogLevel('database:info,auth:debug');
+```
+
 ### ServiceManager events
 
 ServiceManager emits these events (constants from `$lib/services/service-manager/constants.js`):
@@ -264,14 +295,14 @@ await manager.recoverService('database');
 Forward all service log events to a centralised logger:
 
 ```javascript
-import { ServiceManager, SERVICE_LOG } from '$lib/services/index.js';
+import { ServiceManager } from '$lib/services/index.js';
 import { createServerLogger } from '$lib/logging/index.js';
 
 const manager = new ServiceManager();
 const logger = createServerLogger('SystemLogger');
 
 // Listen to all log events and forward them to the logger
-manager.on(SERVICE_LOG, (logEvent) => {
+const unsubscribe = manager.onServiceLogEvent((logEvent) => {
   logger.logFromEvent('manager:service:log', logEvent);
 });
 
@@ -280,6 +311,9 @@ manager.register('database', DatabaseService, { ... });
 manager.register('auth', AuthService, { ... });
 
 await manager.startAll();
+
+// Cleanup when done
+unsubscribe();
 ```
 
 ## Plugins

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

@@ -106,7 +106,8 @@ export class ServiceManager extends EventEmitter {
     /** @type {Map<string, ServiceEntry>} */
     this.services = new Map();
 
-    const defaultLogLevel = config.defaultLogLevel || (config.debug ? DEBUG : INFO);
+    const defaultLogLevel =
+      config.defaultLogLevel || (config.debug ? DEBUG : INFO);
     const managerLogLevel = config.managerLogLevel || defaultLogLevel;
     const serviceLogLevels = config.serviceLogLevels;
 
@@ -118,16 +119,16 @@ export class ServiceManager extends EventEmitter {
       debug: config.debug ?? false,
       autoStart: config.autoStart ?? false,
       stopTimeout: config.stopTimeout || 10000,
-      defaultLogLevel,
-      managerLogLevel
+      defaultLogLevel
+      // managerLogLevel will be set bysetManagerLogLevel()
       // serviceLogLevels will be set by setServiceLogLevel()
     };
 
+    this.setManagerLogLevel(managerLogLevel);
+
     if (serviceLogLevels) {
       this.setServiceLogLevel(serviceLogLevels);
     }
-
-    this.#setupLogging();
   }
 
   /**
@@ -528,7 +529,9 @@ export class ServiceManager extends EventEmitter {
       } else {
         // Single service name
         if (!level) {
-          throw new Error(`Level parameter required for service '${nameOrConfig}'`);
+          throw new Error(
+            `Level parameter required for service '${nameOrConfig}'`
+          );
         }
         serviceLevels[nameOrConfig] = level;
       }
@@ -633,23 +636,6 @@ export class ServiceManager extends EventEmitter {
     }
   }
 
-  /**
-   * Setup logging configuration based on config.debug
-   */
-  #setupLogging() {
-    // 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;
-    }
-
-    // Set manager log level (use defaultLogLevel as fallback)
-    const managerLevel = this.config.managerLogLevel ||
-                         this.config.defaultLogLevel;
-    if (managerLevel) {
-      this.logger.setLevel(managerLevel);
-    }
-  }
-
   /**
    * Get the appropriate log level for a service
    *

package/dist/state/machines/finite-state-machine/constants.js

@@ -6,10 +6,10 @@
  * Event emitted when entering a state
  * @type {string}
  */
-export const ENTER = 'enter';
+export const ENTER = '_enter';
 
 /**
  * Event emitted when exiting a state
  * @type {string}
  */
-export const EXIT = 'exit';
+export const EXIT = '_exit';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-core",
-	"version": "0.4.29",
+	"version": "0.4.30",
 	"author": {
 		"name": "HKdigital",
 		"url": "https://hkdigital.nl"