create-brainerce-store 1.43.3 → 1.44.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.43.3",
+      version: "1.44.0",
       description: "Scaffold a production-ready e-commerce storefront connected to Brainerce",
       bin: {
         "create-brainerce-store": "dist/index.js"
@@ -172,12 +172,13 @@ var ALLOWED_PACKAGE_MANAGERS = [
   "bun"
 ];
 var BRAINERCE_RUNTIME_DEPS = Object.freeze({
-  // 1.28 = first cut after the PriceList API removal + the FX-driven display
-  // pricing rework (Product.displayPrice / displayCurrency / displaySalePrice
-  // attached additively when getProducts is called with a regionId). Older
-  // 1.27 had PriceList/Resolved* surface that no longer exists on the
-  // backend, so scaffolded stores must pin >=1.28 to compile.
-  brainerce: "^1.28.0",
+  // 1.30 adds the storefront seam for geo-IP region resolution
+  // (getAutoRegion) + non-binding tax preview (estimateTax). 1.28 cut the
+  // PriceList API + introduced the FX display overlay
+  // (Product.displayPrice / displayCurrency / displaySalePrice attached
+  // additively when getProducts is called with a regionId). Scaffolded stores
+  // must pin >=1.30 to get the auto-region + tax-estimate methods.
+  brainerce: "^1.30.0",
   "isomorphic-dompurify": "^3.8.0"
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-brainerce-store",
-  "version": "1.43.3",
+  "version": "1.44.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

@@ -1,15 +1,19 @@
-# Brainerce Sales Channel — preferred env var name.
-NEXT_PUBLIC_BRAINERCE_SALES_CHANNEL_ID=<%= connectionId %>
-# Legacy alias kept for backwards compatibility — both are accepted by the SDK.
-# @deprecated will be removed when SDK 2.0 ships.
-NEXT_PUBLIC_BRAINERCE_CONNECTION_ID=<%= connectionId %>
-
-# Store info (pre-fetched during setup to avoid flash on first load)
-NEXT_PUBLIC_STORE_NAME=<%- storeNameEnv %>
-NEXT_PUBLIC_STORE_CURRENCY=<%- currencyEnv %>
-
-# Backend API URL (server-side only — used by BFF proxy and SSR, never exposed to browser)
-BRAINERCE_API_URL=<%- apiBaseUrlEnv %>
-
-# Public site URL — used for sitemap, robots.txt, and SEO metadata
-NEXT_PUBLIC_SITE_URL=http://localhost:3000
+# Brainerce Sales Channel — preferred env var name.
+NEXT_PUBLIC_BRAINERCE_SALES_CHANNEL_ID=<%= connectionId %>
+# Legacy alias kept for backwards compatibility — both are accepted by the SDK.
+# @deprecated will be removed when SDK 2.0 ships.
+NEXT_PUBLIC_BRAINERCE_CONNECTION_ID=<%= connectionId %>
+
+# Store info (pre-fetched during setup to avoid flash on first load)
+NEXT_PUBLIC_STORE_NAME=<%- storeNameEnv %>
+NEXT_PUBLIC_STORE_CURRENCY=<%- currencyEnv %>
+
+# Backend API URL (server-side only — used by BFF proxy and SSR, never exposed to browser)
+BRAINERCE_API_URL=<%- apiBaseUrlEnv %>
+
+# Public API origin for the AI chat widget (public, unauthenticated endpoints only).
+# The widget streams chat directly from the browser, so this one IS public.
+NEXT_PUBLIC_BRAINERCE_API_URL=<%- apiBaseUrlEnv %>
+
+# Public site URL — used for sitemap, robots.txt, and SEO metadata
+NEXT_PUBLIC_SITE_URL=http://localhost:3000

package/templates/nextjs/base/src/app/layout.tsx.ejs

@@ -1,195 +1,199 @@
-<% if (i18nEnabled) { %>
-import type { Metadata } from 'next';
-<%- fontImport %>
-import { StoreProvider } from '@/providers/store-provider';
-import { AnnouncementBar } from '@/components/content/announcement-bar';
-import { SiteHeader } from '@/components/content/site-header';
-import { SiteFooter } from '@/components/content/site-footer';
-import { getServerClient, fetchStoreInfo } from '@/lib/brainerce';
-import { getDirection, supportedLocales } from '@/i18n';
-import { getNonce } from '@/lib/nonce';
-import '../globals.css';
-
-<%- fontVariable %>
-
-const baseUrl = process.env.NEXT_PUBLIC_SITE_URL || 'https://example.com';
-
-export const metadata: Metadata = {
-  metadataBase: new URL(baseUrl),
-  title: {
-    default: <%- storeNameJs %>,
-    template: <%- titleTemplateJs %>,
-  },
-  description: <%- storeNameJs %>,
-  alternates: {
-    canonical: '/',
-  },
-  openGraph: {
-    siteName: <%- storeNameJs %>,
-    type: 'website',
-  },
-  robots: {
-    index: true,
-    follow: true,
-  },
-};
-
-const organizationJsonLd = {
-  '@context': 'https://schema.org',
-  '@type': 'Organization',
-  name: <%- storeNameJs %>,
-  url: baseUrl,
-};
-
-export function generateStaticParams() {
-  return supportedLocales.map((locale) => ({ locale }));
-}
-
-export default async function RootLayout({
-  children,
-  params,
-}: {
-  children: React.ReactNode;
-  params: Promise<{ locale: string }>;
-}) {
-  const { locale } = await params;
-  const dir = getDirection(locale);
-  const nonce = await getNonce();
-
-  // Merchant-driven layout chrome — fetched server-side. Each call falls back
-  // to null/[] on 404 so the layout never crashes when the merchant hasn't
-  // seeded a particular content type yet. New stores ship with default rows
-  // seeded by the backend (StoresService.seedDefaultContent).
-  const client = getServerClient(locale);
-  const [announcements, siteHeader, siteFooter, storeInfo] = await Promise.all([
-    client.content.announcement.list(locale).catch(() => []),
-    client.content.header.get('main', locale).catch(() => null),
-    client.content.footer.get('main', locale).catch(() => null),
-    // SSR-fetch store config so PriceDisplay / FreeShippingBar / upsell UI
-    // render with the real currency, feature flags, and i18n config at frame 0
-    // — without this, Googlebot sees USD/defaults baked into the HTML.
-    fetchStoreInfo(locale),
-  ]);
-
-  return (
-    <html lang={locale} dir={dir}>
-      <head>
-        <script
-          type="application/ld+json"
-          nonce={nonce}
-          suppressHydrationWarning
-          dangerouslySetInnerHTML={{
-            __html: JSON.stringify(organizationJsonLd)
-              .replace(/</g, '\\u003c')
-              .replace(/>/g, '\\u003e')
-              .replace(/&/g, '\\u0026'),
-          }}
-        />
-      </head>
-      <body className={font.className}>
-        <StoreProvider locale={locale} initialStoreInfo={storeInfo}>
-          <div className="min-h-screen flex flex-col">
-            <AnnouncementBar announcements={announcements} />
-            <SiteHeader header={siteHeader} storeName={<%- storeNameJs %>} />
-            <main className="flex-1">{children}</main>
-            <SiteFooter footer={siteFooter} storeName={<%- storeNameJs %>} />
-          </div>
-        </StoreProvider>
-      </body>
-    </html>
-  );
-}
-<% } else { %>
-import type { Metadata } from 'next';
-<%- fontImport %>
-import { StoreProvider } from '@/providers/store-provider';
-import { AnnouncementBar } from '@/components/content/announcement-bar';
-import { SiteHeader } from '@/components/content/site-header';
-import { SiteFooter } from '@/components/content/site-footer';
-import { getServerClient, fetchStoreInfo } from '@/lib/brainerce';
-import { getNonce } from '@/lib/nonce';
-import './globals.css';
-
-<%- fontVariable %>
-
-const baseUrl = process.env.NEXT_PUBLIC_SITE_URL || 'https://example.com';
-
-export const metadata: Metadata = {
-  metadataBase: new URL(baseUrl),
-  title: {
-    default: <%- storeNameJs %>,
-    template: <%- titleTemplateJs %>,
-  },
-  description: <%- storeNameJs %>,
-  alternates: {
-    canonical: '/',
-  },
-  openGraph: {
-    siteName: <%- storeNameJs %>,
-    locale: '<%= ogLocale %>',
-    type: 'website',
-  },
-  robots: {
-    index: true,
-    follow: true,
-  },
-};
-
-const organizationJsonLd = {
-  '@context': 'https://schema.org',
-  '@type': 'Organization',
-  name: <%- storeNameJs %>,
-  url: baseUrl,
-};
-
-export default async function RootLayout({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
-  const nonce = await getNonce();
-
-  // Merchant-driven layout chrome — fetched server-side. Each call falls back
-  // to null/[] on 404 so the layout never crashes when the merchant hasn't
-  // seeded a particular content type yet. New stores ship with default rows
-  // seeded by the backend (StoresService.seedDefaultContent).
-  const client = getServerClient();
-  const [announcements, siteHeader, siteFooter, storeInfo] = await Promise.all([
-    client.content.announcement.list().catch(() => []),
-    client.content.header.get('main').catch(() => null),
-    client.content.footer.get('main').catch(() => null),
-    // SSR-fetch store config so PriceDisplay / FreeShippingBar / upsell UI
-    // render with the real currency, feature flags, and i18n config at frame 0
-    // — without this, Googlebot sees USD/defaults baked into the HTML.
-    fetchStoreInfo(),
-  ]);
-
-  return (
-    <html lang="<%= language %>" dir="<%= direction %>">
-      <head>
-        <script
-          type="application/ld+json"
-          nonce={nonce}
-          suppressHydrationWarning
-          dangerouslySetInnerHTML={{
-            __html: JSON.stringify(organizationJsonLd)
-              .replace(/</g, '\\u003c')
-              .replace(/>/g, '\\u003e')
-              .replace(/&/g, '\\u0026'),
-          }}
-        />
-      </head>
-      <body className={font.className}>
-        <StoreProvider initialStoreInfo={storeInfo}>
-          <div className="min-h-screen flex flex-col">
-            <AnnouncementBar announcements={announcements} />
-            <SiteHeader header={siteHeader} storeName={<%- storeNameJs %>} />
-            <main className="flex-1">{children}</main>
-            <SiteFooter footer={siteFooter} storeName={<%- storeNameJs %>} />
-          </div>
-        </StoreProvider>
-      </body>
-    </html>
-  );
-}
-<% } %>
+<% if (i18nEnabled) { %>
+import type { Metadata } from 'next';
+<%- fontImport %>
+import { StoreProvider } from '@/providers/store-provider';
+import { AnnouncementBar } from '@/components/content/announcement-bar';
+import { SiteHeader } from '@/components/content/site-header';
+import { SiteFooter } from '@/components/content/site-footer';
+import { BrainerceBotWidget } from '@/components/brainerce-bot';
+import { getServerClient, fetchStoreInfo } from '@/lib/brainerce';
+import { getDirection, supportedLocales } from '@/i18n';
+import { getNonce } from '@/lib/nonce';
+import '../globals.css';
+
+<%- fontVariable %>
+
+const baseUrl = process.env.NEXT_PUBLIC_SITE_URL || 'https://example.com';
+
+export const metadata: Metadata = {
+  metadataBase: new URL(baseUrl),
+  title: {
+    default: <%- storeNameJs %>,
+    template: <%- titleTemplateJs %>,
+  },
+  description: <%- storeNameJs %>,
+  alternates: {
+    canonical: '/',
+  },
+  openGraph: {
+    siteName: <%- storeNameJs %>,
+    type: 'website',
+  },
+  robots: {
+    index: true,
+    follow: true,
+  },
+};
+
+const organizationJsonLd = {
+  '@context': 'https://schema.org',
+  '@type': 'Organization',
+  name: <%- storeNameJs %>,
+  url: baseUrl,
+};
+
+export function generateStaticParams() {
+  return supportedLocales.map((locale) => ({ locale }));
+}
+
+export default async function RootLayout({
+  children,
+  params,
+}: {
+  children: React.ReactNode;
+  params: Promise<{ locale: string }>;
+}) {
+  const { locale } = await params;
+  const dir = getDirection(locale);
+  const nonce = await getNonce();
+
+  // Merchant-driven layout chrome — fetched server-side. Each call falls back
+  // to null/[] on 404 so the layout never crashes when the merchant hasn't
+  // seeded a particular content type yet. New stores ship with default rows
+  // seeded by the backend (StoresService.seedDefaultContent).
+  const client = getServerClient(locale);
+  const [announcements, siteHeader, siteFooter, storeInfo] = await Promise.all([
+    client.content.announcement.list(locale).catch(() => []),
+    client.content.header.get('main', locale).catch(() => null),
+    client.content.footer.get('main', locale).catch(() => null),
+    // SSR-fetch store config so PriceDisplay / FreeShippingBar / upsell UI
+    // render with the real currency, feature flags, and i18n config at frame 0
+    // — without this, Googlebot sees USD/defaults baked into the HTML.
+    fetchStoreInfo(locale),
+  ]);
+
+  return (
+    <html lang={locale} dir={dir}>
+      <head>
+        <script
+          type="application/ld+json"
+          nonce={nonce}
+          suppressHydrationWarning
+          dangerouslySetInnerHTML={{
+            __html: JSON.stringify(organizationJsonLd)
+              .replace(/</g, '\\u003c')
+              .replace(/>/g, '\\u003e')
+              .replace(/&/g, '\\u0026'),
+          }}
+        />
+      </head>
+      <body className={font.className}>
+        <StoreProvider locale={locale} initialStoreInfo={storeInfo}>
+          <div className="min-h-screen flex flex-col">
+            <AnnouncementBar announcements={announcements} />
+            <SiteHeader header={siteHeader} storeName={<%- storeNameJs %>} />
+            <main className="flex-1">{children}</main>
+            <SiteFooter footer={siteFooter} storeName={<%- storeNameJs %>} />
+          </div>
+          <BrainerceBotWidget />
+        </StoreProvider>
+      </body>
+    </html>
+  );
+}
+<% } else { %>
+import type { Metadata } from 'next';
+<%- fontImport %>
+import { StoreProvider } from '@/providers/store-provider';
+import { AnnouncementBar } from '@/components/content/announcement-bar';
+import { SiteHeader } from '@/components/content/site-header';
+import { SiteFooter } from '@/components/content/site-footer';
+import { BrainerceBotWidget } from '@/components/brainerce-bot';
+import { getServerClient, fetchStoreInfo } from '@/lib/brainerce';
+import { getNonce } from '@/lib/nonce';
+import './globals.css';
+
+<%- fontVariable %>
+
+const baseUrl = process.env.NEXT_PUBLIC_SITE_URL || 'https://example.com';
+
+export const metadata: Metadata = {
+  metadataBase: new URL(baseUrl),
+  title: {
+    default: <%- storeNameJs %>,
+    template: <%- titleTemplateJs %>,
+  },
+  description: <%- storeNameJs %>,
+  alternates: {
+    canonical: '/',
+  },
+  openGraph: {
+    siteName: <%- storeNameJs %>,
+    locale: '<%= ogLocale %>',
+    type: 'website',
+  },
+  robots: {
+    index: true,
+    follow: true,
+  },
+};
+
+const organizationJsonLd = {
+  '@context': 'https://schema.org',
+  '@type': 'Organization',
+  name: <%- storeNameJs %>,
+  url: baseUrl,
+};
+
+export default async function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  const nonce = await getNonce();
+
+  // Merchant-driven layout chrome — fetched server-side. Each call falls back
+  // to null/[] on 404 so the layout never crashes when the merchant hasn't
+  // seeded a particular content type yet. New stores ship with default rows
+  // seeded by the backend (StoresService.seedDefaultContent).
+  const client = getServerClient();
+  const [announcements, siteHeader, siteFooter, storeInfo] = await Promise.all([
+    client.content.announcement.list().catch(() => []),
+    client.content.header.get('main').catch(() => null),
+    client.content.footer.get('main').catch(() => null),
+    // SSR-fetch store config so PriceDisplay / FreeShippingBar / upsell UI
+    // render with the real currency, feature flags, and i18n config at frame 0
+    // — without this, Googlebot sees USD/defaults baked into the HTML.
+    fetchStoreInfo(),
+  ]);
+
+  return (
+    <html lang="<%= language %>" dir="<%= direction %>">
+      <head>
+        <script
+          type="application/ld+json"
+          nonce={nonce}
+          suppressHydrationWarning
+          dangerouslySetInnerHTML={{
+            __html: JSON.stringify(organizationJsonLd)
+              .replace(/</g, '\\u003c')
+              .replace(/>/g, '\\u003e')
+              .replace(/&/g, '\\u0026'),
+          }}
+        />
+      </head>
+      <body className={font.className}>
+        <StoreProvider initialStoreInfo={storeInfo}>
+          <div className="min-h-screen flex flex-col">
+            <AnnouncementBar announcements={announcements} />
+            <SiteHeader header={siteHeader} storeName={<%- storeNameJs %>} />
+            <main className="flex-1">{children}</main>
+            <SiteFooter footer={siteFooter} storeName={<%- storeNameJs %>} />
+          </div>
+          <BrainerceBotWidget />
+        </StoreProvider>
+      </body>
+    </html>
+  );
+}
+<% } %>

package/templates/nextjs/base/src/components/brainerce-bot.tsx

@@ -0,0 +1,39 @@
+'use client';
+
+import { useEffect } from 'react';
+
+/**
+ * Mounts the Brainerce AI chat widget (the store's shopping assistant).
+ *
+ * Everything about the bot — name, avatar, colors, greeting, starter
+ * questions, capabilities, guardrails — is configured by the merchant in the
+ * Brainerce dashboard (Customers → Storefront Bot). This component renders
+ * nothing until the bot is switched Live there, so it is always safe to keep
+ * mounted.
+ */
+export function BrainerceBotWidget() {
+  useEffect(() => {
+    const connectionId =
+      process.env.NEXT_PUBLIC_BRAINERCE_SALES_CHANNEL_ID ||
+      process.env.NEXT_PUBLIC_BRAINERCE_CONNECTION_ID;
+    if (!connectionId) return;
+
+    let bot: { destroy(): void } | null = null;
+    let cancelled = false;
+    void import('brainerce/bot').then(({ BrainerceBot }) =>
+      BrainerceBot.mount({
+        connectionId,
+        baseUrl: process.env.NEXT_PUBLIC_BRAINERCE_API_URL || undefined,
+      }).then((mounted) => {
+        if (cancelled) mounted?.destroy();
+        else bot = mounted;
+      }),
+    );
+    return () => {
+      cancelled = true;
+      bot?.destroy();
+    };
+  }, []);
+
+  return null;
+}