@nestjs/common 12.0.0-alpha.0 → 12.0.0-alpha.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/common",
-  "version": "12.0.0-alpha.0",
+  "version": "12.0.0-alpha.1",
   "description": "Nest - modern, fast, powerful node.js web framework (@common)",
   "author": "Kamil Mysliwiec",
   "homepage": "https://nestjs.com",

package/utils/load-package.util.d.ts

@@ -19,3 +19,11 @@ export declare function loadPackageSync(packageName: string, context: string, lo
  * before calling this function (typically during `init()` or `compile()`).
  */
 export declare function loadPackageCached(packageName: string): any;
+/**
+ * Attempts to load and cache a package. Returns the loaded module on success
+ * or `null` if the package is not installed.
+ *
+ * Unlike {@link loadPackage}, this function does **not** terminate the process
+ * when the package is missing, making it suitable for optional dependencies.
+ */
+export declare function tryLoadPackage(packageName: string, loaderFn?: Function): Promise<any>;

package/utils/load-package.util.js

@@ -1,6 +1,6 @@
 import { createRequire } from 'module';
 import { Logger } from '../services/logger.service.js';
-const MISSING_REQUIRED_DEPENDENCY = (name, reason) => `The "${name}" package is missing. Please, make sure to install it to take advantage of ${reason}.`;
+const MISSING_REQUIRED_DEPENDENCY = (name, reason) => `The "${name}" package is missing. Please, make sure to install it to use ${reason}.`;
 const logger = new Logger('PackageLoader');
 /**
  * Cache of already-loaded packages keyed by package name.
@@ -68,3 +68,24 @@ export function loadPackageCached(packageName) {
     }
     return cached;
 }
+/**
+ * Attempts to load and cache a package. Returns the loaded module on success
+ * or `null` if the package is not installed.
+ *
+ * Unlike {@link loadPackage}, this function does **not** terminate the process
+ * when the package is missing, making it suitable for optional dependencies.
+ */
+export async function tryLoadPackage(packageName, loaderFn) {
+    const cached = packageCache.get(packageName);
+    if (cached) {
+        return cached;
+    }
+    try {
+        const pkg = loaderFn ? await loaderFn() : await import(packageName);
+        packageCache.set(packageName, pkg);
+        return pkg;
+    }
+    catch {
+        return null;
+    }
+}