@cimplify/sdk 0.40.1 → 0.42.0

package/templates/storefront-restaurant/app/reservations/reservations-client.tsx

@@ -0,0 +1,234 @@
+"use client";
+
+import { useMemo, useState } from "react";
+import { useRouter } from "next/navigation";
+import type { Product } from "@cimplify/sdk";
+import { useCart } from "@cimplify/sdk/react";
+
+const PARTY_SIZES = [2, 3, 4, 5, 6, 8, 10, 12];
+
+/**
+ * Reservation flow. Reservations are modelled as service-type products in
+ * the catalogue (e.g. "Two-top", "Four-top", "Long table"). The user picks
+ * a seating option, date, time, and party size; we add to cart with the
+ * reservation details as item notes; checkout finalises the booking.
+ */
+export function ReservationsClient({ options }: { options: Product[] }) {
+  const router = useRouter();
+  const { addToCart } = useCart();
+  const [selectedOption, setSelectedOption] = useState<Product | undefined>(options[0]);
+  const [selectedDate, setSelectedDate] = useState<Date>(() => new Date());
+  const [selectedSlotKey, setSelectedSlotKey] = useState<string | null>(null);
+  const [partySize, setPartySize] = useState<number>(2);
+  const [notes, setNotes] = useState("");
+  const [submitting, setSubmitting] = useState(false);
+
+  const dates = useMemo(() => {
+    const now = new Date();
+    return Array.from({ length: 14 }).map((_, i) => {
+      const d = new Date(now);
+      d.setDate(now.getDate() + i);
+      d.setHours(0, 0, 0, 0);
+      return d;
+    });
+  }, []);
+
+  // Restaurant slots: lunch 12–14:30, dinner 18–21:30, every 30 min.
+  const slots = useMemo(() => {
+    const out: { date: Date; label: string; service: "Lunch" | "Dinner" }[] = [];
+    for (let h = 12; h <= 14; h++) {
+      for (const m of [0, 30]) {
+        const d = new Date(selectedDate);
+        d.setHours(h, m, 0, 0);
+        out.push({ date: d, label: `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}`, service: "Lunch" });
+      }
+    }
+    for (let h = 18; h <= 21; h++) {
+      for (const m of [0, 30]) {
+        const d = new Date(selectedDate);
+        d.setHours(h, m, 0, 0);
+        out.push({ date: d, label: `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}`, service: "Dinner" });
+      }
+    }
+    return out;
+  }, [selectedDate]);
+
+  async function confirm() {
+    if (!selectedOption || !selectedSlotKey) return;
+    setSubmitting(true);
+    try {
+      const when = new Date(selectedSlotKey).toLocaleString();
+      const note = `Party of ${partySize} · ${when}${notes ? ` · ${notes}` : ""}`;
+      await addToCart(selectedOption.id, 1, { notes: note });
+      router.push("/checkout");
+    } catch {
+      setSubmitting(false);
+    }
+  }
+
+  if (options.length === 0) {
+    return (
+      <p className="text-muted-foreground">
+        No bookable seating options yet. Add Service-type products to your catalogue
+        (e.g. "Two-top", "Four-top", "Long table for 12") to enable reservations.
+      </p>
+    );
+  }
+
+  return (
+    <div className="grid grid-cols-1 lg:grid-cols-[1fr_1.4fr] gap-8">
+      <div className="space-y-6">
+        <div>
+          <p className="text-[11px] font-semibold uppercase tracking-[0.16em] text-muted-foreground mb-3">
+            Seating
+          </p>
+          <div className="space-y-2">
+            {options.map((o) => {
+              const active = selectedOption?.id === o.id;
+              return (
+                <button
+                  key={o.id}
+                  type="button"
+                  onClick={() => setSelectedOption(o)}
+                  className={[
+                    "w-full text-left rounded-2xl border p-4 transition-colors",
+                    active
+                      ? "border-primary bg-primary/5"
+                      : "border-border bg-card hover:border-foreground/30",
+                  ].join(" ")}
+                >
+                  <p className="font-semibold text-sm m-0">{o.name}</p>
+                  {o.description && (
+                    <p className="text-xs text-muted-foreground mt-0.5 line-clamp-2">{o.description}</p>
+                  )}
+                </button>
+              );
+            })}
+          </div>
+        </div>
+
+        <div>
+          <label
+            htmlFor="party"
+            className="text-[11px] font-semibold uppercase tracking-[0.16em] text-muted-foreground block mb-3"
+          >
+            Party size
+          </label>
+          <div className="grid grid-cols-4 gap-1.5">
+            {PARTY_SIZES.map((p) => {
+              const active = partySize === p;
+              return (
+                <button
+                  key={p}
+                  type="button"
+                  onClick={() => setPartySize(p)}
+                  className={[
+                    "py-2 rounded-md text-sm font-semibold transition-colors",
+                    active
+                      ? "bg-foreground text-background"
+                      : "bg-background border border-border hover:border-foreground",
+                  ].join(" ")}
+                >
+                  {p}
+                </button>
+              );
+            })}
+          </div>
+        </div>
+
+        <div>
+          <label
+            htmlFor="notes"
+            className="text-[11px] font-semibold uppercase tracking-[0.16em] text-muted-foreground block mb-3"
+          >
+            Notes (optional)
+          </label>
+          <textarea
+            id="notes"
+            rows={3}
+            value={notes}
+            onChange={(e) => setNotes(e.target.value)}
+            placeholder="Allergies, occasion, accessibility…"
+            className="w-full px-4 py-2.5 rounded-md bg-background border border-border focus:border-primary focus:ring-2 focus:ring-primary/20 outline-none text-sm resize-y"
+          />
+        </div>
+      </div>
+
+      <div className="rounded-2xl border border-border bg-card p-6">
+        <p className="text-[11px] font-semibold uppercase tracking-[0.16em] text-muted-foreground mb-3">
+          Date
+        </p>
+        <div className="grid grid-cols-7 gap-1.5 mb-6">
+          {dates.map((d) => {
+            const active = d.toDateString() === selectedDate.toDateString();
+            return (
+              <button
+                key={d.toISOString()}
+                type="button"
+                onClick={() => {
+                  setSelectedDate(d);
+                  setSelectedSlotKey(null);
+                }}
+                className={[
+                  "flex flex-col items-center justify-center py-2 rounded-md transition-colors",
+                  active
+                    ? "bg-foreground text-background"
+                    : "bg-background hover:bg-muted text-foreground",
+                ].join(" ")}
+              >
+                <span className="text-[10px] uppercase tracking-wider opacity-60">
+                  {d.toLocaleString(undefined, { weekday: "short" })}
+                </span>
+                <span className="text-base font-semibold tabular-nums">{d.getDate()}</span>
+              </button>
+            );
+          })}
+        </div>
+
+        {(["Lunch", "Dinner"] as const).map((service) => (
+          <div key={service} className="mb-5 last:mb-0">
+            <p className="text-[11px] font-semibold uppercase tracking-[0.16em] text-muted-foreground mb-2">
+              {service}
+            </p>
+            <div className="grid grid-cols-3 sm:grid-cols-5 gap-2">
+              {slots
+                .filter((s) => s.service === service)
+                .map((s) => {
+                  const key = s.date.toISOString();
+                  const active = selectedSlotKey === key;
+                  return (
+                    <button
+                      key={key}
+                      type="button"
+                      onClick={() => setSelectedSlotKey(key)}
+                      className={[
+                        "py-2 rounded-md text-sm tabular-nums transition-colors",
+                        active
+                          ? "bg-primary text-primary-foreground"
+                          : "bg-background border border-border hover:border-primary",
+                      ].join(" ")}
+                    >
+                      {s.label}
+                    </button>
+                  );
+                })}
+            </div>
+          </div>
+        ))}
+
+        <button
+          type="button"
+          onClick={confirm}
+          disabled={!selectedOption || !selectedSlotKey || submitting}
+          className="w-full mt-4 inline-flex items-center justify-center gap-2 px-5 py-3 rounded-md bg-primary text-primary-foreground font-semibold text-sm hover:bg-primary/90 transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
+        >
+          {submitting
+            ? "Confirming…"
+            : selectedSlotKey
+              ? `Reserve for ${partySize} on ${new Date(selectedSlotKey).toLocaleDateString()} at ${new Date(selectedSlotKey).toLocaleTimeString(undefined, { hour: "2-digit", minute: "2-digit" })}`
+              : "Pick a slot to reserve"}
+        </button>
+      </div>
+    </div>
+  );
+}

