@h3ravel/core 1.29.0-alpha.16 → 2.0.0

package/dist/index.cjs

@@ -1,1386 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
-require("reflect-metadata");
-let _h3ravel_shared = require("@h3ravel/shared");
-let h3 = require("h3");
-let _h3ravel_contracts = require("@h3ravel/contracts");
-let _h3ravel_support = require("@h3ravel/support");
-let _h3ravel_foundation = require("@h3ravel/foundation");
-let module$1 = require("module");
-let fast_glob = require("fast-glob");
-fast_glob = __toESM(fast_glob, 1);
-let node_path = require("node:path");
-node_path = __toESM(node_path, 1);
-let detect_port = require("detect-port");
-let dotenv = require("dotenv");
-dotenv = __toESM(dotenv, 1);
-let dotenv_expand = require("dotenv-expand");
-dotenv_expand = __toESM(dotenv_expand, 1);
-let node_fs_promises = require("node:fs/promises");
-let semver = require("semver");
-semver = __toESM(semver, 1);
-let node_module = require("node:module");
-let _h3ravel_support_facades = require("@h3ravel/support/facades");
-//#region src/Manager/ContainerResolver.ts
-var ContainerResolver = class ContainerResolver {
-	app;
-	constructor(app) {
-		this.app = app;
-	}
-	async resolveMethodParams(instance, method, ..._default) {
-		/**
-		* Get param types for instance method
-		*/
-		let params = Reflect.getMetadata("design:paramtypes", instance, String(method)) || [];
-		/**
-		* Ensure that the Application class is always available
-		*/
-		if (params.length < 1 && _default.length > 0) params = _default;
-		/**
-		* Resolve the bound dependencies
-		*/
-		const args = params.filter((e) => ContainerResolver.isClass(e) || e instanceof Application).map((type) => {
-			if (type instanceof Application) return type;
-			return this.app.make(type);
-		});
-		return new Promise((resolve) => {
-			resolve(instance[method](...args));
-		});
-	}
-	static isClass(C) {
-		return typeof C === "function" && C.prototype !== void 0 && Object.toString.call(C).substring(0, 5) === "class";
-	}
-	static isAbstract(C) {
-		return this.isClass(C) && C.name.startsWith("I");
-	}
-	static isCallable(C) {
-		return typeof C === "function" && !ContainerResolver.isClass(C);
-	}
-};
-//#endregion
-//#region src/Container.ts
-var Container = class Container extends _h3ravel_contracts.IContainer {
-	bindings = /* @__PURE__ */ new Map();
-	singletons = /* @__PURE__ */ new Map();
-	middlewareHandler;
-	/**
-	* The current globally available container (if any).
-	*/
-	static instance;
-	/**
-	* All of the before resolving callbacks by class type.
-	*/
-	beforeResolvingCallbacks = /* @__PURE__ */ new Map();
-	/**
-	* All of the after resolving callbacks by class type.
-	*/
-	afterResolvingCallbacks = /* @__PURE__ */ new Map();
-	/**
-	* All of the registered rebound callbacks.
-	*/
-	reboundCallbacks = /* @__PURE__ */ new Map();
-	/**
-	* The container's shared instances.
-	*/
-	instances = /* @__PURE__ */ new Map();
-	/**
-	* The container's resolved instances.
-	*/
-	resolvedInstances = /* @__PURE__ */ new Map();
-	/**
-	* The registered type alias.
-	*/
-	aliases = /* @__PURE__ */ new Map();
-	/**
-	* The registered aliases keyed by the abstract name.
-	*/
-	abstractAliases = /* @__PURE__ */ new Map();
-	/**
-	* The registered aliases keyed by the abstract name.
-	*/
-	middlewares = /* @__PURE__ */ new Map();
-	/**
-	* The extension closures for services.
-	*/
-	extenders = /* @__PURE__ */ new Map();
-	static hasAnyDecorator(target) {
-		if (Reflect.getMetadataKeys(target).length > 0) return true;
-		const paramLength = target.length;
-		for (let i = 0; i < paramLength; i++) if (Reflect.getMetadataKeys(target, `__param_${i}`).length > 0) return true;
-		return false;
-	}
-	bind(key, factory) {
-		const abstract = this.getAlias(key);
-		this.resolvedInstances.delete(abstract);
-		this.singletons.delete(abstract);
-		this.bindings.set(abstract, factory);
-		if (this.reboundCallbacks.has(abstract)) this.rebound(abstract);
-	}
-	/**
-	* Bind unregistered middlewares to the service container so we can use them later
-	* 
-	* @param key 
-	* @param middleware 
-	*/
-	bindMiddleware(key, middleware) {
-		this.middlewares.set(key, middleware);
-	}
-	boundMiddlewares(key) {
-		if (key) return this.middlewares.get(key);
-		return this.middlewares.entries();
-	}
-	/**
-	* Remove one or more transient services from the container
-	* 
-	* @param key 
-	*/
-	unbind(key) {
-		if (Array.isArray(key)) for (let i = 0; i < key.length; i++) {
-			const abstract = this.getAlias(key[i]);
-			this.bindings.delete(abstract);
-			this.singletons.delete(abstract);
-			this.instances.delete(abstract);
-			this.resolvedInstances.delete(abstract);
-		}
-		else {
-			const abstract = this.getAlias(key);
-			this.bindings.delete(abstract);
-			this.singletons.delete(abstract);
-			this.instances.delete(abstract);
-			this.resolvedInstances.delete(abstract);
-		}
-	}
-	singleton(key, factory) {
-		this.bindings.set(key, () => {
-			if (!this.singletons.has(key)) this.singletons.set(key, this.call(factory));
-			return this.singletons.get(key);
-		});
-	}
-	/**
-	* Read reflected param types, resolve dependencies from the container and 
-	* optionally transform them, finally invoke the specified method on a class instance
-	* 
-	* @param instance 
-	* @param method 
-	* @param defaultArgs 
-	* @param handler 
-	* @returns 
-	*/
-	async invoke(instance, method, defaultArgs, handler) {
-		/**
-		* Get param types for the instance method
-		*/
-		const paramTypes = Reflect.getMetadata("design:paramtypes", instance, method) || [];
-		/**
-		* Resolve the bound dependencies
-		*/
-		let args = await Promise.all(paramTypes.map(async (paramType) => {
-			const inst = this.make(paramType);
-			if (handler) return await handler(inst);
-			return inst;
-		}));
-		/**
-		* Ensure that the args is always filled
-		*/
-		if (args.length < 1) args = defaultArgs ?? [];
-		const fn = instance[method];
-		return Reflect.apply(fn, instance, args);
-	}
-	/**
-	* Read reflected param types, resolve dependencies from the container and return the result
-	* 
-	* @param instance 
-	* @param method 
-	*/
-	resolveParams(instance, method) {
-		/**
-		* Resolve and return the bound dependencies
-		*/
-		return (Reflect.getMetadata("design:paramtypes", instance, method) || []).filter((e) => !!e).map((abstract) => {
-			if (typeof abstract === "function" && abstract.toString().startsWith("function Function")) return abstract;
-			return this.make(abstract);
-		});
-	}
-	make(key) {
-		return this.resolve(key);
-	}
-	/**
-	* Resolve the gevein service from the container
-	* 
-	* @param abstract 
-	* @param raiseEvents 
-	*/
-	resolve(abstract, raiseEvents = true) {
-		abstract = this.getAlias(abstract);
-		/**
-		* Direct factory binding
-		*/
-		let resolved;
-		if (this.resolvedInstances.has(abstract)) return this.resolvedInstances.get(abstract);
-		if (raiseEvents) this.runBeforeResolvingCallbacks(abstract);
-		if (this.bindings.has(abstract)) resolved = this.bindings.get(abstract)();
-		else if (this.instances.has(abstract)) resolved = this.instances.get(abstract);
-		else if (typeof abstract === "function")
- /**
-		* If this is a class constructor, auto-resolve via reflection
-		*/
-		resolved = this.build(abstract);
-		else throw new Error(`No binding found for key: ${typeof abstract === "string" ? abstract : abstract?.name}`);
-		/**
-		* If we defined any extenders for this type, we'll need to spin through them
-		* and apply them to the object being built. This allows for the extension
-		* of services, such as changing configuration or decorating the object.
-		*/
-		for (const extender of this.getExtenders(abstract)) resolved = extender(resolved, this);
-		if (raiseEvents) this.runAfterResolvingCallbacks(abstract, resolved);
-		this.resolvedInstances.set(abstract, resolved);
-		return resolved;
-	}
-	afterResolving(key, callback) {
-		const existing = this.afterResolvingCallbacks.get(key) || [];
-		existing.push(callback);
-		this.afterResolvingCallbacks.set(key, existing);
-	}
-	beforeResolving(key, callback) {
-		const existing = this.beforeResolvingCallbacks.get(key) || [];
-		existing.push(callback);
-		this.beforeResolvingCallbacks.set(key, existing);
-	}
-	/**
-	* Execute all registered beforeResolving callbacks for a given key
-	*
-	* @param  key
-	* @param resolved 
-	*/
-	runBeforeResolvingCallbacks(key) {
-		const callbacks = this.beforeResolvingCallbacks.get(key) || [];
-		for (let i = 0; i < callbacks.length; i++) callbacks[i](this);
-	}
-	/**
-	* Execute all registered afterResolving callbacks for a given key
-	* 
-	* @param key 
-	* @param resolved 
-	*/
-	runAfterResolvingCallbacks(key, resolved) {
-		const callbacks = this.afterResolvingCallbacks.get(key) || [];
-		for (let i = 0; i < callbacks.length; i++) callbacks[i](resolved, this);
-	}
-	/**
-	* Automatically build a class with constructor dependency injection
-	* 
-	* @param ClassType 
-	* @returns 
-	*/
-	build(ClassType) {
-		let dependencies = [];
-		if (Array.isArray(ClassType.__inject__)) dependencies = ClassType.__inject__.map((alias) => {
-			return this.make(alias);
-		});
-		else dependencies = (Reflect.getMetadata("design:paramtypes", ClassType) || []).map((dep) => this.make(dep));
-		if (dependencies.length === 0) dependencies = [this];
-		return new ClassType(...dependencies);
-	}
-	/**
-	* Determine if a given string is an alias.
-	*
-	* @param name
-	*/
-	isAlias(name) {
-		return this.aliases.has(name) && typeof this.aliases.get(name) !== "undefined";
-	}
-	/**
-	* Get the alias for an abstract if available.
-	*
-	* @param  abstract
-	*/
-	getAlias(abstract) {
-		if (typeof abstract === "string" && this.aliases.has(abstract)) return this.getAlias(this.aliases.get(abstract));
-		if (abstract == null) return abstract;
-		return this.aliases.get(abstract) ?? abstract;
-	}
-	/**
-	* Get the extender callbacks for a given type.
-	*
-	* @param  abstract
-	*/
-	getExtenders(abstract) {
-		return this.extenders.get(this.getAlias(abstract)) ?? [];
-	}
-	/**
-	* Remove all of the extender callbacks for a given type.
-	*
-	* @param  abstract
-	*/
-	forgetExtenders(abstract) {
-		this.extenders.delete(this.getAlias(abstract));
-	}
-	alias(key, target) {
-		if (Array.isArray(key)) for (const [tokn, targ] of key) this.aliases.set(tokn, targ);
-		else this.aliases.set(key, target);
-		return this;
-	}
-	rebinding(abstract, callback) {
-		abstract = this.getAlias(abstract);
-		this.reboundCallbacks.set(abstract, this.reboundCallbacks.get(abstract)?.concat(callback) ?? [callback]);
-		if (this.bound(abstract)) return this.make(abstract);
-	}
-	bound(abstract) {
-		return this.bindings.has(abstract) || !!this.instances.get(abstract) || this.isAlias(abstract);
-	}
-	has(key) {
-		return this.bound(key);
-	}
-	/**
-	* Determine if the given abstract type has been resolved.
-	*
-	* @param abstract
-	*/
-	resolved(abstract) {
-		if (this.isAlias(abstract)) abstract = this.getAlias(abstract);
-		return this.resolvedInstances.has(abstract) || this.instances.has(abstract);
-	}
-	extend(abstract, closure) {
-		abstract = this.getAlias(abstract);
-		if (this.instances.has(abstract)) {
-			this.instances.set(abstract, closure(this.instances.get(abstract), this));
-			this.rebound(abstract);
-		} else {
-			this.extenders.set(abstract, this.extenders.get(abstract)?.concat(closure) ?? [closure]);
-			if (this.resolved(abstract)) this.rebound(abstract);
-		}
-	}
-	instance(abstract, instance) {
-		abstract = this.getAlias(abstract);
-		this.removeAbstractAlias(abstract);
-		const isBound = this.bound(abstract);
-		this.aliases.delete(abstract);
-		this.resolvedInstances.delete(abstract);
-		this.instances.set(abstract, instance);
-		if (isBound) this.rebound(abstract);
-		return instance;
-	}
-	call(callback) {
-		if (ContainerResolver.isClass(callback)) return this.make(callback);
-		return callback(this);
-	}
-	/**
-	* Fire the "rebound" callbacks for the given abstract type.
-	*
-	* @param abstract
-	*/
-	rebound(abstract) {
-		const callbacks = this.getReboundCallbacks(abstract);
-		if (!callbacks) return;
-		const instance = this.make(abstract);
-		for (const callback of callbacks) callback(this, instance);
-	}
-	/**
-	* Get the rebound callbacks for a given type.
-	*
-	* @param abstract
-	*/
-	getReboundCallbacks(abstract) {
-		return this.reboundCallbacks.get(abstract) ?? [];
-	}
-	/**
-	* Remove an alias from the contextual binding alias cache.
-	*
-	* @param  searched
-	*/
-	removeAbstractAlias(searched) {
-		if (!this.aliases.has(searched)) return;
-		for (const [abstract, aliases] of this.abstractAliases.entries()) {
-			const filtered = aliases.filter((alias) => alias !== searched);
-			if (filtered.length > 0) this.abstractAliases.set(abstract, filtered);
-			else this.abstractAliases.delete(abstract);
-		}
-	}
-	/**
-	* Get the globally available instance of the container.
-	*/
-	static getInstance() {
-		return this.instance ??= new Application(process.cwd(), "h3ravel");
-	}
-	/**
-	* Set the shared instance of the container.
-	* 
-	* @param container 
-	*/
-	static setInstance(container) {
-		return Container.instance = container;
-	}
-};
-//#endregion
-//#region src/ProviderRegistry.ts
-var ProviderRegistry = class {
-	static providers = /* @__PURE__ */ new Map();
-	static priorityMap = /* @__PURE__ */ new Map();
-	static filteredProviders = [];
-	static sortable = true;
-	/**
-	* Set wether providers should be sorted or not.
-	* 
-	* @returns 
-	*/
-	static setSortable(sort = true) {
-		this.sortable = sort;
-	}
-	/**
-	* Get a unique identifier for the Provider.
-	* 
-	* @param provider 
-	* @returns 
-	*/
-	static getKey(provider) {
-		const anyProvider = provider;
-		if (typeof anyProvider.uid === "string") return anyProvider.uid;
-		if (typeof anyProvider.id === "string") return anyProvider.id;
-		return provider.name || "AnonymousProvider";
-	}
-	/**
-	* Register one or more providers.
-	* Duplicate constructors will be ignored.
-	* 
-	* @param providers 
-	* @returns 
-	*/
-	static register(...providers) {
-		const list = this.sortable ? this.sort(providers.concat(...this.providers.values())) : providers.concat(...this.providers.values());
-		for (const provider of list) {
-			const key = this.getKey(provider);
-			this.providers.set(key, provider);
-		}
-	}
-	/**
-	* Bulk register providers from an array.
-	* 
-	* @param providers 
-	* @returns 
-	*/
-	static registerMany(providers) {
-		const list = this.sortable ? this.sort(providers.concat(...this.providers.values())) : providers.concat(...this.providers.values());
-		for (const provider of list) {
-			const key = this.getKey(provider);
-			this.providers.set(key, provider);
-		}
-	}
-	/**
-	* Set the filtered providers.
-	*  
-	* @returns 
-	*/
-	static setFiltered(filtered) {
-		this.filteredProviders = filtered;
-	}
-	/**
-	* Resolve (instantiate) all providers with the given application or Service Container.
-	* 
-	* @param app 
-	* @returns 
-	*/
-	static async resolve(app, useServiceContainer = false) {
-		const providers = Array.from(this.providers.values()).filter((e) => {
-			return !!e && (this.filteredProviders.length < 1 || !this.filteredProviders.includes(e.name));
-		});
-		return await Promise.all(providers.map(async (ProviderClass) => {
-			const provider = new ProviderClass(app);
-			if (!useServiceContainer) return Promise.resolve(provider);
-			await new ContainerResolver(app).resolveMethodParams(provider, "register", app);
-			return provider;
-		}));
-	}
-	/**
-	* Sort the service providers
-	* 
-	* @param providers 
-	* @returns 
-	*/
-	static sort(providers) {
-		const makeKey = (Provider) => `${Provider.name}::${this.getKey(Provider)}`;
-		providers.sort((A, B) => (B.priority ?? 0) - (A.priority ?? 0));
-		const findIndex = (target) => {
-			if (target.includes("::")) return providers.findIndex((p) => makeKey(p) === target);
-			return providers.findIndex((p) => p.name === target);
-		};
-		providers.forEach((Provider) => {
-			const order = Provider.order;
-			if (!order) return;
-			const [direction, rawTarget] = order.split(":");
-			const targetIndex = findIndex(rawTarget);
-			if (targetIndex === -1) return;
-			const currentIndex = providers.indexOf(Provider);
-			if (currentIndex === -1) return;
-			providers.splice(currentIndex, 1);
-			const insertIndex = direction === "before" ? targetIndex : targetIndex + 1;
-			providers.splice(insertIndex, 0, Provider);
-		});
-		return providers;
-	}
-	/**
-	* Sort service providers
-	*/
-	static doSort() {
-		const raw = this.sort(Array.from(this.providers.values()));
-		const providers = /* @__PURE__ */ new Map();
-		for (const provider of raw) {
-			const key = this.getKey(provider);
-			providers.set(key, provider);
-		}
-		this.providers = providers;
-	}
-	/**
-	* Log the service providers in a table
-	* 
-	* @param priorityMap 
-	*/
-	static log(providers, enabled = true) {
-		if (!enabled) return;
-		const sorted = Array.from((providers ?? this.providers).values());
-		console.table(sorted.map((P) => ({
-			Name: P.constructor.name,
-			Order: P.constructor.order ?? "N/A",
-			Priority: P.constructor.priority
-		})));
-		console.info("");
-	}
-	/**
-	* Get all registered providers as an array.
-	*  
-	* @returns 
-	*/
-	static all() {
-		return Array.from(this.providers.values());
-	}
-	/**
-	* Check if a provider is already registered.
-	* 
-	* @param provider 
-	* @returns 
-	*/
-	static has(provider) {
-		return this.providers.has(this.getKey(provider));
-	}
-	/**
-	* Automatically search for and discover service providers in packages.
-	* 
-	* @param autoRegister 
-	* @returns 
-	*/
-	static async discoverProviders(autoRegister = true) {
-		const manifests = await (0, fast_glob.default)([
-			"node_modules/@h3ravel/*/package.json",
-			"node_modules/@h3ravel-community/*/package.json",
-			"node_modules/h3ravel-*/package.json"
-		]);
-		const providers = [];
-		if (autoRegister) {
-			for (const manifestPath of manifests) {
-				const pkg = this.getManifest(node_path.default.resolve(manifestPath));
-				if (pkg.h3ravel?.providers) providers.push(...await Promise.all(pkg.h3ravel.providers.map(async (name) => (await import(node_path.default.resolve(node_path.default.dirname(manifestPath), "dist/index.js")))[name])));
-			}
-			for (const provider of providers.filter((e) => typeof e !== "undefined")) {
-				const key = this.getKey(provider);
-				this.providers.set(key, provider);
-			}
-		}
-		return providers;
-	}
-	/**
-	* Get the content of the package.json file
-	* 
-	* @param manifestPath 
-	* @returns 
-	*/
-	static getManifest(manifestPath) {
-		return (0, module$1.createRequire)(require("url").pathToFileURL(__filename).href)(manifestPath);
-	}
-};
-//#endregion
-//#region src/Registerer.ts
-var Registerer = class Registerer extends _h3ravel_contracts.IRegisterer {
-	app;
-	constructor(app) {
-		super();
-		this.app = app;
-	}
-	static register(app) {
-		new Registerer(app).bootRegister();
-	}
-	bootRegister() {
-		globalThis.dd = _h3ravel_support.dd;
-		globalThis.dump = _h3ravel_support.dump;
-		globalThis.app_path = (path) => this.appPath(path);
-		globalThis.base_path = (path) => this.basePath(path);
-		globalThis.public_path = (path) => this.publicPath(path);
-		globalThis.storage_path = (path) => this.storagePath(path);
-		globalThis.database_path = (path) => this.databasePath(path);
-	}
-	appPath(path) {
-		return this.app.getPath("base", node_path.default.join(`/${process.env.DIST_DIR ?? "src"}/`.replace(/([^:]\/)\/+/g, "$1"), "app", path ?? ""));
-	}
-	basePath(path) {
-		return this.app.getPath("base", path);
-	}
-	publicPath(path) {
-		return this.app.getPath("public", path);
-	}
-	storagePath(path) {
-		return this.app.getPath("base", node_path.default.join("storage", path ?? ""));
-	}
-	databasePath(path) {
-		return this.app.getPath("database", path);
-	}
-};
-//#endregion
-//#region src/Providers/CoreServiceProvider.ts
-/**
-* Bootstraps core services and bindings.
-* 
-* Bind essential services to the container (logger, config repository).
-* Register app-level singletons.
-* Set up exception handling.
-* 
-* Auto-Registered
-*/
-var CoreServiceProvider = class extends _h3ravel_support.ServiceProvider {
-	static priority = 999;
-	register() {
-		Object.assign(globalThis, { str: _h3ravel_support.str });
-		this.app.alias(_h3ravel_contracts.IApplication, Application);
-	}
-	boot() {}
-};
-//#endregion
-//#region src/Application.ts
-var Application = class Application extends Container {
-	initializer;
-	/**
-	* Indicates if the application has "booted".
-	*/
-	#booted = false;
-	paths = new _h3ravel_shared.PathLoader();
-	context;
-	h3Event;
-	tries = 0;
-	basePath;
-	versions = {
-		app: "0.0.0",
-		ts: "0.0.0"
-	};
-	namespace;
-	static versions = {
-		app: "0.0.0",
-		ts: "0.0.0"
-	};
-	h3App;
-	providers = [];
-	externalProviders = [];
-	filteredProviders = [];
-	autoRegisterProviders = false;
-	/**
-	* The route resolver callback.
-	*/
-	uriResolver;
-	/**
-	* List of registered console commands
-	*/
-	registeredCommands = [];
-	/**
-	* The array of booted callbacks.
-	*/
-	bootedCallbacks = [];
-	/**
-	* The array of booting callbacks.
-	*/
-	bootingCallbacks = [];
-	/**
-	* The array of terminating callbacks.
-	*/
-	terminatingCallbacks = [];
-	/**
-	* Indicates if the application has been bootstrapped before.
-	*/
-	bootstrapped = false;
-	/**
-	* Controls logging
-	*/
-	logsDisabled = false;
-	/**
-	* The conrrent HttpContext
-	*/
-	httpContext;
-	constructor(basePath, initializer) {
-		super();
-		this.initializer = initializer;
-		dotenv_expand.default.expand(dotenv.default.config({ quiet: true }));
-		this.basePath = basePath;
-		this.setPath("base", basePath);
-		this.loadOptions();
-		this.registerBaseBindings();
-		Registerer.register(this);
-	}
-	/**
-	* Register core bindings into the container
-	*/
-	registerBaseBindings() {
-		Application.setInstance(this);
-		this.bind(Application, () => this);
-		this.bind("path.base", () => this.basePath);
-		this.bind("load.paths", () => this.paths);
-	}
-	async loadOptions() {
-		try {
-			const corePath = _h3ravel_shared.FileSystem.findModulePkg("@h3ravel/core", process.cwd()) ?? "";
-			const app = JSON.parse(await (0, node_fs_promises.readFile)(node_path.default.join(process.cwd(), "/package.json"), { encoding: "utf8" }));
-			const core = JSON.parse(await (0, node_fs_promises.readFile)(node_path.default.join(corePath, "package.json"), { encoding: "utf8" }));
-			if (core) {
-				this.versions.app = semver.default.minVersion(core.version)?.version ?? this.versions.app;
-				Application.versions.app = this.versions.app;
-			}
-			if (app && app.devDependencies) {
-				this.versions.ts = semver.default.minVersion(app.devDependencies.typescript)?.version ?? this.versions.ts;
-				Application.versions.ts = this.versions.ts;
-			}
-			if (app && app.dependencies) {
-				const versions = Object.fromEntries(Object.entries(app.dependencies).filter(([e]) => e.includes("@h3ravel")).map(([name, ver]) => [_h3ravel_support.Str.afterLast(name, "/"), semver.default.minVersion(ver.includes("work") ? this.versions.app : ver)?.version]));
-				Object.assign(this.versions, versions);
-				Object.assign(Application.versions, versions);
-			}
-		} catch {}
-	}
-	/**
-	* Get all registered providers
-	*/
-	getRegisteredProviders() {
-		return this.providers;
-	}
-	/**
-	* 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.
-	*/
-	async getConfiguredProviders() {
-		return [CoreServiceProvider];
-	}
-	async getAllProviders() {
-		return [...await this.getConfiguredProviders(), ...this.externalProviders];
-	}
-	/**
-	* Configure and Dynamically register all configured service providers, then boot the app.
-	* 
-	* @param providers All regitererable service providers
-	* @param filtered A list of service provider name strings we do not want to register at all cost
-	* @param autoRegisterProviders If set to false, service providers will not be auto discovered and registered.
-	* 
-	* @returns 
-	*/
-	initialize(providers, filtered = [], autoRegisterProviders = true) {
-		/**
-		* Bind HTTP APP to the service container
-		*/
-		this.singleton("http.app", () => {
-			return new h3.H3();
-		});
-		/**
-		* Bind the HTTP server to the service container
-		*/
-		this.singleton("http.serve", () => h3.serve);
-		this.registerProviders(providers, filtered);
-		this.autoRegisterProviders = autoRegisterProviders;
-		return this;
-	}
-	/**
-	* Dynamically register all configured providers
-	*/
-	async registerConfiguredProviders() {
-		const providers = await this.getAllProviders();
-		ProviderRegistry.setSortable(false);
-		ProviderRegistry.setFiltered(this.filteredProviders);
-		ProviderRegistry.registerMany(providers);
-		if (this.autoRegisterProviders) await ProviderRegistry.discoverProviders(this.autoRegisterProviders);
-		ProviderRegistry.doSort();
-		for (const ProviderClass of ProviderRegistry.all()) {
-			if (!ProviderClass) continue;
-			const provider = new ProviderClass(this);
-			await this.register(provider);
-		}
-	}
-	/**
-	* Register service providers
-	* 
-	* @param providers 
-	* @param filtered 
-	*/
-	registerProviders(providers, filtered = []) {
-		this.externalProviders.push(...providers);
-		this.filteredProviders = Array.from(new Set(this.filteredProviders.concat(filtered)));
-	}
-	/**
-	* Register a provider
-	*/
-	async register(provider) {
-		await new ContainerResolver(this).resolveMethodParams(provider, "register", this);
-		if (provider.registeredCommands && provider.registeredCommands.length > 0) this.registeredCommands.push(...provider.registeredCommands);
-		this.providers.push(provider);
-	}
-	/**
-	* Register the listed service providers.
-	* 
-	* @param commands An array of console commands to register.
-	*/
-	withCommands(commands) {
-		this.registeredCommands = commands;
-		return this;
-	}
-	/**
-	* checks if the application is running in CLI
-	*/
-	runningInConsole() {
-		return typeof process !== "undefined" && !!process.stdout && !!process.stdin;
-	}
-	/**
-	* checks if the application is running in Unit Test
-	*/
-	runningUnitTests() {
-		return process.env.VITEST === "true";
-	}
-	getRuntimeEnv() {
-		if (typeof window !== "undefined" && typeof document !== "undefined") return "browser";
-		if (typeof process !== "undefined" && process.versions?.node) return "node";
-		return "unknown";
-	}
-	/**
-	* Determine if the application has booted.
-	*/
-	isBooted() {
-		return this.#booted;
-	}
-	/**
-	* Determine if the application has booted.
-	*/
-	logging(logging = true) {
-		this.logsDisabled = !logging;
-		return this;
-	}
-	logsEnabled() {
-		if (this.logsDisabled) return false;
-		return (process.env.APP_DEBUG === "true" && process.env.EXTENDED_DEBUG !== "false" || Number(process.env.VERBOSE) > 1) && !this.providers.some((e) => e.runsInConsole);
-	}
-	/**
-	* Boot all service providers after registration
-	*/
-	async boot() {
-		if (this.#booted) return this;
-		this.fireAppCallbacks(this.bootingCallbacks);
-		/**
-		* Register all the configured service providers
-		*/
-		await this.registerConfiguredProviders();
-		/**
-		* If debug is enabled, let's show the loaded service provider info
-		*/
-		ProviderRegistry.log(this.providers, this.logsEnabled());
-		for (const provider of this.providers) if (provider.boot) {
-			if (Container.hasAnyDecorator(provider.boot))
- /**
-			* If the service provider is decorated use the IoC container
-			*/
-			await this.make(provider.boot);
-			else
- /**
-			* Otherwise instantiate manually so that we can at least
-			* pass the app instance
-			*/
-			await provider.boot(this);
-			if (provider.callBootedCallbacks) await provider.callBootedCallbacks();
-		}
-		this.#booted = true;
-		this.fireAppCallbacks(this.bootedCallbacks);
-		return this;
-	}
-	/**
-	* Register a new boot listener.
-	*
-	* @param  callable  $callback
-	*/
-	booting(callback) {
-		this.bootingCallbacks.push(callback);
-	}
-	/**
-	* Register a new "booted" listener.
-	*
-	* @param callback
-	*/
-	booted(callback) {
-		this.bootedCallbacks.push(callback);
-		if (this.isBooted()) callback(this);
-	}
-	/**
-	* Throw an HttpException with the given data.
-	*
-	* @param  code
-	* @param  message
-	* @param  headers
-	*
-	* @throws {HttpException}
-	* @throws {NotFoundHttpException}
-	*/
-	abort(code, message = "", headers = {}) {
-		if (code == 404) throw new _h3ravel_foundation.NotFoundHttpException(message, void 0, 0, headers);
-		throw new _h3ravel_foundation.HttpException(code, message, void 0, headers);
-	}
-	/**
-	* Register a terminating callback with the application.
-	*
-	* @param  callback
-	*/
-	terminating(callback) {
-		this.terminatingCallbacks.push(callback);
-		return this;
-	}
-	/**
-	* Terminate the application.
-	*/
-	terminate() {
-		let index = 0;
-		while (index < this.terminatingCallbacks.length) {
-			this.call(this.terminatingCallbacks[index]);
-			index++;
-		}
-	}
-	/**
-	* Call the booting callbacks for the application.
-	*
-	* @param  callbacks
-	*/
-	fireAppCallbacks(callbacks) {
-		let index = 0;
-		while (index < callbacks.length) {
-			callbacks[index](this);
-			index++;
-		}
-	}
-	/**
-	* Handle the incoming HTTP request and send the response to the browser.
-	*
-	* @param  config  Configuration option to pass to the initializer
-	*/
-	async handleRequest(config) {
-		this.h3App?.all("/**", async (event) => {
-			this.context = (event) => this.buildContext(event, config);
-			this.h3Event = event;
-			const context = await this.buildContext(event, config, true);
-			const kernel = this.make(_h3ravel_contracts.IKernel);
-			this.bind("http.context", () => context);
-			this.bind("http.request", () => context.request);
-			this.bind("http.response", () => context.response);
-			let response;
-			try {
-				response = await kernel.handle(context.request);
-				const handledResponse = response ?? context.response;
-				this.bind("http.response", () => handledResponse);
-				kernel.terminate(context.request, handledResponse);
-				let finalResponse;
-				if (response && ["Response", "JsonResponse"].includes(response.constructor.name)) finalResponse = response.prepare(context.request).send();
-				else finalResponse = response;
-				return finalResponse;
-			} finally {
-				const { HttpContext } = await import("@h3ravel/http");
-				HttpContext.forget(context.event);
-				delete context.event._h3ravelContext;
-				this.unbind([
-					"http.context",
-					"http.request",
-					"http.response"
-				]);
-			}
-		});
-	}
-	/**
-	* Build the http context
-	* 
-	* @param event 
-	* @param config 
-	* @returns 
-	*/
-	async buildContext(event, config, fresh = false) {
-		const { HttpContext, Request, Response } = await import("@h3ravel/http");
-		event = config?.h3Event ?? event;
-		if (!fresh && event._h3ravelContext) return event._h3ravelContext;
-		Request.enableHttpMethodParameterOverride();
-		const ctx = HttpContext.init({
-			app: this,
-			request: await Request.create(event, this),
-			response: new Response(this, event)
-		}, event);
-		event._h3ravelContext = ctx;
-		return ctx;
-	}
-	/**
-	* Handle the incoming Artisan command.
-	*/
-	async handleCommand() {
-		const kernel = this.make(_h3ravel_contracts.CKernel);
-		const status = await kernel.handle();
-		kernel.terminate(status);
-		return status;
-	}
-	/**
-	* Get the URI resolver callback.
-	*/
-	getUriResolver() {
-		return this.uriResolver ?? (() => void 0);
-	}
-	/**
-	* Set the URI resolver callback.
-	*
-	* @param  callback
-	*/
-	setUriResolver(callback) {
-		this.uriResolver = callback;
-		return this;
-	}
-	/**
-	* Determine if middleware has been disabled for the application.
-	*/
-	shouldSkipMiddleware() {
-		return this.bound("middleware.disable") && this.make("middleware.disable") === true;
-	}
-	/**
-	* Provide safe overides for the app
-	*/
-	configure() {
-		return new _h3ravel_foundation.AppBuilder(this).withKernels().withCommands();
-	}
-	/**
-	* Check if the current application environment matches the one provided
-	*/
-	environment(env) {
-		return this.make("config").get("app.env") === env;
-	}
-	async fire(h3App, preferredPort) {
-		if (h3App) this.h3App = h3App;
-		if (!this?.h3App) throw new _h3ravel_foundation.ConfigException("[Provide a H3 app instance in the config or install @h3ravel/http]");
-		return await this.serve(this.h3App, preferredPort);
-	}
-	/**
-	* 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
-	*/
-	async serve(h3App, preferredPort) {
-		if (!h3App) throw new _h3ravel_support.InvalidArgumentException("No valid H3 app instance was provided.");
-		await this.boot();
-		const serve = this.make("http.serve");
-		const port = preferredPort ?? env("PORT", 3e3);
-		const tries = env("RETRIES", 1);
-		const hostname = env("HOSTNAME", "localhost");
-		try {
-			const realPort = await (0, detect_port.detect)(port);
-			if (port == realPort) {
-				const server = serve(h3App, {
-					port,
-					hostname,
-					silent: true
-				});
-				_h3ravel_shared.Logger.parse([["🚀 H3ravel running at:", "green"], [`${server.options.protocol ?? "http"}://${server.options.hostname}:${server.options.port}`, "cyan"]]);
-			} else if (this.tries <= tries) {
-				await this.fire(h3App, realPort);
-				this.tries++;
-			} else _h3ravel_shared.Logger.parse([["ERROR:", "bgRed"], ["No free port available", "red"]]);
-		} catch (e) {
-			_h3ravel_shared.Logger.parse([
-				["An error occured", "bgRed"],
-				[e.message, "red"],
-				[e.stack, "red"]
-			], "\n");
-		}
-		return this;
-	}
-	/**
-	* Run the given array of bootstrap classes.
-	*
-	* @param bootstrappers
-	*/
-	async bootstrapWith(bootstrappers) {
-		for (const bootstrapper of bootstrappers) {
-			if (this.has("app.events")) this.make("app.events").dispatch("bootstrapping: " + bootstrapper.name, [this]);
-			await this.make(bootstrapper).bootstrap(this);
-			if (this.has("app.events")) this.make("app.events").dispatch("bootstrapped: " + bootstrapper.name, [this]);
-		}
-		this.bootstrapped = true;
-	}
-	/**
-	* Determine if the application has been bootstrapped before.
-	*/
-	hasBeenBootstrapped() {
-		return this.bootstrapped;
-	}
-	/**
-	* Save the current H3 app instance for possible future use.
-	*
-	* @param h3App The current H3 app instance
-	* @returns 
-	*/
-	setH3App(h3App) {
-		this.h3App = h3App;
-		return this;
-	}
-	/**
-	* Get the current H3 app instance.
-	*
-	* @returns 
-	*/
-	getH3App() {
-		return this.h3App;
-	}
-	/**
-	* Set the HttpContext.
-	*
-	* @param  ctx
-	*/
-	setHttpContext(ctx) {
-		this.httpContext = ctx;
-		return this;
-	}
-	getHttpContext(key) {
-		return key ? this.httpContext?.[key] : this.httpContext;
-	}
-	/**
-	* Get the application namespace.
-	*
-	* @throws {RuntimeException}
-	*/
-	getNamespace() {
-		if (this.namespace != null) return this.namespace;
-		const pkg = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href)(node_path.default.join(process.cwd(), "package.json"));
-		for (const [namespace, pathChoice] of Object.entries((0, _h3ravel_support.data_get)(pkg, "autoload.namespaces"))) if (this.getPath("app", "/") === this.getPath("src", pathChoice)) return this.namespace = namespace;
-		throw new _h3ravel_support.RuntimeException("Unable to detect application namespace.");
-	}
-	/**
-	* Get the path of the app dir
-	* 
-	* @returns 
-	*/
-	path() {
-		return this.getPath("app");
-	}
-	/**
-	* Get the base path of the app
-	* 
-	* @returns 
-	*/
-	getBasePath() {
-		return this.basePath;
-	}
-	/**
-	* 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, suffix) {
-		return node_path.default.join(this.paths.getPath(name, this.basePath), suffix ?? "");
-	}
-	/**
-	* Programatically set the paths.
-	*
-	* @param name - The base name of the path property
-	* @param path - The new path
-	* @returns 
-	*/
-	setPath(name, path) {
-		return this.paths.setPath(name, path, this.basePath);
-	}
-	/**
-	* Returns the installed version of the system core and typescript.
-	*
-	* @returns 
-	*/
-	getVersion(key) {
-		return this.versions[key]?.replaceAll(/\^|~/g, "");
-	}
-	/**
-	* Returns the installed version of the system core and typescript.
-	*
-	* @returns 
-	*/
-	static getVersion(key) {
-		return this.versions[key]?.replaceAll(/\^|~/g, "");
-	}
-};
-//#endregion
-//#region src/Controller.ts
-/**
-* Base controller class
-*/
-var Controller = class extends _h3ravel_contracts.IController {
-	app;
-	constructor(app) {
-		super();
-		this.app = app;
-	}
-};
-//#endregion
-//#region src/H3ravel.ts
-/**
-* Simple global entry point for H3ravel applications
-* 
-* @param providers 
-* @param basePath 
-* @param callback 
-*/
-const h3ravel = async (providers = [], basePath = process.cwd(), config = {
-	initialize: false,
-	autoload: false,
-	filteredProviders: []
-}) => {
-	let h3App;
-	const app = new Application(basePath, "h3ravel");
-	if (config.customPaths) for (const [name, path] of Object.entries(config.customPaths)) app.setPath(name, path);
-	app.initialize(providers, config.filteredProviders, config.autoload);
-	try {
-		h3App = app.make("http.app");
-		app.setH3App(h3App);
-		app.singleton(_h3ravel_contracts.IApplication, () => app);
-		if (!_h3ravel_support_facades.Facades.getApplication()) _h3ravel_support_facades.Facades.setApplication(app);
-		if (!_h3ravel_foundation.Helpers.isLoaded()) _h3ravel_foundation.Helpers.load(app);
-		await app.handleRequest(config);
-	} catch {
-		if (!h3App && config.h3) h3App = config.h3;
-	}
-	if (config.initialize && h3App) return await app.fire(h3App);
-	return app.setH3App(h3App);
-};
-//#endregion
-//#region src/Http/Kernel.ts
-/**
-* Kernel class handles middleware execution and response transformations.
-* It acts as the core middleware pipeline for HTTP requests.
-*/
-var Kernel = class {
-	app;
-	middleware;
-	/**
-	* The router instance.
-	*/
-	router;
-	/**
-	* A factory function that converts an H3Event into an HttpContext.
-	*/
-	context;
-	applicationContext;
-	/**
-	* @param app - The current application instance
-	* @param middleware - An array of middleware classes that will be executed in sequence.
-	*/
-	constructor(app, middleware = []) {
-		this.app = app;
-		this.middleware = middleware;
-		this.router = app.make("router");
-		this.context = async (event) => app.context(event);
-	}
-	/**
-	* 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.
-	*/
-	async handle(event, next) {
-		const { request } = await this.app.context(event);
-		/**
-		* Convert the raw event into a standardized HttpContext
-		*/
-		this.applicationContext = await this.context(event);
-		/**
-		* Bind HttpContext, request, and response to the container
-		*/
-		this.app.bind("http.context", () => this.applicationContext);
-		this.app.bind("http.request", () => this.applicationContext.request);
-		this.app.bind("http.response", () => this.applicationContext.response);
-		this.app.middlewareHandler = this.app.has(_h3ravel_foundation.MiddlewareHandler) ? this.app.make(_h3ravel_foundation.MiddlewareHandler) : new _h3ravel_foundation.MiddlewareHandler([], this.app);
-		request.constructor.enableHttpMethodParameterOverride();
-		/**
-		* Run middleware stack and obtain result
-		*/
-		const result = await this.app.middlewareHandler.register(this.middleware).run(this.applicationContext, next);
-		/**
-		* If a plain object is returned from a controller or middleware,
-		* automatically set the JSON Content-Type header for the response.
-		*/
-		if (result !== void 0 && _h3ravel_support.Obj.isPlainObject(result, true) && !result?.headers) event.res.headers.set("Content-Type", "application/json; charset=UTF-8");
-		return result;
-	}
-	/**
-	* Resolve the provided callback using the current H3 event instance 
-	*/
-	async resolve(event, middleware, handler) {
-		const { Response } = await import("@h3ravel/http");
-		this.middleware = Array.from(new Set([...this.middleware, ..._h3ravel_support.Arr.wrap(middleware)]));
-		return this.handle(event, (ctx) => new Promise((resolve) => {
-			if (_h3ravel_shared.Resolver.isAsyncFunction(handler)) handler(ctx).then((response) => {
-				if (response instanceof Response) resolve(response.prepare(ctx.request).send());
-				else resolve(response);
-			});
-			else resolve(handler(ctx));
-		}));
-	}
-};
-//#endregion
-exports.Application = Application;
-exports.Container = Container;
-exports.ContainerResolver = ContainerResolver;
-exports.Controller = Controller;
-exports.CoreServiceProvider = CoreServiceProvider;
-Object.defineProperty(exports, "Inject", {
-	enumerable: true,
-	get: function() {
-		return _h3ravel_foundation.Inject;
-	}
-});
-Object.defineProperty(exports, "Injectable", {
-	enumerable: true,
-	get: function() {
-		return _h3ravel_foundation.Injectable;
-	}
-});
-exports.Kernel = Kernel;
-exports.ProviderRegistry = ProviderRegistry;
-exports.Registerer = Registerer;
-Object.defineProperty(exports, "ServiceProvider", {
-	enumerable: true,
-	get: function() {
-		return _h3ravel_support.ServiceProvider;
-	}
-});
-exports.h3ravel = h3ravel;