@arkstack/driver-h3 0.2.4 → 0.3.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Toneflix Technologies Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ArkstackKitDriver, PromiseOrValue } from "@arkstack/contract";
+import { ArkstackKitDriver, ArkstackMiddlewareConfig, PromiseOrValue } from "@arkstack/contract";
 import { H3 } from "h3";
 import { Middleware } from "clear-router/types/h3";
 
@@ -9,6 +9,13 @@ interface H3DriverOptions {
   mountPublicAssets: (app: H3, publicPath: string) => PromiseOrValue<void>;
   createApp?: () => H3;
 }
+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;
@@ -16,9 +23,9 @@ declare class H3Driver extends ArkstackKitDriver<H3, H3Middleware> {
   createApp(): H3;
   mountPublicAssets(app: H3, publicPath: string): PromiseOrValue<void>;
   bindRouter(app: H3): PromiseOrValue<void>;
-  applyMiddleware(app: H3, middleware: H3Middleware): void;
+  applyMiddleware(app: H3, middleware: H3Middleware | ArkstackMiddlewareConfig<H3Middleware>): void;
   start(app: H3, port: number): void;
 }
 //#endregion
-export { H3Driver, H3DriverOptions, H3Middleware };
+export { H3Driver, H3DriverOptions, H3EventResponse, H3Middleware };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,7 +1,20 @@
 import { ArkstackKitDriver } from "@arkstack/contract";
-import { H3, serve } from "h3";
+import { H3, serve, toResponse } from "h3";
+import { Logger } from "@arkstack/common";
 
 //#region src/index.ts
+var H3EventResponse = class {
+	status = 200;
+	statusText;
+	constructor(response) {
+		this.response = response;
+		this.status = response.status;
+		this.statusText = response.statusText;
+	}
+	get headers() {
+		return this.response.headers;
+	}
+};
 /**
 * The H3Driver class implements the ArkstackKitDriver contract for the H3 framework.
 */
@@ -49,7 +62,22 @@ var H3Driver = class extends ArkstackKitDriver {
 	* @param middleware 
 	*/
 	applyMiddleware(app, middleware) {
-		app.use(Array.isArray(middleware) ? middleware[0] : middleware, Array.isArray(middleware) ? middleware[1] : void 0);
+		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);
+			return;
+		}
+		for (const [pos, entries] of Object.entries(middleware)) for (const entry of entries) {
+			const mw = Array.isArray(entry) ? entry[0] : entry;
+			const conf = Array.isArray(entry) && entry[1] ? entry[1] : {};
+			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);
+				next();
+			}, conf);
+			else app.use(mw, conf);
+		}
 	}
 	/**
 	* Starts the H3 server on the specified port.
@@ -58,10 +86,15 @@ var H3Driver = class extends ArkstackKitDriver {
 	* @param port 
 	*/
 	start(app, port) {
-		serve(app, { port });
+		serve(app, {
+			port,
+			silent: true
+		}).ready().then(() => {
+			Logger.log([["Server is running on", "white"], [`http://localhost:${port}`, "cyan"]], " ");
+		});
 	}
 };
 
 //#endregion
