@usethrottle/catalog 1.2.0 → 1.4.0

package/dist/{chunk-TDMDOHD3.cjs → chunk-OKWXS3FD.cjs}

@@ -6,7 +6,7 @@
 
 
 
-var _chunkB2DYAHNRcjs = require('./chunk-B2DYAHNR.cjs');
+var _chunkJ2GHGQY6cjs = require('./chunk-J2GHGQY6.cjs');
 
 // src/react/provider.tsx
 
@@ -32,7 +32,7 @@ function createStore(client, options = {}) {
   let until = 0;
   let cause;
   let pauseTimer;
-  const pausedError = () => new (0, _chunkB2DYAHNRcjs.RateLimitedError)({
+  const pausedError = () => new (0, _chunkJ2GHGQY6cjs.RateLimitedError)({
     code: _nullishCoalesce(_optionalChain([cause, 'optionalAccess', _ => _.code]), () => ( "RATE_LIMITED")),
     message: _nullishCoalesce(_optionalChain([cause, 'optionalAccess', _2 => _2.message]), () => ( "Too many requests.")),
     statusCode: 429,
@@ -54,7 +54,7 @@ function createStore(client, options = {}) {
         retries: 0
       };
       for (const [oldKey, old] of entries) {
-        if (entries.size < _chunkB2DYAHNRcjs.CACHE_MAX_ENTRIES) break;
+        if (entries.size < _chunkJ2GHGQY6cjs.CACHE_MAX_ENTRIES) break;
         if (old.subs.size === 0 && old.flight === void 0) {
           clearTimeout(old.timer);
           entries.delete(oldKey);
@@ -73,7 +73,7 @@ function createStore(client, options = {}) {
       else entry.indexing = false;
     }, ms);
   };
-  function fetchKey(key, run, { force = false, staleMs = _chunkB2DYAHNRcjs.STALE_MS } = {}) {
+  function fetchKey(key, run, { force = false, staleMs = _chunkJ2GHGQY6cjs.STALE_MS } = {}) {
     const entry = touch(key);
     entry.run = run;
     if (entry.promise !== void 0 && !_optionalChain([entry, 'access', _4 => _4.flight, 'optionalAccess', _5 => _5.signal, 'access', _6 => _6.aborted]))
@@ -125,7 +125,7 @@ function createStore(client, options = {}) {
           return;
         }
         if (_optionalChain([result, 'access', _7 => _7.data, 'optionalAccess', _8 => _8.indexing]) === true) {
-          if (!entry.indexing) later(key, entry, _chunkB2DYAHNRcjs.INDEXING_REVALIDATE_MS);
+          if (!entry.indexing) later(key, entry, _chunkJ2GHGQY6cjs.INDEXING_REVALIDATE_MS);
         } else {
           entry.indexing = false;
         }
@@ -138,7 +138,7 @@ function createStore(client, options = {}) {
       },
       (error) => {
         if (!current()) return;
-        const retryMs = (_nullishCoalesce(error.retryAfterSeconds, () => ( _chunkB2DYAHNRcjs.RATE_LIMIT_DEFAULT_RETRY_S))) * 1e3;
+        const retryMs = (_nullishCoalesce(error.retryAfterSeconds, () => ( _chunkJ2GHGQY6cjs.RATE_LIMIT_DEFAULT_RETRY_S))) * 1e3;
         if (error.statusCode === 429 && error.code === "RATE_LIMITED")
           pause(now() + retryMs, error);
         else if (error.code === "STOREFRONT_INDEXING") {
@@ -183,6 +183,21 @@ function createStore(client, options = {}) {
       }
     }
   }
+  function invalidate() {
+    for (const [key, entry] of [...entries]) {
+      clearTimeout(entry.timer);
+      clearTimeout(entry.retry);
+      _optionalChain([entry, 'access', _12 => _12.flight, 'optionalAccess', _13 => _13.abort, 'call', _14 => _14()]);
+      if (entry.subs.size === 0) {
+        entries.delete(key);
+      } else {
+        entry.etag = entry.flight = entry.promise = void 0;
+        entry.indexing = false;
+        entry.retries = 0;
+        if (entry.run) void fetchKey(key, entry.run, { force: true });
+      }
+    }
+  }
   return {
     subscribe(key, listener) {
       const entry = touch(key);
@@ -190,11 +205,11 @@ function createStore(client, options = {}) {
       return () => {
         entry.subs.delete(listener);
         void done.then(() => {
-          if (entry.subs.size === 0) _optionalChain([entry, 'access', _12 => _12.flight, 'optionalAccess', _13 => _13.abort, 'call', _14 => _14()]);
+          if (entry.subs.size === 0) _optionalChain([entry, 'access', _15 => _15.flight, 'optionalAccess', _16 => _16.abort, 'call', _17 => _17()]);
         });
       };
     },
-    get: (key, initial, stale) => key === null ? EMPTY : _nullishCoalesce(_optionalChain([(_nullishCoalesce(entries.get(key), () => ( (initial === void 0 ? void 0 : touch(key, initial, stale))))), 'optionalAccess', _15 => _15.snap]), () => ( EMPTY)),
+    get: (key, initial, stale) => key === null ? EMPTY : _nullishCoalesce(_optionalChain([(_nullishCoalesce(entries.get(key), () => ( (initial === void 0 ? void 0 : touch(key, initial, stale))))), 'optionalAccess', _18 => _18.snap]), () => ( EMPTY)),
     getServer(key, initial, stale) {
       if (key === null || initial === void 0) return EMPTY;
       const entry = _nullishCoalesce(entries.get(key), () => ( touch(key, initial, stale)));
@@ -202,6 +217,7 @@ function createStore(client, options = {}) {
     },
     fetch: fetchKey,
     clear,
+    invalidate,
     pause,
     pausedUntil: () => until > now() ? until : 0,
     dispose() {
@@ -218,6 +234,7 @@ function createStore(client, options = {}) {
 var _jsxruntime = require('react/jsx-runtime');
 function createMemoryCartStorage() {
   let id = null;
+  const byCurrency = /* @__PURE__ */ new Map();
   return {
     get: () => id,
     set: (value) => {
@@ -225,6 +242,13 @@ function createMemoryCartStorage() {
     },
     remove: () => {
       id = null;
+    },
+    getFor: (currency) => _nullishCoalesce(byCurrency.get(currency), () => ( null)),
+    setFor: (currency, value) => {
+      byCurrency.set(currency, value);
+    },
+    removeFor: (currency) => {
+      byCurrency.delete(currency);
     }
   };
 }
@@ -241,7 +265,7 @@ function CatalogProvider(props) {
   const mounted = _react.useRef.call(void 0, null);
   const store = _react.useMemo.call(void 0, () => {
     const next = createStore(client);
-    next.pause(_nullishCoalesce(_optionalChain([mounted, 'access', _16 => _16.current, 'optionalAccess', _17 => _17.pausedUntil, 'call', _18 => _18()]), () => ( 0)));
+    next.pause(_nullishCoalesce(_optionalChain([mounted, 'access', _19 => _19.current, 'optionalAccess', _20 => _20.pausedUntil, 'call', _21 => _21()]), () => ( 0)));
     return next;
   }, [client, customerKey]);
   _react.useEffect.call(void 0, () => {
@@ -273,9 +297,9 @@ function CatalogProvider(props) {
       rest.customerCart,
       rest.throttleBaseUrl,
       rest.throttleCheckoutUrl,
-      _optionalChain([urls, 'optionalAccess', _19 => _19.returnUrl]),
-      _optionalChain([urls, 'optionalAccess', _20 => _20.cancelUrl]),
-      _optionalChain([urls, 'optionalAccess', _21 => _21.storefrontUrl])
+      _optionalChain([urls, 'optionalAccess', _22 => _22.returnUrl]),
+      _optionalChain([urls, 'optionalAccess', _23 => _23.cancelUrl]),
+      _optionalChain([urls, 'optionalAccess', _24 => _24.storefrontUrl])
     ]
   );
   cart.context = value;
@@ -409,9 +433,9 @@ function useDebounced(q, ms) {
   return _react.useSyncExternalStore.call(void 0, box.subscribe, box.get, box.get);
 }
 function useSuggest(q, options = {}) {
-  const settled = useDebounced(q, _nullishCoalesce(options.debounceMs, () => ( _chunkB2DYAHNRcjs.SUGGEST_DEBOUNCE_MS)));
+  const settled = useDebounced(q, _nullishCoalesce(options.debounceMs, () => ( _chunkJ2GHGQY6cjs.SUGGEST_DEBOUNCE_MS)));
   const extra = defined({ limit: options.limit });
-  const long = (value) => value.trim().length >= _chunkB2DYAHNRcjs.SUGGEST_MIN_CHARS;
+  const long = (value) => value.trim().length >= _chunkJ2GHGQY6cjs.SUGGEST_MIN_CHARS;
   return useQuery(
     "suggest",
     { q: settled, ...extra },
@@ -458,6 +482,75 @@ function useConfig(options) {
     options
   );
 }
+function useStorefrontSettings(options) {
+  return useQuery(
+    "settings",
+    null,
+    (client, call) => client.settings(call),
+    options
+  );
+}
+var watches = /* @__PURE__ */ new WeakMap();
+var watchRun = (client, call) => client.config(call);
+var pageDocument = () => Reflect.get(globalThis, "document");
+function watch(store, intervalMs, listener) {
+  let w = watches.get(store);
+  if (w === void 0) {
+    const key = `\0${catalogQueryKey("generation", null)}`;
+    const visible = () => pageDocument().visibilityState === "visible";
+    const listeners = /* @__PURE__ */ new Set();
+    let known;
+    let hiddenAt = visible() ? 0 : Date.now();
+    const check = async () => {
+      if (!visible()) return;
+      await store.fetch(key, watchRun, { force: true });
+      const data = store.get(key).data;
+      if (watches.get(store) !== w || _optionalChain([data, 'optionalAccess', _25 => _25.generation]) === void 0) return;
+      const changed = known !== void 0 && data.generation !== known;
+      known = data.generation;
+      if (changed) {
+        store.invalidate();
+        for (const { current } of [...listeners]) _optionalChain([current, 'optionalCall', _26 => _26(known)]);
+      }
+    };
+    const onVisibility = () => {
+      if (!visible()) hiddenAt = Date.now();
+      else {
+        if (known === void 0 || Date.now() - hiddenAt >= intervalMs)
+          void check();
+        hiddenAt = 0;
+      }
+    };
+    void check();
+    const timer = setInterval(() => void check(), intervalMs);
+    const doc = pageDocument();
+    doc.addEventListener("visibilitychange", onVisibility);
+    w = {
+      listeners,
+      stop() {
+        clearInterval(timer);
+        doc.removeEventListener("visibilitychange", onVisibility);
+        watches.delete(store);
+      }
+    };
+    watches.set(store, w);
+  }
+  const mine = w;
+  mine.listeners.add(listener);
+  return () => {
+    mine.listeners.delete(listener);
+    if (mine.listeners.size === 0) mine.stop();
+  };
+}
+function useGenerationWatch({
+  intervalMs = 6e4,
+  onChange
+} = {}) {
+  const { store } = useCatalogContext();
+  const latest = _react.useRef.call(void 0, onChange);
+  latest.current = onChange;
+  _react.useEffect.call(void 0, () => watch(store, intervalMs, latest), [store, intervalMs]);
+}
 function useFilterValues(key, query = {}, options) {
   return useQuery(
     "filterValues",
@@ -485,4 +578,6 @@ function useFilterValues(key, query = {}, options) {
 
 
 
-exports.createMemoryCartStorage = createMemoryCartStorage; exports.useCatalogContext = useCatalogContext; exports.CatalogProvider = CatalogProvider; exports.useCustomerKey = useCustomerKey; exports.useCatalog = useCatalog; exports.catalogQueryKey = catalogQueryKey; exports.useQuery = useQuery; exports.defined = defined; exports.useProducts = useProducts; exports.useProduct = useProduct; exports.useRelated = useRelated; exports.useSuggest = useSuggest; exports.useCategories = useCategories; exports.useCollection = useCollection; exports.useReviews = useReviews; exports.useConfig = useConfig; exports.useFilterValues = useFilterValues;
+
+
+exports.createMemoryCartStorage = createMemoryCartStorage; exports.useCatalogContext = useCatalogContext; exports.CatalogProvider = CatalogProvider; exports.useCustomerKey = useCustomerKey; exports.useCatalog = useCatalog; exports.catalogQueryKey = catalogQueryKey; exports.useQuery = useQuery; exports.defined = defined; exports.useProducts = useProducts; exports.useProduct = useProduct; exports.useRelated = useRelated; exports.useSuggest = useSuggest; exports.useCategories = useCategories; exports.useCollection = useCollection; exports.useReviews = useReviews; exports.useConfig = useConfig; exports.useStorefrontSettings = useStorefrontSettings; exports.useGenerationWatch = useGenerationWatch; exports.useFilterValues = useFilterValues;

package/dist/chunk-PZ3SFYH4.cjs

@@ -0,0 +1,192 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+
+
+var _chunkJ2GHGQY6cjs = require('./chunk-J2GHGQY6.cjs');
+
+// src/server/cache-policy.ts
+var UNTIL_CHANGED_REVALIDATE_S = 3600;
+var DEFAULT_CACHE_POLICY = {
+  settings: "until-changed",
+  navigation: "until-changed",
+  pages: "until-changed",
+  product: "until-changed",
+  listings: "60s",
+  facets: "60s",
+  related: "60s",
+  reviews: "60s",
+  search: "60s"
+};
+function decode(segment) {
+  try {
+    return decodeURIComponent(segment);
+  } catch (e) {
+    return segment;
+  }
+}
+function storefrontRoute(path) {
+  const bare = _nullishCoalesce(path.split(/[?#]/u, 1)[0], () => ( ""));
+  const at = bare.indexOf("/v1/storefront/");
+  const parts = (at < 0 ? bare : bare.slice(at + 15)).replace(/^\//u, "");
+  const [first, segment, sub, extra] = parts.split("/");
+  if (extra !== void 0) return null;
+  if (segment === void 0) {
+    switch (first) {
+      case "config":
+      case "products":
+      case "pages":
+      case "categories":
+      case "tags":
+      case "collections":
+      case "suggest":
+        return { route: first };
+      default:
+        return null;
+    }
+  }
+  const handle = decode(segment);
+  if (handle === "") return null;
+  switch (first) {
+    case "filters":
+      return sub === "values" ? { route: "filters" } : null;
+    case "products":
+      if (sub === "related" || sub === "reviews") return { route: sub, handle };
+      return sub === void 0 ? { route: "product", handle } : null;
+    case "pages":
+      return sub === void 0 ? { route: "page", handle } : null;
+    case "categories":
+      return sub === void 0 ? { route: "category", handle } : null;
+    case "collections":
+      return sub === void 0 ? { route: "collection", handle } : null;
+    default:
+      return null;
+  }
+}
+var KIND_OF_ROUTE = {
+  config: "settings",
+  pages: "pages",
+  page: "pages",
+  products: "listings",
+  product: "product",
+  related: "related",
+  reviews: "reviews",
+  filters: "facets",
+  suggest: "search",
+  categories: "listings",
+  category: "listings",
+  collections: "listings",
+  collection: "listings",
+  tags: "listings"
+};
+function cacheKindForPath(path) {
+  const found = storefrontRoute(path);
+  return found === null ? null : _nullishCoalesce(KIND_OF_ROUTE[found.route], () => ( null));
+}
+var DURATION = /^(\d+)([sm])$/u;
+function policyToNext(policy) {
+  if (policy === "no-store") return "no-store";
+  if (policy === "until-changed")
+    return { revalidate: UNTIL_CHANGED_REVALIDATE_S };
+  const match = typeof policy === "string" ? DURATION.exec(policy) : null;
+  if (match === null) {
+    throw new (0, _chunkJ2GHGQY6cjs.CatalogError)({
+      code: "INVALID_REQUEST",
+      message: "A cache policy is 'until-changed', 'no-store' or a duration such as '90s' or '5m'.",
+      statusCode: 0,
+      source: "client",
+      retryable: false
+    });
+  }
+  const seconds = Number(match[1]) * (match[2] === "m" ? 60 : 1);
+  return seconds === 0 ? "no-store" : { revalidate: seconds };
+}
+
+// src/server/min-generation.ts
+var EVERY_STORE = Symbol("every-store");
+var floors = /* @__PURE__ */ new Map();
+function noteMinGeneration(generation, floorKey) {
+  if (!Number.isSafeInteger(generation) || generation < 0) return;
+  const key = _nullishCoalesce(floorKey, () => ( EVERY_STORE));
+  const known = floors.get(key);
+  if (known === void 0 || generation > known) floors.set(key, generation);
+}
+function pendingMinGeneration(floorKey) {
+  const own = floors.get(floorKey);
+  const every = floors.get(EVERY_STORE);
+  return own === void 0 || every !== void 0 && every > own ? every : own;
+}
+function observeGeneration(generation, floorKey) {
+  if (typeof generation !== "number") return;
+  for (const key of [floorKey, EVERY_STORE]) {
+    const floor = floors.get(key);
+    if (floor !== void 0 && generation >= floor) floors.delete(key);
+  }
+}
+
+// src/server/tags.ts
+function familyOf(route) {
+  if (route === "config") return "config";
+  return route === "pages" || route === "page" ? "pages" : "data";
+}
+function catalogTags(route, handle) {
+  const tags = [_chunkJ2GHGQY6cjs.CACHE_TAG, `${_chunkJ2GHGQY6cjs.CACHE_TAG}:${familyOf(route)}`];
+  if (route !== familyOf(route)) tags.push(`${_chunkJ2GHGQY6cjs.CACHE_TAG}:${route}`);
+  if (handle !== void 0) tags.push(`${_chunkJ2GHGQY6cjs.CACHE_TAG}:${route}:${handle}`);
+  return tags.filter((tag) => tag.length <= _chunkJ2GHGQY6cjs.TAG_MAX_CHARS);
+}
+function tagsForUrl(url, storefront) {
+  const path = _nullishCoalesce(url.split(/[?#]/u, 1)[0], () => ( ""));
+  if (!path.startsWith(storefront)) return null;
+  const found = storefrontRoute(path.slice(storefront.length));
+  return found === null ? null : catalogTags(found.route, found.handle);
+}
+var family = (name) => `${_chunkJ2GHGQY6cjs.CACHE_TAG}:${name}`;
+function tagsForScope(scope) {
+  const colon = scope.indexOf(":");
+  const name = colon < 0 ? scope : scope.slice(0, colon);
+  const handle = colon < 0 ? "" : scope.slice(colon + 1);
+  switch (scope) {
+    case "settings":
+    case "navigation":
+      return [family("config")];
+    case "filters":
+      return [family("config"), family("data")];
+    case "pages":
+      return [family("pages")];
+    case "taxonomy":
+    case "catalog":
+      return [family("data")];
+  }
+  if (handle !== "") {
+    if (name === "product" || name === "collection" || name === "category")
+      return [`${family(name)}:${handle}`, family("data")];
+    if (name === "reviews")
+      return [
+        `${family("reviews")}:${handle}`,
+        `${family("product")}:${handle}`
+      ];
+  }
+  return [family("data")];
+}
+function scopesToTags(scopes) {
+  const out = /* @__PURE__ */ new Set();
+  for (const scope of scopes) {
+    for (const tag of tagsForScope(scope)) {
+      if (tag.length <= _chunkJ2GHGQY6cjs.TAG_MAX_CHARS) out.add(tag);
+    }
+  }
+  return [...out];
+}
+
+
+
+
+
+
+
+
+
+
+
+
+exports.DEFAULT_CACHE_POLICY = DEFAULT_CACHE_POLICY; exports.storefrontRoute = storefrontRoute; exports.cacheKindForPath = cacheKindForPath; exports.policyToNext = policyToNext; exports.noteMinGeneration = noteMinGeneration; exports.pendingMinGeneration = pendingMinGeneration; exports.observeGeneration = observeGeneration; exports.catalogTags = catalogTags; exports.tagsForUrl = tagsForUrl; exports.scopesToTags = scopesToTags;

package/dist/chunk-SN6STYPW.js

@@ -0,0 +1,192 @@
+import {
+  CACHE_TAG,
+  CatalogError,
+  TAG_MAX_CHARS
+} from "./chunk-VJHA7J7B.js";
+
+// src/server/cache-policy.ts
+var UNTIL_CHANGED_REVALIDATE_S = 3600;
+var DEFAULT_CACHE_POLICY = {
+  settings: "until-changed",
+  navigation: "until-changed",
+  pages: "until-changed",
+  product: "until-changed",
+  listings: "60s",
+  facets: "60s",
+  related: "60s",
+  reviews: "60s",
+  search: "60s"
+};
+function decode(segment) {
+  try {
+    return decodeURIComponent(segment);
+  } catch {
+    return segment;
+  }
+}
+function storefrontRoute(path) {
+  const bare = path.split(/[?#]/u, 1)[0] ?? "";
+  const at = bare.indexOf("/v1/storefront/");
+  const parts = (at < 0 ? bare : bare.slice(at + 15)).replace(/^\//u, "");
+  const [first, segment, sub, extra] = parts.split("/");
+  if (extra !== void 0) return null;
+  if (segment === void 0) {
+    switch (first) {
+      case "config":
+      case "products":
+      case "pages":
+      case "categories":
+      case "tags":
+      case "collections":
+      case "suggest":
+        return { route: first };
+      default:
+        return null;
+    }
+  }
+  const handle = decode(segment);
+  if (handle === "") return null;
+  switch (first) {
+    case "filters":
+      return sub === "values" ? { route: "filters" } : null;
+    case "products":
+      if (sub === "related" || sub === "reviews") return { route: sub, handle };
+      return sub === void 0 ? { route: "product", handle } : null;
+    case "pages":
+      return sub === void 0 ? { route: "page", handle } : null;
+    case "categories":
+      return sub === void 0 ? { route: "category", handle } : null;
+    case "collections":
+      return sub === void 0 ? { route: "collection", handle } : null;
+    default:
+      return null;
+  }
+}
+var KIND_OF_ROUTE = {
+  config: "settings",
+  pages: "pages",
+  page: "pages",
+  products: "listings",
+  product: "product",
+  related: "related",
+  reviews: "reviews",
+  filters: "facets",
+  suggest: "search",
+  categories: "listings",
+  category: "listings",
+  collections: "listings",
+  collection: "listings",
+  tags: "listings"
+};
+function cacheKindForPath(path) {
+  const found = storefrontRoute(path);
+  return found === null ? null : KIND_OF_ROUTE[found.route] ?? null;
+}
+var DURATION = /^(\d+)([sm])$/u;
+function policyToNext(policy) {
+  if (policy === "no-store") return "no-store";
+  if (policy === "until-changed")
+    return { revalidate: UNTIL_CHANGED_REVALIDATE_S };
+  const match = typeof policy === "string" ? DURATION.exec(policy) : null;
+  if (match === null) {
+    throw new CatalogError({
+      code: "INVALID_REQUEST",
+      message: "A cache policy is 'until-changed', 'no-store' or a duration such as '90s' or '5m'.",
+      statusCode: 0,
+      source: "client",
+      retryable: false
+    });
+  }
+  const seconds = Number(match[1]) * (match[2] === "m" ? 60 : 1);
+  return seconds === 0 ? "no-store" : { revalidate: seconds };
+}
+
+// src/server/min-generation.ts
+var EVERY_STORE = Symbol("every-store");
+var floors = /* @__PURE__ */ new Map();
+function noteMinGeneration(generation, floorKey) {
+  if (!Number.isSafeInteger(generation) || generation < 0) return;
+  const key = floorKey ?? EVERY_STORE;
+  const known = floors.get(key);
+  if (known === void 0 || generation > known) floors.set(key, generation);
+}
+function pendingMinGeneration(floorKey) {
+  const own = floors.get(floorKey);
+  const every = floors.get(EVERY_STORE);
+  return own === void 0 || every !== void 0 && every > own ? every : own;
+}
+function observeGeneration(generation, floorKey) {
+  if (typeof generation !== "number") return;
+  for (const key of [floorKey, EVERY_STORE]) {
+    const floor = floors.get(key);
+    if (floor !== void 0 && generation >= floor) floors.delete(key);
+  }
+}
+
+// src/server/tags.ts
+function familyOf(route) {
+  if (route === "config") return "config";
+  return route === "pages" || route === "page" ? "pages" : "data";
+}
+function catalogTags(route, handle) {
+  const tags = [CACHE_TAG, `${CACHE_TAG}:${familyOf(route)}`];
+  if (route !== familyOf(route)) tags.push(`${CACHE_TAG}:${route}`);
+  if (handle !== void 0) tags.push(`${CACHE_TAG}:${route}:${handle}`);
+  return tags.filter((tag) => tag.length <= TAG_MAX_CHARS);
+}
+function tagsForUrl(url, storefront) {
+  const path = url.split(/[?#]/u, 1)[0] ?? "";
+  if (!path.startsWith(storefront)) return null;
+  const found = storefrontRoute(path.slice(storefront.length));
+  return found === null ? null : catalogTags(found.route, found.handle);
+}
+var family = (name) => `${CACHE_TAG}:${name}`;
+function tagsForScope(scope) {
+  const colon = scope.indexOf(":");
+  const name = colon < 0 ? scope : scope.slice(0, colon);
+  const handle = colon < 0 ? "" : scope.slice(colon + 1);
+  switch (scope) {
+    case "settings":
+    case "navigation":
+      return [family("config")];
+    case "filters":
+      return [family("config"), family("data")];
+    case "pages":
+      return [family("pages")];
+    case "taxonomy":
+    case "catalog":
+      return [family("data")];
+  }
+  if (handle !== "") {
+    if (name === "product" || name === "collection" || name === "category")
+      return [`${family(name)}:${handle}`, family("data")];
+    if (name === "reviews")
+      return [
+        `${family("reviews")}:${handle}`,
+        `${family("product")}:${handle}`
+      ];
+  }
+  return [family("data")];
+}
+function scopesToTags(scopes) {
+  const out = /* @__PURE__ */ new Set();
+  for (const scope of scopes) {
+    for (const tag of tagsForScope(scope)) {
+      if (tag.length <= TAG_MAX_CHARS) out.add(tag);
+    }
+  }
+  return [...out];
+}
+
+export {
+  DEFAULT_CACHE_POLICY,
+  storefrontRoute,
+  cacheKindForPath,
+  policyToNext,
+  noteMinGeneration,
+  pendingMinGeneration,
+  observeGeneration,
+  catalogTags,
+  tagsForUrl,
+  scopesToTags
+};