@cimplify/sdk 0.40.0 → 0.41.0

package/templates/storefront-fashion/app/categories/[slug]/page.tsx

@@ -0,0 +1,130 @@
+import type { Metadata } from "next";
+import { Suspense } from "react";
+import Link from "next/link";
+import { notFound } from "next/navigation";
+import { cacheTag, cacheLife } from "next/cache";
+import {
+  getServerClient,
+  tags,
+  type Category,
+  type Product,
+} from "@cimplify/sdk/server";
+import { ListingClient } from "./listing-client";
+import { brand } from "@/lib/brand";
+
+interface CategoryData {
+  category: Category;
+  products: Product[];
+}
+
+async function getCategory(slug: string): Promise<CategoryData | null> {
+  "use cache";
+  cacheTag(tags.categories());
+  cacheLife("hours");
+
+  const client = getServerClient();
+  const catRes = await client.catalogue.getCategoryBySlug(slug);
+  if (!catRes.ok) return null;
+
+  cacheTag(tags.category(catRes.value.id), tags.categoryProducts(catRes.value.id));
+  const r = await client.catalogue.getCategoryProducts(catRes.value.id);
+  const products = r.ok
+    ? ((r.value as { items?: Product[] }).items ?? (r.value as Product[]))
+    : [];
+  return { category: catRes.value, products };
+}
+
+export async function generateMetadata({
+  params,
+}: {
+  params: Promise<{ slug: string }>;
+}): Promise<Metadata> {
+  const { slug } = await params;
+  const data = await getCategory(slug);
+  if (!data) return {};
+  return {
+    title: `${data.category.name} — ${brand.name}`,
+    description: data.category.description ?? undefined,
+  };
+}
+
+export default async function CategoryPage({
+  params,
+}: {
+  params: Promise<{ slug: string }>;
+}) {
+  return (
+    <Suspense fallback={<CategorySkeleton />}>
+      <CategoryContent params={params} />
+    </Suspense>
+  );
+}
+
+async function CategoryContent({
+  params,
+}: {
+  params: Promise<{ slug: string }>;
+}) {
+  const { slug } = await params;
+  const data = await getCategory(slug);
+  if (!data) notFound();
+
+  const { category, products } = data;
+  return (
+    <>
+      <section className="bg-foreground text-background relative overflow-hidden">
+        <div className="absolute inset-0 opacity-[0.04] pointer-events-none [background-image:radial-gradient(circle_at_2px_2px,white_1px,transparent_0)] [background-size:32px_32px]" />
+        <div className="relative max-w-7xl mx-auto px-6 sm:px-8 py-12 sm:py-14">
+          <nav className="text-[12px] font-mono text-background/60 mb-3 flex items-center gap-2">
+            <Link href="/" className="hover:text-background transition-colors">Home</Link>
+            <span>/</span>
+            <Link href="/shop" className="hover:text-background transition-colors">Shop</Link>
+            <span>/</span>
+            <span className="text-background/90">{category.name}</span>
+          </nav>
+          <h1 className="text-[clamp(2rem,4vw,3rem)] font-bold m-0 -tracking-[0.025em]">
+            {category.name}
+          </h1>
+          {category.description && (
+            <p className="mt-3 max-w-2xl text-base text-background/75">
+              {category.description}
+            </p>
+          )}
+          <p className="mt-4 text-[11px] font-mono uppercase tracking-[0.16em] text-background/60 tabular-nums">
+            {products.length} {products.length === 1 ? "product" : "products"}
+          </p>
+        </div>
+      </section>
+      <section className="max-w-7xl mx-auto px-6 sm:px-8 py-10 sm:py-12">
+        <ListingClient products={products} />
+        {products.length === 0 && (
+          <p className="text-center mt-8">
+            <Link href="/shop" className="text-primary font-semibold hover:underline">
+              ← Browse all products
+            </Link>
+          </p>
+        )}
+      </section>
+    </>
+  );
+}
+
+function CategorySkeleton() {
+  return (
+    <>
+      <section className="bg-foreground py-12 sm:py-14">
+        <div className="max-w-7xl mx-auto px-6 sm:px-8">
+          <div className="h-3 w-32 bg-background/20 rounded mb-3 animate-pulse" />
+          <div className="h-12 w-72 bg-background/20 rounded animate-pulse" />
+        </div>
+      </section>
+      <section className="max-w-7xl mx-auto px-6 sm:px-8 py-10 sm:py-12">
+        <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>
+      </section>
+    </>
+  );
+}

