@nest-forge/core 0.0.3 → 0.0.5

package/dist/constants-public.d.ts

@@ -0,0 +1,2 @@
+export declare const FORGE_ROOT_MODULE: unique symbol;
+export declare const FORGE_APP_OPTIONS: unique symbol;

package/dist/constants-public.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORGE_APP_OPTIONS = exports.FORGE_ROOT_MODULE = void 0;
+exports.FORGE_ROOT_MODULE = Symbol('FORGE_ROOT_MODULE');
+exports.FORGE_APP_OPTIONS = Symbol('FORGE_APP_OPTIONS');

package/dist/constants.d.ts

@@ -1,4 +1,3 @@
-export declare const FORGE_ROOT_MODULE: unique symbol;
 export declare const FORGE_FIELD_MODULE_REF: unique symbol;
 export declare const FORGE_TOKEN_ROOT_MODULE: unique symbol;
 export declare const FORGE_PATCHED: unique symbol;

package/dist/constants.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FORGE_PATCH_ENABLE_INIT = exports.FORGE_PATCH_BOOT_CALLBACK = exports.FORGE_PATCHED = exports.FORGE_TOKEN_ROOT_MODULE = exports.FORGE_FIELD_MODULE_REF = exports.FORGE_ROOT_MODULE = void 0;
-exports.FORGE_ROOT_MODULE = Symbol('FORGE_ROOT_MODULE');
+exports.FORGE_PATCH_ENABLE_INIT = exports.FORGE_PATCH_BOOT_CALLBACK = exports.FORGE_PATCHED = exports.FORGE_TOKEN_ROOT_MODULE = exports.FORGE_FIELD_MODULE_REF = void 0;
 exports.FORGE_FIELD_MODULE_REF = Symbol('FORGE_FIELD_MODULE_REF');
 exports.FORGE_TOKEN_ROOT_MODULE = Symbol('FORGE_TOKEN_ROOT_MODULE');
 exports.FORGE_PATCHED = Symbol('FORGE_PATCHED');

package/dist/extensions/extension.d.ts

@@ -1,17 +1,9 @@
-import { INestApplication, INestApplicationContext, INestMicroservice, MiddlewareConsumer, ModuleMetadata, NestApplicationOptions } from '@nestjs/common';
+import { INestApplicationContext, INestMicroservice, MiddlewareConsumer, ModuleMetadata, NestApplicationOptions } from '@nestjs/common';
 import { ForgeBaseComponent, ForgeController, ForgeModule, ForgeService } from '../architecture';
 import { NestApplicationContextOptions } from '@nestjs/common/interfaces/nest-application-context-options.interface';
 import { NestMicroserviceOptions } from '@nestjs/common/interfaces/microservices/nest-microservice-options.interface';
