@hkdigital/lib-core 0.5.50 → 0.5.52

package/dist/logging/internal/logger/Logger.d.ts

@@ -1,3 +1,6 @@
+/** @typedef {import('../../../generic/typedef.js').ErrorDetails} ErrorDetails */
+/** @typedef {import('../../typedef.js').LogEvent} LogEvent */
+/** @typedef {import('../../typedef.js').LogEventData} LogEventData */
 /** @typedef {import('../../typedef.js').LogLevel} LogLevel */
 /**
  * Logger class for consistent logging
@@ -63,7 +66,7 @@ export default class Logger extends EventEmitter {
      */
     error(errorOrMessage: Error | ErrorEvent | PromiseRejectionEvent | string, errorOrDetails?: Error | ErrorDetails, details?: ErrorDetails, ...args: any[]): boolean;
     /**
-     * Create a child logger with additional context
+     * New logger with same name, namespaced context, no event forwarding
      *
      * @param {string} namespace
      *   Namespace of the context (needed for chaining contexts)
@@ -72,17 +75,33 @@ export default class Logger extends EventEmitter {
      * @returns {Logger} New logger instance with merged context
      */
     context(namespace: string, additionalContext: Object): Logger;
+    /**
+     * Create a child logger that emits events on the current logger
+     *
+     * @param {string} name
+     *   Child logger name (will be appended to parent name)
+     *
+     * @param {object} [options]
+     * @param {LogLevel} [options.level] - Child logger log level
+     *
+     * @returns {Logger} New child logger instance
+     */
+    child(name: string, { level }?: {
+        level?: import("../../typedef.js").LogLevel | undefined;
+    }): Logger;
     /**
      * Log an LogEvent emitted by an event emitter
      *
      * E.g. an event that was created by another Logger instance and should be
      * forwarded to this logger.
      *
-     * @param {import('../../typedef.js').LogEventData} eventData
+     * @param {LogEventData} eventData
      */
-    logFromEvent(eventData: import("../../typedef.js").LogEventData): false | undefined;
+    logFromEvent(eventData: LogEventData): false | undefined;
     #private;
 }
 export type ErrorDetails = import("../../../generic/typedef.js").ErrorDetails;
+export type LogEvent = import("../../typedef.js").LogEvent;
+export type LogEventData = import("../../typedef.js").LogEventData;
 export type LogLevel = import("../../typedef.js").LogLevel;
 import { EventEmitter } from '../../../generic/events.js';

package/dist/logging/internal/logger/Logger.js

@@ -32,8 +32,6 @@
  * logger.setLevel(DEBUG); // Now debug messages will also be logged
  */
 
-/** @typedef {import('../../../generic/typedef.js').ErrorDetails} ErrorDetails */
-
 import * as expect from '../../../util/expect.js';
 
 import { EventEmitter } from '../../../generic/events.js';
@@ -61,6 +59,11 @@ import { exportNotNullish } from '../../../util/object.js';
 import * as is from '../../../util/is.js';
 import { HttpError } from '../../../network/errors.js';
 
