@wix/himalaya-cli 0.1544.0 → 0.1545.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-reviews.mjs

@@ -1,16 +1,24 @@
 // ../../stdlib/wix-sdk/reviews/src/index.ts
-function wixCall(method, path, body) {
+function wixCall(method, path, body, readOptions) {
   if (!globalThis.himalaya?.wixApi) {
     return Promise.reject(new Error("@himalaya/wix-reviews: host did not install the wixApi bridge"));
   }
-  return globalThis.himalaya.wixApi.call(method, path, body);
+  const api = globalThis.himalaya.wixApi;
+  if (readOptions?.cache || readOptions?.onCacheResult) {
+    if (!api.read) return Promise.reject(new Error("READ_LIFECYCLE_UNSUPPORTED: update the Himalaya runtime"));
+    return api.read(method, path, body, readOptions.site ? { "wix-site-id": readOptions.site } : void 0, { cache: readOptions.cache ?? "default" }).then((result) => {
+      readOptions.onCacheResult?.(result.cache);
+      return result.data;
+    });
+  }
+  return readOptions?.site ? api.call(method, path, body, { "wix-site-id": readOptions.site }) : api.call(method, path, body);
 }
-function queryReviews(query, returnPrivateReviews = false) {
-  return wixCall("POST", "/reviews/v1/reviews/query", { query, returnPrivateReviews });
+function queryReviews(query, returnPrivateReviews = false, readOptions) {
+  return wixCall("POST", "/reviews/v1/reviews/query", { query, returnPrivateReviews }, readOptions);
 }
-function getReview(id, returnPrivateReviews = true) {
+function getReview(id, returnPrivateReviews = true, readOptions) {
   const qs = returnPrivateReviews ? "?returnPrivateReviews=true" : "";
-  return wixCall("GET", `/reviews/v1/reviews/${encodeURIComponent(id)}${qs}`);
+  return wixCall("GET", `/reviews/v1/reviews/${encodeURIComponent(id)}${qs}`, void 0, readOptions);
 }
 function countReviews(filter, returnPrivateReviews = true) {
   return wixCall("POST", "/reviews/v1/reviews/count", { filter: filter ?? {}, returnPrivateReviews });

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-rich-content-editor.mjs

@@ -6,6 +6,9 @@ function defineService(name, def) {
       "@himalaya/state: defineService called outside a Himalaya runtime. This bundle must run inside a JSWorker (Tier 5)."
     );
   }
+  if (def.readLifecycle && (himalaya.readLifecycleVersion ?? 0) < 1) {
+    throw new Error("READ_LIFECYCLE_UNSUPPORTED: update the Himalaya runtime before installing this screen");
+  }
   return himalaya.defineService(name, def);
 }
 

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-seo.mjs

@@ -9,12 +9,26 @@ function wixCall(method, path, body, opts) {
       new Error("@himalaya/wix-seo-v1: host did not install the wixApi bridge")
     );
   }
-  return globalThis.himalaya.wixApi.call(
-    method,
-    path,
-    body,
-    wixCallHeaders(opts)
+  const api = globalThis.himalaya.wixApi;
+  const verb = method.toUpperCase();
+  const readShaped = verb === "GET" || verb === "HEAD" || verb === "POST" && /\/(query|query-cursor|search|list|count)(\?|$)/.test(
+    path.split("#")[0]
   );
+  if (readShaped && (opts?.cache || opts?.onCacheResult)) {
+    if (!api.read)
+      return Promise.reject(
+        new Error("READ_LIFECYCLE_UNSUPPORTED: update the Himalaya runtime")
+      );
+    return api.read(method, path, body, wixCallHeaders(opts), {
+      cache: opts.cache ?? "default"
+    }).then((result) => {
+      opts.onCacheResult?.(result.cache);
+      return result.data;
+    });
+  }
+  if (opts?.cache === "only-if-cached")
+    return Promise.reject(new Error("OFFLINE_CACHE_MISS"));
+  return api.call(method, path, body, wixCallHeaders(opts));
 }
 function wixQueryPath(path, req) {
   const parts = [];

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-site-list.mjs

@@ -22,12 +22,26 @@ function wixCall(method, path, body, opts) {
       )
     );
   }
