@h3ravel/foundation 1.29.0-alpha.15 → 2.0.0-alpha.16

package/dist/index.d.ts

@@ -1,7 +1,10 @@
 /// <reference path="./app.globals.d.ts" />
-import { CKernel, CacheOptions, CallableConstructor, ConcreteConstructor, ExceptionConditionCallback, ExceptionConstructor, IApplication, IBootstraper, IExceptionHandler, IHttpContext, IKernel, IMiddleware, IMiddlewareHandler, IModel, IRequest, IResponse, IRoute, IRouter, MiddlewareList, RateLimiterAdapter, RedirectHandler, RenderExceptionCallback, ReportExceptionCallback, ThrottleExceptionCallback } from "@h3ravel/contracts";
+import { CKernel, CONTAINER_TOKEN, CacheOptions, CallableConstructor, ConcreteConstructor, ExceptionConditionCallback, ExceptionConstructor, IApplication, IBootstraper, IExceptionHandler, IHttpContext, IKernel, IMiddleware, IMiddlewareHandler, IModel, IRequest, IResponse, IRoute, IRouter, MiddlewareList, RateLimiterAdapter, RedirectHandler, RenderExceptionCallback, ReportExceptionCallback, ThrottleExceptionCallback } from "@h3ravel/contracts";
 import { Collection, DateTime, InvalidArgumentException } from "@h3ravel/support";
 import { Command, Kernel as Kernel$1 } from "@h3ravel/musket";
+import { Console } from "@h3ravel/shared";
+import { Application } from "@h3ravel/core";
+import { Method, PRequest } from "parasito";
 import { UserConfig } from "tsdown";
 import { DriverContract, ObjectMetaData, ObjectVisibility, SignedURLOptions, WriteOptions } from "flydrive/types";
 import { FSDriver } from "flydrive/drivers/fs";
@@ -10,9 +13,7 @@ import { DriveDirectory, DriveFile, DriveManager } from "flydrive";
 import { Readable } from "node:stream";
 import { S3Driver } from "flydrive/drivers/s3";
 import { GCSDriverOptions } from "flydrive/drivers/gcs/types";
-import { Application } from "@h3ravel/core";
 import { H3 } from "h3";
