create-brainerce-store 1.66.0 → 1.68.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/dist/index.js +1 -1
  2. package/package.json +1 -1
  3. package/templates/nextjs/base/.env.local.ejs +52 -24
  4. package/templates/nextjs/base/.eslintrc.json +51 -57
  5. package/templates/nextjs/base/AGENTS.md.ejs +114 -81
  6. package/templates/nextjs/base/CLAUDE.md.ejs +125 -92
  7. package/templates/nextjs/base/next.config.ts +103 -86
  8. package/templates/nextjs/base/scripts/fetch-store-info.mjs +104 -97
  9. package/templates/nextjs/base/src/app/agents.md/route.ts +4 -3
  10. package/templates/nextjs/base/src/app/api/auth/me/route.ts +65 -59
  11. package/templates/nextjs/base/src/app/api/store/[...path]/route.ts +255 -242
  12. package/templates/nextjs/base/src/app/blog/[slug]/page.tsx.ejs +317 -308
  13. package/templates/nextjs/base/src/app/blog/page.tsx.ejs +277 -276
  14. package/templates/nextjs/base/src/app/blog/rss.xml/route.ts +4 -3
  15. package/templates/nextjs/base/src/app/category/[slug]/page.tsx +22 -12
  16. package/templates/nextjs/base/src/app/error.tsx.ejs +53 -0
  17. package/templates/nextjs/base/src/app/faq/page.tsx.ejs +46 -46
  18. package/templates/nextjs/base/src/app/indexnow-key.txt/route.ts +25 -26
  19. package/templates/nextjs/base/src/app/layout.tsx.ejs +273 -257
  20. package/templates/nextjs/base/src/app/llms.txt/route.ts +4 -3
  21. package/templates/nextjs/base/src/app/opengraph-image.tsx +1 -1
  22. package/templates/nextjs/base/src/app/page.tsx +65 -64
  23. package/templates/nextjs/base/src/app/pages/[slug]/page.tsx.ejs +98 -92
  24. package/templates/nextjs/base/src/app/products/[slug]/page.tsx +22 -11
  25. package/templates/nextjs/base/src/app/robots.ts +3 -2
  26. package/templates/nextjs/base/src/app/sitemap.ts +4 -3
  27. package/templates/nextjs/base/src/components/checkout/custom-fields-step.tsx +294 -292
  28. package/templates/nextjs/base/src/components/seo/article-json-ld.tsx +60 -59
  29. package/templates/nextjs/base/src/components/seo/category-json-ld.tsx +60 -61
  30. package/templates/nextjs/base/src/components/seo/product-json-ld.tsx +2 -1
  31. package/templates/nextjs/base/src/core/lib/brainerce.server.ts +81 -0
  32. package/templates/nextjs/base/src/core/lib/brainerce.ts.ejs +60 -110
  33. package/templates/nextjs/base/src/core/lib/site-url.ts +230 -0
  34. package/templates/nextjs/base/src/ui/product/review-form.tsx +294 -294
  35. package/templates/nextjs/base/src/ui/product/reviews-section.tsx.ejs +108 -108
  36. package/templates/nextjs/designs/atelier/app-overlay/layout.tsx.ejs +301 -285
  37. package/templates/nextjs/designs/atelier/ui/layout/faq-section.tsx +97 -96
  38. package/templates/nextjs/designs/atelier/ui/layout/site-footer.tsx.ejs +142 -141
  39. package/templates/nextjs/designs/atelier/ui/layout/site-header.tsx.ejs +139 -138
  40. package/templates/nextjs/designs/atelier/ui/product/review-form.tsx +295 -267
  41. package/templates/nextjs/designs/atelier/ui/product/reviews-section.tsx.ejs +148 -148
  42. package/templates/nextjs/ui-canvas/layout/faq-section.tsx.ejs +72 -71
  43. package/templates/nextjs/ui-canvas/layout/site-footer.tsx.ejs +83 -82
  44. package/templates/nextjs/ui-canvas/layout/site-header.tsx.ejs +120 -119
  45. package/templates/nextjs/ui-canvas/product/faq-section.tsx.ejs +54 -0
  46. package/templates/nextjs/ui-canvas/product/review-form.tsx +267 -266
  47. package/templates/nextjs/ui-canvas/product/reviews-section.tsx.ejs +96 -96
