@hkdigital/lib-sveltekit 0.2.20 → 0.2.21

package/dist/classes/services/typedef.js

@@ -1,179 +1,179 @@
-/**
- * @fileoverview Type definitions for the service management system.
- * 
- * This file contains all TypeScript/JSDoc type definitions used throughout
- * the service management system. Import these types in your service
- * implementations and when using the ServiceManager.
- * 
- * @example
- * // In your service implementation
- * import { ServiceBase } from './ServiceBase.js';
- * 
- * // @ typedef {import('./typedef.js').ServiceConfig} ServiceConfig
- * // @ typedef {import('./typedef.js').HealthStatus} HealthStatus
- * 
- * class MyService extends ServiceBase {
- *   async _init(config) {
- *     // config is typed as ServiceConfig
- *   }
- *   
- *   async _healthCheck() {
- *     // Return type is HealthStatus
- *     return { latency: 10 };
- *   }
- * }
- * 
- * @example
- * // When using ServiceManager
- * import { ServiceManager } from './ServiceManager.js';
- * 
- * // @ typedef {import('./typedef.js').ServiceManagerConfig} ServiceManagerConfig
- * // @ typedef {import('./typedef.js').ServiceRegistrationOptions} ServiceRegistrationOptions
- * 
- * const config = {
- *   environment: 'development',
- *   stopTimeout: 5000
- * };
- * 
- * const manager = new ServiceManager(config);
- * 
- * const options = {
- *   dependencies: ['database'],
- *   tags: ['critical']
- * };
- * 
- * manager.register('auth', AuthService, {}, options);
- */
-
-/**
- * Service configuration object passed to service initialization
- *
- * @typedef {Object} ServiceConfig
- * @property {*} [key] - Service-specific configuration properties
- */
-
-/**
- * Options for creating a service instance
- *
- * @typedef {Object} ServiceOptions
- * @property {string} [logLevel] - Initial log level for the service
- * @property {number} [shutdownTimeout=5000] - Timeout for graceful shutdown
- */
-
-/**
- * Options for stopping a service
- *
- * @typedef {Object} StopOptions
- * @property {number} [timeout] - Override shutdown timeout
- * @property {boolean} [force=false] - Force stop even if timeout exceeded
- */
-
-/**
- * Health status returned by service health checks
- *
- * @typedef {Object} HealthStatus
- * @property {string} name - Service name
- * @property {string} state - Current service state
- * @property {boolean} healthy - Whether the service is healthy
- * @property {string} [error] - Error message if unhealthy
- * @property {string} [checkError] - Error from health check itself
- * @property {*} [key] - Additional health check properties
- */
-
-/**
- * @typedef {Object} StateChangeEvent
- * @property {string} service - Service name (added by ServiceManager)
- * @property {string} oldState - Previous state
- * @property {string} newState - New state
- */
-
-/**
- * @typedef {Object} HealthChangeEvent
- * @property {string} service - Service name (added by ServiceManager)
- * @property {boolean} healthy - Current health status
- * @property {boolean} [wasHealthy] - Previous health status
- */
-
-/**
- * Event emitted when service encounters an error
- *
- * @typedef {Object} ServiceErrorEvent
- * @property {string} service - Service name
- * @property {string} operation - Operation that failed
- * @property {Error} error - Error that occurred
- */
-
-/**
- * Service class constructor type
- *
- * @typedef {new (name: string, options?: ServiceOptions) => ServiceInstance} ServiceConstructor
- */
-
-/**
- * Options for registering a service
- *
- * @typedef {Object} ServiceRegistrationOptions
- * @property {string[]} [dependencies=[]] - Services this service depends on
- * @property {string[]} [tags=[]] - Tags for grouping services
- * @property {number} [priority=0] - Startup priority (higher starts first)
- */
-
-/**
- * Configuration for ServiceManager
- *
- * @typedef {Object} ServiceManagerConfig
- * @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
- */
-
-/**
- * Internal service registry entry
- *
- * @typedef {Object} ServiceEntry
- * @property {ServiceConstructor} ServiceClass - Service class constructor
- * @property {ServiceInstance|null} instance - Service instance (lazy-created)
- * @property {ServiceConfig} config - Service configuration
- * @property {string[]} dependencies - Service dependencies
- * @property {Set<string>} dependents - Services that depend on this one
- * @property {string[]} tags - Service tags
- * @property {number} priority - Startup priority
- */
-
-/**
- * Result of health check for all services
- * @typedef {Object<string, HealthStatus>} HealthCheckResult
- */
-
-/**
- * Base class interface that services must implement
- *
- * @typedef {Object} ServiceInstance
- * @property {string} name - Service name
- * @property {string} state - Current state
- * @property {boolean} healthy - Health status
- * @property {Error|null} error - Last error
- * @property {import('../logging').Logger} logger - Service logger
- * @property {(config?: ServiceConfig) => Promise<boolean>} initialize
- * @property {() => Promise<boolean>} start
- * @property {(options?: StopOptions) => Promise<boolean>} stop
- * @property {() => Promise<boolean>} recover
- * @property {() => Promise<boolean>} destroy
- * @property {() => Promise<HealthStatus>} getHealth
- * @property {(level: string) => boolean} setLogLevel
- * @property {(event: string, handler: Function) => Function} on
- * @property {(event: string, data: any) => boolean} emit
- */
-
-export {};
+/**
+ * @fileoverview Type definitions for the service management system.
+ * 
+ * This file contains all TypeScript/JSDoc type definitions used throughout
+ * the service management system. Import these types in your service
+ * implementations and when using the ServiceManager.
+ * 
+ * @example
+ * // In your service implementation
+ * import { ServiceBase } from './ServiceBase.js';
+ * 
+ * // @ typedef {import('./typedef.js').ServiceConfig} ServiceConfig
+ * // @ typedef {import('./typedef.js').HealthStatus} HealthStatus
+ * 
+ * class MyService extends ServiceBase {
+ *   async _init(config) {
+ *     // config is typed as ServiceConfig
+ *   }
+ *   
+ *   async _healthCheck() {
+ *     // Return type is HealthStatus
+ *     return { latency: 10 };
+ *   }
+ * }
+ * 
+ * @example
+ * // When using ServiceManager
+ * import { ServiceManager } from './ServiceManager.js';
+ * 
+ * // @ typedef {import('./typedef.js').ServiceManagerConfig} ServiceManagerConfig
+ * // @ typedef {import('./typedef.js').ServiceRegistrationOptions} ServiceRegistrationOptions
+ * 
+ * const config = {
+ *   environment: 'development',
+ *   stopTimeout: 5000
+ * };
+ * 
+ * const manager = new ServiceManager(config);
+ * 
+ * const options = {
+ *   dependencies: ['database'],
+ *   tags: ['critical']
+ * };
+ * 
+ * manager.register('auth', AuthService, {}, options);
+ */
+
+/**
+ * Service configuration object passed to service initialization
+ *
+ * @typedef {Object} ServiceConfig
+ * @property {*} [key] - Service-specific configuration properties
+ */
+
+/**
+ * Options for creating a service instance
+ *
+ * @typedef {Object} ServiceOptions
+ * @property {string} [logLevel] - Initial log level for the service
+ * @property {number} [shutdownTimeout=5000] - Timeout for graceful shutdown
+ */
+
+/**
+ * Options for stopping a service
+ *
+ * @typedef {Object} StopOptions
+ * @property {number} [timeout] - Override shutdown timeout
+ * @property {boolean} [force=false] - Force stop even if timeout exceeded
+ */
+
+/**
+ * Health status returned by service health checks
+ *
+ * @typedef {Object} HealthStatus
+ * @property {string} name - Service name
+ * @property {string} state - Current service state
+ * @property {boolean} healthy - Whether the service is healthy
+ * @property {string} [error] - Error message if unhealthy
+ * @property {string} [checkError] - Error from health check itself
+ * @property {*} [key] - Additional health check properties
+ */
+
+/**
+ * @typedef {Object} StateChangeEvent
+ * @property {string} service - Service name (added by ServiceManager)
+ * @property {string} oldState - Previous state
+ * @property {string} newState - New state
+ */
+
+/**
+ * @typedef {Object} HealthChangeEvent
+ * @property {string} service - Service name (added by ServiceManager)
+ * @property {boolean} healthy - Current health status
+ * @property {boolean} [wasHealthy] - Previous health status
+ */
+
+/**
+ * Event emitted when service encounters an error
+ *
+ * @typedef {Object} ServiceErrorEvent
+ * @property {string} service - Service name
+ * @property {string} operation - Operation that failed
+ * @property {Error} error - Error that occurred
+ */
+
+/**
+ * Service class constructor type
+ *
+ * @typedef {new (name: string, options?: ServiceOptions) => ServiceInstance} ServiceConstructor
+ */
+
+/**
+ * Options for registering a service
+ *
+ * @typedef {Object} ServiceRegistrationOptions
+ * @property {string[]} [dependencies=[]] - Services this service depends on
+ * @property {string[]} [tags=[]] - Tags for grouping services
+ * @property {number} [priority=0] - Startup priority (higher starts first)
+ */
+
+/**
+ * Configuration for ServiceManager
+ *
+ * @typedef {Object} ServiceManagerConfig
+ * @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
+ */
+
+/**
+ * Internal service registry entry
+ *
+ * @typedef {Object} ServiceEntry
+ * @property {ServiceConstructor} ServiceClass - Service class constructor
+ * @property {ServiceInstance|null} instance - Service instance (lazy-created)
+ * @property {ServiceConfig} config - Service configuration
+ * @property {string[]} dependencies - Service dependencies
+ * @property {Set<string>} dependents - Services that depend on this one
+ * @property {string[]} tags - Service tags
+ * @property {number} priority - Startup priority
+ */
+
+/**
+ * Result of health check for all services
+ * @typedef {Object<string, HealthStatus>} HealthCheckResult
+ */
+
+/**
+ * Base class interface that services must implement
+ *
+ * @typedef {Object} ServiceInstance
+ * @property {string} name - Service name
+ * @property {string} state - Current state
+ * @property {boolean} healthy - Health status
+ * @property {Error|null} error - Last error
+ * @property {import('../logging').Logger} logger - Service logger
+ * @property {(config?: ServiceConfig) => Promise<boolean>} initialize
+ * @property {() => Promise<boolean>} start
+ * @property {(options?: StopOptions) => Promise<boolean>} stop
+ * @property {() => Promise<boolean>} recover
+ * @property {() => Promise<boolean>} destroy
+ * @property {() => Promise<HealthStatus>} getHealth
+ * @property {(level: string) => boolean} setLogLevel
+ * @property {(event: string, handler: Function) => Function} on
+ * @property {(event: string, data: any) => boolean} emit
+ */
+
+export {};

