@hkdigital/lib-core 0.3.4 → 0.3.6

package/dist/{classes/services → services/internal/service-base}/typedef.d.ts

@@ -53,6 +53,40 @@ export type HealthStatus = {
      */
     key?: any;
 };
+/**
+ * Base class interface that services must implement
+ */
+export type ServiceInstance = {
+    /**
+     * - Service name
+     */
+    name: string;
+    /**
+     * - Current state
+     */
+    state: string;
+    /**
+     * - Health status
+     */
+    healthy: boolean;
+    /**
+     * - Last error
+     */
+    error: Error | null;
+    /**
+     * - Service logger
+     */
+    logger: import("../../../logging/internal/unified-logger").Logger;
+    initialize: (config?: any) => Promise<boolean>;
+    start: () => Promise<boolean>;
+    stop: (options?: StopOptions) => Promise<boolean>;
+    recover: () => Promise<boolean>;
+    destroy: () => Promise<boolean>;
+    getHealth: () => Promise<HealthStatus>;
+    setLogLevel: (level: string) => boolean;
+    on: (event: string, handler: Function) => Function;
+    emit: (event: string, data: any) => boolean;
+};
 export type StateChangeEvent = {
     /**
      * - Service name (added by ServiceManager)
@@ -98,141 +132,3 @@ export type ServiceErrorEvent = {
      */
     error: Error;
 };
-/**
- * Service class constructor type
- */
-export type ServiceConstructor = new (name: string, options?: ServiceOptions) => ServiceInstance;
-/**
- * Options for registering a service
- */
-export type ServiceRegistrationOptions = {
-    /**
-     * - Services this service depends on
-     */
-    dependencies?: string[];
-    /**
-     * - Tags for grouping services
-     */
-    tags?: string[];
-    /**
-     * - Startup priority (higher starts first)
-     */
-    priority?: number;
-};
-/**
- * Configuration for ServiceManager
- */
-export type ServiceManagerConfig = {
-    /**
-     * - Debug mode switch
-     */
-    debug?: boolean;
-    /**
-     * - Auto-start services on registration
-     */
-    autoStart?: boolean;
-    /**
-     * - Default timeout for stopping services
-     */
-    stopTimeout?: number;
-    /**
-     * - Initial log level for ServiceManager
-     */
-    logLevel?: string;
-    /**
-     * - Logging configuration
-     */
-    logConfig?: LogConfig;
-};
-/**
- * Logging configuration
- */
-export type LogConfig = {
-    /**
-     * - Default log level for services
-     */
-    defaultLevel?: string;
-    /**
-     * - Override level for all services
-     */
-    globalLevel?: string;
-    /**
-     * - Per-service log levels
-     */
-    serviceLevels?: {
-        [x: string]: string;
-    };
-};
-/**
- * Internal service registry entry
- */
-export type ServiceEntry = {
-    /**
-     * - Service class constructor
-     */
-    ServiceClass: ServiceConstructor;
-    /**
-     * - Service instance (lazy-created)
-     */
-    instance: ServiceInstance | null;
-    /**
-     * - Service configuration
-     */
-    config: any;
-    /**
-     * - Service dependencies
-     */
-    dependencies: string[];
-    /**
-     * - Services that depend on this one
-     */
-    dependents: Set<string>;
-    /**
-     * - Service tags
-     */
-    tags: string[];
-    /**
-     * - Startup priority
-     */
-    priority: number;
-};
-/**
- * Result of health check for all services
- */
-export type HealthCheckResult = {
-    [x: string]: HealthStatus;
-};
-/**
- * Base class interface that services must implement
- */
-export type ServiceInstance = {
-    /**
-     * - Service name
-     */
-    name: string;
-    /**
-     * - Current state
-     */
-    state: string;
-    /**
-     * - Health status
-     */
-    healthy: boolean;
-    /**
-     * - Last error
-     */
-    error: Error | null;
-    /**
-     * - Service logger
-     */
-    logger: import("../logging").Logger;
-    initialize: (config?: any) => Promise<boolean>;
-    start: () => Promise<boolean>;
-    stop: (options?: StopOptions) => Promise<boolean>;
-    recover: () => Promise<boolean>;
-    destroy: () => Promise<boolean>;
-    getHealth: () => Promise<HealthStatus>;
-    setLogLevel: (level: string) => boolean;
-    on: (event: string, handler: Function) => Function;
-    emit: (event: string, data: any) => boolean;
-};

