@arkstack/driver-h3 0.5.2 → 0.5.3

package/README.md

@@ -1,5 +1,7 @@
 # @arkstack/driver-h3
 
+[![@arkstack/driver-h3](https://img.shields.io/npm/dt/@arkstack/driver-h3?style=flat-square&label=@arkstack/driver-h3&link=https%3A%2F%2Fwww.npmjs.com%2Fpackage%2F@arkstack/driver-h3)](https://www.npmjs.com/package/@arkstack/driver-h3)
+
 H3 driver for Arkstack, providing H3-based runtime integration for the framework.
 
 ## Auth Middleware

package/dist/app.d.ts

@@ -0,0 +1,25 @@
+import type { H3Event } from 'h3'
+
+declare module '@arkstack/common' {
+    interface HookRegistry {
+        'middleware:auth': {
+            before: (event: H3Event) => void
+            after: (event: H3Event) => void
+            error: (error: unknown, event: H3Event) => void
+        }
+    }
+}
+
+declare module '@arkstack/foundry' {
+    interface HookRegistry {
+        'middleware:auth': {
+            before: (event: H3Event) => void
+            after: (event: H3Event) => void
+            error: (error: unknown, event: H3Event) => void
+        }
+    }
+}
+
+declare global {
+    var tunnelUrl: () => string
+}

package/dist/index-BZYQAccK.d.ts

@@ -0,0 +1,98 @@
+import { n as MiddlewareConfig, t as Middleware$2 } from "./types-DWUchLdg.js";
+import { ArkstackKitDriver, ArkstackRouteListOptions, PromiseOrValue } from "@arkstack/contract";
+import { H3, H3Event, HTTPError, HTTPResponse } from "h3";
+import { Router } from "clear-router/h3";
+import { H3App, Handler, HttpContext, Middleware as Middleware$1 } from "clear-router/types/h3";
+import { Route } from "clear-router";
+
+//#region src/error-handler.d.ts
+declare const defaultErrorHandler: (err: HTTPError | Error | string, event: H3Event) => Promise<HTTPResponse | {
+  error: boolean;
+  message: string;
+  status: "error";
+  code: number;
+  errors?: unknown;
+  stack?: string;
+}>;
+//#endregion
+//#region src/Router.d.ts
+declare class Router$1 extends Router {
+  static bind(app: H3): Promise<H3App>;
+  static list(_options: ArkstackRouteListOptions | undefined, app: H3): Promise<Route<HttpContext, Middleware$1, Handler>[]>;
+}
+//#endregion
+//#region src/index.d.ts
+type H3Middleware = Middleware$1 | [Middleware$1, Record<string, any>];
+interface H3DriverOptions {
+  bindRouter: (app: H3) => PromiseOrValue<void>;
+  mountPublicAssets?: (app: H3, publicPath: string) => PromiseOrValue<void>;
+  createApp?: () => H3;
+  onError?: (err: Error | string, event: H3Event) => unknown;
+}
+declare class H3EventResponse {
+  response: Response;
+  status: number;
+  statusText?: string;
+  constructor(response: Response);
+  get headers(): Headers;
+}
+/**
+ * The H3Driver class implements the ArkstackKitDriver contract for the H3 framework.
+ */
+declare class H3Driver extends ArkstackKitDriver<H3, H3Middleware> {
+  readonly name = "h3";
+  private tunnel_url?;
+  private readonly options;
+  /**
+   * Creates an instance of H3Driver.
+   *
+   * @param options
+   */
+  constructor(options: H3DriverOptions);
+  /**
+   * Creates an H3 application instance.
+   *
+   * @returns
+   */
+  createApp(): H3;
+  /**
+   * Mounts static assets from the specified public path to the H3 application.
+   *
+   * @param app
+   * @param publicPath
+   */
+  mountPublicAssets(app: H3, publicPath: string): PromiseOrValue<void>;
+  /**
+   * Binds the router to the H3 application using the provided bindRouter function.
+   *
+   * @param app
+   */
+  bindRouter(app: H3): PromiseOrValue<void>;
+  /**
+   * Applies middleware to the H3 application.
+   *
+   * @param app
+   * @param middleware
+   */
+  applyMiddleware(app: H3, middleware: H3Middleware | Middleware$2 | MiddlewareConfig): void;
+  /**
+   * If trafic has been proxied via ngrok, this will return the tunnel URL.
+   *
+   * @returns
+   */
+  geTunnelUrl(): string | undefined;
+  /**
+   * Starts the H3 server on the specified port.
+   *
+   * The bind host can be overridden with the `APP_HOST` (or `HOST`) env
+   * variable. It defaults to `0.0.0.0` so the server is reachable on all
+   * network interfaces, which platforms like Railway require for their
+   * healthcheck proxy to reach the app.
+   *
+   * @param app
+   * @param port
+   */
+  start(app: H3, port: number): Promise<void>;
+}
+//#endregion
+export { Router$1 as a, H3Middleware as i, H3DriverOptions as n, defaultErrorHandler as o, H3EventResponse as r, H3Driver as t };

package/dist/index.d.ts

@@ -1,2 +1,3 @@
-import { a as Router, i as H3Middleware, n as H3DriverOptions, o as defaultErrorHandler, r as H3EventResponse, t as H3Driver } from "./index-B3NOMsXC.js";
+/// <reference path="./app.d.ts" />
+import { a as Router, i as H3Middleware, n as H3DriverOptions, o as defaultErrorHandler, r as H3EventResponse, t as H3Driver } from "./index-BZYQAccK.js";
 export { H3Driver, H3DriverOptions, H3EventResponse, H3Middleware, Router, defaultErrorHandler };

package/dist/index.js

@@ -1,13 +1,32 @@
-import { t as staticAssetHandler } from "./middlewares-DIYzSTD5.js";
+import { t as staticAssetHandler } from "./middlewares-BORI5o6J.js";
 import { ArkstackKitDriver } from "@arkstack/contract";
 import { H3, HTTPResponse, serve, toResponse } from "h3";
-import { ErrorHandler, Logger, importFile, renderError } from "@arkstack/common";
-import { join } from "node:path";
+import { ErrorHandler, Logger, devTlsCredentials, env, localNetworkAddress, renderError, resolveRuntimeModule } from "@arkstack/common";
+import ngrok from "@ngrok/ngrok";
+import { resolveMiddleware } from "@arkstack/http";
+import { registerPlugin } from "resora";
 import { Router as Router$1 } from "clear-router/h3";
 import { clearRouterH3Plugin } from "@resora/plugin-clear-router";
-import { registerPlugin } from "resora";
 //#region src/error-handler.ts
-const defaultErrorHandler = (err, event) => {
+const webMiddlewareKey = Symbol.for("arkstack:http:web");
+const isRecord = (value) => {
+	return typeof value === "object" && value !== null;
+};
+const isWebRequest = (value) => {
+	if (!isRecord(value)) return false;
+	return value[webMiddlewareKey] === true || value.arkstackWeb === true || isWebRequest(value.context) || isWebRequest(value.req);
+};
+const redirectBackTarget = (event) => {
+	return event.req.headers.get("referer") || event.req.headers.get("referrer") || "/";
+};
+const flashValidationState = async (err, event, errors) => {
+	const session = event.httpSession ?? event.session ?? event.context?.httpSession ?? event.context?.session;
+	if (!session) return;
+	if (errors) session.addErrors?.(errors);
+	else session.addValidationErrors?.(err);
+	await session.save?.();
+};
+const defaultErrorHandler = async (err, event) => {
 	const responseBody = ErrorHandler.createErrorPayload(err);
 	if (ErrorHandler.shouldLogError(err)) ErrorHandler.logUnhandledError(err, {
 		headers: Object.fromEntries(event.req.headers.entries()),
@@ -17,7 +36,16 @@ const defaultErrorHandler = (err, event) => {
 	if (process.env.NODE_ENV === "development") console.error(responseBody);
 	const code = ErrorHandler.normalizeStatusCode(responseBody.code);
 	event.res.status = code;
-	if ((event.req.headers.get("accept") ?? "").includes("application/json") || event.req._url?.pathname?.startsWith("/api")) return {
+	const expectsJson = (event.req.headers.get("accept") ?? "").includes("application/json") || event.req._url?.pathname?.startsWith("/api");
+	if (code === 422 && !expectsJson && isWebRequest(event)) {
+		await flashValidationState(err, event, responseBody.errors);
+		event.res.status = 302;
+		return new HTTPResponse(null, {
+			status: 302,
+			headers: { Location: redirectBackTarget(event) }
+		});
+	}
+	if (expectsJson) return {
 		...responseBody,
 		error: true,
 		message: responseBody.message
@@ -38,12 +66,10 @@ Router$1.configure({ inferParamName: true });
 var Router = class extends Router$1 {
 	static async bind(app) {
 		try {
-			await Router$1.group("/api", async () => {
-				await importFile(join(process.cwd(), "src/routes/api.ts"));
-			});
-			await Router$1.group("/", async () => {
-				await importFile(join(process.cwd(), "src/routes/web.ts"));
-			});
+			await Router$1.group("/api", resolveRuntimeModule("src/routes/api.ts"));
+		} catch {}
+		try {
+			await Router$1.group("/", resolveRuntimeModule("src/routes/web.ts"));
 		} catch {}
 		return Router$1.apply(app);
 	}
@@ -72,6 +98,7 @@ var H3EventResponse = class {
 */
 var H3Driver = class extends ArkstackKitDriver {
 	name = "h3";
+	tunnel_url;
 	options;
 	/**
 	* Creates an instance of H3Driver.
@@ -118,12 +145,13 @@ var H3Driver = class extends ArkstackKitDriver {
 		const mw = Array.isArray(middleware) ? middleware[0] : middleware;
 		const conf = Array.isArray(middleware) && middleware[1] ? middleware[1] : {};
 		if (typeof mw === "function") {
-			app.use(mw, conf);
+			app.use(resolveMiddleware(mw), conf);
 			return;
 		}
 		for (const [pos, entries] of Object.entries(middleware)) for (const entry of entries) {
-			const mw = Array.isArray(entry) ? entry[0] : entry;
+			const instance = Array.isArray(entry) ? entry[0] : entry;
 			const conf = Array.isArray(entry) && entry[1] ? entry[1] : {};
+			const mw = resolveMiddleware(instance);
 			if (pos === "after") app.use(async (evt, next) => {
 				evt[Symbol.for("h3.internal.event.res")] = new H3EventResponse(await toResponse(await next(), evt));
 				await mw(evt, next);
@@ -133,21 +161,73 @@ var H3Driver = class extends ArkstackKitDriver {
 		}
 	}
 	/**
-	* Starts the H3 server on the specified port.
+	* If trafic has been proxied via ngrok, this will return the tunnel URL.
 	* 
-	* @param app 
-	* @param port 
+	* @returns 
+	*/
+	geTunnelUrl() {
+		return this.tunnel_url;
+	}
+	/**
+	* Starts the H3 server on the specified port.
+	*
+	* The bind host can be overridden with the `APP_HOST` (or `HOST`) env
+	* variable. It defaults to `0.0.0.0` so the server is reachable on all
+	* network interfaces, which platforms like Railway require for their
+	* healthcheck proxy to reach the app.
+	*
+	* @param app
+	* @param port
 	*/
-	start(app, port) {
-		serve(app, {
+	async start(app, port) {
+		const host = env("APP_HOST", env("HOST", "0.0.0.0"));
+		const secure = env("APP_SECURE", false) === true;
+		const tunneled = env("TUNNEL", false);
+		const scheme = secure ? "https" : "http";
+		const tls = secure ? await devTlsCredentials() : void 0;
+		await serve(app, {
 			port,
-			silent: true
-		}).ready().then(() => {
-			Logger.log([["Server is running on", "white"], [`http://localhost:${port}`, "cyan"]], " ");
-		});
+			hostname: host,
+			silent: true,
+			...tls ? {
+				protocol: "https",
+				tls: {
+					cert: tls.cert,
+					key: tls.key
+				}
+			} : {}
+		}).ready();
+		let log = startupLogLines(scheme, host, port);
+		if (tunneled === true) {
+			const url = (await ngrok.forward({
+				addr: port,
+				authtoken: env("NGROK_AUTHTOKEN"),
+				domain: env("NGROK_DOMAIN")
+			})).url();
+			if (url) {
+				log = log.concat(Logger.log([["Trafic has been tunnelled to", "white"], [url, "green"]], " ", false));
+				process.env.TUNNEL_URL = url;
+				this.tunnel_url = url;
+				globalThis.tunnelUrl = () => url;
+			}
+		}
+		console.log(log.join("\n"));
+	}
+};
+/**
+* Build the "Server is running" startup lines, adding a local-network URL when
+* the server is bound to all interfaces (`0.0.0.0`/`::`) so it is reachable from
+* other devices.
+*/
+const startupLogLines = (scheme, host, port) => {
+	const bindsAll = host === "0.0.0.0" || host === "::";
+	const localHost = bindsAll ? "localhost" : host;
+	const lines = [Logger.log([["Server is running on", "white"], [`${scheme}://${localHost}:${port}`, "cyan"]], " ", false)];
+	if (bindsAll) {
+		const address = localNetworkAddress();
+		if (address) lines.push(Logger.log([["Network access via", "white"], [`${scheme}://${address}:${port}`, "cyan"]], " ", false));
 	}
+	return lines;
 };
 //#endregion
 export { H3Driver, H3EventResponse, Router, defaultErrorHandler };
-
-//# sourceMappingURL=index.js.map

package/dist/middlewares/index.d.ts

@@ -1,10 +1,13 @@
-import { i as H3Middleware } from "../index-B3NOMsXC.js";
+import { i as H3Middleware } from "../index-BZYQAccK.js";
 import * as _$h3 from "h3";
-import { H3Event } from "h3";
+import { EventHandlerRequest, H3Event } from "h3";
 import { NextFunction } from "clear-router/types/h3";
 
 //#region src/middlewares/auth.d.ts
 declare const auth: (event: H3Event, next: () => unknown | Promise<unknown>) => Promise<unknown>;
+declare class AuthMiddleware {
+  handler(event: H3Event, next: () => unknown | Promise<unknown>): Promise<unknown>;
+}
 //#endregion
 //#region src/middlewares/cors.d.ts
 declare const cors: (options?: {
@@ -17,16 +20,75 @@ declare const cors: (options?: {
   optionsSuccessStatus?: number;
   preflightContinue?: boolean;
 }) => (event: H3Event, next: NextFunction) => Promise<void>;
+declare class CorsMiddleware {
+  private options;
+  constructor(options?: {
+    origin?: string | string[] | RegExp | boolean;
+    methods?: string[] | string;
+    allowedHeaders?: string[] | string | null;
+    exposedHeaders?: string[] | string;
+    credentials?: boolean;
+    maxAge?: number | string;
+    optionsSuccessStatus?: number;
+    preflightContinue?: boolean;
+  });
+  handler(event: H3Event<EventHandlerRequest>, next: NextFunction): Promise<void>;
+}
+//#endregion
+//#region src/middlewares/inertia.d.ts
+/**
+ * Bind the Inertia request context for H3.
+ *
+ * Normalizes the H3 event into the adapter's driver-agnostic shape and runs the
+ * downstream handler inside Inertia's async-local context (mirroring the `resora`
+ * middleware), so `inertia()` / `Inertia.*` resolve the active request.
+ *
+ * It also upgrades a `302` redirect returned for a `PUT`/`PATCH`/`DELETE` Inertia
+ * visit to `303 See Other`, which the Inertia client requires to follow the
+ * redirect with a `GET`. (Prefer `Inertia.redirect()` / `Inertia.back()`, which
+ * already emit the correct status.)
+ *
+ * `@arkstack/inertia` is imported dynamically so the package stays optional.
+ */
+declare const inertia: () => (event: H3Event, next: NextFunction) => Promise<unknown>;
+declare class InertiaMiddleware {
+  handler(event: H3Event, next: NextFunction): Promise<unknown>;
+}
 //#endregion
 //#region src/middlewares/request-logger.d.ts
+/**
+ * Middleware to log incoming requests and their response times.
+ *
+ * @param config Configuration options for the request logger middleware.
+ * @param config.allowInProduction If true, the logger will also log requests in production environment. Default is false.
+ * @returns H3Middleware function
+ */
 declare const requestLogger: ({
   allowInProduction
 }?: {
   allowInProduction?: boolean;
 }) => H3Middleware;
+declare class RequestLoggerMiddleware {
+  private options;
+  constructor(options?: {
+    allowInProduction?: boolean;
+  });
+  handler(): H3Middleware;
+}
+//#endregion
+//#region src/middlewares/resora.d.ts
+/**
+ * Apply the application's resora configuration (`src/config/resources.ts`) and
+ * bind the per-request `{ req, res }` context so Resources can build URLs and
+ * pagination links.
+ *
+ * Replaces the manual `Resource.setCtx(...)` wiring: resora's runtime config is
+ * applied from `config('resources')`, and the request is run within resora's
+ * async context so downstream handlers resolve the correct context.
+ */
+declare const resora: () => (event: H3Event, next: NextFunction) => Promise<unknown>;
 //#endregion
 //#region src/middlewares/static-asset-handler.d.ts
 declare const staticAssetHandler: (publicPath?: string) => (event: H3Event) => Promise<_$h3.HTTPResponse | undefined> | undefined;
 //#endregion
-export { auth, cors, requestLogger, staticAssetHandler };
-//# sourceMappingURL=index.d.ts.map
+export { AuthMiddleware, CorsMiddleware, InertiaMiddleware, RequestLoggerMiddleware, auth, cors, inertia, requestLogger, resora, staticAssetHandler };

package/dist/middlewares/index.js

@@ -1,2 +1,2 @@
-import { i as auth, n as requestLogger, r as cors, t as staticAssetHandler } from "../middlewares-DIYzSTD5.js";
-export { auth, cors, requestLogger, staticAssetHandler };
+import { a as InertiaMiddleware, c as cors, i as requestLogger, l as AuthMiddleware, n as resora, o as inertia, r as RequestLoggerMiddleware, s as CorsMiddleware, t as staticAssetHandler, u as auth } from "../middlewares-BORI5o6J.js";
+export { AuthMiddleware, CorsMiddleware, InertiaMiddleware, RequestLoggerMiddleware, auth, cors, inertia, requestLogger, resora, staticAssetHandler };

package/dist/{middlewares-DIYzSTD5.js → middlewares-BORI5o6J.js}

@@ -1,10 +1,13 @@
+import { Arkstack } from "@arkstack/contract";
 import { serveStatic } from "h3";
-import { Hook, Logger, nodeEnv } from "@arkstack/common";
-import { Auth, AuthenticationException } from "@arkstack/auth";
-import { readFile, stat } from "node:fs/promises";
+import { Logger, config, nodeEnv, resolveRuntimeDir } from "@arkstack/common";
+import { Hook } from "@arkstack/foundry";
+import { applyRuntimeConfig, getDefaultConfig, runWithCtx, setCtx } from "resora";
 import { join, resolve } from "node:path";
+import { readFile, stat } from "node:fs/promises";
 //#region src/middlewares/auth.ts
 const auth = async (event, next) => {
+	const { Auth, AuthenticationException } = await import("@arkstack/auth");
 	try {
 		const token = readBearerToken(event.req.headers.get("authorization"));
 		if (!token) throw new AuthenticationException("Unauthenticated", {
@@ -27,10 +30,12 @@ const auth = async (event, next) => {
 		const user = await auth.authorizeToken(token);
 		event.context.user = user;
 		event.context.auth = auth;
+		event.context.session = auth.session();
 		event.context.authUser = user;
 		event.context.authToken = token;
 		event.req.user = user;
 		event.req.auth = auth;
+		event.req.session = event.context.session;
 		event.req.authUser = user;
 		event.req.authToken = token;
 		if (Hook.has("middleware:auth", "after")) Hook.get("middleware:auth", "after")?.(event);
@@ -40,6 +45,11 @@ const auth = async (event, next) => {
 		throw error;
 	}
 };
+var AuthMiddleware = class {
+	handler(event, next) {
+		return auth(event, next);
+	}
+};
 const readBearerToken = (authorization) => {
 	if (!authorization?.startsWith("Bearer ")) return null;
 	return authorization.substring(7);
@@ -253,6 +263,52 @@ const cors = (options = {}) => async (event, next) => {
 		next();
 	}
 };
+var CorsMiddleware = class {
+	options;
+	constructor(options = {}) {
+		this.options = options;
+	}
+	handler(event, next) {
+		return cors(this.options).call(this.handler, event, next);
+	}
+};
+//#endregion
+//#region src/middlewares/inertia.ts
+/**
+* Bind the Inertia request context for H3.
+*
+* Normalizes the H3 event into the adapter's driver-agnostic shape and runs the
+* downstream handler inside Inertia's async-local context (mirroring the `resora`
+* middleware), so `inertia()` / `Inertia.*` resolve the active request.
+*
+* It also upgrades a `302` redirect returned for a `PUT`/`PATCH`/`DELETE` Inertia
+* visit to `303 See Other`, which the Inertia client requires to follow the
+* redirect with a `GET`. (Prefer `Inertia.redirect()` / `Inertia.back()`, which
+* already emit the correct status.)
+*
+* `@arkstack/inertia` is imported dynamically so the package stays optional.
+*/
+const inertia = () => {
+	return async (event, next) => {
+		const { runInertia, shouldUpgradeRedirect } = await import("@arkstack/inertia");
+		const sourceUrl = event.req._url ? event.req._url.pathname + event.req._url.search : event.req.url || "/";
+		const request = {
+			method: String(event.req.method ?? "GET").toUpperCase(),
+			url: sourceUrl,
+			header: (name) => event.req.headers.get(name) ?? void 0
+		};
+		return runInertia(request, async () => {
+			const result = await next();
+			if (request.header("x-inertia") === "true" && result && typeof result === "object" && typeof result.statusCode === "number" && shouldUpgradeRedirect(request.method, result.statusCode)) result.statusCode = 303;
+			return result;
+		});
+	};
+};
+var InertiaMiddleware = class {
+	handler(event, next) {
+		return inertia()(event, next);
+	}
+};
 //#endregion
 //#region src/middlewares/request-logger.ts
 const colors = {
@@ -270,7 +326,8 @@ const colors = {
 * @returns H3Middleware function
 */
 const requestLogger = ({ allowInProduction = false } = {}) => async (event, next) => {
-	if (nodeEnv() === "prod" && !allowInProduction) return next();
+	const VERBOSE = process.env.VERBOSITY != "0";
+	if (nodeEnv() === "prod" && !allowInProduction || !VERBOSE) return next();
 	await next();
 	const start = Date.now();
 	const req = event.req;
@@ -283,10 +340,51 @@ const requestLogger = ({ allowInProduction = false } = {}) => async (event, next
 		[`- ${duration}ms`, "dim"]
 	], " ");
 };
+var RequestLoggerMiddleware = class {
+	options;
+	constructor(options = {}) {
+		this.options = options;
+	}
+	handler() {
+		return requestLogger(this.options);
+	}
+};
+//#endregion
+//#region src/middlewares/resora.ts
+/**
+* Apply the application's resora configuration (`src/config/resources.ts`) and
+* bind the per-request `{ req, res }` context so Resources can build URLs and
+* pagination links.
+*
+* Replaces the manual `Resource.setCtx(...)` wiring: resora's runtime config is
+* applied from `config('resources')`, and the request is run within resora's
+* async context so downstream handlers resolve the correct context.
+*/
+const resora = () => {
+	let resources;
+	return async (event, next) => {
+		try {
+			if (!resources) {
+				resources = {
+					...getDefaultConfig(),
+					...config("resources", {})
+				};
+				if (typeof resources.resourcesDir === "string") resources.resourcesDir = resolveRuntimeDir(resources.resourcesDir);
+			}
+			applyRuntimeConfig(resources);
+		} catch {}
+		const ctx = {
+			req: event.req,
+			res: event.res
+		};
+		setCtx(ctx);
+		return runWithCtx(ctx, () => next());
+	};
+};
 //#endregion
 //#region src/middlewares/static-asset-handler.ts
 const staticAssetHandler = (publicPath = "public") => {
-	const rootPath = resolve(process.cwd(), publicPath);
+	const rootPath = resolve(Arkstack.rootDir(), publicPath);
 	return (event) => {
 		const { pathname } = new URL(event.req.url);
 		if (!/\.[a-zA-Z0-9]+$/.test(pathname)) return;
@@ -311,6 +409,4 @@ const staticAssetHandler = (publicPath = "public") => {
 	};
 };
 //#endregion
-export { auth as i, requestLogger as n, cors as r, staticAssetHandler as t };
-
-//# sourceMappingURL=middlewares-DIYzSTD5.js.map
+export { InertiaMiddleware as a, cors as c, requestLogger as i, AuthMiddleware as l, resora as n, inertia as o, RequestLoggerMiddleware as r, CorsMiddleware as s, staticAssetHandler as t, auth as u };

package/dist/types-DWUchLdg.d.ts

@@ -0,0 +1,10 @@
+import { ArkstackMiddlewareConfig } from "@arkstack/contract";
+import { Middleware } from "h3";
+import { ClassMiddleware } from "clear-router/types/basic";
+import { H3Middleware } from "@arkstack/driver-h3";
+
+//#region src/types.d.ts
+type Middleware$1 = Middleware | ClassMiddleware<Middleware>;
+type MiddlewareConfig = ArkstackMiddlewareConfig<Middleware$1> | ArkstackMiddlewareConfig<H3Middleware>;
+//#endregion
+export { MiddlewareConfig as n, Middleware$1 as t };

package/dist/types.d.ts

@@ -0,0 +1,2 @@
+import { n as MiddlewareConfig, t as Middleware } from "./types-DWUchLdg.js";
+export { Middleware, MiddlewareConfig };

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/driver-h3",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "type": "module",
   "description": "H3 driver for Arkstack, providing H3-based runtime integration for the framework.",
   "homepage": "https://arkstack.toneflix.net",
@@ -33,26 +33,33 @@
   "exports": {
     ".": "./dist/index.js",
     "./middlewares": "./dist/middlewares/index.js",
+    "./types": "./dist/types.js",
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "clear-router": "^2.6.4",
-    "@resora/plugin-clear-router": "^1.0.14",
-    "resora": "^1.2.4",
-    "@arkstack/contract": "^0.5.2"
+    "@ngrok/ngrok": "^1.7.0",
+    "@resora/plugin-clear-router": "^1.0.66",
+    "clear-router": "^2.9.0",
+    "resora": "^1.3.27",
+    "@arkstack/contract": "^0.5.3"
   },
   "peerDependencies": {
-    "h3": "2.0.1-rc.16",
-    "@arkstack/auth": "^0.5.2",
-    "@arkstack/common": "^0.5.2"
+    "h3": "2.0.1-rc.22",
+    "@arkstack/foundry": "^0.5.3",
+    "@arkstack/auth": "^0.5.3",
+    "@arkstack/inertia": "^0.5.3",
+    "@arkstack/common": "^0.5.3"
   },
   "peerDependenciesMeta": {
     "@arkstack/auth": {
       "optional": true
+    },
+    "@arkstack/inertia": {
+      "optional": true
     }
   },
   "scripts": {
-    "build": "tsdown",
+    "build": "tsdown --config-loader unrun",
     "version:patch": "pnpm version patch"
   }
 }

package/dist/index-B3NOMsXC.d.ts

@@ -1,50 +0,0 @@
-import { ArkstackKitDriver, ArkstackMiddlewareConfig, ArkstackRouteListOptions, PromiseOrValue } from "@arkstack/contract";
-import { H3, H3Event, HTTPError, HTTPResponse } from "h3";
-import { Router } from "clear-router/h3";
-import { H3App, Handler, HttpContext, Middleware } from "clear-router/types/h3";
-import { Route } from "clear-router";
-
-//#region src/error-handler.d.ts
-declare const defaultErrorHandler: (err: HTTPError | Error | string, event: H3Event) => HTTPResponse | {
-  error: boolean;
-  message: string;
-  status: "error";
-  code: number;
-  errors?: unknown;
-  stack?: string;
-};
-//#endregion
-//#region src/Router.d.ts
-declare class Router$1 extends Router {
-  static bind(app: H3): Promise<H3App>;
-  static list(_options: ArkstackRouteListOptions | undefined, app: H3): Promise<Route<HttpContext, Middleware, Handler>[]>;
-}
-//#endregion
-//#region src/index.d.ts
-type H3Middleware = Middleware | [Middleware, Record<string, any>];
-interface H3DriverOptions {
-  bindRouter: (app: H3) => PromiseOrValue<void>;
-  mountPublicAssets?: (app: H3, publicPath: string) => PromiseOrValue<void>;
-  createApp?: () => H3;
-  onError?: (err: Error | string, event: H3Event) => unknown;
-}
-declare class H3EventResponse {
-  response: Response;
-  status: number;
-  statusText?: string;
-  constructor(response: Response);
-  get headers(): Headers;
-}
-declare class H3Driver extends ArkstackKitDriver<H3, H3Middleware> {
-  readonly name = "h3";
-  private readonly options;
-  constructor(options: H3DriverOptions);
-  createApp(): H3;
-  mountPublicAssets(app: H3, publicPath: string): PromiseOrValue<void>;
-  bindRouter(app: H3): PromiseOrValue<void>;
-  applyMiddleware(app: H3, middleware: H3Middleware | ArkstackMiddlewareConfig<H3Middleware>): void;
-  start(app: H3, port: number): void;
-}
-//#endregion
-export { Router$1 as a, H3Middleware as i, H3DriverOptions as n, defaultErrorHandler as o, H3EventResponse as r, H3Driver as t };
-//# sourceMappingURL=index-B3NOMsXC.d.ts.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":["ClearRouter"],"sources":["../src/error-handler.ts","../src/Router.ts","../src/index.ts"],"sourcesContent":["import {\n    ErrorHandler,\n    renderError,\n} from '@arkstack/common'\nimport { H3Event, HTTPError, HTTPResponse } from 'h3'\n\nexport const defaultErrorHandler = (err: HTTPError | Error | string, event: H3Event) => {\n    const responseBody = ErrorHandler.createErrorPayload(err)\n\n    if (ErrorHandler.shouldLogError(err)) {\n        ErrorHandler.logUnhandledError(err, {\n            headers: Object.fromEntries(event.req.headers.entries()),\n            method: event.req.method,\n            url: event.req.url,\n        }, 'Unhandled H3 request error')\n    }\n\n    if (process.env.NODE_ENV === 'development') console.error(responseBody)\n\n    const code = ErrorHandler.normalizeStatusCode(responseBody.code)\n    event.res.status = code\n\n    const acceptsHeader = event.req.headers.get('accept') ?? ''\n    const expectsJson = acceptsHeader.includes('application/json') || event.req._url?.pathname?.startsWith('/api')\n\n    if (expectsJson) {\n        return {\n            ...responseBody,\n            error: true,\n            message: responseBody.message,\n        }\n    }\n\n    return new HTTPResponse(renderError({\n        message: String(responseBody.message),\n        stack: typeof responseBody.stack === 'string' ? responseBody.stack : undefined,\n        code,\n    }), {\n        status: code,\n        headers: {\n            'Content-Type': 'text/html',\n        },\n    })\n}\n\nexport default defaultErrorHandler\n","import { ArkstackRouteListOptions } from '@arkstack/contract'\nimport { Router as ClearRouter } from 'clear-router/h3'\nimport { H3 } from 'h3'\nimport type { H3App, Handler, HttpContext, Middleware } from 'clear-router/types/h3'\nimport { type Route } from 'clear-router'\nimport { clearRouterH3Plugin } from '@resora/plugin-clear-router'\nimport { importFile } from '@arkstack/common'\nimport { join } from 'node:path'\nimport { registerPlugin } from 'resora'\n\nregisterPlugin(clearRouterH3Plugin)\nClearRouter.configure({\n  inferParamName: true\n})\n\nexport class Router extends ClearRouter {\n  static async bind (app: H3): Promise<H3App> {\n    try {\n      // Register API routes\n      await ClearRouter.group('/api', async () => {\n        await importFile(join(process.cwd(), 'src/routes/api.ts'))\n      })\n\n      // Register web routes\n      await ClearRouter.group('/', async () => {\n        await importFile(join(process.cwd(), 'src/routes/web.ts'))\n      })\n\n    } catch { /** */ }\n\n    // Apply the registered routes to the H3 application\n    const router = ClearRouter.apply(app)\n\n    return router\n  }\n\n  static async list (\n    _options: ArkstackRouteListOptions = {}, app: H3\n  ): Promise<Route<HttpContext, Middleware, Handler>[]> {\n    await this.bind(app)\n\n    return this.allRoutes() as never\n  }\n}\n","import { ArkstackKitDriver, ArkstackMiddlewareConfig, PromiseOrValue } from '@arkstack/contract'\nimport { H3, H3Event, serve, toResponse } from 'h3'\n\nimport { Middleware as H3BaseMiddleware } from 'clear-router/types/h3'\nimport { Logger } from '@arkstack/common'\nimport { defaultErrorHandler } from './error-handler'\nimport { staticAssetHandler } from './middlewares'\n\n// oxlint-disable-next-line typescript/no-explicit-any\nexport type H3Middleware = H3BaseMiddleware | [H3BaseMiddleware, Record<string, any>];\n\nexport interface H3DriverOptions {\n    bindRouter: (app: H3) => PromiseOrValue<void>;\n    mountPublicAssets?: (app: H3, publicPath: string) => PromiseOrValue<void>;\n    createApp?: () => H3;\n    onError?: (err: Error | string, event: H3Event) => unknown;\n}\n\nexport class H3EventResponse {\n    status: number = 200\n    statusText?: string\n\n    constructor(public response: Response) {\n        this.status = response.status\n        this.statusText = response.statusText\n    }\n\n    get headers (): Headers {\n        return this.response.headers\n    }\n}\n\n/**\n * The H3Driver class implements the ArkstackKitDriver contract for the H3 framework.\n */\nexport class H3Driver extends ArkstackKitDriver<H3, H3Middleware> {\n    readonly name = 'h3'\n    private readonly options: H3DriverOptions\n\n    /**\n     * Creates an instance of H3Driver.\n     * \n     * @param options \n     */\n    constructor(options: H3DriverOptions) {\n        super()\n        this.options = options\n    }\n\n    /**\n     * Creates an H3 application instance.\n     * \n     * @returns \n     */\n    createApp (): H3 {\n        return this.options.createApp?.() ?? new H3({\n            onError: this.options.onError ?? defaultErrorHandler,\n        })\n    }\n\n    /**\n     * Mounts static assets from the specified public path to the H3 application.\n     * \n     * @param app \n     * @param publicPath \n     */\n    mountPublicAssets (app: H3, publicPath: string): PromiseOrValue<void> {\n        if (this.options.mountPublicAssets) {\n            return this.options.mountPublicAssets(app, publicPath)\n        }\n\n        app.use(staticAssetHandler(publicPath))\n    }\n\n    /**\n     * Binds the router to the H3 application using the provided bindRouter function.\n     * \n     * @param app \n     */\n    bindRouter (app: H3): PromiseOrValue<void> {\n        return this.options.bindRouter(app)\n    }\n\n    /**\n     * Applies middleware to the H3 application.\n     * \n     * @param app \n     * @param middleware \n     */\n    applyMiddleware (\n        app: H3,\n        middleware: H3Middleware | ArkstackMiddlewareConfig<H3Middleware>,\n    ): void {\n        const mw = Array.isArray(middleware) ? middleware[0] : middleware\n        const conf = Array.isArray(middleware) && middleware[1] ? middleware[1] : {}\n\n        if (typeof mw === 'function') {\n            app.use(mw, conf)\n\n            return\n        }\n\n        for (const [pos, entries] of Object.entries(middleware) as [string, H3Middleware[]][]) {\n            for (const entry of entries) {\n                const mw = Array.isArray(entry) ? entry[0] : entry\n                const conf = Array.isArray(entry) && entry[1] ? entry[1] : {}\n\n                if (pos === 'after') {\n                    app.use(async (evt, next) => {\n                        const response = await toResponse(await next(), evt)\n                        // evt.res.status = response.status\n                        evt[Symbol.for('h3.internal.event.res') as never] = new H3EventResponse(response) as never\n                        await mw(evt, next)\n                        next()\n                    }, conf)\n                } else {\n                    app.use(mw, conf)\n                }\n            }\n        }\n    }\n\n    /**\n     * Starts the H3 server on the specified port.\n     * \n     * @param app \n     * @param port \n     */\n    start (app: H3, port: number): void {\n        serve(app, { port, silent: true }).ready().then(() => {\n            Logger.log([\n                ['Server is running on', 'white'],\n                [`http://localhost:${port}`, 'cyan']\n            ], ' ')\n        })\n    }\n}\n\nexport * from './error-handler'\nexport * from './Router'\n"],"mappings":"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"}

package/dist/middlewares-DIYzSTD5.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"middlewares-DIYzSTD5.js","names":[],"sources":["../src/middlewares/auth.ts","../src/utils/vary.ts","../src/middlewares/cors.ts","../src/middlewares/request-logger.ts","../src/middlewares/static-asset-handler.ts"],"sourcesContent":["import { Auth, AuthenticationException } from '@arkstack/auth'\n\nimport type { H3Event } from 'h3'\nimport { Hook } from '@arkstack/common'\n\nexport const auth = async (event: H3Event, next: () => unknown | Promise<unknown>) => {\n    try {\n        const token = readBearerToken(event.req.headers.get('authorization'))\n\n        if (!token) {\n            throw new AuthenticationException('Unauthenticated', {\n                req: {\n                    headers: event.req.headers,\n                    method: event.req.method,\n                    url: event.req.url,\n                    path: getEventPath(event),\n                },\n                status: 401,\n            })\n        }\n\n        if (Hook.has('middleware:auth', 'before'))\n            Hook.get('middleware:auth', 'before')?.(event)\n\n        const requestSource = {\n            headers: event.req.headers,\n            method: event.req.method,\n            url: event.req.url,\n            path: getEventPath(event),\n        }\n        const auth = Auth.make().setRequest(requestSource)\n        const user = await auth.authorizeToken(token)\n\n        event.context.user = user\n        event.context.auth = auth\n        event.context.authUser = user\n        event.context.authToken = token;\n        (event.req as any).user = user;\n        (event.req as any).auth = auth;\n        (event.req as any).authUser = user;\n        (event.req as any).authToken = token\n\n        if (Hook.has('middleware:auth', 'after'))\n            Hook.get('middleware:auth', 'after')?.(event)\n\n        return await next()\n    } catch (error) {\n        if (Hook.has('middleware:auth', 'error'))\n            Hook.get('middleware:auth', 'error')?.(error, event)\n\n        throw error\n    }\n}\n\nconst readBearerToken = (authorization: string | null) => {\n    if (!authorization?.startsWith('Bearer ')) {\n        return null\n    }\n\n    return authorization.substring(7)\n}\n\nconst getEventPath = (event: H3Event) => event.req._url?.pathname\n","/*!\n * vary\n * Copyright(c) 2014-2017 Douglas Christopher Wilson\n * MIT Licensed\n */\nimport { H3Event } from 'h3'\n\n/**\n * RegExp to match field-name in RFC 7230 sec 3.2\n *\n * field-name    = token\n * token         = 1*tchar\n * tchar         = \"!\" / \"#\" / \"$\" / \"%\" / \"&\" / \"'\" / \"*\"\n *               / \"+\" / \"-\" / \".\" / \"^\" / \"_\" / \"`\" / \"|\" / \"~\"\n *               / DIGIT / ALPHA\n *               ; any VCHAR, except delimiters\n */\n\nconst FIELD_NAME_REGEXP = /^[!#$%&'*+\\-.^_`|~0-9A-Za-z]+$/\n\n/**\n * Append a field to a vary header.\n *\n * @param header\n * @param field\n * @return\n * @public\n */\nexport const append = (header: string, field: string | string[]) => {\n    if (typeof header !== 'string') {\n        throw new TypeError('header argument is required')\n    }\n\n    if (!field) {\n        throw new TypeError('field argument is required')\n    }\n\n    // get fields array\n    const fields = !Array.isArray(field) ? parse(String(field)) : field\n\n    // assert on invalid field names\n    for (let j = 0; j < fields.length; j++) {\n        if (!FIELD_NAME_REGEXP.test(fields[j])) {\n            throw new TypeError('field argument contains an invalid header name')\n        }\n    }\n\n    // existing, unspecified vary\n    if (header === '*') {\n        return header\n    }\n\n    // enumerate current values\n    let val = header\n    const vals = parse(header.toLowerCase())\n\n    // unspecified vary\n    if (fields.indexOf('*') !== -1 || vals.indexOf('*') !== -1) {\n        return '*'\n    }\n\n    for (let i = 0; i < fields.length; i++) {\n        const fld = fields[i].toLowerCase()\n\n        // append value (case-preserving)\n        if (vals.indexOf(fld) === -1) {\n            vals.push(fld)\n            val = val ? val + ', ' + fields[i] : fields[i]\n        }\n    }\n\n    return val\n}\n\n/**\n * Parse a vary header into an array.\n *\n * @param  header\n * @return\n * @private\n */\n\nexport const parse = (header: string) => {\n    let end = 0\n    const list = []\n    let start = 0\n\n    // gather tokens\n    for (let i = 0, len = header.length; i < len; i++) {\n        switch (header.charCodeAt(i)) {\n            case 0x20 /*   */:\n                if (start === end) {\n                    start = end = i + 1\n                }\n                break\n            case 0x2c /* , */:\n                list.push(header.substring(start, end))\n                start = end = i + 1\n                break\n            default:\n                end = i + 1\n                break\n        }\n    }\n\n    // final token\n    list.push(header.substring(start, end))\n\n    return list\n}\n\n/**\n * Mark that a request is varied on a header field.\n *\n * @param res\n * @param  field\n * @public\n */\n\nexport const vary = (res?: H3Event['res'], field?: string | string[]) => {\n    if (!res || !res.headers.get || !res.headers.set) {\n        throw new TypeError('res argument is required')\n    }\n\n    // get existing header\n    let val = res.headers.get('Vary') || ''\n    const header = Array.isArray(val) ? val.join(', ') : String(val)\n\n    if (!field) {\n        return res.headers.set('Vary', '*')\n    }\n\n    // set new header\n    if ((val = append(header, field))) {\n        res.headers.set('Vary', val)\n    }\n}\n","import { H3Event } from 'h3'\nimport { NextFunction } from 'clear-router/types/h3'\nimport { vary } from '../utils/vary'\n\nconst isString = (s: any) => {\n  return typeof s === 'string' || s instanceof String\n}\n\nconst isOriginAllowed = (origin: string, allowedOrigin: string | string[] | RegExp | boolean) => {\n  if (Array.isArray(allowedOrigin)) {\n    for (let i = 0; i < allowedOrigin.length; ++i) {\n      if (isOriginAllowed(origin, allowedOrigin[i])) {\n        return true\n      }\n    }\n\n    return false\n  } else if (isString(allowedOrigin)) {\n    return origin === allowedOrigin\n  } else if (allowedOrigin instanceof RegExp) {\n    return allowedOrigin.test(origin)\n  } else {\n    return !!allowedOrigin\n  }\n}\n\nconst configureOrigin = (\n  options: { origin?: string | string[] | RegExp | boolean },\n  req: H3Event['req'],\n) => {\n  let isAllowed: boolean\n  const requestOrigin = req.headers.get('origin') || '*',\n    headers = []\n\n  if (!options.origin || options.origin === '*') {\n    // allow any origin\n    headers.push([\n      {\n        key: 'Access-Control-Allow-Origin',\n        value: '*',\n      },\n    ])\n  } else if (isString(options.origin)) {\n    // fixed origin\n    headers.push([\n      {\n        key: 'Access-Control-Allow-Origin',\n        value: options.origin,\n      },\n    ])\n    headers.push([\n      {\n        key: 'Vary',\n        value: 'Origin',\n      },\n    ])\n  } else {\n    isAllowed = isOriginAllowed(requestOrigin, options.origin)\n    // reflect origin\n    headers.push([\n      {\n        key: 'Access-Control-Allow-Origin',\n        value: isAllowed ? requestOrigin : false,\n      },\n    ])\n    headers.push([\n      {\n        key: 'Vary',\n        value: 'Origin',\n      },\n    ])\n  }\n\n  return headers\n}\n\nconst configureMethods = (options: { methods?: string[] | string }) => {\n  let methods = options.methods\n  if (Array.isArray(methods)) {\n    methods = methods.join(',') // .methods is an array, so turn it into a string\n  }\n\n  return {\n    key: 'Access-Control-Allow-Methods',\n    value: methods,\n  }\n}\n\nconst configureCredentials = (options: { credentials?: boolean }) => {\n  if (options.credentials === true) {\n    return {\n      key: 'Access-Control-Allow-Credentials',\n      value: 'true',\n    }\n  }\n\n  return null\n}\n\nconst configureAllowedHeaders = (\n  options: { allowedHeaders?: string[] | string | null; headers?: string[] | string | null },\n  req: H3Event['req'],\n) => {\n  let allowedHeaders = options.allowedHeaders || options.headers\n  const headers = []\n\n  if (!allowedHeaders) {\n    allowedHeaders = req.headers.get('access-control-request-headers') // .headers wasn't specified, so reflect the request headers\n    headers.push([\n      {\n        key: 'Vary',\n        value: 'Access-Control-Request-Headers',\n      },\n    ])\n  } else if (Array.isArray(allowedHeaders)) {\n    allowedHeaders = allowedHeaders.join(',') // .headers is an array, so turn it into a string\n  }\n  if (allowedHeaders && allowedHeaders.length) {\n    headers.push([\n      {\n        key: 'Access-Control-Allow-Headers',\n        value: allowedHeaders,\n      },\n    ])\n  }\n\n  return headers\n}\n\nfunction configureExposedHeaders (options: { exposedHeaders?: string[] | string }) {\n  let headers = options.exposedHeaders\n  if (!headers) {\n    return null\n  } else if (Array.isArray(headers)) {\n    headers = headers.join(',') // .headers is an array, so turn it into a string\n  }\n  if (headers && headers.length) {\n    return {\n      key: 'Access-Control-Expose-Headers',\n      value: headers,\n    }\n  }\n\n  return null\n}\n\nfunction configureMaxAge (options: { maxAge?: number | string }) {\n  const maxAge = (typeof options.maxAge === 'number' || options.maxAge) && options.maxAge.toString()\n  if (maxAge && maxAge.length) {\n    return {\n      key: 'Access-Control-Max-Age',\n      value: maxAge,\n    }\n  }\n\n  return null\n}\n\nfunction applyHeaders (headers: any[], res: H3Event['res']) {\n  for (let i = 0, n = headers.length; i < n; i++) {\n    const header = headers[i]\n    if (header) {\n      if (Array.isArray(header)) {\n        applyHeaders(header, res)\n      } else if (header.key === 'Vary' && header.value) {\n        vary(res, header.value)\n      } else if (header.value) {\n        res.headers.set(header.key, header.value)\n      }\n    }\n  }\n}\n\nexport const cors =\n  (\n    options: {\n      origin?: string | string[] | RegExp | boolean;\n      methods?: string[] | string;\n      allowedHeaders?: string[] | string | null;\n      exposedHeaders?: string[] | string;\n      credentials?: boolean;\n      maxAge?: number | string;\n      optionsSuccessStatus?: number;\n      preflightContinue?: boolean;\n    } = {},\n  ) =>\n    async (event: H3Event, next: NextFunction) => {\n      const headers = [],\n        method = event.req.method && event.req.method.toUpperCase && event.req.method.toUpperCase()\n\n      if (method === 'OPTIONS') {\n        // preflight\n        headers.push(configureOrigin(options, event.req))\n        headers.push(configureCredentials(options))\n        headers.push(configureMethods(options))\n        headers.push(configureAllowedHeaders(options, event.req))\n        headers.push(configureMaxAge(options))\n        headers.push(configureExposedHeaders(options))\n        applyHeaders(headers, event.res)\n\n        if (options.preflightContinue) {\n          next()\n        } else {\n          // Safari (and potentially other browsers) need content-length 0,\n          //   for 204 or they just hang waiting for a body\n          event.res.status = options.optionsSuccessStatus\n          event.res.headers.set('Content-Length', '0')\n        }\n      } else {\n        // actual response\n        headers.push(configureOrigin(options, event.req))\n        headers.push(configureCredentials(options))\n        headers.push(configureExposedHeaders(options))\n        applyHeaders(headers, event.res)\n        next()\n      }\n    }\n","import { Logger, nodeEnv } from '@arkstack/common'\n\nimport { H3Middleware } from '..'\n\nconst colors: Record<string, 'green' | 'blue' | 'yellow' | 'red' | 'cyan'> = {\n    GET: 'green',\n    POST: 'blue',\n    PUT: 'yellow',\n    DELETE: 'red',\n    PATCH: 'cyan',\n}\n\n/**\n * Middleware to log incoming requests and their response times.\n * \n * @param config Configuration options for the request logger middleware.\n * @param config.allowInProduction If true, the logger will also log requests in production environment. Default is false. \n * @returns H3Middleware function\n */\nexport const requestLogger = ({\n    allowInProduction = false,\n}: {\n    allowInProduction?: boolean\n} = {}): H3Middleware => async (event, next) => {\n    if (nodeEnv() === 'prod' && !allowInProduction) return next()\n\n    await next()\n\n    const start = Date.now()\n    const req = event.req\n    const status = event.res.status || 200\n    const duration = Date.now() - start\n\n    Logger.log([\n        [`[${req.method}]`, colors[req.method] || 'green'],\n        [req.url, 'cyan'],\n        [status.toString(), status >= 500 ? 'red' : status >= 400 ? 'yellow' : 'green'],\n        [`- ${duration}ms`, 'dim']\n    ], ' ')\n}","import { H3Event, serveStatic } from 'h3'\nimport { readFile, stat } from 'node:fs/promises'\nimport { join, resolve } from 'node:path'\n\nexport const staticAssetHandler = (publicPath: string = 'public') => {\n    const rootPath = resolve(process.cwd(), publicPath)\n\n    return (event: H3Event) => {\n        const { pathname } = new URL(event.req.url)\n\n        if (!/\\.[a-zA-Z0-9]+$/.test(pathname)) return\n        if (pathname.startsWith('/.') || pathname.includes('..')) return\n\n        event.res.headers.set('Cache-Control', 'public, max-age=31536000, immutable')\n        event.res.headers.set('Access-Control-Allow-Origin', '*')\n        event.res.headers.set('Access-Control-Allow-Methods', 'GET, HEAD, OPTIONS')\n        event.res.headers.set('Access-Control-Allow-Headers', 'Content-Type, Authorization')\n\n        return serveStatic(event, {\n            indexNames: ['/index.html'],\n            getContents: (id) => {\n                const relativePath = id.replace(/^\\/+/, '')\n                const file = join(rootPath, relativePath)\n\n                return readFile(file).catch(() => null) as never\n            },\n            getMeta: async (id) => {\n                const relativePath = id.replace(/^\\/+/, '')\n                const file = join(rootPath, relativePath)\n                const stats = await stat(file).catch(() => undefined)\n\n                if (stats?.isFile()) {\n                    return {\n                        size: stats.size,\n                        mtime: stats.mtimeMs,\n                    }\n                }\n            },\n        })\n    }\n}"],"mappings":"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"}