@cimplify/sdk 0.49.0 → 0.49.2

package/dist/server.d.mts

@@ -85,41 +85,112 @@ declare const tags: {
 };
 
 /**
- * Invalidate every cache entry tagged with the products list. Call after a
- * Server Action that creates / deletes / reorders products.
+ * Cimplify's opinionated cacheLife profiles for storefront server caches.
+ *
+ * Pass either of these to Next 16's `cacheLife(...)` inside a `'use cache'`
+ * server function. They're typed-literal exports so a typo fails at the SDK
+ * import site, not silently at runtime (Next's own `cacheLife(profile: string)`
+ * overload would accept anything and look it up as a custom profile).
+ *
+ * @example
+ * ```ts
+ * import { cacheLife } from "next/cache";
+ * import { CACHE_LIFE_DEFAULT, CACHE_LIFE_PROBE, tags } from "@cimplify/sdk/server";
+ *
+ * async function getProducts() {
+ *   "use cache";
+ *   cacheTag(tags.products());
+ *   const r = await getServerClient().catalogue.getProducts();
+ *   // Don't lock in empties / failures — a transient bad render would
+ *   // otherwise sit cached for the full "max" window.
+ *   if (!r.ok || r.value.items.length === 0) {
+ *     cacheLife(CACHE_LIFE_PROBE);
+ *     return r;
+ *   }
+ *   cacheLife(CACHE_LIFE_DEFAULT);
+ *   return r;
+ * }
+ * ```
  */
-declare function revalidateProducts(): 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.
+ * The default cacheLife for cached storefront reads. Resolves to `"max"`,
+ * which is Next 16's longest built-in profile (stale 5min, revalidate 30d,
+ * never expires). Safe because Cimplify's tag-cache + CF cache-purge wiring
+ * invalidates on-demand within ~1s of a merchant edit — there's no benefit
+ * to short timer-based expirations on data Cimplify owns.
  */
-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 revalidateBrand(): Promise<void>;
-declare function revalidateLocations(): Promise<void>;
-declare function revalidateLocation(id: string): Promise<void>;
-declare function revalidatePricing(): Promise<void>;
-declare function revalidateAddOns(): Promise<void>;
-declare function revalidateAddOn(id: string): Promise<void>;
-declare function revalidateSubscriptions(): Promise<void>;
-declare function revalidateSubscription(id: string): Promise<void>;
-declare function revalidateStock(productId?: string): Promise<void>;
+declare const CACHE_LIFE_DEFAULT: "max";
 /**
- * Escape hatch: invalidate by raw tag string. Prefer the typed helpers
- * above where possible — they keep the tag scheme in one place.
+ * Short-lived cacheLife for "probe" results — empty arrays, errors, 404s,
+ * anything that *might* be a transient bad render. Resolves to `"seconds"`
+ * (stale 30s, revalidate 1s, expires 1min). Use this when the fetch returned
+ * no usable data so a momentary backend blip can't get locked into the cache
+ * for `CACHE_LIFE_DEFAULT`'s entire window.
+ *
+ * The tag still gets attached, so a real `revalidateTag(...)` from Cimplify
+ * will refresh the entry the moment the underlying data changes.
  */
-declare function revalidateByTag(tag: string): Promise<void>;
+declare const CACHE_LIFE_PROBE: "seconds";
+/** The TS type of {@link CACHE_LIFE_DEFAULT} — the `"max"` literal. */
+type CacheLifeDefault = typeof CACHE_LIFE_DEFAULT;
+/** The TS type of {@link CACHE_LIFE_PROBE} — the `"seconds"` literal. */
+type CacheLifeProbe = typeof CACHE_LIFE_PROBE;
+
+/** Next 16 cacheLife profile — a built-in name (`'max'`/`'hours'`/…) or `{expire: secs}`. */
+type RevalidateProfile$1 = string | {
+    expire: number;
+};
+declare function revalidateProducts(profile?: RevalidateProfile$1): 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>;
+declare function revalidateByTag(tag: string, profile?: RevalidateProfile$1): Promise<void>;
 