package/templates/storefront-restaurant/app/returns/page.tsx

@@ -0,0 +1,11 @@
+import type { Metadata } from "next";
+import { brand } from "@/lib/brand";
+import { PolicyPage } from "@/components/policy-page";
+
+export const metadata: Metadata = {
+  title: `${brand.returns.title} — ${brand.name}`,
+};
+
+export default function ReturnsPage() {
+  return <PolicyPage policy={brand.returns} />;
+}

package/templates/storefront-restaurant/app/robots.ts

@@ -0,0 +1,18 @@
+import type { MetadataRoute } from "next";
+
+const SITE_URL =
+  process.env.NEXT_PUBLIC_SITE_URL?.trim() || "https://example.com";
+
+export default function robots(): MetadataRoute.Robots {
+  return {
+    rules: [
+      {
+        userAgent: "*",
+        allow: "/",
+        disallow: ["/cart", "/checkout", "/orders/", "/api/"],
+      },
+    ],
+    sitemap: `${SITE_URL}/sitemap.xml`,
+    host: SITE_URL,
+  };
+}

package/templates/storefront-restaurant/app/search/page.tsx

@@ -0,0 +1,38 @@
+import type { Metadata } from "next";
+import { Suspense } from "react";
+import { SearchClient } from "./search-client";
+import { brand } from "@/lib/brand";
+
+export const metadata: Metadata = {
+  title: `Search — ${brand.name}`,
+  description: `Search ${brand.name} — products, collections, categories.`,
+};
+
+export default function SearchPage() {
+  return (
+    <article className="max-w-7xl mx-auto px-6 sm:px-8 py-10">
+      <p className="text-[11px] font-semibold uppercase tracking-[0.16em] text-primary mb-2">
+        Search
+      </p>
+      <h1 className="font-serif text-[clamp(2rem,4vw,2.75rem)] font-semibold mb-8 -tracking-[0.02em]">
+        Find anything.
+      </h1>
+      <Suspense fallback={<SearchSkeleton />}>
+        <SearchClient />
+      </Suspense>
+    </article>
+  );
+}
+
+function SearchSkeleton() {
+  return (
+    <div>
+      <div className="h-12 w-full max-w-xl bg-muted rounded animate-pulse mb-8" />
+      <div className="grid grid-cols-2 md:grid-cols-3 lg:grid-cols-4 gap-3 sm:gap-4">
+        {Array.from({ length: 8 }).map((_, i) => (
+          <div key={i} className="aspect-[4/3] bg-muted rounded-2xl animate-pulse" />
+        ))}
+      </div>
+    </div>
+  );
+}