package/templates/storefront-fashion/app/checkout/page.tsx

@@ -0,0 +1,17 @@
+"use client";
+
+import { useRouter } from "next/navigation";
+import { CheckoutPage as SdkCheckoutPage } from "@cimplify/sdk/react";
+
+export default function CheckoutPage() {
+  const router = useRouter();
+  return (
+    <SdkCheckoutPage
+      onComplete={(result) => {
+        if (result.success && result.order) {
+          router.push(`/orders/${result.order.id}`);
+        }
+      }}
+    />
+  );
+}

package/templates/storefront-fashion/app/collections/[slug]/listing-client.tsx

@@ -0,0 +1,20 @@
+"use client";
+
+import { ProductGrid } from "@cimplify/sdk/react";
+import type { Product } from "@cimplify/sdk";
+import { StoreProductCard } from "@/components/store-product-card";
+
+/**
+ * Client island for the collection listing. Receives server-fetched
+ * products as props (serializable) and owns the `renderCard` function
+ * (which can't cross the server/client boundary).
+ */
+export function ListingClient({ products }: { products: Product[] }) {
+  return (
+    <ProductGrid
+      products={products}
+      emptyMessage="No products in this collection yet."
+      renderCard={(p) => <StoreProductCard product={p} />}
+    />
+  );
+}

package/templates/storefront-fashion/app/collections/[slug]/page.tsx

