@arkstack/driver-express 0.4.3 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # @arkstack/driver-express
 
-Express driver package for Arkstack, providing Express-specific implementations of core Arkstack features such as routing, middleware, and database integration.
+Express driver for Arkstack, providing Express-based runtime integration for the framework.
 
 ## Auth Middleware
 

package/dist/index.js

@@ -5,7 +5,6 @@ import { Router as Router$2 } from "clear-router/express";
 import { clearRouterExpressPlugin } from "@resora/plugin-clear-router";
 import { join } from "node:path";
 import { registerPlugin } from "resora";
-
 //#region src/error-handler.ts
 const defaultErrorHandler = (err, req, res, next) => {
 	const responseBody = ErrorHandler.createErrorPayload(err);
@@ -31,10 +30,10 @@ const defaultErrorHandler = (err, req, res, next) => {
 		code
 	}));
 };
-
 //#endregion
 //#region src/Router.ts
 registerPlugin(clearRouterExpressPlugin);
+Router$2.configure({ inferParamName: true });
 var Router = class extends Router$2 {
 	static async bind() {
 		const router = express.Router();
@@ -56,7 +55,6 @@ var Router = class extends Router$2 {
 		return this.allRoutes();
 	}
 };
-
 //#endregion
 //#region src/index.ts
 /**
@@ -149,7 +147,7 @@ var ExpressDriver = class extends ArkstackKitDriver {
 		});
 	}
 };
-
 //#endregion
 export { ExpressDriver, Router, defaultErrorHandler };
+
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"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'\n\nimport type { ErrorRequestHandler } from 'express'\n\nexport const defaultErrorHandler: ErrorRequestHandler = (err, req, res, next) => {\n    const responseBody = ErrorHandler.createErrorPayload(err)\n\n    if (ErrorHandler.shouldLogError(err)) {\n        ErrorHandler.logUnhandledError(err, {\n            headers: req.headers,\n            method: req.method,\n            url: req.originalUrl || req.url,\n        }, 'Unhandled Express request error')\n    }\n\n    if (process.env.NODE_ENV === 'development') console.error(responseBody)\n\n    if (res.headersSent) {\n        next(err)\n\n        return\n    }\n\n    const acceptsHeader = Array.isArray(req.headers.accept) ? req.headers.accept.join(',') : req.headers.accept ?? ''\n    const expectsJson = acceptsHeader.includes('application/json') || req.originalUrl.startsWith('/api/')\n    const code = ErrorHandler.normalizeStatusCode(responseBody.code)\n\n    if (expectsJson) {\n        res.status(code).json(responseBody)\n\n        return\n    }\n\n    res.status(code).setHeader('Content-Type', 'text/html').send(renderError({\n        message: String(responseBody.message),\n        stack: typeof responseBody.stack === 'string' ? responseBody.stack : undefined,\n        code,\n    }))\n}\n\nexport default defaultErrorHandler\n","import { RequestException, importFile } from '@arkstack/common'\nimport express, { Router as ExpressRouter } from 'express'\n\nimport { ArkstackRouteListOptions } from '@arkstack/contract'\nimport { Router as ClearRouter } from 'clear-router/express'\nimport { type Route } from 'clear-router'\nimport { clearRouterExpressPlugin } from '@resora/plugin-clear-router'\nimport { join } from 'node:path'\nimport { registerPlugin } from 'resora'\nimport type { Handler, HttpContext, Middleware } from 'clear-router/types/express'\n\nregisterPlugin(clearRouterExpressPlugin)\n\nexport class Router extends ClearRouter {\n  static async bind (): Promise<ExpressRouter> {\n    const router = express.Router()\n\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    // Apply the registered routes to the Express application\n    ClearRouter.apply(router)\n\n    // Handle unmatched routes\n    router.all('/*splat', (req, _res, next) => {\n      const url = req.originalUrl || req.url\n      next(new RequestException(`Cannot find any route matching [${req.method}] ${url}`, 404))\n    })\n\n    return router\n  }\n\n  static async list (\n    _options: ArkstackRouteListOptions = {}\n  ): Promise<Array<Route<HttpContext, Middleware, Handler>>> {\n    await this.bind()\n\n    return this.allRoutes()\n  }\n}\n","import express, { type ErrorRequestHandler, type Express, type Handler } from 'express'\n\nimport { ArkstackKitDriver, ArkstackMiddlewareConfig, PromiseOrValue } from '@arkstack/contract'\nimport { Logger } from '@arkstack/common'\nimport { defaultErrorHandler } from './error-handler'\n\nexport interface ExpressDriverOptions {\n    bindRouter: (app: Express) => PromiseOrValue<void>;\n    mountPublicAssets?: (app: Express, publicPath: string) => PromiseOrValue<void>;\n    errorHandler?: ErrorRequestHandler | Handler;\n}\n\n/**\n * The ExpressDriver class implements the ArkstackKitDriver \n * contract for the Express framework.\n */\nexport class ExpressDriver extends ArkstackKitDriver<Express, Handler> {\n    readonly name = 'express'\n    private readonly options: ExpressDriverOptions\n\n    /**\n     * Creates an instance of ExpressDriver.\n     * \n     * @param options \n     */\n    constructor(options: ExpressDriverOptions) {\n        super()\n        this.options = options\n    }\n\n    /**\n     * Creates an Express application instance.\n     * \n     * @returns \n     */\n    createApp (): Express {\n        return express()\n    }\n\n    /**\n     * Mounts static assets from the specified public path to the Express application.\n     * \n     * @param app \n     * @param publicPath \n     */\n    mountPublicAssets (app: Express, publicPath: string): PromiseOrValue<void> {\n        if (this.options.mountPublicAssets) {\n            return this.options.mountPublicAssets(app, publicPath)\n        }\n\n        app.use(express.static(publicPath, {\n            maxAge: '1y',\n            immutable: true,\n            setHeaders: (res) => {\n                res.setHeader('Access-Control-Allow-Origin', '*')\n                res.setHeader('Access-Control-Allow-Methods', 'GET, HEAD, OPTIONS')\n                res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization')\n            },\n        }))\n    }\n\n    /**\n     * Binds the router to the Express application using the provided bindRouter function.\n     * \n     * @param app \n     */\n    bindRouter (app: Express): PromiseOrValue<void> {\n        return this.options.bindRouter(app)\n    }\n\n    /**\n     * Applies middleware to the Express application.\n     * \n     * @param app \n     * @param middleware \n     */\n    applyMiddleware (\n        app: Express,\n        middleware: Handler | ArkstackMiddlewareConfig<Handler>,\n    ): void {\n        if (typeof middleware === 'function') {\n            app.use(middleware)\n\n            return\n        }\n\n        for (const [pos, entries] of Object.entries(middleware) as [string, Handler[]][]) {\n            for (const entry of entries) {\n                if (pos === 'after') {\n                    app.use(async (req, res, next) => {\n                        res.once('finish', async () => {\n                            await entry(req, res, next)\n                        })\n                        next()\n                    })\n                } else {\n                    app.use(entry)\n                }\n            }\n        }\n    }\n\n    /**\n     * Registers an error handler middleware to the Express \n     * application if provided in the options.\n     * \n     * @param app \n     */\n    registerErrorHandler (app: Express): void {\n        app.use((this.options.errorHandler ?? defaultErrorHandler) as ErrorRequestHandler)\n    }\n\n    /**\n     * Starts the Express server on the specified port.\n     * \n     * @param app \n     * @param port \n     */\n    start (app: Express, port: number): void {\n        app.listen(port, () => {\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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"}
+{"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'\n\nimport type { ErrorRequestHandler } from 'express'\n\nexport const defaultErrorHandler: ErrorRequestHandler = (err, req, res, next) => {\n    const responseBody = ErrorHandler.createErrorPayload(err)\n\n    if (ErrorHandler.shouldLogError(err)) {\n        ErrorHandler.logUnhandledError(err, {\n            headers: req.headers,\n            method: req.method,\n            url: req.originalUrl || req.url,\n        }, 'Unhandled Express request error')\n    }\n\n    if (process.env.NODE_ENV === 'development') console.error(responseBody)\n\n    if (res.headersSent) {\n        next(err)\n\n        return\n    }\n\n    const acceptsHeader = Array.isArray(req.headers.accept) ? req.headers.accept.join(',') : req.headers.accept ?? ''\n    const expectsJson = acceptsHeader.includes('application/json') || req.originalUrl.startsWith('/api/')\n    const code = ErrorHandler.normalizeStatusCode(responseBody.code)\n\n    if (expectsJson) {\n        res.status(code).json(responseBody)\n\n        return\n    }\n\n    res.status(code).setHeader('Content-Type', 'text/html').send(renderError({\n        message: String(responseBody.message),\n        stack: typeof responseBody.stack === 'string' ? responseBody.stack : undefined,\n        code,\n    }))\n}\n\nexport default defaultErrorHandler\n","import { RequestException, importFile } from '@arkstack/common'\nimport express, { Router as ExpressRouter } from 'express'\n\nimport { ArkstackRouteListOptions } from '@arkstack/contract'\nimport { Router as ClearRouter } from 'clear-router/express'\nimport { type Route } from 'clear-router'\nimport { clearRouterExpressPlugin } from '@resora/plugin-clear-router'\nimport { join } from 'node:path'\nimport { registerPlugin } from 'resora'\nimport type { Handler, HttpContext, Middleware } from 'clear-router/types/express'\n\nregisterPlugin(clearRouterExpressPlugin)\nClearRouter.configure({\n  inferParamName: true\n})\n\nexport class Router extends ClearRouter {\n  static async bind (): Promise<ExpressRouter> {\n    const router = express.Router()\n\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    // Apply the registered routes to the Express application\n    ClearRouter.apply(router)\n\n    // Handle unmatched routes\n    router.all('/*splat', (req, _res, next) => {\n      const url = req.originalUrl || req.url\n      next(new RequestException(`Cannot find any route matching [${req.method}] ${url}`, 404))\n    })\n\n    return router\n  }\n\n  static async list (\n    _options: ArkstackRouteListOptions = {}\n  ): Promise<Array<Route<HttpContext, Middleware, Handler>>> {\n    await this.bind()\n\n    return this.allRoutes() as never\n  }\n}\n","import express, { type ErrorRequestHandler, type Express, type Handler } from 'express'\n\nimport { ArkstackKitDriver, ArkstackMiddlewareConfig, PromiseOrValue } from '@arkstack/contract'\nimport { Logger } from '@arkstack/common'\nimport { defaultErrorHandler } from './error-handler'\n\nexport interface ExpressDriverOptions {\n    bindRouter: (app: Express) => PromiseOrValue<void>;\n    mountPublicAssets?: (app: Express, publicPath: string) => PromiseOrValue<void>;\n    errorHandler?: ErrorRequestHandler | Handler;\n}\n\n/**\n * The ExpressDriver class implements the ArkstackKitDriver \n * contract for the Express framework.\n */\nexport class ExpressDriver extends ArkstackKitDriver<Express, Handler> {\n    readonly name = 'express'\n    private readonly options: ExpressDriverOptions\n\n    /**\n     * Creates an instance of ExpressDriver.\n     * \n     * @param options \n     */\n    constructor(options: ExpressDriverOptions) {\n        super()\n        this.options = options\n    }\n\n    /**\n     * Creates an Express application instance.\n     * \n     * @returns \n     */\n    createApp (): Express {\n        return express()\n    }\n\n    /**\n     * Mounts static assets from the specified public path to the Express application.\n     * \n     * @param app \n     * @param publicPath \n     */\n    mountPublicAssets (app: Express, publicPath: string): PromiseOrValue<void> {\n        if (this.options.mountPublicAssets) {\n            return this.options.mountPublicAssets(app, publicPath)\n        }\n\n        app.use(express.static(publicPath, {\n            maxAge: '1y',\n            immutable: true,\n            setHeaders: (res) => {\n                res.setHeader('Access-Control-Allow-Origin', '*')\n                res.setHeader('Access-Control-Allow-Methods', 'GET, HEAD, OPTIONS')\n                res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization')\n            },\n        }))\n    }\n\n    /**\n     * Binds the router to the Express application using the provided bindRouter function.\n     * \n     * @param app \n     */\n    bindRouter (app: Express): PromiseOrValue<void> {\n        return this.options.bindRouter(app)\n    }\n\n    /**\n     * Applies middleware to the Express application.\n     * \n     * @param app \n     * @param middleware \n     */\n    applyMiddleware (\n        app: Express,\n        middleware: Handler | ArkstackMiddlewareConfig<Handler>,\n    ): void {\n        if (typeof middleware === 'function') {\n            app.use(middleware)\n\n            return\n        }\n\n        for (const [pos, entries] of Object.entries(middleware) as [string, Handler[]][]) {\n            for (const entry of entries) {\n                if (pos === 'after') {\n                    app.use(async (req, res, next) => {\n                        res.once('finish', async () => {\n                            await entry(req, res, next)\n                        })\n                        next()\n                    })\n                } else {\n                    app.use(entry)\n                }\n            }\n        }\n    }\n\n    /**\n     * Registers an error handler middleware to the Express \n     * application if provided in the options.\n     * \n     * @param app \n     */\n    registerErrorHandler (app: Express): void {\n        app.use((this.options.errorHandler ?? defaultErrorHandler) as ErrorRequestHandler)\n    }\n\n    /**\n     * Starts the Express server on the specified port.\n     * \n     * @param app \n     * @param port \n     */\n    start (app: Express, port: number): void {\n        app.listen(port, () => {\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/index.d.ts

@@ -1,8 +1,12 @@
 import { Handler, NextFunction, Request, Response } from "express";
+import multer from "multer";
 
 //#region src/middlewares/auth.d.ts
 declare const auth: Handler;
 //#endregion
+//#region src/middlewares/formdata.d.ts
+declare const formdata: multer.Multer;
+//#endregion
 //#region src/middlewares/request-logger.d.ts
 declare const requestLogger: ({
   allowInProduction
@@ -10,5 +14,5 @@ declare const requestLogger: ({
   allowInProduction?: boolean;
 }) => (req: Request, res: Response, next: NextFunction) => Promise<void>;
 //#endregion
-export { auth, requestLogger };
+export { auth, formdata, requestLogger };
 //# sourceMappingURL=index.d.ts.map

package/dist/middlewares/index.js

@@ -1,6 +1,6 @@
 import { Hook, Logger, nodeEnv } from "@arkstack/common";
 import { Auth, AuthenticationException } from "@arkstack/auth";
-
+import multer from "multer";
 //#region src/middlewares/auth.ts
 const auth = async (req, res, next) => {
 	try {
@@ -37,7 +37,9 @@ const readBearerToken = (authorization) => {
 	if (!value?.startsWith("Bearer ")) return null;
 	return value.substring(7);
 };
-
+//#endregion
+//#region src/middlewares/formdata.ts
+const formdata = multer({ storage: multer.memoryStorage() });
 //#endregion
 //#region src/middlewares/request-logger.ts
 const colors = {
@@ -67,7 +69,7 @@ const requestLogger = ({ allowInProduction = false } = {}) => async (req, res, n
 	], " ");
 	next();
 };
-
 //#endregion
-export { auth, requestLogger };
+export { auth, formdata, requestLogger };
+
 //# sourceMappingURL=index.js.map

package/dist/middlewares/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/middlewares/auth.ts","../../src/middlewares/request-logger.ts"],"sourcesContent":["import { Auth, AuthenticationException } from '@arkstack/auth'\n\nimport type { Handler } from 'express'\nimport { Hook } from '@arkstack/common'\n\nexport const auth: Handler = async (req, res, next) => {\n    try {\n        if (Hook.has('middleware:auth', 'before'))\n            Hook.get('middleware:auth', 'before')?.({ req, res })\n\n        const token = readBearerToken(req.headers.authorization)\n\n        if (!token) {\n            throw new AuthenticationException('Unauthenticated', { req, status: 401 })\n        }\n\n        const auth = Auth.make().setRequest(req)\n        const user = await Auth.make().setRequest(req).authorizeToken(token)\n\n        req.user = user\n        req.auth = auth\n        req.authUser = user\n        req.authToken = token\n\n        if (Hook.has('middleware:auth', 'after'))\n            Hook.get('middleware:auth', 'after')?.({ req, res })\n\n        next()\n    } catch (error) {\n        if (Hook.has('middleware:auth', 'error'))\n            Hook.get('middleware:auth', 'error')?.(error, { req, res })\n\n        next(error)\n    }\n}\n\nconst readBearerToken = (authorization: string | string[] | undefined) => {\n    const value = Array.isArray(authorization) ? authorization[0] : authorization\n\n    if (!value?.startsWith('Bearer ')) {\n        return null\n    }\n\n    return value.substring(7)\n}\n","import { Logger, nodeEnv } from '@arkstack/common'\nimport { NextFunction, Request, Response } from 'express'\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 \n */\nexport const requestLogger = ({\n    allowInProduction = false,\n}: {\n    allowInProduction?: boolean\n} = {}) => async (req: Request, res: Response, next: NextFunction) => {\n    if (nodeEnv() === 'prod' && !allowInProduction) return next()\n\n    const start = Date.now()\n\n    const status = res.statusCode || 200\n    const duration = Date.now() - start\n    Logger.log([\n        [`[${req.method}]`, colors[req.method] || 'white'],\n        [req.url, 'cyan'],\n        [status.toString(), status >= 500 ? 'red' : status >= 400 ? 'yellow' : 'green'],\n        [`- ${duration}ms`, 'dim']\n    ], ' ')\n\n    next()\n}"],"mappings":";;;;AAKA,MAAa,OAAgB,OAAO,KAAK,KAAK,SAAS;AACnD,KAAI;AACA,MAAI,KAAK,IAAI,mBAAmB,SAAS,CACrC,MAAK,IAAI,mBAAmB,SAAS,GAAG;GAAE;GAAK;GAAK,CAAC;EAEzD,MAAM,QAAQ,gBAAgB,IAAI,QAAQ,cAAc;AAExD,MAAI,CAAC,MACD,OAAM,IAAI,wBAAwB,mBAAmB;GAAE;GAAK,QAAQ;GAAK,CAAC;EAG9E,MAAM,OAAO,KAAK,MAAM,CAAC,WAAW,IAAI;EACxC,MAAM,OAAO,MAAM,KAAK,MAAM,CAAC,WAAW,IAAI,CAAC,eAAe,MAAM;AAEpE,MAAI,OAAO;AACX,MAAI,OAAO;AACX,MAAI,WAAW;AACf,MAAI,YAAY;AAEhB,MAAI,KAAK,IAAI,mBAAmB,QAAQ,CACpC,MAAK,IAAI,mBAAmB,QAAQ,GAAG;GAAE;GAAK;GAAK,CAAC;AAExD,QAAM;UACD,OAAO;AACZ,MAAI,KAAK,IAAI,mBAAmB,QAAQ,CACpC,MAAK,IAAI,mBAAmB,QAAQ,GAAG,OAAO;GAAE;GAAK;GAAK,CAAC;AAE/D,OAAK,MAAM;;;AAInB,MAAM,mBAAmB,kBAAiD;CACtE,MAAM,QAAQ,MAAM,QAAQ,cAAc,GAAG,cAAc,KAAK;AAEhE,KAAI,CAAC,OAAO,WAAW,UAAU,CAC7B,QAAO;AAGX,QAAO,MAAM,UAAU,EAAE;;;;;ACxC7B,MAAM,SAAuE;CACzE,KAAK;CACL,MAAM;CACN,KAAK;CACL,QAAQ;CACR,OAAO;CACV;;;;;;;;AASD,MAAa,iBAAiB,EAC1B,oBAAoB,UAGpB,EAAE,KAAK,OAAO,KAAc,KAAe,SAAuB;AAClE,KAAI,SAAS,KAAK,UAAU,CAAC,kBAAmB,QAAO,MAAM;CAE7D,MAAM,QAAQ,KAAK,KAAK;CAExB,MAAM,SAAS,IAAI,cAAc;CACjC,MAAM,WAAW,KAAK,KAAK,GAAG;AAC9B,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;AAEP,OAAM"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/middlewares/auth.ts","../../src/middlewares/formdata.ts","../../src/middlewares/request-logger.ts"],"sourcesContent":["import { Auth, AuthenticationException } from '@arkstack/auth'\n\nimport type { Handler } from 'express'\nimport { Hook } from '@arkstack/common'\n\nexport const auth: Handler = async (req, res, next) => {\n    try {\n        if (Hook.has('middleware:auth', 'before'))\n            Hook.get('middleware:auth', 'before')?.({ req, res })\n\n        const token = readBearerToken(req.headers.authorization)\n\n        if (!token) {\n            throw new AuthenticationException('Unauthenticated', { req, status: 401 })\n        }\n\n        const auth = Auth.make().setRequest(req)\n        const user = await Auth.make().setRequest(req).authorizeToken(token)\n\n        req.user = user\n        req.auth = auth\n        req.authUser = user\n        req.authToken = token\n\n        if (Hook.has('middleware:auth', 'after'))\n            Hook.get('middleware:auth', 'after')?.({ req, res })\n\n        next()\n    } catch (error) {\n        if (Hook.has('middleware:auth', 'error'))\n            Hook.get('middleware:auth', 'error')?.(error, { req, res })\n\n        next(error)\n    }\n}\n\nconst readBearerToken = (authorization: string | string[] | undefined) => {\n    const value = Array.isArray(authorization) ? authorization[0] : authorization\n\n    if (!value?.startsWith('Bearer ')) {\n        return null\n    }\n\n    return value.substring(7)\n}\n","import multer from 'multer'\n\nexport const formdata = multer({ storage: multer.memoryStorage() })","import { Logger, nodeEnv } from '@arkstack/common'\nimport { NextFunction, Request, Response } from 'express'\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 \n */\nexport const requestLogger = ({\n    allowInProduction = false,\n}: {\n    allowInProduction?: boolean\n} = {}) => async (req: Request, res: Response, next: NextFunction) => {\n    if (nodeEnv() === 'prod' && !allowInProduction) return next()\n\n    const start = Date.now()\n\n    const status = res.statusCode || 200\n    const duration = Date.now() - start\n    Logger.log([\n        [`[${req.method}]`, colors[req.method] || 'white'],\n        [req.url, 'cyan'],\n        [status.toString(), status >= 500 ? 'red' : status >= 400 ? 'yellow' : 'green'],\n        [`- ${duration}ms`, 'dim']\n    ], ' ')\n\n    next()\n}"],"mappings":";;;;AAKA,MAAa,OAAgB,OAAO,KAAK,KAAK,SAAS;CACnD,IAAI;EACA,IAAI,KAAK,IAAI,mBAAmB,SAAS,EACrC,KAAK,IAAI,mBAAmB,SAAS,GAAG;GAAE;GAAK;GAAK,CAAC;EAEzD,MAAM,QAAQ,gBAAgB,IAAI,QAAQ,cAAc;EAExD,IAAI,CAAC,OACD,MAAM,IAAI,wBAAwB,mBAAmB;GAAE;GAAK,QAAQ;GAAK,CAAC;EAG9E,MAAM,OAAO,KAAK,MAAM,CAAC,WAAW,IAAI;EACxC,MAAM,OAAO,MAAM,KAAK,MAAM,CAAC,WAAW,IAAI,CAAC,eAAe,MAAM;EAEpE,IAAI,OAAO;EACX,IAAI,OAAO;EACX,IAAI,WAAW;EACf,IAAI,YAAY;EAEhB,IAAI,KAAK,IAAI,mBAAmB,QAAQ,EACpC,KAAK,IAAI,mBAAmB,QAAQ,GAAG;GAAE;GAAK;GAAK,CAAC;EAExD,MAAM;UACD,OAAO;EACZ,IAAI,KAAK,IAAI,mBAAmB,QAAQ,EACpC,KAAK,IAAI,mBAAmB,QAAQ,GAAG,OAAO;GAAE;GAAK;GAAK,CAAC;EAE/D,KAAK,MAAM;;;AAInB,MAAM,mBAAmB,kBAAiD;CACtE,MAAM,QAAQ,MAAM,QAAQ,cAAc,GAAG,cAAc,KAAK;CAEhE,IAAI,CAAC,OAAO,WAAW,UAAU,EAC7B,OAAO;CAGX,OAAO,MAAM,UAAU,EAAE;;;;ACzC7B,MAAa,WAAW,OAAO,EAAE,SAAS,OAAO,eAAe,EAAE,CAAA;;;ACClE,MAAM,SAAuE;CACzE,KAAK;CACL,MAAM;CACN,KAAK;CACL,QAAQ;CACR,OAAO;CACV;;;;;;;;AASD,MAAa,iBAAiB,EAC1B,oBAAoB,UAGpB,EAAE,KAAK,OAAO,KAAc,KAAe,SAAuB;CAClE,IAAI,SAAS,KAAK,UAAU,CAAC,mBAAmB,OAAO,MAAM;CAE7D,MAAM,QAAQ,KAAK,KAAK;CAExB,MAAM,SAAS,IAAI,cAAc;CACjC,MAAM,WAAW,KAAK,KAAK,GAAG;CAC9B,OAAO,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;CAEP,MAAM"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@arkstack/driver-express",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "type": "module",
-  "description": "Express driver package for Arkstack providing Express-specific implementations of core Arkstack features such as routing, middleware, and database integration.",
+  "description": "Express driver for Arkstack, providing Express-based runtime integration for the framework.",
   "homepage": "https://arkstack.toneflix.net",
   "repository": {
     "type": "git",
@@ -36,16 +36,17 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "clear-router": "^2.5.4",
+    "multer": "^2.1.1",
+    "clear-router": "^2.6.4",
     "express-rate-limit": "^8.4.1",
-    "@resora/plugin-clear-router": "^1.0.3",
-    "resora": "^1.2.0",
-    "@arkstack/contract": "^0.4.3"
+    "@resora/plugin-clear-router": "^1.0.14",
+    "resora": "^1.2.3",
+    "@arkstack/contract": "^0.5.0"
   },
   "peerDependencies": {
     "express": "^5.2.1",
-    "@arkstack/auth": "^0.4.3",
-    "@arkstack/common": "^0.4.3"
+    "@arkstack/auth": "^0.5.0",
+    "@arkstack/common": "^0.5.0"
   },
   "peerDependenciesMeta": {
     "@arkstack/auth": {
@@ -53,6 +54,7 @@
     }
   },
   "devDependencies": {
+    "@types/multer": "^2.1.0",
     "@types/express": "^5.0.6"
   },
   "scripts": {

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/error-handler.ts","../src/Router.ts","../src/index.ts"],"mappings":";;;;;;;cAOa,mBAAA,EAAqB,mBAAA;;;cCMrB,MAAA,SAAe,QAAA;EAAA,OACb,IAAA,CAAA,GAAS,OAAA,CAAQ,QAAA;EAAA,OAyBjB,IAAA,CACX,QAAA,GAAU,wBAAA,GACT,OAAA,CAAQ,KAAA,CAAM,KAAA,CAAM,WAAA,EAAa,UAAA,EAAY,SAAA;AAAA;;;UCnCjC,oBAAA;EACb,UAAA,GAAa,GAAA,EAAK,OAAA,KAAY,cAAA;EAC9B,iBAAA,IAAqB,GAAA,EAAK,OAAA,EAAS,UAAA,aAAuB,cAAA;EAC1D,YAAA,GAAe,mBAAA,GAAsB,OAAA;AAAA;AAAA,cAO5B,aAAA,SAAsB,iBAAA,CAAkB,OAAA,EAAS,OAAA;EAAA,SACjD,IAAA;EAAA,iBACQ,OAAA;cAOL,OAAA,EAAS,oBAAA;EAUrB,SAAA,CAAA,GAAc,OAAA;EAUd,iBAAA,CAAmB,GAAA,EAAK,OAAA,EAAS,UAAA,WAAqB,cAAA;EAqBtD,UAAA,CAAY,GAAA,EAAK,OAAA,GAAU,cAAA;EAU3B,eAAA,CACI,GAAA,EAAK,OAAA,EACL,UAAA,EAAY,OAAA,GAAU,wBAAA,CAAyB,OAAA;EA8BnD,oBAAA,CAAsB,GAAA,EAAK,OAAA;EAU3B,KAAA,CAAO,GAAA,EAAK,OAAA,EAAS,IAAA;AAAA"}

package/dist/middlewares/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/middlewares/auth.ts","../../src/middlewares/request-logger.ts"],"mappings":";;;cAKa,IAAA,EAAM,OAAA;;;cCaN,aAAA;EAAiB;AAAA;EAG1B,iBAAA;AAAA,OACc,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA,KAAY,OAAA"}