package/templates/storefront-restaurant/app/search/search-client.tsx

@@ -0,0 +1,7 @@
+"use client";
+
+import { SearchPage } from "@cimplify/sdk/react";
+
+export function SearchClient() {
+  return <SearchPage />;
+}

package/templates/storefront-restaurant/app/shipping/page.tsx

@@ -0,0 +1,16 @@
+import type { Metadata } from "next";
+import { brand } from "@/lib/brand";
+import { PolicyPage } from "@/components/policy-page";
+
+export const metadata: Metadata = {
+  title: `${brand.shipping.title} — ${brand.name}`,
+  description: brand.shipping.sections[0]?.body
+    ? typeof brand.shipping.sections[0].body === "string"
+      ? brand.shipping.sections[0].body
+      : brand.shipping.sections[0].body.intro
+    : undefined,
+};
+
+export default function ShippingPage() {
+  return <PolicyPage policy={brand.shipping} />;
+}

package/templates/storefront-restaurant/app/shop/page.tsx

@@ -0,0 +1,31 @@
+import type { Metadata } from "next";
+import { cacheTag, cacheLife } from "next/cache";
+import { getServerClient, tags } from "@cimplify/sdk/server";
+import { ShopClient } from "./shop-client";
+import { brand } from "@/lib/brand";
+
+export const metadata: Metadata = {
+  title: `Shop — ${brand.name}`,
+  description: brand.description,
+};
+
+async function getShopData() {
+  "use cache";
+  cacheTag(tags.products(), tags.categories());
+  cacheLife("hours");
+
+  const client = getServerClient();
+  const [p, c] = await Promise.all([
+    client.catalogue.getProducts({ limit: 50 }),
+    client.catalogue.getCategories(),
+  ]);
+  return {
+    products: p.ok ? p.value.items : [],
+    categories: c.ok ? c.value : [],
+  };
+}
+
+export default async function ShopPage() {
+  const { products, categories } = await getShopData();
+  return <ShopClient products={products} categories={categories} />;
+}

