@nest-forge/core 0.0.2 → 0.0.4

package/package.json

@@ -1,12 +1,11 @@
 {
 	"name": "@nest-forge/core",
 	"description": "",
-	"version": "0.0.2",
+	"version": "0.0.4",
 	"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\""
 	},
 	"directories": {
 		"lib": "src"
@@ -15,13 +14,12 @@
 	"types": "./dist/index.d.ts",
 	"keywords": [],
 	"license": "UNLICENSED",
-	"homepage": "https://github.com/nest-forge",
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/nest-forge/core"
+		"url": "https://github.com/baileyherbert/nest-forge"
 	},
 	"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,19 +27,10 @@
 		"tslib": "^2.8.1"
 	},
 	"devDependencies": {
-		"@eslint/eslintrc": "^3.3.3",
-		"@eslint/js": "^9.39.2",
-		"@types/node": "~25.0.0",
-		"eslint": "^9.18.0",
-		"eslint-config-prettier": "^10.1.8",
-		"eslint-plugin-import": "^2.32.0",
-		"eslint-plugin-prettier": "^5.5.4",
-		"globals": "^16.0.0",
+		"@types/node": "~24.0.0",
 		"prettier": "3.7.4",
-		"reflect-metadata": "^0.2.2",
 		"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",

package/tsconfig.json

@@ -17,7 +17,8 @@
 		"outDir": "./dist",
 		"forceConsistentCasingInFileNames": true,
 		"strictPropertyInitialization": false,
-		"stripInternal": true
+		"stripInternal": true,
+		"strict": true
 	},
 	"include": [
 		"src/**/*"

package/.prettierignore

@@ -1,3 +0,0 @@
-pnpm-lock.yaml
-package-lock.json
-yarn.lock

package/.prettierrc

@@ -1,7 +0,0 @@
-{
-	"parser": "typescript",
-	"useTabs": true,
-	"singleQuote": true,
-	"trailingComma": "es5",
-	"printWidth": 140
-}

package/dist/architecture/component.d.ts

@@ -1,7 +0,0 @@
-export declare abstract class ForgeBaseComponent {
-    protected onModuleInit(): any;
-    protected onApplicationBootstrap(): any;
-    protected onModuleDestroy(signal: string): any;
-    protected beforeApplicationShutdown(signal: string): any;
-    protected onApplicationShutdown(signal: string): any;
-}

package/dist/architecture/component.js

@@ -1,24 +0,0 @@
-"use strict";
-var _a;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ForgeBaseComponent = void 0;
-const tslib_1 = require("tslib");
-const common_1 = require("@nestjs/common");
-const constants_1 = require("../constants");
-const core_1 = require("@nestjs/core");
-class ForgeBaseComponent {
-    /**
-     * @internal
-     */
-    [_a = constants_1.FORGE_FIELD_MODULE_REF];
-    onModuleInit() { }
-    onApplicationBootstrap() { }
-    onModuleDestroy(signal) { }
-    beforeApplicationShutdown(signal) { }
-    onApplicationShutdown(signal) { }
-}
-exports.ForgeBaseComponent = ForgeBaseComponent;
-tslib_1.__decorate([
-    (0, common_1.Inject)(core_1.ModuleRef),
-    tslib_1.__metadata("design:type", core_1.ModuleRef)
-], ForgeBaseComponent.prototype, _a, void 0);

package/dist/architecture/controller.d.ts

@@ -1,3 +0,0 @@
-import { ForgeBaseComponent } from './component';
-export declare abstract class ForgeController extends ForgeBaseComponent {
-}

package/dist/architecture/controller.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ForgeController = void 0;
-const component_1 = require("./component");
-class ForgeController extends component_1.ForgeBaseComponent {
-}
-exports.ForgeController = ForgeController;

package/dist/architecture/index.d.ts

@@ -1,4 +0,0 @@
-export * from './component';
-export * from './module';
-export * from './controller';
-export * from './service';

package/dist/architecture/index.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./component"), exports);
-tslib_1.__exportStar(require("./module"), exports);
-tslib_1.__exportStar(require("./controller"), exports);
-tslib_1.__exportStar(require("./service"), exports);

package/dist/architecture/module.d.ts

@@ -1,5 +0,0 @@
-import { MiddlewareConsumer } from '@nestjs/common';
-import { ForgeBaseComponent } from './component';
-export declare abstract class ForgeModule extends ForgeBaseComponent {
-    configure(consumer: MiddlewareConsumer): any;
-}

package/dist/architecture/module.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ForgeModule = void 0;
-const component_1 = require("./component");
-class ForgeModule extends component_1.ForgeBaseComponent {
-    configure(consumer) { }
-}
-exports.ForgeModule = ForgeModule;

package/dist/architecture/service.d.ts

@@ -1,3 +0,0 @@
-import { ForgeBaseComponent } from './component';
-export declare abstract class ForgeService extends ForgeBaseComponent {
-}

package/dist/architecture/service.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ForgeService = void 0;
-const tslib_1 = require("tslib");
-const common_1 = require("@nestjs/common");
-const component_1 = require("./component");
-let ForgeService = class ForgeService extends component_1.ForgeBaseComponent {
-};
-exports.ForgeService = ForgeService;
-exports.ForgeService = ForgeService = tslib_1.__decorate([
-    (0, common_1.Injectable)()
-], ForgeService);

package/dist/constants.d.ts

@@ -1,3 +0,0 @@
-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;

package/dist/constants.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-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_FIELD_MODULE_REF = Symbol('FORGE_FIELD_MODULE_REF');
-exports.FORGE_TOKEN_ROOT_MODULE = Symbol('FORGE_TOKEN_ROOT_MODULE');

package/dist/extensions/extension.d.ts

@@ -1,56 +0,0 @@
-import { INestApplication, INestApplicationContext, INestMicroservice, MiddlewareConsumer, ModuleMetadata } from '@nestjs/common';
-import { ForgeController, ForgeModule, ForgeService } from '../architecture';
-export declare abstract class ForgeExtension {
-    /**
-     * The metdata for this extension.
-     */
-    private readonly _metadata;
-    /**
-     * Constructs a new forge extension instance.
-     */
-    constructor(options?: ForgeExtensionMetadata);
-    /**
-     * Configures a Nest application instance.
-     */
-    configureHttpApplication(application: INestApplication): any;
-    /**
-     * Configures a Nest application context. This is for a standalone application that has no web server.
-     */
-    configureStandaloneApplication(context: INestApplicationContext): any;
-    /**
-     * Configures a Nest microservice context.
-     */
-    configureMicroserviceApplication(context: INestMicroservice): any;
-    /**
-     * Configures the root module of the application.
-     */
-    configureRootModule(consumer: MiddlewareConsumer): any;
-    /**
-     * Instruments the application context. If a value is returned, the instance is replaced with that value, and no further extensions are
-     * queried.
-     */
-    instrument(instance: unknown): any;
-    /**
-     * Augments a `ForgeModule` instance.
-     */
-    augmentModule(instance: ForgeModule, moduleRef: any): any;
-    /**
-     * Augments a `ForgeController` instance.
-     */
-    augmentController(instance: ForgeController, moduleRef: any): any;
-    /**
-     * Augments a `ForgeService` instance.
-     */
-    augmentService(instance: ForgeService, moduleRef: any): any;
-    /**
-     * Returns the metadata for this extension.
-     */
-    getMetadata(): ForgeExtensionMetadata;
-}
-export interface ForgeExtensionMetadata extends ModuleMetadata {
-    /**
-     * An optional array of nested extensions to import.
-     */
-    extensions?: ForgeExtensionResolvable[];
-}
-export type ForgeExtensionResolvable = ForgeExtension | (new () => ForgeExtension) | null | undefined | false;

package/dist/extensions/extension.js

@@ -1,55 +0,0 @@
-"use strict";
-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 a Nest application instance.
-     */
-    configureHttpApplication(application) { }
-    /**
-     * Configures a Nest application context. This is for a standalone application that has no web server.
-     */
-    configureStandaloneApplication(context) { }
-    /**
-     * Configures a Nest microservice context.
-     */
-    configureMicroserviceApplication(context) { }
-    /**
-     * Configures the root module of the application.
-     */
-    configureRootModule(consumer) { }
-    /**
-     * Instruments the application context. If a value is returned, the instance is replaced with that value, and no further extensions are
-     * queried.
-     */
-    instrument(instance) { }
-    /**
-     * Augments a `ForgeModule` instance.
-     */
-    augmentModule(instance, moduleRef) { }
-    /**
-     * Augments a `ForgeController` instance.
-     */
-    augmentController(instance, moduleRef) { }
-    /**
-     * Augments a `ForgeService` instance.
-     */
-    augmentService(instance, moduleRef) { }
-    /**
-     * Returns the metadata for this extension.
-     */
-    getMetadata() {
-        return this._metadata;
-    }
-}
-exports.ForgeExtension = ForgeExtension;

