@cimplify/sdk 0.40.1 → 0.41.0

package/templates/storefront-services/lib/brand.ts

@@ -0,0 +1,303 @@
+/**
+ * Brand & content configuration — single source of truth for every visible
+ * string. Edit this file to rebrand. See ../AGENTS.md.
+ */
+
+export interface BrandSocial {
+  label: string;
+  href: string;
+  icon?: "instagram" | "x" | "tiktok" | "facebook" | "youtube" | "linkedin" | "whatsapp";
+}
+
+export interface BrandFaqEntry { q: string; a: string }
+export interface BrandFaqSection { title: string; items: BrandFaqEntry[] }
+export interface BrandPolicySection {
+  heading: string;
+  body: string | { intro: string; bullets: string[] };
+}
+export interface BrandSitemapSection { title: string; links: { label: string; href: string }[] }
+
+export interface Brand {
+  name: string; shortName: string; microTag: string; description: string;
+  schemaType:
+    | "Store" | "Bakery" | "Restaurant" | "BeautySalon"
+    | "GroceryStore" | "LocalBusiness" | "Organization";
+  currency: string; locale: string;
+  contact: {
+    address: string; streetAddress: string; city: string; countryCode: string;
+    phone: string; phoneTel: string; email: string; privacyEmail: string;
+    supportEmail?: string; businessEmail?: string; hours: string;
+  };
+  socials: BrandSocial[];
+  header: { nav: { label: string; href: string }[] };
+  hero: {
+    badge: string; title: string; subtitle: string;
+    primaryCtaLabel: string;
+    secondaryCtaLabel?: string; secondaryCtaHref?: string;
+  };
+  trustItems?: { label: string; value: string; description: string; iconKey: string }[];
+  brandStrip?: { headline: string; brands: string[] };
+  promo?: { badge: string; title: string; body: string; ctaLabel: string; ctaHref: string };
+  tradeIn?: {
+    eyebrow: string; title: string; body: string;
+    primaryCtaLabel: string; primaryCtaHref: string;
+    secondaryCtaLabel: string; secondaryCtaHref: string;
+    steps: { step: string; title: string; body: string }[];
+  };
+  newsletter: {
+    eyebrow: string; title: string; body: string; placeholder: string;
+    submitLabel: string; successLabel: string;
+  };
+  about: {
+    eyebrow: string; title: string; paragraphs: string[];
+    sections: { heading: string; body: string }[];
+  };
+  faq: {
+    eyebrow: string; title: string; sections: BrandFaqSection[];
+    contactPrompt: string; contactEmail: string;
+  };
+  terms: { eyebrow: string; title: string; lastUpdated: string; sections: BrandPolicySection[] };
+  privacy: { eyebrow: string; title: string; lastUpdated: string; sections: BrandPolicySection[] };
+  footer: {
+    blurb: string; sitemap: BrandSitemapSection[];
+    poweredBy?: { label: string; href: string };
+  };
+  llms: { summary: string };
+  mock: { seed: string; businessId: string };
+}
+
+export const brand: Brand = {
+  name: "Serene Spa",
+  shortName: "Serene",
+  microTag: "STUDIO · ACCRA",
+  description:
+    "Massage, facials, hands & feet — by appointment in Cantonments. Calm, considered, by people who trust touch.",
+  schemaType: "BeautySalon",
+
+  currency: "GHS",
+  locale: "en_GH",
+
+  contact: {
+    address: "5 Ebony Close, Cantonments, Accra",
+    streetAddress: "5 Ebony Close, Cantonments",
+    city: "Accra",
+    countryCode: "GH",
+    phone: "+233 244 777 222",
+    phoneTel: "+233244777222",
+    email: "hello@serenespa.test",
+    privacyEmail: "privacy@serenespa.test",
+    hours: "Tue–Sun · 10am–8pm · closed Mondays",
+  },
+
+  socials: [
+    { label: "Instagram", href: "https://instagram.com/serenespa", icon: "instagram" },
+    { label: "Facebook", href: "https://facebook.com/serenespa", icon: "facebook" },
+    { label: "WhatsApp", href: "https://wa.me/233244777222", icon: "whatsapp" },
+  ],
+
+  header: {
+    nav: [
+      { label: "Treatments", href: "/shop" },
+      { label: "Memberships", href: "/categories/memberships" },
+      { label: "About", href: "/about" },
+      { label: "FAQ", href: "/faq" },
+    ],
+  },
+
+  hero: {
+    badge: "Now booking · April",
+    title: "Slow down.\nLet us take care.",
+    subtitle:
+      "A small studio in Cantonments. Massage, facials, hands and feet — by qualified, kind hands. Couples rooms, infrared sauna, and herbal tea on arrival.",
+    primaryCtaLabel: "Book a treatment",
+    secondaryCtaLabel: "See the menu",
+    secondaryCtaHref: "/shop",
+  },
+
+  trustItems: [
+    {
+      label: "Studio",
+      value: "Six private rooms",
+      description: "Two couples rooms, four singles. All en-suite.",
+      iconKey: "verified",
+    },
+    {
+      label: "Therapists",
+      value: "8 certified practitioners",
+      description: "Average 12 years' practice, all ITEC-trained.",
+      iconKey: "support",
+    },
+    {
+      label: "Members",
+      value: "20% off · always",
+      description: "Monthly membership with two treatments included.",
+      iconKey: "warranty",
+    },
+    {
+      label: "Booking",
+      value: "Same-week availability",
+      description: "Free cancellation up to 24 hours.",
+      iconKey: "delivery",
+    },
+  ],
+
+  promo: {
+    badge: "April only",
+    title: "The Reset Package — 90 minutes for two.",
+    body: "Couples massage, infrared sauna, fresh juice, and a debrief. GH₵850 for two when booked together. Through April.",
+    ctaLabel: "Reserve the Reset",
+    ctaHref: "/shop",
+  },
+
+  newsletter: {
+    eyebrow: "Quiet list",
+    title: "A short note, once a month.",
+    body: "Seasonal treatments, new therapists, and the discount codes worth knowing about. We don't email more than monthly. Unsubscribe in one click.",
+    placeholder: "you@email.com",
+    submitLabel: "Stay in touch",
+    successLabel: "On the list ✓",
+  },
+
+  about: {
+    eyebrow: "About Serene",
+    title: "A studio, not a chain.",
+    paragraphs: [
+      "Serene opened in 2020 above a flower shop on Ebony Close. Eight therapists, six rooms, and a quiet rule: no upselling, no time pressure, no two-treatment minimums. You book what you need; we bring the same care to a 30-minute scalp massage as to a 3-hour reset.",
+      "Every therapist is ITEC-trained or holds an equivalent international certification. Several are massage specialists with 15+ years of practice — including post-natal, deep-tissue, and oncology-cleared work.",
+      "We use locally-sourced shea, baobab, and coconut bases — pressed in Tamale, blended with essential oils we choose ourselves. No hidden synthetic fragrances, ever.",
+    ],
+    sections: [
+      {
+        heading: "Memberships",
+        body: "Monthly members get 20% off everything, two treatments included, and priority booking. Pause any month, no questions.",
+      },
+      {
+        heading: "Gift cards",
+        body: "Available in any amount. Delivered instantly by email — printable, redeemable in person or online, with no expiry.",
+      },
+      {
+        heading: "Visit",
+        body: "5 Ebony Close, Cantonments · Tue–Sun, 10am–8pm. Mondays the studio rests.",
+      },
+    ],
+  },
+
+  faq: {
+    eyebrow: "Q&A",
+    title: "What to expect.",
+    sections: [
+      {
+        title: "Booking & arrival",
+        items: [
+          { q: "How do I book?", a: "Online via the Treatments menu, or send a WhatsApp to +233 244 777 222. Most slots are bookable same-week." },
+          { q: "What's your cancellation policy?", a: "Free cancellation up to 24 hours before your appointment. Within 24 hours we charge 50% of the treatment cost." },
+          { q: "When should I arrive?", a: "10 minutes early on your first visit (a brief intake form), 5 minutes for return visits." },
+          { q: "Can I bring a guest?", a: "Couples rooms accommodate two. For solo bookings, guests are welcome to wait in our garden lounge." },
+        ],
+      },
+      {
+        title: "Treatments",
+        items: [
+          { q: "What if I have a medical condition?", a: "Tell us at booking. Some treatments — deep-tissue, hot stone, certain pressure points — aren't suitable during pregnancy, post-surgery, or with specific conditions. Our therapists will adjust or recommend alternatives." },
+          { q: "Are your products allergen-free?", a: "Our base oils are shea, baobab, and coconut — locally pressed. Essential oils we use are listed on the product page; flag any allergies at booking." },
+          { q: "Is tipping expected?", a: "Not expected, always appreciated. Cash or via the kiosk after your treatment." },
+        ],
+      },
+      {
+        title: "Memberships",
+        items: [
+          { q: "How does membership work?", a: "GH₵400/month. Includes two 60-minute treatments per month, 20% off everything else, priority booking, and bring-a-guest credits." },
+          { q: "Can I pause it?", a: "Any month, anytime. Email or message us before the next billing date." },
+          { q: "Do treatments roll over?", a: "Up to one treatment, for up to 60 days." },
+        ],
+      },
+    ],
+    contactPrompt: "Other questions? Message us:",
+    contactEmail: "hello@serenespa.test",
+  },
+
+  terms: {
+    eyebrow: "Terms of service",
+    title: "Terms of Service",
+    lastUpdated: "1 May 2026",
+    sections: [
+      { heading: "1. Who we are", body: "Serene Spa (\"we\", \"us\") is a wellness studio at 5 Ebony Close, Cantonments, Accra. By booking a treatment you (\"you\", \"client\") agree to these terms." },
+      { heading: "2. Bookings", body: "Slot is held when payment is received (full or 50% deposit). Confirmation by email and SMS." },
+      { heading: "3. Cancellations", body: "Free cancellation up to 24 hours before your appointment. Within 24 hours, 50% of the treatment cost is charged." },
+      { heading: "4. Late arrival", body: "Treatments end at the scheduled time. Late arrival shortens the treatment, not the cost." },
+      { heading: "5. Health & contraindications", body: "You're responsible for declaring relevant medical conditions, allergies, and medications. We may decline or adjust treatment in the interest of your safety." },
+      { heading: "6. Memberships", body: "Monthly subscriptions auto-renew. Pause or cancel any month before the next billing date." },
+      { heading: "7. Liability", body: "Maximum liability for any session is the price of that session. We're not liable for items left in the studio." },
+      { heading: "8. Governing law", body: "These terms are governed by the laws of Ghana." },
+    ],
+  },
+
+  privacy: {
+    eyebrow: "Privacy",
+    title: "Privacy Policy",
+    lastUpdated: "1 May 2026",
+    sections: [
+      { heading: "What we collect", body: "Booking details (name, phone, email, treatment, time slot), the intake form for health-relevant context, and payment data via our processors. We do not store payment cards." },
+      { heading: "How we use it", body: { intro: "We use your data to:", bullets: [
+        "Confirm and run your appointments.",
+        "Adapt treatments to your stated conditions and preferences.",
+        "Send appointment reminders by SMS.",
+        "Send our monthly note (only if you opted in).",
+      ] } },
+      { heading: "Health data", body: "Intake-form information is treated as sensitive. Only the therapist scheduled to see you accesses it; we never share with third parties." },
+      { heading: "Who we share it with", body: "Payment processors (Paystack, Stripe), our SMS provider for reminders. No one else." },
+      { heading: "Your rights", body: "Under the Ghana Data Protection Act, 2012 (Act 843), you can access, correct, or delete your data. Email privacy@serenespa.test." },
+      { heading: "Retention", body: "Booking records: 7 years (tax). Intake forms: 3 years from your last visit." },
+    ],
+  },
+
+  footer: {
+    blurb:
+      "A small spa in Cantonments. Massage, facials, hands & feet — by qualified, kind therapists.",
+    sitemap: [
+      {
+        title: "Visit",
+        links: [
+          { label: "Treatments", href: "/shop" },
+          { label: "Memberships", href: "/categories/memberships" },
+          { label: "Gift cards", href: "/about" },
+          { label: "Couples", href: "/about" },
+        ],
+      },
+      {
+        title: "Studio",
+        links: [
+          { label: "About", href: "/about" },
+          { label: "Therapists", href: "/about" },
+          { label: "Press", href: "mailto:press@serenespa.test" },
+        ],
+      },
+      {
+        title: "Help",
+        links: [
+          { label: "Contact", href: "mailto:hello@serenespa.test" },
+          { label: "FAQ", href: "/faq" },
+          { label: "Cancellation policy", href: "/faq" },
+        ],
+      },
+      {
+        title: "Legal",
+        links: [
+          { label: "Terms of Service", href: "/terms" },
+          { label: "Privacy Policy", href: "/privacy" },
+        ],
+      },
+    ],
+    poweredBy: { label: "Cimplify", href: "https://app.cimplify.io" },
+  },
+
+  llms: {
+    summary:
+      "Serene Spa — small wellness studio in Cantonments, Accra. Massage, facials, hands and feet by appointment. Couples rooms, infrared sauna, monthly membership. Booking via website or WhatsApp.",
+  },
+
+  mock: {
+    seed: "services",
+    businessId: "bus_serene_spa",
+  },
+};

package/templates/storefront-services/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-services/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-services/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 services --quiet\" \"next dev\"",
+    "dev:storefront": "next dev",
+    "dev:mock": "bunx @cimplify/sdk --seed services",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@cimplify/sdk": "^0.40.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-services/postcss.config.mjs

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

package/templates/storefront-services/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"]
+}