-import { AbstractHttpAdapter } from '@nestjs/core';
+import { AbstractHttpAdapter, NestApplication } from '@nestjs/core';
 export declare abstract class ForgeExtension {
-    /**
-     * The metdata for this extension.
-     */
-    private readonly _metadata;
-    /**
-     * Constructs a new forge extension instance.
-     */
-    constructor(options?: ForgeExtensionMetadata);
     /**
      * Configures the HTTP adapter to use for the Nest application instance.
      *
@@ -21,7 +13,7 @@ export declare abstract class ForgeExtension {
     /**
      * Configures a Nest application instance.
      */
-    configureHttpApplication(application: INestApplication): any;
+    configureHttpApplication(application: NestApplication): any;
     /**
      * Configures the options object for a Nest application instance.
      */
@@ -72,15 +64,29 @@ export declare abstract class ForgeExtension {
      */
     augmentService(instance: ForgeService, moduleRef: any): any;
     /**
-     * Returns the metadata for this extension.
+     * Returns an array of imports to add onto the root module.
      */
-    getMetadata(): ForgeExtensionMetadata;
-}
-export interface ForgeExtensionMetadata extends ModuleMetadata {
+    getRootImports(): ModuleImport[];
+    /**
+     * Returns an array of providers to add onto the root module.
+     */
+    getRootProviders(): ModuleProvider[];
+    /**
+     * Returns an array of controllers to add onto the root module.
+     */
+    getRootControllers(): ModuleController[];
+    /**
+     * Returns an array of exports to add onto the root module.
+     */
+    getRootExports(): ModuleExport[];
     /**
-     * An optional array of nested extensions to import.
+     * Returns an array of nested extensions that will be imported along with this one.
      */
-    extensions?: ForgeExtensionResolvable[];
+    getNestedExtensions(): ForgeExtensionResolvable[];
 }
+export type ModuleImport = NonNullable<ModuleMetadata['imports']>[number];
+export type ModuleProvider = NonNullable<ModuleMetadata['providers']>[number];
+export type ModuleController = NonNullable<ModuleMetadata['controllers']>[number];
+export type ModuleExport = NonNullable<ModuleMetadata['exports']>[number];
 export type ForgeExtensionResolvable = ForgeExtension | (new () => ForgeExtension) | null | undefined | false;
 export type ForgeHttpAdapterLike = AbstractHttpAdapter | null | undefined | Promise<AbstractHttpAdapter | null | undefined>;

package/dist/extensions/extension.js

@@ -2,16 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ForgeExtension = void 0;
 class ForgeExtension {
-    /**
-     * The metdata for this extension.
-     */
-    _metadata;
-    /**
-     * Constructs a new forge extension instance.
-     */
-    constructor(options) {
-        this._metadata = options || {};
-    }
     /**
      * Configures the HTTP adapter to use for the Nest application instance.
      *
@@ -80,10 +70,34 @@ class ForgeExtension {
      */
     augmentService(instance, moduleRef) { }
     /**
-     * Returns the metadata for this extension.
+     * Returns an array of imports to add onto the root module.
+     */
+    getRootImports() {
+        return [];
+    }
+    /**
+     * Returns an array of providers to add onto the root module.
+     */
+    getRootProviders() {
+        return [];
+    }
+    /**
+     * Returns an array of controllers to add onto the root module.
+     */
+    getRootControllers() {
+        return [];
+    }
+    /**
+     * Returns an array of exports to add onto the root module.
+     */
+    getRootExports() {
+        return [];
+    }
+    /**
+     * Returns an array of nested extensions that will be imported along with this one.
      */
-    getMetadata() {
-        return this._metadata;
+    getNestedExtensions() {
+        return [];
     }
 }
 exports.ForgeExtension = ForgeExtension;

package/dist/forge.factory.d.ts

@@ -1,24 +1,25 @@
-import { DynamicModule, ForwardReference, INestApplication, INestApplicationContext, MiddlewareConsumer, Type } from '@nestjs/common';
+import { DynamicModule, ForwardReference, INestApplication, INestApplicationContext, MiddlewareConsumer, ModuleMetadata, Type } from '@nestjs/common';
 import { ForgeApplicationContextOptions, ForgeApplicationOptions, ForgeMicroserviceOptions } from './forge-options.interface';
 import { ForgeExtension, ForgeExtensionResolvable } from './extensions';
-import { AbstractHttpAdapter, ModuleRef } from '@nestjs/core';
-import { FORGE_ROOT_MODULE } from './constants';
+import { AbstractHttpAdapter, ModuleRef, NestApplication } from '@nestjs/core';
 import { ForgeBaseComponent, ForgeController, ForgeModule, ForgeService } from './architecture';
+import { FORGE_ROOT_MODULE } from './constants-public';
 declare class Forge {
     private _augmented;
-    create<T extends INestApplication = INestApplication>(appModule: IEntryNestModule, options?: ForgeApplicationOptions): Promise<T>;
-    create<T extends INestApplication = INestApplication>(appModule: IEntryNestModule, httpAdapter: AbstractHttpAdapter, options?: ForgeApplicationOptions): Promise<T>;
+    create<T extends INestApplication = NestApplication>(appModule: IEntryNestModule, options?: ForgeApplicationOptions): Promise<T>;
+    create<T extends INestApplication = NestApplication>(appModule: IEntryNestModule, httpAdapter: AbstractHttpAdapter, options?: ForgeApplicationOptions): Promise<T>;
     createApplicationContext(appModule: IEntryNestModule, options: ForgeApplicationContextOptions): Promise<INestApplicationContext>;
     createMicroservice<T extends object>(appModule: IEntryNestModule, options: ForgeMicroserviceOptions & T): Promise<import("@nestjs/common").INestMicroservice>;
     protected discoverExtensions(resolvables: ForgeExtensionResolvable | ForgeExtensionResolvable[]): ForgeExtension[];
     protected resolveExtension(resolvable: ForgeExtensionResolvable): ForgeExtension | null;
-    protected createRootModule(appModule: IEntryNestModule, extensions: ForgeExtension[]): {
+    protected createRootModule(appModule: IEntryNestModule, extensions: ForgeExtension[], options: any): Promise<{
         new (moduleRef: ModuleRef): {
             readonly moduleRef: ModuleRef;
             configure(consumer: MiddlewareConsumer): Promise<void>;
             readonly [FORGE_ROOT_MODULE]: true;
         };
-    };
+    }>;
+    protected _getExtensionMetadata(extension: ForgeExtension): Promise<ExtensionMetadata>;
     protected createInstrument(extensions: ForgeExtension[], originalInstrument?: Instrument): InstrumentResponse;
     protected augmentComponents(instances: ForgeBaseComponent[], extensions: ForgeExtension[]): Promise<void>;
     protected augmentComponent(instance: ForgeBaseComponent, extensions: ForgeExtension[]): Promise<void>;
@@ -34,9 +35,15 @@ type IEntryNestModule = Type<any> | DynamicModule | ForwardReference | Promise<I
 type Instrument = {
     instanceDecorator: (instance: unknown) => unknown;
 };
+type NonNullableFields<T> = {
+    [P in keyof T]-?: NonNullable<T[P]>;
+};
 interface InstrumentResponse {
     instances: ForgeBaseComponent[];
     instanceDecorator: (instance: unknown) => any;
 }
+interface ExtensionMetadata extends NonNullableFields<ModuleMetadata> {
+    extensions: ForgeExtensionResolvable[];
+}
 declare const forge: Forge;
 export { forge as Forge };

package/dist/forge.factory.js

@@ -6,6 +6,7 @@ const common_1 = require("@nestjs/common");
 const core_1 = require("@nestjs/core");
 const constants_1 = require("./constants");
 const architecture_1 = require("./architecture");
+const constants_public_1 = require("./constants-public");
 class Forge {
     _augmented = new Set();
     async create(appModule, optionsOrHttpAdapter, optionsFallback) {
@@ -13,7 +14,7 @@ class Forge {
         const options = (typeof optionsFallback === 'object' ? optionsFallback : adapter ? {} : optionsOrHttpAdapter) ??
             {};
         const extensions = this.discoverExtensions(options?.extensions ?? []);
-        const root = this.createRootModule(appModule, extensions);
+        const root = await this.createRootModule(appModule, extensions, options);
         const instrument = this.createInstrument(extensions, options.instrument);
         let createOptions = {
             ...options,
@@ -46,7 +47,7 @@ class Forge {
     }
     async createApplicationContext(appModule, options) {
         const extensions = this.discoverExtensions(options?.extensions ?? []);
-        const root = this.createRootModule(appModule, extensions);
+        const root = this.createRootModule(appModule, extensions, options);
         const instrument = this.createInstrument(extensions, options.instrument);
         let createOptions = {
             ...options,
@@ -74,7 +75,7 @@ class Forge {
     }
     async createMicroservice(appModule, options) {
         const extensions = this.discoverExtensions(options?.extensions ?? []);
-        const root = this.createRootModule(appModule, extensions);
+        const root = this.createRootModule(appModule, extensions, options);
         const instrument = this.createInstrument(extensions, options.instrument);
         let createOptions = {
             ...options,
@@ -105,8 +106,7 @@ class Forge {
         for (const resolvable of resolvables) {
             const extension = this.resolveExtension(resolvable);
             if (extension !== null) {
-                const metadata = extension.getMetadata();
-                for (const nestedExtension of this.discoverExtensions(metadata.extensions)) {
+                for (const nestedExtension of this.discoverExtensions(extension.getNestedExtensions())) {
                     extensions.delete(nestedExtension.constructor);
                     extensions.set(nestedExtension.constructor, nestedExtension);
                 }
@@ -128,7 +128,7 @@ class Forge {
         }
         throw new Error(`Unsupported extension resolvable "${String(resolvable)}"`);
     }
-    createRootModule(appModule, extensions) {
+    async createRootModule(appModule, extensions, options) {
         const meta = {
             imports: [],
             controllers: [],
@@ -136,16 +136,16 @@ class Forge {
             exports: [],
         };
         for (const extension of extensions) {
-            const extensionMeta = extension.getMetadata();
-            meta.imports.push(...(extensionMeta.imports ?? []));
-            meta.controllers.push(...(extensionMeta.controllers ?? []));
-            meta.providers.push(...(extensionMeta.providers ?? []));
-            meta.exports.push(...(extensionMeta.exports ?? []));
+            const extensionMeta = await this._getExtensionMetadata(extension);
+            meta.imports.push(...extensionMeta.imports);
+            meta.controllers.push(...extensionMeta.controllers);
+            meta.providers.push(...extensionMeta.providers);
+            meta.exports.push(...extensionMeta.exports);
         }
         meta.imports.push(appModule);
         let ForgeRootModule = class ForgeRootModule {
             moduleRef;
-            [constants_1.FORGE_ROOT_MODULE] = true;
+            [constants_public_1.FORGE_ROOT_MODULE] = true;
             constructor(moduleRef) {
                 this.moduleRef = moduleRef;
             }
@@ -170,13 +170,33 @@ class Forge {
                         provide: constants_1.FORGE_TOKEN_ROOT_MODULE,
                         useClass: ForgeRootModule,
                     },
+                    {
+                        provide: constants_public_1.FORGE_APP_OPTIONS,
+                        useValue: options,
+                    },
                 ],
-                exports: [constants_1.FORGE_TOKEN_ROOT_MODULE],
+                exports: [constants_1.FORGE_TOKEN_ROOT_MODULE, constants_public_1.FORGE_APP_OPTIONS],
             })
         ], ForgeRootProviderModule);
         meta.imports.unshift(ForgeRootProviderModule);
         return ForgeRootModule;
     }
+    async _getExtensionMetadata(extension) {
+        const results = await Promise.all([
+            extension.getRootImports(),
+            extension.getRootProviders(),
+            extension.getRootExports(),
+            extension.getRootControllers(),
+            extension.getNestedExtensions(),
+        ]);
+        return {
+            imports: results[0],
+            providers: results[1],
+            exports: results[2],
+            controllers: results[3],
+            extensions: results[4],
+        };
+    }
     createInstrument(extensions, originalInstrument) {
         const hasOriginalInstrument = originalInstrument && originalInstrument.instanceDecorator;
         const instances = new Array();
@@ -240,19 +260,14 @@ class Forge {
         }
     }
     _isRootModule(instance) {
-        return typeof instance === 'object' && instance !== null && instance[constants_1.FORGE_ROOT_MODULE] === true;
+        return typeof instance === 'object' && instance !== null && instance[constants_public_1.FORGE_ROOT_MODULE] === true;
     }
     _isHttpAdapter(instance) {
         return typeof instance === 'object' && instance !== null && typeof instance['use'] === 'function';
     }
     _augmentBootHooks(createOptions, extensions) {
         createOptions[constants_1.FORGE_PATCH_BOOT_CALLBACK] = async (app) => {
-            try {
-                await Promise.all(extensions.map((e) => e.afterBoot(app)));
-            }
-            catch (error) {
-                console.error(error);
-            }
+            await Promise.all(extensions.map((e) => e.afterBoot(app)));
         };
     }
     _augmentNestApplication() {

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export * from './forge.factory';
 export * from './forge-options.interface';
 export * from './extensions';
 export * from './architecture';
+export * from './constants-public';

package/dist/index.js

@@ -5,3 +5,4 @@ tslib_1.__exportStar(require("./forge.factory"), exports);
 tslib_1.__exportStar(require("./forge-options.interface"), exports);
 tslib_1.__exportStar(require("./extensions"), exports);
 tslib_1.__exportStar(require("./architecture"), exports);
+tslib_1.__exportStar(require("./constants-public"), exports);

package/package.json

@@ -1,27 +1,29 @@
 {
 	"name": "@nest-forge/core",
 	"description": "",
-	"version": "0.0.3",
+	"version": "0.0.5",
 	"scripts": {
 		"build": "rimraf dist && tsc -p tsconfig.json",
 		"watch": "rimraf dist && tsc -w -p tsconfig.json",
-		"format": "prettier --write \"{src,apps,libs,test}/**/*.ts\"",
-		"lint": "eslint --ignore-pattern .gitignore \"{src,apps,libs,test}/**/*.ts\""
+		"format": "prettier --write \"{src,apps,libs,test}/**/*.ts\""
 	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
 	"directories": {
 		"lib": "src"
 	},
-	"main": "./dist/index.js",
-	"types": "./dist/index.d.ts",
+	"files": [
+		"dist",
+		"tsconfig.json"
+	],
 	"keywords": [],
 	"license": "UNLICENSED",
-	"homepage": "https://github.com/nest-forge",
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/nest-forge/core"
+		"url": "git+https://github.com/baileyherbert/nest-forge.git"
 	},
 	"bugs": {
-		"url": "https://github.com/nest-forge/core/issues"
+		"url": "https://github.com/baileyherbert/nest-forge/issues"
 	},
 	"author": "Bailey Herbert <hello@bailey.sh>",
 	"contributors": [],
@@ -29,17 +31,10 @@
 		"tslib": "^2.8.1"
 	},
 	"devDependencies": {
-		"@eslint/eslintrc": "^3.3.3",
-		"@eslint/js": "^9.39.2",
 		"@types/node": "~24.0.0",
-		"eslint": "^9.18.0",
-		"eslint-config-prettier": "^10.1.8",
-		"eslint-plugin-prettier": "^5.5.4",
-		"globals": "^16.0.0",
 		"prettier": "3.7.4",
 		"rimraf": "^6.1.2",
-		"typescript": "^5.9.0",
-		"typescript-eslint": "^8.51.0"
+		"typescript": "^5.9.0"
 	},
 	"peerDependencies": {
 		"@nestjs/common": "^10.2.0 || ^11.0.0",