@decocms/blocks 7.10.0 → 7.11.1

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@decocms/blocks",
-  "version": "7.10.0",
+  "version": "7.11.1",
   "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
   "description": "Deco framework-agnostic core: CMS block resolution, section registry, matchers, portable SDK utilities",
   "repository": {
     "type": "git",

package/src/cms/loader.test.ts

@@ -101,6 +101,24 @@ describe("matchPath", () => {
       expect(() => matchPath("/[invalid", "/anything")).not.toThrow();
       expect(matchPath("/[invalid", "/anything")).toBeNull();
     });
+
+    // Node <= 22 has no URLPattern global. The malformed-pattern try/catch
+    // above must NOT absorb that ReferenceError — a missing API has to fail
+    // loudly at first match, not degrade into every CMS page silently
+    // returning null (which renders as sitewide 404s).
+    it("throws a descriptive error when the runtime lacks URLPattern", () => {
+      const g = globalThis as { URLPattern?: unknown };
+      const saved = g.URLPattern;
+      // biome-ignore lint/performance/noDelete: restoring exact global state
+      delete g.URLPattern;
+      try {
+        expect(() => matchPath("/foo/:slug", "/foo/bar")).toThrow(
+          /URLPattern.*Node\.js >= 24/s,
+        );
+      } finally {
+        if (saved !== undefined) g.URLPattern = saved;
+      }
+    });
   });
 });
 

package/src/cms/loader.ts

@@ -223,11 +223,27 @@ declare const URLPattern: {
  *
  * Malformed patterns return `null` instead of throwing — bad CMS data must
  * never take down the worker.
+ *
+ * A MISSING `URLPattern` API, however, throws loudly and immediately: the
+ * try/catch below exists to absorb bad *patterns*, and letting it also
+ * swallow a `ReferenceError` from an old runtime turns "wrong Node version"
+ * into "every CMS page silently 404s" — the worst possible failure mode.
+ * `URLPattern` is native in browsers, workerd, Deno, and Node >= 24 (this
+ * package's `engines` floor). Node 22 and older lack it.
  */
 export function matchPath(
   pattern: string,
   urlPath: string,
 ): Record<string, string> | null {
+  if (typeof URLPattern === "undefined") {
+    throw new Error(
+      "@decocms/blocks: this runtime has no URLPattern Web API, so CMS page " +
+        "paths cannot be matched. URLPattern is native in browsers, " +
+        "Cloudflare workerd, Deno, and Node.js >= 24 — you are most likely " +
+        "running Node <= 22. Upgrade the runtime to Node 24+ (see this " +
+        'package\'s "engines" field).',
+    );
+  }
   let result: MatchPatternResult | null;
   try {
     result = new URLPattern({ pathname: pattern }).exec({ pathname: urlPath });