@rovela-ai/sdk 0.19.4 → 0.19.6

package/templates/store-template/app/products/page.tsx

@@ -0,0 +1,102 @@
+'use client'
+
+/**
+ * Products Listing Page
+ *
+ * Uses SDK components for product display:
+ * - ProductGrid: Responsive grid of product cards
+ * - ProductSearch: Search input with debouncing
+ * - ProductSort: Sort dropdown
+ * - useProducts: Data fetching hook
+ */
+
+import { useState } from 'react'
+import {
+  ProductGrid,
+  ProductSearch,
+  ProductSort,
+  useProducts,
+} from '@rovela-ai/sdk/products'
+import type { SortOption } from '@rovela-ai/sdk/products'
+import { useT } from '@rovela-ai/sdk/core'
+
+export default function ProductsPage() {
+  const t = useT()
+  const [search, setSearch] = useState('')
+  const [sort, setSort] = useState<SortOption>('newest')
+
+  const {
+    products,
+    isLoading,
+    error,
+    hasMore,
+    loadMore,
+  } = useProducts({
+    search,
+    sort,
+    limit: 12,
+  })
+
+  return (
+    <div className="container mx-auto px-4 sm:px-6 lg:px-8 py-8">
+      {/* Page Header */}
+      <div className="mb-8">
+        <h1 className="text-3xl font-bold font-heading">{t('listing.title')}</h1>
+        <p className="mt-2 text-muted-foreground">
+          {t('listing.subtitle')}
+        </p>
+      </div>
+
+      {/* Filters Bar */}
+      <div className="flex flex-col sm:flex-row gap-4 mb-8">
+        <div className="flex-1 max-w-md">
+          <ProductSearch
+            value={search}
+            onSearch={setSearch}
+          />
+        </div>
+        <ProductSort
+          value={sort}
+          onChange={setSort}
+        />
+      </div>
+
+      {/* One message per state: on error, ONLY the error renders (the grid
+          is skipped — its built-in empty state would double the message);
+          when empty, the page's copy rides the grid's emptyState slot. */}
+      {error ? (
+        <div className="text-center py-12">
+          <p className="text-destructive">{t('listing.loadFailed')}</p>
+        </div>
+      ) : (
+        <ProductGrid
+          products={products}
+          isLoading={isLoading}
+          columns={{ sm: 2, md: 3, lg: 4 }}
+          cardProps={{
+            showQuickAdd: true,
+          }}
+          emptyState={
+            <div className="text-center py-12">
+              <p className="text-muted-foreground">
+                {search ? t('listing.noneMatching') : t('listing.noneAvailable')}
+              </p>
+            </div>
+          }
+        />
+      )}
+
+      {/* Load More */}
+      {hasMore && !isLoading && !error && (
+        <div className="mt-12 text-center">
+          <button
+            onClick={loadMore}
+            className="rounded-md bg-primary px-8 py-3 text-sm font-semibold text-primary-foreground shadow-sm hover:bg-primary/90 transition-colors"
+          >
+            {t('listing.loadMore')}
+          </button>
+        </div>
+      )}
+    </div>
+  )
+}

package/templates/store-template/app/robots.ts

@@ -0,0 +1,25 @@
+import type { MetadataRoute } from 'next'
+
+const STORE_URL = process.env.NEXT_PUBLIC_APP_URL || ''
+
+/**
+ * Storefront robots rules.
+ *
+ * Merchant stores default to MAXIMUM discoverability for every search + AI
+ * shopping crawler (Google, Bing, ChatGPT, Perplexity, Google AI Mode, etc.) —
+ * AI shopping visibility is the goal. Only private / transactional routes are
+ * disallowed.
+ */
+export default function robots(): MetadataRoute.Robots {
+  const base = STORE_URL.replace(/\/$/, '')
+  return {
+    rules: [
+      {
+        userAgent: '*',
+        allow: '/',
+        disallow: ['/admin', '/api/', '/account', '/cart', '/checkout'],
+      },
+    ],
+    ...(base && { sitemap: `${base}/sitemap.xml` }),
+  }
+}

package/templates/store-template/app/sitemap.ts