package/dist/extensions/index.d.ts

@@ -1 +0,0 @@
-export * from './extension';

package/dist/extensions/index.js

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./extension"), exports);

package/dist/forge-options.interface.d.ts

@@ -1,13 +0,0 @@
-import { NestApplicationOptions } from '@nestjs/common';
-import { ForgeExtensionResolvable } from './extensions';
-import { NestApplicationContextOptions } from '@nestjs/common/interfaces/nest-application-context-options.interface';
-import { NestMicroserviceOptions } from '@nestjs/common/interfaces/microservices/nest-microservice-options.interface';
-export interface ForgeApplicationOptions extends NestApplicationOptions {
-    extensions?: ForgeExtensionResolvable | ForgeExtensionResolvable[];
-}
-export interface ForgeApplicationContextOptions extends NestApplicationContextOptions {
-    extensions?: ForgeExtensionResolvable | ForgeExtensionResolvable[];
-}
-export interface ForgeMicroserviceOptions extends NestMicroserviceOptions {
-    extensions?: ForgeExtensionResolvable | ForgeExtensionResolvable[];
-}

package/dist/forge-options.interface.js

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

package/dist/forge.factory.d.ts

@@ -1,37 +0,0 @@
-import { DynamicModule, ForwardReference, MiddlewareConsumer, Type } from '@nestjs/common';
-import { ForgeApplicationContextOptions, ForgeApplicationOptions, ForgeMicroserviceOptions } from './forge-options.interface';
-import { ForgeExtension, ForgeExtensionResolvable } from './extensions';
-import { ModuleRef } from '@nestjs/core';
-import { FORGE_ROOT_MODULE } from './constants';
-import { ForgeBaseComponent, ForgeController, ForgeModule, ForgeService } from './architecture';
-declare class Forge {
-    private _augmented;
-    create(appModule: IEntryNestModule, options?: ForgeApplicationOptions): Promise<import("@nestjs/common").INestApplication<any>>;
-    createApplicationContext(appModule: IEntryNestModule, options: ForgeApplicationContextOptions): Promise<import("@nestjs/common").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;
-    protected createRootModule(appModule: IEntryNestModule, extensions: ForgeExtension[]): {
-        new (moduleRef: ModuleRef): {
-            readonly moduleRef: ModuleRef;
-            configure(consumer: MiddlewareConsumer): void;
-            readonly [FORGE_ROOT_MODULE]: true;
-        };
-    };
-    protected createInstrument(extensions: ForgeExtension[], originalInstrument?: Instrument): InstrumentResponse;
-    protected augmentComponents(instances: ForgeBaseComponent[], extensions: ForgeExtension[]): void;
-    protected augmentModule(instance: ForgeModule, extensions: ForgeExtension[]): void;
-    protected augmentController(instance: ForgeController, extensions: ForgeExtension[]): void;
-    protected augmentService(instance: ForgeService, extensions: ForgeExtension[]): void;
-    protected _isRootModule(instance: unknown): instance is IForgeRootModule;
-}
-type IEntryNestModule = Type<any> | DynamicModule | ForwardReference | Promise<IEntryNestModule>;
-type Instrument = {
-    instanceDecorator: (instance: unknown) => unknown;
-};
-interface InstrumentResponse {
-    instances: ForgeBaseComponent[];
-    instanceDecorator: (instance: unknown) => any;
-}
-declare const forge: Forge;
-export { forge as Forge };

