@cimplify/sdk 0.6.7 → 0.6.9

package/dist/react.mjs

@@ -711,6 +711,15 @@ function CimplifyCheckout({
 }
 
 // src/types/common.ts
+function money(value) {
+  return value;
+}
+function moneyFromNumber(value) {
+  return value.toFixed(2);
+}
+function currencyCode(value) {
+  return value;
+}
 var ErrorCode = {
   // General
   UNKNOWN_ERROR: "UNKNOWN_ERROR",
@@ -822,6 +831,11 @@ function err(error) {
   return { ok: false, error };
 }
 
+// src/query/builder.ts
+function escapeQueryValue(value) {
+  return value.replace(/'/g, "\\'");
+}
+
 // src/catalogue.ts
 function toCimplifyError(error) {
   if (error instanceof CimplifyError) return enrichError(error);
@@ -902,7 +916,7 @@ var CatalogueQueries = class {
     let query = "products";
     const filters = [];
     if (options?.category) {
-      filters.push(`@.category_id=='${options.category}'`);
+      filters.push(`@.category_id=='${escapeQueryValue(options.category)}'`);
     }
     if (options?.featured !== void 0) {
       filters.push(`@.featured==${options.featured}`);
@@ -911,7 +925,7 @@ var CatalogueQueries = class {
       filters.push(`@.in_stock==${options.in_stock}`);
     }
     if (options?.search) {
-      filters.push(`@.name contains '${options.search}'`);
+      filters.push(`@.name contains '${escapeQueryValue(options.search)}'`);
     }
     if (options?.min_price !== void 0) {
       filters.push(`@.price>=${options.min_price}`);
@@ -942,7 +956,9 @@ var CatalogueQueries = class {
   }
   async getProductBySlug(slug) {
     const filteredResult = await safe(
-      this.client.query(`products[?(@.slug=='${slug}')]`)
+      this.client.query(
+        `products[?(@.slug=='${escapeQueryValue(slug)}')]`
+      )
     );
     if (!filteredResult.ok) return filteredResult;
     const exactMatch = findProductBySlug(filteredResult.value, slug);
@@ -994,7 +1010,7 @@ var CatalogueQueries = class {
   }
   async getCategoryBySlug(slug) {
     const result = await safe(
-      this.client.query(`categories[?(@.slug=='${slug}')]`)
+      this.client.query(`categories[?(@.slug=='${escapeQueryValue(slug)}')]`)
     );
     if (!result.ok) return result;
     if (!result.value.length) {
@@ -1003,7 +1019,11 @@ var CatalogueQueries = class {
     return ok(result.value[0]);
   }
   async getCategoryProducts(categoryId) {
-    return safe(this.client.query(`products[?(@.category_id=='${categoryId}')]`));
+    return safe(
+      this.client.query(
+        `products[?(@.category_id=='${escapeQueryValue(categoryId)}')]`
+      )
+    );
   }
   async getCollections() {
     return safe(this.client.query("collections"));
@@ -1013,7 +1033,9 @@ var CatalogueQueries = class {
   }
   async getCollectionBySlug(slug) {
     const result = await safe(
-      this.client.query(`collections[?(@.slug=='${slug}')]`)
+      this.client.query(
+        `collections[?(@.slug=='${escapeQueryValue(slug)}')]`
+      )
     );
     if (!result.ok) return result;
     if (!result.value.length) {
@@ -1026,7 +1048,9 @@ var CatalogueQueries = class {
   }
   async searchCollections(query, limit = 20) {
     return safe(
-      this.client.query(`collections[?(@.name contains '${query}')]#limit(${limit})`)
+      this.client.query(
+        `collections[?(@.name contains '${escapeQueryValue(query)}')]#limit(${limit})`
+      )
     );
   }
   async getBundles() {
@@ -1037,7 +1061,9 @@ var CatalogueQueries = class {
   }
   async getBundleBySlug(slug) {
     const result = await safe(
-      this.client.query(`bundles[?(@.slug=='${slug}')]`)
+      this.client.query(
+        `bundles[?(@.slug=='${escapeQueryValue(slug)}')]`
+      )
     );
     if (!result.ok) return result;
     if (!result.value.length) {
@@ -1047,7 +1073,9 @@ var CatalogueQueries = class {
   }
   async searchBundles(query, limit = 20) {
     return safe(
-      this.client.query(`bundles[?(@.name contains '${query}')]#limit(${limit})`)
+      this.client.query(
+        `bundles[?(@.name contains '${escapeQueryValue(query)}')]#limit(${limit})`
+      )
     );
   }
   async getComposites(options) {
@@ -1087,9 +1115,9 @@ var CatalogueQueries = class {
   }
   async search(query, options) {
     const limit = options?.limit ?? 20;
-    let searchQuery = `products[?(@.name contains '${query}')]`;
+    let searchQuery = `products[?(@.name contains '${escapeQueryValue(query)}')]`;
     if (options?.category) {
-      searchQuery = `products[?(@.name contains '${query}' && @.category_id=='${options.category}')]`;
+      searchQuery = `products[?(@.name contains '${escapeQueryValue(query)}' && @.category_id=='${escapeQueryValue(options.category)}')]`;
     }
     searchQuery += `#limit(${limit})`;
     return safe(this.client.query(searchQuery));
@@ -1106,7 +1134,7 @@ var CatalogueQueries = class {
   async getMenu(options) {
     let query = "menu";
     if (options?.category) {
-      query = `menu[?(@.category=='${options.category}')]`;
+      query = `menu[?(@.category=='${escapeQueryValue(options.category)}')]`;
     }
     if (options?.limit) {
       query += `#limit(${options.limit})`;
@@ -1253,9 +1281,6 @@ var CartOperations = class {
 
 // src/constants.ts
 var LINK_QUERY = {
-  DATA: "link.data",
-  ADDRESSES: "link.addresses",
-  MOBILE_MONEY: "link.mobile_money",
   PREFERENCES: "link.preferences"};
 var LINK_MUTATION = {
   CHECK_STATUS: "link.check_status",
@@ -1264,12 +1289,8 @@ var LINK_MUTATION = {
   UPDATE_PREFERENCES: "link.update_preferences",
   CREATE_ADDRESS: "link.create_address",
   UPDATE_ADDRESS: "link.update_address",
-  DELETE_ADDRESS: "link.delete_address",
-  SET_DEFAULT_ADDRESS: "link.set_default_address",
   TRACK_ADDRESS_USAGE: "link.track_address_usage",
   CREATE_MOBILE_MONEY: "link.create_mobile_money",
-  DELETE_MOBILE_MONEY: "link.delete_mobile_money",
-  SET_DEFAULT_MOBILE_MONEY: "link.set_default_mobile_money",
   TRACK_MOBILE_MONEY_USAGE: "link.track_mobile_money_usage",
   VERIFY_MOBILE_MONEY: "link.verify_mobile_money"};
 var AUTH_MUTATION = {
@@ -1400,6 +1421,8 @@ function normalizeStatusResponse(response) {
   }
   const res = response;
   const normalizedStatus = normalizePaymentStatusValue(res.status ?? void 0);
+  const normalizedAmount = typeof res.amount === "string" ? money(res.amount) : typeof res.amount === "number" && Number.isFinite(res.amount) ? moneyFromNumber(res.amount) : void 0;
+  const normalizedCurrency = typeof res.currency === "string" && res.currency.trim().length > 0 ? currencyCode(res.currency) : void 0;
   const paidValue = res.paid === true;
   const derivedPaid = paidValue || [
     "success",
@@ -1412,8 +1435,8 @@ function normalizeStatusResponse(response) {
   return {
     status: normalizedStatus,
     paid: derivedPaid,
-    amount: res.amount,
-    currency: res.currency,
+    amount: normalizedAmount,
+    currency: normalizedCurrency,
     reference: res.reference,
     message: res.message || ""
   };
@@ -2105,14 +2128,17 @@ var CheckoutService = class {
       pay_currency: data.pay_currency,
       fx_quote_id: data.fx_quote_id
     };
-    const baseCurrency = (cart.pricing.currency || checkoutData.pay_currency || "GHS").toUpperCase();
+    const baseCurrency = currencyCode(
+      (cart.pricing.currency || checkoutData.pay_currency || "GHS").toUpperCase()
+    );
     const payCurrency = data.pay_currency?.trim().toUpperCase();
+    const payCurrencyCode = payCurrency ? currencyCode(payCurrency) : void 0;
     const cartTotalAmount = Number.parseFloat(cart.pricing.total_price || "0");
-    if (payCurrency && payCurrency !== baseCurrency && !checkoutData.fx_quote_id && Number.isFinite(cartTotalAmount) && cartTotalAmount > 0) {
+    if (payCurrencyCode && payCurrencyCode !== baseCurrency && !checkoutData.fx_quote_id && Number.isFinite(cartTotalAmount) && cartTotalAmount > 0) {
       const fxQuoteResult = await this.client.fx.lockQuote({
         from: baseCurrency,
-        to: payCurrency,
-        amount: cartTotalAmount
+        to: payCurrencyCode,
+        amount: cart.pricing.total_price
       });
       if (!fxQuoteResult.ok) {
         return ok(
@@ -2123,7 +2149,7 @@ var CheckoutService = class {
           )
         );
       }
-      checkoutData.pay_currency = payCurrency;
+      checkoutData.pay_currency = payCurrencyCode;
       checkoutData.fx_quote_id = fxQuoteResult.value.id;
     }
     data.on_status_change?.("processing", {});
@@ -2228,6 +2254,9 @@ var LinkService = class {
   constructor(client) {
     this.client = client;
   }
+  async getProfile() {
+    return safe5(this.client.linkGet("/v1/link/profile"));
+  }
   async requestOtp(input) {
     return safe5(this.client.linkPost("/v1/link/auth/request-otp", input));
   }
@@ -2255,13 +2284,13 @@ var LinkService = class {
     );
   }
   async getLinkData() {
-    return safe5(this.client.query(LINK_QUERY.DATA));
+    return safe5(this.client.linkGet("/v1/link/data"));
   }
   async getAddresses() {
-    return safe5(this.client.query(LINK_QUERY.ADDRESSES));
+    return safe5(this.client.linkGet("/v1/link/addresses"));
   }
   async getMobileMoney() {
-    return safe5(this.client.query(LINK_QUERY.MOBILE_MONEY));
+    return safe5(this.client.linkGet("/v1/link/mobile-money"));
   }
   async getPreferences() {
     return safe5(this.client.query(LINK_QUERY.PREFERENCES));
@@ -2284,10 +2313,10 @@ var LinkService = class {
     return safe5(this.client.call(LINK_MUTATION.UPDATE_ADDRESS, input));
   }
   async deleteAddress(addressId) {
-    return safe5(this.client.call(LINK_MUTATION.DELETE_ADDRESS, addressId));
+    return safe5(this.client.linkDelete(`/v1/link/addresses/${addressId}`));
   }
   async setDefaultAddress(addressId) {
-    return safe5(this.client.call(LINK_MUTATION.SET_DEFAULT_ADDRESS, addressId));
+    return safe5(this.client.linkPost(`/v1/link/addresses/${addressId}/default`));
   }
   async trackAddressUsage(addressId) {
     return safe5(
@@ -2300,11 +2329,13 @@ var LinkService = class {
     return safe5(this.client.call(LINK_MUTATION.CREATE_MOBILE_MONEY, input));
   }
   async deleteMobileMoney(mobileMoneyId) {
-    return safe5(this.client.call(LINK_MUTATION.DELETE_MOBILE_MONEY, mobileMoneyId));
+    return safe5(
+      this.client.linkDelete(`/v1/link/mobile-money/${mobileMoneyId}`)
+    );
   }
   async setDefaultMobileMoney(mobileMoneyId) {
     return safe5(
-      this.client.call(LINK_MUTATION.SET_DEFAULT_MOBILE_MONEY, mobileMoneyId)
+      this.client.linkPost(`/v1/link/mobile-money/${mobileMoneyId}/default`)
     );
   }
   async trackMobileMoneyUsage(mobileMoneyId) {
@@ -3430,7 +3461,7 @@ var CimplifyClient = class {
     this.retryDelay = config.retryDelay ?? DEFAULT_RETRY_DELAY_MS;
     this.hooks = config.hooks ?? {};
     this.accessToken = this.loadAccessToken();
-    if (!this.publicKey) {
+    if (!this.publicKey && !config.suppressPublicKeyWarning) {
       console.warn(
         '[Cimplify] No public key found. Set NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY in your environment, or pass { publicKey: "pk_..." } to createCimplifyClient().'
       );
@@ -3543,9 +3574,12 @@ var CimplifyClient = class {
   }
   getHeaders() {
     const headers = {
-      "Content-Type": "application/json",
-      "X-API-Key": this.publicKey
+      "Content-Type": "application/json"
     };
+    const trimmedPublicKey = this.publicKey.trim();
+    if (trimmedPublicKey) {
+      headers["X-API-Key"] = trimmedPublicKey;
+    }
     if (this.accessToken) {
       headers["Authorization"] = `Bearer ${this.accessToken}`;
     }
@@ -3574,7 +3608,7 @@ var CimplifyClient = class {
           signal: controller.signal
         });
         clearTimeout(timeoutId);
-        if (response.ok || response.status >= 400 && response.status < 500) {
+        if (response.ok) {
           this.hooks.onRequestSuccess?.({
             ...context,
             status: response.status,
@@ -3582,6 +3616,21 @@ var CimplifyClient = class {
           });
           return response;
         }
+        if (response.status >= 400 && response.status < 500) {
+          this.hooks.onRequestError?.({
+            ...context,
+            error: new CimplifyError(
+              `HTTP_${response.status}`,
+              `Request failed with status ${response.status}`,
+              false
+            ),
+            status: response.status,
+            durationMs: Date.now() - startTime,
+            retryCount,
+            retryable: false
+          });
+          return response;
+        }
         if (response.status >= 500 && attempt < this.maxRetries) {
           retryCount++;
           const delay = this.retryDelay * Math.pow(2, attempt);
@@ -3594,10 +3643,17 @@ var CimplifyClient = class {
           await sleep(delay);
           continue;
         }
-        this.hooks.onRequestSuccess?.({
+        this.hooks.onRequestError?.({
           ...context,
+          error: new CimplifyError(
+            "SERVER_ERROR",
+            `Server error ${response.status} after ${retryCount} retries`,
+            false
+          ),
           status: response.status,
-          durationMs: Date.now() - startTime
+          durationMs: Date.now() - startTime,
+          retryCount,
+          retryable: false
         });
         return response;
       } catch (error) {
@@ -5083,6 +5139,750 @@ function useLocations(options = {}) {
     isLoading
   };
 }
+var collectionsCache = /* @__PURE__ */ new Map();
+var collectionsInflight = /* @__PURE__ */ new Map();
+function buildCollectionsCacheKey(client, locationId) {
+  return JSON.stringify({
+    key: client.getPublicKey(),
+    location_id: locationId || "__none__"
+  });
+}
+function useCollections(options = {}) {
+  const context = useOptionalCimplify();
+  const client = options.client ?? context?.client;
+  if (!client) {
+    throw new Error("useCollections must be used within CimplifyProvider or passed { client }.");
+  }
+  const enabled = options.enabled ?? true;
+  const locationId = client.getLocationId();
+  const previousLocationIdRef = useRef(locationId);
+  const requestIdRef = useRef(0);
+  const cacheKey = useMemo(
+    () => buildCollectionsCacheKey(client, locationId),
+    [client, locationId]
+  );
+  const cached = collectionsCache.get(cacheKey);
+  const [collections, setCollections] = useState(cached?.collections ?? []);
+  const [isLoading, setIsLoading] = useState(enabled && !cached);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (previousLocationIdRef.current !== locationId) {
+      collectionsCache.clear();
+      collectionsInflight.clear();
+      previousLocationIdRef.current = locationId;
+    }
+  }, [locationId]);
+  const load = useCallback(
+    async (force = false) => {
+      if (!enabled) {
+        setIsLoading(false);
+        return;
+      }
+      const nextRequestId = ++requestIdRef.current;
+      setError(null);
+      if (!force) {
+        const cacheEntry = collectionsCache.get(cacheKey);
+        if (cacheEntry) {
+          setCollections(cacheEntry.collections);
+          setIsLoading(false);
+          return;
+        }
+      }
+      setIsLoading(true);
+      try {
+        const existing = collectionsInflight.get(cacheKey);
+        const promise = existing ?? (async () => {
+          const result = await client.catalogue.getCollections();
+          if (!result.ok) {
+            throw result.error;
+          }
+          return result.value;
+        })();
+        if (!existing) {
+          collectionsInflight.set(cacheKey, promise);
+          promise.finally(() => {
+            collectionsInflight.delete(cacheKey);
+          }).catch(() => void 0);
+        }
+        const value = await promise;
+        collectionsCache.set(cacheKey, { collections: value });
+        if (nextRequestId === requestIdRef.current) {
+          setCollections(value);
+          setError(null);
+        }
+      } catch (loadError) {
+        if (nextRequestId === requestIdRef.current) {
+          setError(loadError);
+        }
+      } finally {
+        if (nextRequestId === requestIdRef.current) {
+          setIsLoading(false);
+        }
+      }
+    },
+    [cacheKey, client, enabled]
+  );
+  useEffect(() => {
+    void load(false);
+  }, [load]);
+  const refetch = useCallback(async () => {
+    collectionsCache.delete(cacheKey);
+    await load(true);
+  }, [cacheKey, load]);
+  return { collections, isLoading, error, refetch };
+}
+var collectionCache = /* @__PURE__ */ new Map();
+var collectionInflight = /* @__PURE__ */ new Map();
+function isLikelySlug2(value) {
+  return /^[a-z0-9-]+$/.test(value);
+}
+function buildCollectionCacheKey(client, locationId, idOrSlug) {
+  return JSON.stringify({
+    key: client.getPublicKey(),
+    location_id: locationId || "__none__",
+    collection: idOrSlug
+  });
+}
+function useCollection(idOrSlug, options = {}) {
+  const context = useOptionalCimplify();
+  const client = options.client ?? context?.client;
+  if (!client) {
+    throw new Error("useCollection must be used within CimplifyProvider or passed { client }.");
+  }
+  const enabled = options.enabled ?? true;
+  const locationId = client.getLocationId();
+  const previousLocationIdRef = useRef(locationId);
+  const requestIdRef = useRef(0);
+  const normalizedIdOrSlug = useMemo(() => (idOrSlug || "").trim(), [idOrSlug]);
+  const cacheKey = useMemo(
+    () => buildCollectionCacheKey(client, locationId, normalizedIdOrSlug),
+    [client, locationId, normalizedIdOrSlug]
+  );
+  const cached = collectionCache.get(cacheKey);
+  const [collection, setCollection] = useState(cached?.collection ?? null);
+  const [products, setProducts] = useState(cached?.products ?? []);
+  const [isLoading, setIsLoading] = useState(
+    enabled && normalizedIdOrSlug.length > 0 && !cached
+  );
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (previousLocationIdRef.current !== locationId) {
+      collectionCache.clear();
+      collectionInflight.clear();
+      previousLocationIdRef.current = locationId;
+    }
+  }, [locationId]);
+  const load = useCallback(
+    async (force = false) => {
+      if (!enabled || normalizedIdOrSlug.length === 0) {
+        setCollection(null);
+        setProducts([]);
+        setIsLoading(false);
+        return;
+      }
+      const nextRequestId = ++requestIdRef.current;
+      setError(null);
+      if (!force) {
+        const cacheEntry = collectionCache.get(cacheKey);
+        if (cacheEntry) {
+          setCollection(cacheEntry.collection);
+          setProducts(cacheEntry.products);
+          setIsLoading(false);
+          return;
+        }
+      }
+      setIsLoading(true);
+      try {
+        const existing = collectionInflight.get(cacheKey);
+        const promise = existing ?? (async () => {
+          const collectionResult = isLikelySlug2(normalizedIdOrSlug) ? await client.catalogue.getCollectionBySlug(normalizedIdOrSlug) : await client.catalogue.getCollection(normalizedIdOrSlug);
+          if (!collectionResult.ok) {
+            throw collectionResult.error;
+          }
+          const productsResult = await client.catalogue.getCollectionProducts(
+            collectionResult.value.id
+          );
+          if (!productsResult.ok) {
+            throw productsResult.error;
+          }
+          return {
+            collection: collectionResult.value,
+            products: productsResult.value
+          };
+        })();
+        if (!existing) {
+          collectionInflight.set(cacheKey, promise);
+          promise.finally(() => {
+            collectionInflight.delete(cacheKey);
+          }).catch(() => void 0);
+        }
+        const value = await promise;
+        collectionCache.set(cacheKey, value);
+        if (nextRequestId === requestIdRef.current) {
+          setCollection(value.collection);
+          setProducts(value.products);
+          setError(null);
+        }
+      } catch (loadError) {
+        if (nextRequestId === requestIdRef.current) {
+          setError(loadError);
+        }
+      } finally {
+        if (nextRequestId === requestIdRef.current) {
+          setIsLoading(false);
+        }
+      }
+    },
+    [cacheKey, client, enabled, normalizedIdOrSlug]
+  );
+  useEffect(() => {
+    void load(false);
+  }, [load]);
+  const refetch = useCallback(async () => {
+    collectionCache.delete(cacheKey);
+    await load(true);
+  }, [cacheKey, load]);
+  return { collection, products, isLoading, error, refetch };
+}
+var bundleCache = /* @__PURE__ */ new Map();
+var bundleInflight = /* @__PURE__ */ new Map();
+function isLikelySlug3(value) {
+  return /^[a-z0-9-]+$/.test(value);
+}
+function buildBundleCacheKey(client, locationId, idOrSlug) {
+  return JSON.stringify({
+    key: client.getPublicKey(),
+    location_id: locationId || "__none__",
+    bundle: idOrSlug
+  });
+}
+function useBundle(idOrSlug, options = {}) {
+  const context = useOptionalCimplify();
+  const client = options.client ?? context?.client;
+  if (!client) {
+    throw new Error("useBundle must be used within CimplifyProvider or passed { client }.");
+  }
+  const enabled = options.enabled ?? true;
+  const locationId = client.getLocationId();
+  const previousLocationIdRef = useRef(locationId);
+  const requestIdRef = useRef(0);
+  const normalizedIdOrSlug = useMemo(() => (idOrSlug || "").trim(), [idOrSlug]);
+  const cacheKey = useMemo(
+    () => buildBundleCacheKey(client, locationId, normalizedIdOrSlug),
+    [client, locationId, normalizedIdOrSlug]
+  );
+  const cached = bundleCache.get(cacheKey);
+  const [bundle, setBundle] = useState(cached?.bundle ?? null);
+  const [isLoading, setIsLoading] = useState(
+    enabled && normalizedIdOrSlug.length > 0 && !cached
+  );
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (previousLocationIdRef.current !== locationId) {
+      bundleCache.clear();
+      bundleInflight.clear();
+      previousLocationIdRef.current = locationId;
+    }
+  }, [locationId]);
+  const load = useCallback(
+    async (force = false) => {
+      if (!enabled || normalizedIdOrSlug.length === 0) {
+        setBundle(null);
+        setIsLoading(false);
+        return;
+      }
+      const nextRequestId = ++requestIdRef.current;
+      setError(null);
+      if (!force) {
+        const cacheEntry = bundleCache.get(cacheKey);
+        if (cacheEntry) {
+          setBundle(cacheEntry.bundle);
+          setIsLoading(false);
+          return;
+        }
+      }
+      setIsLoading(true);
+      try {
+        const existing = bundleInflight.get(cacheKey);
+        const promise = existing ?? (async () => {
+          const result = isLikelySlug3(normalizedIdOrSlug) ? await client.catalogue.getBundleBySlug(normalizedIdOrSlug) : await client.catalogue.getBundle(normalizedIdOrSlug);
+          if (!result.ok) {
+            throw result.error;
+          }
+          return result.value;
+        })();
+        if (!existing) {
+          bundleInflight.set(cacheKey, promise);
+          promise.finally(() => {
+            bundleInflight.delete(cacheKey);
+          }).catch(() => void 0);
+        }
+        const value = await promise;
+        bundleCache.set(cacheKey, { bundle: value });
+        if (nextRequestId === requestIdRef.current) {
+          setBundle(value);
+          setError(null);
+        }
+      } catch (loadError) {
+        if (nextRequestId === requestIdRef.current) {
+          setError(loadError);
+        }
+      } finally {
+        if (nextRequestId === requestIdRef.current) {
+          setIsLoading(false);
+        }
+      }
+    },
+    [cacheKey, client, enabled, normalizedIdOrSlug]
+  );
+  useEffect(() => {
+    void load(false);
+  }, [load]);
+  const refetch = useCallback(async () => {
+    bundleCache.delete(cacheKey);
+    await load(true);
+  }, [cacheKey, load]);
+  return { bundle, isLoading, error, refetch };
+}
+var compositeCache = /* @__PURE__ */ new Map();
+var compositeInflight = /* @__PURE__ */ new Map();
+function shouldFetchByProductId(idOrProductId, byProductId) {
+  if (typeof byProductId === "boolean") {
+    return byProductId;
+  }
+  return idOrProductId.startsWith("prod_");
+}
+function buildCompositeCacheKey(client, locationId, idOrProductId, byProductId) {
+  return JSON.stringify({
+    key: client.getPublicKey(),
+    location_id: locationId || "__none__",
+    composite: idOrProductId,
+    by_product_id: byProductId
+  });
+}
+function useComposite(idOrProductId, options = {}) {
+  const context = useOptionalCimplify();
+  const client = options.client ?? context?.client;
+  if (!client) {
+    throw new Error("useComposite must be used within CimplifyProvider or passed { client }.");
+  }
+  const enabled = options.enabled ?? true;
+  const locationId = client.getLocationId();
+  const previousLocationIdRef = useRef(locationId);
+  const requestIdRef = useRef(0);
+  const priceRequestIdRef = useRef(0);
+  const normalizedIdOrProductId = useMemo(
+    () => (idOrProductId || "").trim(),
+    [idOrProductId]
+  );
+  const byProductId = useMemo(
+    () => shouldFetchByProductId(normalizedIdOrProductId, options.byProductId),
+    [normalizedIdOrProductId, options.byProductId]
+  );
+  const cacheKey = useMemo(
+    () => buildCompositeCacheKey(client, locationId, normalizedIdOrProductId, byProductId),
+    [byProductId, client, locationId, normalizedIdOrProductId]
+  );
+  const cached = compositeCache.get(cacheKey);
+  const [composite, setComposite] = useState(cached?.composite ?? null);
+  const [isLoading, setIsLoading] = useState(
+    enabled && normalizedIdOrProductId.length > 0 && !cached
+  );
+  const [error, setError] = useState(null);
+  const [priceResult, setPriceResult] = useState(null);
+  const [isPriceLoading, setIsPriceLoading] = useState(false);
+  useEffect(() => {
+    if (previousLocationIdRef.current !== locationId) {
+      compositeCache.clear();
+      compositeInflight.clear();
+      previousLocationIdRef.current = locationId;
+    }
+  }, [locationId]);
+  const load = useCallback(
+    async (force = false) => {
+      if (!enabled || normalizedIdOrProductId.length === 0) {
+        setComposite(null);
+        setPriceResult(null);
+        setIsLoading(false);
+        return;
+      }
+      const nextRequestId = ++requestIdRef.current;
+      setError(null);
+      if (!force) {
+        const cacheEntry = compositeCache.get(cacheKey);
+        if (cacheEntry) {
+          setComposite(cacheEntry.composite);
+          setIsLoading(false);
+          return;
+        }
+      }
+      setIsLoading(true);
+      try {
+        const existing = compositeInflight.get(cacheKey);
+        const promise = existing ?? (async () => {
+          const result = byProductId ? await client.catalogue.getCompositeByProductId(normalizedIdOrProductId) : await client.catalogue.getComposite(normalizedIdOrProductId);
+          if (!result.ok) {
+            throw result.error;
+          }
+          return result.value;
+        })();
+        if (!existing) {
+          compositeInflight.set(cacheKey, promise);
+          promise.finally(() => {
+            compositeInflight.delete(cacheKey);
+          }).catch(() => void 0);
+        }
+        const value = await promise;
+        compositeCache.set(cacheKey, { composite: value });
+        if (nextRequestId === requestIdRef.current) {
+          setComposite(value);
+          setPriceResult(null);
+          setError(null);
+        }
+      } catch (loadError) {
+        if (nextRequestId === requestIdRef.current) {
+          setError(loadError);
+        }
+      } finally {
+        if (nextRequestId === requestIdRef.current) {
+          setIsLoading(false);
+        }
+      }
+    },
+    [byProductId, cacheKey, client, enabled, normalizedIdOrProductId]
+  );
+  useEffect(() => {
+    void load(false);
+  }, [load]);
+  const calculatePrice = useCallback(
+    async (selections, overrideLocationId) => {
+      if (!composite) {
+        return null;
+      }
+      const nextRequestId = ++priceRequestIdRef.current;
+      setIsPriceLoading(true);
+      try {
+        const result = await client.catalogue.calculateCompositePrice(
+          composite.id,
+          selections,
+          overrideLocationId
+        );
+        if (!result.ok) {
+          throw result.error;
+        }
+        if (nextRequestId === priceRequestIdRef.current) {
+          setPriceResult(result.value);
+          setError(null);
+        }
+        return result.value;
+      } catch (loadError) {
+        if (nextRequestId === priceRequestIdRef.current) {
+          setError(loadError);
+        }
+        return null;
+      } finally {
+        if (nextRequestId === priceRequestIdRef.current) {
+          setIsPriceLoading(false);
+        }
+      }
+    },
+    [client, composite]
+  );
+  const refetch = useCallback(async () => {
+    compositeCache.delete(cacheKey);
+    await load(true);
+  }, [cacheKey, load]);
+  return { composite, isLoading, error, refetch, calculatePrice, priceResult, isPriceLoading };
+}
+function useSearch(options = {}) {
+  const context = useOptionalCimplify();
+  const client = options.client ?? context?.client;
+  if (!client) {
+    throw new Error("useSearch must be used within CimplifyProvider or passed { client }.");
+  }
+  const minLength = Math.max(0, options.minLength ?? 2);
+  const debounceMs = Math.max(0, options.debounceMs ?? 300);
+  const limit = Math.max(1, options.limit ?? 20);
+  const [query, setQueryState] = useState("");
+  const [results, setResults] = useState([]);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const requestIdRef = useRef(0);
+  const timerRef = useRef(null);
+  useEffect(() => {
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+    const trimmedQuery = query.trim();
+    if (trimmedQuery.length < minLength) {
+      setResults([]);
+      setError(null);
+      setIsLoading(false);
+      return;
+    }
+    const nextRequestId = ++requestIdRef.current;
+    setError(null);
+    setIsLoading(true);
+    timerRef.current = setTimeout(() => {
+      void (async () => {
+        try {
+          const result = await client.catalogue.searchProducts(trimmedQuery, {
+            limit,
+            category: options.category
+          });
+          if (!result.ok) {
+            throw result.error;
+          }
+          if (nextRequestId === requestIdRef.current) {
+            setResults(result.value);
+            setError(null);
+          }
+        } catch (loadError) {
+          if (nextRequestId === requestIdRef.current) {
+            setError(loadError);
+          }
+        } finally {
+          if (nextRequestId === requestIdRef.current) {
+            setIsLoading(false);
+          }
+        }
+      })();
+    }, debounceMs);
+    return () => {
+      if (timerRef.current) {
+        clearTimeout(timerRef.current);
+        timerRef.current = null;
+      }
+    };
+  }, [client, debounceMs, limit, minLength, options.category, query]);
+  const setQuery = useCallback((nextQuery) => {
+    setQueryState(nextQuery);
+  }, []);
+  const clear = useCallback(() => {
+    requestIdRef.current += 1;
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+    setQueryState("");
+    setResults([]);
+    setError(null);
+    setIsLoading(false);
+  }, []);
+  return { results, isLoading, error, query, setQuery, clear };
+}
+var quoteCache = /* @__PURE__ */ new Map();
+var quoteInflight = /* @__PURE__ */ new Map();
+function buildQuoteCacheKey(client, locationId, inputSignature) {
+  return JSON.stringify({
+    key: client.getPublicKey(),
+    location_id: locationId || "__none__",
+    input: inputSignature
+  });
+}
+function isQuoteExpired(quote) {
+  if (!quote?.expires_at) {
+    return false;
+  }
+  const expiresAt = Date.parse(quote.expires_at);
+  if (!Number.isFinite(expiresAt)) {
+    return false;
+  }
+  return expiresAt <= Date.now();
+}
+function normalizeInput(input, fallbackLocationId) {
+  const productId = input.productId.trim();
+  const variantId = input.variantId?.trim();
+  const locationId = input.locationId?.trim() || fallbackLocationId || void 0;
+  return {
+    product_id: productId,
+    variant_id: variantId && variantId.length > 0 ? variantId : void 0,
+    location_id: locationId && locationId.length > 0 ? locationId : void 0,
+    quantity: input.quantity,
+    add_on_option_ids: input.addOnOptionIds,
+    bundle_selections: input.bundleSelections,
+    composite_selections: input.compositeSelections
+  };
+}
+function useQuote(input, options = {}) {
+  const context = useOptionalCimplify();
+  const client = options.client ?? context?.client;
+  if (!client) {
+    throw new Error("useQuote must be used within CimplifyProvider or passed { client }.");
+  }
+  const enabled = options.enabled ?? true;
+  const autoRefresh = options.autoRefresh ?? true;
+  const refreshBeforeExpiryMs = Math.max(0, options.refreshBeforeExpiryMs ?? 3e4);
+  const locationId = client.getLocationId();
+  const requestIdRef = useRef(0);
+  const refreshTimerRef = useRef(null);
+  const expiryTimerRef = useRef(null);
+  const inputSignature = useMemo(() => JSON.stringify(input ?? null), [input]);
+  const normalizedInput = useMemo(() => {
+    if (!input) {
+      return null;
+    }
+    const normalized = normalizeInput(input, locationId);
+    return normalized.product_id.length > 0 ? normalized : null;
+  }, [inputSignature, locationId]);
+  const cacheKey = useMemo(
+    () => buildQuoteCacheKey(client, locationId, inputSignature),
+    [client, inputSignature, locationId]
+  );
+  const cached = quoteCache.get(cacheKey);
+  const [quote, setQuote] = useState(cached?.quote ?? null);
+  const [isLoading, setIsLoading] = useState(enabled && normalizedInput !== null && !cached);
+  const [error, setError] = useState(null);
+  const [isExpired, setIsExpired] = useState(isQuoteExpired(cached?.quote ?? null));
+  const [messages, setMessages] = useState(cached?.quote?.ui_messages ?? []);
+  const load = useCallback(
+    async (force = false) => {
+      if (!enabled || !normalizedInput) {
+        setQuote(null);
+        setMessages([]);
+        setIsExpired(false);
+        setError(null);
+        setIsLoading(false);
+        return;
+      }
+      const nextRequestId = ++requestIdRef.current;
+      setError(null);
+      if (!force) {
+        const cacheEntry = quoteCache.get(cacheKey);
+        if (cacheEntry) {
+          setQuote(cacheEntry.quote);
+          setMessages(cacheEntry.quote?.ui_messages ?? []);
+          setIsExpired(isQuoteExpired(cacheEntry.quote));
+          setIsLoading(false);
+          return;
+        }
+      }
+      setIsLoading(true);
+      try {
+        const existing = quoteInflight.get(cacheKey);
+        const promise = existing ?? (async () => {
+          const result = await client.catalogue.fetchQuote(normalizedInput);
+          if (!result.ok) {
+            throw result.error;
+          }
+          return result.value;
+        })();
+        if (!existing) {
+          quoteInflight.set(cacheKey, promise);
+          promise.finally(() => {
+            quoteInflight.delete(cacheKey);
+          }).catch(() => void 0);
+        }
+        const value = await promise;
+        quoteCache.set(cacheKey, { quote: value });
+        if (nextRequestId === requestIdRef.current) {
+          setQuote(value);
+          setMessages(value.ui_messages ?? []);
+          setIsExpired(isQuoteExpired(value));
+          setError(null);
+        }
+      } catch (loadError) {
+        if (nextRequestId === requestIdRef.current) {
+          setError(loadError);
+        }
+      } finally {
+        if (nextRequestId === requestIdRef.current) {
+          setIsLoading(false);
+        }
+      }
+    },
+    [cacheKey, client, enabled, normalizedInput]
+  );
+  useEffect(() => {
+    void load(false);
+  }, [load]);
+  const refresh = useCallback(async () => {
+    if (!enabled || !normalizedInput) {
+      return;
+    }
+    if (!quote?.quote_id) {
+      await load(true);
+      return;
+    }
+    const nextRequestId = ++requestIdRef.current;
+    setError(null);
+    setIsLoading(true);
+    try {
+      const result = await client.catalogue.refreshQuote({
+        quote_id: quote.quote_id,
+        ...normalizedInput
+      });
+      if (!result.ok) {
+        throw result.error;
+      }
+      const refreshed = result.value.quote;
+      quoteCache.set(cacheKey, { quote: refreshed });
+      if (nextRequestId === requestIdRef.current) {
+        setQuote(refreshed);
+        setMessages(refreshed.ui_messages ?? []);
+        setIsExpired(isQuoteExpired(refreshed));
+        setError(null);
+      }
+    } catch (refreshError) {
+      if (nextRequestId === requestIdRef.current) {
+        setError(refreshError);
+      }
+    } finally {
+      if (nextRequestId === requestIdRef.current) {
+        setIsLoading(false);
+      }
+    }
+  }, [cacheKey, client, enabled, load, normalizedInput, quote]);
+  useEffect(() => {
+    if (expiryTimerRef.current) {
+      clearTimeout(expiryTimerRef.current);
+      expiryTimerRef.current = null;
+    }
+    const expiresAt = quote?.expires_at ? Date.parse(quote.expires_at) : NaN;
+    if (!Number.isFinite(expiresAt)) {
+      setIsExpired(false);
+      return;
+    }
+    const expired = expiresAt <= Date.now();
+    setIsExpired(expired);
+    if (!expired) {
+      expiryTimerRef.current = setTimeout(() => {
+        setIsExpired(true);
+      }, Math.max(0, expiresAt - Date.now()));
+    }
+    return () => {
+      if (expiryTimerRef.current) {
+        clearTimeout(expiryTimerRef.current);
+        expiryTimerRef.current = null;
+      }
+    };
+  }, [quote?.expires_at, quote?.quote_id]);
+  useEffect(() => {
+    if (refreshTimerRef.current) {
+      clearTimeout(refreshTimerRef.current);
+      refreshTimerRef.current = null;
+    }
+    if (!autoRefresh || !enabled || !quote?.expires_at) {
+      return;
+    }
+    const expiresAt = Date.parse(quote.expires_at);
+    if (!Number.isFinite(expiresAt)) {
+      return;
+    }
+    const delay = Math.max(0, expiresAt - Date.now() - refreshBeforeExpiryMs);
+    refreshTimerRef.current = setTimeout(() => {
+      void refresh();
+    }, delay);
+    return () => {
+      if (refreshTimerRef.current) {
+        clearTimeout(refreshTimerRef.current);
+        refreshTimerRef.current = null;
+      }
+    };
+  }, [autoRefresh, enabled, quote?.expires_at, quote?.quote_id, refresh, refreshBeforeExpiryMs]);
+  return { quote, isLoading, error, refresh, isExpired, messages };
+}
 var ElementsContext = createContext({
   elements: null,
   isReady: false
@@ -5243,4 +6043,4 @@ function useCheckout() {
   return { submit, process, isLoading };
 }
 
-export { Ad, AdProvider, AddressElement, AuthElement, CimplifyCheckout, CimplifyProvider, ElementsProvider, PaymentElement, useAds, useCart, useCategories, useCheckout, useCimplify, useElements, useElementsReady, useLocations, useOptionalCimplify, useOrder, useProduct, useProducts };
+export { Ad, AdProvider, AddressElement, AuthElement, CimplifyCheckout, CimplifyProvider, ElementsProvider, PaymentElement, useAds, useBundle, useCart, useCategories, useCheckout, useCimplify, useCollection, useCollections, useComposite, useElements, useElementsReady, useLocations, useOptionalCimplify, useOrder, useProduct, useProducts, useQuote, useSearch };