express-fastify-runtime 0.1.0

package/dist/examples/auth.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Example: auth middleware (Fastify-safe).
+ * Same API as Express; runs on Fastify lane.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("../index");
+const app = (0, index_1.createApp)();
+// Auth middleware – safe for Fastify
+app.use((req, res, next) => {
+    const token = req.get('authorization');
+    if (!token) {
+        res.status(401).json({ error: 'Unauthorized' });
+        return;
+    }
+    req.user = { id: '1', name: 'User' };
+    next();
+});
+app.get('/me', (req, res) => {
+    const user = req.user;
+    res.json({ user });
+});
+app.listen(3000, () => {
+    console.log('Auth example: http://localhost:3000/me');
+});
+//# sourceMappingURL=auth.js.map

package/dist/examples/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/examples/auth.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAEH,oCAAqC;AAGrC,MAAM,GAAG,GAAG,IAAA,iBAAS,GAAE,CAAC;AAExB,qCAAqC;AACrC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAmB,EAAE,GAAoB,EAAE,IAAkB,EAAE,EAAE;IACxE,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IACA,GAA2C,CAAC,IAAI,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC9E,IAAI,EAAE,CAAC;AACT,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAmB,EAAE,GAAoB,EAAE,EAAE;IAC3D,MAAM,IAAI,GAAI,GAA2C,CAAC,IAAI,CAAC;IAC/D,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AACrB,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACpB,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;AACxD,CAAC,CAAC,CAAC"}

package/dist/examples/logging.d.ts

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

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

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

package/dist/examples/logging.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Example: morgan-style logging (Fastify-safe).
+ * Same API as Express; runs on Fastify lane.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("../index");
+const app = (0, index_1.createApp)();
+// Logging middleware – safe for Fastify
+app.use((req, res, next) => {
+    const start = Date.now();
+    res.on('finish', () => {
+        const ms = Date.now() - start;
+        const raw = req;
+        console.log(`${raw.method} ${raw.url} ${res.statusCode} - ${ms}ms`);
+    });
+    next();
+});
+app.get('/', (_req, res) => {
+    res.json({ ok: true });
+});
+app.listen(3001, () => {
+    console.log('Logging example: http://localhost:3001/');
+});
+//# sourceMappingURL=logging.js.map

package/dist/examples/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/examples/logging.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAEH,oCAAqC;AAGrC,MAAM,GAAG,GAAG,IAAA,iBAAS,GAAE,CAAC;AAExB,wCAAwC;AACxC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAmB,EAAE,GAAoB,EAAE,IAAkB,EAAE,EAAE;IACxE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACpB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAC9B,MAAM,GAAG,GAAG,GAAyD,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,MAAM,EAAE,IAAI,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IACH,IAAI,EAAE,CAAC;AACT,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAoB,EAAE,GAAoB,EAAE,EAAE;IAC1D,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AACzB,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACpB,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC"}

package/dist/examples/uploads.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Example: file uploads (Express-required).
+ * Uses Express lane for multer / multipart; same API as Express.
+ */
+export {};
+//# sourceMappingURL=uploads.d.ts.map

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

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

package/dist/examples/uploads.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Example: file uploads (Express-required).
+ * Uses Express lane for multer / multipart; same API as Express.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("../index");
+const app = (0, index_1.createApp)();
+// Multer-like middleware would be express-required and run on Express lane.
+// For demo we use a simple JSON body route (Fastify) and a placeholder "upload" (Express).
+app.use((_req, _res, next) => {
+    next();
+});
+app.post('/api/upload', (_req, res) => {
+    // In real app: multer runs on Express lane; handler runs after.
+    res.json({ message: 'Upload would run on Express lane with multer' });
+});
+app.listen(3002, () => {
+    console.log('Uploads example: http://localhost:3002/api/upload');
+});
+//# sourceMappingURL=uploads.js.map

