@h3ravel/core 1.7.4 → 1.8.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/Container.ts","../src/Registerer.ts","../src/Application.ts","../src/Contracts/ServiceProviderConstructor.ts","../src/Controller.ts","../src/Di/Inject.ts","../src/Exceptions/Handler.ts","../src/Http/Kernel.ts","../src/ServiceProvider.ts","../src/Providers/CoreServiceProvider.ts","../src/Providers/ViewServiceProvider.ts","../src/index.ts"],"sourcesContent":["import type { Bindings, IContainer, UseKey } from '@h3ravel/shared'\n\ntype IBinding = UseKey | (new (..._args: any[]) => unknown)\n\nexport class Container implements IContainer {\n    private bindings = new Map<IBinding, () => unknown>()\n    private singletons = new Map<IBinding, unknown>()\n\n    /**\n     * Check if the target has any decorators\n     * \n     * @param target \n     * @returns \n     */\n    static hasAnyDecorator (target: Function): boolean {\n        if (Reflect.getMetadataKeys(target).length > 0) return true\n\n        const paramLength = target.length\n\n        for (let i = 0; i < paramLength; i++) {\n            if (Reflect.getMetadataKeys(target, `__param_${i}`).length > 0) {\n                return true\n            }\n        }\n\n        return false\n    }\n\n    /**\n     * Bind a transient service to the container\n     */\n    bind<T> (key: new (...args: any[]) => T, factory: () => T): void\n    bind<T extends UseKey> (key: T, factory: () => Bindings[T]): void\n    bind<T extends UseKey> (\n        key: T,\n        factory: () => Bindings[T] | T\n    ) {\n        this.bindings.set(key, factory)\n    }\n\n    /**\n     * Bind a singleton service to the container\n     */\n    singleton<T extends UseKey> (\n        key: T | (new (..._args: any[]) => Bindings[T]),\n        factory: () => Bindings[T]\n    ) {\n        this.bindings.set(key, () => {\n            if (!this.singletons.has(key)) {\n                this.singletons.set(key, factory())\n            }\n            return this.singletons.get(key)!\n        })\n    }\n\n    /**\n     * Resolve a service from the container\n     */\n    make<T extends UseKey, X = undefined> (\n        key: T | (new (..._args: any[]) => Bindings[T])\n    ): X extends undefined ? Bindings[T] : X {\n        /**\n         * Direct factory binding\n         */\n        if (this.bindings.has(key)) {\n            return this.bindings.get(key)!() as Bindings[T]\n        }\n\n        /**\n         * If this is a class constructor, auto-resolve via reflection\n         */\n        if (typeof key === 'function') {\n            return this.build(key)\n        }\n\n        throw new Error(\n            `No binding found for key: ${typeof key === 'string' ? key : (key as any)?.name}`\n        )\n    }\n\n    /**\n     * Automatically build a class with constructor dependency injection\n     */\n    private build<T extends UseKey> (ClassType: new (..._args: any[]) => Bindings[T]): Bindings[T] {\n        let dependencies: any[] = [];\n\n        if (Array.isArray((ClassType as any).__inject__)) {\n            dependencies = (ClassType as any).__inject__.map((alias: any) => {\n                return this.make(alias)\n            });\n        } else {\n            const paramTypes: any[] = Reflect.getMetadata('design:paramtypes', ClassType) || []\n            dependencies = paramTypes.map((dep) => this.make(dep))\n        }\n\n        return new ClassType(...dependencies);\n    }\n\n    /**\n     * Check if a service is registered\n     */\n    has (key: UseKey): boolean {\n        return this.bindings.has(key)\n    }\n}\n","import { dd, dump } from '@h3ravel/support'\n\nexport class Registerer {\n    static register () {\n        globalThis.dd = dd\n        globalThis.dump = dump\n    }\n}\n","import { IApplication, IPathName, IServiceProvider } from '@h3ravel/shared'\n\nimport { Container } from './Container'\nimport { PathLoader } from '@h3ravel/shared'\nimport { Registerer } from './Registerer'\nimport dotenv from 'dotenv'\nimport path from 'node:path'\n\nexport class Application extends Container implements IApplication {\n    paths = new PathLoader()\n    private booted = false\n    private versions = { app: '0', ts: '0' }\n    private basePath: string\n\n    private providers: IServiceProvider[] = []\n    protected externalProviders: Array<new (_app: Application) => IServiceProvider> = []\n\n    constructor(basePath: string) {\n        super()\n        this.basePath = basePath\n        this.setPath('base', basePath)\n        this.loadOptions()\n        this.registerBaseBindings();\n        Registerer.register()\n        dotenv.config({ quiet: true })\n    }\n\n    /**\n     * Register core bindings into the container\n     */\n    protected registerBaseBindings () {\n        this.bind(Application, () => this)\n        this.bind('path.base', () => this.basePath)\n        this.bind('load.paths', () => this.paths)\n    }\n\n    /**\n     * Dynamically register all configured providers\n     */\n    public async registerConfiguredProviders () {\n        const providers = await this.getAllProviders()\n\n        for (const ProviderClass of providers) {\n            if (!ProviderClass) continue\n            const provider = new ProviderClass(this)\n            await this.register(provider)\n        }\n    }\n\n    protected async loadOptions () {\n        const app = await this.safeImport(this.getPath('base', 'package.json'))\n        const core = await this.safeImport('../package.json')\n\n        if (app && app.dependencies) {\n            this.versions.app = app.dependencies['@h3ravel/core']\n        }\n        if (core && core.devDependencies) {\n            this.versions.ts = app.devDependencies.typescript\n        }\n    }\n\n    /**\n     * Load default and optional providers dynamically\n     * \n     * Auto-Registration Behavior\n     * \n     * Minimal App: Loads only core, config, http, router by default.\n     * Full-Stack App: Installs database, mail, queue, cache → they self-register via their providers.\n     */\n    protected async getConfiguredProviders (): Promise<Array<new (_app: Application) => IServiceProvider>> {\n        return [\n            (await import('@h3ravel/core')).CoreServiceProvider,\n            (await import('@h3ravel/core')).ViewServiceProvider,\n        ]\n    }\n\n    protected async getAllProviders (): Promise<Array<new (_app: Application) => IServiceProvider>> {\n        const coreProviders = await this.getConfiguredProviders();\n        const allProviders = [...coreProviders, ...this.externalProviders];\n\n        /**\n         * Deduplicate by class reference\n         */\n        const uniqueProviders = Array.from(new Set(allProviders));\n\n        return this.sortProviders(uniqueProviders);\n    }\n\n    private sortProviders (providers: Array<new (_app: Application) => IServiceProvider>) {\n        const priorityMap = new Map<string, number>();\n\n        /**\n         * Base priority (default 0)\n         */\n        providers.forEach((Provider) => {\n            priorityMap.set(Provider.name, (Provider as any).priority ?? 0);\n        });\n\n        /**\n         * Handle before/after adjustments\n         */\n        providers.forEach((Provider) => {\n            const order = (Provider as any).order;\n            if (!order) return;\n\n            const [direction, target] = order.split(':');\n            const targetPriority = priorityMap.get(target) ?? 0;\n\n            if (direction === 'before') {\n                priorityMap.set(Provider.name, targetPriority - 1);\n            } else if (direction === 'after') {\n                priorityMap.set(Provider.name, targetPriority + 1);\n            }\n        });\n\n        /**\n         * Sort the service providers based on thier name and priority\n         */\n        const sorted = providers.sort(\n            (A, B) => (priorityMap.get(B.name) ?? 0) - (priorityMap.get(A.name) ?? 0)\n        );\n\n        /**\n         * If debug is enabled, let's show the loaded service provider info\n         */\n        if (process.env.APP_DEBUG === 'true') {\n            console.table(\n                sorted.map((P) => ({\n                    Provider: P.name,\n                    Priority: priorityMap.get(P.name),\n                    Order: (P as any).order || 'N/A',\n                }))\n            );\n        }\n\n        return sorted\n    }\n\n    registerProviders (providers: Array<new (_app: Application) => IServiceProvider>): void {\n        this.externalProviders.push(...providers)\n    }\n\n    /**\n     * Register a provider\n     */\n    public async register (provider: IServiceProvider) {\n        await provider.register()\n        this.providers.push(provider)\n    }\n\n    /**\n     * Boot all providers after registration\n     */\n    public async boot () {\n        if (this.booted) return\n\n        for (const provider of this.providers) {\n            if (provider.boot) {\n                await provider.boot()\n            }\n        }\n\n        this.booted = true\n    }\n\n    /**\n     * Attempt to dynamically import an optional module\n     */\n    private async safeImport (moduleName: string) {\n        try {\n            const mod = await import(moduleName)\n            return mod.default ?? mod ?? {}\n        } catch {\n            return null\n        }\n    }\n\n    /**\n     * Get the base path of the app\n     * \n     * @returns \n     */\n    getBasePath (): string {\n        return this.basePath\n    }\n\n    /**\n     * Dynamically retrieves a path property from the class.\n     * Any property ending with \"Path\" is accessible automatically.\n     *\n     * @param name - The base name of the path property\n     * @returns \n     */\n    getPath (name: IPathName, pth?: string) {\n        return path.join(this.paths.getPath(name, this.basePath), pth ?? '')\n    }\n\n    /**\n     * Programatically set the paths.\n     *\n     * @param name - The base name of the path property\n     * @param path - The new path\n     * @returns \n     */\n    setPath (name: IPathName, path: string) {\n        return this.paths.setPath(name, path, this.basePath)\n    }\n\n    /**\n     * Returns the installed version of the system core and typescript.\n     *\n     * @returns \n     */\n    getVersion (key: 'app' | 'ts') {\n        return this.versions[key]?.replaceAll(/\\^|~/g, '')\n    }\n}\n","/// <reference path=\"../globals.d.ts\" />\n\nimport { Application, ServiceProvider } from \"..\";\n\nimport { IServiceProvider } from \"@h3ravel/shared\";\n\nexport type ServiceProviderConstructor = (new (app: Application) => ServiceProvider) & IServiceProvider;\n","import { Application } from '.'\nimport { IController } from '@h3ravel/shared'\n\n/**\n * Base controller class\n */\nexport abstract class Controller implements IController {\n    protected app: Application\n\n    constructor(app: Application) {\n        this.app = app\n    }\n\n    public show (..._ctx: any[]): any { return }\n    public index (..._ctx: any[]): any { return }\n    public store (..._ctx: any[]): any { return }\n    public update (..._ctx: any[]): any { return }\n    public destroy (..._ctx: any[]): any { return }\n}\n","export function Inject (...dependencies: string[]) {\n    return function (target: any) {\n        target.__inject__ = dependencies;\n    };\n}\n\n/**\n * Allows binding dependencies to both class and class methods \n * \n * @returns \n */\nexport function Injectable (): ClassDecorator & MethodDecorator {\n    return (...args: any[]) => {\n        if (args.length === 1) {\n            void args[0]; // class target\n        }\n        if (args.length === 3) {\n            void args[0]; // target\n            void args[1]; // propertyKey\n            void args[2]; // descriptor\n        }\n    };\n}\n","export default class { }\n","import { HttpContext, IMiddleware } from '@h3ravel/shared'\n\nimport type { H3Event } from 'h3'\n\n/**\n * Kernel class handles middleware execution and response transformations.\n * It acts as the core middleware pipeline for HTTP requests.\n */\nexport class Kernel {\n    /**\n     * @param context - A factory function that converts an H3Event into an HttpContext.\n     * @param middleware - An array of middleware classes that will be executed in sequence.\n     */\n    constructor(\n        protected context: (event: H3Event) => HttpContext,\n        protected middleware: IMiddleware[] = [],\n    ) { }\n\n    /**\n     * Handles an incoming request and passes it through middleware before invoking the next handler.\n     * \n     * @param event - The raw H3 event object.\n     * @param next - A callback function that represents the next layer (usually the controller or final handler).\n     * @returns A promise resolving to the result of the request pipeline.\n     */\n    async handle (\n        event: H3Event,\n        next: (ctx: HttpContext) => Promise<unknown>\n    ): Promise<unknown> {\n        /**\n         * Convert the raw event into a standardized HttpContext\n         */\n        const ctx = this.context(event)\n        const { app } = ctx.request\n\n        /**\n         * Dynamically bind the view renderer to the service container.\n         * This allows any part of the request lifecycle to render templates using Edge.\n         */\n        app.bind('view', () => async (template: string, params?: Record<string, any>) => {\n            const edge = app.make('edge')\n            return ctx.response.html(await edge.render(template, params))\n        })\n\n        /**\n         * Run middleware stack and obtain result\n         */\n        const result = await this.runMiddleware(ctx, () => next(ctx))\n\n        /**\n         * If a plain object is returned from a controller or middleware,\n         * automatically set the JSON Content-Type header for the response.\n         */\n        if (result !== undefined && this.isPlainObject(result)) {\n            event.res.headers.set('Content-Type', 'application/json; charset=UTF-8')\n        }\n\n        return result\n    }\n\n    /**\n     * Sequentially runs middleware in the order they were registered.\n     * \n     * @param context - The standardized HttpContext.\n     * @param next - Callback to execute when middleware completes.\n     * @returns A promise resolving to the final handler's result.\n     */\n    private async runMiddleware (\n        context: HttpContext,\n        next: (ctx: HttpContext) => Promise<unknown>\n    ) {\n        let index = -1\n\n        const runner = async (i: number): Promise<unknown> => {\n            if (i <= index) throw new Error('next() called multiple times')\n            index = i\n            const middleware = this.middleware[i]\n\n            if (middleware) {\n                /**\n                 * Execute the current middleware and proceed to the next one\n                 */\n                return middleware.handle(context, () => runner(i + 1))\n            } else {\n                /**\n                 * If no more middleware, call the final handler\n                 */\n                return next(context)\n            }\n        }\n\n        return runner(0)\n    }\n\n    /**\n     * Utility function to determine if a value is a plain object or array.\n     * \n     * @param value - The value to check.\n     * @returns True if the value is a plain object or array, otherwise false.\n     */\n    private isPlainObject (value: unknown): value is Record<string, unknown> {\n        return typeof value === 'object' &&\n            value !== null &&\n            (value.constructor === Object || value.constructor === Array)\n    }\n}\n","import { Application } from './Application'\nimport { IServiceProvider } from '@h3ravel/shared'\n\nexport abstract class ServiceProvider implements IServiceProvider {\n    public static order?: `before:${string}` | `after:${string}` | string | undefined;\n    public static priority = 0;\n    protected app: Application\n\n    constructor(app: Application) {\n        this.app = app\n    }\n\n    /**\n     * Register bindings to the container.\n     * Runs before boot().\n     */\n    abstract register (): void | Promise<void>\n\n    /**\n     * Perform post-registration booting of services.\n     * Runs after all providers have been registered.\n     */\n    boot?(): void | Promise<void>\n}\n","import 'reflect-metadata'\n\nimport { ServiceProvider } from '../ServiceProvider'\n\n/**\n * Bootstraps core services and bindings.\n * \n * Bind essential services to the container (logger, config repository).\n * Register app-level singletons.\n * Set up exception handling.\n * \n * Auto-Registered\n */\nexport class CoreServiceProvider extends ServiceProvider {\n    public static priority = 999;\n\n    register () {\n    }\n}\n","import { Edge } from 'edge.js'\nimport { ServiceProvider } from '../ServiceProvider'\n\nexport class ViewServiceProvider extends ServiceProvider {\n    public static priority = 995;\n\n    register (): void {\n        const config = this.app.make('config')\n        const edge = Edge.create({\n            cache: process.env.NODE_ENV === 'production'\n        })\n\n        edge.mount(this.app.getPath('views'))\n\n        edge.global('asset', this.app.make('asset'))\n        edge.global('config', config.get)\n        edge.global('app', this.app)\n\n        this.app.bind('edge', () => edge)\n    }\n}\n","export * from './Application'\nexport * from './Container'\nexport * from './Contracts/ServiceProviderConstructor'\nexport * from './Controller'\nexport * from './Di/Inject'\nexport * from './Exceptions/Handler'\nexport * from './Http/Kernel'\nexport * from './Providers/CoreServiceProvider'\nexport * from './Providers/ViewServiceProvider'\nexport * from './Registerer'\nexport * from './ServiceProvider'\n"],"mappings":"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","names":["Container","bindings","Map","singletons","hasAnyDecorator","target","Reflect","getMetadataKeys","length","paramLength","i","bind","key","factory","set","singleton","has","get","make","build","Error","name","ClassType","dependencies","Array","isArray","__inject__","map","alias","paramTypes","getMetadata","dep","Registerer","register","globalThis","dd","dump","Application","Container","paths","PathLoader","booted","versions","app","ts","basePath","providers","externalProviders","setPath","loadOptions","registerBaseBindings","Registerer","register","dotenv","config","quiet","bind","registerConfiguredProviders","getAllProviders","ProviderClass","provider","safeImport","getPath","core","dependencies","devDependencies","typescript","getConfiguredProviders","CoreServiceProvider","ViewServiceProvider","coreProviders","allProviders","uniqueProviders","Array","from","Set","sortProviders","priorityMap","Map","forEach","Provider","set","name","priority","order","direction","target","split","targetPriority","get","sorted","sort","A","B","process","env","APP_DEBUG","console","table","map","P","Priority","Order","registerProviders","push","boot","moduleName","mod","default","getBasePath","pth","path","join","getVersion","key","replaceAll","Controller","app","show","_ctx","index","store","update","destroy","Inject","dependencies","target","__inject__","Injectable","args","length","Kernel","context","middleware","handle","event","next","ctx","app","request","bind","template","params","edge","make","response","html","render","result","runMiddleware","undefined","isPlainObject","res","headers","set","index","runner","i","Error","value","Object","Array","ServiceProvider","order","priority","app","CoreServiceProvider","ServiceProvider","priority","register","ViewServiceProvider","ServiceProvider","priority","register","config","app","make","edge","Edge","create","cache","process","env","NODE_ENV","mount","getPath","global","get","bind"]}
+{"version":3,"file":"index.cjs","names":["dependencies: any[]","app: Application","params: any[]","args: any[]","app: Application","dd","dump","path","nodepath","PathLoader","port: number","tries: number","hostname: string","e: any","path","context: (event: H3Event) => HttpContext","middleware: IMiddleware[]","Edge"],"sources":["../src/Container.ts","../src/Di/ContainerResolver.ts","../src/Registerer.ts","../src/Application.ts","../src/Controller.ts","../src/Di/Inject.ts","../src/Http/Kernel.ts","../src/ServiceProvider.ts","../src/Providers/CoreServiceProvider.ts","../src/Providers/ViewServiceProvider.ts"],"sourcesContent":["import type { Bindings, IContainer, UseKey } from '@h3ravel/shared'\n\ntype IBinding = UseKey | (new (..._args: any[]) => unknown)\n\nexport class Container implements IContainer {\n    private bindings = new Map<IBinding, () => unknown>()\n    private singletons = new Map<IBinding, unknown>()\n\n    /**\n     * Check if the target has any decorators\n     * \n     * @param target \n     * @returns \n     */\n    static hasAnyDecorator (target: Function): boolean {\n        if (Reflect.getMetadataKeys(target).length > 0) return true\n\n        const paramLength = target.length\n\n        for (let i = 0; i < paramLength; i++) {\n            if (Reflect.getMetadataKeys(target, `__param_${i}`).length > 0) {\n                return true\n            }\n        }\n\n        return false\n    }\n\n    /**\n     * Bind a transient service to the container\n     */\n    bind<T> (key: new (...args: any[]) => T, factory: () => T): void\n    bind<T extends UseKey> (key: T, factory: () => Bindings[T]): void\n    bind<T extends UseKey> (\n        key: T,\n        factory: () => Bindings[T] | T\n    ) {\n        this.bindings.set(key, factory)\n    }\n\n    /**\n     * Bind a singleton service to the container\n     */\n    singleton<T extends UseKey> (\n        key: T | (new (..._args: any[]) => Bindings[T]),\n        factory: () => Bindings[T]\n    ) {\n        this.bindings.set(key, () => {\n            if (!this.singletons.has(key)) {\n                this.singletons.set(key, factory())\n            }\n            return this.singletons.get(key)!\n        })\n    }\n\n    /**\n     * Resolve a service from the container\n     */\n    make<T extends UseKey, X = undefined> (\n        key: T | (new (..._args: any[]) => Bindings[T])\n    ): X extends undefined ? Bindings[T] : X {\n        /**\n         * Direct factory binding\n         */\n        if (this.bindings.has(key)) {\n            return this.bindings.get(key)!() as Bindings[T]\n        }\n\n        /**\n         * If this is a class constructor, auto-resolve via reflection\n         */\n        if (typeof key === 'function') {\n            return this.build(key)\n        }\n\n        throw new Error(\n            `No binding found for key: ${typeof key === 'string' ? key : (key as any)?.name}`\n        )\n    }\n\n    /**\n     * Automatically build a class with constructor dependency injection\n     */\n    private build<T extends UseKey> (ClassType: new (..._args: any[]) => Bindings[T]): Bindings[T] {\n        let dependencies: any[] = [];\n\n        if (Array.isArray((ClassType as any).__inject__)) {\n            dependencies = (ClassType as any).__inject__.map((alias: any) => {\n                return this.make(alias)\n            });\n        } else {\n            const paramTypes: any[] = Reflect.getMetadata('design:paramtypes', ClassType) || []\n            dependencies = paramTypes.map((dep) => this.make(dep))\n        }\n\n        return new ClassType(...dependencies);\n    }\n\n    /**\n     * Check if a service is registered\n     */\n    has (key: UseKey): boolean {\n        return this.bindings.has(key)\n    }\n}\n","import 'reflect-metadata';\n\nimport { Application } from '..';\n\nexport class ContainerResolver {\n    constructor(private app: Application) { }\n\n    async resolveMethodParams<I extends Record<string, any>> (instance: I, method: keyof I, _default?: any) {\n        /**\n         * Get param types for instance method\n         */\n        let params: any[] = Reflect.getMetadata('design:paramtypes', instance, String(method)) || [];\n\n        /**\n         * Ensure that the Application class is always available\n         */\n        if (params.length < 1 && _default) {\n            params = [_default]\n        }\n\n        /**\n         * Resolve the bound dependencies\n         */\n        let args: any[] = params.filter(e => ContainerResolver.isClass(e)).map((type: any) => {\n            return this.app.make(type)\n        });\n\n        return new Promise<I>((resolve) => {\n            resolve(instance[method](...args))\n        })\n    }\n\n    static isClass (C: any) {\n        return typeof C === \"function\" &&\n            C.prototype !== undefined &&\n            Object.toString.call(C).substring(0, 5) === 'class'\n    }\n}\n","import { dd, dump } from '@h3ravel/support'\n\nimport { Application } from '.'\nimport nodepath from 'node:path'\n\nexport class Registerer {\n    constructor(private app: Application) { }\n\n    static register (app: Application) {\n        const reg = new Registerer(app)\n        reg.bootRegister()\n    }\n\n    bootRegister () {\n        globalThis.dd = dd\n        globalThis.dump = dump\n        globalThis.app_path = (path?: string) => this.appPath(path)\n        globalThis.base_path = (path?: string) => this.basePath(path)\n        globalThis.public_path = (path?: string) => this.publicPath(path)\n        globalThis.storage_path = (path?: string) => this.storagePath(path)\n        globalThis.database_path = (path?: string) => this.databasePath(path)\n    }\n\n    private appPath (path?: string) {\n        return this.app.getPath(\n            'base', nodepath.join(`/${process.env.SRC_PATH ?? 'src'}/`.replace(/([^:]\\/)\\/+/g, \"$1\"), 'app', path ?? '')\n        )\n    }\n\n    private basePath (path?: string) {\n        return this.app.getPath('base', path)\n    }\n\n    private publicPath (path?: string) {\n        return this.app.getPath('public', path)\n    }\n\n    private storagePath (path?: string) {\n        return this.app.getPath('base', nodepath.join('storage', path ?? ''))\n    }\n\n    private databasePath (path?: string) {\n        return this.app.getPath('database', path)\n    }\n}\n","import 'reflect-metadata';\n\nimport { IApplication, IPathName, IServiceProvider, Logger } from '@h3ravel/shared'\n\nimport { Container } from './Container'\nimport { ContainerResolver } from './Di/ContainerResolver';\nimport type { H3 } from 'h3'\nimport { PathLoader } from '@h3ravel/shared'\nimport { Registerer } from './Registerer'\nimport chalk from 'chalk';\nimport { detect } from 'detect-port';\nimport dotenv from 'dotenv'\nimport dotenvExpand from 'dotenv-expand'\nimport path from 'node:path'\n\ntype AServiceProvider = (new (_app: Application) => IServiceProvider) & IServiceProvider\n\nexport class Application extends Container implements IApplication {\n    public paths = new PathLoader()\n    private tries: number = 0\n    private booted = false\n    private versions = { app: '0', ts: '0' }\n    private basePath: string\n\n    private providers: IServiceProvider[] = []\n    protected externalProviders: Array<new (_app: Application) => IServiceProvider> = []\n\n    /**\n     * List of registered console commands\n     */\n    public registeredCommands: (new (app: any, kernel: any) => any)[] = [];\n\n    constructor(basePath: string) {\n        super()\n\n        dotenvExpand.expand(dotenv.config({ quiet: true }))\n\n        this.basePath = basePath\n        this.setPath('base', basePath)\n        this.loadOptions()\n        this.registerBaseBindings();\n        Registerer.register(this)\n    }\n\n    /**\n     * Register core bindings into the container\n     */\n    protected registerBaseBindings () {\n        this.bind(Application, () => this)\n        this.bind('path.base', () => this.basePath)\n        this.bind('load.paths', () => this.paths)\n    }\n\n    /**\n     * Dynamically register all configured providers\n     */\n    public async registerConfiguredProviders () {\n        const providers = await this.getAllProviders()\n\n        for (const ProviderClass of providers) {\n            if (!ProviderClass) continue\n            const provider = new ProviderClass(this)\n            await this.register(provider)\n        }\n    }\n\n    protected async loadOptions () {\n        const app = await this.safeImport(this.getPath('base', 'package.json'))\n        const core = await this.safeImport('../package.json')\n\n        if (app && app.dependencies) {\n            this.versions.app = app.dependencies['@h3ravel/core']\n        }\n        if (core && core.devDependencies) {\n            this.versions.ts = app.devDependencies.typescript\n        }\n    }\n\n    /**\n     * Get all registered providers\n     */\n    public getRegisteredProviders () {\n        return this.providers;\n    }\n\n    /**\n     * Load default and optional providers dynamically\n     * \n     * Auto-Registration Behavior\n     * \n     * Minimal App: Loads only core, config, http, router by default.\n     * Full-Stack App: Installs database, mail, queue, cache → they self-register via their providers.\n     */\n    protected async getConfiguredProviders (): Promise<Array<AServiceProvider>> {\n        return [\n            (await import('@h3ravel/core')).CoreServiceProvider,\n            (await import('@h3ravel/core')).ViewServiceProvider,\n        ]\n    }\n\n    protected async getAllProviders (): Promise<Array<AServiceProvider>> {\n        const coreProviders = await this.getConfiguredProviders();\n        const allProviders = [...coreProviders, ...this.externalProviders];\n\n        /**\n         * Deduplicate by class reference\n         */\n        const uniqueProviders = Array.from(new Set(allProviders));\n\n        return this.sortProviders(uniqueProviders);\n    }\n\n    private sortProviders (providers: Array<AServiceProvider>) {\n        const priorityMap = new Map<string, number>();\n\n        /**\n         * Base priority (default 0)\n         */\n        providers.forEach((Provider) => {\n            priorityMap.set(Provider.name, (Provider as any).priority ?? 0);\n        });\n\n        /**\n         * Handle before/after adjustments\n         */\n        providers.forEach((Provider) => {\n            const order = (Provider as any).order;\n            if (!order) return;\n\n            const [direction, target] = order.split(':');\n            const targetPriority = priorityMap.get(target) ?? 0;\n\n            if (direction === 'before') {\n                priorityMap.set(Provider.name, targetPriority - 1);\n            } else if (direction === 'after') {\n                priorityMap.set(Provider.name, targetPriority + 1);\n            }\n        });\n\n        /**\n         * Service providers sorted based on thier name and priority\n         */\n        const sorted = providers.sort(\n            (A, B) => (priorityMap.get(B.name) ?? 0) - (priorityMap.get(A.name) ?? 0)\n        );\n\n        /**\n         * If debug is enabled, let's show the loaded service provider info\n         */\n        if (process.env.APP_DEBUG === 'true' && process.env.EXTENDED_DEBUG !== 'false' && !sorted.some(e => e.console)) {\n            console.table(\n                sorted.map((P) => ({\n                    Provider: P.name,\n                    Priority: priorityMap.get(P.name),\n                    Order: (P as any).order || 'N/A',\n                }))\n            );\n\n            console.info(`Set ${chalk.bgCyan(' APP_DEBUG = false ')} in your .env file to hide this information`, \"\\n\")\n        }\n\n        return sorted\n    }\n\n    registerProviders (providers: Array<AServiceProvider>): void {\n        this.externalProviders.push(...providers)\n    }\n\n    /**\n     * Register a provider\n     */\n    public async register (provider: IServiceProvider) {\n        await new ContainerResolver(this).resolveMethodParams(provider, 'register', this)\n        if (provider.registeredCommands && provider.registeredCommands.length > 0) {\n            this.registeredCommands.push(...provider.registeredCommands)\n        }\n        this.providers.push(provider)\n    }\n\n    /**\n     * checks if the application is running in CLI\n     */\n    public runningInConsole (): boolean {\n        return typeof process !== 'undefined'\n            && !!process.stdout\n            && !!process.stdin\n\n    }\n\n    public getRuntimeEnv (): 'browser' | 'node' | 'unknown' {\n        if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n            return 'browser'\n        }\n        if (typeof process !== 'undefined' && process.versions?.node) {\n            return 'node'\n        }\n        return 'unknown'\n    }\n\n    /**\n     * Boot all service providers after registration\n     */\n    public async boot () {\n        if (this.booted) return\n\n        for (const provider of this.providers) {\n            if (provider.boot) {\n                if (Container.hasAnyDecorator(provider.boot)) {\n                    /**\n                     * If the service provider is decorated use the IoC container\n                     */\n                    await this.make<any>(provider.boot)\n                } else {\n                    /**\n                     * Otherwise instantiate manually so that we can at least\n                     * pass the app instance\n                     */\n                    await provider.boot(this)\n                }\n            }\n        }\n\n        this.booted = true\n    }\n\n    /**\n     * Fire up the developement server using the user provided arguments\n     * \n     * Port will be auto assigned if provided one is not available\n     * \n     * @param h3App The current H3 app instance\n     * @param preferedPort If provided, this will overide the port set in the evironment\n     */\n    public async fire (h3App: H3, preferedPort?: number) {\n        const serve = this.make('http.serve')\n\n        const port: number = preferedPort ?? env('PORT', 3000)\n        const tries: number = env('RETRIES', 1)\n        const hostname: string = env('HOSTNAME', 'localhost')\n\n        try {\n            const realPort = await detect(port)\n\n            if (port == realPort) {\n                const server = serve(h3App, {\n                    port,\n                    hostname,\n                    silent: true,\n                })\n\n                Logger.parse([\n                    [`🚀 H3ravel running at:`, 'green'],\n                    [`${server.options.protocol ?? 'http'}://${server.options.hostname}:${server.options.port}`, 'cyan']]\n                )\n            } else if (this.tries <= tries) {\n                await this.fire(h3App, realPort)\n                this.tries++\n            } else {\n                Logger.parse([\n                    ['ERROR:', 'bgRed'],\n                    ['No free port available', 'red'],\n                ])\n            }\n        } catch (e: any) {\n            Logger.parse([\n                ['An error occured', 'bgRed'],\n                [e.message, 'red'],\n                [e.stack, 'red']\n            ], \"\\n\")\n        }\n    }\n\n    /**\n     * Attempt to dynamically import an optional module\n     */\n    private async safeImport (moduleName: string) {\n        try {\n            const mod = await import(moduleName)\n            return mod.default ?? mod ?? {}\n        } catch {\n            return null\n        }\n    }\n\n    /**\n     * Get the base path of the app\n     * \n     * @returns \n     */\n    getBasePath (): string {\n        return this.basePath\n    }\n\n    /**\n     * Dynamically retrieves a path property from the class.\n     * Any property ending with \"Path\" is accessible automatically.\n     *\n     * @param name - The base name of the path property\n     * @returns \n     */\n    getPath (name: IPathName, suffix?: string) {\n        return path.join(this.paths.getPath(name, this.basePath), suffix ?? '')\n    }\n\n    /**\n     * Programatically set the paths.\n     *\n     * @param name - The base name of the path property\n     * @param path - The new path\n     * @returns \n     */\n    setPath (name: IPathName, path: string) {\n        return this.paths.setPath(name, path, this.basePath)\n    }\n\n    /**\n     * Returns the installed version of the system core and typescript.\n     *\n     * @returns \n     */\n    getVersion (key: 'app' | 'ts') {\n        return this.versions[key]?.replaceAll(/\\^|~/g, '')\n    }\n}\n","import { Application } from '.'\nimport { IController } from '@h3ravel/shared'\n\n/**\n * Base controller class\n */\nexport abstract class Controller implements IController {\n    protected app: Application\n\n    constructor(app: Application) {\n        this.app = app\n    }\n\n    public show (..._ctx: any[]): any { return }\n    public index (..._ctx: any[]): any { return }\n    public store (..._ctx: any[]): any { return }\n    public update (..._ctx: any[]): any { return }\n    public destroy (..._ctx: any[]): any { return }\n}\n","export function Inject (...dependencies: string[]) {\n    return function (target: any) {\n        target.__inject__ = dependencies;\n    };\n}\n\n/**\n * Allows binding dependencies to both class and class methods \n * \n * @returns \n */\nexport function Injectable (): ClassDecorator & MethodDecorator {\n    return (...args: any[]) => {\n        if (args.length === 1) {\n            void args[0]; // class target\n        }\n        if (args.length === 3) {\n            void args[0]; // target\n            void args[1]; // propertyKey\n            void args[2]; // descriptor\n        }\n    };\n}\n\n// export function Injectable (): MethodDecorator & ClassDecorator {\n//     return ((_target: any, _propertyKey?: string, descriptor?: PropertyDescriptor) => {\n//         if (descriptor) {\n//             const original = descriptor.value;\n//             descriptor.value = async function (...args: any[]) {\n//                 const resolvedArgs = await Promise.all(args);\n//                 return original.apply(this, resolvedArgs);\n//             };\n//         }\n//     }) as any;\n// }\n","import { HttpContext, IMiddleware } from '@h3ravel/shared'\n\nimport type { H3Event } from 'h3'\n\n/**\n * Kernel class handles middleware execution and response transformations.\n * It acts as the core middleware pipeline for HTTP requests.\n */\nexport class Kernel {\n    /**\n     * @param context - A factory function that converts an H3Event into an HttpContext.\n     * @param middleware - An array of middleware classes that will be executed in sequence.\n     */\n    constructor(\n        protected context: (event: H3Event) => HttpContext,\n        protected middleware: IMiddleware[] = [],\n    ) { }\n\n    /**\n     * Handles an incoming request and passes it through middleware before invoking the next handler.\n     * \n     * @param event - The raw H3 event object.\n     * @param next - A callback function that represents the next layer (usually the controller or final handler).\n     * @returns A promise resolving to the result of the request pipeline.\n     */\n    async handle (\n        event: H3Event,\n        next: (ctx: HttpContext) => Promise<unknown>\n    ): Promise<unknown> {\n        /**\n         * Convert the raw event into a standardized HttpContext\n         */\n        const ctx = this.context(event)\n        const { app } = ctx.request\n\n        /**\n         * Dynamically bind the view renderer to the service container.\n         * This allows any part of the request lifecycle to render templates using Edge.\n         */\n        app.bind('view', () => async (template: string, params?: Record<string, any>) => {\n            const edge = app.make('edge')\n            return ctx.response.html(await edge.render(template, params))\n        })\n\n        /**\n         * Run middleware stack and obtain result\n         */\n        const result = await this.runMiddleware(ctx, () => next(ctx))\n\n        /**\n         * If a plain object is returned from a controller or middleware,\n         * automatically set the JSON Content-Type header for the response.\n         */\n        if (result !== undefined && this.isPlainObject(result)) {\n            event.res.headers.set('Content-Type', 'application/json; charset=UTF-8')\n        }\n\n        return result\n    }\n\n    /**\n     * Sequentially runs middleware in the order they were registered.\n     * \n     * @param context - The standardized HttpContext.\n     * @param next - Callback to execute when middleware completes.\n     * @returns A promise resolving to the final handler's result.\n     */\n    private async runMiddleware (\n        context: HttpContext,\n        next: (ctx: HttpContext) => Promise<unknown>\n    ) {\n        let index = -1\n\n        const runner = async (i: number): Promise<unknown> => {\n            if (i <= index) throw new Error('next() called multiple times')\n            index = i\n            const middleware = this.middleware[i]\n\n            if (middleware) {\n                /**\n                 * Execute the current middleware and proceed to the next one\n                 */\n                return middleware.handle(context, () => runner(i + 1))\n            } else {\n                /**\n                 * If no more middleware, call the final handler\n                 */\n                return next(context)\n            }\n        }\n\n        return runner(0)\n    }\n\n    /**\n     * Utility function to determine if a value is a plain object or array.\n     * \n     * @param value - The value to check.\n     * @returns True if the value is a plain object or array, otherwise false.\n     */\n    private isPlainObject (value: unknown): value is Record<string, unknown> {\n        return typeof value === 'object' &&\n            value !== null &&\n            (value.constructor === Object || value.constructor === Array)\n    }\n}\n","import { Application } from './Application'\nimport { IServiceProvider } from '@h3ravel/shared'\n\nexport abstract class ServiceProvider implements IServiceProvider {\n    /**\n     * Sort order\n     */\n\n    public static order?: `before:${string}` | `after:${string}` | string | undefined;\n\n    /**\n     * Sort priority\n     */\n    public static priority = 0;\n\n    /**\n     * Indicate that this service provider only runs in console\n     */\n    public static console = false;\n\n    /**\n     * List of registered console commands\n     */\n    public registeredCommands?: (new (app: any, kernel: any) => any)[];\n\n    protected app: Application\n\n    constructor(app: Application) {\n        this.app = app\n    }\n\n    /**\n     * Register bindings to the container.\n     * Runs before boot().\n     */\n    abstract register (...app: unknown[]): void | Promise<void>;\n\n    /**\n     * Perform post-registration booting of services.\n     * Runs after all providers have been registered.\n     */\n    boot?(...app: unknown[]): void | Promise<void>;\n\n    /**\n     * An array of console commands to register.\n     */\n    commands (commands: (new (app: any, kernel: any) => any)[]): void {\n        this.registeredCommands = commands\n    }\n}\n","import 'reflect-metadata'\n\nimport { ServiceProvider } from '../ServiceProvider'\n\n/**\n * Bootstraps core services and bindings.\n * \n * Bind essential services to the container (logger, config repository).\n * Register app-level singletons.\n * Set up exception handling.\n * \n * Auto-Registered\n */\nexport class CoreServiceProvider extends ServiceProvider {\n    public static priority = 999;\n\n    register () {\n    }\n}\n","import { Edge } from 'edge.js'\nimport { ServiceProvider } from '../ServiceProvider'\n\nexport class ViewServiceProvider extends ServiceProvider {\n    public static priority = 995;\n\n    register (): void {\n        const config = this.app.make('config')\n        const edge = Edge.create({\n            cache: process.env.NODE_ENV === 'production'\n        })\n\n        edge.mount(this.app.getPath('views'))\n\n        edge.global('asset', this.app.make('asset'))\n        edge.global('config', config.get)\n        edge.global('app', this.app)\n\n        this.app.bind('edge', () => edge)\n    }\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,125 +1,162 @@
-import { IContainer, UseKey, Bindings, IApplication, PathLoader, IServiceProvider, IPathName, IController, HttpContext, IMiddleware } from '@h3ravel/shared';
-import { H3Event } from 'h3';
+import { Bindings, HttpContext, IApplication, IContainer, IController, IMiddleware, IPathName, IServiceProvider, PathLoader, UseKey } from "@h3ravel/shared";
+import { H3, H3Event } from "h3";
 
+//#region src/Container.d.ts
 declare class Container implements IContainer {
-    private bindings;
-    private singletons;
-    /**
-     * Check if the target has any decorators
-     *
-     * @param target
-     * @returns
-     */
-    static hasAnyDecorator(target: Function): boolean;
-    /**
-     * Bind a transient service to the container
-     */
-    bind<T>(key: new (...args: any[]) => T, factory: () => T): void;
-    bind<T extends UseKey>(key: T, factory: () => Bindings[T]): void;
-    /**
-     * Bind a singleton service to the container
-     */
-    singleton<T extends UseKey>(key: T | (new (..._args: any[]) => Bindings[T]), factory: () => Bindings[T]): void;
-    /**
-     * Resolve a service from the container
-     */
-    make<T extends UseKey, X = undefined>(key: T | (new (..._args: any[]) => Bindings[T])): X extends undefined ? Bindings[T] : X;
-    /**
-     * Automatically build a class with constructor dependency injection
-     */
-    private build;
-    /**
-     * Check if a service is registered
-     */
-    has(key: UseKey): boolean;
+  private bindings;
+  private singletons;
+  /**
+   * Check if the target has any decorators
+   *
+   * @param target
+   * @returns
+   */
+  static hasAnyDecorator(target: Function): boolean;
+  /**
+   * Bind a transient service to the container
+   */
+  bind<T>(key: new (...args: any[]) => T, factory: () => T): void;
+  bind<T extends UseKey>(key: T, factory: () => Bindings[T]): void;
+  /**
+   * Bind a singleton service to the container
+   */
+  singleton<T extends UseKey>(key: T | (new (..._args: any[]) => Bindings[T]), factory: () => Bindings[T]): void;
+  /**
+   * Resolve a service from the container
+   */
+  make<T extends UseKey, X = undefined>(key: T | (new (..._args: any[]) => Bindings[T])): X extends undefined ? Bindings[T] : X;
+  /**
+   * Automatically build a class with constructor dependency injection
+   */
+  private build;
+  /**
+   * Check if a service is registered
+   */
+  has(key: UseKey): boolean;
 }
-
+//#endregion
+//#region src/Application.d.ts
+type AServiceProvider = (new (_app: Application) => IServiceProvider) & IServiceProvider;
 declare class Application extends Container implements IApplication {
-    paths: PathLoader;
-    private booted;
-    private versions;
-    private basePath;
-    private providers;
-    protected externalProviders: Array<new (_app: Application) => IServiceProvider>;
-    constructor(basePath: string);
-    /**
-     * Register core bindings into the container
-     */
-    protected registerBaseBindings(): void;
-    /**
-     * Dynamically register all configured providers
-     */
-    registerConfiguredProviders(): Promise<void>;
-    protected loadOptions(): Promise<void>;
-    /**
-     * Load default and optional providers dynamically
-     *
-     * Auto-Registration Behavior
-     *
-     * Minimal App: Loads only core, config, http, router by default.
-     * Full-Stack App: Installs database, mail, queue, cache → they self-register via their providers.
-     */
-    protected getConfiguredProviders(): Promise<Array<new (_app: Application) => IServiceProvider>>;
-    protected getAllProviders(): Promise<Array<new (_app: Application) => IServiceProvider>>;
-    private sortProviders;
-    registerProviders(providers: Array<new (_app: Application) => IServiceProvider>): void;
-    /**
-     * Register a provider
-     */
-    register(provider: IServiceProvider): Promise<void>;
-    /**
-     * Boot all providers after registration
-     */
-    boot(): Promise<void>;
-    /**
-     * Attempt to dynamically import an optional module
-     */
-    private safeImport;
-    /**
-     * Get the base path of the app
-     *
-     * @returns
-     */
-    getBasePath(): string;
-    /**
-     * Dynamically retrieves a path property from the class.
-     * Any property ending with "Path" is accessible automatically.
-     *
-     * @param name - The base name of the path property
-     * @returns
-     */
-    getPath(name: IPathName, pth?: string): string;
-    /**
-     * Programatically set the paths.
-     *
-     * @param name - The base name of the path property
-     * @param path - The new path
-     * @returns
-     */
-    setPath(name: IPathName, path: string): void;
-    /**
-     * Returns the installed version of the system core and typescript.
-     *
-     * @returns
-     */
-    getVersion(key: 'app' | 'ts'): string;
+  paths: PathLoader;
+  private tries;
+  private booted;
+  private versions;
+  private basePath;
+  private providers;
+  protected externalProviders: Array<new (_app: Application) => IServiceProvider>;
+  /**
+   * List of registered console commands
+   */
+  registeredCommands: (new (app: any, kernel: any) => any)[];
+  constructor(basePath: string);
+  /**
+   * Register core bindings into the container
+   */
+  protected registerBaseBindings(): void;
+  /**
+   * Dynamically register all configured providers
+   */
+  registerConfiguredProviders(): Promise<void>;
+  protected loadOptions(): Promise<void>;
+  /**
+   * Get all registered providers
+   */
+  getRegisteredProviders(): IServiceProvider[];
+  /**
+   * Load default and optional providers dynamically
+   *
+   * Auto-Registration Behavior
+   *
+   * Minimal App: Loads only core, config, http, router by default.
+   * Full-Stack App: Installs database, mail, queue, cache → they self-register via their providers.
+   */
+  protected getConfiguredProviders(): Promise<Array<AServiceProvider>>;
+  protected getAllProviders(): Promise<Array<AServiceProvider>>;
+  private sortProviders;
+  registerProviders(providers: Array<AServiceProvider>): void;
+  /**
+   * Register a provider
+   */
+  register(provider: IServiceProvider): Promise<void>;
+  /**
+   * checks if the application is running in CLI
+   */
+  runningInConsole(): boolean;
+  getRuntimeEnv(): 'browser' | 'node' | 'unknown';
+  /**
+   * Boot all service providers after registration
+   */
+  boot(): Promise<void>;
+  /**
+   * Fire up the developement server using the user provided arguments
+   *
+   * Port will be auto assigned if provided one is not available
+   *
+   * @param h3App The current H3 app instance
+   * @param preferedPort If provided, this will overide the port set in the evironment
+   */
+  fire(h3App: H3, preferedPort?: number): Promise<void>;
+  /**
+   * Attempt to dynamically import an optional module
+   */
+  private safeImport;
+  /**
+   * Get the base path of the app
+   *
+   * @returns
+   */
+  getBasePath(): string;
+  /**
+   * Dynamically retrieves a path property from the class.
+   * Any property ending with "Path" is accessible automatically.
+   *
+   * @param name - The base name of the path property
+   * @returns
+   */
+  getPath(name: IPathName, suffix?: string): string;
+  /**
+   * Programatically set the paths.
+   *
+   * @param name - The base name of the path property
+   * @param path - The new path
+   * @returns
+   */
+  setPath(name: IPathName, path: string): void;
+  /**
+   * Returns the installed version of the system core and typescript.
+   *
+   * @returns
+   */
+  getVersion(key: 'app' | 'ts'): string;
 }
-
+//#endregion
+//#region src/Contracts/ServiceProviderConstructor.d.ts
 type ServiceProviderConstructor = (new (app: Application) => ServiceProvider) & IServiceProvider;
-
+//#endregion
+//#region src/Controller.d.ts
 /**
  * Base controller class
  */
 declare abstract class Controller implements IController {
-    protected app: Application;
-    constructor(app: Application);
-    show(..._ctx: any[]): any;
-    index(..._ctx: any[]): any;
-    store(..._ctx: any[]): any;
-    update(..._ctx: any[]): any;
-    destroy(..._ctx: any[]): any;
+  protected app: Application;
+  constructor(app: Application);
+  show(..._ctx: any[]): any;
+  index(..._ctx: any[]): any;
+  store(..._ctx: any[]): any;
+  update(..._ctx: any[]): any;
+  destroy(..._ctx: any[]): any;
 }
-
+//#endregion
+//#region src/Di/ContainerResolver.d.ts
+declare class ContainerResolver {
+  private app;
+  constructor(app: Application);
+  resolveMethodParams<I extends Record<string, any>>(instance: I, method: keyof I, _default?: any): Promise<I>;
+  static isClass(C: any): boolean;
+}
+//#endregion
+//#region src/Di/Inject.d.ts
 declare function Inject(...dependencies: string[]): (target: any) => void;
 /**
  * Allows binding dependencies to both class and class methods
@@ -127,61 +164,82 @@ declare function Inject(...dependencies: string[]): (target: any) => void;
  * @returns
  */
 declare function Injectable(): ClassDecorator & MethodDecorator;
-
+//#endregion
+//#region src/Http/Kernel.d.ts
 /**
  * Kernel class handles middleware execution and response transformations.
  * It acts as the core middleware pipeline for HTTP requests.
  */
 declare class Kernel {
-    protected context: (event: H3Event) => HttpContext;
-    protected middleware: IMiddleware[];
-    /**
-     * @param context - A factory function that converts an H3Event into an HttpContext.
-     * @param middleware - An array of middleware classes that will be executed in sequence.
-     */
-    constructor(context: (event: H3Event) => HttpContext, middleware?: IMiddleware[]);
-    /**
-     * Handles an incoming request and passes it through middleware before invoking the next handler.
-     *
-     * @param event - The raw H3 event object.
-     * @param next - A callback function that represents the next layer (usually the controller or final handler).
-     * @returns A promise resolving to the result of the request pipeline.
-     */
-    handle(event: H3Event, next: (ctx: HttpContext) => Promise<unknown>): Promise<unknown>;
-    /**
-     * Sequentially runs middleware in the order they were registered.
-     *
-     * @param context - The standardized HttpContext.
-     * @param next - Callback to execute when middleware completes.
-     * @returns A promise resolving to the final handler's result.
-     */
-    private runMiddleware;
-    /**
-     * Utility function to determine if a value is a plain object or array.
-     *
-     * @param value - The value to check.
-     * @returns True if the value is a plain object or array, otherwise false.
-     */
-    private isPlainObject;
+  protected context: (event: H3Event) => HttpContext;
+  protected middleware: IMiddleware[];
+  /**
+   * @param context - A factory function that converts an H3Event into an HttpContext.
+   * @param middleware - An array of middleware classes that will be executed in sequence.
+   */
+  constructor(context: (event: H3Event) => HttpContext, middleware?: IMiddleware[]);
+  /**
+   * Handles an incoming request and passes it through middleware before invoking the next handler.
+   *
+   * @param event - The raw H3 event object.
+   * @param next - A callback function that represents the next layer (usually the controller or final handler).
+   * @returns A promise resolving to the result of the request pipeline.
+   */
+  handle(event: H3Event, next: (ctx: HttpContext) => Promise<unknown>): Promise<unknown>;
+  /**
+   * Sequentially runs middleware in the order they were registered.
+   *
+   * @param context - The standardized HttpContext.
+   * @param next - Callback to execute when middleware completes.
+   * @returns A promise resolving to the final handler's result.
+   */
+  private runMiddleware;
+  /**
+   * Utility function to determine if a value is a plain object or array.
+   *
+   * @param value - The value to check.
+   * @returns True if the value is a plain object or array, otherwise false.
+   */
+  private isPlainObject;
 }
-
+//#endregion
+//#region src/ServiceProvider.d.ts
 declare abstract class ServiceProvider implements IServiceProvider {
-    static order?: `before:${string}` | `after:${string}` | string | undefined;
-    static priority: number;
-    protected app: Application;
-    constructor(app: Application);
-    /**
-     * Register bindings to the container.
-     * Runs before boot().
-     */
-    abstract register(): void | Promise<void>;
-    /**
-     * Perform post-registration booting of services.
-     * Runs after all providers have been registered.
-     */
-    boot?(): void | Promise<void>;
+  /**
+   * Sort order
+   */
+  static order?: `before:${string}` | `after:${string}` | string | undefined;
+  /**
+   * Sort priority
+   */
+  static priority: number;
+  /**
+   * Indicate that this service provider only runs in console
+   */
+  static console: boolean;
+  /**
+   * List of registered console commands
+   */
+  registeredCommands?: (new (app: any, kernel: any) => any)[];
+  protected app: Application;
+  constructor(app: Application);
+  /**
+   * Register bindings to the container.
+   * Runs before boot().
+   */
+  abstract register(...app: unknown[]): void | Promise<void>;
+  /**
+   * Perform post-registration booting of services.
+   * Runs after all providers have been registered.
+   */
+  boot?(...app: unknown[]): void | Promise<void>;
+  /**
+   * An array of console commands to register.
+   */
+  commands(commands: (new (app: any, kernel: any) => any)[]): void;
 }
-
+//#endregion
+//#region src/Providers/CoreServiceProvider.d.ts
 /**
  * Bootstraps core services and bindings.
  *
@@ -192,17 +250,28 @@ declare abstract class ServiceProvider implements IServiceProvider {
  * Auto-Registered
  */
 declare class CoreServiceProvider extends ServiceProvider {
-    static priority: number;
-    register(): void;
+  static priority: number;
+  register(): void;
 }
-
+//#endregion
+//#region src/Providers/ViewServiceProvider.d.ts
 declare class ViewServiceProvider extends ServiceProvider {
-    static priority: number;
-    register(): void;
+  static priority: number;
+  register(): void;
 }
-
+//#endregion
+//#region src/Registerer.d.ts
 declare class Registerer {
-    static register(): void;
+  private app;
+  constructor(app: Application);
+  static register(app: Application): void;
+  bootRegister(): void;
+  private appPath;
+  private basePath;
+  private publicPath;
+  private storagePath;
+  private databasePath;
 }
-
-export { Application, Container, Controller, CoreServiceProvider, Inject, Injectable, Kernel, Registerer, ServiceProvider, type ServiceProviderConstructor, ViewServiceProvider };
+//#endregion
+export { Application, Container, ContainerResolver, Controller, CoreServiceProvider, Inject, Injectable, Kernel, Registerer, ServiceProvider, ServiceProviderConstructor, ViewServiceProvider };
+//# sourceMappingURL=index.d.cts.map