express-fastify-runtime 0.1.0

package/dist/app/RouteStore.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Stores routes and middleware before compile. Immutable after listen().
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteStore = void 0;
+const express_1 = require("../types/express");
+class RouteStore {
+    entries = [];
+    addMiddleware(path, ...handlers) {
+        this.entries.push({ type: 'middleware', path, handlers });
+    }
+    addRoute(method, path, ...handlers) {
+        const m = method.toLowerCase();
+        if (!express_1.HTTP_METHODS.includes(m) && m !== 'all') {
+            throw new TypeError(`Invalid method: ${method}`);
+        }
+        this.entries.push({ type: 'route', method: m, path, handlers });
+    }
+    /** Add a single entry (used when flattening Router). */
+    addEntry(entry) {
+        if (entry.type === 'route') {
+            this.addRoute(entry.method, entry.path, ...entry.handlers);
+        }
+        else {
+            this.addMiddleware(entry.path, ...entry.handlers);
+        }
+    }
+    /** Add multiple entries (used when flattening Router). */
+    addEntries(entries) {
+        for (const entry of entries) {
+            this.addEntry(entry);
+        }
+    }
+    getAll() {
+        return this.entries;
+    }
+    clear() {
+        this.entries = [];
+    }
+}
+exports.RouteStore = RouteStore;
+//# sourceMappingURL=RouteStore.js.map

package/dist/app/RouteStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteStore.js","sourceRoot":"","sources":["../../src/app/RouteStore.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH,8CAAiE;AAEjE,MAAa,UAAU;IACb,OAAO,GAAiB,EAAE,CAAC;IAEnC,aAAa,CAAC,IAAY,EAAE,GAAG,QAA0B;QACvD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,QAAQ,CAAC,MAAc,EAAE,IAAY,EAAE,GAAG,QAA0B;QAClE,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,sBAAY,CAAC,QAAQ,CAAC,CAAe,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YAC3D,MAAM,IAAI,SAAS,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,wDAAwD;IACxD,QAAQ,CAAC,KAAiB;QACxB,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,UAAU,CAAC,OAA8B;QACvC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;CACF;AAtCD,gCAsCC"}

package/dist/app/classify.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Classify each route/middleware as safe (Fastify) or express-required.
+ * No guessing: if unsure → Express lane.
+ */
+import type { RouteEntry, ClassifiedRoute } from '../types/internal';
+export declare function classifyRoute(entry: RouteEntry): ClassifiedRoute[];
+export declare function classifyAll(entries: readonly RouteEntry[]): ClassifiedRoute[];
+//# sourceMappingURL=classify.d.ts.map

package/dist/app/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/app/classify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGrE,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,EAAE,CAOlE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,eAAe,EAAE,CAM7E"}

package/dist/app/classify.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Classify each route/middleware as safe (Fastify) or express-required.
+ * No guessing: if unsure → Express lane.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyRoute = classifyRoute;
+exports.classifyAll = classifyAll;
+const detect_1 = require("../utils/detect");
+function classifyRoute(entry) {
+    if (entry.type === 'middleware') {
+        const anyUnsafe = entry.handlers.some((fn) => (0, detect_1.isExpressRequired)(fn));
+        return [{ ...entry, lane: anyUnsafe ? 'express' : 'fastify', expressRequired: anyUnsafe }];
+    }
+    const anyUnsafe = entry.handlers.some((fn) => (0, detect_1.isExpressRequired)(fn));
+    return [{ ...entry, lane: anyUnsafe ? 'express' : 'fastify', expressRequired: anyUnsafe }];
+}
+function classifyAll(entries) {
+    const out = [];
+    for (const entry of entries) {
+        out.push(...classifyRoute(entry));
+    }
+    return out;
+}
+//# sourceMappingURL=classify.js.map