@@ -0,0 +1,76 @@
+import type { MetadataRoute } from 'next'
+import { findProducts, findSettings } from '@rovela-ai/sdk/core/server'
+import { resolveStoreLocaleConfig } from '@rovela-ai/sdk/core'
+
+// ISR: the sitemap reads live data (products + locale config) but Next
+// statically caches metadata routes at build — hourly revalidation keeps
+// new products and language toggles from being frozen until the next deploy.
+export const revalidate = 3600
+
+const STORE_URL = process.env.NEXT_PUBLIC_APP_URL || ''
+
+/**
+ * Storefront sitemap: static public pages + every active product detail page.
+ * Gives search + AI shopping crawlers a discovery path to the catalog.
+ * Transactional / private routes (cart, checkout, account, admin) are omitted
+ * by design — they mirror the robots.ts disallow list.
+ */
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+  const base = STORE_URL.replace(/\/$/, '')
+  if (!base) return []
+
+  let products: Awaited<ReturnType<typeof findProducts>> = []
+  try {
+    products = await findProducts({ status: 'active', limit: 5000 })
+  } catch {
+    products = []
+  }
+
+  // hreflang via sitemap (i18n core): when the store serves more than one
+  // locale, every URL declares its alternates so crawlers index /fr pages as
+  // translations, not duplicates. Sitemap-level hreflang is fully supported
+  // by Google and avoids fragile per-page head injection.
+  let localeAlternates: ((path: string) => MetadataRoute.Sitemap[number]['alternates']) | null = null
+  try {
+    const settings = await findSettings()
+    const { defaultLocale, enabledLocales } = resolveStoreLocaleConfig(settings)
+    if (enabledLocales.length > 1) {
+      localeAlternates = (path: string) => ({
+        languages: Object.fromEntries(
+          enabledLocales.map((l) => [
+            l,
+            l === defaultLocale ? `${base}${path}` : `${base}/${l}${path === '/' ? '' : path}`,
+          ])
+        ),
+      })
+    }
+  } catch {
+    // settings unreadable → single-locale sitemap (safe default)
+  }
+
+  const staticDefs: Array<{ path: string; changeFrequency: 'weekly' | 'daily' | 'monthly' | 'yearly'; priority: number }> = [
+    { path: '/', changeFrequency: 'weekly', priority: 1.0 },
+    { path: '/products', changeFrequency: 'daily', priority: 0.9 },
+    { path: '/faq', changeFrequency: 'monthly', priority: 0.5 },
+    { path: '/contact', changeFrequency: 'monthly', priority: 0.4 },
+    { path: '/privacy', changeFrequency: 'yearly', priority: 0.2 },
+    { path: '/terms', changeFrequency: 'yearly', priority: 0.2 },
+  ]
+
+  const staticPages: MetadataRoute.Sitemap = staticDefs.map((d) => ({
+    url: `${base}${d.path === '/' ? '/' : d.path}`,
+    changeFrequency: d.changeFrequency,
+    priority: d.priority,
+    ...(localeAlternates && { alternates: localeAlternates(d.path) }),
+  }))
+
+  const productPages: MetadataRoute.Sitemap = products.map((p) => ({
+    url: `${base}/products/${p.slug}`,
+    lastModified: p.updatedAt ?? undefined,
+    changeFrequency: 'weekly',
+    priority: 0.8,
+    ...(localeAlternates && { alternates: localeAlternates(`/products/${p.slug}`) }),
+  }))
+
+  return [...staticPages, ...productPages]
+}

package/templates/store-template/app/terms/page.tsx

