express-fastify-runtime 0.1.0

package/dist/runtime/lifecycle.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Boot, lock, listen. Compile once; no dynamic routing.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApp = createApp;
+const fastify_1 = __importDefault(require("fastify"));
+const classify_1 = require("../app/classify");
+const engine_1 = require("../express/engine");
+const mount_1 = require("../express/mount");
+const register_1 = require("../fastify/register");
+const populateExpress_1 = require("./populateExpress");
+const assert_1 = require("../utils/assert");
+const errorHandler_1 = require("./errorHandler");
+const request_1 = require("../fastify/adapters/request");
+const response_1 = require("../fastify/adapters/response");
+const RouteStore_1 = require("../app/RouteStore");
+const flattenRouter_1 = require("../app/flattenRouter");
+const path_1 = require("../utils/path");
+const runtimeLogger_1 = require("../utils/runtimeLogger");
+function createApp(options) {
+    const routeStore = new RouteStore_1.RouteStore();
+    const locked = { current: false };
+    const runtimeLogger = (0, runtimeLogger_1.createRuntimeLogger)(options);
+    const app = {
+        use(pathOrHandler, ...handlers) {
+            (0, assert_1.assertNotLocked)(locked.current);
+            const path = typeof pathOrHandler === 'string' ? (0, path_1.normalizePath)(pathOrHandler) : '/';
+            const allHandlers = typeof pathOrHandler === 'string' ? handlers : [pathOrHandler, ...handlers];
+            let middlewareGroup = [];
+            for (const h of allHandlers) {
+                if ((0, flattenRouter_1.isExpressRouter)(h)) {
+                    if (middlewareGroup.length > 0) {
+                        routeStore.addMiddleware(path, ...middlewareGroup);
+                        middlewareGroup = [];
+                    }
+                    const flat = (0, flattenRouter_1.flattenRouter)(h, path);
+                    if (flat !== null) {
+                        routeStore.addEntries(flat);
+                    }
+                    else {
+                        runtimeLogger.warnDowngrade('express.Router (middleware or RegExp path). Tip: import express-fastify-runtime before Express or routers so middleware paths can be detected');
+                        routeStore.addMiddleware(path, h);
+                    }
+                }
+                else {
+                    middlewareGroup.push(h);
+                }
+            }
+            if (middlewareGroup.length > 0) {
+                routeStore.addMiddleware(path, ...middlewareGroup);
+            }
+            return app;
+        },
+        get(path, ...handlers) {
+            (0, assert_1.assertNotLocked)(locked.current);
+            routeStore.addRoute('get', path, ...handlers);
+            return app;
+        },
+        post(path, ...handlers) {
+            (0, assert_1.assertNotLocked)(locked.current);
+            routeStore.addRoute('post', path, ...handlers);
+            return app;
+        },
+        put(path, ...handlers) {
+            (0, assert_1.assertNotLocked)(locked.current);
+            routeStore.addRoute('put', path, ...handlers);
+            return app;
+        },
+        patch(path, ...handlers) {
+            (0, assert_1.assertNotLocked)(locked.current);
+            routeStore.addRoute('patch', path, ...handlers);
+            return app;
+        },
+        delete(path, ...handlers) {
+            (0, assert_1.assertNotLocked)(locked.current);
+            routeStore.addRoute('delete', path, ...handlers);
+            return app;
+        },
+        head(path, ...handlers) {
+            (0, assert_1.assertNotLocked)(locked.current);
+            routeStore.addRoute('head', path, ...handlers);
+            return app;
+        },
+        options(path, ...handlers) {
+            (0, assert_1.assertNotLocked)(locked.current);
+            routeStore.addRoute('options', path, ...handlers);
+            return app;
+        },
+        all(path, ...handlers) {
+            (0, assert_1.assertNotLocked)(locked.current);
+            routeStore.addRoute('all', path, ...handlers);
+            return app;
+        },
+        listen(port, host, callback) {
+            let cb;
+            let p;
+            let h;
+            if (typeof port === 'function') {
+                cb = port;
+                p = undefined;
+                h = undefined;
+            }
+            else if (typeof host === 'function') {
+                cb = host;
+                p = port;
+                h = undefined;
+            }
+            else {
+                p = port;
+                h = host;
+                cb = callback;
+            }
+            locked.current = true;
+            const express = (0, engine_1.createExpressEngine)();
+            (0, populateExpress_1.populateExpressApp)(express, routeStore);
+            const fastify = (0, fastify_1.default)({
+                logger: false,
+                bodyLimit: 10 * 1024 * 1024, // 10MB; matches express.json({ limit: '10mb' }) for large payloads
+            });
+            const classified = (0, classify_1.classifyAll)(routeStore.getAll());
+            const runMiddleware = (_req, _res, next) => next();
+            (0, register_1.registerCompiledRoutes)(fastify, classified, runMiddleware);
+            // Wire Express 4-arg error middleware → Fastify error handler so next(err)/throw on the
+            // Fastify lane reaches it (parity with fast()). The error mw is excluded from the normal
+            // middleware chain (see compile.ts), so it only runs here.
+            const errorMiddleware = (0, errorHandler_1.findErrorMiddleware)(routeStore.getAll());
+            if (errorMiddleware) {
+                fastify.setErrorHandler((0, errorHandler_1.wrapErrorHandler)(errorMiddleware, (0, request_1.createRequestAdapter)(), response_1.adaptResponse));
+            }
+            (0, mount_1.mountExpress)(fastify, express);
+            const listenOpts = { port: p ?? 0, host: h ?? '0.0.0.0' };
+            const listenPromise = fastify.listen(listenOpts);
+            if (cb) {
+                listenPromise.then(() => cb(), (err) => cb?.(err));
+            }
+            return listenPromise.then(() => ({
+                close(closeCb) {
+                    return fastify.close().then(() => closeCb?.(), (err) => closeCb?.(err));
+                },
+                address() {
+                    return fastify.server?.address() ?? null;
+                },
+            }));
+        },
+    };
+    return app;
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/runtime/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/runtime/lifecycle.ts"],"names":[],"mappings":"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"}

package/dist/runtime/populateExpress.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Populate real Express app from RouteStore (all middleware + routes).
+ */
+import type { Application } from 'express';
+import type { RouteStore } from '../app/RouteStore';
+export declare function populateExpressApp(expressApp: Application, store: RouteStore): void;
+//# sourceMappingURL=populateExpress.d.ts.map

package/dist/runtime/populateExpress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"populateExpress.d.ts","sourceRoot":"","sources":["../../src/runtime/populateExpress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAgBnF"}

package/dist/runtime/populateExpress.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Populate real Express app from RouteStore (all middleware + routes).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.populateExpressApp = populateExpressApp;
+const path_1 = require("../utils/path");
+function populateExpressApp(expressApp, store) {
+    const entries = store.getAll();
+    for (const entry of entries) {
+        if (entry.type === 'middleware') {
+            const path = (0, path_1.normalizePath)(entry.path);
+            expressApp.use(path, ...entry.handlers);
+        }
+        else {
+            const path = (0, path_1.normalizePath)(entry.path);
+            const method = entry.method === 'all' ? 'all' : entry.method;
+            if (method === 'all') {
+                expressApp.all(path, ...entry.handlers);
+            }
+            else {
+                expressApp[method](path, ...entry.handlers);
+            }
+        }
+    }
+}
+//# sourceMappingURL=populateExpress.js.map

package/dist/runtime/populateExpress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"populateExpress.js","sourceRoot":"","sources":["../../src/runtime/populateExpress.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAMH,gDAgBC;AAlBD,wCAA8C;AAE9C,SAAgB,kBAAkB,CAAC,UAAuB,EAAE,KAAiB;IAC3E,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,IAAA,oBAAa,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,GAAI,KAAK,CAAC,QAAgB,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,IAAA,oBAAa,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,KAAK,CAAC,MAA2E,CAAC;YACnI,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBACpB,UAAkB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACL,UAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/types/express.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Express-like types for the compatibility API.
+ * req, res, next - what users write against.
+ * Extended to cover Express 5.x response and request API used in adapters.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/** Cookie options (Express-compatible shape). */
+export interface CookieOptions {
+    maxAge?: number;
+    signed?: boolean;
+    expires?: Date;
+    httpOnly?: boolean;
+    path?: string;
+    domain?: string;
+    secure?: boolean;
+    sameSite?: boolean | 'lax' | 'strict' | 'none';
+}
+export type ExpressRequest = IncomingMessage & {
+    body?: unknown;
+    query?: Record<string, string | string[]>;
+    params?: Record<string, string>;
+    url: string;
+    baseUrl: string;
+    originalUrl: string;
+    path?: string;
+    method?: string;
+    headers?: IncomingMessage['headers'];
+    get(name: string): string | undefined;
+    header(name: string): string | undefined;
+    /** Trust proxy: protocol, ip, hostname, etc. (adapter-derived when possible). */
+    protocol?: string;
+    secure?: boolean;
+    ip?: string;
+    ips?: string[];
+    hostname?: string;
+    host?: string;
+    /** Accepts (Accept header); stub or parsed. */
+    accepts?(...types: string[]): string | false | string[];
+    acceptsCharsets?(...charsets: string[]): string | false | string[];
+    acceptsEncodings?(...encodings: string[]): string | false | string[];
+    acceptsLanguages?(...langs: string[]): string | false | string[];
+    is?(type: string): string | false;
+    range?(size: number, options?: {
+        combine?: boolean;
+    }): unknown;
+    xhr?: boolean;
+    fresh?: boolean;
+    stale?: boolean;
+    cookies?: Record<string, string>;
+    signedCookies?: Record<string, string>;
+    app?: unknown;
+    res?: ExpressResponse;
+    next?: unknown;
+    route?: unknown;
+};
+export type ExpressResponse = ServerResponse & {
+    status(code: number): ExpressResponse;
+    send(body?: unknown): ExpressResponse;
+    json(body?: unknown): ExpressResponse;
+    set(field: string | Record<string, string>, value?: string | string[]): ExpressResponse;
+    setHeader(name: string, value: string | number | string[]): ServerResponse;
+    removeHeader(name: string): ExpressResponse;
+    header(field: string | Record<string, string>, value?: string | string[]): ExpressResponse;
+    sendStatus(code: number): ExpressResponse;
+    links(links: Record<string, string>): ExpressResponse;
+    jsonp(body?: unknown): ExpressResponse;
+    type(type: string): ExpressResponse;
+    contentType(type: string): ExpressResponse;
+    format(obj: Record<string, (() => void) | (() => Promise<void>)>): ExpressResponse;
+    attachment(filename?: string): ExpressResponse;
+    append(field: string, value: string | string[]): ExpressResponse;
+    get(field: string): string | undefined;
+    getHeader(name: string): string | number | string[] | undefined;
+    clearCookie(name: string, options?: CookieOptions): ExpressResponse;
+    cookie(name: string, val: string | object, options?: CookieOptions): ExpressResponse;
+    location(url: string): ExpressResponse;
+    redirect(url: string): ExpressResponse;
+    redirect(status: number, url: string): ExpressResponse;
+    vary(field: string): ExpressResponse;
+    end(cb?: () => void): ServerResponse;
+    end(chunk: unknown, encoding?: BufferEncoding, cb?: () => void): ServerResponse;
+    /** View engine render (Express lane only; on Fastify lane we send 501 + dev warning). */
+    render?(view: string, locals?: Record<string, unknown>, callback?: (err: Error | null, html?: string) => void): ExpressResponse;
+    /** Per-request response locals (Express-compatible). */
+    locals: Record<string, unknown>;
+    headersSent: boolean;
+    app?: unknown;
+    req?: ExpressRequest;
+    charset?: string;
+};
+export type NextFunction = (err?: Error | unknown) => void;
+export type ExpressMiddleware = (req: ExpressRequest, res: ExpressResponse, next: NextFunction) => void | Promise<void>;
+export type ExpressErrorMiddleware = (err: Error, req: ExpressRequest, res: ExpressResponse, next: NextFunction) => void | Promise<void>;
+export type ExpressHandler = ExpressMiddleware | ExpressErrorMiddleware;
+export declare const HTTP_METHODS: readonly ["get", "post", "put", "patch", "delete", "head", "options", "all"];
+export type HttpMethod = (typeof HTTP_METHODS)[number];
+//# sourceMappingURL=express.d.ts.map

package/dist/types/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/types/express.ts"],"names":[],"mappings":"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"}

package/dist/types/express.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Express-like types for the compatibility API.
+ * req, res, next - what users write against.
+ * Extended to cover Express 5.x response and request API used in adapters.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTTP_METHODS = void 0;
+exports.HTTP_METHODS = [
+    'get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'all'
+];
+//# sourceMappingURL=express.js.map

package/dist/types/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/types/express.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AA8GU,QAAA,YAAY,GAAG;IAC1B,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK;CACzD,CAAC"}

package/dist/types/internal.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Internal compiler and runtime types.
+ * use() accepts Express Router so app.use("/api", router) type-checks (Express-compatible).
+ */
+import type { FastifyInstance, FastifyRequest, FastifyReply } from "fastify";
+import type { ExpressRequest, ExpressResponse, ExpressHandler } from "./express";
+import type { Router } from "express";
+/**
+ * Server-like object returned by app.listen().
+ * Express returns http.Server; we return a Promise that resolves to this,
+ * so you can call close() (and address()) like with Node's server.
+ */
+export interface ServerLike {
+    /** Stop accepting new connections. Same idea as http.Server#close(). */
+    close(callback?: (err?: Error) => void): Promise<void>;
+    /** Bound address after listen (port, address, family). Same shape as http.Server#address(). */
+    address(): ReturnType<import("node:net").Server["address"]>;
+}
+export type RouteEntry = {
+    type: "middleware";
+    path: string;
+    handlers: ExpressHandler[];
+} | {
+    type: "route";
+    method: string;
+    path: string;
+    handlers: ExpressHandler[];
+};
+export type Lane = "fastify" | "express";
+export type ClassifiedRoute = RouteEntry & {
+    lane: Lane;
+    /** If true, this route/middleware requires Express (unsafe for Fastify). */
+    expressRequired: boolean;
+};
+/** Handlers accepted in use(); includes Router so app.use("/api", router) type-checks. */
+export type UseHandler = ExpressHandler | Router;
+export interface ExpressLikeApp {
+    use(...handlers: UseHandler[]): this;
+    use(pathOrHandler: string | UseHandler, ...handlers: UseHandler[]): this;
+    get(path: string, ...handlers: ExpressHandler[]): this;
+    post(path: string, ...handlers: ExpressHandler[]): this;
+    put(path: string, ...handlers: ExpressHandler[]): this;
+    patch(path: string, ...handlers: ExpressHandler[]): this;
+    delete(path: string, ...handlers: ExpressHandler[]): this;
+    head(path: string, ...handlers: ExpressHandler[]): this;
+    options(path: string, ...handlers: ExpressHandler[]): this;
+    all(path: string, ...handlers: ExpressHandler[]): this;
+    /** Listen with optional port, host, and callback. Returns Promise<ServerLike> (Express returns http.Server; we are async). */
+    listen(port?: number, host?: string, callback?: (err?: Error) => void): Promise<ServerLike>;
+    listen(port: number, callback?: (err?: Error) => void): Promise<ServerLike>;
+    listen(callback?: (err?: Error) => void): Promise<ServerLike>;
+}
+export type RequestAdapter = (fastifyReq: FastifyRequest) => ExpressRequest;
+export type ResponseAdapter = (fastifyReply: FastifyReply, fastifyReq: FastifyRequest) => ExpressResponse;
+export interface RuntimeContext {
+    fastify: FastifyInstance;
+    expressApp: import("express").Application;
+    locked: boolean;
+}
+//# sourceMappingURL=internal.d.ts.map

package/dist/types/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/types/internal.ts"],"names":[],"mappings":"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"}

package/dist/types/internal.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Internal compiler and runtime types.
+ * use() accepts Express Router so app.use("/api", router) type-checks (Express-compatible).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=internal.js.map

package/dist/types/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/types/internal.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/utils/assert.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Fail-fast helpers. No silent failures.
+ */
+export declare function assertNotLocked(locked: boolean): void;
+export declare function failUnsupportedFeature(feature: string): never;
+//# sourceMappingURL=assert.d.ts.map

package/dist/utils/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAIrD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAE7D"}

package/dist/utils/assert.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Fail-fast helpers. No silent failures.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertNotLocked = assertNotLocked;
+exports.failUnsupportedFeature = failUnsupportedFeature;
+const ROUTE_LOCKED_MSG = 'Cannot add routes or middleware after listen(). Routes are immutable.';
+function assertNotLocked(locked) {
+    if (locked) {
+        throw new Error(ROUTE_LOCKED_MSG);
+    }
+}
+function failUnsupportedFeature(feature) {
+    throw new Error(`${feature} is not supported. Fail loudly.`);
+}
+//# sourceMappingURL=assert.js.map

package/dist/utils/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAIH,0CAIC;AAED,wDAEC;AAVD,MAAM,gBAAgB,GAAG,uEAAuE,CAAC;AAEjG,SAAgB,eAAe,CAAC,MAAe;IAC7C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,SAAgB,sBAAsB,CAAC,OAAe;IACpD,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,iCAAiC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/utils/detect.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Unsafe middleware detection.
+ * If unsure → Express lane. Never silently downgrade.
+ */
+import type { ExpressHandler } from '../types/express';
+/**
+ * Returns true if the middleware is known to require Express (streams, multipart, etc.).
+ */
+export declare function isExpressRequired(fn: ExpressHandler): boolean;
+/**
+ * Returns true if the middleware is safe to run in Fastify (no streams, no prototype mutation).
+ */
+export declare function isFastifySafe(fn: ExpressHandler): boolean;
+//# sourceMappingURL=detect.d.ts.map

package/dist/utils/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/utils/detect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA2BvD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAiB7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAEzD"}

package/dist/utils/detect.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Unsafe middleware detection.
+ * If unsure → Express lane. Never silently downgrade.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isExpressRequired = isExpressRequired;
+exports.isFastifySafe = isFastifySafe;
+const unwrap_1 = require("./unwrap");
+const UNSAFE_NAMES = new Set([
+    'multer',
+    'upload',
+    'storage.upload',
+    'formidable',
+    'busboy',
+    'multipart',
+    // Express body parsers that read the raw request stream. On the Fastify lane the body stream
+    // is already consumed and there is no parser for these content types, so they must run on the
+    // Express lane. NOTE: express.json()'s `jsonParser` is intentionally NOT here — it is mapped to
+    // Fastify's native JSON parser (see express/middleware.ts) and stays on the fast lane.
+    'urlencodedparser', // express.urlencoded()
+    'rawparser', // express.raw()
+    'textparser', // express.text()
+]);
+const UNSAFE_PATTERNS = [
+    /\.pipe\s*\(/,
+    /req\.on\s*\(\s*['"]data['"]/,
+    /req\.on\s*\(\s*['"]end['"]/,
+    /multipart\/form-data/,
+    /formidable|busboy|multer/,
+];
+/**
+ * Returns true if the middleware is known to require Express (streams, multipart, etc.).
+ */
+function isExpressRequired(fn) {
+    if (typeof fn !== 'function')
+        return true;
+    // Unwrap APM wrappers (OpenTelemetry/Sentry) so body parsers/multer/etc. are recognized even
+    // when an instrumentation library has wrapped them (otherwise fn.name is e.g. "patched").
+    const target = (0, unwrap_1.unwrapHandler)(fn);
+    if (typeof target !== 'function')
+        return true;
+    const s = target.name || '';
+    const str = target.toString();
+    const nameLower = s.toLowerCase();
+    if (UNSAFE_NAMES.has(nameLower))
+        return true;
+    for (const name of UNSAFE_NAMES) {
+        if (nameLower.includes(name) || str.includes(name))
+            return true;
+    }
+    for (const re of UNSAFE_PATTERNS) {
+        if (re.test(str))
+            return true;
+    }
+    return false;
+}
+/**
+ * Returns true if the middleware is safe to run in Fastify (no streams, no prototype mutation).
+ */
+function isFastifySafe(fn) {
+    return !isExpressRequired(fn);
+}
+//# sourceMappingURL=detect.js.map

package/dist/utils/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/utils/detect.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAgCH,8CAiBC;AAKD,sCAEC;AArDD,qCAAyC;AAEzC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,QAAQ;IACR,QAAQ;IACR,gBAAgB;IAChB,YAAY;IACZ,QAAQ;IACR,WAAW;IACX,6FAA6F;IAC7F,8FAA8F;IAC9F,gGAAgG;IAChG,uFAAuF;IACvF,kBAAkB,EAAE,uBAAuB;IAC3C,WAAW,EAAE,gBAAgB;IAC7B,YAAY,EAAE,iBAAiB;CAChC,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG;IACtB,aAAa;IACb,6BAA6B;IAC7B,4BAA4B;IAC5B,sBAAsB;IACtB,0BAA0B;CAC3B,CAAC;AAEF;;GAEG;AACH,SAAgB,iBAAiB,CAAC,EAAkB;IAClD,IAAI,OAAO,EAAE,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC1C,6FAA6F;IAC7F,0FAA0F;IAC1F,MAAM,MAAM,GAAG,IAAA,sBAAa,EAAC,EAAE,CAAmB,CAAC;IACnD,IAAI,OAAO,MAAM,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,CAAC,GAAI,MAAuC,CAAC,IAAI,IAAI,EAAE,CAAC;IAC9D,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAClC,IAAI,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IAClE,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;QACjC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,EAAkB;IAC9C,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/dist/utils/maxListeners.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Max listeners for request/response and socket.
+ *
+ * Node's default EventEmitter max listeners is 10. In a plain Express or
+ * Fastify app that's usually fine, and neither framework changes it.
+ *
+ * In express-fastify-runtime we run **Express-style middleware on top of
+ * Fastify's request/reply**, so a single response/socket can legitimately have
+ * many listeners (our finish waiter, morgan, user middleware, etc.).
+ *
+ * Rather than trying to guess a safe upper bound (we already saw 32 was not
+ * enough under load), we set the limit to **Infinity (unlimited)** for the
+ * specific response/socket objects we control so Node does not emit
+ * MaxListenersExceededWarning for this intentional pattern.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+/** Default max listeners per response and per socket (Infinity = unlimited). */
+export declare const DEFAULT_MAX_LISTENERS: number;
+/**
+ * Raise (or remove) the max-listener limit on the raw response and the
+ * request's socket so multiple listeners (our finish waiter, morgan, user
+ * middleware, etc.) do not trigger MaxListenersExceededWarning.
+ *
+ * Call at the start of each request (Fastify preHandler or Express lane
+ * notFoundHandler).
+ */
+export declare function applyMaxListeners(rawReq: IncomingMessage, rawRes: ServerResponse, limit?: number): void;
+//# sourceMappingURL=maxListeners.d.ts.map

package/dist/utils/maxListeners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maxListeners.d.ts","sourceRoot":"","sources":["../../src/utils/maxListeners.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,QAAW,CAAC;AAE9C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,cAAc,EACtB,KAAK,GAAE,MAA8B,GACpC,IAAI,CAiBN"}

package/dist/utils/maxListeners.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Max listeners for request/response and socket.
+ *
+ * Node's default EventEmitter max listeners is 10. In a plain Express or
+ * Fastify app that's usually fine, and neither framework changes it.
+ *
+ * In express-fastify-runtime we run **Express-style middleware on top of
+ * Fastify's request/reply**, so a single response/socket can legitimately have
+ * many listeners (our finish waiter, morgan, user middleware, etc.).
+ *
+ * Rather than trying to guess a safe upper bound (we already saw 32 was not
+ * enough under load), we set the limit to **Infinity (unlimited)** for the
+ * specific response/socket objects we control so Node does not emit
+ * MaxListenersExceededWarning for this intentional pattern.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MAX_LISTENERS = void 0;
+exports.applyMaxListeners = applyMaxListeners;
+/** Default max listeners per response and per socket (Infinity = unlimited). */
+exports.DEFAULT_MAX_LISTENERS = Infinity;
+/**
+ * Raise (or remove) the max-listener limit on the raw response and the
+ * request's socket so multiple listeners (our finish waiter, morgan, user
+ * middleware, etc.) do not trigger MaxListenersExceededWarning.
+ *
+ * Call at the start of each request (Fastify preHandler or Express lane
+ * notFoundHandler).
+ */
+function applyMaxListeners(rawReq, rawRes, limit = exports.DEFAULT_MAX_LISTENERS) {
+    // Hot path: when limit is Infinity (default), skip getMaxListeners (saves two calls per request).
+    if (typeof rawRes.setMaxListeners === "function") {
+        if (limit === Infinity) {
+            rawRes.setMaxListeners(Infinity);
+        }
+        else {
+            rawRes.setMaxListeners(Math.max(rawRes.getMaxListeners?.() ?? 10, limit));
+        }
+    }
+    const socket = rawReq?.socket;
+    if (socket && typeof socket.setMaxListeners === "function") {
+        if (limit === Infinity) {
+            socket.setMaxListeners(Infinity);
+        }
+        else {
+            socket.setMaxListeners(Math.max(socket.getMaxListeners?.() ?? 10, limit));
+        }
+    }
+}
+//# sourceMappingURL=maxListeners.js.map

package/dist/utils/maxListeners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maxListeners.js","sourceRoot":"","sources":["../../src/utils/maxListeners.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAeH,8CAqBC;AAhCD,gFAAgF;AACnE,QAAA,qBAAqB,GAAG,QAAQ,CAAC;AAE9C;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAC/B,MAAuB,EACvB,MAAsB,EACtB,QAAgB,6BAAqB;IAErC,kGAAkG;IAClG,IAAI,OAAO,MAAM,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;IAC9B,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAC3D,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/patchRouterLayer.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Patch the router package's Layer so that the path passed to Layer(path, options, fn)
+ * is stored on the instance as _path. This allows us to flatten routers that use
+ * router.use(path, fn) by reading layer._path at compile time.
+ *
+ * We run once when the package is loaded (startup only; no per-request cost).
+ * We patch from our package's resolution context and also from process.cwd() so
+ * that when the app lives in another package (e.g. workspace or app with its own
+ * node_modules), the same router copy the app uses gets patched.
+ */
+export {};
+//# sourceMappingURL=patchRouterLayer.d.ts.map

package/dist/utils/patchRouterLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchRouterLayer.d.ts","sourceRoot":"","sources":["../../src/utils/patchRouterLayer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmGH,OAAO,EAAE,CAAC"}