package/dist/app/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/app/classify.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAKH,sCAOC;AAED,kCAMC;AAjBD,4CAAoD;AAEpD,SAAgB,aAAa,CAAC,KAAiB;IAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAA,0BAAiB,EAAC,EAAE,CAAC,CAAC,CAAC;QACrE,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAA,0BAAiB,EAAC,EAAE,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,CAAC;AAC7F,CAAC;AAED,SAAgB,WAAW,CAAC,OAA8B;IACxD,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,GAAG,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/app/compile.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Compile classified routes to Fastify routes.
+ * Maximize work at compile/registration time; at runtime we only adapt req/res and run
+ * prebuilt handler chains. No runtime middleware resolution; single handler per route; sync-first.
+ */
+import type { FastifyInstance } from "fastify";
+import type { ClassifiedRoute } from "../types/internal";
+import type { ExpressRequest, ExpressResponse, NextFunction } from "../types/express";
+import type { RequestAdapter } from "../types/internal";
+import type { ResponseAdapter } from "../types/internal";
+export type RunMiddleware = (req: ExpressRequest, res: ExpressResponse, next: NextFunction) => void | Promise<void>;
+export interface RegisterFastifyRoutesOptions {
+    diagnostics?: boolean;
+}
+/**
+ * Register compiled Fastify routes (safe route entries only).
+ *
+ * One Fastify handler per route (no separate preHandler stage). The full chain
+ * [applicable global middleware..., route handlers...] is precomputed at registration:
+ * - chain length 1 → call it directly (sync return, no Promise/chain) — the hot path.
+ * - chain length >1 → drive it with the continuation runner (correct for every middleware
+ *   style, incl. callback-style next()).
+ */
+export declare function registerFastifyRoutes(fastify: FastifyInstance, classified: ClassifiedRoute[], adaptRequest: RequestAdapter, adaptResponse: ResponseAdapter, _runMiddleware: RunMiddleware, options?: RegisterFastifyRoutesOptions): void;
+//# sourceMappingURL=compile.d.ts.map

package/dist/app/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/app/compile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,YAAY,KACf,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAyG1B,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,eAAe,EAAE,EAC7B,YAAY,EAAE,cAAc,EAC5B,aAAa,EAAE,eAAe,EAC9B,cAAc,EAAE,aAAa,EAC7B,OAAO,CAAC,EAAE,4BAA4B,GACrC,IAAI,CA+EN"}

