express-fastify-runtime 0.1.1 → 0.1.3

package/dist/utils/expressPath.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Translate an Express route path string into a Fastify (find-my-way) path.
+ *
+ * Express and Fastify share `/:param` and `/static`, but wildcards differ:
+ *   - Express 4: bare `*` → the match is exposed as `req.params[0]` (then `[1]`, ...).
+ *   - Express 5: named `*splat` → exposed as `req.params.splat`.
+ *   - Fastify/find-my-way: a single trailing `*`, exposed as `req.params['*']`.
+ * Passing an Express path verbatim to Fastify therefore (a) crashes at registration for Express 5's
+ * `*splat` ("Wildcard must be the last character"), and (b) loses the wildcard value (handlers read
+ * `params[0]`/`params.splat`, Fastify wrote `params['*']`).
+ *
+ * `toFastifyPath` rewrites a trailing wildcard to Fastify's `*` and reports the Express key to bridge
+ * back at request time. Anything we can't translate safely (mid-path or multiple wildcards) returns
+ * null so the caller leaves that route on the Express lane. Plain param/static paths are returned
+ * unchanged with `wildcard: null` (zero behavior change for the common case).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toFastifyPath = toFastifyPath;
+const STAR = '*';
+function toFastifyPath(expressPath) {
+    if (typeof expressPath !== 'string' || expressPath.length === 0)
+        return null;
+    // No wildcard → identical syntax on both routers (params, statics). Return as-is.
+    if (!expressPath.includes(STAR))
+        return { url: expressPath, wildcard: null };
+    // Count wildcard occurrences. Fastify supports exactly one, and only as the final segment.
+    const starCount = (expressPath.match(/\*/g) ?? []).length;
+    if (starCount !== 1)
+        return null; // multiple wildcards → Express lane
+    const starIndex = expressPath.indexOf(STAR);
+    // Express 5 names the wildcard: `*name` (chars right after `*`). Express 4 uses a bare `*`.
+    const after = expressPath.slice(starIndex + 1);
+    const nameMatch = after.match(/^([A-Za-z_$][\w$]*)/);
+    const wildcardName = nameMatch ? nameMatch[1] : null;
+    const trailingAfterName = nameMatch ? after.slice(nameMatch[1].length) : after;
+    // The wildcard must be last (only an optional trailing slash may follow). Otherwise we can't map
+    // it to Fastify's trailing `*`.
+    if (trailingAfterName !== '' && trailingAfterName !== '/')
+        return null;
+    const before = expressPath.slice(0, starIndex); // includes the slash before `*`
+    const url = before + STAR;
+    // Express 4 exposes a bare `*` as the numeric key '0'; Express 5 uses the given name.
+    const wildcard = wildcardName ?? '0';
+    return { url, wildcard };
+}
+//# sourceMappingURL=expressPath.js.map

package/dist/utils/expressPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressPath.js","sourceRoot":"","sources":["../../src/utils/expressPath.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;AAWH,sCA0BC;AA5BD,MAAM,IAAI,GAAG,GAAG,CAAC;AAEjB,SAAgB,aAAa,CAAC,WAAmB;IAC/C,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7E,kFAAkF;IAClF,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAE7E,2FAA2F;IAC3F,MAAM,SAAS,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAC1D,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,oCAAoC;IAEtE,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,4FAA4F;IAC5F,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,MAAM,iBAAiB,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAE/E,iGAAiG;IACjG,gCAAgC;IAChC,IAAI,iBAAiB,KAAK,EAAE,IAAI,iBAAiB,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAEvE,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,gCAAgC;IAChF,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1B,sFAAsF;IACtF,MAAM,QAAQ,GAAG,YAAY,IAAI,GAAG,CAAC;IACrC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "express-fastify-runtime",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Run Express apps on Fastify safely, faster, without code changes",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",