-export { H3Driver };
+export { H3Driver, H3EventResponse };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { ArkstackKitDriver, PromiseOrValue } from '@arkstack/contract'\nimport { H3, serve } from 'h3'\n\nimport { Middleware as H3BaseMiddleware } from 'clear-router/types/h3'\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}\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    }\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        return this.options.mountPublicAssets(app, 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 (app: H3, middleware: H3Middleware): void {\n        app.use(\n            Array.isArray(middleware) ? middleware[0] : middleware,\n            Array.isArray(middleware) ? middleware[1] : undefined,\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 })\n    }\n}\n"],"mappings":";;;;;;;AAiBA,IAAa,WAAb,cAA8B,kBAAoC;CAC9D,AAAS,OAAO;CAChB,AAAiB;;;;;;CAOjB,YAAY,SAA0B;AAClC,SAAO;AACP,OAAK,UAAU;;;;;;;CAQnB,YAAiB;AACb,SAAO,KAAK,QAAQ,aAAa,IAAI,IAAI,IAAI;;;;;;;;CASjD,kBAAmB,KAAS,YAA0C;AAClE,SAAO,KAAK,QAAQ,kBAAkB,KAAK,WAAW;;;;;;;CAQ1D,WAAY,KAA+B;AACvC,SAAO,KAAK,QAAQ,WAAW,IAAI;;;;;;;;CASvC,gBAAiB,KAAS,YAAgC;AACtD,MAAI,IACA,MAAM,QAAQ,WAAW,GAAG,WAAW,KAAK,YAC5C,MAAM,QAAQ,WAAW,GAAG,WAAW,KAAK,OAC/C;;;;;;;;CASL,MAAO,KAAS,MAAoB;AAChC,QAAM,KAAK,EAAE,MAAM,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { ArkstackKitDriver, ArkstackMiddlewareConfig, PromiseOrValue } from '@arkstack/contract'\nimport { H3, serve, toResponse } from 'h3'\n\nimport { Middleware as H3BaseMiddleware } from 'clear-router/types/h3'\nimport { Logger } from '@arkstack/common'\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}\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    }\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        return this.options.mountPublicAssets(app, 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"],"mappings":";;;;;AAeA,IAAa,kBAAb,MAA6B;CACzB,SAAiB;CACjB;CAEA,YAAY,AAAO,UAAoB;EAApB;AACf,OAAK,SAAS,SAAS;AACvB,OAAK,aAAa,SAAS;;CAG/B,IAAI,UAAoB;AACpB,SAAO,KAAK,SAAS;;;;;;AAO7B,IAAa,WAAb,cAA8B,kBAAoC;CAC9D,AAAS,OAAO;CAChB,AAAiB;;;;;;CAOjB,YAAY,SAA0B;AAClC,SAAO;AACP,OAAK,UAAU;;;;;;;CAQnB,YAAiB;AACb,SAAO,KAAK,QAAQ,aAAa,IAAI,IAAI,IAAI;;;;;;;;CASjD,kBAAmB,KAAS,YAA0C;AAClE,SAAO,KAAK,QAAQ,kBAAkB,KAAK,WAAW;;;;;;;CAQ1D,WAAY,KAA+B;AACvC,SAAO,KAAK,QAAQ,WAAW,IAAI;;;;;;;;CASvC,gBACI,KACA,YACI;EACJ,MAAM,KAAK,MAAM,QAAQ,WAAW,GAAG,WAAW,KAAK;EACvD,MAAM,OAAO,MAAM,QAAQ,WAAW,IAAI,WAAW,KAAK,WAAW,KAAK,EAAE;AAE5E,MAAI,OAAO,OAAO,YAAY;AAC1B,OAAI,IAAI,IAAI,KAAK;AAEjB;;AAGJ,OAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,WAAW,CACnD,MAAK,MAAM,SAAS,SAAS;GACzB,MAAM,KAAK,MAAM,QAAQ,MAAM,GAAG,MAAM,KAAK;GAC7C,MAAM,OAAO,MAAM,QAAQ,MAAM,IAAI,MAAM,KAAK,MAAM,KAAK,EAAE;AAE7D,OAAI,QAAQ,QACR,KAAI,IAAI,OAAO,KAAK,SAAS;AAGzB,QAAI,OAAO,IAAI,wBAAwB,IAAa,IAAI,gBAFvC,MAAM,WAAW,MAAM,MAAM,EAAE,IAAI,CAE6B;AACjF,UAAM,GAAG,KAAK,KAAK;AACnB,UAAM;MACP,KAAK;OAER,KAAI,IAAI,IAAI,KAAK;;;;;;;;;CAYjC,MAAO,KAAS,MAAoB;AAChC,QAAM,KAAK;GAAE;GAAM,QAAQ;GAAM,CAAC,CAAC,OAAO,CAAC,WAAW;AAClD,UAAO,IAAI,CACP,CAAC,wBAAwB,QAAQ,EACjC,CAAC,oBAAoB,QAAQ,OAAO,CACvC,EAAE,IAAI;IACT"}

package/dist/middlewares/index.d.ts

@@ -0,0 +1,11 @@
+import { H3Middleware } from "../index.js";
+
+//#region src/middlewares/request-logger.d.ts
+declare const requestLogger: ({
+  allowInProduction
+}?: {
+  allowInProduction?: boolean;
+}) => H3Middleware;
+//#endregion
+export { requestLogger };
+//# sourceMappingURL=index.d.ts.map

package/dist/middlewares/index.js

@@ -0,0 +1,35 @@
+import { Logger, nodeEnv } from "@arkstack/common";
+
+//#region src/middlewares/request-logger.ts
+const colors = {
+	GET: "green",
+	POST: "blue",
+	PUT: "yellow",
+	DELETE: "red",
+	PATCH: "cyan"
+};
+/**
+* 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
+*/
+const requestLogger = ({ allowInProduction = false } = {}) => async (event, next) => {
+	if (nodeEnv() === "prod" && !allowInProduction) return next();
+	await next();
+	const start = Date.now();
+	const req = event.req;
+	const status = event.res.status || 200;
+	const duration = Date.now() - start;
+	Logger.log([
+		[`[${req.method}]`, colors[req.method] || "green"],
+		[req.url, "cyan"],
+		[status.toString(), status >= 500 ? "red" : status >= 400 ? "yellow" : "green"],
+		[`- ${duration}ms`, "dim"]
+	], " ");
+};
+
+//#endregion
+export { requestLogger };
+//# sourceMappingURL=index.js.map

package/dist/middlewares/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/middlewares/request-logger.ts"],"sourcesContent":["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}"],"mappings":";;;AAIA,MAAM,SAAuE;CACzE,KAAK;CACL,MAAM;CACN,KAAK;CACL,QAAQ;CACR,OAAO;CACV;;;;;;;;AASD,MAAa,iBAAiB,EAC1B,oBAAoB,UAGpB,EAAE,KAAmB,OAAO,OAAO,SAAS;AAC5C,KAAI,SAAS,KAAK,UAAU,CAAC,kBAAmB,QAAO,MAAM;AAE7D,OAAM,MAAM;CAEZ,MAAM,QAAQ,KAAK,KAAK;CACxB,MAAM,MAAM,MAAM;CAClB,MAAM,SAAS,MAAM,IAAI,UAAU;CACnC,MAAM,WAAW,KAAK,KAAK,GAAG;AAE9B,QAAO,IAAI;EACP,CAAC,IAAI,IAAI,OAAO,IAAI,OAAO,IAAI,WAAW,QAAQ;EAClD,CAAC,IAAI,KAAK,OAAO;EACjB,CAAC,OAAO,UAAU,EAAE,UAAU,MAAM,QAAQ,UAAU,MAAM,WAAW,QAAQ;EAC/E,CAAC,KAAK,SAAS,KAAK,MAAM;EAC7B,EAAE,IAAI"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/driver-h3",
-  "version": "0.2.4",
+  "version": "0.3.2",
   "type": "module",
   "description": "H3 driver package for Arkstack providing H3-specific implementations of core Arkstack features such as routing, middleware, and database integration.",
   "homepage": "https://arkstack.toneflix.net",
@@ -32,14 +32,16 @@
   },
   "exports": {
     ".": "./dist/index.js",
+    "./middlewares": "./dist/middlewares/index.js",
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@arkstack/contract": "^0.2.4"
+    "@arkstack/contract": "^0.3.2"
   },
   "peerDependencies": {
     "clear-router": "^2.3.3",
-    "h3": "2.0.1-rc.16"
+    "h3": "2.0.1-rc.16",
+    "@arkstack/common": "^0.3.2"
   },
   "scripts": {
     "build": "tsdown",