package/dist/app/compile.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Compile classified routes to Fastify routes.
+ * Maximize work at compile/registration time; at runtime we only adapt req/res and run
+ * prebuilt handler chains. No runtime middleware resolution; single handler per route; sync-first.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFastifyRoutes = registerFastifyRoutes;
+const path_1 = require("../utils/path");
+const maxListeners_1 = require("../utils/maxListeners");
+const middleware_1 = require("../express/middleware");
+/** Path prefix match: middleware at /api applies to /api, /api/users, etc. */
+function pathMatches(middlewarePath, routePath) {
+    const m = (0, path_1.normalizePath)(middlewarePath);
+    const r = (0, path_1.normalizePath)(routePath);
+    if (m === "/" || m === "")
+        return true;
+    return r === m || r.startsWith(m + "/");
+}
+/** Shared no-op next() for the single-handler fast path (stateless: only rethrows errors). */
+const noopNext = (err) => {
+    if (err)
+        throw err;
+};
+const noop = () => { };
+/**
+ * Run an Express-style handler chain the way Express's router does: continuation-based, but
+ * sync-first so the common case stays allocation-light.
+ *
+ * `next()` is the ONLY driver — a handler advances whenever it calls next(): synchronously,
+ * from an awaited promise, OR from a detached callback / setTimeout / microtask (classic
+ * callback style). A handler that ends the response without next() stops the chain (res.json/
+ * send/end signal us via res._onEnd). Errors (sync throw, next(err), or async rejection) are
+ * routed to Fastify's error handler.
+ *
+ * Returns `undefined` when the chain settles synchronously (no Promise allocated — the fast
+ * path), or a Promise when a handler defers work (async/await or a detached next()). The only
+ * thing that "hangs" is a handler that never calls next() and never responds — as in Express.
+ */
+function run(handlers, req, res) {
+    const r = res;
+    let i = 0;
+    let finished = false;
+    let syncError = null; // captured sync error, rethrown after the drive
+    let deferred = null;
+    // settle() is inlined into next()/_onEnd to keep per-request closures to a minimum (sync case
+    // allocates just _onEnd + next; the async rejection closure is only created if a handler defers).
+    const settle = (err) => {
+        if (finished)
+            return;
+        finished = true;
+        r._onEnd = undefined;
+        if (err === undefined) {
+            if (deferred)
+                deferred.resolve();
+        }
+        else if (deferred) {
+            deferred.reject(err);
+        }
+        else {
+            // next(err) is called from inside the handler that run()'s own try/catch wraps, so throwing
+            // here would be swallowed. Stash and rethrow once the synchronous drive unwinds.
+            syncError = { e: err };
+        }
+    };
+    // If a handler ends the response without calling next(), stop waiting (settle() = success).
+    r._onEnd = settle;
+    const next = (err) => {
+        if (err !== undefined && err !== null)
+            return settle(err);
+        if (i >= handlers.length)
+            return settle();
+        const fn = handlers[i++];
+        let ret;
+        try {
+            ret = fn(req, res, next);
+        }
+        catch (e) {
+            return settle(e);
+        }
+        if (ret != null && typeof ret.then === "function") {
+            ret.then(noop, (e) => settle(e));
+        }
+    };
+    next(); // drive synchronously
+    if (syncError)
+        throw syncError.e; // sync throw / next(err) → Fastify error handler
+    if (finished)
+        return; // settled synchronously → no Promise (fast path)
+    return new Promise((resolve, reject) => {
+        deferred = { resolve, reject };
+        if (finished)
+            resolve();
+    });
+}
+/** Path prefix match wrapper kept above; collect the applicable middleware for a route. */
+function collectApplicableMiddleware(routePath, classified, routeIndex) {
+    const applicable = [];
+    for (let i = 0; i < classified.length && i < routeIndex; i++) {
+        const c = classified[i];
+        if (c.lane !== "fastify" || c.type !== "middleware")
+            continue;
+        const path = c.path === "/" ? "/" : (0, path_1.normalizePath)(c.path);
+        if (!pathMatches(path, routePath))
+            continue;
+        for (const h of c.handlers) {
+            // 4-arg Express error middleware runs via setErrorHandler, never in the normal chain.
+            if (typeof h === "function" && h.length === 4)
+                continue;
+            applicable.push(((0, middleware_1.isExpressJson)(h) ? (0, middleware_1.expressJsonPassthrough)() : h));
+        }
+    }
+    return applicable;
+}
+/**
+ * Register compiled Fastify routes (safe route entries only).
+ *
+ * One Fastify handler per route (no separate preHandler stage). The full chain
+ * [applicable global middleware..., route handlers...] is precomputed at registration:
+ * - chain length 1 → call it directly (sync return, no Promise/chain) — the hot path.
+ * - chain length >1 → drive it with the continuation runner (correct for every middleware
+ *   style, incl. callback-style next()).
+ */
+function registerFastifyRoutes(fastify, classified, adaptRequest, adaptResponse, _runMiddleware, options) {
+    const diagnostics = options?.diagnostics === true;
+    const ALL_METHODS = [
+        "GET",
+        "POST",
+        "PUT",
+        "PATCH",
+        "DELETE",
+        "HEAD",
+        "OPTIONS",
+    ];
+    const expandMethods = (method) => method === "all" ? ALL_METHODS : [method.toUpperCase()];
+    // Count route entries per concrete method+path across ALL lanes. Express allows the same
+    // method+path to be declared more than once (the layers chain via next()); Fastify forbids
+    // duplicate method+path. Any method+path declared >1 time is left OFF the Fastify lane and
+    // handled by the real embedded Express app (which has every layer and runs them in order).
+    const methodPathCount = new Map();
+    for (const c of classified) {
+        if (c.type !== "route")
+            continue;
+        const p = (0, path_1.normalizePath)(c.path);
+        for (const m of expandMethods(c.method)) {
+            const key = m + " " + p;
+            methodPathCount.set(key, (methodPathCount.get(key) ?? 0) + 1);
+        }
+    }
+    const routeEntries = classified.filter((c) => c.type === "route" && c.lane === "fastify");
+    for (const entry of routeEntries) {
+        if (entry.type !== "route")
+            continue;
+        const path = (0, path_1.normalizePath)(entry.path);
+        // baseUrl is constant per route — compute once at registration, not per request.
+        const baseUrlSegments = path.split("/").filter(Boolean);
+        const baseUrl = baseUrlSegments.length >= 1 ? "/" + baseUrlSegments[0] : "";
+        const routeIndex = classified.indexOf(entry);
+        // Only register methods that are declared exactly once for this path; duplicates (incl.
+        // all+method overlaps, or a same-path entry on the Express lane) defer to the Express lane.
+        const methods = expandMethods(entry.method).filter((m) => (methodPathCount.get(m + " " + path) ?? 0) === 1);
+        if (methods.length === 0)
+            continue;
+        const applicable = collectApplicableMiddleware(path, classified, routeIndex);
+        const routeHandlers = entry.handlers.map((h) => (0, middleware_1.isExpressJson)(h) ? (0, middleware_1.expressJsonPassthrough)() : h);
+        const chain = applicable.length ? applicable.concat(routeHandlers) : routeHandlers;
+        // Hot path: exactly one handler that doesn't take `next` (arity ≤ 2) can only respond
+        // synchronously or return a promise — call it directly, no runner/closures/Promise.
+        // Anything that takes `next` (or a multi-handler chain) goes through the continuation runner.
+        const fastSingle = chain.length === 1 && chain[0].length <= 2 ? chain[0] : null;
+        for (const m of methods) {
+            const logLane = diagnostics
+                ? (request) => console.log(`[express-fastify-runtime] Fastify lane: ${m} ${request.url ?? path}`)
+                : null;
+            fastify.route({
+                method: m,
+                url: path,
+                handler: (request, reply) => {
+                    if (logLane)
+                        logLane(request);
+                    (0, maxListeners_1.applyMaxListeners)(request.raw, reply.raw);
+                    const req = adaptRequest(request);
+                    const res = adaptResponse(reply, request);
+                    res.req = req;
+                    req.baseUrl = baseUrl;
+                    if (fastSingle !== null) {
+                        return fastSingle(req, res, noopNext);
+                    }
+                    return run(chain, req, res);
+                },
+            });
+        }
+    }
+}
+//# sourceMappingURL=compile.js.map

