create-brainerce-store 1.67.0 → 1.71.0

package/dist/index.js

@@ -31,7 +31,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "create-brainerce-store",
-      version: "1.67.0",
+      version: "1.71.0",
       description: "Scaffold a production-ready e-commerce storefront connected to Brainerce",
       bin: {
         "create-brainerce-store": "dist/index.js"
@@ -206,7 +206,27 @@ var BRAINERCE_RUNTIME_DEPS = Object.freeze({
   // dashboard's "orders from ChatGPT/Google/…" reporting. No template code
   // depends on it (fully automatic), but scaffolds should ship the SDK that
   // actually reports attribution.
-  brainerce: "^1.58.0",
+  // 1.60 adds marketing.subscribe() — confirmed opt-in for a storefront
+  // newsletter signup. The scaffolded footer's signup form calls it, so an
+  // older SDK fails type-check at scaffold time.
+  // 1.61 adds stockAlerts.subscribe() plus two fields the scaffolded product
+  // page reads to decide whether to offer it at all —
+  // StoreInfo.stockAlertsEnabled (the merchant's switch) and
+  // InventoryInfo.backorderMode (an alert on a backorderable item is a
+  // no-op). All three are referenced by the generated back-in-stock form, so
+  // an older SDK fails type-check at scaffold time.
+  // 1.62 adds the availability clock. The scaffolded DATE/DATETIME checkout
+  // pickers pass `{ timezone }` as a third argument to isCalendarDateAllowed()/
+  // computeAvailableSlots()/getBusinessHoursForDate() — without it the
+  // leadTimeMinutes/cutoffTime/maxDaysAhead bounds are skipped and the picker
+  // offers days the API then rejects — and an older SDK types those helpers
+  // with two parameters, so the scaffold fails type-check outright.
+  // 1.63 adds customer photos on reviews. The scaffolded review form calls
+  // uploadReviewPhoto() and passes `imageKeys` on submit, reads `photos` off
+  // getMyProductReview() to decide whether to render a picker at all, and the
+  // reviews list renders `review.images`. None of those exist on an older SDK,
+  // so the scaffold fails type-check outright.
+  brainerce: "^1.63.0",
   "isomorphic-dompurify": "^3.8.0"
 });
 

package/messages/en.json

@@ -38,7 +38,28 @@
     "allRightsReserved": "All rights reserved.",
     "store": "Store",
     "save": "Save",
-    "cancel": "Cancel"
+    "cancel": "Cancel",
+    "birthday": "Birthday",
+    "birthdayMonth": "Month",
+    "birthdayDay": "Day",
+    "birthdayGiftNote": "Add your birthday and a gift arrives by email on the day.",
+    "birthdayIncomplete": "Choose both a month and a day, or leave both empty.",
+    "birthdayRequired": "Choose your birthday month and day to continue.",
+    "birthdayPlaceholder": "Choose your birthday",
+    "birthdayClear": "Clear",
+    "birthdayDisplay": "{month} {day}",
+    "monthJanuary": "January",
+    "monthFebruary": "February",
+    "monthMarch": "March",
+    "monthApril": "April",
+    "monthMay": "May",
+    "monthJune": "June",
+    "monthJuly": "July",
+    "monthAugust": "August",
+    "monthSeptember": "September",
+    "monthOctober": "October",
+    "monthNovember": "November",
+    "monthDecember": "December"
   },
   "nav": {
     "products": "Products",
@@ -130,7 +151,13 @@
     "saving": "Saving…",
     "submittingBtn": "Submitting…",
     "saveChanges": "Save changes",
-    "submitReview": "Submit review"
+    "submitReview": "Submit review",
+    "addPhotos": "Add photos",
+    "removePhoto": "Remove photo",
+    "photoUploading": "Uploading…",
+    "photoTooLarge": "That photo is too large. Please pick a smaller one.",
+    "photoUploadFailed": "Could not upload that photo. Please try another.",
+    "photosNeedApproval": "Photos are checked before they appear, so yours may not show right away."
   },
   "customization": {
     "title": "Personalize this product",
@@ -258,6 +285,8 @@
     "customFieldsDateNextMonth": "Next month",
     "customFieldsTimeLabel": "Time",
     "customFieldsTimeClosed": "No delivery times are available on this date.",
+    "customFieldsTimeNoneLeft": "Every time on this date has already passed. Please pick a later date.",
+    "customFieldsTimeTo": "to",
     "changeOptions": "Change options",
     "surcharges": "Additional charges"
   },
