create-brainerce-store 1.66.0 → 1.67.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 (46) hide show
  1. package/dist/index.js +1 -1
  2. package/package.json +1 -1
  3. package/templates/nextjs/base/.env.local.ejs +45 -24
  4. package/templates/nextjs/base/.eslintrc.json +51 -57
  5. package/templates/nextjs/base/AGENTS.md.ejs +107 -81
  6. package/templates/nextjs/base/CLAUDE.md.ejs +118 -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 +311 -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 +6 -5
  16. package/templates/nextjs/base/src/app/faq/page.tsx.ejs +46 -46
  17. package/templates/nextjs/base/src/app/indexnow-key.txt/route.ts +25 -26
  18. package/templates/nextjs/base/src/app/layout.tsx.ejs +273 -257
  19. package/templates/nextjs/base/src/app/llms.txt/route.ts +4 -3
  20. package/templates/nextjs/base/src/app/opengraph-image.tsx +1 -1
  21. package/templates/nextjs/base/src/app/page.tsx +65 -64
  22. package/templates/nextjs/base/src/app/pages/[slug]/page.tsx.ejs +92 -92
  23. package/templates/nextjs/base/src/app/products/[slug]/page.tsx +6 -5
  24. package/templates/nextjs/base/src/app/robots.ts +3 -2
  25. package/templates/nextjs/base/src/app/sitemap.ts +4 -3
  26. package/templates/nextjs/base/src/components/checkout/custom-fields-step.tsx +294 -292
  27. package/templates/nextjs/base/src/components/seo/article-json-ld.tsx +60 -59
  28. package/templates/nextjs/base/src/components/seo/category-json-ld.tsx +60 -61
  29. package/templates/nextjs/base/src/components/seo/product-json-ld.tsx +2 -1
  30. package/templates/nextjs/base/src/core/lib/brainerce.server.ts +81 -0
  31. package/templates/nextjs/base/src/core/lib/brainerce.ts.ejs +60 -110
  32. package/templates/nextjs/base/src/core/lib/site-url.ts +197 -0
  33. package/templates/nextjs/base/src/ui/product/review-form.tsx +294 -294
  34. package/templates/nextjs/base/src/ui/product/reviews-section.tsx.ejs +108 -108
  35. package/templates/nextjs/designs/atelier/app-overlay/layout.tsx.ejs +301 -285
  36. package/templates/nextjs/designs/atelier/ui/layout/faq-section.tsx +97 -96
  37. package/templates/nextjs/designs/atelier/ui/layout/site-footer.tsx.ejs +142 -141
  38. package/templates/nextjs/designs/atelier/ui/layout/site-header.tsx.ejs +139 -138
  39. package/templates/nextjs/designs/atelier/ui/product/review-form.tsx +295 -267
  40. package/templates/nextjs/designs/atelier/ui/product/reviews-section.tsx.ejs +148 -148
  41. package/templates/nextjs/ui-canvas/layout/faq-section.tsx.ejs +72 -71
  42. package/templates/nextjs/ui-canvas/layout/site-footer.tsx.ejs +83 -82
  43. package/templates/nextjs/ui-canvas/layout/site-header.tsx.ejs +120 -119
  44. package/templates/nextjs/ui-canvas/product/faq-section.tsx.ejs +54 -0
  45. package/templates/nextjs/ui-canvas/product/review-form.tsx +267 -266
  46. package/templates/nextjs/ui-canvas/product/reviews-section.tsx.ejs +96 -96