package/dist/examples/uploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.js","sourceRoot":"","sources":["../../src/examples/uploads.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAEH,oCAAqC;AAGrC,MAAM,GAAG,GAAG,IAAA,iBAAS,GAAE,CAAC;AAExB,4EAA4E;AAC5E,2FAA2F;AAC3F,GAAG,CAAC,GAAG,CAAC,CAAC,IAAoB,EAAE,IAAqB,EAAE,IAAkB,EAAE,EAAE;IAC1E,IAAI,EAAE,CAAC;AACT,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,IAAoB,EAAE,GAAoB,EAAE,EAAE;IACrE,gEAAgE;IAChE,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC,CAAC;AACxE,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACpB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;AACnE,CAAC,CAAC,CAAC"}

package/dist/express/engine.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Real Express app instance. Not a reimplementation.
+ */
+import express from 'express';
+export declare function createExpressEngine(): express.Application;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/express/engine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,WAAW,CAEzD"}

package/dist/express/engine.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Real Express app instance. Not a reimplementation.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExpressEngine = createExpressEngine;
+const express_1 = __importDefault(require("express"));
+function createExpressEngine() {
+    return (0, express_1.default)();
+}
+//# sourceMappingURL=engine.js.map

package/dist/express/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/express/engine.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;AAIH,kDAEC;AAJD,sDAA8B;AAE9B,SAAgB,mBAAmB;IACjC,OAAO,IAAA,iBAAO,GAAE,CAAC;AACnB,CAAC"}

package/dist/express/middleware.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Passthrough helpers for Express middleware (e.g. express.json interception).
+ */
+import type { ExpressHandler } from '../types/express';
+/**
+ * Detect express.json() so we can map it to Fastify JSON parser instead of Express lane.
+ * Express 4: bodyParser.json / express; Express 5: named jsonParser, body calls read(req, res, next, parse).
+ * Unwraps APM-wrapped handlers (OpenTelemetry/Sentry) so a wrapped jsonParser is still recognized.
+ */
+export declare function isExpressJson(fn: ExpressHandler): boolean;
+/**
+ * No-op for express.json() when we use Fastify's built-in JSON; keeps middleware stack shape.
+ */
+export declare function expressJsonPassthrough(): ExpressHandler;
+//# sourceMappingURL=middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/express/middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAQzD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,cAAc,CAEvD"}

package/dist/express/middleware.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Passthrough helpers for Express middleware (e.g. express.json interception).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isExpressJson = isExpressJson;
+exports.expressJsonPassthrough = expressJsonPassthrough;
+const unwrap_1 = require("../utils/unwrap");
+/**
+ * Detect express.json() so we can map it to Fastify JSON parser instead of Express lane.
+ * Express 4: bodyParser.json / express; Express 5: named jsonParser, body calls read(req, res, next, parse).
+ * Unwraps APM-wrapped handlers (OpenTelemetry/Sentry) so a wrapped jsonParser is still recognized.
+ */
+function isExpressJson(fn) {
+    if (typeof fn !== 'function')
+        return false;
+    const target = (0, unwrap_1.unwrapHandler)(fn);
+    if (typeof target !== 'function')
+        return false;
+    const name = target.name ?? '';
+    const str = target.toString();
+    if (name === 'jsonParser')
+        return true; // Express 5
+    return str.includes('json') && (str.includes('bodyParser') || str.includes('express'));
+}
+/**
+ * No-op for express.json() when we use Fastify's built-in JSON; keeps middleware stack shape.
+ */
+function expressJsonPassthrough() {
+    return (req, res, next) => next();
+}
+//# sourceMappingURL=middleware.js.map

