@h3ravel/support 0.15.6 → 0.16.0

package/dist/RuntimeException-CmsL83ow.cjs

@@ -0,0 +1,19 @@
+
+//#region src/Exceptions/RuntimeException.ts
+/**
+* Exception thrown if an error which can only be found on runtime occurs.
+*/
+var RuntimeException = class extends Error {
+	constructor(message = "") {
+		super(message);
+		this.name = "RuntimeException";
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'RuntimeException', {
+  enumerable: true,
+  get: function () {
+    return RuntimeException;
+  }
+});

package/dist/RuntimeException-CrNX0B-p.js

@@ -0,0 +1,13 @@
+//#region src/Exceptions/RuntimeException.ts
+/**
+* Exception thrown if an error which can only be found on runtime occurs.
+*/
+var RuntimeException = class extends Error {
+	constructor(message = "") {
+		super(message);
+		this.name = "RuntimeException";
+	}
+};
+
+//#endregion
+export { RuntimeException as t };

package/dist/chunk-NmTyJVUt.js

@@ -0,0 +1,20 @@
+import "node:module";
+
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __export = (all, symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+export { __export as t };

package/dist/facades.cjs

@@ -0,0 +1,111 @@
+const require_RuntimeException = require('./RuntimeException-CmsL83ow.cjs');
+const require_index = require('./index.cjs');
+let __h3ravel_foundation = require("@h3ravel/foundation");
+
+//#region src/Facades/Facades.ts
+var Facades = class {
+	/**
+	* The application instance being facaded.
+	*/
+	static app;
+	/**
+	* The resolved object instances.
+	*/
+	static resolvedInstance = /* @__PURE__ */ new Map();
+	/**
+	* Indicates if the resolved instance should be cached.
+	*/
+	static cached = true;
+	/**
+	* Called once during bootstrap
+	* 
+	* @param app 
+	*/
+	static setApplication(app) {
+		this.app = app;
+	}
+	/**
+	* Get the application instance behind the facade.
+	*/
+	static getApplication() {
+		return this.app;
+	}
+	/**
+	* Get the registered name of the component.
+	* Each facade must define its container key
+	*
+	* @return string
+	*
+	* @throws {RuntimeException}
+	*/
+	static getFacadeAccessor() {
+		throw new require_RuntimeException.RuntimeException("Facade accessor not implemented.");
+	}
+	/**
+	* Get the root object behind the facade.
+	*/
+	static getFacadeRoot() {
+		return this.resolveInstance(this.getFacadeAccessor());
+	}
+	/**
+	* Resolve the facade root instance from the container.
+	*
+	* @param  name
+	*/
+	static resolveInstance(name) {
+		if (this.resolvedInstance.has(name)) return this.resolvedInstance.get(name);
+		if (this.app) {
+			const instance = this.app.make(name);
+			if (this.cached) this.resolvedInstance.set(name, instance);
+			return instance;
+		}
+	}
+	/**
+	* Clear a resolved facade instance.
+	*
+	* @param  name
+	*/
+	static clearResolvedInstance(name) {
+		this.resolvedInstance.delete(name);
+	}
+	/**
+	* Clear all of the resolved instances.
+	*/
+	static clearResolvedInstances() {
+		this.resolvedInstance.clear();
+	}
+	/**
+	* Hotswap the underlying instance behind the facade.
+	*
+	* @param  instance
+	*/
+	static swap(instance) {
+		this.resolvedInstance.set(this.getFacadeAccessor(), instance);
+		if (this.app) this.app.instance(this.getFacadeAccessor(), instance);
+	}
+	static __callStatic(method, args) {
+		const instance = this.getFacadeRoot();
+		if (!instance) throw new Error("Facade root not resolved.");
+		if (typeof instance[method] === "function" && !(0, __h3ravel_foundation.isInternal)(instance, method)) return Reflect.apply(instance[method], instance, args);
+		if (typeof instance.__call === "function") return instance.__call(method, args);
+		throw new Error(`Method [${method}] does not exist on [${instance.constructor.name}] facade root.`);
+	}
+	static createFacade() {
+		return new Proxy({}, { get: (_target, prop) => {
+			return (...args) => this.__callStatic(prop, args);
+		} });
+	}
+};
+
+//#endregion
+//#region src/Facades/RouteFacade.ts
+var RouteFacade = class extends Facades {
+	static getFacadeAccessor() {
+		return "router";
+	}
+};
+const Route = RouteFacade.createFacade();
+
+//#endregion
+exports.Facades = Facades;
+exports.Route = Route;

package/dist/facades.d.ts

@@ -0,0 +1,70 @@
+import { ClassConstructor, ConcreteConstructor, IApplication, IBinding, IRouteRegistrar, IRouter } from "@h3ravel/contracts";
+
+//#region src/Facades/Facades.d.ts
+declare abstract class Facades {
+  /**
+   * The application instance being facaded.
+   */
+  protected static app?: IApplication;
+  /**
+   * The resolved object instances.
+   */
+  protected static resolvedInstance: Map<string | (new (...args: any[]) => unknown), any>;
+  /**
+   * Indicates if the resolved instance should be cached.
+   */
+  protected static cached: boolean;
+  /**
+   * Called once during bootstrap
+   *
+   * @param app
+   */
+  static setApplication(app: IApplication): void;
+  /**
+   * Get the application instance behind the facade.
+   */
+  static getApplication(): IApplication | undefined;
+  /**
+   * Get the registered name of the component.
+   * Each facade must define its container key
+   *
+   * @return string
+   *
+   * @throws {RuntimeException}
+   */
+  protected static getFacadeAccessor(): string;
+  /**
+   * Get the root object behind the facade.
+   */
+  static getFacadeRoot<T>(): any;
+  /**
+   * Resolve the facade root instance from the container.
+   *
+   * @param  name
+   */
+  static resolveInstance<T>(name: string | IBinding): any;
+  /**
+   * Clear a resolved facade instance.
+   *
+   * @param  name
+   */
+  static clearResolvedInstance(name: string | IBinding): void;
+  /**
+   * Clear all of the resolved instances.
+   */
+  static clearResolvedInstances(): void;
+  /**
+   * Hotswap the underlying instance behind the facade.
+   *
+   * @param  instance
+   */
+  static swap(instance: ConcreteConstructor<ClassConstructor>): void;
+  static __callStatic<T>(method: string, args: any[]): any;
+  static createFacade<T extends object>(): T;
+}
+//#endregion
+//#region src/Facades/RouteFacade.d.ts
+type FRoute = Omit<IRouter, 'group' | 'apiSingleton' | 'match' | 'resource' | 'apiResource' | 'singleton' | 'middleware'>;
+declare const Route: IRouteRegistrar & FRoute;
+//#endregion
+export { FRoute, Facades, Route };

package/dist/facades.js

@@ -0,0 +1,109 @@
+import { t as RuntimeException } from "./RuntimeException-CrNX0B-p.js";
+import { isInternal } from "@h3ravel/foundation";
+
+//#region src/Facades/Facades.ts
+var Facades = class {
+	/**
+	* The application instance being facaded.
+	*/
+	static app;
+	/**
+	* The resolved object instances.
+	*/
+	static resolvedInstance = /* @__PURE__ */ new Map();
+	/**
+	* Indicates if the resolved instance should be cached.
+	*/
+	static cached = true;
+	/**
+	* Called once during bootstrap
+	* 
+	* @param app 
+	*/
+	static setApplication(app) {
+		this.app = app;
+	}
+	/**
+	* Get the application instance behind the facade.
+	*/
+	static getApplication() {
+		return this.app;
+	}
+	/**
+	* Get the registered name of the component.
+	* Each facade must define its container key
+	*
+	* @return string
+	*
+	* @throws {RuntimeException}
+	*/
+	static getFacadeAccessor() {
+		throw new RuntimeException("Facade accessor not implemented.");
+	}
+	/**
+	* Get the root object behind the facade.
+	*/
+	static getFacadeRoot() {
+		return this.resolveInstance(this.getFacadeAccessor());
+	}
+	/**
+	* Resolve the facade root instance from the container.
+	*
+	* @param  name
+	*/
+	static resolveInstance(name) {
+		if (this.resolvedInstance.has(name)) return this.resolvedInstance.get(name);
+		if (this.app) {
+			const instance = this.app.make(name);
+			if (this.cached) this.resolvedInstance.set(name, instance);
+			return instance;
+		}
+	}
+	/**
+	* Clear a resolved facade instance.
+	*
+	* @param  name
+	*/
+	static clearResolvedInstance(name) {
+		this.resolvedInstance.delete(name);
+	}
+	/**
+	* Clear all of the resolved instances.
+	*/
+	static clearResolvedInstances() {
+		this.resolvedInstance.clear();
+	}
+	/**
+	* Hotswap the underlying instance behind the facade.
+	*
+	* @param  instance
+	*/
+	static swap(instance) {
+		this.resolvedInstance.set(this.getFacadeAccessor(), instance);
+		if (this.app) this.app.instance(this.getFacadeAccessor(), instance);
+	}
+	static __callStatic(method, args) {
+		const instance = this.getFacadeRoot();
+		if (!instance) throw new Error("Facade root not resolved.");
+		if (typeof instance[method] === "function" && !isInternal(instance, method)) return Reflect.apply(instance[method], instance, args);
+		if (typeof instance.__call === "function") return instance.__call(method, args);
+		throw new Error(`Method [${method}] does not exist on [${instance.constructor.name}] facade root.`);
+	}
+	static createFacade() {
+		return new Proxy({}, { get: (_target, prop) => {
+			return (...args) => this.__callStatic(prop, args);
+		} });
+	}
+};
+
+//#endregion
+//#region src/Facades/RouteFacade.ts
+var RouteFacade = class extends Facades {
+	static getFacadeAccessor() {
+		return "router";
+	}
+};
+const Route = RouteFacade.createFacade();
+
+//#endregion
+export { Facades, Route };