@@ -1,294 +1,294 @@
1
- 'use client';
2
-
3
- import { useEffect, useState } from 'react';
4
- import { Star } from 'lucide-react';
5
- import { getClient } from '@/core/lib/brainerce';
6
- import { checkAuthStatus } from '@/core/lib/auth';
7
- import { Link } from '@/core/lib/navigation';
8
- import { useTranslations } from '@/core/lib/translations';
9
- import { Button } from '@/components/ui/button';
10
- import { Label } from '@/components/ui/label';
11
- import { Textarea } from '@/components/ui/textarea';
12
- import type { MyProductReview, ProductReview } from 'brainerce';
13
-
14
- interface ReviewFormProps {
15
- productId: string;
16
- }
17
-
18
- type Stage =
19
- | { kind: 'loading' }
20
- | { kind: 'signed_out' }
21
- | { kind: 'not_eligible'; reason: MyProductReview['reason'] }
22
- | { kind: 'submit' }
23
- | { kind: 'edit'; review: ProductReview };
24
-
25
- /**
26
- * Single component that decides which UI to render for a customer on a PDP:
27
- * - Loading while we check auth state and eligibility
28
- * - Signed out -> sign-in CTA
29
- * - Signed in but not eligible -> "purchase this product to review"
30
- * - Eligible without review -> submit form
31
- * - Eligible with existing review -> edit/delete form (rating + body prefilled)
32
- */
33
- export function ReviewForm({ productId }: ReviewFormProps) {
34
- const [stage, setStage] = useState<Stage>({ kind: 'loading' });
35
- const t = useTranslations('reviews');
36
-
37
- useEffect(() => {
38
- let cancelled = false;
39
- async function load() {
40
- const auth = await checkAuthStatus();
41
- if (cancelled) return;
42
- if (!auth.isLoggedIn) {
43
- setStage({ kind: 'signed_out' });
44
- return;
45
- }
46
- try {
47
- const me = await getClient().getMyProductReview(productId);
48
- if (cancelled) return;
49
- if (!me.eligible) {
50
- setStage({ kind: 'not_eligible', reason: me.reason });
51
- return;
52
- }
53
- if (me.myReview) {
54
- setStage({ kind: 'edit', review: me.myReview });
55
- return;
56
- }
57
- setStage({ kind: 'submit' });
58
- } catch {
59
- if (!cancelled) setStage({ kind: 'not_eligible', reason: 'product_not_found' });
60
- }
61
- }
62
- void load();
63
- return () => {
64
- cancelled = true;
65
- };
66
- }, [productId]);
67
-
68
- if (stage.kind === 'loading') {
69
- return <div className="text-muted-foreground text-sm">{t('loading')}</div>;
70
- }
71
-
72
- if (stage.kind === 'signed_out') {
73
- return (
74
- <div className="rounded-md border p-4">
75
- <p className="text-sm">
76
- <Link href="/account/login" className="font-medium underline">
77
- {t('signIn')}
78
- </Link>{' '}
79
- {t('signInSuffix')}
80
- </p>
81
- </div>
82
- );
83
- }
84
-
85
- if (stage.kind === 'not_eligible') {
86
- return <NotEligibleMessage reason={stage.reason} />;
87
- }
88
-
89
- if (stage.kind === 'edit') {
90
- return (
91
- <EditReviewBlock
92
- productId={productId}
93
- initial={stage.review}
94
- onDeleted={() => setStage({ kind: 'submit' })}
95
- />
96
- );
97
- }
98
-
99
- return <SubmitReviewBlock productId={productId} />;
100
- }
101
-
102
- function NotEligibleMessage({ reason }: { reason: MyProductReview['reason'] }) {
103
- const t = useTranslations('reviews');
104
- let message: string;
105
- switch (reason) {
106
- case 'no_eligible_order':
107
- message = t('onlyPurchasers');
108
- break;
109
- case 'reviews_disabled':
110
- message = t('reviewsDisabled');
111
- break;
112
- default:
113
- message = t('cannotReview');
114
- }
115
- return (
116
- <div className="bg-muted/30 rounded-md border p-4">
117
- <p className="text-muted-foreground text-sm">{message}</p>
118
- </div>
119
- );
120
- }
121
-
122
- function SubmitReviewBlock({ productId }: { productId: string }) {
123
- return <ReviewEditor productId={productId} mode="create" initialRating={5} initialBody="" />;
124
- }
125
-
126
- function EditReviewBlock({
127
- productId,
128
- initial,
129
- onDeleted,
130
- }: {
131
- productId: string;
132
- initial: ProductReview;
133
- onDeleted: () => void;
134
- }) {
135
- const [deleting, setDeleting] = useState(false);
136
- const t = useTranslations('reviews');
137
- const [deleteError, setDeleteError] = useState<string | null>(null);
138
-
139
- async function handleDelete() {
140
- if (!window.confirm(t('confirmDelete'))) return;
141
- setDeleting(true);
142
- setDeleteError(null);
143
- try {
144
- await getClient().deleteMyProductReview(productId);
145
- onDeleted();
146
- window.location.reload();
147
- } catch {
148
- setDeleteError(t('deleteFailed'));
149
- } finally {
150
- setDeleting(false);
151
- }
152
- }
153
-
154
- return (
155
- <div className="space-y-3">
156
- <ReviewEditor
157
- productId={productId}
158
- mode="edit"
159
- initialRating={initial.rating}
160
- initialBody={initial.body ?? ''}
161
- />
162
- <div className="flex items-center justify-between rounded-md border border-red-100 bg-red-50/50 p-3">
163
- <p className="text-xs text-red-700">{t('startOver')}</p>
164
- <button
165
- type="button"
166
- onClick={handleDelete}
167
- disabled={deleting}
168
- className="text-xs font-medium text-red-700 underline disabled:opacity-50"
169
- >
170
- {deleting ? t('deleting') : t('deleteReview')}
171
- </button>
172
- </div>
173
- {deleteError && (
174
- <p role="alert" className="text-sm text-red-700">
175
- {deleteError}
176
- </p>
177
- )}
178
- </div>
179
- );
180
- }
181
-
182
- /**
183
- * The actual form. Same shape for create and edit — only the API method
184
- * and the heading differ. Optimistic UX: success state + page reload to
185
- * let the server-rendered reviews list pick up the change.
186
- */
187
- function ReviewEditor({
188
- productId,
189
- mode,
190
- initialRating,
191
- initialBody,
192
- }: {
193
- productId: string;
194
- mode: 'create' | 'edit';
195
- initialRating: number;
196
- initialBody: string;
197
- }) {
198
- const [rating, setRating] = useState(initialRating);
199
- const t = useTranslations('reviews');
200
- const [body, setBody] = useState(initialBody);
201
- const [submitting, setSubmitting] = useState(false);
202
- const [error, setError] = useState<string | null>(null);
203
- const [success, setSuccess] = useState(false);
204
-
205
- async function handleSubmit(event: React.FormEvent<HTMLFormElement>) {
206
- event.preventDefault();
207
- setError(null);
208
- setSubmitting(true);
209
- try {
210
- const client = getClient();
211
- const input = { rating, body: body.trim() || undefined };
212
- if (mode === 'edit') {
213
- await client.updateMyProductReview(productId, input);
214
- } else {
215
- await client.submitProductReview(productId, input);
216
- }
217
- setSuccess(true);
218
- setTimeout(() => window.location.reload(), 1200);
219
- } catch (err) {
220
- const status = (err as { status?: number })?.status;
221
- if (status === 409) {
222
- setError(t('alreadySubmitted'));
223
- } else if (status === 403) {
224
- setError(t('onlyPurchasers'));
225
- } else if (status === 429) {
226
- setError(t('tooMany'));
227
- } else {
228
- setError(mode === 'edit' ? t('updateFailed') : t('submitFailed'));
229
- }
230
- } finally {
231
- setSubmitting(false);
232
- }
233
- }
234
-
235
- if (success) {
236
- return (
237
- <p className="rounded-md border border-emerald-200 bg-emerald-50 p-3 text-sm text-emerald-700">
238
- {mode === 'edit' ? t('thanksUpdated') : t('thanksSubmitted')}
239
- </p>
240
- );
241
- }
242
-
243
- return (
244
- <form onSubmit={handleSubmit} className="space-y-3 rounded-md border p-4">
245
- <h3 className="font-medium">{mode === 'edit' ? t('editYourReview') : t('writeReview')}</h3>
246
-
247
- <fieldset>
248
- <legend className="mb-1 text-sm">{t('yourRating')}</legend>
249
- <div className="inline-flex gap-1" role="radiogroup" aria-label={t('starRating')}>
250
- {[1, 2, 3, 4, 5].map((n) => (
251
- <button
252
- key={n}
253
- type="button"
254
- role="radio"
255
- aria-checked={rating === n}
256
- onClick={() => setRating(n)}
257
- className={n <= rating ? 'text-yellow-500' : 'text-gray-300'}
258
- >
259
- <Star className="h-6 w-6 fill-current" aria-hidden="true" />
260
- </button>
261
- ))}
262
- </div>
263
- </fieldset>
264
-
265
- <Label className="block text-sm font-normal">
266
- {t('yourReview')}{' '}
267
- <span className="text-muted-foreground text-xs">({t('optionalField')})</span>
268
- <Textarea
269
- value={body}
270
- onChange={(event) => setBody(event.target.value)}
271
- maxLength={5000}
272
- rows={4}
273
- className="mt-1 rounded"
274
- />
275
- </Label>
276
-
277
- {error && (
278
- <p role="alert" className="text-sm text-red-700">
279
- {error}
280
- </p>
281
- )}
282
-
283
- <Button type="submit" disabled={submitting}>
284
- {submitting
285
- ? mode === 'edit'
286
- ? t('saving')
287
- : t('submittingBtn')
288
- : mode === 'edit'
289
- ? t('saveChanges')
290
- : t('submitReview')}
291
- </Button>
292
- </form>
293
- );
294
- }
1
+ 'use client';
2
+
3
+ import { useEffect, useState } from 'react';
4
+ import { Star } from 'lucide-react';
5
+ import { getClient } from '@/core/lib/brainerce';
6
+ import { checkAuthStatus } from '@/core/lib/auth';
7
+ import { Link } from '@/core/lib/navigation';
8
+ import { useTranslations } from '@/core/lib/translations';
9
+ import { Button } from '@/components/ui/button';
10
+ import { Label } from '@/components/ui/label';
11
+ import { Textarea } from '@/components/ui/textarea';
12
+ import type { MyProductReview, ProductReview } from 'brainerce';
13
+
14
+ interface ReviewFormProps {
15
+ productId: string;
16
+ }
17
+
18
+ type Stage =
19
+ | { kind: 'loading' }
20
+ | { kind: 'signed_out' }
21
+ | { kind: 'not_eligible'; reason: MyProductReview['reason'] }
22
+ | { kind: 'submit' }
23
+ | { kind: 'edit'; review: ProductReview };
24
+
25
+ /**
26
+ * Single component that decides which UI to render for a customer on a PDP:
27
+ * - Loading while we check auth state and eligibility
28
+ * - Signed out -> sign-in CTA
29
+ * - Signed in but not eligible -> "purchase this product to review"
30
+ * - Eligible without review -> submit form
31
+ * - Eligible with existing review -> edit/delete form (rating + body prefilled)
32
+ */
33
+ export function ReviewForm({ productId }: ReviewFormProps) {
34
+ const [stage, setStage] = useState<Stage>({ kind: 'loading' });
35
+ const t = useTranslations('reviews');
36
+
37
+ useEffect(() => {
38
+ let cancelled = false;
39
+ async function load() {
40
+ const auth = await checkAuthStatus();
41
+ if (cancelled) return;
42
+ if (!auth.isLoggedIn) {
43
+ setStage({ kind: 'signed_out' });
44
+ return;
45
+ }
46
+ try {
47
+ const me = await getClient().getMyProductReview(productId);
48
+ if (cancelled) return;
49
+ if (!me.eligible) {
50
+ setStage({ kind: 'not_eligible', reason: me.reason });
51
+ return;
52
+ }
53
+ if (me.myReview) {
54
+ setStage({ kind: 'edit', review: me.myReview });
55
+ return;
56
+ }
57
+ setStage({ kind: 'submit' });
58
+ } catch {
59
+ if (!cancelled) setStage({ kind: 'not_eligible', reason: 'product_not_found' });
60
+ }
61
+ }
62
+ void load();
63
+ return () => {
64
+ cancelled = true;
65
+ };
66
+ }, [productId]);
67
+
68
+ if (stage.kind === 'loading') {
69
+ return <div className="text-muted-foreground text-sm">{t('loading')}</div>;
70
+ }
71
+
72
+ if (stage.kind === 'signed_out') {
73
+ return (
74
+ <div className="rounded-md border p-4">
75
+ <p className="text-sm">
76
+ <Link href="/login" className="font-medium underline">
77
+ {t('signIn')}
78
+ </Link>{' '}
79
+ {t('signInSuffix')}
80
+ </p>
81
+ </div>
82
+ );
83
+ }
84
+
85
+ if (stage.kind === 'not_eligible') {
86
+ return <NotEligibleMessage reason={stage.reason} />;
87
+ }
88
+
89
+ if (stage.kind === 'edit') {
90
+ return (
91
+ <EditReviewBlock
92
+ productId={productId}
93
+ initial={stage.review}
94
+ onDeleted={() => setStage({ kind: 'submit' })}
95
+ />
96
+ );
97
+ }
98
+
99
+ return <SubmitReviewBlock productId={productId} />;
100
+ }
101
+
102
+ function NotEligibleMessage({ reason }: { reason: MyProductReview['reason'] }) {
103
+ const t = useTranslations('reviews');
104
+ let message: string;
105
+ switch (reason) {
106
+ case 'no_eligible_order':
107
+ message = t('onlyPurchasers');
108
+ break;
109
+ case 'reviews_disabled':
110
+ message = t('reviewsDisabled');
111
+ break;
112
+ default:
113
+ message = t('cannotReview');
114
+ }
115
+ return (
116
+ <div className="bg-muted/30 rounded-md border p-4">
117
+ <p className="text-muted-foreground text-sm">{message}</p>
118
+ </div>
119
+ );
120
+ }
121
+
122
+ function SubmitReviewBlock({ productId }: { productId: string }) {
123
+ return <ReviewEditor productId={productId} mode="create" initialRating={5} initialBody="" />;
124
+ }
125
+
126
+ function EditReviewBlock({
127
+ productId,
128
+ initial,
129
+ onDeleted,
130
+ }: {
131
+ productId: string;
132
+ initial: ProductReview;
133
+ onDeleted: () => void;
134
+ }) {
135
+ const [deleting, setDeleting] = useState(false);
136
+ const t = useTranslations('reviews');
137
+ const [deleteError, setDeleteError] = useState<string | null>(null);
138
+
139
+ async function handleDelete() {
140
+ if (!window.confirm(t('confirmDelete'))) return;
141
+ setDeleting(true);
142
+ setDeleteError(null);
143
+ try {
144
+ await getClient().deleteMyProductReview(productId);
145
+ onDeleted();
146
+ window.location.reload();
147
+ } catch {
148
+ setDeleteError(t('deleteFailed'));
149
+ } finally {
150
+ setDeleting(false);
151
+ }
152
+ }
153
+
154
+ return (
155
+ <div className="space-y-3">
156
+ <ReviewEditor
157
+ productId={productId}
158
+ mode="edit"
159
+ initialRating={initial.rating}
160
+ initialBody={initial.body ?? ''}
161
+ />
162
+ <div className="flex items-center justify-between rounded-md border border-red-100 bg-red-50/50 p-3">
163
+ <p className="text-xs text-red-700">{t('startOver')}</p>
164
+ <button
165
+ type="button"
166
+ onClick={handleDelete}
167
+ disabled={deleting}
168
+ className="text-xs font-medium text-red-700 underline disabled:opacity-50"
169
+ >
170
+ {deleting ? t('deleting') : t('deleteReview')}
171
+ </button>
172
+ </div>
173
+ {deleteError && (
174
+ <p role="alert" className="text-sm text-red-700">
175
+ {deleteError}
176
+ </p>
177
+ )}
178
+ </div>
179
+ );
180
+ }
181
+
182
+ /**
183
+ * The actual form. Same shape for create and edit — only the API method
184
+ * and the heading differ. Optimistic UX: success state + page reload to
185
+ * let the server-rendered reviews list pick up the change.
186
+ */
187
+ function ReviewEditor({
188
+ productId,
189
+ mode,
190
+ initialRating,
191
+ initialBody,
192
+ }: {
193
+ productId: string;
194
+ mode: 'create' | 'edit';
195
+ initialRating: number;
196
+ initialBody: string;
197
+ }) {
198
+ const [rating, setRating] = useState(initialRating);
199
+ const t = useTranslations('reviews');
200
+ const [body, setBody] = useState(initialBody);
201
+ const [submitting, setSubmitting] = useState(false);
202
+ const [error, setError] = useState<string | null>(null);
203
+ const [success, setSuccess] = useState(false);
204
+
205
+ async function handleSubmit(event: React.FormEvent<HTMLFormElement>) {
206
+ event.preventDefault();
207
+ setError(null);
208
+ setSubmitting(true);
209
+ try {
210
+ const client = getClient();
211
+ const input = { rating, body: body.trim() || undefined };
212
+ if (mode === 'edit') {
213
+ await client.updateMyProductReview(productId, input);
214
+ } else {
215
+ await client.submitProductReview(productId, input);
216
+ }
217
+ setSuccess(true);
218
+ setTimeout(() => window.location.reload(), 1200);
219
+ } catch (err) {
220
+ const status = (err as { status?: number })?.status;
221
+ if (status === 409) {
222
+ setError(t('alreadySubmitted'));
223
+ } else if (status === 403) {
224
+ setError(t('onlyPurchasers'));
225
+ } else if (status === 429) {
226
+ setError(t('tooMany'));
227
+ } else {
228
+ setError(mode === 'edit' ? t('updateFailed') : t('submitFailed'));
229
+ }
230
+ } finally {
231
+ setSubmitting(false);
232
+ }
233
+ }
234
+
235
+ if (success) {
236
+ return (
237
+ <p className="rounded-md border border-emerald-200 bg-emerald-50 p-3 text-sm text-emerald-700">
238
+ {mode === 'edit' ? t('thanksUpdated') : t('thanksSubmitted')}
239
+ </p>
240
+ );
241
+ }
242
+
243
+ return (
244
+ <form onSubmit={handleSubmit} className="space-y-3 rounded-md border p-4">
245
+ <h3 className="font-medium">{mode === 'edit' ? t('editYourReview') : t('writeReview')}</h3>
246
+
247
+ <fieldset>
248
+ <legend className="mb-1 text-sm">{t('yourRating')}</legend>
249
+ <div className="inline-flex gap-1" role="radiogroup" aria-label={t('starRating')}>
250
+ {[1, 2, 3, 4, 5].map((n) => (
251
+ <button
252
+ key={n}
253
+ type="button"
254
+ role="radio"
255
+ aria-checked={rating === n}
256
+ onClick={() => setRating(n)}
257
+ className={n <= rating ? 'text-yellow-500' : 'text-gray-300'}
258
+ >
259
+ <Star className="h-6 w-6 fill-current" aria-hidden="true" />
260
+ </button>
261
+ ))}
262
+ </div>
263
+ </fieldset>
264
+
265
+ <Label className="block text-sm font-normal">
266
+ {t('yourReview')}{' '}
267
+ <span className="text-muted-foreground text-xs">({t('optionalField')})</span>
268
+ <Textarea
269
+ value={body}
270
+ onChange={(event) => setBody(event.target.value)}
271
+ maxLength={5000}
272
+ rows={4}
273
+ className="mt-1 rounded"
274
+ />
275
+ </Label>
276
+
277
+ {error && (
278
+ <p role="alert" className="text-sm text-red-700">
279
+ {error}
280
+ </p>
281
+ )}
282
+
283
+ <Button type="submit" disabled={submitting}>
284
+ {submitting
285
+ ? mode === 'edit'
286
+ ? t('saving')
287
+ : t('submittingBtn')
288
+ : mode === 'edit'
289
+ ? t('saveChanges')
290
+ : t('submitReview')}
291
+ </Button>
292
+ </form>
293
+ );
294
+ }