@cimplify/sdk 0.48.2 → 0.49.0

package/dist/server.mjs

@@ -39,7 +39,19 @@ var tags = {
   collection: (id) => `cimplify:collection:${id}`,
   collectionProducts: (id) => `cimplify:collection:${id}:products`,
   business: () => "cimplify:business",
+  brand: () => "cimplify:brand",
   locations: () => "cimplify:locations",
+  location: (id) => `cimplify:location:${id}`,
+  locale: () => "cimplify:locale",
+  pricing: () => "cimplify:pricing",
+  // Product-level tag (e.g. "vegan", "bestseller"), not "cache tag".
+  tag: (name) => `cimplify:tag:${name}`,
+  addons: () => "cimplify:addons",
+  addon: (id) => `cimplify:addon:${id}`,
+  subscriptions: () => "cimplify:subscriptions",
+  subscription: (id) => `cimplify:subscription:${id}`,
+  stock: () => "cimplify:stock",
+  stockFor: (productId) => `cimplify:stock:${productId}`,
   orders: (customerId) => `cimplify:orders:${customerId}`,
   order: (id) => `cimplify:order:${id}`
 };
@@ -86,8 +98,111 @@ async function revalidateCollection(id) {
 async function revalidateBusiness() {
   return revalidate(tags.business());
 }
+async function revalidateBrand() {
+  return revalidate(tags.brand());
+}
+async function revalidateLocations() {
+  return revalidate(tags.locations());
+}
+async function revalidateLocation(id) {
+  return revalidate(tags.location(id), tags.locations());
+}
+async function revalidatePricing() {
+  return revalidate(tags.pricing(), tags.products());
+}
+async function revalidateAddOns() {
+  return revalidate(tags.addons());
+}
+async function revalidateAddOn(id) {
+  return revalidate(tags.addon(id), tags.addons());
+}
+async function revalidateSubscriptions() {
+  return revalidate(tags.subscriptions());
+}
+async function revalidateSubscription(id) {
+  return revalidate(tags.subscription(id), tags.subscriptions());
+}
+async function revalidateStock(productId) {
+  return productId ? revalidate(tags.stockFor(productId), tags.stock()) : revalidate(tags.stock());
+}
 async function revalidateByTag(tag) {
   return revalidate(tag);
 }
 
-export { getServerClient, revalidateBusiness, revalidateByTag, revalidateCategories, revalidateCategory, revalidateCollection, revalidateCollections, revalidateProduct, revalidateProducts, tags };
+// src/server/revalidate-route.ts
+var TIMESTAMP_HEADER = "x-cimplify-timestamp";
+var SIGNATURE_HEADER = "x-cimplify-signature";
+var SIGNATURE_PREFIX = "sha256=";
+var MAX_SKEW_MS = 5 * 60 * 1e3;
+var SECRET_ENV = "CIMPLIFY_REVALIDATE_SECRET";
+async function revalidateRouteHandler(req, options = {}) {
+  const secret = options.secret ?? envSecret();
+  if (!secret) return text(`revalidate disabled: ${SECRET_ENV} not set`, 500);
+  const timestamp = req.headers.get(TIMESTAMP_HEADER);
+  const signature = req.headers.get(SIGNATURE_HEADER);
+  if (!timestamp || !signature) return text("missing auth headers", 401);
+  const ts = Number.parseInt(timestamp, 10);
+  const now = options.now ?? Date.now;
+  if (!Number.isFinite(ts) || Math.abs(now() - ts) > MAX_SKEW_MS) {
+    return text("stale or invalid timestamp", 401);
+  }
+  const body = await req.text();
+  if (!await verifyHmac(secret, `${timestamp}.${body}`, signature)) {
+    return text("invalid signature", 401);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(body);
+  } catch {
+    return text("invalid json", 400);
+  }
+  const tags2 = Array.isArray(parsed.tags) ? parsed.tags.filter((t) => typeof t === "string" && t.length > 0) : [];
+  if (tags2.length === 0) return text("no tags", 400);
+  const revalidate2 = options.revalidateTag ?? await loadRevalidateTag();
+  for (const tag of tags2) revalidate2(tag);
+  return Response.json({ ok: true, revalidated: tags2.length });
+}
+var cachedRevalidateTag = null;
+async function loadRevalidateTag() {
+  if (cachedRevalidateTag) return cachedRevalidateTag;
+  const specifier = "next/cache";
+  const mod = await import(
+    /* webpackIgnore: true */
+    /* @vite-ignore */
+    specifier
+  );
+  cachedRevalidateTag = mod.revalidateTag;
+  return cachedRevalidateTag;
+}
+async function verifyHmac(secret, payload, signatureHeader) {
+  if (!signatureHeader.startsWith(SIGNATURE_PREFIX)) return false;
+  const providedBytes = hexToBytes(signatureHeader.slice(SIGNATURE_PREFIX.length));
+  if (!providedBytes) return false;
+  const enc = new TextEncoder();
+  const key = await crypto.subtle.importKey(
+    "raw",
+    enc.encode(secret),
+    { name: "HMAC", hash: "SHA-256" },
+    false,
+    ["verify"]
+  );
+  return crypto.subtle.verify("HMAC", key, providedBytes, enc.encode(payload));
+}
+function hexToBytes(hex) {
+  if (hex.length % 2 !== 0 || !/^[0-9a-f]+$/i.test(hex)) return null;
+  const buf = new ArrayBuffer(hex.length / 2);
+  const out = new Uint8Array(buf);
+  for (let i = 0; i < hex.length; i += 2) {
+    out[i / 2] = Number.parseInt(hex.slice(i, i + 2), 16);
+  }
+  return out;
+}
+function envSecret() {
+  const proc = globalThis.process;
+  return proc?.env?.[SECRET_ENV];
+}
+function text(message, status) {
+  return new Response(message, { status, headers: { "content-type": "text/plain" } });
+}
+
+export { getServerClient, revalidateAddOn, revalidateAddOns, revalidateBrand, revalidateBusiness, revalidateByTag, revalidateCategories, revalidateCategory, revalidateCollection, revalidateCollections, revalidateLocation, revalidateLocations, revalidatePricing, revalidateProduct, revalidateProducts, revalidateRouteHandler, revalidateStock, revalidateSubscription, revalidateSubscriptions, tags };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cimplify/sdk",
-  "version": "0.48.2",
+  "version": "0.49.0",
   "description": "Cimplify Commerce SDK for storefronts",
   "keywords": [
     "cimplify",

package/registry/index.json

@@ -71,6 +71,30 @@
       "type": "component",
       "registryDependencies": []
     },
+    {
+      "name": "store-video",
+      "title": "StoreVideo",
+      "description": "Autoplay-muted-loop video for storefront heroes / product demos. Lazy-loaded, mobile-safe (playsInline), poster fallback for browsers without video.",
+      "type": "component",
+      "registryDependencies": []
+    },
+    {
+      "name": "product-model-3d",
+      "title": "ProductModel3D",
+      "description": "Interactive 3D product viewer wrapping Google's <model-viewer>. Loads the web component on demand; AR mode lights up on iOS (Quick Look) and Android (Scene Viewer) automatically.",
+      "type": "component",
+      "registryDependencies": []
+    },
+    {
+      "name": "media-gallery",
+      "title": "MediaGallery",
+      "description": "Like ProductImageGallery but accepts mixed image/video/3D items in one carousel. Thumbnails show a poster + small overlay icon for video/3D.",
+      "type": "component",
+      "registryDependencies": [
+        "store-video",
+        "product-model-3d"
+      ]
+    },
     {
       "name": "cart-summary",
       "title": "CartSummary",

package/registry/media-gallery.json

@@ -0,0 +1,16 @@
+{
+  "name": "media-gallery",
+  "title": "MediaGallery",
+  "description": "Like ProductImageGallery but accepts mixed image/video/3D items in one carousel. Thumbnails show a poster + small overlay icon for video/3D.",
+  "type": "component",
+  "registryDependencies": [
+    "store-video",
+    "product-model-3d"
+  ],
+  "files": [
+    {
+      "path": "media-gallery.tsx",
+      "content": "\"use client\";\n\nimport React, { useEffect, useMemo, useState } from \"react\";\nimport { RadioGroup } from \"@base-ui/react/radio-group\";\nimport { Radio } from \"@base-ui/react/radio\";\nimport { StoreVideo } from \"@cimplify/sdk/react\";\nimport { ProductModel3D } from \"@cimplify/sdk/react\";\n\nexport type MediaItem =\n  | { type: \"image\"; src: string; alt?: string }\n  | { type: \"video\"; src: string; poster?: string; alt?: string }\n  | { type: \"model\"; src: string; iosSrc?: string; poster?: string; alt?: string };\n\nexport interface MediaGalleryProps {\n  items: MediaItem[];\n  productName: string;\n  aspectRatio?: \"square\" | \"4/3\" | \"16/10\" | \"3/4\";\n  className?: string;\n}\n\nconst ASPECT_STYLES: Record<string, React.CSSProperties> = {\n  square: { aspectRatio: \"1/1\" },\n  \"4/3\": { aspectRatio: \"4/3\" },\n  \"16/10\": { aspectRatio: \"16/10\" },\n  \"3/4\": { aspectRatio: \"3/4\" },\n};\n\nfunction thumbnailFor(item: MediaItem): string | null {\n  if (item.type === \"image\") return item.src;\n  return item.poster ?? null;\n}\n\nfunction thumbIcon(item: MediaItem): string | null {\n  if (item.type === \"video\") return \"▶\";\n  if (item.type === \"model\") return \"◆\";\n  return null;\n}\n\n/**\n * MediaGallery — like ProductImageGallery, but accepts mixed image/video/3D\n * items in one carousel. The active item renders via the matching SDK\n * component (img / StoreVideo / ProductModel3D); thumbnails show a poster\n * (or the image itself) with a small overlay icon for video/3D.\n */\nexport function MediaGallery({\n  items,\n  productName,\n  aspectRatio = \"4/3\",\n  className,\n}: MediaGalleryProps): React.ReactElement | null {\n  const validItems = useMemo(\n    () => items.filter((i) => typeof i.src === \"string\" && i.src.trim().length > 0),\n    [items],\n  );\n\n  const [selected, setSelected] = useState(0);\n\n  useEffect(() => {\n    setSelected(0);\n  }, [validItems.length, productName]);\n\n  if (validItems.length === 0) return null;\n\n  const active = validItems[selected] ?? validItems[0];\n\n  return (\n    <div data-cimplify-media-gallery className={className}>\n      <div\n        data-cimplify-media-gallery-main\n        style={{ position: \"relative\", overflow: \"hidden\", ...ASPECT_STYLES[aspectRatio] }}\n      >\n        {active.type === \"image\" ? (\n          <img\n            src={active.src}\n            alt={active.alt ?? productName}\n            style={{ width: \"100%\", height: \"100%\", objectFit: \"cover\" }}\n            data-cimplify-media-gallery-active\n          />\n        ) : active.type === \"video\" ? (\n          <StoreVideo\n            src={active.src}\n            poster={active.poster}\n            alt={active.alt ?? productName}\n            aspectRatio=\"square\"\n            lazy={false}\n          />\n        ) : (\n          <ProductModel3D\n            src={active.src}\n            iosSrc={active.iosSrc}\n            poster={active.poster}\n            alt={active.alt ?? productName}\n            aspectRatio=\"square\"\n          />\n        )}\n      </div>\n\n      {validItems.length > 1 && (\n        <RadioGroup\n          aria-label={`${productName} media thumbnails`}\n          value={String(selected)}\n          onValueChange={(v) => setSelected(Number(v))}\n          data-cimplify-media-gallery-thumbnails\n          style={{ display: \"flex\", gap: \"0.5rem\", marginTop: \"0.75rem\" }}\n        >\n          {validItems.map((item, index) => {\n            const thumb = thumbnailFor(item);\n            const icon = thumbIcon(item);\n            const isSelected = selected === index;\n            return (\n              <Radio.Root\n                key={`${item.src}-${index}`}\n                value={String(index)}\n                data-cimplify-media-gallery-thumb\n                data-selected={isSelected || undefined}\n                data-type={item.type}\n                style={{\n                  position: \"relative\",\n                  width: \"4rem\",\n                  height: \"4rem\",\n                  overflow: \"hidden\",\n                  padding: 0,\n                  border: \"none\",\n                  cursor: \"pointer\",\n                  backgroundColor: \"var(--muted, #f3f4f6)\",\n                }}\n              >\n                {thumb ? (\n                  <img\n                    src={thumb}\n                    alt=\"\"\n                    style={{ width: \"100%\", height: \"100%\", objectFit: \"cover\" }}\n                  />\n                ) : null}\n                {icon ? (\n                  <span\n                    aria-hidden\n                    style={{\n                      position: \"absolute\",\n                      inset: 0,\n                      display: \"flex\",\n                      alignItems: \"center\",\n                      justifyContent: \"center\",\n                      color: \"white\",\n                      fontSize: \"0.875rem\",\n                      textShadow: \"0 1px 2px rgba(0,0,0,0.6)\",\n                      pointerEvents: \"none\",\n                    }}\n                  >\n                    {icon}\n                  </span>\n                ) : null}\n              </Radio.Root>\n            );\n          })}\n        </RadioGroup>\n      )}\n    </div>\n  );\n}\n"
+    }
+  ]
+}

package/registry/product-model-3d.json

@@ -0,0 +1,13 @@
+{
+  "name": "product-model-3d",
+  "title": "ProductModel3D",
+  "description": "Interactive 3D product viewer wrapping Google's <model-viewer>. Loads the web component on demand; AR mode lights up on iOS (Quick Look) and Android (Scene Viewer) automatically.",
+  "type": "component",
+  "registryDependencies": [],
+  "files": [
+    {
+      "path": "product-model-3d.tsx",
+      "content": "\"use client\";\n\nimport React, { useEffect, useState } from \"react\";\n\nexport interface ProductModel3DProps {\n  /** glTF or GLB URL. */\n  src: string;\n  /** Optional USDZ URL for iOS AR Quick Look (Safari/WebKit). */\n  iosSrc?: string;\n  /** Poster image shown while the model loads (and as a fallback). */\n  poster?: string;\n  alt?: string;\n  aspectRatio?: \"square\" | \"4/3\" | \"16/9\" | \"3/4\";\n  /** Enable AR mode. Lights up on iOS (Quick Look) + Android (Scene Viewer). Default `true`. */\n  ar?: boolean;\n  autoRotate?: boolean;\n  cameraControls?: boolean;\n  className?: string;\n}\n\nconst ASPECT_STYLES: Record<string, React.CSSProperties> = {\n  square: { aspectRatio: \"1/1\" },\n  \"4/3\": { aspectRatio: \"4/3\" },\n  \"16/9\": { aspectRatio: \"16/9\" },\n  \"3/4\": { aspectRatio: \"3/4\" },\n};\n\nconst MODEL_VIEWER_CDN =\n  \"https://unpkg.com/@google/model-viewer@4.0.0/dist/model-viewer.min.js\";\n\n// Module-level cache so multiple <ProductModel3D> instances share one script load.\nlet modelViewerLoadPromise: Promise<void> | null = null;\nfunction ensureModelViewer(): Promise<void> {\n  if (typeof window === \"undefined\") return Promise.resolve();\n  if (modelViewerLoadPromise) return modelViewerLoadPromise;\n  if (window.customElements?.get(\"model-viewer\")) {\n    modelViewerLoadPromise = Promise.resolve();\n    return modelViewerLoadPromise;\n  }\n  modelViewerLoadPromise = new Promise<void>((resolve, reject) => {\n    const script = document.createElement(\"script\");\n    script.type = \"module\";\n    script.src = MODEL_VIEWER_CDN;\n    script.onload = () => resolve();\n    script.onerror = () => reject(new Error(\"Failed to load model-viewer\"));\n    document.head.appendChild(script);\n  });\n  return modelViewerLoadPromise;\n}\n\n/**\n * ProductModel3D — interactive 3D product viewer wrapping Google's\n * `<model-viewer>` web component. Script loads on demand (one tag per page,\n * cached). AR mode auto-resolves the right OS surface: USDZ Quick Look on iOS,\n * Scene Viewer on Android, WebXR where available. Poster image shows during\n * load and as a fallback if the script can't load.\n */\nexport function ProductModel3D({\n  src,\n  iosSrc,\n  poster,\n  alt,\n  aspectRatio = \"square\",\n  ar = true,\n  autoRotate = true,\n  cameraControls = true,\n  className,\n}: ProductModel3DProps): React.ReactElement {\n  const [ready, setReady] = useState(false);\n\n  useEffect(() => {\n    let cancelled = false;\n    ensureModelViewer().then(\n      () => {\n        if (!cancelled) setReady(true);\n      },\n      () => {\n        // Stay on the poster fallback if the CDN script fails.\n      },\n    );\n    return () => {\n      cancelled = true;\n    };\n  }, []);\n\n  return (\n    <div\n      data-cimplify-product-model-3d\n      className={className}\n      style={{ position: \"relative\", overflow: \"hidden\", ...ASPECT_STYLES[aspectRatio] }}\n    >\n      {ready\n        ? React.createElement(\"model-viewer\", {\n            src,\n            \"ios-src\": iosSrc,\n            alt,\n            poster,\n            ar: ar || undefined,\n            \"ar-modes\": ar ? \"webxr scene-viewer quick-look\" : undefined,\n            \"camera-controls\": cameraControls || undefined,\n            \"auto-rotate\": autoRotate || undefined,\n            \"shadow-intensity\": \"1\",\n            style: { width: \"100%\", height: \"100%\", backgroundColor: \"transparent\" },\n          })\n        : poster\n          ? React.createElement(\"img\", {\n              src: poster,\n              alt: alt ?? \"\",\n              \"data-cimplify-product-model-3d-loading\": true,\n              style: { width: \"100%\", height: \"100%\", objectFit: \"cover\" },\n            })\n          : React.createElement(\"div\", {\n              \"data-cimplify-product-model-3d-loading\": true,\n              style: { width: \"100%\", height: \"100%\", backgroundColor: \"var(--muted, #f3f4f6)\" },\n            })}\n    </div>\n  );\n}\n"
+    }
+  ]
+}

package/registry/store-video.json

@@ -0,0 +1,13 @@
+{
+  "name": "store-video",
+  "title": "StoreVideo",
+  "description": "Autoplay-muted-loop video for storefront heroes / product demos. Lazy-loaded, mobile-safe (playsInline), poster fallback for browsers without video.",
+  "type": "component",
+  "registryDependencies": [],
+  "files": [
+    {
+      "path": "store-video.tsx",
+      "content": "\"use client\";\n\nimport React, { useEffect, useRef, useState } from \"react\";\n\nexport interface StoreVideoProps {\n  src: string;\n  /** Poster shown before play + as the fallback if `<video>` isn't supported. */\n  poster?: string;\n  /** Accessible label; also the alt of the fallback `<img>`. */\n  alt?: string;\n  aspectRatio?: \"square\" | \"4/3\" | \"16/9\" | \"16/10\" | \"3/4\";\n  /** Show native browser controls. Default off for autoplay-friendly hero clips. */\n  controls?: boolean;\n  /** Default `true` — muted is the only way mobile browsers allow autoplay. */\n  autoplay?: boolean;\n  loop?: boolean;\n  muted?: boolean;\n  /** Lazy-load: defer the src until the player scrolls into view. Default `true`. */\n  lazy?: boolean;\n  className?: string;\n}\n\nconst ASPECT_STYLES: Record<string, React.CSSProperties> = {\n  square: { aspectRatio: \"1/1\" },\n  \"4/3\": { aspectRatio: \"4/3\" },\n  \"16/9\": { aspectRatio: \"16/9\" },\n  \"16/10\": { aspectRatio: \"16/10\" },\n  \"3/4\": { aspectRatio: \"3/4\" },\n};\n\n/**\n * StoreVideo — `<video>` with mobile-safe defaults (muted + playsInline + loop),\n * IntersectionObserver-driven lazy load, and a poster `<img>` fallback for\n * browsers without video support. Drop-in replacement for a static hero image.\n */\nexport function StoreVideo({\n  src,\n  poster,\n  alt,\n  aspectRatio = \"16/9\",\n  controls = false,\n  autoplay = true,\n  loop = true,\n  muted = true,\n  lazy = true,\n  className,\n}: StoreVideoProps): React.ReactElement {\n  const ref = useRef<HTMLVideoElement>(null);\n  const [inView, setInView] = useState(!lazy);\n\n  useEffect(() => {\n    if (!lazy || inView) return;\n    const node = ref.current;\n    if (!node || typeof IntersectionObserver === \"undefined\") {\n      setInView(true);\n      return;\n    }\n    const observer = new IntersectionObserver(\n      (entries) => {\n        if (entries.some((e) => e.isIntersecting)) {\n          setInView(true);\n          observer.disconnect();\n        }\n      },\n      { rootMargin: \"200px\" },\n    );\n    observer.observe(node);\n    return () => observer.disconnect();\n  }, [lazy, inView]);\n\n  return (\n    <div\n      data-cimplify-store-video\n      className={className}\n      style={{ position: \"relative\", overflow: \"hidden\", ...ASPECT_STYLES[aspectRatio] }}\n    >\n      <video\n        ref={ref}\n        src={inView ? src : undefined}\n        poster={poster}\n        autoPlay={autoplay}\n        loop={loop}\n        muted={muted}\n        playsInline\n        controls={controls}\n        preload={lazy ? \"metadata\" : \"auto\"}\n        aria-label={alt}\n        style={{ width: \"100%\", height: \"100%\", objectFit: \"cover\", display: \"block\" }}\n      >\n        {poster ? (\n          <img\n            src={poster}\n            alt={alt ?? \"\"}\n            style={{ width: \"100%\", height: \"100%\", objectFit: \"cover\" }}\n          />\n        ) : null}\n      </video>\n    </div>\n  );\n}\n"
+    }
+  ]
+}