@@ -0,0 +1,130 @@
+import type { Metadata } from "next";
+import { Suspense } from "react";
+import Link from "next/link";
+import { notFound } from "next/navigation";
+import { cacheTag, cacheLife } from "next/cache";
+import {
+  getServerClient,
+  tags,
+  type Collection,
+  type Product,
+} from "@cimplify/sdk/server";
+import { ListingClient } from "./listing-client";
+import { brand } from "@/lib/brand";
+
+interface CollectionData {
+  collection: Collection;
+  products: Product[];
+}
+
+async function getCollection(slug: string): Promise<CollectionData | null> {
+  "use cache";
+  cacheTag(tags.collections());
+  cacheLife("hours");
+
+  const client = getServerClient();
+  const colRes = await client.catalogue.getCollectionBySlug(slug);
+  if (!colRes.ok) return null;
+
+  cacheTag(tags.collection(colRes.value.id), tags.collectionProducts(colRes.value.id));
+  const r = await client.catalogue.getCollectionProducts(colRes.value.id);
+  const products = r.ok
+    ? ((r.value as { items?: Product[] }).items ?? (r.value as Product[]))
+    : [];
+  return { collection: colRes.value, products };
+}
+
+export async function generateMetadata({
+  params,
+}: {
+  params: Promise<{ slug: string }>;
+}): Promise<Metadata> {
+  const { slug } = await params;
+  const data = await getCollection(slug);
+  if (!data) return {};
+  return {
+    title: `${data.collection.name} — ${brand.name}`,
+    description: data.collection.description ?? undefined,
+  };
+}
+
+export default async function CollectionPage({
+  params,
+}: {
+  params: Promise<{ slug: string }>;
+}) {
+  return (
+    <Suspense fallback={<CollectionSkeleton />}>
+      <CollectionContent params={params} />
+    </Suspense>
+  );
+}
+
+async function CollectionContent({
+  params,
+}: {
+  params: Promise<{ slug: string }>;
+}) {
+  const { slug } = await params;
+  const data = await getCollection(slug);
+  if (!data) notFound();
+
+  const { collection, products } = data;
+  return (
+    <>
+      <section className="bg-foreground text-background relative overflow-hidden">
+        <div className="absolute inset-0 opacity-[0.04] pointer-events-none [background-image:radial-gradient(circle_at_2px_2px,white_1px,transparent_0)] [background-size:32px_32px]" />
+        <div className="relative max-w-7xl mx-auto px-6 sm:px-8 py-12 sm:py-14">
+          <nav className="text-[12px] font-mono text-background/60 mb-3 flex items-center gap-2">
+            <Link href="/" className="hover:text-background transition-colors">Home</Link>
+            <span>/</span>
+            <span className="text-background/90">Collections</span>
+            <span>/</span>
+            <span className="text-background/90">{collection.name}</span>
+          </nav>
+          <h1 className="text-[clamp(2rem,4vw,3rem)] font-bold m-0 -tracking-[0.025em]">
+            {collection.name}
+          </h1>
+          {collection.description && (
+            <p className="mt-3 max-w-2xl text-base text-background/75">
+              {collection.description}
+            </p>
+          )}
+          <p className="mt-4 text-[11px] font-mono uppercase tracking-[0.16em] text-background/60 tabular-nums">
+            {products.length} {products.length === 1 ? "product" : "products"}
+          </p>
+        </div>
+      </section>
+      <section className="max-w-7xl mx-auto px-6 sm:px-8 py-10 sm:py-12">
+        <ListingClient products={products} />
+        {products.length === 0 && (
+          <p className="text-center mt-8">
+            <Link href="/shop" className="text-primary font-semibold hover:underline">
+              ← Browse all products
+            </Link>
+          </p>
+        )}
+      </section>
+    </>
+  );
+}
+
+function CollectionSkeleton() {
+  return (
+    <>
+      <section className="bg-foreground py-12 sm:py-14">
+        <div className="max-w-7xl mx-auto px-6 sm:px-8">
+          <div className="h-3 w-32 bg-background/20 rounded mb-3 animate-pulse" />
+          <div className="h-12 w-72 bg-background/20 rounded animate-pulse" />
+        </div>
+      </section>
+      <section className="max-w-7xl mx-auto px-6 sm:px-8 py-10 sm:py-12">
+        <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>
+      </section>
+    </>
+  );
+}

package/templates/storefront-fashion/app/error.tsx

@@ -0,0 +1,61 @@
+"use client";
+
+import { useEffect } from "react";
+import Link from "next/link";
+
+/**
+ * Root error boundary. Next.js calls this whenever a thrown error escapes
+ * a Server Component without being caught by a closer `error.tsx`.
+ *
+ * Wire `reportError` (Sentry, Datadog, etc.) here so production failures
+ * surface — silently recovering hides real bugs.
+ */
+export default function GlobalError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}) {
+  useEffect(() => {
+    // TODO: replace with your error reporter
+    // eslint-disable-next-line no-console
+    console.error("Storefront error:", error);
+  }, [error]);
+
+  return (
+    <section className="max-w-2xl mx-auto px-6 sm:px-8 py-20 text-center">
+      <p className="text-[11px] font-mono uppercase tracking-[0.16em] text-primary mb-3">
+        Something broke
+      </p>
+      <h1 className="text-[clamp(2rem,4vw,3rem)] font-bold mb-4 -tracking-[0.025em]">
+        That wasn&apos;t supposed to happen.
+      </h1>
+      <p className="text-muted-foreground leading-relaxed mb-8">
+        We&apos;ve been notified. Refresh the page, or head back home — most
+        of the time the second try just works.
+      </p>
+      {error.digest && (
+        <p className="text-xs font-mono text-muted-foreground mb-6">
+          Reference:{" "}
+          <code className="text-foreground">{error.digest}</code>
+        </p>
+      )}
+      <div className="flex flex-wrap items-center justify-center gap-3">
+        <button
+          type="button"
+          onClick={reset}
+          className="inline-flex items-center gap-2 px-5 py-2.5 rounded-md bg-primary text-primary-foreground font-semibold text-sm hover:bg-primary/90 transition-colors"
+        >
+          Try again
+        </button>
+        <Link
+          href="/"
+          className="inline-flex items-center gap-2 px-5 py-2.5 rounded-md border border-border hover:bg-muted transition-colors text-sm font-medium"
+        >
+          Back home
+        </Link>
+      </div>
+    </section>
+  );
+}

