@nestjs/core 9.3.8 → 9.3.10

package/errors/exceptions/unknown-dependencies.exception.d.ts

@@ -1,6 +1,14 @@
 import { InjectorDependencyContext } from '../../injector/injector';
-import { RuntimeException } from './runtime.exception';
 import { Module } from '../../injector/module';
+import { RuntimeException } from './runtime.exception';
 export declare class UnknownDependenciesException extends RuntimeException {
-    constructor(type: string | symbol, unknownDependencyContext: InjectorDependencyContext, module?: Module);
+    readonly type: string | symbol;
+    readonly context: InjectorDependencyContext;
+    readonly moduleRef?: Module;
+    readonly metadata?: {
+        id: string;
+    };
+    constructor(type: string | symbol, context: InjectorDependencyContext, moduleRef?: Module, metadata?: {
+        id: string;
+    });
 }

package/errors/exceptions/unknown-dependencies.exception.js

@@ -4,8 +4,12 @@ exports.UnknownDependenciesException = void 0;
 const messages_1 = require("../messages");
 const runtime_exception_1 = require("./runtime.exception");
 class UnknownDependenciesException extends runtime_exception_1.RuntimeException {
-    constructor(type, unknownDependencyContext, module) {
-        super((0, messages_1.UNKNOWN_DEPENDENCIES_MESSAGE)(type, unknownDependencyContext, module));
+    constructor(type, context, moduleRef, metadata) {
+        super((0, messages_1.UNKNOWN_DEPENDENCIES_MESSAGE)(type, context, moduleRef));
+        this.type = type;
+        this.context = context;
+        this.moduleRef = moduleRef;
+        this.metadata = metadata;
     }
 }
 exports.UnknownDependenciesException = UnknownDependenciesException;

package/errors/messages.js

@@ -20,7 +20,7 @@ const getInstanceName = (instance) => {
  * Returns the name of the dependency
  * Tries to get the class name, otherwise the string value
  * (= injection token). As fallback it returns '+'
- * @param dependency The dependency whichs name should get displayed
+ * @param dependency The name of the dependency to be displayed
  */
 const getDependencyName = (dependency) => 
 // use class name

package/helpers/index.d.ts

@@ -1,2 +1,3 @@
 export * from './context-id-factory';
+export * from './external-context-creator';
 export * from './http-adapter-host';

package/helpers/index.js

@@ -2,4 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./context-id-factory"), exports);
+tslib_1.__exportStar(require("./external-context-creator"), exports);
 tslib_1.__exportStar(require("./http-adapter-host"), exports);

package/injector/helpers/transient-instances.d.ts

@@ -2,11 +2,11 @@ import { InstanceWrapper } from '../instance-wrapper';
 import { InstanceToken } from '../module';
 /**
  * Returns the instances which are transient
- * @param instances The instances which should be checked whether they are transcient
+ * @param instances The instances which should be checked whether they are transient
  */
 export declare function getTransientInstances(instances: [InstanceToken, InstanceWrapper][]): InstanceWrapper[];
 /**
  * Returns the instances which are not transient
- * @param instances The instances which should be checked whether they are transcient
+ * @param instances The instances which should be checked whether they are transient
  */
 export declare function getNonTransientInstances(instances: [InstanceToken, InstanceWrapper][]): InstanceWrapper[];

package/injector/helpers/transient-instances.js

@@ -4,7 +4,7 @@ exports.getNonTransientInstances = exports.getTransientInstances = void 0;
 const iterare_1 = require("iterare");
 /**
  * Returns the instances which are transient
- * @param instances The instances which should be checked whether they are transcient
+ * @param instances The instances which should be checked whether they are transient
  */
 function getTransientInstances(instances) {
     return (0, iterare_1.iterate)(instances)
@@ -18,7 +18,7 @@ function getTransientInstances(instances) {
 exports.getTransientInstances = getTransientInstances;
 /**
  * Returns the instances which are not transient
- * @param instances The instances which should be checked whether they are transcient
+ * @param instances The instances which should be checked whether they are transient
  */
 function getNonTransientInstances(instances) {
     return (0, iterare_1.iterate)(instances)

package/injector/injector.d.ts

@@ -83,4 +83,5 @@ export declare class Injector {
     private printFoundInModuleLog;
     private isDebugMode;
     private getContextId;
+    private getNowTimestamp;
 }

package/injector/injector.js

@@ -6,6 +6,7 @@ const constants_1 = require("@nestjs/common/constants");
 const cli_colors_util_1 = require("@nestjs/common/utils/cli-colors.util");
 const shared_utils_1 = require("@nestjs/common/utils/shared.utils");
 const iterare_1 = require("iterare");
+const perf_hooks_1 = require("perf_hooks");
 const runtime_exception_1 = require("../errors/exceptions/runtime.exception");
 const undefined_dependency_exception_1 = require("../errors/exceptions/undefined-dependency.exception");
 const unknown_dependencies_exception_1 = require("../errors/exceptions/unknown-dependencies.exception");
@@ -49,10 +50,12 @@ class Injector {
             return done();
         }
         try {
+            const t0 = this.getNowTimestamp();
             const callback = async (instances) => {
                 const properties = await this.resolveProperties(wrapper, moduleRef, inject, contextId, wrapper, inquirer);
                 const instance = await this.instantiateClass(instances, wrapper, targetWrapper, contextId, inquirer);
                 this.applyProperties(instance, properties);
+                wrapper.initTime = this.getNowTimestamp() - t0;
                 done();
             };
             await this.resolveConstructorParams(wrapper, moduleRef, inject, callback, contextId, wrapper, inquirer);
@@ -228,7 +231,7 @@ class Injector {
         const token = wrapper.token || wrapper.name;
         const { name } = dependencyContext;
         if (wrapper && token === name) {
-            throw new unknown_dependencies_exception_1.UnknownDependenciesException(wrapper.name, dependencyContext, moduleRef);
+            throw new unknown_dependencies_exception_1.UnknownDependenciesException(wrapper.name, dependencyContext, moduleRef, { id: wrapper.id });
         }
         if (providers.has(name)) {
             const instanceWrapper = providers.get(name);
@@ -241,7 +244,7 @@ class Injector {
     async lookupComponentInParentModules(dependencyContext, moduleRef, wrapper, contextId = constants_2.STATIC_CONTEXT, inquirer, keyOrIndex) {
         const instanceWrapper = await this.lookupComponentInImports(moduleRef, dependencyContext.name, wrapper, [], contextId, inquirer, keyOrIndex);
         if ((0, shared_utils_1.isNil)(instanceWrapper)) {
-            throw new unknown_dependencies_exception_1.UnknownDependenciesException(wrapper.name, dependencyContext, moduleRef);
+            throw new unknown_dependencies_exception_1.UnknownDependenciesException(wrapper.name, dependencyContext, moduleRef, { id: wrapper.id });
         }
         return instanceWrapper;
     }
@@ -454,5 +457,8 @@ class Injector {
             })
             : contextId;
     }
+    getNowTimestamp() {
+        return perf_hooks_1.performance.now();
+    }
 }
 exports.Injector = Injector;

package/injector/instance-loader.js

@@ -18,7 +18,14 @@ class InstanceLoader {
     }
     async createInstancesOfDependencies(modules = this.container.getModules()) {
         this.createPrototypes(modules);
-        await this.createInstances(modules);
+        try {
+            await this.createInstances(modules);
+        }
+        catch (err) {
+            this.graphInspector.inspectModules(modules);
+            this.graphInspector.registerPartial(err);
+            throw err;
+        }
         this.graphInspector.inspectModules(modules);
     }
     createPrototypes(modules) {

package/injector/instance-wrapper.d.ts

@@ -41,6 +41,7 @@ export declare class InstanceWrapper<T = any> {
     inject?: FactoryProvider['inject'];
     forwardRef?: boolean;
     durable?: boolean;
+    initTime?: number;
     private static logger;
     private readonly values;
     private readonly [INSTANCE_METADATA_SYMBOL];

package/inspector/graph-inspector.d.ts

@@ -11,6 +11,7 @@ export declare class GraphInspector {
     private readonly enhancersMetadataCache;
     constructor(container: NestContainer);
     inspectModules(modules?: Map<string, Module>): void;
+    registerPartial(error: unknown): void;
     inspectInstanceWrapper<T = any>(source: InstanceWrapper<T>, moduleRef: Module): void;
     insertEnhancerMetadataCache(entry: EnhancerMetadataCacheEntry): void;
     insertOrphanedEnhancer(entry: OrphanedEnhancerDefinition): void;

package/inspector/graph-inspector.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GraphInspector = void 0;
+const unknown_dependencies_exception_1 = require("../errors/exceptions/unknown-dependencies.exception");
 const deterministic_uuid_registry_1 = require("./deterministic-uuid-registry");
+const partial_graph_host_1 = require("./partial-graph.host");
 class GraphInspector {
     constructor(container) {
         this.container = container;
@@ -17,6 +19,29 @@ class GraphInspector {
         this.enhancersMetadataCache.forEach(entry => this.insertEnhancerEdge(entry));
         deterministic_uuid_registry_1.DeterministicUuidRegistry.clear();
     }
+    registerPartial(error) {
+        var _a, _b;
+        this.graph.status = 'partial';
+        if (error instanceof unknown_dependencies_exception_1.UnknownDependenciesException) {
+            this.graph.metadata = {
+                cause: {
+                    type: 'unknown-dependencies',
+                    context: error.context,
+                    moduleId: (_a = error.moduleRef) === null || _a === void 0 ? void 0 : _a.id,
+                    nodeId: (_b = error.metadata) === null || _b === void 0 ? void 0 : _b.id,
+                },
+            };
+        }
+        else {
+            this.graph.metadata = {
+                cause: {
+                    type: 'unknown',
+                    error,
+                },
+            };
+        }
+        partial_graph_host_1.PartialGraphHost.register(this.graph);
+    }
     inspectInstanceWrapper(source, moduleRef) {
         const ctorMetadata = source.getCtorMetadata();
         ctorMetadata === null || ctorMetadata === void 0 ? void 0 : ctorMetadata.forEach((target, index) => this.insertClassToClassEdge(source, target, moduleRef, index, 'constructor'));
@@ -55,6 +80,7 @@ class GraphInspector {
                 exported: moduleRef.exports.has(wrapper.token),
                 token: wrapper.token,
                 subtype: wrapper.subtype,
+                initTime: wrapper.initTime,
             },
         });
     }

package/inspector/index.d.ts

@@ -1,2 +1,4 @@
 export * from './graph-inspector';
 export * from './initialize-on-preview.allowlist';
+export * from './partial-graph.host';
+export * from './serialized-graph';

package/inspector/index.js

@@ -3,3 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./graph-inspector"), exports);
 tslib_1.__exportStar(require("./initialize-on-preview.allowlist"), exports);
+tslib_1.__exportStar(require("./partial-graph.host"), exports);
+tslib_1.__exportStar(require("./serialized-graph"), exports);

package/inspector/interfaces/node.interface.d.ts

@@ -20,6 +20,7 @@ export type ClassNode = {
         exported: boolean;
         scope: Scope;
         token: InjectionToken;
+        initTime: number;
         /**
          * Enhancers metadata collection
          */

package/inspector/interfaces/serialized-graph-json.interface.d.ts

@@ -0,0 +1,14 @@
+import { SerializedGraphStatus } from '../serialized-graph';
+import { Edge } from './edge.interface';
+import { Entrypoint } from './entrypoint.interface';
+import { Extras } from './extras.interface';
+import { Node } from './node.interface';
+import { SerializedGraphMetadata } from './serialized-graph-metadata.interface';
+export interface SerializedGraphJson {
+    nodes: Record<string, Node>;
+    edges: Record<string, Edge>;
+    entrypoints: Record<string, Entrypoint<unknown>[]>;
+    extras: Extras;
+    status?: SerializedGraphStatus;
+    metadata?: SerializedGraphMetadata;
+}

package/inspector/interfaces/serialized-graph-json.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/inspector/interfaces/serialized-graph-metadata.interface.d.ts

@@ -0,0 +1,10 @@
+import { InjectorDependencyContext } from '../../injector/injector';
+export interface SerializedGraphMetadata {
+    cause: {
+        type: 'unknown-dependencies' | 'unknown';
+        context?: InjectorDependencyContext;
+        moduleId?: string;
+        nodeId?: string;
+        error?: any;
+    };
+}

package/inspector/interfaces/serialized-graph-metadata.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/inspector/partial-graph.host.d.ts

@@ -0,0 +1,7 @@
+import { SerializedGraph } from './serialized-graph';
+export declare class PartialGraphHost {
+    private static partialGraph;
+    static toJSON(): import("./interfaces/serialized-graph-json.interface").SerializedGraphJson;
+    static toString(): string;
+    static register(partialGraph: SerializedGraph): void;
+}

package/inspector/partial-graph.host.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PartialGraphHost = void 0;
+class PartialGraphHost {
+    static toJSON() {
+        var _a;
+        return (_a = this.partialGraph) === null || _a === void 0 ? void 0 : _a.toJSON();
+    }
+    static toString() {
+        var _a;
+        return (_a = this.partialGraph) === null || _a === void 0 ? void 0 : _a.toString();
+    }
+    static register(partialGraph) {
+        this.partialGraph = partialGraph;
+    }
+}
+exports.PartialGraphHost = PartialGraphHost;

package/inspector/serialized-graph.d.ts

@@ -1,15 +1,22 @@
 import { InjectionToken } from '@nestjs/common';
 import { Edge } from './interfaces/edge.interface';
 import { Entrypoint } from './interfaces/entrypoint.interface';
-import { Extras, OrphanedEnhancerDefinition } from './interfaces/extras.interface';
+import { OrphanedEnhancerDefinition } from './interfaces/extras.interface';
 import { Node } from './interfaces/node.interface';
+import { SerializedGraphJson } from './interfaces/serialized-graph-json.interface';
+import { SerializedGraphMetadata } from './interfaces/serialized-graph-metadata.interface';
+export type SerializedGraphStatus = 'partial' | 'complete';
 type WithOptionalId<T extends Record<'id', string>> = Omit<T, 'id'> & Partial<Pick<T, 'id'>>;
 export declare class SerializedGraph {
     private readonly nodes;
     private readonly edges;
     private readonly entrypoints;
     private readonly extras;
+    private _status;
+    private _metadata?;
     private static readonly INTERNAL_PROVIDERS;
+    set status(status: SerializedGraphStatus);
+    set metadata(metadata: SerializedGraphMetadata);
     insertNode(nodeDefinition: Node): Node;
     insertEdge(edgeDefinition: WithOptionalId<Edge>): {
         id: string;
@@ -38,18 +45,7 @@ export declare class SerializedGraph {
     insertOrphanedEnhancer(entry: OrphanedEnhancerDefinition): void;
     insertAttachedEnhancer(nodeId: string): void;
     getNodeById(id: string): Node;
-    toJSON(): {
-        nodes: {
-            [k: string]: Node;
-        };
-        edges: {
-            [k: string]: Edge;
-        };
-        entrypoints: {
-            [k: string]: Entrypoint<unknown>[];
-        };
-        extras: Extras;
-    };
+    toJSON(): SerializedGraphJson;
     toString(): string;
     private generateUuidByEdgeDefinition;
 }

package/inspector/serialized-graph.js

@@ -20,6 +20,13 @@ class SerializedGraph {
             orphanedEnhancers: [],
             attachedEnhancers: [],
         };
+        this._status = 'complete';
+    }
+    set status(status) {
+        this._status = status;
+    }
+    set metadata(metadata) {
+        this._metadata = metadata;
     }
     insertNode(nodeDefinition) {
         if (nodeDefinition.metadata.type === 'provider' &&
@@ -65,12 +72,19 @@ class SerializedGraph {
         return this.nodes.get(id);
     }
     toJSON() {
-        return {
+        const json = {
             nodes: Object.fromEntries(this.nodes),
             edges: Object.fromEntries(this.edges),
             entrypoints: Object.fromEntries(this.entrypoints),
             extras: this.extras,
         };
+        if (this._status) {
+            json['status'] = this._status;
+        }
+        if (this._metadata) {
+            json['metadata'] = this._metadata;
+        }
+        return json;
     }
     toString() {
         const replacer = (key, value) => {

package/metadata-scanner.d.ts

@@ -2,11 +2,15 @@ import { Injectable } from '@nestjs/common/interfaces/injectable.interface';
 export declare class MetadataScanner {
     private readonly cachedScannedPrototypes;
     /**
-     * @deprecated Use {@link getAllMethodNames} instead.
+     * @deprecated
+     * @see {@link getAllMethodNames}
+     * @see getAllMethodNames
      */
     scanFromPrototype<T extends Injectable, R = any>(instance: T, prototype: object, callback: (name: string) => R): R[];
     /**
-     * @deprecated Use {@link getAllMethodNames} instead.
+     * @deprecated
+     * @see {@link getAllMethodNames}
+     * @see getAllMethodNames
      */
     getAllFilteredMethodNames(prototype: object): IterableIterator<string>;
     getAllMethodNames(prototype: object | null): string[];

package/metadata-scanner.js

@@ -7,7 +7,9 @@ class MetadataScanner {
         this.cachedScannedPrototypes = new Map();
     }
     /**
-     * @deprecated Use {@link getAllMethodNames} instead.
+     * @deprecated
+     * @see {@link getAllMethodNames}
+     * @see getAllMethodNames
      */
     scanFromPrototype(instance, prototype, callback) {
         if (!prototype) {
@@ -40,7 +42,9 @@ class MetadataScanner {
         return result;
     }
     /**
-     * @deprecated Use {@link getAllMethodNames} instead.
+     * @deprecated
+     * @see {@link getAllMethodNames}
+     * @see getAllMethodNames
      */
     *getAllFilteredMethodNames(prototype) {
         yield* this.getAllMethodNames(prototype);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/core",
-  "version": "9.3.8",
+  "version": "9.3.10",
   "description": "Nest - modern, fast, powerful node.js web framework (@core)",
   "author": "Kamil Mysliwiec",
   "license": "MIT",
@@ -35,7 +35,7 @@
     "uid": "2.0.1"
   },
   "devDependencies": {
-    "@nestjs/common": "9.3.8"
+    "@nestjs/common": "9.3.10"
   },
   "peerDependencies": {
     "@nestjs/common": "^9.0.0",

package/repl/repl-context.js

@@ -76,14 +76,14 @@ class ReplContext {
         const nativeFunction = new NativeFunctionRef(this);
         const nativeFunctions = [nativeFunction];
         this.nativeFunctions.set(nativeFunction.fnDefinition.name, nativeFunction);
-        (_a = nativeFunction.fnDefinition.aliases) === null || _a === void 0 ? void 0 : _a.forEach(aliaseName => {
+        (_a = nativeFunction.fnDefinition.aliases) === null || _a === void 0 ? void 0 : _a.forEach(aliasName => {
             const aliasNativeFunction = Object.create(nativeFunction);
             aliasNativeFunction.fnDefinition = {
-                name: aliaseName,
+                name: aliasName,
                 description: aliasNativeFunction.fnDefinition.description,
                 signature: aliasNativeFunction.fnDefinition.signature,
             };
-            this.nativeFunctions.set(aliaseName, aliasNativeFunction);
+            this.nativeFunctions.set(aliasName, aliasNativeFunction);
             nativeFunctions.push(aliasNativeFunction);
         });
         return nativeFunctions;

package/inspector/on-preview-allowlist.registry.js

@@ -1 +0,0 @@
-"use strict";