package/dist/express/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/express/middleware.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAUH,sCAQC;AAKD,wDAEC;AAtBD,4CAAgD;AAEhD;;;;GAIG;AACH,SAAgB,aAAa,CAAC,EAAkB;IAC9C,IAAI,OAAO,EAAE,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAA,sBAAa,EAAC,EAAE,CAAC,CAAC;IACjC,IAAI,OAAO,MAAM,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC/C,MAAM,IAAI,GAAI,MAAuC,CAAC,IAAI,IAAI,EAAE,CAAC;IACjE,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC9B,IAAI,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC,CAAC,YAAY;IACpD,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AACzF,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB;IACpC,OAAO,CAAC,GAA8C,EAAE,GAA+C,EAAE,IAA6C,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;AACpK,CAAC"}

package/dist/express/mount.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Proxy Fastify → Express when request is not handled by Fastify lane.
+ * We pass the real Node req/res (request.raw, reply.raw) so Express APIs like res.render(),
+ * res.sendFile(), and view engines work. Express treats them as the real IncomingMessage/ServerResponse.
+ *
+ * We must wait for Express to finish (call next or send the response) before returning from
+ * the notFoundHandler; otherwise Fastify sends its default response and then Express tries to
+ * send again → "Cannot set headers after they are sent".
+ *
+ * Body: Fastify parses application/json (and other types) by default and consumes the request
+ * stream. So when we pass request.raw to Express, the body stream is already consumed and
+ * express.json() would read nothing. We attach Fastify's parsed body to the request we pass
+ * so req.body is available on the Express lane.
+ */
+import type { IncomingMessage } from 'node:http';
+import type { FastifyInstance } from 'fastify';
+import type { Application } from 'express';
+/** Request with optional body (Express lane uses raw + body from Fastify). */
+export type IncomingMessageWithBody = IncomingMessage & {
+    body?: unknown;
+};
+/** Options for mountExpress (e.g. diagnostics). */
+export interface MountExpressOptions {
+    /** When true, log that the request is handled on the Express lane. */
+    diagnostics?: boolean;
+}
+/**
+ * Mount Express app so that unhandled Fastify requests are proxied to it.
+ * Uses the raw Node request/response so Express middleware and res.render() work.
+ * Awaits until Express calls the done callback (or the response is finished) so Fastify
+ * does not send a default response before Express has sent.
+ * Attaches Fastify's parsed request.body to the request so req.body is available in Express.
+ */
+export declare function mountExpress(fastify: FastifyInstance, expressApp: Application, options?: MountExpressOptions): void;
+//# sourceMappingURL=mount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/express/mount.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAU3C,8EAA8E;AAC9E,MAAM,MAAM,uBAAuB,GAAG,eAAe,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE3E,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,WAAW,EACvB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CAyDN"}