package/dist/classes/stores/SubscribersCount.js

@@ -1,107 +1,107 @@
-import { writable, get } from 'svelte/store';
-
-/**
- * Class that can be used to add a `SubscribersCount` store to classes
- * or other objects
- */
-export default class SubscribersCount {
-	#count;
-
-	constructor() {
-		this.#count = writable(0);
-	}
-
-	increment() {
-		this.#count.update((value) => value + 1);
-	}
-
-	decrement() {
-		this.#count.update((value) => value - 1);
-	}
-
-	/**
-	 * Subscribe to `SubscribersCount` store
-	 *
-	 * @param {(value:number)=>void} fn
-	 *
-	 * @returns {()=>void} unsubscribe
-	 */
-	subscribe(fn) {
-		return this.#count.subscribe(fn);
-	}
-
-	/**
-	 * Subscribe to `SubscribersCount` store and receive an update once if the
-	 * count is zero.
-	 *
-	 * @param {(value:number)=>void} fn
-	 *
-	 * @returns {()=>void} unsubscribe
-	 */
-	onceEmpty(fn) {
-		let unsubscribe = this.#count.subscribe((value) => {
-			if (value === 0) {
-				unsubscribe();
-				fn(value);
-			}
-		});
-
-		return unsubscribe;
-	}
-
-	/**
-	 * Create a writable store with added 'subscribeCount' functionality
-	 */
-	static writable() {
-		const store = writable(...arguments);
-
-		return SubscribersCount.wrap(store);
-	}
-
-	/**
-	 * Add subscriber count functionality to an existing store by wrapping
-	 * the store with a Proxy
-	 *
-	 * @template T;
-	 *
-	 * @param {import('svelte/store').Writable<T>} store
-	 */
-	static wrap(store) {
-		// expect.store( store );
-
-		const counter = new SubscribersCount();
-
-		const handler = {
-			/**
-			 * @param {any} target
-			 * @param {string} prop
-			 */
-			get(target, prop) {
-				switch (prop) {
-					case 'subscribe': {
-						return /* subscribe */ function () {
-							counter.increment();
-							const unsubscribe = target[prop](...arguments);
-
-							return /* unsubscribe */ () => {
-								counter.decrement();
-								unsubscribe();
-							};
-						};
-					}
-
-					case 'value':
-						return get(store);
-
-					case 'subscribersCount':
-						return counter;
-				}
-
-				return Reflect.get(target, prop);
-				// return target[prop];
-			}
-		};
-
-		return new Proxy(store, handler);
-	}
-}
+import { writable, get } from 'svelte/store';
+
+/**
+ * Class that can be used to add a `SubscribersCount` store to classes
+ * or other objects
+ */
+export default class SubscribersCount {
+	#count;
+
+	constructor() {
+		this.#count = writable(0);
+	}
+
+	increment() {
+		this.#count.update((value) => value + 1);
+	}
+
+	decrement() {
+		this.#count.update((value) => value - 1);
+	}
+
+	/**
+	 * Subscribe to `SubscribersCount` store
+	 *
+	 * @param {(value:number)=>void} fn
+	 *
+	 * @returns {()=>void} unsubscribe
+	 */
+	subscribe(fn) {
+		return this.#count.subscribe(fn);
+	}
+
+	/**
+	 * Subscribe to `SubscribersCount` store and receive an update once if the
+	 * count is zero.
+	 *
+	 * @param {(value:number)=>void} fn
+	 *
+	 * @returns {()=>void} unsubscribe
+	 */
+	onceEmpty(fn) {
+		let unsubscribe = this.#count.subscribe((value) => {
+			if (value === 0) {
+				unsubscribe();
+				fn(value);
+			}
+		});
+
+		return unsubscribe;
+	}
+
+	/**
+	 * Create a writable store with added 'subscribeCount' functionality
+	 */
+	static writable() {
+		const store = writable(...arguments);
+
+		return SubscribersCount.wrap(store);
+	}
+
+	/**
+	 * Add subscriber count functionality to an existing store by wrapping
+	 * the store with a Proxy
+	 *
+	 * @template T;
+	 *
+	 * @param {import('svelte/store').Writable<T>} store
+	 */
+	static wrap(store) {
+		// expect.store( store );
+
+		const counter = new SubscribersCount();
+
+		const handler = {
+			/**
+			 * @param {any} target
+			 * @param {string} prop
+			 */
+			get(target, prop) {
+				switch (prop) {
+					case 'subscribe': {
+						return /* subscribe */ function () {
+							counter.increment();
+							const unsubscribe = target[prop](...arguments);
+
+							return /* unsubscribe */ () => {
+								counter.decrement();
+								unsubscribe();
+							};
+						};
+					}
+
+					case 'value':
+						return get(store);
+
+					case 'subscribersCount':
+						return counter;
+				}
+
+				return Reflect.get(target, prop);
+				// return target[prop];
+			}
+		};
+
+		return new Proxy(store, handler);
+	}
+}

package/dist/classes/stores/index.js

@@ -1 +1 @@
-export { default as SubscribersCount } from './SubscribersCount.js';
+export { default as SubscribersCount } from './SubscribersCount.js';

package/dist/classes/streams/LogTransformStream.js

@@ -1,19 +1,19 @@
-export default class LogTransformStream extends TransformStream {
-	constructor() {
-		const transformer = {
-			/**
-			 * Log the chunk and enqueue the unchanged chunk
-			 *
-			 * @param {any} chunk
-			 * @param {any} controller
-			 */
-			transform: (chunk, controller) => {
-				console.log('log', chunk);
-				controller.enqueue(chunk);
-			}
-		};
-
-		super(transformer);
-	}
-	start() {}
-}
+export default class LogTransformStream extends TransformStream {
+	constructor() {
+		const transformer = {
+			/**
+			 * Log the chunk and enqueue the unchanged chunk
+			 *
+			 * @param {any} chunk
+			 * @param {any} controller
+			 */
+			transform: (chunk, controller) => {
+				console.log('log', chunk);
+				controller.enqueue(chunk);
+			}
+		};
+
+		super(transformer);
+	}
+	start() {}
+}