package/dist/app/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../src/app/compile.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA0IH,sDAsFC;AApND,wCAA8C;AAC9C,wDAA0D;AAC1D,sDAA8E;AAQ9E,8EAA8E;AAC9E,SAAS,WAAW,CAAC,cAAsB,EAAE,SAAiB;IAC5D,MAAM,CAAC,GAAG,IAAA,oBAAa,EAAC,cAAc,CAAC,CAAC;IACxC,MAAM,CAAC,GAAG,IAAA,oBAAa,EAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,8FAA8F;AAC9F,MAAM,QAAQ,GAAiB,CAAC,GAAqB,EAAE,EAAE;IACvD,IAAI,GAAG;QAAE,MAAM,GAAG,CAAC;AACrB,CAAC,CAAC;AACF,MAAM,IAAI,GAAG,GAAS,EAAE,GAAE,CAAC,CAAC;AAO5B;;;;;;;;;;;;;GAaG;AACH,SAAS,GAAG,CAAC,QAAmB,EAAE,GAAmB,EAAE,GAAoB;IACzE,MAAM,CAAC,GAAG,GAAiB,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,SAAS,GAA0B,IAAI,CAAC,CAAC,gDAAgD;IAC7F,IAAI,QAAQ,GAAiE,IAAI,CAAC;IAClF,8FAA8F;IAC9F,kGAAkG;IAClG,MAAM,MAAM,GAAG,CAAC,GAAa,EAAQ,EAAE;QACrC,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC;QACrB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,QAAQ;gBAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;aAAM,IAAI,QAAQ,EAAE,CAAC;YACpB,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,4FAA4F;YAC5F,iFAAiF;YACjF,SAAS,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;QACzB,CAAC;IACH,CAAC,CAAC;IACF,4FAA4F;IAC5F,CAAC,CAAC,MAAM,GAAG,MAAoB,CAAC;IAChC,MAAM,IAAI,GAAiB,CAAC,GAAqB,EAAE,EAAE;QACnD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,QAAQ,CAAC,MAAM;YAAE,OAAO,MAAM,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;QACzB,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;QACD,IAAI,GAAG,IAAI,IAAI,IAAI,OAAQ,GAAwB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACvE,GAAwB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC;IACF,IAAI,EAAE,CAAC,CAAC,sBAAsB;IAC9B,IAAI,SAAS;QAAE,MAAO,SAA4B,CAAC,CAAC,CAAC,CAAC,iDAAiD;IACvG,IAAI,QAAQ;QAAE,OAAO,CAAC,iDAAiD;IACvE,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,QAAQ,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC/B,IAAI,QAAQ;YAAE,OAAO,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,2FAA2F;AAC3F,SAAS,2BAA2B,CAClC,SAAiB,EACjB,UAA6B,EAC7B,UAAkB;IAElB,MAAM,UAAU,GAAc,EAAE,CAAC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7D,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY;YAAE,SAAS;QAC9D,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAA,oBAAa,EAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC;YAAE,SAAS;QAC5C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC3B,sFAAsF;YACtF,IAAI,OAAO,CAAC,KAAK,UAAU,IAAK,CAAwB,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAChF,UAAU,CAAC,IAAI,CACb,CAAC,IAAA,0BAAa,EAAC,CAAmB,CAAC,CAAC,CAAC,CAAC,IAAA,mCAAsB,GAAE,CAAC,CAAC,CAAC,CAAC,CAAY,CAC/E,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAMD;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CACnC,OAAwB,EACxB,UAA6B,EAC7B,YAA4B,EAC5B,aAA8B,EAC9B,cAA6B,EAC7B,OAAsC;IAEtC,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAElD,MAAM,WAAW,GAAG;QAClB,KAAK;QACL,MAAM;QACN,KAAK;QACL,OAAO;QACP,QAAQ;QACR,MAAM;QACN,SAAS;KACD,CAAC;IACX,MAAM,aAAa,GAAG,CAAC,MAAc,EAAqB,EAAE,CAC1D,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1D,yFAAyF;IACzF,2FAA2F;IAC3F,2FAA2F;IAC3F,2FAA2F;IAC3F,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;YAAE,SAAS;QACjC,MAAM,CAAC,GAAG,IAAA,oBAAa,EAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;YACxB,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAClD,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE,SAAS;QACrC,MAAM,IAAI,GAAG,IAAA,oBAAa,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,iFAAiF;QACjF,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7C,wFAAwF;QACxF,4FAA4F;QAC5F,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAChD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CACxD,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,MAAM,UAAU,GAAG,2BAA2B,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAC7E,MAAM,aAAa,GAAI,KAAK,CAAC,QAA6B,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACnE,IAAA,0BAAa,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAA,mCAAsB,GAAE,CAAC,CAAC,CAAC,CAAC,CACnC,CAAC;QACf,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;QACnF,sFAAsF;QACtF,oFAAoF;QACpF,8FAA8F;QAC9F,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,IAAK,KAAK,CAAC,CAAC,CAAwB,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAExG,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,WAAW;gBACzB,CAAC,CAAC,CAAC,OAAyC,EAAE,EAAE,CAC5C,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;gBACtF,CAAC,CAAC,IAAI,CAAC;YAET,OAAO,CAAC,KAAK,CAAC;gBACZ,MAAM,EAAE,CAAC;gBACT,GAAG,EAAE,IAAI;gBACT,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;oBAC1B,IAAI,OAAO;wBAAE,OAAO,CAAC,OAAO,CAAC,CAAC;oBAC9B,IAAA,gCAAiB,EAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;oBAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;oBAClC,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;oBACzC,GAAkB,CAAC,GAAG,GAAG,GAAG,CAAC;oBAC9B,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;oBACtB,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;wBACxB,OAAO,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAA4B,CAAC;oBACnE,CAAC;oBACD,OAAO,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBAC9B,CAAC;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/app/flattenRouter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Flatten express.Router() into RouteStore entries so router routes and
+ * router.use() middleware can be classified and run on the Fastify lane when safe.
+ *
+ * When the router package's Layer is patched (see patchRouterLayer.ts), middleware
+ * layers expose layer._path so we can flatten router.use(path, fn) too. Otherwise
+ * we only flatten routers that have no middleware layers (route-only).
+ */
+import type { RouteEntry } from '../types/internal';
+import type { ExpressHandler } from '../types/express';
+/** Minimal Express Router shape (express + router package). */
+export interface ExpressRouterLike {
+    stack: ExpressLayerLike[];
+}
+/** Layer: either middleware (no route) or route (has route). _path is set by our patch for middleware. */
+export interface ExpressLayerLike {
+    path?: string;
+    /** Layer name — Express sets it from the original handler's name and KEEPS it even when an
+     * instrumentation library (e.g. OpenTelemetry/Sentry) wraps the handler. More reliable than
+     * handle.name for identifying Express built-ins. */
+    name?: string;
+    /** Set by patchRouterLayer when Layer(path, options, fn) is called with a string path. */
+    _path?: string;
+    /** router.use('/') creates a layer with slash: true. */
+    slash?: boolean;
+    handle: ExpressHandler | ExpressRouterLike;
+    route?: ExpressRouteLike;
+}
+/** Route has path, methods, and stack of method handlers. */
+export interface ExpressRouteLike {
+    path: string;
+    methods: Record<string, boolean>;
+    stack: Array<{
+        method?: string;
+        name?: string;
+        handle: ExpressHandler;
+    }>;
+}
+/**
+ * Returns true if the value looks like an Express Router (has stack array).
+ */
+export declare function isExpressRouter(value: unknown): value is ExpressRouterLike;
+/**
+ * Flatten a Router into RouteEntry[] when possible.
+ * - Route layers (router.get/post etc.) are always flattened when we have route.path.
+ * - Middleware layers (router.use) are flattened when we have the path (from Layer._path patch or slash).
+ * - Nested routers are flattened recursively.
+ * - If any middleware layer has no path we can read, return null and the caller mounts the router on Express lane.
+ */
+export declare function flattenRouter(router: ExpressRouterLike, mountPath: string): RouteEntry[] | null;
+//# sourceMappingURL=flattenRouter.d.ts.map