package/templates/storefront-restaurant/app/shop/shop-client.tsx

@@ -0,0 +1,27 @@
+"use client";
+
+import { CataloguePage } from "@cimplify/sdk/react";
+import type { Category, Product } from "@cimplify/sdk";
+import { StoreProductCard } from "@/components/store-product-card";
+
+/**
+ * Client island for the shop page. Server-side fetches all products and
+ * categories (cached via `'use cache'` in `app/shop/page.tsx`), then hands
+ * them to `<CataloguePage>` which owns the interactive filter / sort state.
+ */
+export function ShopClient({
+  products,
+  categories,
+}: {
+  products: Product[];
+  categories: Category[];
+}) {
+  return (
+    <CataloguePage
+      title="The Menu"
+      products={products}
+      categories={categories}
+      renderCard={(p) => <StoreProductCard product={p} />}
+    />
+  );
+}

package/templates/storefront-restaurant/app/signup/page.tsx

@@ -0,0 +1,17 @@
+import type { Metadata } from "next";
+import { redirect } from "next/navigation";
+import { brand } from "@/lib/brand";
+
+export const metadata: Metadata = {
+  title: `Create an account — ${brand.name}`,
+  description: brand.account.signupSubtitle,
+};
+
+/**
+ * Cimplify Link handles sign-up inside the `<CimplifyAccount>` iframe.
+ * We bounce /signup to /account; the iframe shows the create-account UI
+ * for visitors with no session.
+ */
+export default function SignupPage(): never {
+  redirect("/account");
+}

package/templates/storefront-restaurant/app/sitemap-page/page.tsx