package/templates/storefront-fashion/app/faq/page.tsx

@@ -0,0 +1,46 @@
+import type { Metadata } from "next";
+import { brand } from "@/lib/brand";
+
+export const metadata: Metadata = {
+  title: `Support — ${brand.name}`,
+  description: "Shipping, warranty, repairs, returns, payment — answers to the questions we hear most often.",
+};
+
+export default function FaqPage() {
+  const f = brand.faq;
+  return (
+    <article className="max-w-3xl mx-auto px-8 py-16">
+      <p className="text-[11px] font-mono uppercase tracking-[0.16em] text-primary mb-2">
+        {f.eyebrow}
+      </p>
+      <h1 className="text-[clamp(2.25rem,5vw,3.5rem)] font-bold mb-10 -tracking-[0.025em]">
+        {f.title}
+      </h1>
+      <div className="space-y-12">
+        {f.sections.map((section) => (
+          <section key={section.title}>
+            <h2 className="text-2xl font-semibold mb-5 -tracking-[0.02em]">{section.title}</h2>
+            <dl className="space-y-6">
+              {section.items.map((item) => (
+                <div key={item.q}>
+                  <dt className="font-semibold text-foreground mb-1.5">{item.q}</dt>
+                  <dd className="text-muted-foreground leading-relaxed">{item.a}</dd>
+                </div>
+              ))}
+            </dl>
+          </section>
+        ))}
+      </div>
+      <p className="mt-12 pt-8 border-t border-border text-sm text-muted-foreground">
+        {f.contactPrompt}{" "}
+        <a
+          href={`mailto:${f.contactEmail}`}
+          className="text-primary font-semibold hover:underline"
+        >
+          {f.contactEmail}
+        </a>{" "}
+        and a real human will reply within 24 hours.
+      </p>
+    </article>
+  );
+}

package/templates/storefront-fashion/app/globals.css

@@ -0,0 +1,46 @@
+@import "tailwindcss";
+
+@source "../node_modules/@cimplify/sdk/dist";
+
+/* Studio FRX — Nike/Aritzia-style streetwear palette. High-contrast
+   neutrals with one electric accent. Tweak primary to retheme everything. */
+@theme {
+  --color-background: oklch(0.99 0 0);
+  --color-foreground: oklch(0.12 0 0);
+  --color-card: oklch(1 0 0);
+  --color-card-foreground: oklch(0.12 0 0);
+  --color-popover: oklch(1 0 0);
+  --color-popover-foreground: oklch(0.12 0 0);
+  --color-primary: oklch(0.7 0.24 30);
+  --color-primary-foreground: oklch(0.99 0 0);
+  --color-secondary: oklch(0.96 0 0);
+  --color-secondary-foreground: oklch(0.18 0 0);
+  --color-muted: oklch(0.96 0 0);
+  --color-muted-foreground: oklch(0.45 0 0);
+  --color-accent: oklch(0.92 0 0);
+  --color-accent-foreground: oklch(0.18 0 0);
+  --color-destructive: oklch(0.58 0.24 27);
+  --color-destructive-foreground: oklch(0.99 0 0);
+  --color-border: oklch(0.9 0 0);
+  --color-input: oklch(0.93 0 0);
+  --color-ring: oklch(0.7 0.24 30);
+  --radius: 0.125rem;
+}
+
+@layer base {
+  html, body {
+    margin: 0;
+    padding: 0;
+    background: var(--color-background);
+    color: var(--color-foreground);
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+  }
+  a { color: inherit; text-decoration: none; }
+  h1, h2, h3, h4 {
+    font-family: var(--font-display);
+    letter-spacing: -0.04em;
+    font-weight: 800;
+    line-height: 0.95;
+  }
+}