-  return globalThis.himalaya.wixApi.call(
-    method,
-    path,
-    body,
-    wixCallHeaders(opts)
+  const api = globalThis.himalaya.wixApi;
+  const verb = method.toUpperCase();
+  const readShaped = verb === "GET" || verb === "HEAD" || verb === "POST" && /\/(query|query-cursor|search|list|count)(\?|$)/.test(
+    path.split("#")[0]
   );
+  if (readShaped && (opts?.cache || opts?.onCacheResult)) {
+    if (!api.read)
+      return Promise.reject(
+        new Error("READ_LIFECYCLE_UNSUPPORTED: update the Himalaya runtime")
+      );
+    return api.read(method, path, body, wixCallHeaders(opts), {
+      cache: opts.cache ?? "default"
+    }).then((result) => {
+      opts.onCacheResult?.(result.cache);
+      return result.data;
+    });
+  }
+  if (opts?.cache === "only-if-cached")
+    return Promise.reject(new Error("OFFLINE_CACHE_MISS"));
+  return api.call(method, path, body, wixCallHeaders(opts));
 }
 function querySites(req = {}, opts) {
   return wixCall(

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-social-feed.mjs

@@ -1,17 +1,27 @@
 // ../../stdlib/wix-sdk/social-feed/src/index.ts
-function wixCall(method, path, body) {
+function wixCall(method, path, body, readOptions) {
   if (!globalThis.himalaya?.wixApi) {
-    return Promise.reject(new Error("@himalaya/wix-social-feed: host did not install the wixApi bridge"));
+    return Promise.reject(
+      new Error("@himalaya/wix-social-feed: host did not install the wixApi bridge")
+    );
   }
-  return globalThis.himalaya.wixApi.call(method, path, body);
+  const api = globalThis.himalaya.wixApi;
+  if (readOptions?.cache || readOptions?.onCacheResult) {
+    if (!api.read) return Promise.reject(new Error("READ_LIFECYCLE_UNSUPPORTED: update the Himalaya runtime"));
+    return api.read(method, path, body, readOptions.site ? { "wix-site-id": readOptions.site } : void 0, { cache: readOptions.cache ?? "default" }).then((result) => {
+      readOptions.onCacheResult?.(result.cache);
+      return result.data;
+    });
+  }
+  return readOptions?.site ? api.call(method, path, body, { "wix-site-id": readOptions.site }) : api.call(method, path, body);
 }
 var FEED_BASE = "https://social.wix.com/api/v1/feed";
 var FEED_SERVERLESS = "https://social.wix.com/serverless/mobile/feed";
 var GROUPS_APP_DEF_ID = "148c2287-c669-d849-d153-463c7486a694";
-function listFeedItems(groupId, limit = 20) {
+function listFeedItems(groupId, limit = 20, options) {
   if (!groupId) throw new Error("listFeedItems: groupId is required");
   const qs = `containerId=${encodeURIComponent(groupId)}&appDefId=${GROUPS_APP_DEF_ID}&limit=${limit}&feedType=all&contentType=DRAFTJS`;
-  return wixCall("GET", `${FEED_SERVERLESS}/v4/feedPosts/?${qs}`);
+  return wixCall("GET", `${FEED_SERVERLESS}/v4/feedPosts/?${qs}`, void 0, options);
 }
 function createFeedItem(groupId, content) {
   if (!groupId) throw new Error("createFeedItem: groupId is required");

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-stores-collections.mjs

@@ -79,18 +79,20 @@ function wixMediaUrl(value, size = WIX_LIST_IMAGE) {
 
 // ../../stdlib/wix-sdk/stores-collections/src/display.ts
 var STORES_TREE = { appNamespace: "@wix/stores" };
-function queryStoreCategories(limit = 50, cursor) {
+function queryStoreCategories(limit = 50, cursor, options) {
   return wixCall("POST", "/categories/v1/categories/query", {
     query: { cursorPaging: { limit, ...cursor ? { cursor } : {} } },
     treeReference: STORES_TREE,
     fields: ["DESCRIPTION"]
-  });
+  }, options);
 }
-function getStoreCategory(categoryId) {
+function getStoreCategory(categoryId, options) {
   if (!categoryId) throw new Error("getStoreCategory: categoryId is required");
   return wixCall(
     "GET",
-    `/categories/v1/categories/${encodeURIComponent(categoryId)}?treeReference.appNamespace=${encodeURIComponent("@wix/stores")}&fields=DESCRIPTION`
+    `/categories/v1/categories/${encodeURIComponent(categoryId)}?treeReference.appNamespace=${encodeURIComponent("@wix/stores")}&fields=DESCRIPTION`,
+    void 0,
+    options
   );
 }
 function categoryCount(c) {
@@ -102,21 +104,29 @@ function categoryImage(c, size = WIX_LIST_IMAGE) {
 }
 
 // ../../stdlib/wix-sdk/stores-collections/src/index.ts
-function wixCall(method, path, body) {
+function wixCall(method, path, body, readOptions) {
   if (!globalThis.himalaya?.wixApi) {
     return Promise.reject(
       new Error("@himalaya/wix-stores-collections: host did not install the wixApi bridge")
     );
   }
-  return globalThis.himalaya.wixApi.call(method, path, body);
+  const api = globalThis.himalaya.wixApi;
+  if (readOptions?.cache || readOptions?.onCacheResult) {
+    if (!api.read) return Promise.reject(new Error("READ_LIFECYCLE_UNSUPPORTED: update the Himalaya runtime"));
+    return api.read(method, path, body, readOptions.site ? { "wix-site-id": readOptions.site } : void 0, { cache: readOptions.cache ?? "default" }).then((result) => {
+      readOptions.onCacheResult?.(result.cache);
+      return result.data;
+    });
+  }
+  return readOptions?.site ? api.call(method, path, body, { "wix-site-id": readOptions.site }) : api.call(method, path, body);
 }
-function getCollection(collectionId) {
+function getCollection(collectionId, options) {
   if (!collectionId) throw new Error("getCollection: collectionId is required");
-  return wixCall("GET", `/stores/v1/collections/${encodeURIComponent(collectionId)}?includeNumberOfProducts=true`);
+  return wixCall("GET", `/stores/v1/collections/${encodeURIComponent(collectionId)}?includeNumberOfProducts=true`, void 0, options);
 }
-function queryCollections(req = {}) {
+function queryCollections(req = {}, options) {
   const body = { includeNumberOfProducts: true, ...req };
-  return wixCall("POST", "/stores/v1/collections/query", body);
+  return wixCall("POST", "/stores/v1/collections/query", body, options);
 }
 function createCollection(collection) {
   return wixCall("POST", "/stores/v1/collections", { collection });

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-stores.mjs

@@ -1,26 +1,34 @@
 // ../../stdlib/wix-sdk/stores-v1/src/catalog.ts
 var CATALOG_VERSION_KEY = "wix.stores.catalog-version.v1";
-var memo;
-var memoStamp;
-var inflight;
-var generation = 0;
-var resolveUnavailable = false;
+var catalogStates = /* @__PURE__ */ new Map();
+function stateFor(site) {
+  const key = site ?? "";
+  let state = catalogStates.get(key);
+  if (!state) {
+    state = { generation: 0, resolveUnavailable: false };
+    catalogStates.set(key, state);
+  }
+  return state;
+}
+function catalogKey(site) {
+  return site ? `${CATALOG_VERSION_KEY}:site:${encodeURIComponent(site)}` : CATALOG_VERSION_KEY;
+}
 function catalogStorage() {
   const host = globalThis;
   return host.himalaya?.storage ?? host.localStorage;
 }
-function persistedCatalogVersion() {
+function persistedCatalogVersion(site) {
   try {
-    const value = catalogStorage()?.getItem(CATALOG_VERSION_KEY);
+    const value = catalogStorage()?.getItem(catalogKey(site));
     return value === "v1" || value === "v3" ? value : void 0;
   } catch {
     return void 0;
   }
 }
 var CLEARED_PREFIX = "cleared:";
-function catalogWitness() {
+function catalogWitness(site) {
   try {
-    return catalogStorage()?.getItem(CATALOG_VERSION_KEY) ?? "";
+    return catalogStorage()?.getItem(catalogKey(site)) ?? "";
   } catch {
     return "";
   }
@@ -28,55 +36,58 @@ function catalogWitness() {
 function clearedToken() {
   return `${CLEARED_PREFIX}${Date.now().toString(36)}.${Math.random().toString(36).slice(2, 10)}`;
 }
-function rememberCatalogVersion(version, persist = true, witness) {
+function rememberCatalogVersion(version, persist = true, witness, site) {
+  const state = stateFor(site);
   const store = catalogStorage();
   if (!store) {
-    memo = version;
-    memoStamp = void 0;
+    state.memo = version;
+    state.memoStamp = void 0;
     return;
   }
   let current;
   try {
-    current = store.getItem(CATALOG_VERSION_KEY) ?? "";
+    current = store.getItem(catalogKey(site)) ?? "";
   } catch {
-    memo = version;
-    memoStamp = void 0;
+    state.memo = version;
+    state.memoStamp = void 0;
     return;
   }
   if (witness !== void 0 && current !== witness) return;
   if (persist) {
     try {
-      if (current !== version) store.setItem(CATALOG_VERSION_KEY, version);
+      if (current !== version) store.setItem(catalogKey(site), version);
     } catch {
-      memo = version;
-      memoStamp = void 0;
+      state.memo = version;
+      state.memoStamp = void 0;
       return;
     }
   }
-  memo = version;
-  memoStamp = persist ? version : current;
-}
-function liveMemo() {
-  if (!memo || memoStamp === void 0) return memo;
-  if (catalogWitness() !== memoStamp) {
-    memo = void 0;
-    memoStamp = void 0;
+  state.memo = version;
+  state.memoStamp = persist ? version : current;
+}
+function liveMemo(site) {
+  const state = stateFor(site);
+  if (!state.memo || state.memoStamp === void 0) return state.memo;
+  if (catalogWitness(site) !== state.memoStamp) {
+    state.memo = void 0;
+    state.memoStamp = void 0;
   }
-  return memo;
-}
-function forgetCatalogVersion() {
-  generation += 1;
-  memo = void 0;
-  memoStamp = void 0;
-  inflight = void 0;
-  resolveUnavailable = false;
+  return state.memo;
+}
+function forgetCatalogVersion(site) {
+  const state = stateFor(site);
+  state.generation += 1;
+  state.memo = void 0;
+  state.memoStamp = void 0;
+  state.inflight = void 0;
+  state.resolveUnavailable = false;
   try {
-    catalogStorage()?.setItem(CATALOG_VERSION_KEY, clearedToken());
+    catalogStorage()?.setItem(catalogKey(site), clearedToken());
   } catch {
   }
 }
-function observedCatalogVersion() {
-  return liveMemo() ?? persistedCatalogVersion();
+function observedCatalogVersion(site) {
+  return liveMemo(site) ?? persistedCatalogVersion(site);
 }
 function isCatalogMismatch(e) {
   return /CATALOG_V[13]|catalog version/i.test(String(e?.message ?? e));
@@ -87,48 +98,52 @@ function catalogVersionFromMismatch(e) {
   if (/CATALOG_V3(_SITE)?_CALLING/i.test(message)) return "v3";
   return void 0;
 }
-function noteCatalogMismatch(attempted, error, witness) {
+function noteCatalogMismatch(attempted, error, witness, site) {
   const named = catalogVersionFromMismatch(error);
-  rememberCatalogVersion(named ?? (attempted === "v3" ? "v1" : "v3"), named !== void 0, witness);
-}
-async function readWithCatalogFallback(attempt) {
-  const first = observedCatalogVersion() ?? (resolveUnavailable ? "v3" : await resolveCatalogVersion());
-  const witness = catalogWitness();
-  const startedAt = generation;
+  rememberCatalogVersion(named ?? (attempted === "v3" ? "v1" : "v3"), named !== void 0, witness, site);
+}
+async function readWithCatalogFallback(attempt, cacheOnly = false, site) {
+  const state = stateFor(site);
+  const observed = observedCatalogVersion(site);
+  const first = observed ?? (cacheOnly || state.resolveUnavailable ? "v3" : await resolveCatalogVersion(site));
+  const witness = catalogWitness(site);
+  const startedAt = state.generation;
   try {
     return await attempt(first);
   } catch (error) {
+    if (cacheOnly && !observed && /OFFLINE_CACHE_MISS/.test(String(error))) return attempt(first === "v3" ? "v1" : "v3");
     if (!isCatalogMismatch(error)) throw error;
-    if (generation === startedAt) noteCatalogMismatch(first, error, witness);
+    if (state.generation === startedAt) noteCatalogMismatch(first, error, witness, site);
     const named = catalogVersionFromMismatch(error);
     const corrected = named !== void 0 && named !== first ? named : first === "v3" ? "v1" : "v3";
     return attempt(corrected);
   }
 }
-async function resolveCatalogVersion() {
-  const known = liveMemo();
+async function resolveCatalogVersion(site) {
+  const state = stateFor(site);
+  const known = liveMemo(site);
   if (known) return known;
-  const stored = persistedCatalogVersion();
+  const stored = persistedCatalogVersion(site);
   if (stored) {
-    memo = stored;
-    memoStamp = stored;
+    state.memo = stored;
+    state.memoStamp = stored;
     return stored;
   }
-  if (!inflight) {
-    const startedAt = generation;
-    const witness = catalogWitness();
-    inflight = wixCall("GET", "/stores/v3/provision/version").then((res) => {
+  if (!state.inflight) {
+    const startedAt = state.generation;
+    const witness = catalogWitness(site);
+    state.inflight = wixCall("GET", "/stores/v3/provision/version", void 0, site ? { site } : void 0).then((res) => {
       const v = res?.catalogVersion === "V1_CATALOG" ? "v1" : "v3";
-      if (generation === startedAt) rememberCatalogVersion(v, true, witness);
+      if (state.generation === startedAt) rememberCatalogVersion(v, true, witness, site);
       return v;
     }).catch(() => {
-      if (generation === startedAt) resolveUnavailable = true;
+      if (state.generation === startedAt) state.resolveUnavailable = true;
       return "v3";
     }).finally(() => {
-      if (generation === startedAt) inflight = void 0;
+      if (state.generation === startedAt) state.inflight = void 0;
     });
   }
-  return inflight;
+  return state.inflight;
 }
 
 // ../../stdlib/wix-sdk/stores-v1/src/products-v3.ts
@@ -349,22 +364,22 @@ function fromV1(res, offset) {
     }
   };
 }
-function queryV1(limit, cursor) {
+function queryV1(limit, cursor, options) {
   const offset = v1Offset(cursor);
   return wixCall("POST", "/stores/v1/products/query", {
     query: { paging: { limit, offset } }
-  }).then((res) => fromV1(res, offset));
+  }, options).then((res) => fromV1(res, offset));
 }
-async function queryStoreProducts(limit = 50, cursor, fields) {
+async function queryStoreProducts(limit = 50, cursor, fields, options) {
   return readWithCatalogFallback((version) => {
-    if (version === "v1") return queryV1(limit, cursor);
+    if (version === "v1") return queryV1(limit, cursor, options);
     return wixCall("POST", "/stores/v3/products/query", {
       query: { cursorPaging: cursor ? { limit, cursor } : { limit } },
       fields: readFields(fields)
-    });
-  });
+    }, options);
+  }, options?.cache === "only-if-cached", options?.site);
 }
-async function searchStoreProducts(options = {}) {
+async function searchStoreProducts(options = {}, readOptions) {
   const query = (options.query ?? "").trim().slice(0, 256);
   const limit = Math.max(1, Math.min(100, Math.floor(options.limit ?? 50) || 50));
   const ids = options.ids === void 0 ? void 0 : [...new Set(options.ids.filter((id) => typeof id === "string" && !!id))].slice(0, 500);
@@ -383,7 +398,7 @@ async function searchStoreProducts(options = {}) {
         paging: { limit, offset },
         ...Object.keys(filter2).length ? { filter: JSON.stringify(filter2) } : {},
         ...sorted ? { sort: JSON.stringify([{ name: ascending ? "asc" : "desc" }]) } : {}
-      } }).then((res) => fromV1(res, offset));
+      } }, readOptions).then((res) => fromV1(res, offset));
     }
     const filter = {
       ...ids ? { id: { $in: ids } } : {},
@@ -399,22 +414,24 @@ async function searchStoreProducts(options = {}) {
     return wixCall("POST", `/stores/v3/products/${search ? "search" : "query"}`, {
       [search ? "search" : "query"]: criteria,
       fields: readFields(options.fields)
-    });
-  });
+    }, readOptions);
+  }, readOptions?.cache === "only-if-cached", readOptions?.site);
 }
-function getProductV1(productId) {
-  return wixCall("GET", `/stores/v1/products/${encodeURIComponent(productId)}`);
+function getProductV1(productId, readOptions) {
+  return wixCall("GET", `/stores/v1/products/${encodeURIComponent(productId)}`, void 0, readOptions);
 }
-async function getStoreProduct(productId, fields) {
+async function getStoreProduct(productId, fields, readOptions) {
   if (!productId) throw new Error("getStoreProduct: productId is required");
   return readWithCatalogFallback((version) => {
-    if (version === "v1") return getProductV1(productId);
+    if (version === "v1") return getProductV1(productId, readOptions);
     const query = readFields(fields).map((f) => `fields=${encodeURIComponent(f)}`).join("&");
     return wixCall(
       "GET",
-      `/stores/v3/products/${encodeURIComponent(productId)}?${query}`
+      `/stores/v3/products/${encodeURIComponent(productId)}?${query}`,
+      void 0,
+      readOptions
     );
-  });
+  }, readOptions?.cache === "only-if-cached", readOptions?.site);
 }
 function productImage(p, size = WIX_LIST_IMAGE) {
   const raw = rawMediaSlot(p.media?.mainMedia) || rawMediaSlot(p.media?.main) || rawMediaSlot(p.media?.items?.[0]) || rawMediaSlot(p.media?.itemsInfo?.items?.[0]) || "";
@@ -736,20 +753,22 @@ function queryProducts(req = {}) {
     return { products: page.map(fromV3Product) };
   });
 }
-function getProduct(productId, opts = {}) {
+function getProduct(productId, opts = {}, readOptions) {
   if (!productId) throw new Error("getProduct: productId is required");
   const id = encodeURIComponent(productId);
   const fields = opts.richDescription ? V3_DETAIL_READ_FIELDS : V3_READ_FIELDS;
   return readWithCatalogFallback(async (v) => {
-    if (v === "v1") return wixCall("GET", `/stores/v1/products/${id}`);
+    if (v === "v1") return wixCall("GET", `/stores/v1/products/${id}`, void 0, readOptions);
     const res = await wixCall(
       "GET",
-      `/stores/v3/products/${id}?${fields.map((f) => `fields=${f}`).join("&")}`
+      `/stores/v3/products/${id}?${fields.map((f) => `fields=${f}`).join("&")}`,
+      void 0,
+      readOptions
     );
     if (!res.product) return { product: void 0 };
     const product = fromV3Product(res.product);
     return { product: opts.richDescription ? { ...product, richDescription: res.product.description ?? null } : product };
-  });
+  }, readOptions?.cache === "only-if-cached", readOptions?.site);
 }
 async function createProduct(product) {
   if (await resolveCatalogVersion() === "v1") {
@@ -806,12 +825,26 @@ function wixCall(method, path, body, opts) {
       )
     );
   }
-  return globalThis.himalaya.wixApi.call(
-    method,
-    path,
-    body,
-    wixCallHeaders(opts)
+  const api = globalThis.himalaya.wixApi;
+  const verb = method.toUpperCase();
+  const readShaped = verb === "GET" || verb === "HEAD" || verb === "POST" && /\/(query|query-cursor|search|list|count)(\?|$)/.test(
+    path.split("#")[0]
   );
+  if (readShaped && (opts?.cache || opts?.onCacheResult)) {
+    if (!api.read)
+      return Promise.reject(
+        new Error("READ_LIFECYCLE_UNSUPPORTED: update the Himalaya runtime")
+      );
+    return api.read(method, path, body, wixCallHeaders(opts), {
+      cache: opts.cache ?? "default"
+    }).then((result) => {
+      opts.onCacheResult?.(result.cache);
+      return result.data;
+    });
+  }
+  if (opts?.cache === "only-if-cached")
+    return Promise.reject(new Error("OFFLINE_CACHE_MISS"));
+  return api.call(method, path, body, wixCallHeaders(opts));
 }
 function addProductMedia(productId, opts) {
   if (!productId) throw new Error("addProductMedia: productId is required");

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-table-reservations.mjs

@@ -1,15 +1,23 @@
 // ../../stdlib/wix-sdk/table-reservations/src/index.ts
-function wixCall(method, path, body) {
+function wixCall(method, path, body, readOptions) {
   if (!globalThis.himalaya?.wixApi) {
     return Promise.reject(new Error("@himalaya/wix-table-reservations: host did not install the wixApi bridge"));
   }
-  return globalThis.himalaya.wixApi.call(method, path, body);
+  const api = globalThis.himalaya.wixApi;
+  if (readOptions?.cache || readOptions?.onCacheResult) {
+    if (!api.read) return Promise.reject(new Error("READ_LIFECYCLE_UNSUPPORTED: update the Himalaya runtime"));
+    return api.read(method, path, body, readOptions.site ? { "wix-site-id": readOptions.site } : void 0, { cache: readOptions.cache ?? "default" }).then((result) => {
+      readOptions.onCacheResult?.(result.cache);
+      return result.data;
+    });
+  }
+  return readOptions?.site ? api.call(method, path, body, { "wix-site-id": readOptions.site }) : api.call(method, path, body);
 }
-function queryReservations(query) {
-  return wixCall("POST", "/table-reservations/reservations/v1/reservations/query", { query });
+function queryReservations(query, readOptions) {
+  return wixCall("POST", "/table-reservations/reservations/v1/reservations/query", { query }, readOptions);
 }
-function getReservation(reservationId) {
-  return wixCall("GET", `/table-reservations/reservations/v1/reservations/${reservationId}`);
+function getReservation(reservationId, readOptions) {
+  return wixCall("GET", `/table-reservations/reservations/v1/reservations/${reservationId}`, void 0, readOptions);
 }
 function updateReservationStatus(reservationId, revision, status) {
   return wixCall("PATCH", `/table-reservations/reservations/v1/reservations/${reservationId}`, {
@@ -20,8 +28,8 @@ function updateReservationStatus(reservationId, revision, status) {
 function cancelReservation(reservationId, revision) {
   return wixCall("POST", `/table-reservations/reservations/v1/reservations/${reservationId}/cancel`, { revision });
 }
-function listReservationLocations() {
-  return wixCall("GET", "/table-reservations/reservation-locations/v1/reservation-locations");
+function listReservationLocations(readOptions) {
+  return wixCall("GET", "/table-reservations/reservation-locations/v1/reservation-locations", void 0, readOptions);
 }
 function createHeldReservation(reservationDetails) {
   return wixCall("POST", "/table-reservations/reservations/v1/reservations/hold", { reservationDetails });

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-users.mjs

@@ -1,12 +1,22 @@
 // ../../stdlib/wix-sdk/users/src/index.ts
-function wixCall(method, path, body) {
+function wixCall(method, path, body, readOptions) {
   if (!globalThis.himalaya?.wixApi) {
-    return Promise.reject(new Error("@himalaya/wix-users: host did not install the wixApi bridge"));
+    return Promise.reject(
+      new Error("@himalaya/wix-users: host did not install the wixApi bridge")
+    );
   }
-  return globalThis.himalaya.wixApi.call(method, path, body);
+  const api = globalThis.himalaya.wixApi;
+  if (readOptions?.cache || readOptions?.onCacheResult) {
+    if (!api.read) return Promise.reject(new Error("READ_LIFECYCLE_UNSUPPORTED: update the Himalaya runtime"));
+    return api.read(method, path, body, readOptions.site ? { "wix-site-id": readOptions.site } : void 0, { cache: readOptions.cache ?? "default" }).then((result) => {
+      readOptions.onCacheResult?.(result.cache);
+      return result.data;
+    });
+  }
+  return readOptions?.site ? api.call(method, path, body, { "wix-site-id": readOptions.site }) : api.call(method, path, body);
 }
-function getMyData() {
-  return wixCall("GET", "https://users.wix.com/wix-users/v1/users/my-data?includeProfile=true");
+function getMyData(options) {
+  return wixCall("GET", "https://users.wix.com/wix-users/v1/users/my-data?includeProfile=true", void 0, options);
 }
 function displayName(d) {
   const full = [d.profile?.firstName, d.profile?.lastName].filter(Boolean).join(" ").trim();

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-video.mjs

@@ -197,8 +197,16 @@ async function wixVideoQuery(query, variables = {}, opts) {
   if (!wixApi) throw wixVideoError("@himalaya/wix-video: host did not install the wixApi bridge");
   const headers = callHeaders(opts);
   let response;
+  const lifecycle = !!(opts?.cache || opts?.onCacheResult);
+  if (lifecycle && !wixApi.read) throw wixVideoError("READ_LIFECYCLE_UNSUPPORTED: update the Himalaya runtime");
   try {
-    response = await (headers ? wixApi.call("POST", WIX_VIDEO_GRAPHQL_URL, { query, variables }, headers) : wixApi.call("POST", WIX_VIDEO_GRAPHQL_URL, { query, variables }));
+    if (lifecycle) {
+      const result = await wixApi.read("POST", WIX_VIDEO_GRAPHQL_URL, { query, variables }, headers, { cache: opts.cache ?? "default" });
+      opts.onCacheResult?.(result.cache);
+      response = result.data;
+    } else {
+      response = await (headers ? wixApi.call("POST", WIX_VIDEO_GRAPHQL_URL, { query, variables }, headers) : wixApi.call("POST", WIX_VIDEO_GRAPHQL_URL, { query, variables }));
+    }
   } catch (error) {
     throw transportError(error);
   }