create-brainerce-store 1.41.0 → 1.41.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-brainerce-store",
-  "version": "1.41.0",
+  "version": "1.41.1",
   "description": "Scaffold a production-ready e-commerce storefront connected to Brainerce",
   "bin": {
     "create-brainerce-store": "dist/index.js"
@@ -33,7 +33,7 @@
     "typescript": "^5.4.0"
   },
   "engines": {
-    "node": ">=18"
+    "node": "^20.19.0 || ^22.13.0 || >=24.0.0"
   },
   "keywords": [
     "brainerce",

package/templates/nextjs/base/package.json.ejs

@@ -28,5 +28,8 @@
     "postcss": "^8.4.0",
     "tailwindcss": "^3.4.0",
     "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": "^20.19.0 || ^22.13.0 || >=24.0.0"
   }
 }

package/templates/nextjs/base/src/app/pages/[slug]/page.tsx.ejs

@@ -17,6 +17,7 @@ import { notFound } from 'next/navigation';
 
 import { getServerClient } from '@/lib/brainerce';
 import { sanitizeHtml } from '@/lib/sanitize';
+import { decodeSlug } from '@/lib/utils';
 
 <% if (i18nEnabled) { %>
 type PageProps = {
@@ -24,7 +25,8 @@ type PageProps = {
 };
 
 export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
-  const { locale, slug } = await params;
+  const { locale, slug: rawSlug } = await params;
+  const slug = decodeSlug(rawSlug);
   const page = await getServerClient(locale).content.page.getBySlug(slug, locale).catch(() => null);
   if (!page) return { title: slug };
   const seo = page.data.seo ?? {};
@@ -36,7 +38,8 @@ export async function generateMetadata({ params }: PageProps): Promise<Metadata>
 }
 
 export default async function StaticPage({ params }: PageProps) {
-  const { locale, slug } = await params;
+  const { locale, slug: rawSlug } = await params;
+  const slug = decodeSlug(rawSlug);
   const page = await getServerClient(locale).content.page.getBySlug(slug, locale).catch(() => null);
   if (!page) notFound();
   return (
@@ -57,7 +60,8 @@ type PageProps = {
 };
 
 export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
-  const { slug } = await params;
+  const { slug: rawSlug } = await params;
+  const slug = decodeSlug(rawSlug);
   const page = await getServerClient().content.page.getBySlug(slug).catch(() => null);
   if (!page) return { title: slug };
   const seo = page.data.seo ?? {};
@@ -69,7 +73,8 @@ export async function generateMetadata({ params }: PageProps): Promise<Metadata>
 }
 
 export default async function StaticPage({ params }: PageProps) {
-  const { slug } = await params;
+  const { slug: rawSlug } = await params;
+  const slug = decodeSlug(rawSlug);
   const page = await getServerClient().content.page.getBySlug(slug).catch(() => null);
   if (!page) notFound();
   return (

package/templates/nextjs/base/src/app/products/[slug]/page.tsx

@@ -2,6 +2,7 @@ import type { Metadata } from 'next';
 import { notFound } from 'next/navigation';
 import { getServerClient } from '@/lib/brainerce';
 import { buildMetaDescription } from '@/lib/seo';
+import { decodeSlug } from '@/lib/utils';
 import { ProductJsonLd } from '@/components/seo/product-json-ld';
 import { ReviewsSection } from '@/components/reviews/reviews-section';
 import { ProductClientSection } from './product-client-section';
@@ -11,7 +12,8 @@ type Props = {
 };
 
 export async function generateMetadata({ params }: Props): Promise<Metadata> {
-  const { slug, locale } = await params;
+  const { slug: rawSlug, locale } = await params;
+  const slug = decodeSlug(rawSlug);
 
   try {
     const client = getServerClient(locale);
@@ -53,7 +55,8 @@ export async function generateMetadata({ params }: Props): Promise<Metadata> {
 }
 
 export default async function ProductDetailPage({ params }: Props) {
-  const { slug, locale } = await params;
+  const { slug: rawSlug, locale } = await params;
+  const slug = decodeSlug(rawSlug);
 
   let product;
   try {

package/templates/nextjs/base/src/lib/utils.ts

@@ -1,6 +1,21 @@
-import { clsx, type ClassValue } from 'clsx';
-import { twMerge } from 'tailwind-merge';
-
-export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs));
-}
+import { clsx, type ClassValue } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}
+
+/**
+ * Normalize a Next.js dynamic-route param into its decoded human-readable
+ * form. App Router usually decodes params automatically, but some runtime
+ * + middleware combinations leak percent-encoded values for non-ASCII
+ * slugs (e.g. Hebrew `%D7%A7…`), which then surface in canonical URLs and
+ * SEO tags. Idempotent on already-decoded input.
+ */
+export function decodeSlug(slug: string): string {
+  try {
+    return decodeURIComponent(slug);
+  } catch {
+    return slug;
+  }
+}