@@ -1,308 +1,317 @@
1
- /**
2
- * Blog post detail page — renders a single published blog post by its slug.
3
- *
4
- * - Fetches the post from the Brainerce SDK (returns null on 404)
5
- * - Generates full SEO metadata (title, description, OG image)
6
- * - Injects Article JSON-LD for Google rich snippets
7
- * - Body HTML is sanitized before rendering
8
- *
9
- * Security: always pass blog content through sanitizeHtml before dangerouslySetInnerHTML.
10
- */
11
- import * as React from 'react';
12
- import type { Metadata } from 'next';
13
- import { notFound, permanentRedirect } from 'next/navigation';
14
- import Link from 'next/link';
15
- import { CdnImage as Image } from '@/ui/shared/cdn-image';
16
- import { ArticleJsonLd } from '@/components/seo/article-json-ld';
17
-
18
- import { getServerClient, fetchStoreInfo } from '@/core/lib/brainerce';
19
- import { sanitizeHtml } from '@/core/lib/sanitize';
20
- import { decodeSlug } from '@/core/lib/utils';
21
-
22
- const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL || 'https://example.com';
23
-
24
- <% if (i18nEnabled) { %>
25
- type PageProps = {
26
- params: Promise<{ locale: string; slug: string }>;
27
- };
28
-
29
- export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
30
- const { locale, slug: rawSlug } = await params;
31
- const slug = decodeSlug(rawSlug);
32
- const [post, storeInfo] = await Promise.all([
33
- getServerClient(locale).blog.getPost(slug).catch(() => null),
34
- fetchStoreInfo(locale),
35
- ]);
36
- if (!post) return { title: slug };
37
-
38
- // Canonical + hreflang. Blog URLs use the same slug across locales (only
39
- // the locale prefix changes) — the same convention getBlogSitemapEntries
40
- // emits, so the alternates always match real, crawlable URLs.
41
- const supportedLocales = storeInfo?.i18n?.supportedLocales ?? [];
42
- const defaultLoc = storeInfo?.i18n?.defaultLocale ?? storeInfo?.language ?? '';
43
- const canonicalPath =
44
- locale && locale !== defaultLoc ? `/${locale}/blog/${post.slug}` : `/blog/${post.slug}`;
45
- const hreflangLanguages =
46
- supportedLocales.length > 1
47
- ? Object.fromEntries([
48
- ...supportedLocales.map((loc) => [
49
- loc,
50
- loc === defaultLoc
51
- ? `${SITE_URL}/blog/${post.slug}`
52
- : `${SITE_URL}/${loc}/blog/${post.slug}`,
53
- ]),
54
- ['x-default', `${SITE_URL}/blog/${post.slug}`],
55
- ])
56
- : undefined;
57
-
58
- return {
59
- title: post.seoTitle ?? post.title,
60
- description: post.seoDescription ?? post.excerpt,
61
- alternates: {
62
- canonical: canonicalPath,
63
- ...(hreflangLanguages ? { languages: hreflangLanguages } : {}),
64
- },
65
- openGraph: {
66
- title: post.seoTitle ?? post.title,
67
- description: post.seoDescription ?? post.excerpt ?? undefined,
68
- type: 'article',
69
- publishedTime: post.publishedAt ?? undefined,
70
- authors: post.author ? [post.author] : undefined,
71
- images: post.ogImageUrl
72
- ? [{ url: post.ogImageUrl }]
73
- : post.coverImageUrl
74
- ? [{ url: post.coverImageUrl }]
75
- : undefined,
76
- },
77
- };
78
- }
79
-
80
- export default async function BlogPostPage({ params }: PageProps) {
81
- const { locale, slug: rawSlug } = await params;
82
- const slug = decodeSlug(rawSlug);
83
- const client = getServerClient(locale);
84
- const [post, storeInfo] = await Promise.all([
85
- client.blog.getPost(slug).catch(() => null),
86
- client.getStoreInfo().catch(() => null),
87
- ]);
88
- if (!post) {
89
- // The slug may have been renamed — 301 to the current slug so the old
90
- // URL keeps its ranking; genuine unknowns fall through to the 404 page.
91
- // Default locale stays unprefixed (matches the sitemap/hreflang convention).
92
- const redirect = await client.resolveSlugRedirect('blog', slug);
93
- if (redirect) {
94
- const defaultLoc = storeInfo?.i18n?.defaultLocale ?? storeInfo?.language ?? '';
95
- const prefix = locale && locale !== defaultLoc ? `/${locale}` : '';
96
- permanentRedirect(`${prefix}/blog/${redirect.currentSlug}`);
97
- }
98
- notFound();
99
- }
100
-
101
- const isHe = locale === 'he';
102
- const dir = isHe ? 'rtl' : 'ltr';
103
- const backLabel = isHe ? '← חזרה לבלוג' : '← Back to blog';
104
- const articleUrl = `${SITE_URL}/blog/${post.slug}`;
105
-
106
- return (
107
- <main dir={dir} className="mx-auto max-w-3xl px-4 py-10 sm:px-6 lg:px-8">
108
- <ArticleJsonLd post={post} url={articleUrl} organizationName={storeInfo?.name} />
109
-
110
- {/* Back link */}
111
- <Link
112
- href="/blog"
113
- className="mb-6 inline-flex items-center gap-1 text-sm text-muted-foreground hover:text-foreground transition-colors"
114
- >
115
- {backLabel}
116
- </Link>
117
-
118
- {/* Category */}
119
- {post.category && (
120
- <div className="mb-3">
121
- <span className="rounded-full bg-primary/10 px-3 py-1 text-xs font-medium text-primary">
122
- {post.category}
123
- </span>
124
- </div>
125
- )}
126
-
127
- {/* Title */}
128
- <h1 className="mb-4 text-3xl font-bold tracking-tight text-foreground sm:text-4xl leading-tight">
129
- {post.title}
130
- </h1>
131
-
132
- {/* Meta row: author + date + tags */}
133
- <div className="mb-6 flex flex-wrap items-center gap-x-4 gap-y-2 text-sm text-muted-foreground border-b border-border pb-6">
134
- {post.author && <span className="font-medium text-foreground">{post.author}</span>}
135
- {post.publishedAt && (
136
- <time dateTime={post.publishedAt}>
137
- {new Date(post.publishedAt).toLocaleDateString(isHe ? 'he-IL' : 'en-US', {
138
- year: 'numeric',
139
- month: 'long',
140
- day: 'numeric',
141
- })}
142
- </time>
143
- )}
144
- {post.tags && post.tags.length > 0 && (
145
- <div className="flex flex-wrap gap-1.5">
146
- {post.tags.map((tag) => (
147
- <span
148
- key={tag}
149
- className="rounded-md bg-muted px-2 py-0.5 text-xs text-muted-foreground"
150
- >
151
- {tag}
152
- </span>
153
- ))}
154
- </div>
155
- )}
156
- </div>
157
-
158
- {/* Cover image */}
159
- {post.coverImageUrl && (
160
- <div className="mb-8 overflow-hidden rounded-xl">
161
- <Image
162
- src={post.coverImageUrl}
163
- alt={post.coverImageAlt ?? post.title}
164
- width={800}
165
- height={450}
166
- className="w-full object-cover"
167
- priority
168
- />
169
- </div>
170
- )}
171
-
172
- {/* Excerpt */}
173
- {post.excerpt && (
174
- <p className="mb-6 text-lg text-muted-foreground leading-relaxed font-light italic border-s-2 border-primary/40 ps-4">
175
- {post.excerpt}
176
- </p>
177
- )}
178
-
179
- {/* Body */}
180
- <div
181
- className="prose prose-neutral dark:prose-invert max-w-none"
182
- dangerouslySetInnerHTML={{ __html: sanitizeHtml(post.content) }}
183
- />
184
- </main>
185
- );
186
- }
187
- <% } else { %>
188
- type PageProps = {
189
- params: Promise<{ slug: string }>;
190
- };
191
-
192
- export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
193
- const { slug: rawSlug } = await params;
194
- const slug = decodeSlug(rawSlug);
195
- const post = await getServerClient().blog.getPost(slug).catch(() => null);
196
- if (!post) return { title: slug };
197
- return {
198
- title: post.seoTitle ?? post.title,
199
- description: post.seoDescription ?? post.excerpt,
200
- alternates: { canonical: `/blog/${post.slug}` },
201
- openGraph: {
202
- title: post.seoTitle ?? post.title,
203
- description: post.seoDescription ?? post.excerpt ?? undefined,
204
- type: 'article',
205
- publishedTime: post.publishedAt ?? undefined,
206
- authors: post.author ? [post.author] : undefined,
207
- images: post.ogImageUrl
208
- ? [{ url: post.ogImageUrl }]
209
- : post.coverImageUrl
210
- ? [{ url: post.coverImageUrl }]
211
- : undefined,
212
- },
213
- };
214
- }
215
-
216
- export default async function BlogPostPage({ params }: PageProps) {
217
- const { slug: rawSlug } = await params;
218
- const slug = decodeSlug(rawSlug);
219
- const client = getServerClient();
220
- const [post, storeInfo] = await Promise.all([
221
- client.blog.getPost(slug).catch(() => null),
222
- client.getStoreInfo().catch(() => null),
223
- ]);
224
- if (!post) {
225
- // The slug may have been renamed — 301 to the current slug so the old
226
- // URL keeps its ranking; genuine unknowns fall through to the 404 page.
227
- const redirect = await client.resolveSlugRedirect('blog', slug);
228
- if (redirect) permanentRedirect(`/blog/${redirect.currentSlug}`);
229
- notFound();
230
- }
231
-
232
- const articleUrl = `${SITE_URL}/blog/${post.slug}`;
233
-
234
- return (
235
- <main className="mx-auto max-w-3xl px-4 py-10 sm:px-6 lg:px-8">
236
- <ArticleJsonLd post={post} url={articleUrl} organizationName={storeInfo?.name} />
237
-
238
- <Link
239
- href="/blog"
240
- className="mb-6 inline-flex items-center gap-1 text-sm text-muted-foreground hover:text-foreground transition-colors"
241
- >
242
- ← Back to blog
243
- </Link>
244
-
245
- {post.category && (
246
- <div className="mb-3">
247
- <span className="rounded-full bg-primary/10 px-3 py-1 text-xs font-medium text-primary">
248
- {post.category}
249
- </span>
250
- </div>
251
- )}
252
-
253
- <h1 className="mb-4 text-3xl font-bold tracking-tight text-foreground sm:text-4xl leading-tight">
254
- {post.title}
255
- </h1>
256
-
257
- <div className="mb-6 flex flex-wrap items-center gap-x-4 gap-y-2 text-sm text-muted-foreground border-b border-border pb-6">
258
- {post.author && <span className="font-medium text-foreground">{post.author}</span>}
259
- {post.publishedAt && (
260
- <time dateTime={post.publishedAt}>
261
- {new Date(post.publishedAt).toLocaleDateString('en-US', {
262
- year: 'numeric',
263
- month: 'long',
264
- day: 'numeric',
265
- })}
266
- </time>
267
- )}
268
- {post.tags && post.tags.length > 0 && (
269
- <div className="flex flex-wrap gap-1.5">
270
- {post.tags.map((tag) => (
271
- <span
272
- key={tag}
273
- className="rounded-md bg-muted px-2 py-0.5 text-xs text-muted-foreground"
274
- >
275
- {tag}
276
- </span>
277
- ))}
278
- </div>
279
- )}
280
- </div>
281
-
282
- {post.coverImageUrl && (
283
- <div className="mb-8 overflow-hidden rounded-xl">
284
- <Image
285
- src={post.coverImageUrl}
286
- alt={post.coverImageAlt ?? post.title}
287
- width={800}
288
- height={450}
289
- className="w-full object-cover"
290
- priority
291
- />
292
- </div>
293
- )}
294
-
295
- {post.excerpt && (
296
- <p className="mb-6 text-lg text-muted-foreground leading-relaxed font-light italic border-s-2 border-primary/40 ps-4">
297
- {post.excerpt}
298
- </p>
299
- )}
300
-
301
- <div
302
- className="prose prose-neutral dark:prose-invert max-w-none"
303
- dangerouslySetInnerHTML={{ __html: sanitizeHtml(post.content) }}
304
- />
305
- </main>
306
- );
307
- }
308
- <% } %>
1
+ /**
2
+ * Blog post detail page — renders a single published blog post by its slug.
3
+ *
4
+ * - Fetches the post from the Brainerce SDK (returns null on 404)
5
+ * - Generates full SEO metadata (title, description, OG image)
6
+ * - Injects Article JSON-LD for Google rich snippets
7
+ * - Body HTML is sanitized before rendering
8
+ *
9
+ * Security: always pass blog content through sanitizeHtml before dangerouslySetInnerHTML.
10
+ */
11
+ import * as React from 'react';
12
+ import type { Metadata } from 'next';
13
+ import { notFound, permanentRedirect } from 'next/navigation';
14
+ import Link from 'next/link';
15
+ import { CdnImage as Image } from '@/ui/shared/cdn-image';
16
+ import { ArticleJsonLd } from '@/components/seo/article-json-ld';
17
+ import { getCanonicalSiteUrl } from '@/core/lib/site-url';
18
+
19
+ import { getServerClient, fetchStoreInfo } from '@/core/lib/brainerce.server';
20
+ import { sanitizeHtml } from '@/core/lib/sanitize';
21
+ import { decodeSlug } from '@/core/lib/utils';
22
+
23
+
24
+ <% if (i18nEnabled) { %>
25
+ type PageProps = {
26
+ params: Promise<{ locale: string; slug: string }>;
27
+ };
28
+
29
+ export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
30
+ const { locale, slug: rawSlug } = await params;
31
+ const slug = decodeSlug(rawSlug);
32
+ const [post, storeInfo] = await Promise.all([
33
+ (await getServerClient(locale)).blog.getPost(slug).catch(() => null),
34
+ fetchStoreInfo(locale),
35
+ ]);
36
+ if (!post) return { title: slug };
37
+
38
+ // Canonical + hreflang. Blog URLs use the same slug across locales (only
39
+ // the locale prefix changes) — the same convention getBlogSitemapEntries
40
+ // emits, so the alternates always match real, crawlable URLs.
41
+ const supportedLocales = storeInfo?.i18n?.supportedLocales ?? [];
42
+ const defaultLoc = storeInfo?.i18n?.defaultLocale ?? storeInfo?.language ?? '';
43
+ const SITE_URL = await getCanonicalSiteUrl();
44
+ const canonicalPath =
45
+ locale && locale !== defaultLoc ? `/${locale}/blog/${post.slug}` : `/blog/${post.slug}`;
46
+ const hreflangLanguages =
47
+ supportedLocales.length > 1
48
+ ? Object.fromEntries([
49
+ ...supportedLocales.map((loc) => [
50
+ loc,
51
+ loc === defaultLoc
52
+ ? `${SITE_URL}/blog/${post.slug}`
53
+ : `${SITE_URL}/${loc}/blog/${post.slug}`,
54
+ ]),
55
+ ['x-default', `${SITE_URL}/blog/${post.slug}`],
56
+ ])
57
+ : undefined;
58
+
59
+ return {
60
+ title: post.seoTitle ?? post.title,
61
+ description: post.seoDescription ?? post.excerpt,
62
+ alternates: {
63
+ canonical: canonicalPath,
64
+ ...(hreflangLanguages ? { languages: hreflangLanguages } : {}),
65
+ },
66
+ openGraph: {
67
+ title: post.seoTitle ?? post.title,
68
+ description: post.seoDescription ?? post.excerpt ?? undefined,
69
+ type: 'article',
70
+ publishedTime: post.publishedAt ?? undefined,
71
+ authors: post.author ? [post.author] : undefined,
72
+ images: post.ogImageUrl
73
+ ? [{ url: post.ogImageUrl }]
74
+ : post.coverImageUrl
75
+ ? [{ url: post.coverImageUrl }]
76
+ : undefined,
77
+ },
78
+ };
79
+ }
80
+
81
+ export default async function BlogPostPage({ params }: PageProps) {
82
+ const { locale, slug: rawSlug } = await params;
83
+ const slug = decodeSlug(rawSlug);
84
+ const client = await getServerClient(locale);
85
+ const [post, storeInfo] = await Promise.all([
86
+ // getPost returns null only on a genuine 404; any other API failure (a
87
+ // 403 from the channel's origin check, a network error) throws and
88
+ // surfaces as the error it is instead of masquerading as a missing post.
89
+ client.blog.getPost(slug),
90
+ client.getStoreInfo().catch(() => null),
91
+ ]);
92
+ if (!post) {
93
+ // The slug may have been renamed — 301 to the current slug so the old
94
+ // URL keeps its ranking; genuine unknowns fall through to the 404 page.
95
+ // Default locale stays unprefixed (matches the sitemap/hreflang convention).
96
+ const redirect = await client.resolveSlugRedirect('blog', slug);
97
+ if (redirect) {
98
+ const defaultLoc = storeInfo?.i18n?.defaultLocale ?? storeInfo?.language ?? '';
99
+ const prefix = locale && locale !== defaultLoc ? `/${locale}` : '';
100
+ permanentRedirect(`${prefix}/blog/${redirect.currentSlug}`);
101
+ }
102
+ notFound();
103
+ }
104
+
105
+ const isHe = locale === 'he';
106
+ const dir = isHe ? 'rtl' : 'ltr';
107
+ const backLabel = isHe ? '← חזרה לבלוג' : '← Back to blog';
108
+ const SITE_URL = await getCanonicalSiteUrl();
109
+ const articleUrl = `${SITE_URL}/blog/${post.slug}`;
110
+
111
+ return (
112
+ <main dir={dir} className="mx-auto max-w-3xl px-4 py-10 sm:px-6 lg:px-8">
113
+ <ArticleJsonLd post={post} url={articleUrl} organizationName={storeInfo?.name} />
114
+
115
+ {/* Back link */}
116
+ <Link
117
+ href="/blog"
118
+ className="mb-6 inline-flex items-center gap-1 text-sm text-muted-foreground hover:text-foreground transition-colors"
119
+ >
120
+ {backLabel}
121
+ </Link>
122
+
123
+ {/* Category */}
124
+ {post.category && (
125
+ <div className="mb-3">
126
+ <span className="rounded-full bg-primary/10 px-3 py-1 text-xs font-medium text-primary">
127
+ {post.category}
128
+ </span>
129
+ </div>
130
+ )}
131
+
132
+ {/* Title */}
133
+ <h1 className="mb-4 text-3xl font-bold tracking-tight text-foreground sm:text-4xl leading-tight">
134
+ {post.title}
135
+ </h1>
136
+
137
+ {/* Meta row: author + date + tags */}
138
+ <div className="mb-6 flex flex-wrap items-center gap-x-4 gap-y-2 text-sm text-muted-foreground border-b border-border pb-6">
139
+ {post.author && <span className="font-medium text-foreground">{post.author}</span>}
140
+ {post.publishedAt && (
141
+ <time dateTime={post.publishedAt}>
142
+ {new Date(post.publishedAt).toLocaleDateString(isHe ? 'he-IL' : 'en-US', {
143
+ year: 'numeric',
144
+ month: 'long',
145
+ day: 'numeric',
146
+ })}
147
+ </time>
148
+ )}
149
+ {post.tags && post.tags.length > 0 && (
150
+ <div className="flex flex-wrap gap-1.5">
151
+ {post.tags.map((tag) => (
152
+ <span
153
+ key={tag}
154
+ className="rounded-md bg-muted px-2 py-0.5 text-xs text-muted-foreground"
155
+ >
156
+ {tag}
157
+ </span>
158
+ ))}
159
+ </div>
160
+ )}
161
+ </div>
162
+
163
+ {/* Cover image */}
164
+ {post.coverImageUrl && (
165
+ <div className="mb-8 overflow-hidden rounded-xl">
166
+ <Image
167
+ src={post.coverImageUrl}
168
+ alt={post.coverImageAlt ?? post.title}
169
+ width={800}
170
+ height={450}
171
+ className="w-full object-cover"
172
+ priority
173
+ />
174
+ </div>
175
+ )}
176
+
177
+ {/* Excerpt */}
178
+ {post.excerpt && (
179
+ <p className="mb-6 text-lg text-muted-foreground leading-relaxed font-light italic border-s-2 border-primary/40 ps-4">
180
+ {post.excerpt}
181
+ </p>
182
+ )}
183
+
184
+ {/* Body */}
185
+ <div
186
+ className="prose prose-neutral dark:prose-invert max-w-none"
187
+ dangerouslySetInnerHTML={{ __html: sanitizeHtml(post.content) }}
188
+ />
189
+ </main>
190
+ );
191
+ }
192
+ <% } else { %>
193
+ type PageProps = {
194
+ params: Promise<{ slug: string }>;
195
+ };
196
+
197
+ export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
198
+ const { slug: rawSlug } = await params;
199
+ const slug = decodeSlug(rawSlug);
200
+ const post = await (await getServerClient()).blog.getPost(slug).catch(() => null);
201
+ if (!post) return { title: slug };
202
+ return {
203
+ title: post.seoTitle ?? post.title,
204
+ description: post.seoDescription ?? post.excerpt,
205
+ alternates: { canonical: `/blog/${post.slug}` },
206
+ openGraph: {
207
+ title: post.seoTitle ?? post.title,
208
+ description: post.seoDescription ?? post.excerpt ?? undefined,
209
+ type: 'article',
210
+ publishedTime: post.publishedAt ?? undefined,
211
+ authors: post.author ? [post.author] : undefined,
212
+ images: post.ogImageUrl
213
+ ? [{ url: post.ogImageUrl }]
214
+ : post.coverImageUrl
215
+ ? [{ url: post.coverImageUrl }]
216
+ : undefined,
217
+ },
218
+ };
219
+ }
220
+
221
+ export default async function BlogPostPage({ params }: PageProps) {
222
+ const { slug: rawSlug } = await params;
223
+ const slug = decodeSlug(rawSlug);
224
+ const client = await getServerClient();
225
+ const [post, storeInfo] = await Promise.all([
226
+ // getPost returns null only on a genuine 404; any other API failure (a
227
+ // 403 from the channel's origin check, a network error) throws and
228
+ // surfaces as the error it is instead of masquerading as a missing post.
229
+ client.blog.getPost(slug),
230
+ client.getStoreInfo().catch(() => null),
231
+ ]);
232
+ if (!post) {
233
+ // The slug may have been renamed — 301 to the current slug so the old
234
+ // URL keeps its ranking; genuine unknowns fall through to the 404 page.
235
+ const redirect = await client.resolveSlugRedirect('blog', slug);
236
+ if (redirect) permanentRedirect(`/blog/${redirect.currentSlug}`);
237
+ notFound();
238
+ }
239
+
240
+ const SITE_URL = await getCanonicalSiteUrl();
241
+ const articleUrl = `${SITE_URL}/blog/${post.slug}`;
242
+
243
+ return (
244
+ <main className="mx-auto max-w-3xl px-4 py-10 sm:px-6 lg:px-8">
245
+ <ArticleJsonLd post={post} url={articleUrl} organizationName={storeInfo?.name} />
246
+
247
+ <Link
248
+ href="/blog"
249
+ className="mb-6 inline-flex items-center gap-1 text-sm text-muted-foreground hover:text-foreground transition-colors"
250
+ >
251
+ ← Back to blog
252
+ </Link>
253
+
254
+ {post.category && (
255
+ <div className="mb-3">
256
+ <span className="rounded-full bg-primary/10 px-3 py-1 text-xs font-medium text-primary">
257
+ {post.category}
258
+ </span>
259
+ </div>
260
+ )}
261
+
262
+ <h1 className="mb-4 text-3xl font-bold tracking-tight text-foreground sm:text-4xl leading-tight">
263
+ {post.title}
264
+ </h1>
265
+
266
+ <div className="mb-6 flex flex-wrap items-center gap-x-4 gap-y-2 text-sm text-muted-foreground border-b border-border pb-6">
267
+ {post.author && <span className="font-medium text-foreground">{post.author}</span>}
268
+ {post.publishedAt && (
269
+ <time dateTime={post.publishedAt}>
270
+ {new Date(post.publishedAt).toLocaleDateString('en-US', {
271
+ year: 'numeric',
272
+ month: 'long',
273
+ day: 'numeric',
274
+ })}
275
+ </time>
276
+ )}
277
+ {post.tags && post.tags.length > 0 && (
278
+ <div className="flex flex-wrap gap-1.5">
279
+ {post.tags.map((tag) => (
280
+ <span
281
+ key={tag}
282
+ className="rounded-md bg-muted px-2 py-0.5 text-xs text-muted-foreground"
283
+ >
284
+ {tag}
285
+ </span>
286
+ ))}
287
+ </div>
288
+ )}
289
+ </div>
290
+
291
+ {post.coverImageUrl && (
292
+ <div className="mb-8 overflow-hidden rounded-xl">
293
+ <Image
294
+ src={post.coverImageUrl}
295
+ alt={post.coverImageAlt ?? post.title}
296
+ width={800}
297
+ height={450}
298
+ className="w-full object-cover"
299
+ priority
300
+ />
301
+ </div>
302
+ )}
303
+
304
+ {post.excerpt && (
305
+ <p className="mb-6 text-lg text-muted-foreground leading-relaxed font-light italic border-s-2 border-primary/40 ps-4">
306
+ {post.excerpt}
307
+ </p>
308
+ )}
309
+
310
+ <div
311
+ className="prose prose-neutral dark:prose-invert max-w-none"
312
+ dangerouslySetInnerHTML={{ __html: sanitizeHtml(post.content) }}
313
+ />
314
+ </main>
315
+ );
316
+ }
317
+ <% } %>