package/dist/express/mount.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Proxy Fastify → Express when request is not handled by Fastify lane.
+ * We pass the real Node req/res (request.raw, reply.raw) so Express APIs like res.render(),
+ * res.sendFile(), and view engines work. Express treats them as the real IncomingMessage/ServerResponse.
+ *
+ * We must wait for Express to finish (call next or send the response) before returning from
+ * the notFoundHandler; otherwise Fastify sends its default response and then Express tries to
+ * send again → "Cannot set headers after they are sent".
+ *
+ * Body: Fastify parses application/json (and other types) by default and consumes the request
+ * stream. So when we pass request.raw to Express, the body stream is already consumed and
+ * express.json() would read nothing. We attach Fastify's parsed body to the request we pass
+ * so req.body is available on the Express lane.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mountExpress = mountExpress;
+const maxListeners_1 = require("../utils/maxListeners");
+/**
+ * Mount Express app so that unhandled Fastify requests are proxied to it.
+ * Uses the raw Node request/response so Express middleware and res.render() work.
+ * Awaits until Express calls the done callback (or the response is finished) so Fastify
+ * does not send a default response before Express has sent.
+ * Attaches Fastify's parsed request.body to the request so req.body is available in Express.
+ */
+function mountExpress(fastify, expressApp, options) {
+    const diagnostics = options?.diagnostics === true;
+    fastify.setNotFoundHandler(async (request, reply) => {
+        if (diagnostics) {
+            const method = request.method ?? "GET";
+            const url = request.url ?? "/";
+            console.log(`[express-fastify-runtime] Express lane: ${method} ${url}`);
+        }
+        (0, maxListeners_1.applyMaxListeners)(request.raw, reply.raw);
+        const raw = request.raw;
+        const res = reply.raw;
+        // Fastify has already consumed the body stream; attach parsed body so Express sees req.body.
+        // Define body as non-writable so express.json() cannot overwrite with empty when it reads
+        // the already-consumed stream. No Proxy — avoids per-property access overhead on Express lane.
+        const bodyFromFastify = await Promise.resolve(request.body);
+        const req = raw;
+        if (bodyFromFastify !== undefined) {
+            Object.defineProperty(raw, 'body', {
+                value: bodyFromFastify,
+                writable: false,
+                configurable: true,
+                enumerable: true,
+            });
+        }
+        await new Promise((resolve, reject) => {
+            let settled = false;
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                resolve();
+            };
+            res.once('finish', finish);
+            res.once('close', finish);
+            const done = (err) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (err && !reply.sent) {
+                    reply.send(err).then(resolve, reject);
+                    return;
+                }
+                if (!reply.sent) {
+                    reply.code(404).send().then(resolve, reject);
+                    return;
+                }
+                resolve();
+            };
+            expressApp(req, res, done);
+        });
+    });
+}
+//# sourceMappingURL=mount.js.map

package/dist/express/mount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.js","sourceRoot":"","sources":["../../src/express/mount.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;AA8BH,oCA6DC;AAtFD,wDAA0D;AAkB1D;;;;;;GAMG;AACH,SAAgB,YAAY,CAC1B,OAAwB,EACxB,UAAuB,EACvB,OAA6B;IAE7B,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAElD,OAAO,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAuB,EAAE,KAAmB,EAAE,EAAE;QAChF,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;YACvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,2CAA2C,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,IAAA,gCAAiB,EAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAE1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QAEtB,6FAA6F;QAC7F,0FAA0F;QAC1F,+FAA+F;QAC/F,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,OAAO,CAAE,OAA8B,CAAC,IAAI,CAAC,CAAC;QACpF,MAAM,GAAG,GAAG,GAA8B,CAAC;QAC3C,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE;gBACjC,KAAK,EAAE,eAAe;gBACtB,QAAQ,EAAE,KAAK;gBACf,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YAEF,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAE1B,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;gBAC3B,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBACvB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;oBACtC,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBAChB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;oBAC7C,OAAO;gBACT,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YAED,UAAgD,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/fastify/adapters/middleware.d.ts