package/templates/storefront-fashion/app/layout.tsx

@@ -0,0 +1,76 @@
+import type { Metadata } from "next";
+import { Inter, Anton } from "next/font/google";
+import "./globals.css";
+import { Providers } from "@/components/providers";
+import { Header } from "@/components/header";
+import { Footer } from "@/components/footer";
+import { brand } from "@/lib/brand";
+
+const inter = Inter({
+  subsets: ["latin"],
+  variable: "--font-sans",
+  display: "swap",
+});
+
+const anton = Anton({
+  subsets: ["latin"],
+  variable: "--font-display",
+  weight: "400",
+  display: "swap",
+});
+
+const SITE_URL =
+  process.env.NEXT_PUBLIC_SITE_URL?.trim() || "https://example.com";
+
+export const metadata: Metadata = {
+  metadataBase: new URL(SITE_URL),
+  title: {
+    default: brand.name,
+    template: `%s — ${brand.name}`,
+  },
+  description: brand.description,
+  openGraph: {
+    type: "website",
+    siteName: brand.name,
+    locale: brand.locale,
+  },
+  twitter: { card: "summary_large_image" },
+};
+
+const ORGANIZATION_LD = {
+  "@context": "https://schema.org",
+  "@type": brand.schemaType,
+  name: brand.name,
+  url: SITE_URL,
+  description: brand.description,
+  email: brand.contact.email,
+  telephone: brand.contact.phoneTel,
+  address: {
+    "@type": "PostalAddress",
+    streetAddress: brand.contact.streetAddress,
+    addressLocality: brand.contact.city,
+    addressCountry: brand.contact.countryCode,
+  },
+  sameAs: brand.socials.map((s) => s.href),
+};
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en" className={`${inter.variable} ${anton.variable}`}>
+      <body
+        suppressHydrationWarning
+        className="min-h-screen flex flex-col bg-background text-foreground font-sans"
+      >
+        <script
+          type="application/ld+json"
+          dangerouslySetInnerHTML={{ __html: JSON.stringify(ORGANIZATION_LD) }}
+        />
+        <Providers>
+          <Header />
+          <main className="flex-1 pb-12 w-full">{children}</main>
+          <Footer />
+        </Providers>
+      </body>
+    </html>
+  );
+}

package/templates/storefront-fashion/app/llms.txt/route.ts

