@cimplify/sdk 0.48.2 → 0.49.1

package/dist/react.mjs

@@ -6975,6 +6975,289 @@ function ProductImageGallery({
     )
   ] });
 }
+var ASPECT_STYLES2 = {
+  square: { aspectRatio: "1/1" },
+  "4/3": { aspectRatio: "4/3" },
+  "16/9": { aspectRatio: "16/9" },
+  "16/10": { aspectRatio: "16/10" },
+  "3/4": { aspectRatio: "3/4" }
+};
+function StoreVideo({
+  src,
+  poster,
+  alt,
+  aspectRatio = "16/9",
+  controls = false,
+  autoplay = true,
+  loop = true,
+  muted = true,
+  lazy = true,
+  className
+}) {
+  const ref = useRef(null);
+  const [inView, setInView] = useState(!lazy);
+  useEffect(() => {
+    if (!lazy || inView) return;
+    const node = ref.current;
+    if (!node || typeof IntersectionObserver === "undefined") {
+      setInView(true);
+      return;
+    }
+    const observer = new IntersectionObserver(
+      (entries) => {
+        if (entries.some((e) => e.isIntersecting)) {
+          setInView(true);
+          observer.disconnect();
+        }
+      },
+      { rootMargin: "200px" }
+    );
+    observer.observe(node);
+    return () => observer.disconnect();
+  }, [lazy, inView]);
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      "data-cimplify-store-video": true,
+      className,
+      style: { position: "relative", overflow: "hidden", ...ASPECT_STYLES2[aspectRatio] },
+      children: /* @__PURE__ */ jsx(
+        "video",
+        {
+          ref,
+          src: inView ? src : void 0,
+          poster,
+          autoPlay: autoplay,
+          loop,
+          muted,
+          playsInline: true,
+          controls,
+          preload: lazy ? "metadata" : "auto",
+          "aria-label": alt,
+          style: { width: "100%", height: "100%", objectFit: "cover", display: "block" },
+          children: poster ? /* @__PURE__ */ jsx(
+            "img",
+            {
+              src: poster,
+              alt: alt ?? "",
+              style: { width: "100%", height: "100%", objectFit: "cover" }
+            }
+          ) : null
+        }
+      )
+    }
+  );
+}
+var ASPECT_STYLES3 = {
+  square: { aspectRatio: "1/1" },
+  "4/3": { aspectRatio: "4/3" },
+  "16/9": { aspectRatio: "16/9" },
+  "3/4": { aspectRatio: "3/4" }
+};
+var MODEL_VIEWER_CDN = "https://unpkg.com/@google/model-viewer@4.0.0/dist/model-viewer.min.js";
+var modelViewerLoadPromise = null;
+function ensureModelViewer() {
+  if (typeof window === "undefined") return Promise.resolve();
+  if (modelViewerLoadPromise) return modelViewerLoadPromise;
+  if (window.customElements?.get("model-viewer")) {
+    modelViewerLoadPromise = Promise.resolve();
+    return modelViewerLoadPromise;
+  }
+  modelViewerLoadPromise = new Promise((resolve, reject) => {
+    const script = document.createElement("script");
+    script.type = "module";
+    script.src = MODEL_VIEWER_CDN;
+    script.onload = () => resolve();
+    script.onerror = () => reject(new Error("Failed to load model-viewer"));
+    document.head.appendChild(script);
+  });
+  return modelViewerLoadPromise;
+}
+function ProductModel3D({
+  src,
+  iosSrc,
+  poster,
+  alt,
+  aspectRatio = "square",
+  ar = true,
+  autoRotate = true,
+  cameraControls = true,
+  className
+}) {
+  const [ready, setReady] = useState(false);
+  useEffect(() => {
+    let cancelled = false;
+    ensureModelViewer().then(
+      () => {
+        if (!cancelled) setReady(true);
+      },
+      () => {
+      }
+    );
+    return () => {
+      cancelled = true;
+    };
+  }, []);
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      "data-cimplify-product-model-3d": true,
+      className,
+      style: { position: "relative", overflow: "hidden", ...ASPECT_STYLES3[aspectRatio] },
+      children: ready ? React10.createElement("model-viewer", {
+        src,
+        "ios-src": iosSrc,
+        alt,
+        poster,
+        ar: ar || void 0,
+        "ar-modes": ar ? "webxr scene-viewer quick-look" : void 0,
+        "camera-controls": cameraControls || void 0,
+        "auto-rotate": autoRotate || void 0,
+        "shadow-intensity": "1",
+        style: { width: "100%", height: "100%", backgroundColor: "transparent" }
+      }) : poster ? React10.createElement("img", {
+        src: poster,
+        alt: alt ?? "",
+        "data-cimplify-product-model-3d-loading": true,
+        style: { width: "100%", height: "100%", objectFit: "cover" }
+      }) : React10.createElement("div", {
+        "data-cimplify-product-model-3d-loading": true,
+        style: { width: "100%", height: "100%", backgroundColor: "var(--muted, #f3f4f6)" }
+      })
+    }
+  );
+}
+var ASPECT_STYLES4 = {
+  square: { aspectRatio: "1/1" },
+  "4/3": { aspectRatio: "4/3" },
+  "16/10": { aspectRatio: "16/10" },
+  "3/4": { aspectRatio: "3/4" }
+};
+function thumbnailFor(item) {
+  if (item.type === "image") return item.src;
+  return item.poster ?? null;
+}
+function thumbIcon(item) {
+  if (item.type === "video") return "\u25B6";
+  if (item.type === "model") return "\u25C6";
+  return null;
+}
+function MediaGallery({
+  items,
+  productName,
+  aspectRatio = "4/3",
+  className
+}) {
+  const validItems = useMemo(
+    () => items.filter((i) => typeof i.src === "string" && i.src.trim().length > 0),
+    [items]
+  );
+  const [selected, setSelected] = useState(0);
+  useEffect(() => {
+    setSelected(0);
+  }, [validItems.length, productName]);
+  if (validItems.length === 0) return null;
+  const active = validItems[selected] ?? validItems[0];
+  return /* @__PURE__ */ jsxs("div", { "data-cimplify-media-gallery": true, className, children: [
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        "data-cimplify-media-gallery-main": true,
+        style: { position: "relative", overflow: "hidden", ...ASPECT_STYLES4[aspectRatio] },
+        children: active.type === "image" ? /* @__PURE__ */ jsx(
+          "img",
+          {
+            src: active.src,
+            alt: active.alt ?? productName,
+            style: { width: "100%", height: "100%", objectFit: "cover" },
+            "data-cimplify-media-gallery-active": true
+          }
+        ) : active.type === "video" ? /* @__PURE__ */ jsx(
+          StoreVideo,
+          {
+            src: active.src,
+            poster: active.poster,
+            alt: active.alt ?? productName,
+            aspectRatio: "square",
+            lazy: false
+          }
+        ) : /* @__PURE__ */ jsx(
+          ProductModel3D,
+          {
+            src: active.src,
+            iosSrc: active.iosSrc,
+            poster: active.poster,
+            alt: active.alt ?? productName,
+            aspectRatio: "square"
+          }
+        )
+      }
+    ),
+    validItems.length > 1 && /* @__PURE__ */ jsx(
+      RadioGroup,
+      {
+        "aria-label": `${productName} media thumbnails`,
+        value: String(selected),
+        onValueChange: (v) => setSelected(Number(v)),
+        "data-cimplify-media-gallery-thumbnails": true,
+        style: { display: "flex", gap: "0.5rem", marginTop: "0.75rem" },
+        children: validItems.map((item, index) => {
+          const thumb = thumbnailFor(item);
+          const icon = thumbIcon(item);
+          const isSelected = selected === index;
+          return /* @__PURE__ */ jsxs(
+            Radio.Root,
+            {
+              value: String(index),
+              "data-cimplify-media-gallery-thumb": true,
+              "data-selected": isSelected || void 0,
+              "data-type": item.type,
+              style: {
+                position: "relative",
+                width: "4rem",
+                height: "4rem",
+                overflow: "hidden",
+                padding: 0,
+                border: "none",
+                cursor: "pointer",
+                backgroundColor: "var(--muted, #f3f4f6)"
+              },
+              children: [
+                thumb ? /* @__PURE__ */ jsx(
+                  "img",
+                  {
+                    src: thumb,
+                    alt: "",
+                    style: { width: "100%", height: "100%", objectFit: "cover" }
+                  }
+                ) : null,
+                icon ? /* @__PURE__ */ jsx(
+                  "span",
+                  {
+                    "aria-hidden": true,
+                    style: {
+                      position: "absolute",
+                      inset: 0,
+                      display: "flex",
+                      alignItems: "center",
+                      justifyContent: "center",
+                      color: "white",
+                      fontSize: "0.875rem",
+                      textShadow: "0 1px 2px rgba(0,0,0,0.6)",
+                      pointerEvents: "none"
+                    },
+                    children: icon
+                  }
+                ) : null
+              ]
+            },
+            `${item.src}-${index}`
+          );
+        })
+      }
+    )
+  ] });
+}
 function CartLineItemRow({
   item,
   onRemove,
@@ -8381,7 +8664,7 @@ var CardVariant = /* @__PURE__ */ ((CardVariant2) => {
   CardVariant2["Subscription"] = "subscription";
   return CardVariant2;
 })(CardVariant || {});
-var ASPECT_STYLES2 = {
+var ASPECT_STYLES5 = {
   square: { aspectRatio: "1/1" },
   "4/3": { aspectRatio: "4/3" },
   "16/10": { aspectRatio: "16/10" },
@@ -8490,7 +8773,7 @@ function ProductCard({
         {
           "data-cimplify-product-card-image-container": true,
           className: cn("overflow-hidden rounded-t-xl", classNames?.imageContainer),
-          style: ASPECT_STYLES2[aspectRatio],
+          style: ASPECT_STYLES5[aspectRatio],
           children: renderImage ? renderImage({ src: imageUrl, alt: product.name, className: classNames?.image }) : /* @__PURE__ */ jsx(
             "img",
             {
@@ -13615,4 +13898,4 @@ function SparkleIcon({ className }) {
   );
 }
 
-export { AccommodationCard, Ad, AdProvider, AddOnSelector, AddressElement, AuthElement, AvailabilityBadge, BillingPlanSelector, BookingCard, BookingList, BookingPage, BookingsPage, BundleProductCard, BundleProductLayout, BundleSelector, CardImage, CardShell, CardVariant, CartDrawer, CartDrawerProvider, CartPage, CartSummary, CartTemplate, CatalogueCollectionLayout, CataloguePage, CatalogueTemplate, CategoryFilter, CategoryGrid, ChatWidget, CheckoutPage, CimplifyAccount, CimplifyCheckout, CimplifyProvider, CollectionPage, CollectionTemplate, CompactCartLayout, CompactCatalogueLayout, CompactSearchLayout, CompactServiceCard, CompositeProductCard, CompositeProductLayout, CompositeSelector, CurrencySelector, CustomAttributesTable, CustomerInputFields, DatePicker, DateSlotPicker, DealBanner, DealsPage, DefaultCartLayout, DefaultCatalogueLayout, DefaultCollectionLayout, DefaultProductLayout, DefaultSearchLayout, DeliveryEstimate, DigitalProductCard, DigitalProductLayout, DiscountInput, ElementsProvider, FeaturedCollectionLayout, FoodProductCard, FoodProductLayout, InventoryBadge, LeaseServiceCard, LocationPicker, MetadataStringList, OrderDetailPage, OrderHistory, OrderHistoryPage, OrderSummary, PaymentElement, Price, PriceRange, ProductCard, ProductCustomizer, ProductGrid, ProductImageGallery, ProductPage, ProductSheet, ProductTemplate, PropertiesTable, QuantitySelector, QuickAddButton, RecentlyViewed, RecommendationCarousel, RelatedProductsSection, RentalServiceCard, ResourcePicker, RetailProductCard, SaleBadge, ScheduleServiceCard, SearchInput, SearchPage, SearchTemplate, ServiceProductLayout, SessionMessageBanner, SlotPicker, SoldOutOverlay, StaffPicker, StandardServiceCard, StoreNav, SubscriptionCard, TagPills, TimePicker, TwoColumnGrid, VariantSelector, VolumePricing, WholesaleProductCard, WholesaleProductLayout, WishlistButton, cn, roomToResource, useActivityState, useAds, useAttributeDefinitions, useAvailableSlots, useBillingPlans, useBookings, useBootstrap, useBundles, useCart, useCartDrawer, useCategories, useChat, useCheckout, useCimplify, useCimplifyClient, useCollection, useCollections, useDeals, useDeliveryFee, useElements, useElementsReady, useFxRate, useLocations, useOptionalCimplify, useOrder, useOrders, useProduct, useProductAvailability, useProductDeals, useProductPrice, useProductSchedules, useProducts, useProductsOnSale, usePropertyFacets, useQuote, useRecommendations, useSearch, useServiceAvailability, useServices, useSubscription, useSubscriptions, useTaxonomies, useTaxonomy, useTaxonomyPath, useValidateDiscount, useVariantSelector };
+export { AccommodationCard, Ad, AdProvider, AddOnSelector, AddressElement, AuthElement, AvailabilityBadge, BillingPlanSelector, BookingCard, BookingList, BookingPage, BookingsPage, BundleProductCard, BundleProductLayout, BundleSelector, CardImage, CardShell, CardVariant, CartDrawer, CartDrawerProvider, CartPage, CartSummary, CartTemplate, CatalogueCollectionLayout, CataloguePage, CatalogueTemplate, CategoryFilter, CategoryGrid, ChatWidget, CheckoutPage, CimplifyAccount, CimplifyCheckout, CimplifyProvider, CollectionPage, CollectionTemplate, CompactCartLayout, CompactCatalogueLayout, CompactSearchLayout, CompactServiceCard, CompositeProductCard, CompositeProductLayout, CompositeSelector, CurrencySelector, CustomAttributesTable, CustomerInputFields, DatePicker, DateSlotPicker, DealBanner, DealsPage, DefaultCartLayout, DefaultCatalogueLayout, DefaultCollectionLayout, DefaultProductLayout, DefaultSearchLayout, DeliveryEstimate, DigitalProductCard, DigitalProductLayout, DiscountInput, ElementsProvider, FeaturedCollectionLayout, FoodProductCard, FoodProductLayout, InventoryBadge, LeaseServiceCard, LocationPicker, MediaGallery, MetadataStringList, OrderDetailPage, OrderHistory, OrderHistoryPage, OrderSummary, PaymentElement, Price, PriceRange, ProductCard, ProductCustomizer, ProductGrid, ProductImageGallery, ProductModel3D, ProductPage, ProductSheet, ProductTemplate, PropertiesTable, QuantitySelector, QuickAddButton, RecentlyViewed, RecommendationCarousel, RelatedProductsSection, RentalServiceCard, ResourcePicker, RetailProductCard, SaleBadge, ScheduleServiceCard, SearchInput, SearchPage, SearchTemplate, ServiceProductLayout, SessionMessageBanner, SlotPicker, SoldOutOverlay, StaffPicker, StandardServiceCard, StoreNav, StoreVideo, SubscriptionCard, TagPills, TimePicker, TwoColumnGrid, VariantSelector, VolumePricing, WholesaleProductCard, WholesaleProductLayout, WishlistButton, cn, roomToResource, useActivityState, useAds, useAttributeDefinitions, useAvailableSlots, useBillingPlans, useBookings, useBootstrap, useBundles, useCart, useCartDrawer, useCategories, useChat, useCheckout, useCimplify, useCimplifyClient, useCollection, useCollections, useDeals, useDeliveryFee, useElements, useElementsReady, useFxRate, useLocations, useOptionalCimplify, useOrder, useOrders, useProduct, useProductAvailability, useProductDeals, useProductPrice, useProductSchedules, useProducts, useProductsOnSale, usePropertyFacets, useQuote, useRecommendations, useSearch, useServiceAvailability, useServices, useSubscription, useSubscriptions, useTaxonomies, useTaxonomy, useTaxonomyPath, useValidateDiscount, useVariantSelector };

package/dist/server.d.mts

@@ -68,31 +68,95 @@ declare const tags: {
     readonly collection: (id: string) => string;
     readonly collectionProducts: (id: string) => string;
     readonly business: () => string;
+    readonly brand: () => string;
     readonly locations: () => string;
+    readonly location: (id: string) => string;
+    readonly locale: () => string;
+    readonly pricing: () => string;
+    readonly tag: (name: string) => string;
+    readonly addons: () => string;
+    readonly addon: (id: string) => string;
+    readonly subscriptions: () => string;
+    readonly subscription: (id: string) => string;
+    readonly stock: () => string;
+    readonly stockFor: (productId: string) => string;
     readonly orders: (customerId: string) => string;
     readonly order: (id: string) => string;
 };
 
+/** Next 16 `revalidateTag` profile arg — built-in name (`'max'`/`'hours'`/…) or `{expire: secs}`. */
+type RevalidateProfile$1 = string | {
+    expire: number;
+};
 /**
  * Invalidate every cache entry tagged with the products list. Call after a
- * Server Action that creates / deletes / reorders products.
+ * Server Action that creates / deletes / reorders products. The optional
+ * `profile` is the Next 16 cacheLife profile (defaults to `'max'` SWR).
  */
-declare function revalidateProducts(): Promise<void>;
+declare function revalidateProducts(profile?: RevalidateProfile$1): Promise<void>;
 /**
  * Invalidate the cached detail of a single product (and the products list,
  * since list-shaped caches typically embed each product's denormalized
  * fields). Call after a Server Action that edits a product.
  */
-declare function revalidateProduct(id: string): Promise<void>;
-declare function revalidateCategories(): Promise<void>;
-declare function revalidateCategory(id: string): Promise<void>;
-declare function revalidateCollections(): Promise<void>;
-declare function revalidateCollection(id: string): Promise<void>;
-declare function revalidateBusiness(): Promise<void>;
+declare function revalidateProduct(id: string, profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateCategories(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateCategory(id: string, profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateCollections(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateCollection(id: string, profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateBusiness(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateBrand(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateLocations(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateLocation(id: string, profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidatePricing(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateAddOns(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateAddOn(id: string, profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateSubscriptions(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateSubscription(id: string, profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateStock(productId?: string, profile?: RevalidateProfile$1): Promise<void>;
 /**
  * Escape hatch: invalidate by raw tag string. Prefer the typed helpers
  * above where possible — they keep the tag scheme in one place.
  */
-declare function revalidateByTag(tag: string): Promise<void>;
+declare function revalidateByTag(tag: string, profile?: RevalidateProfile$1): Promise<void>;
+
+/** Expire the products list with read-your-writes. Call from a Server Action that creates / deletes / reorders. */
+declare function updateProducts(): Promise<void>;
+/** Expire a single product + the products list with read-your-writes. */
+declare function updateProduct(id: string): Promise<void>;
+declare function updateCategories(): Promise<void>;
+declare function updateCategory(id: string): Promise<void>;
+declare function updateCollections(): Promise<void>;
+declare function updateCollection(id: string): Promise<void>;
+declare function updateBusiness(): Promise<void>;
+declare function updateBrand(): Promise<void>;
+declare function updateLocations(): Promise<void>;
+declare function updateLocation(id: string): Promise<void>;
+declare function updatePricing(): Promise<void>;
+declare function updateAddOns(): Promise<void>;
+declare function updateAddOn(id: string): Promise<void>;
+declare function updateSubscriptions(): Promise<void>;
+declare function updateSubscription(id: string): Promise<void>;
+declare function updateStock(productId?: string): Promise<void>;
+/** Escape hatch: expire a raw tag with read-your-writes. Prefer the typed helpers above. */
+declare function updateByTag(tag: string): Promise<void>;
+/**
+ * Refresh uncached data on the current page (notification counts, live
+ * metrics, status indicators). Server-Action-only. Complements
+ * `router.refresh()` on the client.
+ */
+declare function refreshPage(): Promise<void>;
+
+/** Next 16 `revalidateTag` profile arg — built-in name (`'max'`/`'hours'`/…) or inline `{expire: secs}`. */
+type RevalidateProfile = string | {
+    expire: number;
+};
+interface RevalidateRouteOptions {
+    secret?: string;
+    revalidateTag?: (tag: string, profile: RevalidateProfile) => void;
+    now?: () => number;
+    defaultProfile?: RevalidateProfile;
+}
+declare function revalidateRouteHandler(req: Request, options?: RevalidateRouteOptions): Promise<Response>;
 
-export { CimplifyClient, type ServerClientOptions, getServerClient, revalidateBusiness, revalidateByTag, revalidateCategories, revalidateCategory, revalidateCollection, revalidateCollections, revalidateProduct, revalidateProducts, tags };
+export { CimplifyClient, type RevalidateProfile$1 as RevalidateProfile, type RevalidateRouteOptions, type RevalidateProfile as RevalidateRouteProfile, type ServerClientOptions, getServerClient, refreshPage, revalidateAddOn, revalidateAddOns, revalidateBrand, revalidateBusiness, revalidateByTag, revalidateCategories, revalidateCategory, revalidateCollection, revalidateCollections, revalidateLocation, revalidateLocations, revalidatePricing, revalidateProduct, revalidateProducts, revalidateRouteHandler, revalidateStock, revalidateSubscription, revalidateSubscriptions, tags, updateAddOn, updateAddOns, updateBrand, updateBusiness, updateByTag, updateCategories, updateCategory, updateCollection, updateCollections, updateLocation, updateLocations, updatePricing, updateProduct, updateProducts, updateStock, updateSubscription, updateSubscriptions };

package/dist/server.d.ts

@@ -68,31 +68,95 @@ declare const tags: {
     readonly collection: (id: string) => string;
     readonly collectionProducts: (id: string) => string;
     readonly business: () => string;
+    readonly brand: () => string;
     readonly locations: () => string;
+    readonly location: (id: string) => string;
+    readonly locale: () => string;
+    readonly pricing: () => string;
+    readonly tag: (name: string) => string;
+    readonly addons: () => string;
+    readonly addon: (id: string) => string;
+    readonly subscriptions: () => string;
+    readonly subscription: (id: string) => string;
+    readonly stock: () => string;
+    readonly stockFor: (productId: string) => string;
     readonly orders: (customerId: string) => string;
     readonly order: (id: string) => string;
 };
 
+/** Next 16 `revalidateTag` profile arg — built-in name (`'max'`/`'hours'`/…) or `{expire: secs}`. */
+type RevalidateProfile$1 = string | {
+    expire: number;
+};
 /**
  * Invalidate every cache entry tagged with the products list. Call after a
- * Server Action that creates / deletes / reorders products.
+ * Server Action that creates / deletes / reorders products. The optional
+ * `profile` is the Next 16 cacheLife profile (defaults to `'max'` SWR).
  */
-declare function revalidateProducts(): Promise<void>;
+declare function revalidateProducts(profile?: RevalidateProfile$1): Promise<void>;
 /**
  * Invalidate the cached detail of a single product (and the products list,
  * since list-shaped caches typically embed each product's denormalized
  * fields). Call after a Server Action that edits a product.
  */
-declare function revalidateProduct(id: string): Promise<void>;
-declare function revalidateCategories(): Promise<void>;
-declare function revalidateCategory(id: string): Promise<void>;
-declare function revalidateCollections(): Promise<void>;
-declare function revalidateCollection(id: string): Promise<void>;
-declare function revalidateBusiness(): Promise<void>;
+declare function revalidateProduct(id: string, profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateCategories(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateCategory(id: string, profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateCollections(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateCollection(id: string, profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateBusiness(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateBrand(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateLocations(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateLocation(id: string, profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidatePricing(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateAddOns(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateAddOn(id: string, profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateSubscriptions(profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateSubscription(id: string, profile?: RevalidateProfile$1): Promise<void>;
+declare function revalidateStock(productId?: string, profile?: RevalidateProfile$1): Promise<void>;
 /**
  * Escape hatch: invalidate by raw tag string. Prefer the typed helpers
  * above where possible — they keep the tag scheme in one place.
  */
-declare function revalidateByTag(tag: string): Promise<void>;
+declare function revalidateByTag(tag: string, profile?: RevalidateProfile$1): Promise<void>;
+
+/** Expire the products list with read-your-writes. Call from a Server Action that creates / deletes / reorders. */
+declare function updateProducts(): Promise<void>;
+/** Expire a single product + the products list with read-your-writes. */
+declare function updateProduct(id: string): Promise<void>;
+declare function updateCategories(): Promise<void>;
+declare function updateCategory(id: string): Promise<void>;
+declare function updateCollections(): Promise<void>;
+declare function updateCollection(id: string): Promise<void>;
+declare function updateBusiness(): Promise<void>;
+declare function updateBrand(): Promise<void>;
+declare function updateLocations(): Promise<void>;
+declare function updateLocation(id: string): Promise<void>;
+declare function updatePricing(): Promise<void>;
+declare function updateAddOns(): Promise<void>;
+declare function updateAddOn(id: string): Promise<void>;
+declare function updateSubscriptions(): Promise<void>;
+declare function updateSubscription(id: string): Promise<void>;
+declare function updateStock(productId?: string): Promise<void>;
+/** Escape hatch: expire a raw tag with read-your-writes. Prefer the typed helpers above. */
+declare function updateByTag(tag: string): Promise<void>;
+/**
+ * Refresh uncached data on the current page (notification counts, live
+ * metrics, status indicators). Server-Action-only. Complements
+ * `router.refresh()` on the client.
+ */
+declare function refreshPage(): Promise<void>;
+
+/** Next 16 `revalidateTag` profile arg — built-in name (`'max'`/`'hours'`/…) or inline `{expire: secs}`. */
+type RevalidateProfile = string | {
+    expire: number;
+};
+interface RevalidateRouteOptions {
+    secret?: string;
+    revalidateTag?: (tag: string, profile: RevalidateProfile) => void;
+    now?: () => number;
+    defaultProfile?: RevalidateProfile;
+}
+declare function revalidateRouteHandler(req: Request, options?: RevalidateRouteOptions): Promise<Response>;
 
-export { CimplifyClient, type ServerClientOptions, getServerClient, revalidateBusiness, revalidateByTag, revalidateCategories, revalidateCategory, revalidateCollection, revalidateCollections, revalidateProduct, revalidateProducts, tags };
+export { CimplifyClient, type RevalidateProfile$1 as RevalidateProfile, type RevalidateRouteOptions, type RevalidateProfile as RevalidateRouteProfile, type ServerClientOptions, getServerClient, refreshPage, revalidateAddOn, revalidateAddOns, revalidateBrand, revalidateBusiness, revalidateByTag, revalidateCategories, revalidateCategory, revalidateCollection, revalidateCollections, revalidateLocation, revalidateLocations, revalidatePricing, revalidateProduct, revalidateProducts, revalidateRouteHandler, revalidateStock, revalidateSubscription, revalidateSubscriptions, tags, updateAddOn, updateAddOns, updateBrand, updateBusiness, updateByTag, updateCategories, updateCategory, updateCollection, updateCollections, updateLocation, updateLocations, updatePricing, updateProduct, updateProducts, updateStock, updateSubscription, updateSubscriptions };