@@ -496,6 +525,27 @@
     "genericError": "Something went wrong. Please try again.",
     "fieldRequired": "{label} is required"
   },
+  "backInStock": {
+    "title": "Email me when it's back",
+    "subtitle": "One message about this item, nothing else. You can stop it any time.",
+    "placeholder": "your@email.com",
+    "submit": "Notify me",
+    "submitting": "Sending...",
+    "doneTitle": "We'll email you when it's back",
+    "doneBody": "Stock is limited, so it may go quickly once it returns.",
+    "genericError": "Something went wrong. Please try again."
+  },
+  "newsletter": {
+    "title": "Join our newsletter",
+    "subtitle": "Offers and new arrivals, straight to your inbox.",
+    "placeholder": "your@email.com",
+    "submit": "Subscribe",
+    "submitting": "Sending...",
+    "checkEmailTitle": "Almost there — check your email",
+    "checkEmailBody": "We've sent you a link to confirm. Look in your spam folder too; you won't get another copy for 24 hours.",
+    "discountCode": "Your code: {code}",
+    "genericError": "Something went wrong. Please try again."
+  },
   "content": {
     "faqTitle": "Frequently Asked Questions",
     "faqEmptyTitle": "FAQ coming soon",

package/messages/he.json

@@ -38,7 +38,28 @@
     "allRightsReserved": "כל הזכויות שמורות.",
     "store": "חנות",
     "save": "שמירה",
-    "cancel": "ביטול"
+    "cancel": "ביטול",
+    "birthday": "יום הולדת",
+    "birthdayMonth": "חודש",
+    "birthdayDay": "יום",
+    "birthdayGiftNote": "הוסיפו את יום ההולדת ותקבלו מתנה במייל ביום עצמו.",
+    "birthdayIncomplete": "בחרו גם חודש וגם יום, או השאירו את שניהם ריקים.",
+    "birthdayRequired": "בחרו את חודש ויום ההולדת כדי להמשיך.",
+    "birthdayPlaceholder": "בחרו את יום ההולדת",
+    "birthdayClear": "ניקוי",
+    "birthdayDisplay": "{day} ב{month}",
+    "monthJanuary": "ינואר",
+    "monthFebruary": "פברואר",
+    "monthMarch": "מרץ",
+    "monthApril": "אפריל",
+    "monthMay": "מאי",
+    "monthJune": "יוני",
+    "monthJuly": "יולי",
+    "monthAugust": "אוגוסט",
+    "monthSeptember": "ספטמבר",
+    "monthOctober": "אוקטובר",
+    "monthNovember": "נובמבר",
+    "monthDecember": "דצמבר"
   },
   "nav": {
     "products": "מוצרים",
@@ -130,7 +151,13 @@
     "saving": "שומר…",
     "submittingBtn": "שולח…",
     "saveChanges": "שמירת שינויים",
-    "submitReview": "שליחת ביקורת"
+    "submitReview": "שליחת ביקורת",
+    "addPhotos": "הוספת תמונות",
+    "removePhoto": "הסרת תמונה",
+    "photoUploading": "מעלה...",
+    "photoTooLarge": "התמונה הזו גדולה מדי. בחרו תמונה קטנה יותר.",
+    "photoUploadFailed": "לא הצלחנו להעלות את התמונה. נסו תמונה אחרת.",
+    "photosNeedApproval": "התמונות נבדקות לפני שהן מופיעות, כך שייתכן שהתמונה שלכם לא תוצג מיד."
   },
   "customization": {
     "title": "התאמה אישית של המוצר",
@@ -258,6 +285,8 @@
     "customFieldsDateNextMonth": "חודש הבא",
     "customFieldsTimeLabel": "שעה",
     "customFieldsTimeClosed": "אין שעות משלוח זמינות בתאריך הזה.",
+    "customFieldsTimeNoneLeft": "כל השעות בתאריך הזה כבר עברו. בחרו תאריך מאוחר יותר.",
+    "customFieldsTimeTo": "עד",
     "changeOptions": "שנה אפשרויות",
     "surcharges": "תוספות"
   },
