@cimplify/sdk 0.38.5 → 0.39.1

package/dist/react.js

@@ -1,7 +1,8 @@
 "use client";
 'use strict';
 
-var chunk5VHKZTFJ_js = require('./chunk-5VHKZTFJ.js');
+var chunkBGCEKFLA_js = require('./chunk-BGCEKFLA.js');
+var chunkOMAP327U_js = require('./chunk-OMAP327U.js');
 var chunkBAWKQRIB_js = require('./chunk-BAWKQRIB.js');
 var chunkV2O5AO7I_js = require('./chunk-V2O5AO7I.js');
 var React10 = require('react');
@@ -1151,7 +1152,7 @@ var DEFAULT_COUNTRY = "US";
 function createDefaultClient() {
   const processRef = globalThis.process;
   const envPublicKey = processRef?.env?.NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY || "";
-  return chunk5VHKZTFJ_js.createCimplifyClient({ publicKey: envPublicKey });
+  return chunkOMAP327U_js.createCimplifyClient({ publicKey: envPublicKey });
 }
 function getStoredLocationId() {
   if (typeof window === "undefined" || !window.localStorage) {
@@ -4004,7 +4005,7 @@ function VariantSelector({
                   {
                     "data-cimplify-variant-name": true,
                     className: cn("flex-1 min-w-0 text-sm", classNames?.name),
-                    children: chunk5VHKZTFJ_js.getVariantDisplayName(variant, productName)
+                    children: chunkBGCEKFLA_js.getVariantDisplayName(variant, productName)
                   }
                 ),
                 /* @__PURE__ */ jsxRuntime.jsxs("span", { "data-cimplify-variant-pricing": true, className: cn("text-sm text-muted-foreground", classNames?.pricing), children: [
@@ -5221,12 +5222,12 @@ function FieldInput({
     classNames?.input
   );
   switch (field.field_type) {
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Text:
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Url:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Text:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Url:
       return /* @__PURE__ */ jsxRuntime.jsx(
         "input",
         {
-          type: field.field_type === chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Url ? "url" : "text",
+          type: field.field_type === chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Url ? "url" : "text",
           value: typeof value === "string" ? value : "",
           onChange: (e) => onValueChange(e.target.value),
           placeholder: field.placeholder,
@@ -5235,7 +5236,7 @@ function FieldInput({
           className: inputClass
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Textarea:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Textarea:
       return /* @__PURE__ */ jsxRuntime.jsx(
         "textarea",
         {
@@ -5248,7 +5249,7 @@ function FieldInput({
           className: cn(inputClass, "resize-none", classNames?.textarea)
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Number:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Number:
       return /* @__PURE__ */ jsxRuntime.jsx(
         "input",
         {
@@ -5262,7 +5263,7 @@ function FieldInput({
           className: inputClass
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Select:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Select:
       return /* @__PURE__ */ jsxRuntime.jsxs(
         "select",
         {
@@ -5276,7 +5277,7 @@ function FieldInput({
           ]
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Radio:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Radio:
       return /* @__PURE__ */ jsxRuntime.jsx("div", { className: cn("space-y-2", classNames?.radioGroup), children: (field.options || []).map((opt) => /* @__PURE__ */ jsxRuntime.jsxs(
         "label",
         {
@@ -5301,7 +5302,7 @@ function FieldInput({
         },
         opt
       )) });
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Checkbox:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Checkbox:
       return /* @__PURE__ */ jsxRuntime.jsxs("label", { className: cn("flex items-center gap-2 text-sm cursor-pointer", classNames?.checkboxLabel), children: [
         /* @__PURE__ */ jsxRuntime.jsx(
           "input",
@@ -5314,7 +5315,7 @@ function FieldInput({
         ),
         field.placeholder || field.name
       ] });
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Color:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Color:
       return /* @__PURE__ */ jsxRuntime.jsx(
         "input",
         {
@@ -5324,7 +5325,7 @@ function FieldInput({
           className: cn("w-12 h-10 rounded-md border border-input cursor-pointer", classNames?.colorInput)
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Date:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Date:
       return /* @__PURE__ */ jsxRuntime.jsx(
         "input",
         {
@@ -5335,8 +5336,8 @@ function FieldInput({
           className: inputClass
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.File:
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Image:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.File:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Image:
       return /* @__PURE__ */ jsxRuntime.jsx(
         FileUploadInput,
         {
@@ -5347,7 +5348,7 @@ function FieldInput({
           classNames
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Email:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Email:
       return /* @__PURE__ */ jsxRuntime.jsx(
         "input",
         {
@@ -5359,7 +5360,7 @@ function FieldInput({
           className: inputClass
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.DateTime: {
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.DateTime: {
       const dtLocalValue = typeof value === "string" && value.includes("T") ? value.slice(0, 16) : typeof value === "string" ? value : "";
       return /* @__PURE__ */ jsxRuntime.jsx(
         "input",
@@ -5379,7 +5380,7 @@ function FieldInput({
         }
       );
     }
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Time:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Time:
       return /* @__PURE__ */ jsxRuntime.jsx(
         "input",
         {
@@ -5390,7 +5391,7 @@ function FieldInput({
           className: inputClass
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.MultiSelect:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.MultiSelect:
       return /* @__PURE__ */ jsxRuntime.jsx(
         MultiSelectInput,
         {
@@ -5400,7 +5401,7 @@ function FieldInput({
           classNames
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.DateRange:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.DateRange:
       return /* @__PURE__ */ jsxRuntime.jsx(
         DateRangeInput,
         {
@@ -5411,7 +5412,7 @@ function FieldInput({
           inputClass
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Address:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Address:
       return /* @__PURE__ */ jsxRuntime.jsx(
         AddressInput,
         {
@@ -5422,7 +5423,7 @@ function FieldInput({
           inputClass
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Location:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Location:
       return /* @__PURE__ */ jsxRuntime.jsx(
         LocationInput,
         {
@@ -5433,7 +5434,7 @@ function FieldInput({
           inputClass
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Phone:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Phone:
       return /* @__PURE__ */ jsxRuntime.jsx(
         PhoneInput,
         {
@@ -5444,7 +5445,7 @@ function FieldInput({
           inputClass
         }
       );
-    case chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Signature:
+    case chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Signature:
       return /* @__PURE__ */ jsxRuntime.jsx(
         SignatureInput,
         {
@@ -5477,7 +5478,7 @@ function FileUploadInput({
   const [isUploading, setIsUploading] = React10__default.default.useState(false);
   const fileUrl = typeof value === "string" ? value : void 0;
   const acceptedFormats = field.validation?.accepted_formats;
-  const accept = acceptedFormats ? acceptedFormats.map((f) => `.${f}`).join(",") : field.field_type === chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Image ? "image/*" : void 0;
+  const accept = acceptedFormats ? acceptedFormats.map((f) => `.${f}`).join(",") : field.field_type === chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Image ? "image/*" : void 0;
   const handleFile = async (file) => {
     if (!onFileUpload) return;
     if (field.validation?.max_size_mb) {
@@ -5495,7 +5496,7 @@ function FileUploadInput({
     }
   };
   return /* @__PURE__ */ jsxRuntime.jsx("div", { className: cn("space-y-2", classNames?.fileInput), children: fileUrl ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-3", children: [
-    field.field_type === chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Image && /* @__PURE__ */ jsxRuntime.jsx("img", { src: fileUrl, alt: "Uploaded", className: "w-16 h-16 object-cover rounded-md border border-border" }),
+    field.field_type === chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Image && /* @__PURE__ */ jsxRuntime.jsx("img", { src: fileUrl, alt: "Uploaded", className: "w-16 h-16 object-cover rounded-md border border-border" }),
     /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex-1 min-w-0", children: /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm text-foreground truncate", children: fileUrl.split("/").pop() }) }),
     /* @__PURE__ */ jsxRuntime.jsx(
       "button",
@@ -5521,7 +5522,7 @@ function FileUploadInput({
       }
     ),
     isUploading ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm text-muted-foreground", children: "Uploading..." }) : /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm text-muted-foreground", children: field.placeholder || `Upload ${field.field_type === chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Image ? "image" : "file"}` }),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm text-muted-foreground", children: field.placeholder || `Upload ${field.field_type === chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Image ? "image" : "file"}` }),
       acceptedFormats && /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "text-xs text-muted-foreground/60 mt-1", children: [
         acceptedFormats.map((f) => f.toUpperCase()).join(", "),
         field.validation?.max_size_mb && ` \xB7 Max ${field.validation.max_size_mb}MB`
@@ -6456,7 +6457,7 @@ function CartLineItemRow({
       children: [
         /* @__PURE__ */ jsxRuntime.jsxs("div", { "data-cimplify-cart-item-info": true, children: [
           /* @__PURE__ */ jsxRuntime.jsx("span", { "data-cimplify-cart-item-name": true, className: classNames?.itemName, children: item.product.name }),
-          item.variant && /* @__PURE__ */ jsxRuntime.jsx("span", { "data-cimplify-cart-item-variant": true, children: chunk5VHKZTFJ_js.getVariantDisplayName(item.variant, item.product.name) }),
+          item.variant && /* @__PURE__ */ jsxRuntime.jsx("span", { "data-cimplify-cart-item-variant": true, children: chunkBGCEKFLA_js.getVariantDisplayName(item.variant, item.product.name) }),
           item.addOnOptions && item.addOnOptions.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("span", { "data-cimplify-cart-item-addons": true, children: [
             "+ ",
             item.addOnOptions.map((opt) => opt.name).join(", ")
@@ -6465,7 +6466,7 @@ function CartLineItemRow({
           item.specialInstructions && /* @__PURE__ */ jsxRuntime.jsx("span", { "data-cimplify-cart-item-instructions": true, className: "text-xs text-muted-foreground", children: item.specialInstructions }),
           item.customerInputs && item.customerInputs.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("div", { "data-cimplify-cart-customer-inputs": true, className: classNames?.customerInputs, children: item.customerInputs.map((input) => /* @__PURE__ */ jsxRuntime.jsxs("div", { "data-cimplify-cart-input": true, children: [
             /* @__PURE__ */ jsxRuntime.jsx("span", { "data-cimplify-cart-input-label": true, children: input.field_name }),
-            /* @__PURE__ */ jsxRuntime.jsx("span", { "data-cimplify-cart-input-value": true, children: input.field_type === chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.File || input.field_type === chunk5VHKZTFJ_js.INPUT_FIELD_TYPE.Image ? String(input.value).split("/").pop() || "Uploaded file" : String(input.value) })
+            /* @__PURE__ */ jsxRuntime.jsx("span", { "data-cimplify-cart-input-value": true, children: input.field_type === chunkBGCEKFLA_js.INPUT_FIELD_TYPE.File || input.field_type === chunkBGCEKFLA_js.INPUT_FIELD_TYPE.Image ? String(input.value).split("/").pop() || "Uploaded file" : String(input.value) })
           ] }, input.field_id)) }),
           (item.lineType === "service" || item.product.type === "service") && item.scheduledStart && /* @__PURE__ */ jsxRuntime.jsxs("div", { "data-cimplify-cart-service-info": true, className: classNames?.serviceInfo, children: [
             /* @__PURE__ */ jsxRuntime.jsxs("span", { children: [
@@ -7017,7 +7018,7 @@ function FoodProductCard({
   const tags = product.tags || [];
   const isSignature = product.metadata?.is_signature === true;
   const isNew = product.metadata?.is_new === true;
-  const isComposite = product.type === chunk5VHKZTFJ_js.PRODUCT_TYPE.Composite;
+  const isComposite = product.type === chunkBGCEKFLA_js.PRODUCT_TYPE.Composite;
   return /* @__PURE__ */ jsxRuntime.jsxs(CardShell, { product, renderLink, className, children: [
     /* @__PURE__ */ jsxRuntime.jsxs(CardImage, { src: image, alt: product.name, aspectRatio: "square", renderImage, children: [
       isSignature && /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "absolute top-3 left-3 inline-flex items-center gap-1 text-[11px] font-semibold tracking-wide bg-amber-50 text-amber-700 border border-amber-200/60 px-2 py-0.5 rounded-md", children: [
@@ -7770,26 +7771,26 @@ var BUILT_IN_CARDS = {
   ["composite" /* Composite */]: CompositeProductCard,
   ["subscription" /* Subscription */]: SubscriptionCard
 };
-var RENTAL_UNITS = /* @__PURE__ */ new Set([chunk5VHKZTFJ_js.DURATION_UNIT.Days, chunk5VHKZTFJ_js.DURATION_UNIT.Hours]);
-var LEASE_UNITS = /* @__PURE__ */ new Set([chunk5VHKZTFJ_js.DURATION_UNIT.Weeks, chunk5VHKZTFJ_js.DURATION_UNIT.Months, chunk5VHKZTFJ_js.DURATION_UNIT.Years]);
+var RENTAL_UNITS = /* @__PURE__ */ new Set([chunkBGCEKFLA_js.DURATION_UNIT.Days, chunkBGCEKFLA_js.DURATION_UNIT.Hours]);
+var LEASE_UNITS = /* @__PURE__ */ new Set([chunkBGCEKFLA_js.DURATION_UNIT.Weeks, chunkBGCEKFLA_js.DURATION_UNIT.Months, chunkBGCEKFLA_js.DURATION_UNIT.Years]);
 function resolveCardVariant(product) {
-  if (product.type === chunk5VHKZTFJ_js.PRODUCT_TYPE.Bundle) {
+  if (product.type === chunkBGCEKFLA_js.PRODUCT_TYPE.Bundle) {
     return "bundle" /* Bundle */;
   }
-  if (product.type === chunk5VHKZTFJ_js.PRODUCT_TYPE.Composite) {
+  if (product.type === chunkBGCEKFLA_js.PRODUCT_TYPE.Composite) {
     return "composite" /* Composite */;
   }
   if (product.quantity_pricing && product.quantity_pricing.length > 1) {
     return "wholesale" /* Wholesale */;
   }
-  if (product.type === chunk5VHKZTFJ_js.PRODUCT_TYPE.Digital) {
+  if (product.type === chunkBGCEKFLA_js.PRODUCT_TYPE.Digital) {
     return "digital" /* Digital */;
   }
-  if (product.type === chunk5VHKZTFJ_js.PRODUCT_TYPE.Service) {
+  if (product.type === chunkBGCEKFLA_js.PRODUCT_TYPE.Service) {
     if (product.duration_unit && RENTAL_UNITS.has(product.duration_unit)) {
       return "rental" /* Rental */;
     }
-    if (product.duration_unit === chunk5VHKZTFJ_js.DURATION_UNIT.Nights) {
+    if (product.duration_unit === chunkBGCEKFLA_js.DURATION_UNIT.Nights) {
       return "accommodation" /* Accommodation */;
     }
     if (product.duration_unit && LEASE_UNITS.has(product.duration_unit)) {
@@ -7800,10 +7801,10 @@ function resolveCardVariant(product) {
     }
     return "standard" /* Standard */;
   }
-  if (product.render_hint === chunk5VHKZTFJ_js.RENDER_HINT.Food) {
+  if (product.render_hint === chunkBGCEKFLA_js.RENDER_HINT.Food) {
     return "food" /* Food */;
   }
-  if (product.render_hint === chunk5VHKZTFJ_js.RENDER_HINT.Physical) {
+  if (product.render_hint === chunkBGCEKFLA_js.RENDER_HINT.Physical) {
     return "retail" /* Retail */;
   }
   return "retail" /* Retail */;
@@ -10564,25 +10565,25 @@ function resolveTemplateKey(product) {
   if (typeof metaTemplate === "string" && metaTemplate.trim()) {
     return metaTemplate.trim();
   }
-  if (product.type === chunk5VHKZTFJ_js.PRODUCT_TYPE.Bundle) {
+  if (product.type === chunkBGCEKFLA_js.PRODUCT_TYPE.Bundle) {
     return "bundle" /* Bundle */;
   }
-  if (product.type === chunk5VHKZTFJ_js.PRODUCT_TYPE.Composite) {
+  if (product.type === chunkBGCEKFLA_js.PRODUCT_TYPE.Composite) {
     return "composite" /* Composite */;
   }
   if (product.quantity_pricing && product.quantity_pricing.length > 1) {
     return "wholesale" /* Wholesale */;
   }
-  if (product.type === chunk5VHKZTFJ_js.PRODUCT_TYPE.Service) {
+  if (product.type === chunkBGCEKFLA_js.PRODUCT_TYPE.Service) {
     return "service" /* Service */;
   }
-  if (product.type === chunk5VHKZTFJ_js.PRODUCT_TYPE.Digital) {
+  if (product.type === chunkBGCEKFLA_js.PRODUCT_TYPE.Digital) {
     return "digital" /* Digital */;
   }
-  if (product.render_hint === chunk5VHKZTFJ_js.RENDER_HINT.Food) {
+  if (product.render_hint === chunkBGCEKFLA_js.RENDER_HINT.Food) {
     return "food" /* Food */;
   }
-  if (product.render_hint === chunk5VHKZTFJ_js.RENDER_HINT.Physical) {
+  if (product.render_hint === chunkBGCEKFLA_js.RENDER_HINT.Physical) {
     return "physical" /* Physical */;
   }
   return "default" /* Default */;
@@ -12646,7 +12647,7 @@ function SparkleIcon({ className }) {
 
 Object.defineProperty(exports, "getVariantDisplayName", {
   enumerable: true,
-  get: function () { return chunk5VHKZTFJ_js.getVariantDisplayName; }
+  get: function () { return chunkBGCEKFLA_js.getVariantDisplayName; }
 });
 exports.AccommodationCard = AccommodationCard;
 exports.Ad = Ad;

package/dist/react.mjs

@@ -1,6 +1,7 @@
 "use client";
-import { DURATION_UNIT, getVariantDisplayName, INPUT_FIELD_TYPE, PRODUCT_TYPE, createCimplifyClient, RENDER_HINT } from './chunk-JTU5P6GM.mjs';
-export { getVariantDisplayName } from './chunk-JTU5P6GM.mjs';
+import { DURATION_UNIT, getVariantDisplayName, INPUT_FIELD_TYPE, PRODUCT_TYPE, RENDER_HINT } from './chunk-IRJFDKFV.mjs';
+export { getVariantDisplayName } from './chunk-IRJFDKFV.mjs';
+import { createCimplifyClient } from './chunk-3WD6U5RD.mjs';
 import { ELEMENT_TYPES, EVENT_TYPES } from './chunk-EZK2FXTM.mjs';
 import { isSupportedCurrency, formatPrice, parsePrice, getUnitPriceAtQuantity, isOnSale, getDiscountPercentage, getBasePrice, getPriceRange, formatPriceRange } from './chunk-6TVQQYQ5.mjs';
 import React10, { createContext, useRef, useState, useCallback, useEffect, useContext, useMemo, useId, useSyncExternalStore } from 'react';

package/dist/server.d.mts

@@ -0,0 +1,97 @@
+import { C as CimplifyClient } from './client-CkGlXZRd.mjs';
+export { aN as Result } from './client-CkGlXZRd.mjs';
+export { am as Category, h as CimplifyError, ao as Collection, U as Product, a7 as ProductWithDetails } from './payment-DA1i5hhk.mjs';
+
+interface ServerClientOptions {
+    /**
+     * Cimplify API base URL. Defaults to `CIMPLIFY_API_URL`,
+     * then `NEXT_PUBLIC_CIMPLIFY_API_URL`, then the local mock at
+     * `http://127.0.0.1:8787` for dev.
+     */
+    apiUrl?: string;
+    /**
+     * Server-only key. Defaults to `CIMPLIFY_SECRET_KEY`. Falls back to the
+     * publishable key (`NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY`) so the local mock
+     * works without forcing consumers to set a fake secret in dev.
+     */
+    secretKey?: string;
+    /** Optional location id used by location-scoped queries. */
+    locationId?: string;
+}
+/**
+ * Returns a `CimplifyClient` configured for server-side execution and
+ * memoized **per request** via React's `cache()` — calling this multiple
+ * times within a single render tree returns the same instance, so RSC
+ * fan-out doesn't create N clients.
+ *
+ * The returned client is the exact same surface the browser uses — every
+ * resource (catalogue, cart, checkout, …) and every method works identically.
+ * Caching is Next.js's responsibility: wrap your composed reads with
+ * `'use cache'` + `cacheTag` (using the tag builders from `@cimplify/sdk/server`),
+ * or set `next: { revalidate, tags }` on individual fetches.
+ *
+ * Errors continue to flow through `Result<T, CimplifyError>`. Use the SDK's
+ * `unwrap()` helper, or `if (!result.ok) notFound()` — whichever is
+ * idiomatic for the route.
+ *
+ * @example
+ *   import { getServerClient, tags } from "@cimplify/sdk/server";
+ *   import { cacheTag, cacheLife } from "next/cache";
+ *
+ *   async function getProduct(slug: string) {
+ *     "use cache";
+ *     cacheTag(tags.product(slug));
+ *     cacheLife("hours");
+ *     const r = await getServerClient().catalogue.getProductBySlug(slug);
+ *     if (!r.ok) throw new Error(r.error.message);
+ *     return r.value;
+ *   }
+ */
+declare const getServerClient: (opts?: ServerClientOptions) => CimplifyClient;
+
+/**
+ * Cimplify cache-tag scheme.
+ *
+ * Use these constants/builders to tag fetches and invalidate them. The
+ * shape is namespaced (`cimplify:<resource>` and `cimplify:<resource>:<id>`)
+ * so consumer cache tags can't accidentally collide. Tag strings should
+ * always be constructed via these builders so the scheme stays in one place.
+ */
+declare const tags: {
+    readonly products: () => string;
+    readonly product: (id: string) => string;
+    readonly categories: () => string;
+    readonly category: (id: string) => string;
+    readonly categoryProducts: (id: string) => string;
+    readonly collections: () => string;
+    readonly collection: (id: string) => string;
+    readonly collectionProducts: (id: string) => string;
+    readonly business: () => string;
+    readonly locations: () => string;
+    readonly orders: (customerId: string) => string;
+    readonly order: (id: string) => string;
+};
+
+/**
+ * Invalidate every cache entry tagged with the products list. Call after a
+ * Server Action that creates / deletes / reorders products.
+ */
+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.
+ */
+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>;
+/**
+ * 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>;
+
+export { CimplifyClient, type ServerClientOptions, getServerClient, revalidateBusiness, revalidateByTag, revalidateCategories, revalidateCategory, revalidateCollection, revalidateCollections, revalidateProduct, revalidateProducts, tags };

package/dist/server.d.ts

@@ -0,0 +1,97 @@
+import { C as CimplifyClient } from './client-lvLvB1_K.js';
+export { aN as Result } from './client-lvLvB1_K.js';
+export { am as Category, h as CimplifyError, ao as Collection, U as Product, a7 as ProductWithDetails } from './payment-DA1i5hhk.js';
+
+interface ServerClientOptions {
+    /**
+     * Cimplify API base URL. Defaults to `CIMPLIFY_API_URL`,
+     * then `NEXT_PUBLIC_CIMPLIFY_API_URL`, then the local mock at
+     * `http://127.0.0.1:8787` for dev.
+     */
+    apiUrl?: string;
+    /**
+     * Server-only key. Defaults to `CIMPLIFY_SECRET_KEY`. Falls back to the
+     * publishable key (`NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY`) so the local mock
+     * works without forcing consumers to set a fake secret in dev.
+     */
+    secretKey?: string;
+    /** Optional location id used by location-scoped queries. */
+    locationId?: string;
+}
+/**
+ * Returns a `CimplifyClient` configured for server-side execution and
+ * memoized **per request** via React's `cache()` — calling this multiple
+ * times within a single render tree returns the same instance, so RSC
+ * fan-out doesn't create N clients.
+ *
+ * The returned client is the exact same surface the browser uses — every
+ * resource (catalogue, cart, checkout, …) and every method works identically.
+ * Caching is Next.js's responsibility: wrap your composed reads with
+ * `'use cache'` + `cacheTag` (using the tag builders from `@cimplify/sdk/server`),
+ * or set `next: { revalidate, tags }` on individual fetches.
+ *
+ * Errors continue to flow through `Result<T, CimplifyError>`. Use the SDK's
+ * `unwrap()` helper, or `if (!result.ok) notFound()` — whichever is
+ * idiomatic for the route.
+ *
+ * @example
+ *   import { getServerClient, tags } from "@cimplify/sdk/server";
+ *   import { cacheTag, cacheLife } from "next/cache";
+ *
+ *   async function getProduct(slug: string) {
+ *     "use cache";
+ *     cacheTag(tags.product(slug));
+ *     cacheLife("hours");
+ *     const r = await getServerClient().catalogue.getProductBySlug(slug);
+ *     if (!r.ok) throw new Error(r.error.message);
+ *     return r.value;
+ *   }
+ */
+declare const getServerClient: (opts?: ServerClientOptions) => CimplifyClient;
+
+/**
+ * Cimplify cache-tag scheme.
+ *
+ * Use these constants/builders to tag fetches and invalidate them. The
+ * shape is namespaced (`cimplify:<resource>` and `cimplify:<resource>:<id>`)
+ * so consumer cache tags can't accidentally collide. Tag strings should
+ * always be constructed via these builders so the scheme stays in one place.
+ */
+declare const tags: {
+    readonly products: () => string;
+    readonly product: (id: string) => string;
+    readonly categories: () => string;
+    readonly category: (id: string) => string;
+    readonly categoryProducts: (id: string) => string;
+    readonly collections: () => string;
+    readonly collection: (id: string) => string;
+    readonly collectionProducts: (id: string) => string;
+    readonly business: () => string;
+    readonly locations: () => string;
+    readonly orders: (customerId: string) => string;
+    readonly order: (id: string) => string;
+};
+
+/**
+ * Invalidate every cache entry tagged with the products list. Call after a
+ * Server Action that creates / deletes / reorders products.
+ */
+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.
+ */
+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>;
+/**
+ * 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>;
+
+export { CimplifyClient, type ServerClientOptions, getServerClient, revalidateBusiness, revalidateByTag, revalidateCategories, revalidateCategory, revalidateCollection, revalidateCollections, revalidateProduct, revalidateProducts, tags };

package/dist/server.js

@@ -0,0 +1,107 @@
+'use strict';
+
+var chunkOMAP327U_js = require('./chunk-OMAP327U.js');
+require('./chunk-BAWKQRIB.js');
+var chunkV2O5AO7I_js = require('./chunk-V2O5AO7I.js');
+var react = require('react');
+
+var DEFAULT_DEV_URL = "http://127.0.0.1:8787";
+function readEnv(...keys) {
+  const env = globalThis.process?.env;
+  if (!env) return void 0;
+  for (const k of keys) {
+    const v = env[k]?.trim();
+    if (v) return v;
+  }
+  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 publicKey = opts.secretKey ?? readEnv("CIMPLIFY_SECRET_KEY", "NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY") ?? "mock-dev";
+  const client = chunkOMAP327U_js.createCimplifyClient({
+    baseUrl,
+    publicKey,
+    suppressPublicKeyWarning: true
+  });
+  if (opts.locationId) {
+    client.setLocationId(opts.locationId);
+  }
+  return client;
+});
+
+// src/server/tags.ts
+var tags = {
+  products: () => "cimplify:products",
+  product: (id) => `cimplify:product:${id}`,
+  categories: () => "cimplify:categories",
+  category: (id) => `cimplify:category:${id}`,
+  categoryProducts: (id) => `cimplify:category:${id}:products`,
+  collections: () => "cimplify:collections",
+  collection: (id) => `cimplify:collection:${id}`,
+  collectionProducts: (id) => `cimplify:collection:${id}:products`,
+  business: () => "cimplify:business",
+  locations: () => "cimplify:locations",
+  orders: (customerId) => `cimplify:orders:${customerId}`,
+  order: (id) => `cimplify:order:${id}`
+};
+
+// src/server/revalidate.ts
+var _revalidateTag = null;
+async function getRevalidateTag() {
+  if (_revalidateTag) return _revalidateTag;
+  const specifier = "next/cache";
+  const mod = await import(
+    /* webpackIgnore: true */
+    /* @vite-ignore */
+    specifier
+  );
+  _revalidateTag = mod.revalidateTag;
+  return _revalidateTag;
+}
+async function revalidate(...tagList) {
+  const fn = await getRevalidateTag();
+  for (const t of tagList) fn(t);
+}
+async function revalidateProducts() {
+  return revalidate(tags.products());
+}
+async function revalidateProduct(id) {
+  return revalidate(tags.product(id), tags.products());
+}
+async function revalidateCategories() {
+  return revalidate(tags.categories());
+}
+async function revalidateCategory(id) {
+  return revalidate(tags.category(id), tags.categoryProducts(id), tags.categories());
+}
+async function revalidateCollections() {
+  return revalidate(tags.collections());
+}
+async function revalidateCollection(id) {
+  return revalidate(
+    tags.collection(id),
+    tags.collectionProducts(id),
+    tags.collections()
+  );
+}
+async function revalidateBusiness() {
+  return revalidate(tags.business());
+}
+async function revalidateByTag(tag) {
+  return revalidate(tag);
+}
+
+Object.defineProperty(exports, "CimplifyError", {
+  enumerable: true,
+  get: function () { return chunkV2O5AO7I_js.CimplifyError; }
+});
+exports.getServerClient = getServerClient;
+exports.revalidateBusiness = revalidateBusiness;
+exports.revalidateByTag = revalidateByTag;
+exports.revalidateCategories = revalidateCategories;
+exports.revalidateCategory = revalidateCategory;
+exports.revalidateCollection = revalidateCollection;
+exports.revalidateCollections = revalidateCollections;
+exports.revalidateProduct = revalidateProduct;
+exports.revalidateProducts = revalidateProducts;
+exports.tags = tags;