+declare function updateProducts(): Promise<void>;
+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>;
+declare function updateByTag(tag: string): Promise<void>;
+declare function refreshPage(): Promise<void>;
+
+/** Next 16 cacheLife profile — a built-in name (`'max'`/`'hours'`/…) or `{expire: secs}`. */
+type RevalidateProfile = string | {
+    expire: number;
+};
 interface RevalidateRouteOptions {
+    /** Defaults to `process.env.CIMPLIFY_REVALIDATE_SECRET`. */
     secret?: string;
-    revalidateTag?: (tag: string) => void;
+    /** Defaults to a lazy import of `next/cache.revalidateTag`. Override for tests. */
+    revalidateTag?: (tag: string, profile: RevalidateProfile) => void;
+    /** Defaults to `Date.now`. Override for tests. */
     now?: () => number;
+    /** Profile used when the request body doesn't include one. Defaults to `'max'`. */
+    defaultProfile?: RevalidateProfile;
 }
 declare function revalidateRouteHandler(req: Request, options?: RevalidateRouteOptions): Promise<Response>;
 
-export { CimplifyClient, type RevalidateRouteOptions, type ServerClientOptions, getServerClient, revalidateAddOn, revalidateAddOns, revalidateBrand, revalidateBusiness, revalidateByTag, revalidateCategories, revalidateCategory, revalidateCollection, revalidateCollections, revalidateLocation, revalidateLocations, revalidatePricing, revalidateProduct, revalidateProducts, revalidateRouteHandler, revalidateStock, revalidateSubscription, revalidateSubscriptions, tags };
+export { CACHE_LIFE_DEFAULT, CACHE_LIFE_PROBE, type CacheLifeDefault, type CacheLifeProbe, 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

@@ -85,41 +85,112 @@ declare const tags: {
 };
 
 /**
- * Invalidate every cache entry tagged with the products list. Call after a
- * Server Action that creates / deletes / reorders products.
+ * Cimplify's opinionated cacheLife profiles for storefront server caches.
+ *
+ * Pass either of these to Next 16's `cacheLife(...)` inside a `'use cache'`
+ * server function. They're typed-literal exports so a typo fails at the SDK
+ * import site, not silently at runtime (Next's own `cacheLife(profile: string)`
+ * overload would accept anything and look it up as a custom profile).
+ *
+ * @example
+ * ```ts
+ * import { cacheLife } from "next/cache";
+ * import { CACHE_LIFE_DEFAULT, CACHE_LIFE_PROBE, tags } from "@cimplify/sdk/server";
+ *
+ * async function getProducts() {
+ *   "use cache";
+ *   cacheTag(tags.products());
+ *   const r = await getServerClient().catalogue.getProducts();
+ *   // Don't lock in empties / failures — a transient bad render would
+ *   // otherwise sit cached for the full "max" window.
+ *   if (!r.ok || r.value.items.length === 0) {
+ *     cacheLife(CACHE_LIFE_PROBE);
+ *     return r;
+ *   }
+ *   cacheLife(CACHE_LIFE_DEFAULT);
+ *   return r;
+ * }
+ * ```
  */
-declare function revalidateProducts(): 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.
+ * The default cacheLife for cached storefront reads. Resolves to `"max"`,
+ * which is Next 16's longest built-in profile (stale 5min, revalidate 30d,
+ * never expires). Safe because Cimplify's tag-cache + CF cache-purge wiring
+ * invalidates on-demand within ~1s of a merchant edit — there's no benefit
+ * to short timer-based expirations on data Cimplify owns.
  */