@@ -0,0 +1,313 @@
+import type { Metadata } from 'next'
+import { LocaleLink as Link } from '@rovela-ai/sdk/core'
+import { getBlueprint, localizedAlternates, findSettings } from '@rovela-ai/sdk/core/server'
+
+/**
+ * Terms of Service Page
+ *
+ * Static terms of service page with standard e-commerce sections.
+ * Store name is pulled from blueprint for personalization.
+ */
+
+// =============================================================================
+// Metadata
+// =============================================================================
+
+export async function generateMetadata(): Promise<Metadata> {
+  let storeName = 'Our Store'
+  try {
+    const blueprint = getBlueprint()
+    storeName = blueprint?.store?.name || process.env.STORE_NAME || storeName
+  } catch {
+    // Blueprint might not exist
+  }
+
+  return {
+    title: 'Terms of Service',
+    description: `Terms of Service for ${storeName}. Read our terms and conditions for using our website and services.`,
+    alternates: await localizedAlternates('/terms'),
+  }
+}
+
+// =============================================================================
+// Page Component
+// =============================================================================
+
+export default async function TermsPage() {
+  // Get store name for display — LIVE settings first (store_settings is what
+  // the merchant edits in /admin; blueprint + env are build-time fallbacks
+  // that go stale after a rename). Fail-open on DB errors.
+  let storeName = 'Our Store'
+  let supportEmail = ''
+  const liveSettings = await findSettings().catch(() => null)
+
+  try {
+    const blueprint = getBlueprint()
+    storeName =
+      liveSettings?.storeName || blueprint?.store?.name || process.env.STORE_NAME || storeName
+  } catch {
+    storeName = liveSettings?.storeName || process.env.STORE_NAME || storeName
+  }
+
+  // Public contact email = the merchant's own address only. NEVER the platform
+  // transactional sender (RESEND_FROM_EMAIL): surfacing that put
+  // "contact@rovela.ai" on storefront legal pages and read as a template
+  // artifact. Falls back to support@<your-domain> derived from the live host;
+  // if only a *.rovela.app / *.vercel.app / localhost host is available it stays
+  // empty and the email line is hidden (the contact-page link still renders).
+  const storeHost = (process.env.NEXT_PUBLIC_APP_URL || '')
+    .replace(/^https?:\/\//, '')
+    .replace(/\/.*$/, '')
+    .trim()
+  const hasOwnDomain =
+    !!storeHost &&
+    !storeHost.endsWith('rovela.app') &&
+    !storeHost.endsWith('vercel.app') &&
+    !storeHost.startsWith('localhost')
+  // Live store email first — this is the address the merchant actually set
+  // (emails, contact page and JSON-LD already read it); SUPPORT_EMAIL env is
+  // the build-time fallback, support@<domain> the last resort.
+  supportEmail =
+    liveSettings?.storeEmail?.trim() ||
+    process.env.SUPPORT_EMAIL?.trim() ||
+    (hasOwnDomain ? `support@${storeHost}` : '')
+
+  return (
+    <div className="container mx-auto px-4 sm:px-6 lg:px-8 py-16">
+      <div className="max-w-3xl mx-auto">
+        {/* Header */}
+        <div className="mb-12">
+          <h1 className="text-3xl font-bold font-heading">Terms of Service</h1>
+        </div>
+
+        {/* Content */}
+        <div className="prose prose-neutral dark:prose-invert max-w-none">
+          {/* Introduction */}
+          <section className="mb-10">
+            <p className="text-muted-foreground leading-relaxed">
+              Welcome to {storeName}. By accessing or using our website, you agree to be bound
+              by these Terms of Service. Please read them carefully before making any purchases
+              or using our services.
+            </p>
+          </section>
+
+          {/* Acceptance of Terms */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              1. Acceptance of Terms
+            </h2>
+            <p className="text-muted-foreground">
+              By accessing and using this website, you accept and agree to be bound by these
+              Terms of Service and our Privacy Policy. If you do not agree to these terms,
+              please do not use our website or services.
+            </p>
+          </section>
+
+          {/* Use of Website */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              2. Use of Website
+            </h2>
+            <p className="text-muted-foreground mb-4">
+              You agree to use this website only for lawful purposes and in accordance with
+              these Terms. You agree not to:
+            </p>
+            <ul className="list-disc pl-6 space-y-2 text-muted-foreground">
+              <li>Use the website in any way that violates applicable laws or regulations</li>
+              <li>Attempt to interfere with the proper functioning of the website</li>
+              <li>Use automated systems or software to extract data from the website</li>
+              <li>Impersonate any person or entity or misrepresent your affiliation</li>
+              <li>Transmit any viruses, malware, or other harmful code</li>
+            </ul>
+          </section>
+
+          {/* Account Registration */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              3. Account Registration
+            </h2>
+            <p className="text-muted-foreground">
+              If you create an account with us, you are responsible for maintaining the
+              confidentiality of your account credentials and for all activities that occur
+              under your account. You must provide accurate and complete information when
+              creating an account. You agree to notify us immediately of any unauthorized
+              use of your account.
+            </p>
+          </section>
+
+          {/* Products and Pricing */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              4. Products and Pricing
+            </h2>
+            <p className="text-muted-foreground mb-4">
+              We strive to provide accurate product descriptions and pricing. However:
+            </p>
+            <ul className="list-disc pl-6 space-y-2 text-muted-foreground">
+              <li>Product images are for illustration purposes and may vary slightly from actual products</li>
+              <li>We reserve the right to correct pricing errors</li>
+              <li>Prices are subject to change without notice</li>
+              <li>Availability of products is not guaranteed and may change</li>
+            </ul>
+          </section>
+
+          {/* Orders and Payment */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              5. Orders and Payment
+            </h2>
+            <p className="text-muted-foreground mb-4">
+              When you place an order:
+            </p>
+            <ul className="list-disc pl-6 space-y-2 text-muted-foreground">
+              <li>You are making an offer to purchase products at the listed price</li>
+              <li>We reserve the right to accept or decline any order</li>
+              <li>Payment must be made at the time of purchase</li>
+              <li>All payments are processed securely through our payment provider</li>
+              <li>You are responsible for any applicable taxes and shipping fees</li>
+            </ul>
+          </section>
+
+          {/* Shipping and Delivery */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              6. Shipping and Delivery
+            </h2>
+            <p className="text-muted-foreground">
+              Shipping times and costs are estimates and may vary based on your location and
+              the shipping method selected. We are not responsible for delays caused by
+              shipping carriers or customs processing. Risk of loss and title for products
+              pass to you upon delivery to the carrier.
+            </p>
+          </section>
+
+          {/* Returns and Refunds */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              7. Returns and Refunds
+            </h2>
+            <p className="text-muted-foreground">
+              We want you to be satisfied with your purchase. If you are not happy with your
+              order, please contact us within 30 days of delivery. Return eligibility depends
+              on the product condition and type. Refunds will be processed to the original
+              payment method within 5-10 business days after we receive the returned item.
+            </p>
+          </section>
+
+          {/* Intellectual Property */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              8. Intellectual Property
+            </h2>
+            <p className="text-muted-foreground">
+              All content on this website, including text, graphics, logos, images, and software,
+              is the property of {storeName} or its content suppliers and is protected by
+              intellectual property laws. You may not use, reproduce, or distribute any content
+              without our prior written permission.
+            </p>
+          </section>
+
+          {/* Limitation of Liability */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              9. Limitation of Liability
+            </h2>
+            <p className="text-muted-foreground">
+              To the fullest extent permitted by law, {storeName} shall not be liable for any
+              indirect, incidental, special, consequential, or punitive damages arising from
+              your use of the website or purchase of products. Our total liability shall not
+              exceed the amount you paid for the products in question.
+            </p>
+          </section>
+
+          {/* Disclaimer of Warranties */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              10. Disclaimer of Warranties
+            </h2>
+            <p className="text-muted-foreground">
+              This website and all products are provided &quot;as is&quot; without warranties of any kind,
+              either express or implied. We do not warrant that the website will be
+              uninterrupted, error-free, or free of viruses or other harmful components.
+            </p>
+          </section>
+
+          {/* Indemnification */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              11. Indemnification
+            </h2>
+            <p className="text-muted-foreground">
+              You agree to indemnify and hold harmless {storeName} and its affiliates, officers,
+              directors, employees, and agents from any claims, damages, losses, or expenses
+              arising from your use of the website or violation of these Terms.
+            </p>
+          </section>
+
+          {/* Governing Law */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              12. Governing Law
+            </h2>
+            <p className="text-muted-foreground">
+              These Terms of Service shall be governed by and construed in accordance with
+              applicable laws, without regard to conflict of law principles. Any disputes
+              arising from these terms shall be resolved through binding arbitration or in
+              the courts of competent jurisdiction.
+            </p>
+          </section>
+
+          {/* Changes to Terms */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              13. Changes to Terms
+            </h2>
+            <p className="text-muted-foreground">
+              We reserve the right to modify these Terms of Service at any time. Changes will
+              be effective immediately upon posting on this page. Your continued use of the
+              website after any changes constitutes acceptance of the new terms.
+            </p>
+          </section>
+
+          {/* Contact Information */}
+          <section className="mb-10">
+            <h2 className="text-xl font-semibold font-heading mb-4">
+              14. Contact Information
+            </h2>
+            <p className="text-muted-foreground">
+              If you have any questions about these Terms of Service, please
+              {supportEmail ? (
+                <>
+                  {' '}contact us at{' '}
+                  <a
+                    href={`mailto:${supportEmail}`}
+                    className="text-primary hover:underline"
+                  >
+                    {supportEmail}
+                  </a>{' '}
+                  or visit our{' '}
+                </>
+              ) : (
+                <>{' '}reach us through our{' '}</>
+              )}
+              <Link href="/contact" className="text-primary hover:underline">
+                contact page
+              </Link>
+              .
+            </p>
+          </section>
+        </div>
+
+        {/* Back to Home */}
+        <div className="mt-12 pt-8 border-t">
+          <Link
+            href="/"
+            className="text-sm text-primary hover:underline"
+          >
+            &larr; Back to Home
+          </Link>
+        </div>
+      </div>
+    </div>
+  )
+}

package/templates/store-template/components/PathSyncBridge.tsx

@@ -0,0 +1,61 @@
+'use client'
+
+/**
+ * Path-sync bridge — posts the storefront's current pathname (+ search)
+ * to its parent every time it changes. Powers the Rovela editor's path
+ * bar so it stays in lock-step with whatever URL the iframe is showing,
+ * including:
+ *
+ *   - Direct link clicks inside the storefront (header / footer / cards)
+ *   - Browser back / forward (popstate fires usePathname re-renders)
+ *   - Dynamic-route renders (/products/[slug] etc.)
+ *   - Programmatic router.push from any component
+ *
+ * Cross-origin safe:
+ *   - postMessage with '*' target — the payload is a public pathname,
+ *     no sensitive data
+ *   - Parent validates `event.origin` against its known iframe origin
+ *     before reading (anti-spoofing defense in depth)
+ *
+ * Renders nothing — pure side-effect component. Mount it once in the
+ * customer + admin branches of LayoutContent so coverage matches the
+ * actual route tree.
+ *
+ * No-op outside iframe context: when `window.parent === window` the
+ * component returns immediately. Safe to ship in production builds
+ * served on a domain (no postMessage spam to the same window).
+ */
+
+import { usePathname } from 'next/navigation'
+import { useEffect } from 'react'
+
+/*
+ * IMPORTANT — DO NOT add `useSearchParams()` to this component.
+ *
+ * `useSearchParams` opts every page that contains it out of static
+ * prerendering unless wrapped in a Suspense boundary. Because this
+ * component is mounted in LayoutContent (which wraps EVERY route),
+ * adding it would force a Suspense wrap at every mount site AND
+ * dynamic-render every prerenderable page (/auth/*, /privacy, /terms,
+ * marketing pages, etc.) — Vercel hard-fails the build for any page
+ * that lacks the Suspense wrap.
+ *
+ * `usePathname` carries no such restriction. Reading `window.location.search`
+ * synchronously inside the effect gives us the current query string
+ * without the reactivity (which we don't need — we only sync on
+ * pathname change, which is the dominant navigation event).
+ *
+ * Trade-off: pure ?query-only changes without pathname change won't
+ * sync. Acceptable v1.
+ */
+export function PathSyncBridge() {
+  const pathname = usePathname()
+  useEffect(() => {
+    if (typeof window === 'undefined') return
+    if (window.parent === window) return
+    const search = window.location.search
+    const path = pathname + (search || '')
+    window.parent.postMessage({ type: 'rovela:navigation', path }, '*')
+  }, [pathname])
+  return null
+}

package/templates/store-template/components/Providers.tsx

@@ -0,0 +1,37 @@
+'use client'
+
+/**
+ * App Providers
+ *
+ * Client component wrapper for all context providers.
+ * Required because SessionProvider and StoreSettingsProvider are client components.
+ *
+ * Provider hierarchy:
+ * - SessionProvider: NextAuth authentication state
+ * - StoreSettingsProvider: Dynamic store settings from database
+ */
+
+import { SessionProvider } from 'next-auth/react'
+import { StoreSettingsProvider } from '@rovela-ai/sdk/core'
+import { storeConfig } from '@/lib/store-config'
+
+interface ProvidersProps {
+  children: React.ReactNode
+}
+
+export function Providers({ children }: ProvidersProps) {
+  return (
+    <SessionProvider>
+      <StoreSettingsProvider
+        fallback={{
+          storeName: storeConfig.store.name,
+          currency: storeConfig.store.currency,
+          locale: storeConfig.store.locale,
+          supportEmail: storeConfig.store.supportEmail,
+        }}
+      >
+        {children}
+      </StoreSettingsProvider>
+    </SessionProvider>
+  )
+}