@hkdigital/lib-core 0.4.51 → 0.4.53

package/dist/services/service-manager/ServiceManager.d.ts

@@ -81,9 +81,20 @@ export class ServiceManager extends EventEmitter {
      * @template {import('../service-base/typedef.js').ServiceInstance} T
      * @param {string} name - Service name
      *
-     * @returns {T|null} Service instance or null if not found
+     * @returns {T|undefined} Service instance or undefined if not found
      */
-    get<T extends import("../service-base/typedef.js").ServiceInstance>(name: string): T | null;
+    get<T extends import("../service-base/typedef.js").ServiceInstance>(name: string): T | undefined;
+    /**
+     * Get or create a service instance with error throwing
+     *
+     * @template {import('../service-base/typedef.js').ServiceInstance} T
+     * @param {string} name - Service name
+     *
+     * @returns {T} Service instance
+     *
+     * @throws {Error} If service is not found or cannot be created
+     */
+    getService<T extends import("../service-base/typedef.js").ServiceInstance>(name: string): T;
     /**
      * Configure a service
      *

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

@@ -261,7 +261,7 @@ export class ServiceManager extends EventEmitter {
    * @template {import('../service-base/typedef.js').ServiceInstance} T
    * @param {string} name - Service name
    *
-   * @returns {T|null} Service instance or null if not found
+   * @returns {T|undefined} Service instance or undefined if not found
    */
   get(name) {
     // @throws service not found
@@ -288,13 +288,33 @@ export class ServiceManager extends EventEmitter {
           `Failed to create instance for '${name}'`,
           /** @type {Error} */ (error)
         );
-        return null;
+        return undefined;
       }
     }
 
     return entry.instance;
   }
 
+  /**
+   * Get or create a service instance with error throwing
+   *
+   * @template {import('../service-base/typedef.js').ServiceInstance} T
+   * @param {string} name - Service name
+   *
+   * @returns {T} Service instance
+   *
+   * @throws {Error} If service is not found or cannot be created
+   */
+  getService(name) {
+    const service = this.get(name);
+
+    if (!service) {
+      throw new Error(`Service [${name}] not found or could not be created`);
+    }
+
+    return /** @type {T} */ (service);
+  }
+
   /**
    * Configure a service
    *

package/package.json

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