@arkstack/driver-h3 0.12.33 → 0.12.35

package/dist/index--GiaEPJz.d.ts

@@ -0,0 +1,91 @@
+import { n as MiddlewareConfig, t as Middleware$2 } from "./types-DPGHB4nY.js";
+import { ArkstackKitDriver, ArkstackRouteListOptions, PromiseOrValue } from "@arkstack/contract";
+import { H3, H3Event, HTTPError, HTTPResponse } from "h3";
+import { Route } from "clear-router";
+import { Router } from "clear-router/h3";
+import { H3App, Handler, HttpContext, Middleware as Middleware$1 } from "clear-router/types/h3";
+
+//#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 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;
+  /**
+   * 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): 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-DIJtwwZP.d.ts → index-E-098om7.d.ts}

@@ -77,6 +77,11 @@ declare class H3Driver extends ArkstackKitDriver<H3, H3Middleware> {
   /**
    * 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
    */

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 /// <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-DIJtwwZP.js";
+import { a as Router, i as H3Middleware, n as H3DriverOptions, o as defaultErrorHandler, r as H3EventResponse, t as H3Driver } from "./index--GiaEPJz.js";
 export { H3Driver, H3DriverOptions, H3EventResponse, H3Middleware, Router, defaultErrorHandler };

package/dist/index.js

@@ -1,7 +1,7 @@
 import { t as staticAssetHandler } from "./middlewares-CGBJHsH7.js";
 import { Arkstack, ArkstackKitDriver } from "@arkstack/contract";
 import { H3, HTTPResponse, serve, toResponse } from "h3";
-import { ErrorHandler, Logger, isClass, renderError } from "@arkstack/common";
+import { ErrorHandler, Logger, env, isClass, renderError } from "@arkstack/common";
 import { Request } from "clear-router";
 import { definePlugin } from "clear-router/core";
 import { definePlugin as definePlugin$1 } from "kanun";
@@ -1377,16 +1377,23 @@ var H3Driver = class extends ArkstackKitDriver {
 	}
 	/**
 	* Starts the H3 server on the specified port.
-	* 
-	* @param app 
-	* @param 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) {
+		const host = env("APP_HOST", env("HOST", "0.0.0.0"));
 		serve(app, {
 			port,
+			hostname: host,
 			silent: true
 		}).ready().then(() => {
-			Logger.log([["Server is running on", "white"], [`http://localhost:${port}`, "cyan"]], " ");
+			Logger.log([["Server is running on", "white"], [`http://${host}:${port}`, "cyan"]], " ");
 		});
 	}
 };

package/dist/middlewares/index.d.ts

@@ -1,4 +1,4 @@
-import { i as H3Middleware } from "../index-DIJtwwZP.js";
+import { i as H3Middleware } from "../index--GiaEPJz.js";
 import * as _$h3 from "h3";
 import { EventHandlerRequest, H3Event } from "h3";
 import { NextFunction } from "clear-router/types/h3";

package/dist/types-DPGHB4nY.d.ts

@@ -0,0 +1,18 @@
+/// <reference path="./app.d.ts" />
+import { ArkstackKitDriver, ArkstackMiddlewareConfig, ArkstackRouteListOptions, PromiseOrValue } from "@arkstack/contract";
+import { H3, H3Event, HTTPError, HTTPResponse, Middleware } from "h3";
+import { Route } from "clear-router";
+import { Router } from "clear-router/h3";
+import { ClassMiddleware } from "clear-router/types/basic";
+import { H3App, Handler, HttpContext, Middleware as Middleware$1 } from "clear-router/types/h3";
+
+//#region dist/index-E-098om7.d.ts
+//#endregion
+//#region src/index.d.ts
+type H3Middleware = Middleware$1 | [Middleware$1, Record<string, any>];
+//#endregion
+//#region src/types.d.ts
+type Middleware$2 = Middleware | ClassMiddleware<Middleware>;
+type MiddlewareConfig = ArkstackMiddlewareConfig<Middleware$2> | ArkstackMiddlewareConfig<H3Middleware>;
+//#endregion
+export { MiddlewareConfig as n, Middleware$2 as t };

package/dist/types.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/driver-h3",
-  "version": "0.12.33",
+  "version": "0.12.35",
   "type": "module",
   "description": "H3 driver for Arkstack, providing H3-based runtime integration for the framework.",
   "homepage": "https://arkstack.toneflix.net",
@@ -38,15 +38,15 @@
   },
   "dependencies": {
     "clear-router": "^2.8.8",
-    "@resora/plugin-clear-router": "^1.0.60",
-    "resora": "^1.3.23",
-    "@arkstack/contract": "^0.12.33"
+    "@resora/plugin-clear-router": "^1.0.62",
+    "resora": "^1.3.25",
+    "@arkstack/contract": "^0.12.35"
   },
   "peerDependencies": {
     "h3": "2.0.1-rc.22",
-    "@arkstack/auth": "^0.12.33",
-    "@arkstack/foundry": "^0.12.33",
-    "@arkstack/common": "^0.12.33"
+    "@arkstack/foundry": "^0.12.35",
+    "@arkstack/auth": "^0.12.35",
+    "@arkstack/common": "^0.12.35"
   },
   "peerDependenciesMeta": {
     "@arkstack/auth": {