@cimplify/sdk 0.39.1 → 0.40.1

package/templates/storefront-retail/components/product-modal.tsx

@@ -0,0 +1,105 @@
+"use client";
+
+import { useEffect } from "react";
+import Image from "next/image";
+import { useRouter, useSearchParams, usePathname } from "next/navigation";
+import { ProductSheet, useProduct, useCart } from "@cimplify/sdk/react";
+
+/**
+ * URL-driven product modal. Reads `?product=<slug>` and renders the SDK's
+ * `<ProductSheet/>` — vertical layout with image-on-top, then header, then
+ * the variant/add-on/composite/bundle customizer. Closing the modal clears
+ * the search param. Deep-linkable and survives reloads.
+ */
+export function ProductModal() {
+  const router = useRouter();
+  const pathname = usePathname();
+  const searchParams = useSearchParams();
+  const slug = searchParams?.get("product") ?? null;
+
+  const { product } = useProduct(slug ?? "", { enabled: Boolean(slug) });
+  const { addToCart } = useCart();
+
+  useEffect(() => {
+    if (!slug) return;
+    const original = document.body.style.overflow;
+    document.body.style.overflow = "hidden";
+    return () => {
+      document.body.style.overflow = original;
+    };
+  }, [slug]);
+
+  useEffect(() => {
+    if (!slug) return;
+    const onKey = (e: KeyboardEvent) => {
+      if (e.key === "Escape") close();
+    };
+    window.addEventListener("keydown", onKey);
+    return () => window.removeEventListener("keydown", onKey);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [slug]);
+
+  if (!slug) return null;
+
+  function close() {
+    const next = new URLSearchParams(searchParams?.toString() ?? "");
+    next.delete("product");
+    const qs = next.toString();
+    router.replace(qs ? `${pathname}?${qs}` : pathname, { scroll: false });
+  }
+
+  return (
+    <div
+      role="dialog"
+      aria-modal="true"
+      onClick={close}
+      className="fixed inset-0 z-[100] flex items-end sm:items-center justify-center sm:p-6 bg-foreground/50 backdrop-blur-sm"
+    >
+      <div
+        onClick={(e) => e.stopPropagation()}
+        className="relative w-full sm:max-w-lg max-h-[92vh] overflow-auto bg-card sm:rounded-3xl rounded-t-3xl shadow-2xl"
+      >
+        <button
+          onClick={close}
+          aria-label="Close product details"
+          className="absolute top-4 right-4 z-10 w-9 h-9 rounded-full bg-card border border-border text-sm cursor-pointer transition-colors hover:bg-muted"
+        >
+          ✕
+        </button>
+        {product ? (
+          <ProductSheet
+            product={product}
+            onClose={close}
+            onAddToCart={async (p, qty, options) => {
+              await addToCart(p.id, qty, options);
+              close();
+              router.push("/cart");
+            }}
+            renderImage={({ src, alt, className }) => (
+              <Image
+                src={src}
+                alt={alt}
+                width={1200}
+                height={900}
+                className={className}
+                style={{ width: "100%", height: "auto", objectFit: "cover" }}
+                priority
+              />
+            )}
+            classNames={{
+              root: "p-6 sm:p-8 gap-4",
+              image: "rounded-2xl overflow-hidden -mx-6 sm:-mx-8 -mt-6 sm:-mt-8 mb-2",
+              header: "flex items-baseline justify-between gap-4",
+              name: "font-serif text-2xl font-semibold m-0",
+              price: "text-lg font-semibold text-primary",
+              description: "text-sm text-muted-foreground leading-relaxed",
+              customizer: "pt-2",
+            }}
+          />
+        ) : (
+          <div className="p-8 text-center text-muted-foreground">Loading…</div>
+        )}
+      </div>
+    </div>
+  );
+}

package/templates/storefront-retail/components/promo-banner.tsx

@@ -0,0 +1,44 @@
+import Link from "next/link";
+
+interface PromoBannerProps {
+  badge: string;
+  title: string;
+  body: string;
+  cta: { label: string; href: string };
+}
+
+/**
+ * Full-width promo banner — featured deal / launch / season campaign.
+ * Bold geometric background, mono-spaced detail labels.
+ */
+export function PromoBanner({ badge, title, body, cta }: PromoBannerProps) {
+  return (
+    <section className="max-w-7xl mx-auto px-6 sm:px-8 py-6">
+      <div className="relative overflow-hidden rounded-3xl bg-gradient-to-br from-primary via-primary to-foreground text-primary-foreground p-8 sm:p-12 lg:p-16">
+        <div className="absolute -top-20 -right-20 w-72 h-72 rounded-full bg-background/10 blur-3xl pointer-events-none" />
+        <div className="absolute -bottom-32 -left-20 w-96 h-96 rounded-full bg-foreground/30 blur-3xl pointer-events-none" />
+        <div className="relative grid grid-cols-1 lg:grid-cols-[1fr_auto] gap-8 items-center">
+          <div className="max-w-2xl">
+            <span className="inline-flex items-center gap-2 mb-4 px-3 py-1 rounded-full bg-background/15 border border-background/25 text-[11px] font-mono uppercase tracking-[0.16em]">
+              <span className="w-1.5 h-1.5 rounded-full bg-background animate-pulse" />
+              {badge}
+            </span>
+            <h2 className="text-[clamp(1.75rem,3.5vw,2.75rem)] font-bold m-0 mb-3 -tracking-[0.025em] leading-[1.1]">
+              {title}
+            </h2>
+            <p className="text-base sm:text-lg opacity-90 leading-relaxed">{body}</p>
+          </div>
+          <Link
+            href={cta.href}
+            className="inline-flex items-center gap-2 px-5 py-3 rounded-md bg-background text-foreground font-semibold text-sm hover:bg-background/90 transition-colors whitespace-nowrap"
+          >
+            {cta.label}
+            <svg viewBox="0 0 12 12" className="w-3 h-3" fill="none" stroke="currentColor" strokeWidth="2" aria-hidden>
+              <path d="M3 6h7m0 0L7 3m3 3L7 9" strokeLinecap="round" strokeLinejoin="round" />
+            </svg>
+          </Link>
+        </div>
+      </div>
+    </section>
+  );
+}

package/templates/storefront-retail/components/providers.tsx

@@ -0,0 +1,31 @@
+"use client";
+
+import { useMemo, type ReactNode } from "react";
+import { createCimplifyClient } from "@cimplify/sdk";
+import { CimplifyProvider } from "@cimplify/sdk/react";
+
+/**
+ * Boots the Cimplify SDK client once on the client-side and exposes it via
+ * <CimplifyProvider/>.
+ *
+ * Base-URL resolution:
+ *   1) If NEXT_PUBLIC_CIMPLIFY_API_URL is set, use it verbatim.
+ *   2) Otherwise use the current origin so requests flow through the
+ *      Next.js rewrite in `next.config.ts` to the mock at :8787 (no CORS).
+ *   3) Fall back to 127.0.0.1:8787 only during SSR, when there's no window.
+ */
+export function Providers({ children }: { children: ReactNode }) {
+  const client = useMemo(() => {
+    const baseUrl =
+      process.env.NEXT_PUBLIC_CIMPLIFY_API_URL?.trim() ||
+      (typeof window !== "undefined" ? window.location.origin : "http://127.0.0.1:8787");
+    const publicKey = process.env.NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY ?? "mock-dev";
+    return createCimplifyClient({
+      baseUrl,
+      publicKey,
+      suppressPublicKeyWarning: true,
+    });
+  }, []);
+
+  return <CimplifyProvider client={client}>{children}</CimplifyProvider>;
+}

package/templates/storefront-retail/components/section-heading.tsx

@@ -0,0 +1,37 @@
+import Link from "next/link";
+
+interface SectionHeadingProps {
+  eyebrow: string;
+  title: string;
+  description?: string;
+  link?: { label: string; href: string };
+}
+
+export function SectionHeading({ eyebrow, title, description, link }: SectionHeadingProps) {
+  return (
+    <div className="flex items-end justify-between gap-6 mb-8">
+      <div className="max-w-2xl">
+        <p className="text-[11px] font-mono uppercase tracking-[0.16em] text-primary mb-2">
+          {eyebrow}
+        </p>
+        <h2 className="text-[clamp(1.75rem,3vw,2.25rem)] font-bold m-0 -tracking-[0.025em]">
+          {title}
+        </h2>
+        {description && (
+          <p className="mt-2 text-muted-foreground">{description}</p>
+        )}
+      </div>
+      {link && (
+        <Link
+          href={link.href}
+          className="text-sm font-semibold text-primary hover:underline whitespace-nowrap hidden sm:inline-flex items-center gap-1"
+        >
+          {link.label}
+          <svg viewBox="0 0 12 12" className="w-3 h-3" fill="none" stroke="currentColor" strokeWidth="2" aria-hidden>
+            <path d="M3 6h7m0 0L7 3m3 3L7 9" strokeLinecap="round" strokeLinejoin="round" />
+          </svg>
+        </Link>
+      )}
+    </div>
+  );
+}

package/templates/storefront-retail/components/store-product-card.tsx

@@ -0,0 +1,83 @@
+"use client";
+
+import Link from "next/link";
+import {
+  CardVariant,
+  FoodProductCard,
+  RetailProductCard,
+  WholesaleProductCard,
+  DigitalProductCard,
+  BundleProductCard,
+  CompositeProductCard,
+  StandardServiceCard,
+  RentalServiceCard,
+  AccommodationCard,
+  LeaseServiceCard,
+  SubscriptionCard,
+} from "@cimplify/sdk/react";
+import type { CardLayoutProps } from "@cimplify/sdk/react";
+import type { Product } from "@cimplify/sdk";
+import { PRODUCT_TYPE, RENDER_HINT, DURATION_UNIT } from "@cimplify/sdk";
+
+const RENTAL_UNITS = new Set<string>([DURATION_UNIT.Days, DURATION_UNIT.Hours]);
+const LEASE_UNITS = new Set<string>([DURATION_UNIT.Weeks, DURATION_UNIT.Months, DURATION_UNIT.Years]);
+
+const VARIANT_CARDS: Record<CardVariant, React.ComponentType<CardLayoutProps>> = {
+  [CardVariant.Food]: FoodProductCard,
+  [CardVariant.Retail]: RetailProductCard,
+  [CardVariant.Wholesale]: WholesaleProductCard,
+  [CardVariant.Digital]: DigitalProductCard,
+  [CardVariant.Bundle]: BundleProductCard,
+  [CardVariant.Composite]: CompositeProductCard,
+  [CardVariant.Standard]: StandardServiceCard,
+  [CardVariant.Rental]: RentalServiceCard,
+  [CardVariant.Accommodation]: AccommodationCard,
+  [CardVariant.Lease]: LeaseServiceCard,
+  [CardVariant.Subscription]: SubscriptionCard,
+};
+
+function resolveVariant(p: Product): CardVariant {
+  if (p.type === PRODUCT_TYPE.Bundle) return CardVariant.Bundle;
+  if (p.type === PRODUCT_TYPE.Composite) return CardVariant.Composite;
+  if (p.quantity_pricing && p.quantity_pricing.length > 1) return CardVariant.Wholesale;
+  if (p.type === PRODUCT_TYPE.Digital) return CardVariant.Digital;
+  if (p.type === PRODUCT_TYPE.Service) {
+    if (p.duration_unit && RENTAL_UNITS.has(p.duration_unit)) return CardVariant.Rental;
+    if (p.duration_unit === DURATION_UNIT.Nights) return CardVariant.Accommodation;
+    if (p.duration_unit && LEASE_UNITS.has(p.duration_unit)) return CardVariant.Lease;
+    if (p.billing_plans && p.billing_plans.length > 0 && !p.duration_minutes) return CardVariant.Subscription;
+    return CardVariant.Standard;
+  }
+  if (p.render_hint === RENDER_HINT.Food) return CardVariant.Food;
+  return CardVariant.Retail;
+}
+
+interface Props {
+  product: Product;
+  /** Override the auto-detected card variant. */
+  variant?: CardVariant;
+}
+
+/**
+ * Variant-aware product card that opens the URL-driven product modal on
+ * click. Uses `next/link` with `?product=<slug>` so the link is statically
+ * pre-renderable — no `useSearchParams` dependency means cards don't
+ * become dynamic islands. The modal (which already reads `useSearchParams`
+ * inside a Suspense boundary in the root layout) handles the rest.
+ */
+export function StoreProductCard({ product, variant }: Props) {
+  const slug = product.slug || product.id;
+  const Card = VARIANT_CARDS[variant ?? resolveVariant(product)];
+  const href = `?product=${encodeURIComponent(slug)}`;
+
+  return (
+    <Card
+      product={product}
+      renderLink={({ className, children }) => (
+        <Link href={href} scroll={false} prefetch={false} className={className}>
+          {children}
+        </Link>
+      )}
+    />
+  );
+}

package/templates/storefront-retail/components/trade-in-cta.tsx

@@ -0,0 +1,60 @@
+import Link from "next/link";
+
+export function TradeInCta() {
+  return (
+    <section className="max-w-7xl mx-auto px-6 sm:px-8 py-14 sm:py-20">
+      <div className="grid grid-cols-1 lg:grid-cols-2 gap-8 items-center bg-foreground text-background rounded-3xl p-8 sm:p-12 lg:p-14 overflow-hidden relative">
+        <div className="absolute top-0 right-0 w-1/2 h-full opacity-[0.04] [background-image:linear-gradient(135deg,white_1px,transparent_1px)] [background-size:24px_24px] pointer-events-none" />
+        <div>
+          <p className="text-[11px] font-mono uppercase tracking-[0.16em] text-primary-foreground/70 mb-3">
+            Trade-in programme
+          </p>
+          <h2 className="text-[clamp(1.75rem,3.5vw,2.5rem)] font-bold m-0 mb-4 -tracking-[0.025em] leading-[1.1]">
+            Last year&apos;s phone, this year&apos;s discount.
+          </h2>
+          <p className="text-background/75 leading-relaxed mb-6">
+            Send us your iPhone, Galaxy, or MacBook. We&apos;ll quote within
+            48 hours and credit the value toward your next purchase. Devices
+            head to certified refurbishers across the continent — yours stays
+            in service for years more.
+          </p>
+          <div className="flex flex-wrap items-center gap-3">
+            <Link
+              href="/about"
+              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"
+            >
+              Get a quote
+              <svg viewBox="0 0 12 12" className="w-3 h-3" fill="none" stroke="currentColor" strokeWidth="2" aria-hidden>
+                <path d="M3 6h7m0 0L7 3m3 3L7 9" strokeLinecap="round" strokeLinejoin="round" />
+              </svg>
+            </Link>
+            <Link
+              href="/faq"
+              className="inline-flex items-center gap-2 px-5 py-2.5 rounded-md border border-background/25 hover:bg-background/10 transition-colors text-sm font-medium"
+            >
+              How it works
+            </Link>
+          </div>
+        </div>
+        <div className="grid grid-cols-3 gap-3">
+          {[
+            { step: "01", title: "Tell us what you have", body: "Model + condition + photos. 2 minutes." },
+            { step: "02", title: "Ship it free", body: "Drop at our store or book a free pickup." },
+            { step: "03", title: "Get credited", body: "Within 48 hours, in store credit or Mobile Money." },
+          ].map((s) => (
+            <div
+              key={s.step}
+              className="rounded-2xl p-4 sm:p-5 bg-background/5 border border-background/10"
+            >
+              <p className="text-[10px] font-mono text-primary tabular-nums mb-3">{s.step}</p>
+              <p className="text-[13px] sm:text-sm font-semibold mb-1.5 -tracking-[0.015em]">
+                {s.title}
+              </p>
+              <p className="text-[11px] sm:text-xs text-background/65 leading-snug">{s.body}</p>
+            </div>
+          ))}
+        </div>
+      </div>
+    </section>
+  );
+}

package/templates/storefront-retail/components/trust-bar.tsx

@@ -0,0 +1,26 @@
+interface TrustBarProps {
+  items: { label: string; value: string; description: string; icon: React.ReactNode }[];
+}
+
+export function TrustBar({ items }: TrustBarProps) {
+  return (
+    <section className="border-y border-border bg-card">
+      <div className="max-w-7xl mx-auto px-6 sm:px-8 py-10 grid grid-cols-2 md:grid-cols-4 gap-x-6 gap-y-8">
+        {items.map((it) => (
+          <div key={it.label} className="flex items-start gap-3">
+            <div className="grid place-items-center w-10 h-10 rounded-lg bg-primary/10 text-primary shrink-0">
+              {it.icon}
+            </div>
+            <div className="min-w-0">
+              <p className="text-[10px] font-mono uppercase tracking-[0.16em] text-muted-foreground mb-0.5">
+                {it.label}
+              </p>
+              <p className="text-base font-semibold -tracking-[0.015em] mb-0.5">{it.value}</p>
+              <p className="text-xs text-muted-foreground leading-snug">{it.description}</p>
+            </div>
+          </div>
+        ))}
+      </div>
+    </section>
+  );
+}

package/templates/storefront-retail/lib/cart.ts

@@ -0,0 +1,27 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { useCimplifyClient } from "@cimplify/sdk/react";
+
+/**
+ * Tiny hook for the live cart-count pill in the header. Re-fetches on
+ * mount and exposes a refresh callback. The SDK's `useCart` hook is
+ * fine-grained but heavier — this is enough for a header badge.
+ */
+export function useCartCount(): { count: number; refresh: () => void } {
+  const { client } = useCimplifyClient();
+  const [count, setCount] = useState(0);
+
+  const refresh = () => {
+    void client.cart.getCount().then((r) => {
+      if (r.ok) setCount(r.value);
+    });
+  };
+
+  useEffect(() => {
+    refresh();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [client]);
+
+  return { count, refresh };
+}

package/templates/storefront-retail/next.config.ts

@@ -0,0 +1,40 @@
+import type { NextConfig } from "next";
+
+const MOCK_URL = process.env.NEXT_PUBLIC_CIMPLIFY_API_URL?.trim() || "http://127.0.0.1:8787";
+
+/**
+ * Same-origin proxy to the Cimplify mock so the browser never makes a
+ * cross-origin request in dev (no CORS preflights, no flaky `Origin`
+ * mismatches). The SDK's base URL stays empty/relative — requests go to
+ * `/api/v1/...` on the Next origin, then this rewrite forwards them to
+ * the mock at `127.0.0.1:8787`.
+ *
+ * In production, point `NEXT_PUBLIC_CIMPLIFY_API_URL` at your Cimplify
+ * host and the rewrite continues to work the same way (or remove it and
+ * pass the absolute URL through `<CimplifyProvider/>`).
+ */
+const nextConfig: NextConfig = {
+  // Enable Next 16's `cacheComponents` mode so we can use `'use cache'` +
+  // `cacheTag` / `cacheLife` for SSR caching. Cached chrome streams first,
+  // dynamic Suspense boundaries fill in when ready.
+  cacheComponents: true,
+  async rewrites() {
+    return [
+      { source: "/api/v1/:path*", destination: `${MOCK_URL}/api/v1/:path*` },
+      { source: "/img/:path*", destination: `${MOCK_URL}/img/:path*` },
+      { source: "/elements/:path*", destination: `${MOCK_URL}/elements/:path*` },
+      { source: "/_mock/:path*", destination: `${MOCK_URL}/_mock/:path*` },
+    ];
+  },
+  images: {
+    remotePatterns: [
+      { protocol: "http", hostname: "127.0.0.1", port: "8787", pathname: "/img/**" },
+      { protocol: "http", hostname: "localhost", port: "8787", pathname: "/img/**" },
+      { protocol: "http", hostname: "localhost", port: "3000", pathname: "/img/**" },
+      { protocol: "https", hostname: "loremflickr.com", pathname: "/**" },
+      { protocol: "https", hostname: "images.unsplash.com", pathname: "/**" },
+    ],
+  },
+};
+
+export default nextConfig;

package/templates/storefront-retail/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "__STOREFRONT_NAME__",
+  "private": true,
+  "version": "0.0.0",
+  "scripts": {
+    "dev": "concurrently -k -n mock,next -c blue,magenta \"bunx @cimplify/sdk --seed retail --quiet\" \"next dev\"",
+    "dev:storefront": "next dev",
+    "dev:mock": "bunx @cimplify/sdk --seed retail",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@cimplify/sdk": "^0.39.1",
+    "next": "^16.2.4",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.2.4",
+    "@types/node": "^22.10.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "concurrently": "^9.0.0",
+    "tailwindcss": "^4.2.4",
+    "typescript": "^5.9.3"
+  }
+}

package/templates/storefront-retail/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/templates/storefront-retail/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", ".next/dev/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/storefront/lib/server-client.ts

@@ -1,27 +0,0 @@
-import { createCimplifyClient, type CimplifyClient } from "@cimplify/sdk";
-
-/**
- * Server-side Cimplify client. Used by Server Components to fetch catalogue
- * data during SSR/RSC for SEO-friendly product/category/collection pages.
- *
- * Cached per-request via React's cache mechanism — calling this multiple
- * times within the same request returns the same client instance.
- *
- * Base-URL resolution:
- *   1) NEXT_PUBLIC_CIMPLIFY_API_URL (matches the client-side default)
- *   2) http://127.0.0.1:8787 — the local mock during dev
- */
-let cached: CimplifyClient | undefined;
-
-export function getServerClient(): CimplifyClient {
-  if (cached) return cached;
-  const baseUrl =
-    process.env.NEXT_PUBLIC_CIMPLIFY_API_URL?.trim() || "http://127.0.0.1:8787";
-  const publicKey = process.env.NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY ?? "mock-dev";
-  cached = createCimplifyClient({
-    baseUrl,
-    publicKey,
-    suppressPublicKeyWarning: true,
-  });
-  return cached;
-}