@@ -0,0 +1,8 @@
+/**
+ * (req, res, next) → async hook for Fastify preHandler.
+ */
+import type { FastifyRequest, FastifyReply } from 'fastify';
+import type { ExpressRequest, ExpressResponse, NextFunction } from '../../types/express';
+export type MiddlewareRunner = (req: ExpressRequest, res: ExpressResponse, next: NextFunction) => void | Promise<void>;
+export declare function toPreHandler(run: MiddlewareRunner, adaptReq: (r: FastifyRequest) => ExpressRequest, adaptRes: (reply: FastifyReply, req: FastifyRequest) => ExpressResponse): (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/fastify/adapters/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/fastify/adapters/middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIzF,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,YAAY,KACf,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,wBAAgB,YAAY,CAC1B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,cAAc,EAC/C,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,cAAc,KAAK,eAAe,IAEtC,SAAS,cAAc,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CAiB9F"}

package/dist/fastify/adapters/middleware.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * (req, res, next) → async hook for Fastify preHandler.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPreHandler = toPreHandler;
+function toPreHandler(run, adaptReq, adaptRes) {
+    return async function preHandler(request, reply) {
+        const req = adaptReq(request);
+        const res = adaptRes(reply, request);
+        await new Promise((resolve, reject) => {
+            const next = (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            };
+            const result = run(req, res, next);
+            const p = result;
+            if (p != null && typeof p.then === 'function') {
+                p.then(() => resolve(), reject);
+            }
+            else {
+                resolve();
+            }
+        });
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/fastify/adapters/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../src/fastify/adapters/middleware.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAaH,oCAsBC;AAtBD,SAAgB,YAAY,CAC1B,GAAqB,EACrB,QAA+C,EAC/C,QAAuE;IAEvE,OAAO,KAAK,UAAU,UAAU,CAAC,OAAuB,EAAE,KAAmB;QAC3E,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACrC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,IAAI,GAAiB,CAAC,GAAqB,EAAE,EAAE;gBACnD,IAAI,GAAG;oBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;oBAChB,OAAO,EAAE,CAAC;YACjB,CAAC,CAAC;YACF,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YACnC,MAAM,CAAC,GAAG,MAA8B,CAAC;YACzC,IAAI,CAAC,IAAI,IAAI,IAAI,OAAQ,CAAsB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACnE,CAAmB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;YACrD,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/fastify/adapters/request.d.ts

@@ -0,0 +1,19 @@
+/**
+ * FastifyRequest → Express-like req.
+ * Full Express 5.x request API so existing apps work unchanged.
+ * Reusable: one req object per createRequestAdapter(), mutated per request (zero alloc).
+ * Aligns with Express 5.2.1 (see docs/EXPRESS_REFERENCE.md); uses accepts, type-is, range-parser.
+ */
+import type { FastifyRequest } from 'fastify';
+import type { ExpressRequest } from '../../types/express';
+export declare function adaptRequest(fastifyReq: FastifyRequest): ExpressRequest;
+/**
+ * Returns a request adapter that builds a FRESH Express-like req per request (methods
+ * shared via prototype, state per instance).
+ *
+ * CRITICAL: a new instance is created per request. A single shared/mutated req object
+ * corrupts concurrent async requests (a later request would overwrite an earlier one
+ * still in flight).
+ */
+export declare function createRequestAdapter(): (fastifyReq: FastifyRequest) => ExpressRequest;
+//# sourceMappingURL=request.d.ts.map

package/dist/fastify/adapters/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/fastify/adapters/request.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA4D1D,wBAAgB,YAAY,CAAC,UAAU,EAAE,cAAc,GAAG,cAAc,CAoDvE;AAmHD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,CAAC,UAAU,EAAE,cAAc,KAAK,cAAc,CAsBrF"}

package/dist/fastify/adapters/request.js

@@ -0,0 +1,258 @@
+"use strict";
+/**
+ * FastifyRequest → Express-like req.
+ * Full Express 5.x request API so existing apps work unchanged.
+ * Reusable: one req object per createRequestAdapter(), mutated per request (zero alloc).
+ * Aligns with Express 5.2.1 (see docs/EXPRESS_REFERENCE.md); uses accepts, type-is, range-parser.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.adaptRequest = adaptRequest;
+exports.createRequestAdapter = createRequestAdapter;
+const accepts_1 = __importDefault(require("accepts"));
+const range_parser_1 = __importDefault(require("range-parser"));
+const type_is_1 = __importDefault(require("type-is"));
+/** Express: Referer and Referrer are interchangeable. */
+function getHeader(headers, name) {
+    if (!name || typeof name !== 'string')
+        return undefined;
+    const lc = name.toLowerCase();
+    if (lc === 'referer' || lc === 'referrer') {
+        return headers.referrer || headers.referer;
+    }
+    const v = headers[lc];
+    return typeof v === 'string' ? v : Array.isArray(v) ? v[0] : undefined;
+}
+/** Parse Cookie header into key-value object. */
+function parseCookieHeader(cookieHeader) {
+    if (!cookieHeader || typeof cookieHeader !== 'string')
+        return {};
+    const out = {};
+    for (const part of cookieHeader.split(';')) {
+        const eq = part.indexOf('=');
+        if (eq === -1)
+            continue;
+        const key = part.slice(0, eq).trim();
+        const val = part.slice(eq + 1).trim();
+        if (key)
+            out[key] = decodeURIComponent(val);
+    }
+    return out;
+}
+/** Derive protocol from x-forwarded-proto or socket. */
+function getProtocol(raw) {
+    const proto = raw.headers['x-forwarded-proto']?.split(',')[0]?.trim();
+    if (proto === 'https' || proto === 'http')
+        return proto;
+    return raw.socket?.encrypted ? 'https' : 'http';
+}
+/** Derive ip from x-forwarded-for (first) or socket.remoteAddress. */
+function getIp(raw) {
+    const forwarded = raw.headers['x-forwarded-for']?.split(',')[0]?.trim();
+    if (forwarded)
+        return forwarded;
+    const addr = raw.socket?.remoteAddress;
+    if (addr)
+        return addr.startsWith('::ffff:') ? addr.slice(7) : addr;
+    return '';
+}
+/** Parse x-forwarded-for into array (trust proxy). */
+function getIps(raw) {
+    const forwarded = raw.headers['x-forwarded-for'];
+    if (!forwarded)
+        return [];
+    const list = (typeof forwarded === 'string' ? forwarded : forwarded.join(',')).split(',');
+    return list.map((s) => s.trim()).filter(Boolean);
+}
+/** Hostname from Host header (without port). */
+function getHostname(raw) {
+    const host = raw.headers.host ?? '';
+    return host.split(':')[0] || '';
+}
+function adaptRequest(fastifyReq) {
+    const raw = fastifyReq.raw;
+    const req = Object.create(raw);
+    req.get = req.header = (name) => getHeader(raw.headers, name);
+    req.accepts = function (...types) {
+        const acc = (0, accepts_1.default)(req);
+        return acc.types.apply(acc, types);
+    };
+    req.acceptsEncodings = function (...encodings) {
+        const acc = (0, accepts_1.default)(req);
+        return acc.encodings.apply(acc, encodings);
+    };
+    req.acceptsCharsets = function (...charsets) {
+        const acc = (0, accepts_1.default)(req);
+        return acc.charsets.apply(acc, charsets);
+    };
+    req.acceptsLanguages = function (...langs) {
+        const acc = (0, accepts_1.default)(req);
+        return acc.languages.apply(acc, langs);
+    };
+    req.range = function (size, options) {
+        const r = req.get('Range');
+        if (!r)
+            return undefined;
+        return (0, range_parser_1.default)(size, r, options);
+    };
+    req.is = function (types) {
+        const arr = Array.isArray(types) ? types : [].slice.call(arguments);
+        return (0, type_is_1.default)(req, arr);
+    };
+    req.query =
+        fastifyReq.query ?? {};
+    req.params =
+        fastifyReq.params ?? {};
+    req.body = fastifyReq.body;
+    const rawUrl = raw.url ?? '/';
+    req.url = rawUrl;
+    req.originalUrl = rawUrl;
+    req.baseUrl = '';
+    req.path = rawUrl.split('?')[0] || '/';
+    req.protocol = getProtocol(raw);
+    req.secure = req.protocol === 'https';
+    req.ip = getIp(raw);
+    req.ips = getIps(raw);
+    req.hostname = getHostname(raw);
+    req.host = raw.headers.host ?? '';
+    req.xhr =
+        raw.headers['x-requested-with']?.toLowerCase() === 'xmlhttprequest';
+    req.fresh = false;
+    req.stale = true;
+    req.cookies = parseCookieHeader(raw.headers.cookie);
+    req.signedCookies = {};
+    return req;
+}
+/**
+ * Shared request prototype: methods/getters defined ONCE. Per-request state (_raw, url,
+ * query, params, body) lives on each instance. Derived values (protocol, ip, cookies,
+ * hostname, ...) are LAZY getters so we never compute them for requests that don't read
+ * them. Common native IncomingMessage fields are delegated to this._raw for compatibility.
+ */
+const requestProto = {
+    get(name) {
+        return getHeader(this._raw?.headers ?? {}, name);
+    },
+    header(name) {
+        return getHeader(this._raw?.headers ?? {}, name);
+    },
+    get method() {
+        return this._raw?.method;
+    },
+    get headers() {
+        return this._raw?.headers ?? {};
+    },
+    get rawHeaders() {
+        return this._raw?.rawHeaders;
+    },
+    get httpVersion() {
+        return this._raw?.httpVersion;
+    },
+    get socket() {
+        return this._raw?.socket;
+    },
+    get connection() {
+        return this._raw?.socket;
+    },
+    get complete() {
+        return this._raw?.complete;
+    },
+    get aborted() {
+        return this._raw?.aborted ?? false;
+    },
+    get path() {
+        return (this.url || '/').split('?')[0] || '/';
+    },
+    get protocol() {
+        const raw = this._raw;
+        return raw ? getProtocol(raw) : 'http';
+    },
+    get secure() {
+        return this.protocol === 'https';
+    },
+    get ip() {
+        const raw = this._raw;
+        return raw ? getIp(raw) : '';
+    },
+    get ips() {
+        const raw = this._raw;
+        return raw ? getIps(raw) : [];
+    },
+    get hostname() {
+        const raw = this._raw;
+        return raw ? getHostname(raw) : '';
+    },
+    get host() {
+        return this._raw?.headers?.host ?? '';
+    },
+    get xhr() {
+        return (this._raw?.headers?.['x-requested-with']?.toLowerCase() ===
+            'xmlhttprequest');
+    },
+    get fresh() {
+        return false;
+    },
+    get stale() {
+        return true;
+    },
+    get cookies() {
+        const raw = this._raw;
+        return raw ? parseCookieHeader(raw.headers.cookie) : {};
+    },
+    get signedCookies() {
+        return {};
+    },
+    accepts(...types) {
+        const acc = (0, accepts_1.default)(this);
+        return acc.types.apply(acc, types);
+    },
+    acceptsEncodings(...encodings) {
+        const acc = (0, accepts_1.default)(this);
+        return acc.encodings.apply(acc, encodings);
+    },
+    acceptsCharsets(...charsets) {
+        const acc = (0, accepts_1.default)(this);
+        return acc.charsets.apply(acc, charsets);
+    },
+    acceptsLanguages(...langs) {
+        const acc = (0, accepts_1.default)(this);
+        return acc.languages.apply(acc, langs);
+    },
+    range(size, options) {
+        const r = this.get('Range');
+        if (!r)
+            return undefined;
+        return (0, range_parser_1.default)(size, r, options);
+    },
+    is(types) {
+        const arr = Array.isArray(types) ? types : [].slice.call(arguments);
+        return (0, type_is_1.default)(this, arr);
+    },
+};
+/**
+ * Returns a request adapter that builds a FRESH Express-like req per request (methods
+ * shared via prototype, state per instance).
+ *
+ * CRITICAL: a new instance is created per request. A single shared/mutated req object
+ * corrupts concurrent async requests (a later request would overwrite an earlier one
+ * still in flight).
+ */
+function createRequestAdapter() {
+    return (fastifyReq) => {
+        const req = Object.create(requestProto);
+        req._raw = fastifyReq.raw;
+        const rawUrl = fastifyReq.raw?.url ?? '/';
+        req.url = rawUrl;
+        req.originalUrl = rawUrl;
+        req.baseUrl = '';
+        req.query =
+            fastifyReq.query ?? {};
+        req.params =
+            fastifyReq.params ?? {};
+        req.body = fastifyReq.body;
+        return req;
+    };
+}
+//# sourceMappingURL=request.js.map