@hkdigital/lib-core 0.4.53 → 0.4.55

package/dist/services/README.md

@@ -199,6 +199,56 @@ const health = await manager.checkHealth();
 await manager.stopAll();
 ```
 
+### Service Access Patterns
+
+Services receive helpful utilities in their constructor options for accessing other services:
+
+```javascript
+class AuthService extends ServiceBase {
+  constructor(serviceName, options) {
+    super(serviceName, options);
+    
+    // Store service access utilities
+    this.getManager = options.getManager;   // Function to get manager (lazy)
+    this.getService = options.getService;   // Bound getService function
+  }
+  
+  async authenticateUser(credentials) {
+    // Access other services with full type safety and error checking
+    const database = this.getService('database');
+    const user = await database.findUser(credentials.username);
+    
+    // Access manager for advanced operations
+    const manager = this.getManager();
+    const health = await manager.checkHealth();
+    
+    return user;
+  }
+}
+```
+
+**Service Access Methods:**
+
+```javascript
+// ServiceManager provides two access patterns:
+
+// 1. Permissive - returns undefined if not found/created
+const service = manager.get('optional-service');
+if (service) {
+  // Use service safely
+}
+
+// 2. Strict - throws error if not found/created  
+const service = manager.getService('required-service'); // Throws if missing
+```
+
+**Benefits of constructor utilities:**
+
+- **Lightweight** - Functions don't serialize, keeping services serialization-safe
+- **Lazy access** - Manager is only accessed when needed
+- **Type safety** - Full generic support with `getService<DatabaseService>('database')`
+- **Error handling** - Clear errors when services are missing
+
 ### Service Registration
 
 ```javascript

package/dist/services/index.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Create a getService function with a preset manager
+ *
+ * @param {import('./service-manager/ServiceManager.js').default} manager
+ *   ServiceManager instance to use
+ *
+ * @returns {<T>(serviceName: string) => T} getService function with preset manager
+ */
+export function createGetService(manager: import("./service-manager/ServiceManager.js").default): <T>(serviceName: string) => T;
 export { default as ServiceBase } from "./service-base/ServiceBase.js";
 export { default as ServiceManager } from "./service-manager/ServiceManager.js";
 export * from "./service-base/constants.js";

package/dist/services/index.js

@@ -3,3 +3,33 @@ export { default as ServiceManager } from './service-manager/ServiceManager.js';
 
 export * from './service-base/constants.js';
 export * from './service-manager/constants.js';
+
+/**
+ * Create a getService function with a preset manager
+ *
+ * @param {import('./service-manager/ServiceManager.js').default} manager
+ *   ServiceManager instance to use
+ *
+ * @returns {<T>(serviceName: string) => T} getService function with preset manager
+ */
+export function createGetService(manager) {
+  /**
+   * Get a typed service instance from the preset manager
+   *
+   * @template T
+   * @param {string} serviceName - Name of the service to retrieve
+   *
+   * @returns {T} The service instance cast to the specified type
+   *
+   * @throws {Error} If service is not found
+   */
+  return function getService(serviceName) {
+    const service = manager.get(serviceName);
+
+    if (!service) {
+      throw new Error(`Service [${serviceName}] not found`);
+    }
+
+    return /** @type {T} */ (service);
+  };
+}

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

@@ -19,7 +19,14 @@ export type ServiceState = "not-created" | "created" | "configuring" | "configur
  * Options for creating a service instance
  */
 export type ServiceOptions = {
-    manager: import("../service-manager/ServiceManager.js").default;
+    /**
+     * - Function to get manager instance
+     */
+    getManager: () => import("../service-manager/ServiceManager.js").default;
+    /**
+     * - Bound getService function
+     */
+    getService: <T>(serviceName: string) => T;
     /**
      * - Initial log level for the service
      */

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

@@ -53,7 +53,8 @@
  * Options for creating a service instance
  *
  * @typedef {Object} ServiceOptions
- * @property {import('../service-manager/ServiceManager.js').default} manager
+ * @property {() => import('../service-manager/ServiceManager.js').default} getManager - Function to get manager instance
+ * @property {<T>(serviceName: string) => T} getService - Bound getService function
  * @property {import('../../logging/typedef.js').LogLevel} [logLevel] - Initial log level for the service
  * @property {number} [shutdownTimeout=5000] - Timeout for graceful shutdown
  */

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

@@ -269,7 +269,10 @@ export class ServiceManager extends EventEmitter {
 
     if (!entry.instance) {
       try {
-        const options = { manager: this };
+        const options = { 
+          getManager: () => this,
+          getService: this.getService.bind(this)
+        };
 
         entry.instance = new entry.ServiceClass(name, options);
 

package/package.json

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