@@ -0,0 +1,94 @@
+import { cacheTag, cacheLife } from "next/cache";
+import { getServerClient, tags, type Product } from "@cimplify/sdk/server";
+import { brand } from "@/lib/brand";
+
+const SITE_URL =
+  process.env.NEXT_PUBLIC_SITE_URL?.trim() || "https://example.com";
+
+async function buildLlmsTxt(): Promise<string> {
+  "use cache";
+  cacheTag(tags.products(), tags.categories(), tags.collections());
+  cacheLife("hours");
+
+  const client = getServerClient();
+  const [productsRes, categoriesRes, collectionsRes] = await Promise.all([
+    client.catalogue.getProducts({ limit: 500 }),
+    client.catalogue.getCategories(),
+    client.catalogue.getCollections(),
+  ]);
+
+  const products: Product[] = productsRes.ok ? productsRes.value.items : [];
+  const categories = categoriesRes.ok ? categoriesRes.value : [];
+  const collections = collectionsRes.ok ? collectionsRes.value : [];
+
+  const lines: string[] = [];
+  lines.push(`# ${brand.name}`);
+  lines.push("");
+  lines.push(`> ${brand.llms.summary}`);
+  lines.push("");
+  lines.push("## Browse");
+  lines.push(`- [Home](${SITE_URL}/)`);
+  lines.push(`- [Shop](${SITE_URL}/shop): Full catalogue with filter and sort.`);
+
+  if (categories.length > 0) {
+    lines.push("");
+    lines.push("## Categories");
+    for (const c of categories) {
+      lines.push(
+        `- [${c.name}](${SITE_URL}/categories/${c.slug})${c.description ? `: ${c.description}` : ""}`,
+      );
+    }
+  }
+
+  if (collections.length > 0) {
+    lines.push("");
+    lines.push("## Collections");
+    for (const c of collections) {
+      lines.push(
+        `- [${c.name}](${SITE_URL}/collections/${c.slug})${c.description ? `: ${c.description}` : ""}`,
+      );
+    }
+  }
+
+  if (products.length > 0) {
+    lines.push("");
+    lines.push("## Products");
+    for (const p of products) {
+      const slug = p.slug ?? p.id;
+      const price = `${p.currency ?? brand.currency} ${p.default_price}`;
+      const desc = p.description ? ` — ${p.description.replace(/\s+/g, " ").slice(0, 200)}` : "";
+      lines.push(`- [${p.name}](${SITE_URL}/products/${slug}) (${price})${desc}`);
+    }
+  }
+
+  lines.push("");
+  lines.push("## Information");
+  lines.push(`- [About](${SITE_URL}/about)`);
+  lines.push(`- [Support / FAQ](${SITE_URL}/faq)`);
+  lines.push(`- [Terms of Service](${SITE_URL}/terms)`);
+  lines.push(`- [Privacy Policy](${SITE_URL}/privacy)`);
+  lines.push(`- [Sitemap (XML)](${SITE_URL}/sitemap.xml)`);
+  lines.push("");
+  lines.push("## Contact");
+  lines.push(`- Email: ${brand.contact.email}`);
+  lines.push(`- Phone: ${brand.contact.phone}`);
+  lines.push(`- Address: ${brand.contact.address}`);
+
+  return lines.join("\n") + "\n";
+}
+
+/**
+ * `/llms.txt` — machine-readable site index for LLMs (per llmstxt.org).
+ * Lets coding agents and chat assistants find products, categories, and
+ * support pages without scraping HTML. Plain Markdown so it streams cheaply
+ * into context windows.
+ */
+export async function GET(): Promise<Response> {
+  const body = await buildLlmsTxt();
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/plain; charset=utf-8",
+      "Cache-Control": "public, max-age=0, s-maxage=3600, stale-while-revalidate=86400",
+    },
+  });
+}

package/templates/storefront-fashion/app/not-found.tsx

@@ -0,0 +1,39 @@
+import type { Metadata } from "next";
+import Link from "next/link";
+import { brand } from "@/lib/brand";
+
+export const metadata: Metadata = {
+  title: `Page not found — ${brand.name}`,
+  description: "We couldn't find that page.",
+};
+
+export default function NotFound() {
+  return (
+    <section className="max-w-2xl mx-auto px-6 sm:px-8 py-20 text-center">
+      <p className="text-[11px] font-mono uppercase tracking-[0.16em] text-primary mb-3">
+        404
+      </p>
+      <h1 className="text-[clamp(2.5rem,5vw,4rem)] font-bold mb-4 -tracking-[0.03em]">
+        Page not found.
+      </h1>
+      <p className="text-muted-foreground leading-relaxed mb-8">
+        The URL you followed might be old, a typo, or pointing at a product
+        that&apos;s no longer in stock. Try the menu or head back home.
+      </p>
+      <div className="flex flex-wrap items-center justify-center gap-3">
+        <Link
+          href="/shop"
+          className="inline-flex items-center gap-2 px-5 py-2.5 rounded-md bg-primary text-primary-foreground font-semibold text-sm hover:bg-primary/90 transition-colors"
+        >
+          Browse the shop
+        </Link>
+        <Link
+          href="/"
+          className="inline-flex items-center gap-2 px-5 py-2.5 rounded-md border border-border hover:bg-muted transition-colors text-sm font-medium"
+        >
+          Back home
+        </Link>
+      </div>
+    </section>
+  );
+}