-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 revalidateBrand(): Promise<void>;
-declare function revalidateLocations(): Promise<void>;
-declare function revalidateLocation(id: string): Promise<void>;
-declare function revalidatePricing(): Promise<void>;
-declare function revalidateAddOns(): Promise<void>;
-declare function revalidateAddOn(id: string): Promise<void>;
-declare function revalidateSubscriptions(): Promise<void>;
-declare function revalidateSubscription(id: string): Promise<void>;
-declare function revalidateStock(productId?: string): Promise<void>;
+declare const CACHE_LIFE_DEFAULT: "max";
 /**
- * Escape hatch: invalidate by raw tag string. Prefer the typed helpers
- * above where possible — they keep the tag scheme in one place.
+ * Short-lived cacheLife for "probe" results — empty arrays, errors, 404s,
+ * anything that *might* be a transient bad render. Resolves to `"seconds"`
+ * (stale 30s, revalidate 1s, expires 1min). Use this when the fetch returned
+ * no usable data so a momentary backend blip can't get locked into the cache
+ * for `CACHE_LIFE_DEFAULT`'s entire window.
+ *
+ * The tag still gets attached, so a real `revalidateTag(...)` from Cimplify
+ * will refresh the entry the moment the underlying data changes.
  */
-declare function revalidateByTag(tag: string): Promise<void>;
+declare const CACHE_LIFE_PROBE: "seconds";
+/** The TS type of {@link CACHE_LIFE_DEFAULT} — the `"max"` literal. */
+type CacheLifeDefault = typeof CACHE_LIFE_DEFAULT;
+/** The TS type of {@link CACHE_LIFE_PROBE} — the `"seconds"` literal. */
+type CacheLifeProbe = typeof CACHE_LIFE_PROBE;
+
+/** Next 16 cacheLife profile — a built-in name (`'max'`/`'hours'`/…) or `{expire: secs}`. */
+type RevalidateProfile$1 = string | {
+    expire: number;
+};
+declare function revalidateProducts(profile?: RevalidateProfile$1): 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>;
+declare function revalidateByTag(tag: string, profile?: RevalidateProfile$1): Promise<void>;
 
+declare function updateProducts(): Promise<void>;
+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>;
+declare function updateByTag(tag: string): Promise<void>;
+declare function refreshPage(): Promise<void>;
+
+/** Next 16 cacheLife profile — a built-in name (`'max'`/`'hours'`/…) or `{expire: secs}`. */
+type RevalidateProfile = string | {
+    expire: number;
+};
 interface RevalidateRouteOptions {
+    /** Defaults to `process.env.CIMPLIFY_REVALIDATE_SECRET`. */
     secret?: string;
-    revalidateTag?: (tag: string) => void;
+    /** Defaults to a lazy import of `next/cache.revalidateTag`. Override for tests. */
+    revalidateTag?: (tag: string, profile: RevalidateProfile) => void;
+    /** Defaults to `Date.now`. Override for tests. */
     now?: () => number;
+    /** Profile used when the request body doesn't include one. Defaults to `'max'`. */
+    defaultProfile?: RevalidateProfile;
 }
 declare function revalidateRouteHandler(req: Request, options?: RevalidateRouteOptions): Promise<Response>;
 