package/dist/{classes/services → services/internal/service-base}/typedef.js

@@ -1,9 +1,8 @@
 /**
- * @fileoverview Type definitions for the service management system.
+ * @fileoverview Type definitions for ServiceBase class.
  * 
- * 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.
+ * This file contains all TypeScript/JSDoc type definitions used by
+ * the ServiceBase class and service implementations.
  * 
  * @example
  * // In your service implementation
@@ -18,29 +17,12 @@
  *     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);
  */
 
+// ============================================================================
+// PUBLIC TYPES
+// ============================================================================
+
 /**
  * Options for creating a service instance
  *
@@ -69,6 +51,30 @@
  * @property {*} [key] - Additional health check properties
  */
 
+/**
+ * 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/internal/unified-logger').Logger} logger - Service logger
+ * @property {(config?: *) => 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
+ */
+
+// ============================================================================
+// INTERNAL TYPES
+// ============================================================================
+
 /**
  * @typedef {Object} StateChangeEvent
  * @property {string} service - Service name (added by ServiceManager)
@@ -92,77 +98,4 @@
  * @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 {*} 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?: *) => 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/services → services/internal/service-manager}/ServiceManager.d.ts

@@ -2,9 +2,10 @@
  * @typedef {import('./typedef.js').ServiceConstructor} ServiceConstructor
  * @typedef {import('./typedef.js').ServiceRegistrationOptions} ServiceRegistrationOptions
  * @typedef {import('./typedef.js').ServiceManagerConfig} ServiceManagerConfig
- * @typedef {import('./typedef.js').StopOptions} StopOptions
  * @typedef {import('./typedef.js').ServiceEntry} ServiceEntry
  * @typedef {import('./typedef.js').HealthCheckResult} HealthCheckResult
+ *
+ * @typedef {import('../service-base/typedef.js').StopOptions} StopOptions
  */
 /**
  * Service Manager for lifecycle and dependency management
@@ -152,7 +153,7 @@ export class ServiceManager extends EventEmitter {
      *
      * @private
      * @param {string} name - Service name
-     * @param {import('./typedef.js').ServiceInstance} instance
+     * @param {import('../service-base/typedef.js').ServiceInstance} instance
      *   Service instance
      */
     private _attachServiceEvents;
@@ -170,8 +171,8 @@ export default ServiceManager;
 export type ServiceConstructor = import("./typedef.js").ServiceConstructor;
 export type ServiceRegistrationOptions = import("./typedef.js").ServiceRegistrationOptions;
 export type ServiceManagerConfig = import("./typedef.js").ServiceManagerConfig;
-export type StopOptions = import("./typedef.js").StopOptions;
 export type ServiceEntry = import("./typedef.js").ServiceEntry;
 export type HealthCheckResult = import("./typedef.js").HealthCheckResult;
-import { EventEmitter } from '../events';
-import { Logger } from '../logging';
+export type StopOptions = import("../service-base/typedef.js").StopOptions;
+import { EventEmitter } from '../../../classes/event-emitter';
+import { Logger } from '../../../logging/index.js';

package/dist/{classes/services → services/internal/service-manager}/ServiceManager.js

@@ -63,23 +63,24 @@
  * });
  */
 