-import { Console } from "@h3ravel/shared";
 
 //#region src/Helpers.d.ts
 declare class Helpers {
@@ -645,7 +646,7 @@ declare class ConsoleKernel extends CKernel {
   /**
    * Discover the commands that should be automatically loaded.
    */
-  protected discoverCommands(): void;
+  protected discoverCommands(): Promise<void>;
   /**
    * Set the paths that should have their Musket commands automatically discovered.
    *
@@ -1026,6 +1027,7 @@ interface FilesystemConfig {
 //#endregion
 //#region src/Filesystem/IFilesystemManager.d.ts
 declare abstract class IFilesystemManager<D extends keyof KnownDisks | keyof CustomDiskDriverRegistry = keyof KnownDisks | keyof CustomDiskDriverRegistry> implements DriverContract {
+  static readonly [CONTAINER_TOKEN]: symbol;
   abstract driver: DriveManager<any>;
   abstract services: Record<string, () => DriverContract>;
   abstract diskName: D;
@@ -1638,7 +1640,79 @@ declare const statusTexts: {
 };
 //#endregion
 //#region src/Testing/testApp.d.ts
-declare const testApp: (app?: Application) => Promise<H3>;
+declare class TestClient<TBody = any> {
+  private readonly app;
+  constructor(app: H3);
+  /**
+   * Creates a new request builder for an application instance
+   *
+   * @returns
+   */
+  request<TResponse = TBody>(): PRequest<TResponse>;
+  /**
+   * Sets the request method to GET and updates the target path.
+   *
+   * @param path
+   * @returns
+   */
+  get<TResponse = TBody>(path: string): PRequest<TResponse>;
+  /**
+   * Sets the request method to POST and updates the target path.
+   *
+   * @param path
+   * @returns
+   */
+  post<TResponse = TBody>(path: string): PRequest<TResponse>;
+  /**
+   * Sets the request method to PUT and updates the target path.
+   *
+   * @param path
+   * @returns
+   */
+  put<TResponse = TBody>(path: string): PRequest<TResponse>;
+  /**
+   * Sets the request method to PATCH and updates the target path.
+   *
+   * @param path
+   * @returns
+   */
+  patch<TResponse = TBody>(path: string): PRequest<TResponse>;
+  /**
+   * Sets the request method to DELETE and updates the target path.
+   *
+   * @param path
+   * @returns
+   */
+  delete<TResponse = TBody>(path: string): PRequest<TResponse>;
+  /**
+   * Sets the request method to HEAD and updates the target path.
+   *
+   * @param path
+   * @returns
+   */
+  head<TResponse = TBody>(path: string): PRequest<TResponse>;
+  /**
+   * Sets the request method to OPTIONS and updates the target path.
+   *
+   * @param path
+   * @returns
+   */
+  options<TResponse = TBody>(path: string): PRequest<TResponse>;
+  /**
+   * Sets the HTTP method and path for the request.
+   *
+   * @param path
+   * @returns
+   */
+  method<TResponse = TBody>(method: Method, path: string): PRequest<TResponse>;
+}
+/**
+ * Create a new test client
+ *
+ * @param app
+ * @returns
+ */
+declare const testApp: <TBody = any>(app?: Application) => Promise<TestClient<TBody>>;
 //#endregion
 //#region src/Testing/TestApplication.d.ts
 declare class TestApplication {
@@ -1648,7 +1722,7 @@ declare class TestApplication {
    * @returns
    */
   init(cwd?: string): Promise<Application>;
-  configure(app: Application): any;
+  configure(app: Application, basePath?: string): any;
 }
 //#endregion
 //#region src/Console/Commands/BuildCommand.d.ts
@@ -1824,7 +1898,7 @@ declare abstract class Handler extends IExceptionHandler {
   /**
    * A map of exceptions with their corresponding custom log levels.
    */
-  protected levels: Map<string | Error, "log" | "debug" | "warn" | "info" | "error">;
+  protected levels: Map<string | Error, "debug" | "info" | "warn" | "error" | "log">;
   /**
    * Internal exceptions that are not reported by default. Subclasses may expand.
    */
@@ -2224,7 +2298,7 @@ declare class HttpException extends Error {
   protected headers: Record<string, string>;
   code: number;
   constructor(statusCode: number, message?: string, previous?: Error | undefined, headers?: Record<string, string>, code?: number);
-  static fromStatusCode(statusCode: number, message?: string, previous?: Error, headers?: Record<string, string>, code?: number): NotAcceptableHttpException | ConflictHttpException | GoneHttpException | LengthRequiredHttpException | NotFoundHttpException | LockedHttpException | PreconditionFailedHttpException | UnsupportedMediaTypeHttpException | BadRequestHttpException | PreconditionRequiredHttpException | ServiceUnavailableHttpException | TooManyRequestsHttpException | UnprocessableEntityHttpException | AccessDeniedHttpException | HttpException;
+  static fromStatusCode(statusCode: number, message?: string, previous?: Error, headers?: Record<string, string>, code?: number): ConflictHttpException | ServiceUnavailableHttpException | GoneHttpException | LengthRequiredHttpException | LockedHttpException | NotAcceptableHttpException | NotFoundHttpException | PreconditionFailedHttpException | PreconditionRequiredHttpException | TooManyRequestsHttpException | UnprocessableEntityHttpException | UnsupportedMediaTypeHttpException | BadRequestHttpException | AccessDeniedHttpException | HttpException;
   getStatusCode(): number;
   getHeaders(): Record<string, string>;
   setHeaders(headers: Record<string, string>): void;
@@ -2265,4 +2339,4 @@ declare class RequestHandled {
   constructor(request: IRequest, response?: IResponse);
 }
 //#endregion
-export { AccessDeniedHttpException, AppBuilder, BadRequestHttpException, BindingResolutionException, BootProviders, BuildCommand, CommandNotFoundException, ConfigException, ConflictHttpException, ConsoleKernel, CustomDiskConfig, CustomDiskDriverRegistry, DiskConfig, DriverConfig, ExceptionHandler, Exceptions, FileLike, FilesystemConfig, FtpDiskDriverConfig, GcsDiskDriverConfig, GoneHttpException, HTTP_RESPONSE_CACHE_CONTROL_DIRECTIVES, Handler, Helpers, HttpException, HttpExceptionFactory, IFilesystemDriver, IFilesystemManager, IFtpDiskDriver, InMemoryRateLimiter, Inject, Injectable, Kernel, KeyGenerateCommand, KnownDisks, LengthRequiredHttpException, LocalDiskDriverConfig, LockedHttpException, LogicException, MakeCommand, Middleware, MiddlewareHandler, ModelNotFoundException, NotAcceptableHttpException, NotFoundHttpException, PostinstallCommand, PreconditionFailedHttpException, PreconditionRequiredHttpException, RecordNotFoundException, RecordsNotFoundException, RegisterFacades, RequestException, RequestHandled, ResponseCodes, RouteNotFoundException, S3DiskDriverConfig, ServiceUnavailableHttpException, Terminating, TestApplication, TooManyRequestsHttpException, TsDownConfig, UnprocessableEntityHttpException, UnsupportedMediaTypeHttpException, UrlGenerationException, altLogo, logo, statusTexts, testApp };
+export { AccessDeniedHttpException, AppBuilder, BadRequestHttpException, BindingResolutionException, BootProviders, BuildCommand, CommandNotFoundException, ConfigException, ConflictHttpException, ConsoleKernel, CustomDiskConfig, CustomDiskDriverRegistry, DiskConfig, DriverConfig, ExceptionHandler, Exceptions, FileLike, FilesystemConfig, FtpDiskDriverConfig, GcsDiskDriverConfig, GoneHttpException, HTTP_RESPONSE_CACHE_CONTROL_DIRECTIVES, Handler, Helpers, HttpException, HttpExceptionFactory, IFilesystemDriver, IFilesystemManager, IFtpDiskDriver, InMemoryRateLimiter, Inject, Injectable, Kernel, KeyGenerateCommand, KnownDisks, LengthRequiredHttpException, LocalDiskDriverConfig, LockedHttpException, LogicException, MakeCommand, Middleware, MiddlewareHandler, ModelNotFoundException, NotAcceptableHttpException, NotFoundHttpException, PostinstallCommand, PreconditionFailedHttpException, PreconditionRequiredHttpException, RecordNotFoundException, RecordsNotFoundException, RegisterFacades, RequestException, RequestHandled, ResponseCodes, RouteNotFoundException, S3DiskDriverConfig, ServiceUnavailableHttpException, Terminating, TestApplication, TestClient, TooManyRequestsHttpException, TsDownConfig, UnprocessableEntityHttpException, UnsupportedMediaTypeHttpException, UrlGenerationException, altLogo, logo, statusTexts, testApp };

package/dist/index.js

@@ -1,9 +1,9 @@
-import { CKernel, IApplication, IBootstraper, IExceptionHandler, IKernel, IRouter, IUrlGenerator } from "@h3ravel/contracts";
+import { CKernel, CONTAINER_TOKEN, IApplication, IBootstraper, IExceptionHandler, IKernel, IRouter, IUrlGenerator, createContainerToken } from "@h3ravel/contracts";
 import { Facades, Route } from "@h3ravel/support/facades";
 import { Arr, AssetsServiceProvider, Collection, DateTime, InvalidArgumentException, RouteServiceProvider, Str, isClass } from "@h3ravel/support";
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { Command, Kernel as Kernel$1 } from "@h3ravel/musket";
-import { Console, FileSystem, Logger, TaskManager, mix, use } from "@h3ravel/shared";
+import { Console, FileSystem, Logger, TaskManager, importFile, mix, use } from "@h3ravel/shared";
 import { execa } from "execa";
 import preferredPM from "preferred-pm";
 import { ContainerResolver, h3ravel } from "@h3ravel/core";
@@ -12,10 +12,21 @@ import crypto from "crypto";
 import dotenv from "dotenv";
 import { mkdir, readFile as readFile$1, rm, writeFile as writeFile$1 } from "node:fs/promises";
 import path from "node:path";
-import { createRequire } from "module";
 import run from "@rollup/plugin-run";
 import { InteractsWithTime } from "@h3ravel/support/traits";
-import { H3 } from "h3";
+import request from "parasito";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
 //#region src/Helpers.ts
 var Helpers = class {
 	static app;
@@ -898,7 +909,7 @@ var BuildCommand = class BuildCommand extends Command {
 			"tsdown",
 			silent,
 			"--config-loader",
-			"unrun",
+			"native",
 			"-c",
 			"tsdown.default.config.ts"
 		].filter((e) => e !== null), {
@@ -913,7 +924,7 @@ var BuildCommand = class BuildCommand extends Command {
 				"tsdown",
 				silent,
 				"--config-loader",
-				"unrun",
+				"native",
 				"-c",
 				"tsdown.default.config.ts"
 			].filter((e) => e !== null), {
@@ -1347,7 +1358,7 @@ let ConsoleKernel = _ConsoleKernel = class ConsoleKernel extends CKernel {
 		if (!this.app.hasBeenBootstrapped()) await this.app.bootstrapWith(this.bootstrappers());
 		if (!this.commandsLoaded) {
 			this.registerCommands();
-			if (this.shouldDiscoverCommands()) this.discoverCommands();
+			if (this.shouldDiscoverCommands()) await this.discoverCommands();
 			this.commandsLoaded = true;
 		}
 	}
@@ -1364,14 +1375,14 @@ let ConsoleKernel = _ConsoleKernel = class ConsoleKernel extends CKernel {
 	/**
 	* Discover the commands that should be automatically loaded.
 	*/
-	discoverCommands() {
-		const require = createRequire(import.meta.url);
+	async discoverCommands() {
 		this.getConsole().registerDiscoveryPath(Array.from(this.commandPaths));
 		for (let path of this.commandRoutePaths) {
-			path = path.replace("/src/", this.DIST_DIR);
+			if (process.env.NODE_ENV === "production") path = path.replace("/src/", this.DIST_DIR).replace(/\.(ts|tsx|mts|cts)$/, ".js");
 			if (existsSync(path)) {
+				const route = await importFile(path);
 				class RouteCommand extends Command {
-					handle = require(path).default;
+					handle = route.default;
 				}
 				this.getConsole().registerCommands([RouteCommand]);
 			}
@@ -1384,8 +1395,9 @@ let ConsoleKernel = _ConsoleKernel = class ConsoleKernel extends CKernel {
 	*/
 	addCommandPaths(paths) {
 		paths.forEach((e) => {
-			e = e.replace("/src/", this.DIST_DIR);
-			this.commandPaths.add(statSync(e, { throwIfNoEntry: false })?.isFile() ? e : e + "*.js");
+			if (process.env.NODE_ENV === "production") e = e.replace("/src/", this.DIST_DIR);
+			const extension = process.env.NODE_ENV === "production" ? "*.js" : "*.{ts,js}";
+			this.commandPaths.add(statSync(e, { throwIfNoEntry: false })?.isFile() ? e : e + extension);
 		});
 		return this;
 	}
@@ -1676,7 +1688,9 @@ var UrlGenerationException = class UrlGenerationException extends Error {
 var IFilesystemDriver = class {};
 //#endregion
 //#region src/Filesystem/IFilesystemManager.ts
-var IFilesystemManager = class {};
+var IFilesystemManager = class {
+	static [CONTAINER_TOKEN] = createContainerToken("Foundation.IFilesystemManager");
+};
 //#endregion
 //#region src/Filesystem/IFtpDiskDriver.ts
 var IFtpDiskDriver = class {};
@@ -2313,7 +2327,111 @@ const statusTexts = {
 	511: "Network Authentication Required"
 };
 //#endregion
+//#region src/Testing/testApp.ts
+var TestClient = class {
+	app;
+	constructor(app) {
+		this.app = app;
+	}
+	/**
+	* Creates a new request builder for an application instance
+	*
+	* @returns
+	*/
+	request() {
+		return request(this.app);
+	}
+	/**
+	* Sets the request method to GET and updates the target path.
+	*
+	* @param path
+	* @returns
+	*/
+	get(path) {
+		return this.request().get(path);
+	}
+	/**
+	* Sets the request method to POST and updates the target path.
+	*
+	* @param path
+	* @returns
+	*/
+	post(path) {
+		return this.request().post(path);
+	}
+	/**
+	* Sets the request method to PUT and updates the target path.
+	*
+	* @param path
+	* @returns
+	*/
+	put(path) {
+		return this.request().put(path);
+	}
+	/**
+	* Sets the request method to PATCH and updates the target path.
+	*
+	* @param path
+	* @returns
+	*/
+	patch(path) {
+		return this.request().patch(path);
+	}
+	/**
+	* Sets the request method to DELETE and updates the target path.
+	*
+	* @param path
+	* @returns
+	*/
+	delete(path) {
+		return this.request().delete(path);
+	}
+	/**
+	* Sets the request method to HEAD and updates the target path.
+	*
+	* @param path
+	* @returns
+	*/
+	head(path) {
+		return this.request().head(path);
+	}
+	/**
+	* Sets the request method to OPTIONS and updates the target path.
+	*
+	* @param path
+	* @returns
+	*/
+	options(path) {
+		return this.request().options(path);
+	}
+	/**
+	* Sets the HTTP method and path for the request.
+	*
+	* @param path
+	* @returns
+	*/
+	method(method, path) {
+		return this.request().method(method, path);
+	}
+};
+/**
+* Create a new test client
+*
+* @param app
+* @returns
+*/
+const testApp = async (app) => {
+	if (!app) {
+		const { TestApplication } = await Promise.resolve().then(() => TestApplication_exports);
+		app = await new TestApplication().init();
+	}
+	const h3App = app.getH3App();
+	if (!h3App) throw new Error("Unable to create a test client because the application has no H3 instance.");
+	return new TestClient(h3App);
+};
+//#endregion
 //#region src/Testing/TestApplication.ts
+var TestApplication_exports = /* @__PURE__ */ __exportAll({ TestApplication: () => TestApplication });
 var TestApplication = class {
 	/**
 	* Initialize the app without firing up the dev server
@@ -2321,29 +2439,27 @@ var TestApplication = class {
 	* @returns 
 	*/
 	async init(cwd) {
-		const app = await h3ravel(await import(path.join(cwd ?? process.cwd(), "src/bootstrap/providers")), process.cwd(), {
+		const basePath = cwd ?? process.cwd();
+		const providersModule = await importFile(path.join(basePath, "src/bootstrap/providers.ts"));
+		const providers = providersModule.default ?? providersModule;
+		if (!Array.isArray(providers)) throw new TypeError("The application providers module must export an array as its default export.");
+		const app = await h3ravel(providers, basePath, {
 			autoload: true,
 			initialize: false
 		});
-		this.configure(app);
+		this.configure(app, basePath);
 		return await app.boot();
 	}
-	configure(app) {
+	configure(app, basePath = process.cwd()) {
 		return app.configure().withRouting({
-			web: path.join(process.cwd(), "src/routes/web.ts"),
-			api: path.join(process.cwd(), "src/routes/api.ts")
+			web: path.join(basePath, "src/routes/web.ts"),
+			api: path.join(basePath, "src/routes/api.ts")
 		}).withExceptions((exceptions) => {
-			return exceptions.report((_error) => {}).dontReport([UnprocessableEntityHttpException]).truncateRequestExceptionsAt(200);
+			return exceptions.report((error) => {}).dontReport([UnprocessableEntityHttpException]).truncateRequestExceptionsAt(200);
 		}).withMiddleware(() => {});
 	}
 };
 //#endregion
-//#region src/Testing/testApp.ts
-const testApp = async (app) => {
-	if (!app) app = await new TestApplication().init();
-	return app?.getH3App() ?? new H3();
-};
-//#endregion
 //#region src/Database/Exceptions/RecordsNotFoundException.ts
 var RecordsNotFoundException = class extends NotFoundHttpException {};
 //#endregion
@@ -3210,4 +3326,4 @@ var LogicException = class extends Error {
 	}
 };
 //#endregion
-export { AccessDeniedHttpException, AppBuilder, BadRequestHttpException, BindingResolutionException, BootProviders, BuildCommand, CommandNotFoundException, ConfigException, ConflictHttpException, ConsoleKernel, ExceptionHandler, Exceptions, GoneHttpException, HTTP_RESPONSE_CACHE_CONTROL_DIRECTIVES, Handler, Helpers, HttpException, HttpExceptionFactory, IFilesystemDriver, IFilesystemManager, IFtpDiskDriver, InMemoryRateLimiter, Inject, Injectable, Kernel, KeyGenerateCommand, LengthRequiredHttpException, LockedHttpException, LogicException, MakeCommand, Middleware, MiddlewareHandler, ModelNotFoundException, NotAcceptableHttpException, NotFoundHttpException, PostinstallCommand, PreconditionFailedHttpException, PreconditionRequiredHttpException, RecordNotFoundException, RecordsNotFoundException, RegisterFacades, RequestException, RequestHandled, ResponseCodes, RouteNotFoundException, ServiceUnavailableHttpException, Terminating, TestApplication, TooManyRequestsHttpException, TsDownConfig, UnprocessableEntityHttpException, UnsupportedMediaTypeHttpException, UrlGenerationException, altLogo, logo, statusTexts, testApp };
+export { AccessDeniedHttpException, AppBuilder, BadRequestHttpException, BindingResolutionException, BootProviders, BuildCommand, CommandNotFoundException, ConfigException, ConflictHttpException, ConsoleKernel, ExceptionHandler, Exceptions, GoneHttpException, HTTP_RESPONSE_CACHE_CONTROL_DIRECTIVES, Handler, Helpers, HttpException, HttpExceptionFactory, IFilesystemDriver, IFilesystemManager, IFtpDiskDriver, InMemoryRateLimiter, Inject, Injectable, Kernel, KeyGenerateCommand, LengthRequiredHttpException, LockedHttpException, LogicException, MakeCommand, Middleware, MiddlewareHandler, ModelNotFoundException, NotAcceptableHttpException, NotFoundHttpException, PostinstallCommand, PreconditionFailedHttpException, PreconditionRequiredHttpException, RecordNotFoundException, RecordsNotFoundException, RegisterFacades, RequestException, RequestHandled, ResponseCodes, RouteNotFoundException, ServiceUnavailableHttpException, Terminating, TestApplication, TestClient, TooManyRequestsHttpException, TsDownConfig, UnprocessableEntityHttpException, UnsupportedMediaTypeHttpException, UrlGenerationException, altLogo, logo, statusTexts, testApp };

package/package.json

@@ -1,11 +1,9 @@
 {
   "name": "@h3ravel/foundation",
-  "version": "1.29.0-alpha.15",
+  "version": "2.0.0-alpha.16",
   "description": "H3ravel Foundation for shared and reuseable services.",
   "type": "module",
-  "main": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
-  "module": "./dist/index.js",
   "exports": {
     ".": {
       "import": "./dist/index.js",
@@ -55,19 +53,18 @@
     }
   },
   "devDependencies": {
-    "@h3ravel/contracts": "^1.29.0-alpha.15",
-    "@types/supertest": "^6.0.3",
-    "supertest": "^7.1.4"
+    "@h3ravel/contracts": "^2.0.0-alpha.16"
   },
   "dependencies": {
-    "@h3ravel/musket": "^1.29.0-alpha.11",
-    "@h3ravel/shared": "^1.29.0-alpha.15",
-    "@h3ravel/support": "^1.29.0-alpha.15",
-    "h3": "2.0.1-rc.5"
+    "@h3ravel/musket": "^1.29.0-alpha.15",
+    "@h3ravel/shared": "^2.0.0-alpha.16",
+    "@h3ravel/support": "^2.0.0-alpha.16",
+    "h3": "2.0.1-rc.5",
+    "parasito": "^0.2.5"
   },
   "scripts": {
     "build": "tsdown --config-loader unrun",
-    "dev": "tsx watch src/index.ts",
+    "dev": "tsdown --watch --config-loader unrun",
     "start": "node dist/index.js",
     "lint": "eslint . --ext .ts",
     "test": "jest --passWithNoTests",