package/dist/app/flattenRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattenRouter.d.ts","sourceRoot":"","sources":["../../src/app/flattenRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAoBvD,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,0GAA0G;AAC1G,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;wDAEoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAAC;IAC3C,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC;CAC1E;AAID;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAI1E;AAYD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,IAAI,CAoE/F"}

package/dist/app/flattenRouter.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * Flatten express.Router() into RouteStore entries so router routes and
+ * router.use() middleware can be classified and run on the Fastify lane when safe.
+ *
+ * When the router package's Layer is patched (see patchRouterLayer.ts), middleware
+ * layers expose layer._path so we can flatten router.use(path, fn) too. Otherwise
+ * we only flatten routers that have no middleware layers (route-only).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isExpressRouter = isExpressRouter;
+exports.flattenRouter = flattenRouter;
+const expressLane_1 = require("../runtime/expressLane");
+const middleware_1 = require("../express/middleware");
+const path_1 = require("../utils/path");
+/**
+ * Express body parsers, identified by layer/sub-layer `name` (Express preserves it even when an
+ * APM like OpenTelemetry/Sentry wraps the handler, so handle.name becomes e.g. "patched").
+ *
+ * - express.json() → Fastify already parses JSON, so on the Fastify lane the parser is a no-op
+ *   (`expressJsonPassthrough`); req.body comes from Fastify. Otherwise the real jsonParser would
+ *   try to read the already-consumed request stream and throw "argument stream must be a stream".
+ * - express.urlencoded()/raw()/text() read the raw stream and Fastify has no parser for those
+ *   content types — they're left as-is so classify() (utils/detect) routes routes/middleware
+ *   using them to the Express lane (real Express parses the body).
+ */
+function neutralizeJsonParser(name, handle) {
+    return name === 'jsonParser' ? (0, middleware_1.expressJsonPassthrough)() : handle;
+}
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+/**
+ * Returns true if the value looks like an Express Router (has stack array).
+ */
+function isExpressRouter(value) {
+    if (value == null || typeof value !== 'function')
+        return false;
+    const obj = value;
+    return Array.isArray(obj.stack);
+}
+/**
+ * Get the path for a middleware layer. Uses _path (from our patch), or '/' when slash is true.
+ */
+function getMiddlewareLayerPath(layer) {
+    const path = layer._path;
+    if (typeof path === 'string')
+        return path;
+    if (layer.slash === true)
+        return '/';
+    return null;
+}
+/**
+ * Flatten a Router into RouteEntry[] when possible.
+ * - Route layers (router.get/post etc.) are always flattened when we have route.path.
+ * - Middleware layers (router.use) are flattened when we have the path (from Layer._path patch or slash).
+ * - Nested routers are flattened recursively.
+ * - If any middleware layer has no path we can read, return null and the caller mounts the router on Express lane.
+ */
+function flattenRouter(router, mountPath) {
+    const stack = router.stack;
+    if (!stack || stack.length === 0)
+        return [];
+    const entries = [];
+    for (const layer of stack) {
+        if (layer.route) {
+            const route = layer.route;
+            // Skip RegExp/array routes so they stay on Express lane (res.render, etc.)
+            if (typeof route.path !== 'string')
+                continue;
+            // Skip routes whose handler(s) are marked with expressLane() or @ExpressLane()
+            const hasExpressLaneHandler = route.stack.some((l) => (0, expressLane_1.isExpressLaneHandler)(l.handle));
+            if (hasExpressLaneHandler)
+                continue;
+            const fullPath = (0, path_1.joinPath)(mountPath, route.path);
+            for (const method of Object.keys(route.methods)) {
+                const m = method === '_all' ? 'all' : method.toLowerCase();
+                const handlers = route.stack
+                    .filter((l) => l.method === undefined || l.method === m)
+                    .map((l) => neutralizeJsonParser(l.name, l.handle));
+                if (handlers.length === 0)
+                    continue;
+                const validMethod = m === 'all' || HTTP_METHODS.includes(m) ? m : null;
+                if (!validMethod)
+                    continue;
+                entries.push({
+                    type: 'route',
+                    method: validMethod,
+                    path: fullPath,
+                    handlers,
+                });
+            }
+            continue;
+        }
+        const handle = layer.handle;
+        // Express 4 injects `query` and `expressInit` middleware into the app router stack
+        // (Express 5 does not). They must NOT run on the Fastify lane: `expressInit` reassigns
+        // req/res __proto__ to Express's own objects (which breaks our adapter — e.g. res.setHeader
+        // then hits a non-real response and helmet/etc. throw), and Fastify already parses the query
+        // string. Identify them by `layer.name` — Express preserves it even when an instrumentation
+        // library (OpenTelemetry/Sentry) wraps the handler (then handle.name is the wrapper, e.g.
+        // "patched"). Fall back to handle.name for safety.
+        const builtinName = layer.name || (typeof handle === 'function' ? handle.name : '');
+        if (builtinName === 'query' || builtinName === 'expressInit')
+            continue;
+        const middlewarePath = getMiddlewareLayerPath(layer);
+        if (middlewarePath === null)
+            return null;
+        if ((0, expressLane_1.isExpressLaneHandler)(handle))
+            continue;
+        const fullPath = (0, path_1.joinPath)(mountPath, middlewarePath);
+        if (isExpressRouter(handle)) {
+            const nested = flattenRouter(handle, fullPath);
+            if (nested === null)
+                return null;
+            entries.push(...nested);
+        }
+        else {
+            entries.push({
+                type: 'middleware',
+                path: fullPath,
+                handlers: [neutralizeJsonParser(builtinName, handle)],
+            });
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=flattenRouter.js.map

package/dist/app/flattenRouter.js.map

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

package/dist/app/introspectExpress.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Introspect an existing Express app's router stack to produce RouteEntry[].
+ * Used by fast(app, ops) to compile an already-built Express app onto Fastify.
+ *
+ * Requires that express-fastify-runtime was loaded before the app was created,
+ * so that router Layer has _path set for middleware (see patchRouterLayer.ts).
+ * If the app cannot be flattened (e.g. unpatched middleware), returns null.
+ */
+import type { RouteEntry } from '../types/internal';
+import type { ExpressRouterLike } from './flattenRouter';
+/** Express app shape: Express 5 exposes `app.router`; Express 4 uses the private `app._router`. */
+export interface ExpressAppLike {
+    router?: ExpressRouterLike;
+    _router?: ExpressRouterLike;
+}
+/**
+ * Walk the app's router stack and convert to RouteEntry[] with mount path '/'.
+ * Returns null if the app has middleware layers we can't flatten (e.g. no _path).
+ */
+export declare function introspectExpressApp(app: ExpressAppLike): RouteEntry[] | null;
+/** Express 4-arg error middleware type. */
+export type ExpressErrorMiddleware = (err: Error, req: import('../types/express').ExpressRequest, res: import('../types/express').ExpressResponse, next: import('../types/express').NextFunction) => void | Promise<void>;
+/**
+ * Return the first Express error middleware (4-arg handler) from the app's router stack, if any.
+ * Only considers middleware layers (no route), so we don't pick a route's handler by mistake.
+ * Used by fast() to wire setErrorHandler so next(err) in the Fastify lane reaches Express error handlers.
+ */
+export declare function getExpressErrorMiddleware(app: ExpressAppLike): ExpressErrorMiddleware | null;
+//# sourceMappingURL=introspectExpress.d.ts.map

package/dist/app/introspectExpress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspectExpress.d.ts","sourceRoot":"","sources":["../../src/app/introspectExpress.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAG3E,mGAAmG;AACnG,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAiBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,UAAU,EAAE,GAAG,IAAI,CAM7E;AAED,2CAA2C;AAC3C,MAAM,MAAM,sBAAsB,GAAG,CACnC,GAAG,EAAE,KAAK,EACV,GAAG,EAAE,OAAO,kBAAkB,EAAE,cAAc,EAC9C,GAAG,EAAE,OAAO,kBAAkB,EAAE,eAAe,EAC/C,IAAI,EAAE,OAAO,kBAAkB,EAAE,YAAY,KAC1C,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,cAAc,GAAG,sBAAsB,GAAG,IAAI,CAW5F"}

package/dist/app/introspectExpress.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Introspect an existing Express app's router stack to produce RouteEntry[].
+ * Used by fast(app, ops) to compile an already-built Express app onto Fastify.
+ *
+ * Requires that express-fastify-runtime was loaded before the app was created,
+ * so that router Layer has _path set for middleware (see patchRouterLayer.ts).
+ * If the app cannot be flattened (e.g. unpatched middleware), returns null.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.introspectExpressApp = introspectExpressApp;
+exports.getExpressErrorMiddleware = getExpressErrorMiddleware;
+const flattenRouter_1 = require("./flattenRouter");
+/**
+ * Get the app's router stack across Express majors.
+ * Express 4: `app._router` (present after the first route/middleware); `app.router` getter THROWS.
+ * Express 5: `app.router` is a lazy getter; `app._router` is undefined.
+ * Check `_router` first so we never touch Express 4's throwing getter; guard `app.router` anyway.
+ */
+function getAppRouter(app) {
+    if (app._router)
+        return app._router;
+    try {
+        return app.router;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Walk the app's router stack and convert to RouteEntry[] with mount path '/'.
+ * Returns null if the app has middleware layers we can't flatten (e.g. no _path).
+ */
+function introspectExpressApp(app) {
+    const router = getAppRouter(app);
+    if (!router || !Array.isArray(router.stack) || router.stack.length === 0) {
+        return [];
+    }
+    return (0, flattenRouter_1.flattenRouter)(router, '/');
+}
+/**
+ * Return the first Express error middleware (4-arg handler) from the app's router stack, if any.
+ * Only considers middleware layers (no route), so we don't pick a route's handler by mistake.
+ * Used by fast() to wire setErrorHandler so next(err) in the Fastify lane reaches Express error handlers.
+ */
+function getExpressErrorMiddleware(app) {
+    const router = getAppRouter(app);
+    if (!router || !Array.isArray(router.stack))
+        return null;
+    for (const layer of router.stack) {
+        if (layer.route)
+            continue; // skip route layers; only use app-level middleware
+        const handle = layer.handle;
+        if (typeof handle === 'function' && handle.length === 4) {
+            return handle;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=introspectExpress.js.map

package/dist/app/introspectExpress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspectExpress.js","sourceRoot":"","sources":["../../src/app/introspectExpress.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AA+BH,oDAMC;AAeD,8DAWC;AA3DD,mDAAgD;AAQhD;;;;;GAKG;AACH,SAAS,YAAY,CAAC,GAAmB;IACvC,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,MAAM,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,GAAmB;IACtD,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzE,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,IAAA,6BAAa,EAAC,MAA2B,EAAE,GAAG,CAAC,CAAC;AACzD,CAAC;AAUD;;;;GAIG;AACH,SAAgB,yBAAyB,CAAC,GAAmB;IAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAoD,EAAE,CAAC;QAChF,IAAI,KAAK,CAAC,KAAK;YAAE,SAAS,CAAC,mDAAmD;QAC9E,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,OAAO,MAAM,KAAK,UAAU,IAAK,MAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtE,OAAO,MAAgC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/examples/auth.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Example: auth middleware (Fastify-safe).
+ * Same API as Express; runs on Fastify lane.
+ */
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/examples/auth.d.ts.map

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