-import { EventEmitter } from '../events';
-import { Logger, DEBUG, INFO, WARN } from '../logging';
+import { EventEmitter } from '../../../classes/event-emitter';
+import { Logger, DEBUG, INFO, WARN } from '../../../logging/index.js';
 
 import {
   NOT_CREATED,
   CREATED,
   RUNNING,
   DESTROYED
-} from './service-states.js';
+} from '../service-base/constants.js';
 
 /**
  * @typedef {import('./typedef.js').ServiceConstructor} ServiceConstructor
  * @typedef {import('./typedef.js').ServiceRegistrationOptions} ServiceRegistrationOptions
  * @typedef {import('./typedef.js').ServiceManagerConfig} ServiceManagerConfig
- * @typedef {import('./typedef.js').StopOptions} StopOptions
  * @typedef {import('./typedef.js').ServiceEntry} ServiceEntry
  * @typedef {import('./typedef.js').HealthCheckResult} HealthCheckResult
+ *
+ * @typedef {import('../service-base/typedef.js').StopOptions} StopOptions
  */
 
 /**
@@ -544,7 +545,7 @@ export class ServiceManager extends EventEmitter {
    *
    * @private
    * @param {string} name - Service name
-   * @param {import('./typedef.js').ServiceInstance} instance
+   * @param {import('../service-base/typedef.js').ServiceInstance} instance
    *   Service instance
    */
   _attachServiceEvents(name, instance) {

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

@@ -0,0 +1,4 @@
+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";

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

@@ -0,0 +1,6 @@
+
+// Log event names
+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';

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

@@ -0,0 +1,104 @@
+/**
+ * Options for registering a service
+ */
+export type ServiceRegistrationOptions = {
+    /**
+     * - Services this service depends on
+     */
+    dependencies?: string[];
+    /**
+     * - Tags for grouping services
+     */
+    tags?: string[];
+    /**
+     * - Startup priority (higher starts first)
+     */
+    priority?: number;
+};
+/**
+ * Configuration for ServiceManager
+ */
+export type ServiceManagerConfig = {
+    /**
+     * - Debug mode switch
+     */
+    debug?: boolean;
+    /**
+     * - Auto-start services on registration
+     */
+    autoStart?: boolean;
+    /**
+     * - Default timeout for stopping services
+     */
+    stopTimeout?: number;
+    /**
+     * - Initial log level for ServiceManager
+     */
+    logLevel?: string;
+    /**
+     * - Logging configuration
+     */
+    logConfig?: LogConfig;
+};
+/**
+ * Logging configuration
+ */
+export type LogConfig = {
+    /**
+     * - Default log level for services
+     */
+    defaultLevel?: string;
+    /**
+     * - Override level for all services
+     */
+    globalLevel?: string;
+    /**
+     * - Per-service log levels
+     */
+    serviceLevels?: {
+        [x: string]: string;
+    };
+};
+/**
+ * Result of health check for all services
+ */
+export type HealthCheckResult = {
+    [x: string]: HealthStatus;
+};
+/**
+ * Service class constructor type
+ */
+export type ServiceConstructor = new (name: string, options?: ServiceOptions) => ServiceInstance;
+/**
+ * Internal service registry entry
+ */
+export type ServiceEntry = {
+    /**
+     * - Service class constructor
+     */
+    ServiceClass: ServiceConstructor;
+    /**
+     * - Service instance (lazy-created)
+     */
+    instance: ServiceInstance | null;
+    /**
+     * - Service configuration
+     */
+    config: any;
+    /**
+     * - Service dependencies
+     */
+    dependencies: string[];
+    /**
+     * - Services that depend on this one
+     */
+    dependents: Set<string>;
+    /**
+     * - Service tags
+     */
+    tags: string[];
+    /**
+     * - Startup priority
+     */
+    priority: number;
+};

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

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Type definitions for ServiceManager class.
+ * 
+ * This file contains all TypeScript/JSDoc type definitions used by
+ * the ServiceManager class and service registration.
+ * 
+ * @example
+ * // When using ServiceManager
+ * import { ServiceManager } from './ServiceManager.js';
+ * 
+ * // @ typedef {import('./typedef-service-manager.js').ServiceManagerConfig} ServiceManagerConfig
+ * // @ typedef {import('./typedef-service-manager.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);
+ */
+
+// ============================================================================
+// PUBLIC TYPES
+// ============================================================================
+
+/**
+ * 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
+ */
+
+/**
+ * Result of health check for all services
+ * @typedef {Object<string, HealthStatus>} HealthCheckResult
+ */
+
+/**
+ * Service class constructor type
+ *
+ * @typedef {new (name: string, options?: ServiceOptions) => ServiceInstance} ServiceConstructor
+ */
+
+// ============================================================================
+// INTERNAL TYPES
+// ============================================================================
+
+/**
+ * Internal service registry entry
+ *
+ * @typedef {Object} ServiceEntry
+ * @property {ServiceConstructor} ServiceClass - Service class constructor
+ * @property {ServiceInstance|null} instance - Service instance (lazy-created)
+ * @property {*} 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
+ */
+
+export {};

package/package.json

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

package/dist/classes/services/index.d.ts

@@ -1,4 +0,0 @@
-export { default as ServiceBase } from "./ServiceBase.js";
-export { default as ServiceManager } from "./ServiceManager.js";
-export * from "./service-states.js";
-export * from "./typedef.js";

package/dist/classes/services/index.js

@@ -1,5 +0,0 @@
-export { default as ServiceBase } from './ServiceBase.js';
-export { default as ServiceManager } from './ServiceManager.js';
-
-export * from './service-states.js';
-export * from './typedef.js';

package/dist/features/index.d.ts

@@ -1,11 +0,0 @@
-export { default as ButtonGroup } from "./button-group/ButtonGroup.svelte";
-export { default as CompareLeftRight } from "./compare-left-right/CompareLeftRight.svelte";
-export { default as GameBox } from "./game-box/GameBox.svelte";
-export { default as HkAppLayout } from "./hk-app-layout/HkAppLayout.svelte";
-export { default as ImageBox } from "./image-box/ImageBox.svelte";
-export { default as Presenter } from "./presenter/Presenter.svelte";
-export { default as ImageSlide } from "./presenter/ImageSlide.svelte";
-export { default as VirtualViewport } from "./virtual-viewport/VirtualViewport.svelte";
-export * from "./button-group/typedef.js";
-export * from "./presenter/typedef.js";
-export { createOrGetState as createOrGetAppLayoutState, createState as createAppLayoutState, getState as getAppLayoutState } from "./hk-app-layout/HkAppLayout.state.svelte.js";

package/dist/features/index.js

@@ -1,23 +0,0 @@
-export { default as ButtonGroup } from './button-group/ButtonGroup.svelte';
-export { default as CompareLeftRight } from './compare-left-right/CompareLeftRight.svelte';
-export { default as GameBox } from './game-box/GameBox.svelte';
-
-export {
-  createOrGetState as createOrGetAppLayoutState,
-  createState as createAppLayoutState,
-  getState as getAppLayoutState
-} from './hk-app-layout/HkAppLayout.state.svelte.js';
-
-export { default as HkAppLayout } from './hk-app-layout/HkAppLayout.svelte';
-
-export { default as ImageBox } from './image-box/ImageBox.svelte';
-
-export { default as Presenter } from './presenter/Presenter.svelte';
-export { default as ImageSlide } from './presenter/ImageSlide.svelte';
-
-export { default as VirtualViewport } from './virtual-viewport/VirtualViewport.svelte';
-
-// > Types
-
-export * from './button-group/typedef.js';
-export * from './presenter/typedef.js';

package/dist/logging/constants.d.ts

@@ -1 +0,0 @@
-export * from "../classes/logging/constants.js";

package/dist/logging/constants.js

@@ -1 +0,0 @@
-export * from '../classes/logging/constants.js';

package/dist/server/index.d.ts

@@ -1 +0,0 @@
-export * from "./logger.js";

package/dist/server/index.js

@@ -1 +0,0 @@
-export * from './logger.js';