package/dist/forge.factory.js

@@ -1,200 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Forge = void 0;
-const tslib_1 = require("tslib");
-const common_1 = require("@nestjs/common");
-const core_1 = require("@nestjs/core");
-const constants_1 = require("./constants");
-const architecture_1 = require("./architecture");
-class Forge {
-    _augmented = new Set();
-    async create(appModule, options) {
-        const extensions = this.discoverExtensions(options?.extensions ?? []);
-        const root = this.createRootModule(appModule, extensions);
-        const instrument = this.createInstrument(extensions, options.instrument);
-        const app = await core_1.NestFactory.create(root, {
-            ...options,
-            instrument: {
-                instanceDecorator: instrument.instanceDecorator,
-            },
-        });
-        this.augmentComponents(instrument.instances, extensions);
-        for (const extension of extensions) {
-            extension.configureHttpApplication(app);
-        }
-        return app;
-    }
-    async createApplicationContext(appModule, options) {
-        const extensions = this.discoverExtensions(options?.extensions ?? []);
-        const root = this.createRootModule(appModule, extensions);
-        const instrument = this.createInstrument(extensions, options.instrument);
-        const app = await core_1.NestFactory.createApplicationContext(root, {
-            ...options,
-            instrument: {
-                instanceDecorator: instrument.instanceDecorator,
-            },
-        });
-        this.augmentComponents(instrument.instances, extensions);
-        for (const extension of extensions) {
-            extension.configureStandaloneApplication(app);
-        }
-        return app;
-    }
-    async createMicroservice(appModule, options) {
-        const extensions = this.discoverExtensions(options?.extensions ?? []);
-        const root = this.createRootModule(appModule, extensions);
-        const instrument = this.createInstrument(extensions, options.instrument);
-        const app = await core_1.NestFactory.createMicroservice(root, {
-            ...options,
-            instrument: {
-                instanceDecorator: instrument.instanceDecorator,
-            },
-        });
-        this.augmentComponents(instrument.instances, extensions);
-        for (const extension of extensions) {
-            extension.configureMicroserviceApplication(app);
-        }
-        return app;
-    }
-    discoverExtensions(resolvables) {
-        const extensions = new Map();
-        if (!Array.isArray(resolvables)) {
-            resolvables = [resolvables];
-        }
-        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)) {
-                    extensions.delete(nestedExtension.constructor);
-                    extensions.set(nestedExtension.constructor, nestedExtension);
-                }
-                extensions.delete(extension.constructor);
-                extensions.set(extension.constructor, extension);
-            }
-        }
-        return Array.from(extensions.values());
-    }
-    resolveExtension(resolvable) {
-        if (resolvable === false || resolvable === null || resolvable === undefined) {
-            return null;
-        }
-        if (typeof resolvable === 'object') {
-            return resolvable;
-        }
-        if (typeof resolvable === 'function') {
-            return new resolvable();
-        }
-        throw new Error(`Unsupported extension resolvable "${String(resolvable)}"`);
-    }
-    createRootModule(appModule, extensions) {
-        const meta = {
-            imports: [],
-            controllers: [],
-            providers: [],
-            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 ?? []));
-        }
-        meta.imports.push(appModule);
-        let ForgeRootModule = class ForgeRootModule {
-            moduleRef;
-            [constants_1.FORGE_ROOT_MODULE] = true;
-            constructor(moduleRef) {
-                this.moduleRef = moduleRef;
-            }
-            configure(consumer) {
-                for (const extension of extensions) {
-                    extension.configureRootModule(consumer);
-                }
-            }
-        };
-        ForgeRootModule = tslib_1.__decorate([
-            (0, common_1.Module)(meta),
-            (0, common_1.Global)(),
-            tslib_1.__metadata("design:paramtypes", [core_1.ModuleRef])
-        ], ForgeRootModule);
-        let ForgeRootProviderModule = class ForgeRootProviderModule {
-        };
-        ForgeRootProviderModule = tslib_1.__decorate([
-            (0, common_1.Global)(),
-            (0, common_1.Module)({
-                providers: [
-                    {
-                        provide: constants_1.FORGE_TOKEN_ROOT_MODULE,
-                        useClass: ForgeRootModule,
-                    },
-                ],
-                exports: [constants_1.FORGE_TOKEN_ROOT_MODULE],
-            })
-        ], ForgeRootProviderModule);
-        meta.imports.unshift(ForgeRootProviderModule);
-        return ForgeRootModule;
-    }
-    createInstrument(extensions, originalInstrument) {
-        const hasOriginalInstrument = originalInstrument && originalInstrument.instanceDecorator;
-        const instances = new Array();
-        return {
-            instances,
-            instanceDecorator: (instance) => {
-                if (this._isRootModule(instance)) {
-                    // TODO
-                }
-                if (instance instanceof architecture_1.ForgeBaseComponent) {
-                    instances.push(instance);
-                }
-                for (const extension of extensions) {
-                    const response = extension.instrument(instance);
-                    if (response !== undefined) {
-                        return response;
-                    }
-                }
-                if (hasOriginalInstrument) {
-                    return originalInstrument.instanceDecorator(instance);
-                }
-                return instance;
-            },
-        };
-    }
-    augmentComponents(instances, extensions) {
-        for (const instance of instances) {
-            if (!this._augmented.has(instance)) {
-                if (instance instanceof architecture_1.ForgeModule) {
-                    this.augmentModule(instance, extensions);
-                }
-                else if (instance instanceof architecture_1.ForgeController) {
-                    this.augmentController(instance, extensions);
-                }
-                else if (instance instanceof architecture_1.ForgeService) {
-                    this.augmentService(instance, extensions);
-                }
-                this._augmented.add(instance);
-            }
-        }
-    }
-    augmentModule(instance, extensions) {
-        for (const extension of extensions) {
-            extension.augmentModule(instance, instance[constants_1.FORGE_FIELD_MODULE_REF]);
-        }
-    }
-    augmentController(instance, extensions) {
-        for (const extension of extensions) {
-            extension.augmentController(instance, instance[constants_1.FORGE_FIELD_MODULE_REF]);
-        }
-    }
-    augmentService(instance, extensions) {
-        for (const extension of extensions) {
-            extension.augmentService(instance, instance[constants_1.FORGE_FIELD_MODULE_REF]);
-        }
-    }
-    _isRootModule(instance) {
-        return typeof instance === 'object' && instance !== null && instance[constants_1.FORGE_ROOT_MODULE] === true;
-    }
-}
-const forge = new Forge();
-exports.Forge = forge;

package/dist/index.d.ts

@@ -1,4 +0,0 @@
-export * from './forge.factory';
-export * from './forge-options.interface';
-export * from './extensions';
-export * from './architecture';

package/dist/index.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-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);

package/eslint.config.mjs

@@ -1,31 +0,0 @@
-import eslint from '@eslint/js';
-import { defineConfig } from 'eslint/config';
-import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
-import tseslint from 'typescript-eslint';
-import globals from 'globals';
-
-export default defineConfig(
-	{
-		ignores: ['node_modules', '**/node_modules/**', '**/*.js', '**/*.d.ts']
-	},
-	eslint.configs.recommended,
-	...tseslint.configs.recommendedTypeChecked,
-	eslintPluginPrettierRecommended,
-	{
-		languageOptions: {
-			globals: {
-				...globals.node,
-				...globals.jest
-			},
-			ecmaVersion: 2024,
-			sourceType: 'module',
-			parserOptions: {
-				projectService: true,
-				tsconfigRootDir: import.meta.dirname
-			}
-		}
-	},
-	{
-		rules: {}
-	}
-);