-export { CimplifyClient, type RevalidateRouteOptions, type ServerClientOptions, getServerClient, revalidateAddOn, revalidateAddOns, revalidateBrand, revalidateBusiness, revalidateByTag, revalidateCategories, revalidateCategory, revalidateCollection, revalidateCollections, revalidateLocation, revalidateLocations, revalidatePricing, revalidateProduct, revalidateProducts, revalidateRouteHandler, revalidateStock, revalidateSubscription, revalidateSubscriptions, tags };
+export { CACHE_LIFE_DEFAULT, CACHE_LIFE_PROBE, type CacheLifeDefault, type CacheLifeProbe, 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.js

@@ -6,7 +6,12 @@ require('./chunk-6RP6OPYO.js');
 var chunkTKOTACKZ_js = require('./chunk-TKOTACKZ.js');
 var react = require('react');
 
+var DEFAULT_PROD_URL = "https://storefronts.cimplify.io";
 var DEFAULT_DEV_URL = "http://127.0.0.1:8787";
+function defaultBaseUrl() {
+  const proc = globalThis.process;
+  return proc?.env?.NODE_ENV === "production" ? DEFAULT_PROD_URL : DEFAULT_DEV_URL;
+}
 function readEnv(...keys) {
   const env = globalThis.process?.env;
   if (!env) return void 0;
@@ -17,7 +22,7 @@ function readEnv(...keys) {
   return void 0;
 }
 var getServerClient = react.cache((opts = {}) => {
-  const baseUrl = opts.apiUrl ?? readEnv("CIMPLIFY_API_URL", "NEXT_PUBLIC_CIMPLIFY_API_URL") ?? DEFAULT_DEV_URL;
+  const baseUrl = opts.apiUrl ?? readEnv("CIMPLIFY_API_URL", "NEXT_PUBLIC_CIMPLIFY_API_URL") ?? defaultBaseUrl();
   const publicKey = opts.secretKey ?? readEnv("CIMPLIFY_SECRET_KEY", "NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY") ?? "mock-dev";
   const client = chunkCYGLTD7D_js.createCimplifyClient({
     baseUrl,
@@ -58,7 +63,12 @@ var tags = {
   order: (id) => `cimplify:order:${id}`
 };
 
+// src/server/cache-life.ts
+var CACHE_LIFE_DEFAULT = "max";
+var CACHE_LIFE_PROBE = "seconds";
+
 // src/server/revalidate.ts
+var DEFAULT_PROFILE = CACHE_LIFE_DEFAULT;
 var _revalidateTag = null;
 async function getRevalidateTag() {
   if (_revalidateTag) return _revalidateTag;
@@ -71,64 +81,156 @@ async function getRevalidateTag() {
   _revalidateTag = mod.revalidateTag;
   return _revalidateTag;
 }
-async function revalidate(...tagList) {
+async function revalidate(profile, ...tagList) {
   const fn = await getRevalidateTag();
-  for (const t of tagList) fn(t);
+  for (const t of tagList) fn(t, profile);
 }
-async function revalidateProducts() {
-  return revalidate(tags.products());
+async function revalidateProducts(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.products());
 }
-async function revalidateProduct(id) {
-  return revalidate(tags.product(id), tags.products());
+async function revalidateProduct(id, profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.product(id), tags.products());
 }
-async function revalidateCategories() {
-  return revalidate(tags.categories());
+async function revalidateCategories(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.categories());
 }
-async function revalidateCategory(id) {
-  return revalidate(tags.category(id), tags.categoryProducts(id), tags.categories());
+async function revalidateCategory(id, profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.category(id), tags.categoryProducts(id), tags.categories());
 }
-async function revalidateCollections() {
-  return revalidate(tags.collections());
+async function revalidateCollections(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.collections());
 }
-async function revalidateCollection(id) {
+async function revalidateCollection(id, profile = DEFAULT_PROFILE) {
   return revalidate(
+    profile,
     tags.collection(id),
     tags.collectionProducts(id),
     tags.collections()
   );
 }
-async function revalidateBusiness() {
-  return revalidate(tags.business());
+async function revalidateBusiness(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.business());
+}
+async function revalidateBrand(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.brand());
+}
+async function revalidateLocations(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.locations());
+}
+async function revalidateLocation(id, profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.location(id), tags.locations());
+}
+async function revalidatePricing(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.pricing(), tags.products());
+}
+async function revalidateAddOns(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.addons());
+}
+async function revalidateAddOn(id, profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.addon(id), tags.addons());
+}
+async function revalidateSubscriptions(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.subscriptions());
+}
+async function revalidateSubscription(id, profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.subscription(id), tags.subscriptions());
+}
+async function revalidateStock(productId, profile = DEFAULT_PROFILE) {
+  return productId ? revalidate(profile, tags.stockFor(productId), tags.stock()) : revalidate(profile, tags.stock());
+}
+async function revalidateByTag(tag, profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tag);
+}
+
+// src/server/update.ts
+var _updateTag = null;
+var _refresh = null;
+async function getUpdateTag() {
+  if (_updateTag) return _updateTag;
+  const specifier = "next/cache";
+  const mod = await import(
+    /* webpackIgnore: true */
+    /* @vite-ignore */
+    specifier
+  );
+  if (!mod.updateTag) {
+    throw new Error("updateTag is not exported from next/cache \u2014 requires Next 16+");
+  }
+  _updateTag = mod.updateTag;
+  return _updateTag;
+}
+async function getRefresh() {
+  if (_refresh) return _refresh;
+  const specifier = "next/cache";
+  const mod = await import(
+    /* webpackIgnore: true */
+    /* @vite-ignore */
+    specifier
+  );
+  if (!mod.refresh) {
+    throw new Error("refresh is not exported from next/cache \u2014 requires Next 16+");
+  }
+  _refresh = mod.refresh;
+  return _refresh;
+}
+async function update(...tagList) {
+  const fn = await getUpdateTag();
+  for (const t of tagList) fn(t);
+}
+async function updateProducts() {
+  return update(tags.products());
+}
+async function updateProduct(id) {
+  return update(tags.product(id), tags.products());
+}
+async function updateCategories() {
+  return update(tags.categories());
+}
+async function updateCategory(id) {
+  return update(tags.category(id), tags.categoryProducts(id), tags.categories());
+}
+async function updateCollections() {
+  return update(tags.collections());
+}
+async function updateCollection(id) {
+  return update(tags.collection(id), tags.collectionProducts(id), tags.collections());
 }