@@ -0,0 +1,167 @@
+import type { Metadata } from "next";
+import Link from "next/link";
+import { cacheTag, cacheLife } from "next/cache";
+import { getServerClient, tags, type Product } from "@cimplify/sdk/server";
+import { brand } from "@/lib/brand";
+
+export const metadata: Metadata = {
+  title: `Sitemap — ${brand.name}`,
+  description: "A human-readable index of every page on this site.",
+};
+
+interface SitemapData {
+  products: { slug: string; name: string }[];
+  categories: { slug: string; name: string }[];
+  collections: { slug: string; name: string }[];
+}
+
+async function getSitemap(): Promise<SitemapData> {
+  "use cache";
+  cacheTag(tags.products(), tags.categories(), tags.collections());
+  cacheLife("hours");
+
+  const client = getServerClient();
+  const [pRes, cRes, colRes] = await Promise.all([
+    client.catalogue.getProducts({ limit: 500 }),
+    client.catalogue.getCategories(),
+    client.catalogue.getCollections(),
+  ]);
+  return {
+    products: (pRes.ok ? pRes.value.items : []).map((p: Product) => ({
+      slug: p.slug ?? p.id,
+      name: p.name,
+    })),
+    categories: (cRes.ok ? cRes.value : []).map((c) => ({ slug: c.slug, name: c.name })),
+    collections: (colRes.ok ? colRes.value : []).map((c) => ({ slug: c.slug, name: c.name })),
+  };
+}
+
+const STATIC_LINKS: { title: string; links: { href: string; label: string }[] }[] = [
+  {
+    title: "Browse",
+    links: [
+      { href: "/", label: "Home" },
+      { href: "/shop", label: "Shop" },
+      { href: "/search", label: "Search" },
+    ],
+  },
+  {
+    title: "Account",
+    links: [
+      { href: "/account", label: "Account" },
+      { href: "/account/orders", label: "Orders" },
+      { href: "/account/addresses", label: "Addresses" },
+      { href: "/account/settings", label: "Settings" },
+      { href: "/login", label: "Sign in" },
+      { href: "/signup", label: "Create account" },
+      { href: "/track-order", label: "Track an order" },
+      { href: "/cart", label: "Cart" },
+      { href: "/checkout", label: "Checkout" },
+    ],
+  },
+  {
+    title: "About",
+    links: [
+      { href: "/about", label: "About" },
+      { href: "/faq", label: "FAQ" },
+      { href: "/contact", label: "Contact" },
+    ],
+  },
+  {
+    title: "Policies",
+    links: [
+      { href: "/shipping", label: "Shipping" },
+      { href: "/returns", label: "Returns" },
+      { href: "/accessibility", label: "Accessibility" },
+      { href: "/terms", label: "Terms of Service" },
+      { href: "/privacy", label: "Privacy Policy" },
+    ],
+  },
+  {
+    title: "Machine-readable",
+    links: [
+      { href: "/sitemap.xml", label: "sitemap.xml (search engines)" },
+      { href: "/llms.txt", label: "llms.txt (LLM agents)" },
+      { href: "/robots.txt", label: "robots.txt" },
+      { href: "/opensearch.xml", label: "opensearch.xml (browser search)" },
+    ],
+  },
+];
+
+export default async function SitemapHtmlPage() {
+  const { products, categories, collections } = await getSitemap();
+
+  return (
+    <article className="max-w-5xl mx-auto px-6 sm:px-8 py-16">
+      <p className="text-[11px] font-semibold uppercase tracking-[0.16em] text-primary mb-2">
+        Sitemap
+      </p>
+      <h1 className="text-[clamp(2rem,4vw,2.75rem)] font-semibold mb-2 -tracking-[0.02em]">
+        Every page, in one place.
+      </h1>
+      <p className="text-muted-foreground mb-12">
+        For search engines, see <Link href="/sitemap.xml" className="text-primary hover:underline">/sitemap.xml</Link>.
+        For LLM agents, see <Link href="/llms.txt" className="text-primary hover:underline">/llms.txt</Link>.
+      </p>
+      <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-10">
+        {STATIC_LINKS.map((s) => (
+          <Section key={s.title} title={s.title}>
+            {s.links.map((l) => (
+              <li key={l.href}>
+                <Link href={l.href} className="hover:text-primary transition-colors">
+                  {l.label}
+                </Link>
+              </li>
+            ))}
+          </Section>
+        ))}
+        {categories.length > 0 && (
+          <Section title="Categories">
+            {categories.map((c) => (
+              <li key={c.slug}>
+                <Link href={`/categories/${c.slug}`} className="hover:text-primary transition-colors">
+                  {c.name}
+                </Link>
+              </li>
+            ))}
+          </Section>
+        )}
+        {collections.length > 0 && (
+          <Section title="Collections">
+            {collections.map((c) => (
+              <li key={c.slug}>
+                <Link href={`/collections/${c.slug}`} className="hover:text-primary transition-colors">
+                  {c.name}
+                </Link>
+              </li>
+            ))}
+          </Section>
+        )}
+        {products.length > 0 && (
+          <Section title={`Products (${products.length})`}>
+            {products.map((p) => (
+              <li key={p.slug}>
+                <Link href={`/shop?product=${encodeURIComponent(p.slug)}`} className="hover:text-primary transition-colors">
+                  {p.name}
+                </Link>
+              </li>
+            ))}
+          </Section>
+        )}
+      </div>
+    </article>
+  );
+}
+
+function Section({ title, children }: { title: string; children: React.ReactNode }) {
+  return (
+    <div>
+      <p className="font-semibold text-[12px] uppercase tracking-[0.12em] text-foreground mb-3">
+        {title}
+      </p>
+      <ul className="space-y-2 m-0 p-0 list-none text-sm text-muted-foreground">
+        {children}
+      </ul>
+    </div>
+  );
+}

package/templates/storefront-restaurant/app/sitemap.ts