@@ -496,6 +525,27 @@
     "genericError": "משהו השתבש. אנא נסה שוב.",
     "fieldRequired": "השדה {label} הוא חובה"
   },
+  "backInStock": {
+    "title": "עדכנו אותי כשחוזר למלאי",
+    "subtitle": "הודעה אחת על הפריט הזה, ותו לא. אפשר לבטל בכל רגע.",
+    "placeholder": "your@email.com",
+    "submit": "עדכנו אותי",
+    "submitting": "שולח...",
+    "doneTitle": "נעדכן אותך כשהפריט יחזור",
+    "doneBody": "הכמות מוגבלת, אז ייתכן שהפריט ייגמר מהר.",
+    "genericError": "משהו השתבש. אפשר לנסות שוב."
+  },
+  "newsletter": {
+    "title": "הצטרפו לניוזלטר",
+    "subtitle": "מבצעים ומוצרים חדשים, ישירות למייל.",
+    "placeholder": "your@email.com",
+    "submit": "הרשמה",
+    "submitting": "שולח...",
+    "checkEmailTitle": "כמעט סיימנו — בדקו את המייל",
+    "checkEmailBody": "שלחנו לכם קישור לאישור. בדקו גם בתיקיית הספאם; עותק נוסף לא יישלח ב-24 השעות הקרובות.",
+    "discountCode": "הקוד שלכם: {code}",
+    "genericError": "משהו השתבש. נסו שוב."
+  },
   "content": {
     "faqTitle": "שאלות נפוצות",
     "faqEmptyTitle": "השאלות הנפוצות בדרך",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-brainerce-store",
-  "version": "1.67.0",
+  "version": "1.71.0",
   "description": "Scaffold a production-ready e-commerce storefront connected to Brainerce",
   "bin": {
     "create-brainerce-store": "dist/index.js"

package/templates/nextjs/base/.env.local.ejs

@@ -38,6 +38,13 @@ NEXT_PUBLIC_BRAINERCE_API_URL=<%- apiBaseUrlEnv %>
 # Set it in your hosting provider's environment variables, not in this file:
 # .env.local is gitignored and never travels with a deploy.
 # `NEXT_PUBLIC_SITE_URL` is still read as a backwards-compatible alias.
+#
+# On some hosts SITE_URL is NOT optional. Platforms whose proxy forwards
+# requests to the app as `Host: localhost:<port>` (OpenAI Sites /
+# *.chatgpt.site, among others) hide the real hostname from the server, so
+# nothing can be resolved from the request. Set SITE_URL there, or server-side
+# API calls send `Origin: http://localhost:3000` and a sales channel with a
+# configured Domain rejects them with 403.
 
 # Optional: floating WhatsApp contact button (used by some designs, e.g.
 # passepartout). Digits only, international format without "+"

package/templates/nextjs/base/AGENTS.md.ejs

@@ -81,6 +81,13 @@ development and on any host with nothing configured.
   `getRequestOrigin()` (for the `Origin` header sent to Brainerce). Hand-rolled
   versions have shipped `http://` on HTTPS hosts and internal container
   hostnames.
+- **Some hosts hide the real hostname from the app.** Platforms whose proxy
+  forwards requests as `Host: localhost:<port>` with no `x-forwarded-host`
+  (OpenAI Sites / `*.chatgpt.site` does this) leave the resolver blind — the
+  request looks like it arrived on localhost. On such platforms `SITE_URL` is
+  not optional: set it, and the resolver prefers it over any internal host it
+  sees. Without it, server-side API calls send `Origin: http://localhost:3000`
+  and a channel with a configured Domain rejects them with 403.
 - **When the merchant gives you a real domain**, set `SITE_URL` in the hosting
   provider's environment variables — not in `.env.local`, which is gitignored
   and never travels with a deploy.

package/templates/nextjs/base/CLAUDE.md.ejs

@@ -92,6 +92,13 @@ development and on any host with nothing configured.
   `getRequestOrigin()` (for the `Origin` header sent to Brainerce). Hand-rolled
   versions have shipped `http://` on HTTPS hosts and internal container
   hostnames.
+- **Some hosts hide the real hostname from the app.** Platforms whose proxy
+  forwards requests as `Host: localhost:<port>` with no `x-forwarded-host`
+  (OpenAI Sites / `*.chatgpt.site` does this) leave the resolver blind — the
+  request looks like it arrived on localhost. On such platforms `SITE_URL` is
+  not optional: set it, and the resolver prefers it over any internal host it
+  sees. Without it, server-side API calls send `Origin: http://localhost:3000`
+  and a channel with a configured Domain rejects them with 403.
 - **When the merchant gives you a real domain**, set `SITE_URL` in the hosting
   provider's environment variables — not in `.env.local`, which is gitignored
   and never travels with a deploy.

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

@@ -83,7 +83,10 @@ export default async function BlogPostPage({ params }: PageProps) {
   const slug = decodeSlug(rawSlug);
   const client = await getServerClient(locale);
   const [post, storeInfo] = await Promise.all([
-    client.blog.getPost(slug).catch(() => null),
+    // getPost returns null only on a genuine 404; any other API failure (a
+    // 403 from the channel's origin check, a network error) throws and
+    // surfaces as the error it is instead of masquerading as a missing post.
+    client.blog.getPost(slug),
     client.getStoreInfo().catch(() => null),
   ]);
   if (!post) {
@@ -220,7 +223,10 @@ export default async function BlogPostPage({ params }: PageProps) {
   const slug = decodeSlug(rawSlug);
   const client = await getServerClient();
   const [post, storeInfo] = await Promise.all([
-    client.blog.getPost(slug).catch(() => null),
+    // getPost returns null only on a genuine 404; any other API failure (a
+    // 403 from the channel's origin check, a network error) throws and
+    // surfaces as the error it is instead of masquerading as a missing post.
+    client.blog.getPost(slug),
     client.getStoreInfo().catch(() => null),
   ]);
   if (!post) {

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

@@ -1,6 +1,6 @@
 import type { Metadata } from 'next';
 import { notFound } from 'next/navigation';
-import type { Product } from 'brainerce';
+import { BrainerceError } from 'brainerce';
 import { getServerClient, fetchStoreInfo } from '@/core/lib/brainerce.server';
 import { buildMetaDescription } from '@/core/lib/seo';
 import { sanitizeHtml } from '@/core/lib/sanitize';
@@ -77,8 +77,13 @@ export async function generateMetadata({ params }: Props): Promise<Metadata> {
         images: category.image ? [category.image] : [],
       },
     };
-  } catch {
-    return { title: 'Category not found' };
+  } catch (err) {
+    if (err instanceof BrainerceError && err.statusCode === 404) {
+      return { title: 'Category not found' };
+    }
+    // Anything else (channel origin rejection, network failure) hits the page
+    // render below too and surfaces there — don't stamp a misleading title.
+    return {};
   }
 }
 
@@ -87,14 +92,18 @@ export default async function CategoryPage({ params }: Props) {
   const slug = decodeSlug(rawSlug);
   const client = await getServerClient(locale);
 
-  const category = await client.getCategoryBySlug(slug).catch(() => null);
+  // Only a genuine 404 becomes a storefront 404; a 403 from the channel's
+  // origin check or a network failure must surface as the error it is, not
+  // masquerade as a missing category (or an empty one).
+  const category = await client.getCategoryBySlug(slug).catch((err: unknown) => {
+    if (err instanceof BrainerceError && err.statusCode === 404) return null;
+    throw err;
+  });
   if (!category) notFound();
 
   // The listing endpoint owns pagination/FX/publish gating — reuse it rather
   // than duplicating a product query here.
-  const { data: products } = await client
-    .getProducts({ categories: [category.id], limit: 48 })
-    .catch(() => ({ data: [] as Product[] }));
+  const { data: products } = await client.getProducts({ categories: [category.id], limit: 48 });
 
   const baseUrl = await getCanonicalSiteUrl();
   const url = `${baseUrl}/category/${category.slug || slug}`;