-async function revalidateBrand() {
-  return revalidate(tags.brand());
+async function updateBusiness() {
+  return update(tags.business());
 }
-async function revalidateLocations() {
-  return revalidate(tags.locations());
+async function updateBrand() {
+  return update(tags.brand());
 }
-async function revalidateLocation(id) {
-  return revalidate(tags.location(id), tags.locations());
+async function updateLocations() {
+  return update(tags.locations());
 }
-async function revalidatePricing() {
-  return revalidate(tags.pricing(), tags.products());
+async function updateLocation(id) {
+  return update(tags.location(id), tags.locations());
 }
-async function revalidateAddOns() {
-  return revalidate(tags.addons());
+async function updatePricing() {
+  return update(tags.pricing(), tags.products());
 }
-async function revalidateAddOn(id) {
-  return revalidate(tags.addon(id), tags.addons());
+async function updateAddOns() {
+  return update(tags.addons());
 }
-async function revalidateSubscriptions() {
-  return revalidate(tags.subscriptions());
+async function updateAddOn(id) {
+  return update(tags.addon(id), tags.addons());
 }
-async function revalidateSubscription(id) {
-  return revalidate(tags.subscription(id), tags.subscriptions());
+async function updateSubscriptions() {
+  return update(tags.subscriptions());
 }
-async function revalidateStock(productId) {
-  return productId ? revalidate(tags.stockFor(productId), tags.stock()) : revalidate(tags.stock());
+async function updateSubscription(id) {
+  return update(tags.subscription(id), tags.subscriptions());
 }
-async function revalidateByTag(tag) {
-  return revalidate(tag);
+async function updateStock(productId) {
+  return productId ? update(tags.stockFor(productId), tags.stock()) : update(tags.stock());
+}
+async function updateByTag(tag) {
+  return update(tag);
+}
+async function refreshPage() {
+  const fn = await getRefresh();
+  fn();
 }
 
 // src/server/revalidate-route.ts
@@ -137,6 +239,7 @@ var SIGNATURE_HEADER = "x-cimplify-signature";
 var SIGNATURE_PREFIX = "sha256=";
 var MAX_SKEW_MS = 5 * 60 * 1e3;
 var SECRET_ENV = "CIMPLIFY_REVALIDATE_SECRET";
+var DEFAULT_PROFILE2 = CACHE_LIFE_DEFAULT;
 async function revalidateRouteHandler(req, options = {}) {
   const secret = options.secret ?? envSecret();
   if (!secret) return text(`revalidate disabled: ${SECRET_ENV} not set`, 500);
@@ -160,9 +263,17 @@ async function revalidateRouteHandler(req, options = {}) {
   }
   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 profile = parseProfile(parsed.profile) ?? options.defaultProfile ?? DEFAULT_PROFILE2;
   const revalidate2 = options.revalidateTag ?? await loadRevalidateTag();
-  for (const tag of tags2) revalidate2(tag);
-  return Response.json({ ok: true, revalidated: tags2.length });
+  for (const tag of tags2) revalidate2(tag, profile);
+  return Response.json({ ok: true, revalidated: tags2.length, profile });
+}
+function parseProfile(raw) {
+  if (typeof raw === "string" && raw.length > 0) return raw;
+  if (raw && typeof raw === "object" && "expire" in raw && typeof raw.expire === "number") {
+    return { expire: raw.expire };
+  }
+  return void 0;
 }
 var cachedRevalidateTag = null;
 async function loadRevalidateTag() {
@@ -211,7 +322,10 @@ Object.defineProperty(exports, "CimplifyError", {
   enumerable: true,
   get: function () { return chunkTKOTACKZ_js.CimplifyError; }
 });
+exports.CACHE_LIFE_DEFAULT = CACHE_LIFE_DEFAULT;
+exports.CACHE_LIFE_PROBE = CACHE_LIFE_PROBE;
 exports.getServerClient = getServerClient;
+exports.refreshPage = refreshPage;
 exports.revalidateAddOn = revalidateAddOn;
 exports.revalidateAddOns = revalidateAddOns;
 exports.revalidateBrand = revalidateBrand;
@@ -231,3 +345,20 @@ exports.revalidateStock = revalidateStock;
 exports.revalidateSubscription = revalidateSubscription;
 exports.revalidateSubscriptions = revalidateSubscriptions;
 exports.tags = tags;
+exports.updateAddOn = updateAddOn;
+exports.updateAddOns = updateAddOns;
+exports.updateBrand = updateBrand;
+exports.updateBusiness = updateBusiness;
+exports.updateByTag = updateByTag;
+exports.updateCategories = updateCategories;
+exports.updateCategory = updateCategory;
+exports.updateCollection = updateCollection;
+exports.updateCollections = updateCollections;
+exports.updateLocation = updateLocation;
+exports.updateLocations = updateLocations;
+exports.updatePricing = updatePricing;
+exports.updateProduct = updateProduct;
+exports.updateProducts = updateProducts;
+exports.updateStock = updateStock;
+exports.updateSubscription = updateSubscription;
+exports.updateSubscriptions = updateSubscriptions;

package/dist/server.mjs

@@ -4,7 +4,12 @@ import './chunk-XY2DFX5K.mjs';
 export { CimplifyError } from './chunk-Z2AYLZDF.mjs';
 import { cache } from 'react';
 
+var DEFAULT_PROD_URL = "https://storefronts.cimplify.io";
 var DEFAULT_DEV_URL = "http://127.0.0.1:8787";
+function defaultBaseUrl() {
+  const proc = globalThis.process;
+  return proc?.env?.NODE_ENV === "production" ? DEFAULT_PROD_URL : DEFAULT_DEV_URL;
+}
 function readEnv(...keys) {
   const env = globalThis.process?.env;
   if (!env) return void 0;
@@ -15,7 +20,7 @@ function readEnv(...keys) {
   return void 0;
 }
 var getServerClient = cache((opts = {}) => {
-  const baseUrl = opts.apiUrl ?? readEnv("CIMPLIFY_API_URL", "NEXT_PUBLIC_CIMPLIFY_API_URL") ?? DEFAULT_DEV_URL;
+  const baseUrl = opts.apiUrl ?? readEnv("CIMPLIFY_API_URL", "NEXT_PUBLIC_CIMPLIFY_API_URL") ?? defaultBaseUrl();
   const publicKey = opts.secretKey ?? readEnv("CIMPLIFY_SECRET_KEY", "NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY") ?? "mock-dev";
   const client = createCimplifyClient({
     baseUrl,
@@ -56,7 +61,12 @@ var tags = {
   order: (id) => `cimplify:order:${id}`
 };
 
+// src/server/cache-life.ts
+var CACHE_LIFE_DEFAULT = "max";
+var CACHE_LIFE_PROBE = "seconds";
+
 // src/server/revalidate.ts
+var DEFAULT_PROFILE = CACHE_LIFE_DEFAULT;
 var _revalidateTag = null;
 async function getRevalidateTag() {
   if (_revalidateTag) return _revalidateTag;
@@ -69,64 +79,156 @@ async function getRevalidateTag() {
   _revalidateTag = mod.revalidateTag;
   return _revalidateTag;
 }
-async function revalidate(...tagList) {
+async function revalidate(profile, ...tagList) {
   const fn = await getRevalidateTag();
-  for (const t of tagList) fn(t);
+  for (const t of tagList) fn(t, profile);
 }
-async function revalidateProducts() {
-  return revalidate(tags.products());
+async function revalidateProducts(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.products());
 }
-async function revalidateProduct(id) {
-  return revalidate(tags.product(id), tags.products());
+async function revalidateProduct(id, profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.product(id), tags.products());
 }
-async function revalidateCategories() {
-  return revalidate(tags.categories());
+async function revalidateCategories(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.categories());
 }
-async function revalidateCategory(id) {
-  return revalidate(tags.category(id), tags.categoryProducts(id), tags.categories());
+async function revalidateCategory(id, profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.category(id), tags.categoryProducts(id), tags.categories());
 }
-async function revalidateCollections() {
-  return revalidate(tags.collections());
+async function revalidateCollections(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.collections());
 }
-async function revalidateCollection(id) {
+async function revalidateCollection(id, profile = DEFAULT_PROFILE) {
   return revalidate(
+    profile,
     tags.collection(id),
     tags.collectionProducts(id),
     tags.collections()
   );
 }
-async function revalidateBusiness() {
-  return revalidate(tags.business());
+async function revalidateBusiness(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.business());
+}
+async function revalidateBrand(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.brand());
+}
+async function revalidateLocations(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.locations());
+}
+async function revalidateLocation(id, profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.location(id), tags.locations());
+}
+async function revalidatePricing(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.pricing(), tags.products());
+}
+async function revalidateAddOns(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.addons());
+}
+async function revalidateAddOn(id, profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.addon(id), tags.addons());
+}
+async function revalidateSubscriptions(profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.subscriptions());
+}
+async function revalidateSubscription(id, profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tags.subscription(id), tags.subscriptions());
+}
+async function revalidateStock(productId, profile = DEFAULT_PROFILE) {
+  return productId ? revalidate(profile, tags.stockFor(productId), tags.stock()) : revalidate(profile, tags.stock());
+}
+async function revalidateByTag(tag, profile = DEFAULT_PROFILE) {
+  return revalidate(profile, tag);
+}
+
+// src/server/update.ts
+var _updateTag = null;
+var _refresh = null;
+async function getUpdateTag() {
+  if (_updateTag) return _updateTag;
+  const specifier = "next/cache";
+  const mod = await import(
+    /* webpackIgnore: true */
+    /* @vite-ignore */
+    specifier
+  );
+  if (!mod.updateTag) {
+    throw new Error("updateTag is not exported from next/cache \u2014 requires Next 16+");
+  }
+  _updateTag = mod.updateTag;
+  return _updateTag;
+}
+async function getRefresh() {
+  if (_refresh) return _refresh;
+  const specifier = "next/cache";
+  const mod = await import(
+    /* webpackIgnore: true */
+    /* @vite-ignore */
+    specifier
+  );
+  if (!mod.refresh) {
+    throw new Error("refresh is not exported from next/cache \u2014 requires Next 16+");
+  }
+  _refresh = mod.refresh;
+  return _refresh;
+}
+async function update(...tagList) {
+  const fn = await getUpdateTag();
+  for (const t of tagList) fn(t);
+}
+async function updateProducts() {
+  return update(tags.products());
+}
+async function updateProduct(id) {
+  return update(tags.product(id), tags.products());
+}
+async function updateCategories() {
+  return update(tags.categories());
+}
+async function updateCategory(id) {
+  return update(tags.category(id), tags.categoryProducts(id), tags.categories());
+}
+async function updateCollections() {
+  return update(tags.collections());
+}
+async function updateCollection(id) {
+  return update(tags.collection(id), tags.collectionProducts(id), tags.collections());
 }
-async function revalidateBrand() {
-  return revalidate(tags.brand());
+async function updateBusiness() {
+  return update(tags.business());
 }
-async function revalidateLocations() {
-  return revalidate(tags.locations());
+async function updateBrand() {
+  return update(tags.brand());
 }
-async function revalidateLocation(id) {
-  return revalidate(tags.location(id), tags.locations());
+async function updateLocations() {
+  return update(tags.locations());
 }
-async function revalidatePricing() {
-  return revalidate(tags.pricing(), tags.products());
+async function updateLocation(id) {
+  return update(tags.location(id), tags.locations());
 }
-async function revalidateAddOns() {
-  return revalidate(tags.addons());
+async function updatePricing() {
+  return update(tags.pricing(), tags.products());
 }
-async function revalidateAddOn(id) {
-  return revalidate(tags.addon(id), tags.addons());
+async function updateAddOns() {
+  return update(tags.addons());
 }
-async function revalidateSubscriptions() {
-  return revalidate(tags.subscriptions());
+async function updateAddOn(id) {
+  return update(tags.addon(id), tags.addons());
 }
-async function revalidateSubscription(id) {
-  return revalidate(tags.subscription(id), tags.subscriptions());
+async function updateSubscriptions() {
+  return update(tags.subscriptions());
 }
-async function revalidateStock(productId) {
-  return productId ? revalidate(tags.stockFor(productId), tags.stock()) : revalidate(tags.stock());
+async function updateSubscription(id) {
+  return update(tags.subscription(id), tags.subscriptions());
 }
-async function revalidateByTag(tag) {
-  return revalidate(tag);
+async function updateStock(productId) {
+  return productId ? update(tags.stockFor(productId), tags.stock()) : update(tags.stock());
+}
+async function updateByTag(tag) {
+  return update(tag);
+}
+async function refreshPage() {
+  const fn = await getRefresh();
+  fn();
 }
 
 // src/server/revalidate-route.ts
@@ -135,6 +237,7 @@ var SIGNATURE_HEADER = "x-cimplify-signature";
 var SIGNATURE_PREFIX = "sha256=";
 var MAX_SKEW_MS = 5 * 60 * 1e3;
 var SECRET_ENV = "CIMPLIFY_REVALIDATE_SECRET";
+var DEFAULT_PROFILE2 = CACHE_LIFE_DEFAULT;
 async function revalidateRouteHandler(req, options = {}) {
   const secret = options.secret ?? envSecret();
   if (!secret) return text(`revalidate disabled: ${SECRET_ENV} not set`, 500);
@@ -158,9 +261,17 @@ async function revalidateRouteHandler(req, options = {}) {
   }
   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 profile = parseProfile(parsed.profile) ?? options.defaultProfile ?? DEFAULT_PROFILE2;
   const revalidate2 = options.revalidateTag ?? await loadRevalidateTag();
-  for (const tag of tags2) revalidate2(tag);
-  return Response.json({ ok: true, revalidated: tags2.length });
+  for (const tag of tags2) revalidate2(tag, profile);
+  return Response.json({ ok: true, revalidated: tags2.length, profile });
+}
+function parseProfile(raw) {
+  if (typeof raw === "string" && raw.length > 0) return raw;
+  if (raw && typeof raw === "object" && "expire" in raw && typeof raw.expire === "number") {
+    return { expire: raw.expire };
+  }
+  return void 0;
 }
 var cachedRevalidateTag = null;
 async function loadRevalidateTag() {
@@ -205,4 +316,4 @@ 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 };
+export { CACHE_LIFE_DEFAULT, CACHE_LIFE_PROBE, 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/package.json

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