@@ -0,0 +1,62 @@
+import type { MetadataRoute } from "next";
+import { getServerClient, type Product } from "@cimplify/sdk/server";
+
+const SITE_URL =
+  process.env.NEXT_PUBLIC_SITE_URL?.trim() || "https://example.com";
+
+const STATIC_ROUTES: { path: string; priority: number; changeFrequency: "daily" | "weekly" | "monthly" }[] = [
+  { path: "/", priority: 1.0, changeFrequency: "daily" },
+  { path: "/shop", priority: 0.9, changeFrequency: "daily" },
+  { path: "/about", priority: 0.5, changeFrequency: "monthly" },
+  { path: "/faq", priority: 0.4, changeFrequency: "monthly" },
+  { path: "/terms", priority: 0.2, changeFrequency: "monthly" },
+  { path: "/privacy", priority: 0.2, changeFrequency: "monthly" },
+];
+
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+  const now = new Date();
+  const client = getServerClient();
+
+  const [productsRes, categoriesRes, collectionsRes] = await Promise.all([
+    client.catalogue.getProducts({ limit: 500 }),
+    client.catalogue.getCategories(),
+    client.catalogue.getCollections(),
+  ]);
+
+  const products = productsRes.ok ? productsRes.value.items : [];
+  const categories = categoriesRes.ok ? categoriesRes.value : [];
+  const collections = collectionsRes.ok ? collectionsRes.value : [];
+
+  const staticEntries: MetadataRoute.Sitemap = STATIC_ROUTES.map((r) => ({
+    url: `${SITE_URL}${r.path}`,
+    lastModified: now,
+    changeFrequency: r.changeFrequency,
+    priority: r.priority,
+  }));
+
+  // Bakery uses a URL-driven product modal (`?product=<slug>` on the home or
+  // shop pages). Emit those as deep-linkable URLs so search engines and LLMs
+  // can index each product canonically.
+  const productEntries: MetadataRoute.Sitemap = products.map((p: Product) => ({
+    url: `${SITE_URL}/shop?product=${encodeURIComponent(p.slug ?? p.id)}`,
+    lastModified: p.updated_at ? new Date(p.updated_at) : now,
+    changeFrequency: "weekly",
+    priority: 0.7,
+  }));
+
+  const categoryEntries: MetadataRoute.Sitemap = categories.map((c) => ({
+    url: `${SITE_URL}/categories/${c.slug}`,
+    lastModified: now,
+    changeFrequency: "weekly",
+    priority: 0.6,
+  }));
+
+  const collectionEntries: MetadataRoute.Sitemap = collections.map((c) => ({
+    url: `${SITE_URL}/collections/${c.slug}`,
+    lastModified: now,
+    changeFrequency: "weekly",
+    priority: 0.6,
+  }));
+
+  return [...staticEntries, ...categoryEntries, ...collectionEntries, ...productEntries];
+}

package/templates/storefront-restaurant/app/terms/page.tsx

@@ -0,0 +1,44 @@
+import type { Metadata } from "next";
+import { brand } from "@/lib/brand";
+
+export const metadata: Metadata = {
+  title: `Terms of Service — ${brand.name}`,
+  description: `The rules of the road for ordering from ${brand.name}.`,
+};
+
+export default function TermsPage() {
+  const t = brand.terms;
+  return (
+    <article className="max-w-3xl mx-auto px-8 py-16 prose prose-lg max-w-none">
+      <p className="text-[11px] font-semibold uppercase tracking-[0.16em] text-primary mb-2 not-prose">
+        {t.eyebrow}
+      </p>
+      <h1 className="font-serif text-[clamp(2.25rem,5vw,3.5rem)] font-semibold mb-2 -tracking-[0.02em]">
+        {t.title}
+      </h1>
+      <p className="text-sm text-muted-foreground not-prose mb-10">
+        Last updated: {t.lastUpdated}
+      </p>
+
+      <section className="space-y-5 leading-relaxed text-foreground/90">
+        {t.sections.map((s) => (
+          <div key={s.heading}>
+            <h2 className="font-serif text-2xl font-semibold mt-0">{s.heading}</h2>
+            {typeof s.body === "string" ? (
+              <p>{s.body}</p>
+            ) : (
+              <>
+                <p>{s.body.intro}</p>
+                <ul className="list-disc pl-6 space-y-2">
+                  {s.body.bullets.map((b) => (
+                    <li key={b}>{b}</li>
+                  ))}
+                </ul>
+              </>
+            )}
+          </div>
+        ))}
+      </section>
+    </article>
+  );
+}