+/** @typedef {import('../../../generic/typedef.js').ErrorDetails} ErrorDetails */
+
+/** @typedef {import('../../typedef.js').LogEvent} LogEvent */
+/** @typedef {import('../../typedef.js').LogEventData} LogEventData */
+
 /** @typedef {import('../../typedef.js').LogLevel} LogLevel */
 
 /**
@@ -220,7 +223,7 @@ export default class Logger extends EventEmitter {
   }
 
   /**
-   * Create a child logger with additional context
+   * New logger with same name, namespaced context, no event forwarding
    *
    * @param {string} namespace
    *   Namespace of the context (needed for chaining contexts)
@@ -241,13 +244,46 @@ export default class Logger extends EventEmitter {
     return new Logger(this.name, this.level, mergedContext);
   }
 
+  /**
+   * Create a child logger that emits events on the current logger
+   *
+   * @param {string} name
+   *   Child logger name (will be appended to parent name)
+   *
+   * @param {object} [options]
+   * @param {LogLevel} [options.level] - Child logger log level
+   *
+   * @returns {Logger} New child logger instance
+   */
+  child(name, { level } = {}) {
+    if (typeof name !== 'string') {
+      throw new Error('Invalid child logger name');
+    }
+
+    const context = {
+      ...this.#defaultContext
+    };
+
+    const childName = `${this.name}:${name}`;
+
+    const child = new Logger(childName, level ?? this.level, context);
+
+    // Forward all log events from child to parent
+    child.on(LOG, ( /** @type {LogEvent} */ logEvent) => {
+      this.emit(logEvent.level, logEvent);
+      this.emit(LOG, logEvent);
+    });
+
+    return child;
+  }
+
   /**
    * Log an LogEvent emitted by an event emitter
    *
    * E.g. an event that was created by another Logger instance and should be
    * forwarded to this logger.
    *
-   * @param {import('../../typedef.js').LogEventData} eventData
+   * @param {LogEventData} eventData
    */
   logFromEvent(eventData) {
     expect.object(eventData);
@@ -295,9 +331,9 @@ export default class Logger extends EventEmitter {
   }
 
   /**
-   * Internal event loggin method
+   * Internal event logging method
    *
-   * @param {import('../../typedef.js').LogEvent} logEvent
+   * @param {LogEvent} logEvent
    */
   #logEvent(logEvent) {
     // Emit as both specific level event and generic 'log' event
@@ -344,6 +380,7 @@ export default class Logger extends EventEmitter {
         'colno'
       ]);
 
+      // @ts-ignore
       errorEventDetails.type = 'ErrorEvent';
 
       let cause = errorEvent.error;

package/dist/state/machines/page-machine/PageMachine.svelte.d.ts

@@ -111,20 +111,13 @@ export default class PageMachine {
      * Synchronize machine state with URL path
      *
      * Call this in a $effect that watches $page.url.pathname
-     * Automatically tracks visited states
+     * Automatically tracks visited states and triggers onEnter hooks
      *
      * @param {string} currentPath - Current URL pathname
      *
      * @returns {boolean} True if state was changed
      */
     syncFromPath(currentPath: string): boolean;
-    /**
-     * Set the current state directly
-     * Handles onEnter hooks and auto-transitions
-     *
-     * @param {string} newState - Target state
-     */
-    setState(newState: string): Promise<void>;
     /**
      * Get route path for a given state
      *

package/dist/state/machines/page-machine/PageMachine.svelte.js

@@ -241,7 +241,7 @@ export default class PageMachine {
 	 * Synchronize machine state with URL path
 	 *
 	 * Call this in a $effect that watches $page.url.pathname
-	 * Automatically tracks visited states
+	 * Automatically tracks visited states and triggers onEnter hooks
 	 *
 	 * @param {string} currentPath - Current URL pathname
 	 *
@@ -251,13 +251,11 @@ export default class PageMachine {
 		const targetState = this.#getStateFromPath(currentPath);
 
 		if (targetState && targetState !== this.#current) {
-			const oldState = this.#current;
-			this.#current = targetState;
-			this.#visitedStates.add(targetState);
-			this.#revision++;
-
 			// Log state transition from URL sync
-			this.logger?.debug(`syncFromPath (url): ${oldState} → ${targetState}`);
+			this.logger?.debug(`syncFromPath: ${currentPath} → targetState: ${targetState}`);
+
+			// Use #setState to handle onEnter hooks
+			this.#setState(targetState);
 
 			return true;
 		}
@@ -266,12 +264,16 @@ export default class PageMachine {
 	}
 
 	/**
-	 * Set the current state directly
+	 * Set the current state directly (internal use only)
 	 * Handles onEnter hooks and auto-transitions
 	 *
+	 * Note: This is private to enforce URL-first navigation.
+	 * To change state, navigate to the URL using switchToPage()
+	 * and let syncFromPath() update the state.
+	 *
 	 * @param {string} newState - Target state
 	 */
-	async setState(newState) {
+	async #setState(newState) {
 		if (newState === this.#current || this.#isTransitioning) {
 			return;
 		}
@@ -301,7 +303,7 @@ export default class PageMachine {
 				if (!doneCalled && nextState && nextState !== newState) {
 					doneCalled = true;
 					this.#isTransitioning = false;
-					this.setState(nextState);
+					this.#setState(nextState);
 				}
 			};
 

package/package.json

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