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

package/decorators/core/optional.decorator.js

@@ -16,11 +16,11 @@ import { isUndefined } from '../../utils/shared.utils.js';
 export function Optional() {
     return (target, key, index) => {
         if (!isUndefined(index)) {
-            const args = Reflect.getMetadata(OPTIONAL_DEPS_METADATA, target) || [];
+            const args = Reflect.getOwnMetadata(OPTIONAL_DEPS_METADATA, target) || [];
             Reflect.defineMetadata(OPTIONAL_DEPS_METADATA, [...args, index], target);
             return;
         }
-        const properties = Reflect.getMetadata(OPTIONAL_PROPERTY_DEPS_METADATA, target.constructor) || [];
+        const properties = Reflect.getOwnMetadata(OPTIONAL_PROPERTY_DEPS_METADATA, target.constructor) || [];
         Reflect.defineMetadata(OPTIONAL_PROPERTY_DEPS_METADATA, [...properties, key], target.constructor);
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/common",
-  "version": "12.0.0-alpha.0",
+  "version": "12.0.0-alpha.2",
   "description": "Nest - modern, fast, powerful node.js web framework (@common)",
   "author": "Kamil Mysliwiec",
   "homepage": "https://nestjs.com",
@@ -21,34 +21,9 @@
   "main": "./index.js",
   "exports": {
     ".": "./index.js",
+    "./internal": "./internal.js",
     "./*.js": "./*.js",
-    "./*": "./*.js",
-    "./decorators": "./decorators/index.js",
-    "./decorators/core": "./decorators/core/index.js",
-    "./decorators/http": "./decorators/http/index.js",
-    "./decorators/modules": "./decorators/modules/index.js",
-    "./enums": "./enums/index.js",
-    "./exceptions": "./exceptions/index.js",
-    "./file-stream": "./file-stream/index.js",
-    "./file-stream/interfaces": "./file-stream/interfaces/index.js",
-    "./interfaces": "./interfaces/index.js",
-    "./interfaces/controllers": "./interfaces/controllers/index.js",
-    "./interfaces/exceptions": "./interfaces/exceptions/index.js",
-    "./interfaces/hooks": "./interfaces/hooks/index.js",
-    "./interfaces/http": "./interfaces/http/index.js",
-    "./interfaces/middleware": "./interfaces/middleware/index.js",
-    "./interfaces/modules": "./interfaces/modules/index.js",
-    "./module-utils": "./module-utils/index.js",
-    "./module-utils/interfaces": "./module-utils/interfaces/index.js",
-    "./module-utils/utils": "./module-utils/utils/index.js",
-    "./pipes": "./pipes/index.js",
-    "./pipes/file": "./pipes/file/index.js",
-    "./pipes/file/interfaces": "./pipes/file/interfaces/index.js",
-    "./serializer": "./serializer/index.js",
-    "./serializer/decorators": "./serializer/decorators/index.js",
-    "./services": "./services/index.js",
-    "./services/utils": "./services/utils/index.js",
-    "./utils": "./utils/index.js"
+    "./*": "./*.js"
   },
   "dependencies": {
     "file-type": "21.3.0",
@@ -71,5 +46,5 @@
       "optional": true
     }
   },
-  "gitHead": "7035ecc828a2a9f752aad188871b1171663a20c2"
+  "gitHead": "011bff66014e24e82b25f7acf9302b9efb70b02b"
 }

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;
+    }
+}