@wix/himalaya-cli 0.1544.0 → 0.1545.0

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

@@ -11,12 +11,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 wixQueryPath(path, req) {
   const parts = [];

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

@@ -1,9 +1,18 @@
 // ../../stdlib/wix-sdk/chat-web/src/index.ts
-function wixCall(method, path, body, headers) {
-  if (!globalThis.himalaya?.wixApi) {
+function wixCall(method, path, body, headers, options) {
+  const api = globalThis.himalaya?.wixApi;
+  if (!api) {
     return Promise.reject(new Error("@himalaya/wix-chat-web: host did not install the wixApi bridge"));
   }
-  return globalThis.himalaya.wixApi.call(method, path, body, headers);
+  const readShaped = method === "GET" || method === "HEAD" || method === "POST" && (/\/(query|search|list|count)(\?|$)/.test(path) || /\/_api\/chat-web\/v1\/chatrooms-for-list-view(?:\/(?:business|siteMember))?(?:[?#]|$)/.test(path));
+  if (readShaped && (options?.cache || options?.onCacheResult)) {
+    if (!api.read) return Promise.reject(new Error("READ_LIFECYCLE_UNSUPPORTED: update the Himalaya runtime"));
+    return api.read(method, path, body ?? null, headers, { cache: options.cache ?? "default" }).then((result) => {
+      options.onCacheResult?.(result.cache);
+      return result.data;
+    });
+  }
+  return api.call(method, path, body, headers);
 }
 function uuid() {
   return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
@@ -92,10 +101,17 @@ async function getMessagesPage(chatroomId, params = {}) {
     throw chatWebError("invalid_argument", "invalid ordering");
   }
   const { chatToken } = await getChatToken(params);
+  if (!chatToken) {
+    if (params.cache || params.onCacheResult) throw chatWebError("token_empty", "Chat authorization unavailable");
+    return { items: [], next: void 0, nextPointer: void 0 };
+  }
   const query = queryString({ chatToken, pageSize: size, ordering, nextPointer });
   const res = await wixCall(
     "GET",
-    `${BASE}/_api/chat-web/v1/chatrooms/${room}/messages?${query}`
+    `${BASE}/_api/chat-web/v1/chatrooms/${room}/messages?${query}`,
+    void 0,
+    void 0,
+    params
   );
   if (!res || typeof res !== "object") throw chatWebError("invalid_response", "history response is not an object");
   const items = requiredArray(res.items, "items");
@@ -138,6 +154,9 @@ async function getChatToken(options = {}) {
     }
     return { chatToken: options.chatToken };
   }
+  if (options.cache === "only-if-cached") {
+    throw chatWebError("token_empty", "Chat authorization unavailable offline");
+  }
   const role = options.role ?? "owner";
   if (role !== "owner" && role !== "member") {
     throw chatWebError("invalid_argument", "invalid role");
@@ -156,14 +175,17 @@ async function getChatToken(options = {}) {
       failure = e;
     }
   }
-  throw failure === void 0 ? chatWebError("token_empty", `chat token mint returned no token after ${TOKEN_MINT_ATTEMPTS} attempts`) : chatWebError("token_mint_failed", `chat token mint failed after ${TOKEN_MINT_ATTEMPTS} attempts`, failure);
+  throw failure === void 0 ? chatWebError("token_empty", "Chat authorization unavailable") : chatWebError("token_mint_failed", `chat token mint failed after ${TOKEN_MINT_ATTEMPTS} attempts`, failure);
 }
 async function listChatrooms(pageSize = 20, options = {}) {
   if (options.role === "member") return (await listChatroomsPage({ ...options, pageSize })).items;
   const { chatToken } = await getChatToken(options);
   const res = await wixCall(
     "GET",
-    `${BASE}/_api/chat-web/v2/chatrooms?chatToken=${encodeURIComponent(chatToken)}&pageSize=${pageSize}`
+    `${BASE}/_api/chat-web/v2/chatrooms?chatToken=${encodeURIComponent(chatToken)}&pageSize=${pageSize}`,
+    void 0,
+    void 0,
+    options
   );
   return res.chatrooms?.items ?? [];
 }
@@ -197,7 +219,7 @@ async function listChatroomsPage(params = {}) {
     lastMessageLimit: LAST_MESSAGE_LIMIT,
     unreadChatroomLimit: unreadLimit
   });
-  const res = await wixCall("POST", `${BASE}/_api/chat-web/v1/chatrooms-for-list-view${type}?${query}`, { participantIds, labelIds: [] });
+  const res = await wixCall("POST", `${BASE}/_api/chat-web/v1/chatrooms-for-list-view${type}?${query}`, { participantIds, labelIds: [] }, void 0, params);
   if (!res || typeof res !== "object" || !res.chatrooms || typeof res.chatrooms !== "object") {
     throw chatWebError("invalid_response", "list response has no chatrooms");
   }

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

@@ -189,12 +189,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 wixQueryPath(path, req) {
   const parts = [];
@@ -490,6 +504,15 @@ function send(verb, template, req, opts, route, queue) {
   const headers = site ? { "wix-site-id": site } : void 0;
   const target = route.query ? wixQueryPath2(path, withoutFields(req, fields)) : path;
   const body = route.query ? void 0 : req;
+  const readShaped = verb === "GET" || verb === "HEAD" || verb === "POST" && /\/(query|query-cursor|search|list|count)(?:\?|$)/i.test(target.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(verb, target, body, headers, { 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"));
   if (!queue) return api.call(verb, target, body, headers);
   if (!api.offline) return api.call(verb, target, body, headers).then((value) => ({ status: "sent", value }));
   return api.call(verb, target, body, headers, { offline: "queue" });

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-contacts.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 wixQueryPath(path, req) {
   const parts = [];

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

@@ -1,18 +1,26 @@
 // ../../stdlib/wix-sdk/coupons/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-coupons: 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 queryCoupons(req = {}) {
-  return wixCall("POST", "/stores/v2/coupons/query", { query: req });
+function queryCoupons(req = {}, readOptions) {
+  return wixCall("POST", "/stores/v2/coupons/query", { query: req }, readOptions);
 }
-function getCoupon(id) {
+function getCoupon(id, options) {
   if (!id) throw new Error("getCoupon: id is required");
-  return wixCall("GET", `/stores/v2/coupons/${encodeURIComponent(id)}`);
+  return wixCall("GET", `/stores/v2/coupons/${encodeURIComponent(id)}`, void 0, options);
 }
 function createCoupon(specification) {
   return wixCall("POST", "/stores/v2/coupons", { specification });

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

@@ -21,12 +21,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 wixQueryPath(path, req) {
   const parts = [];

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

@@ -1,11 +1,19 @@
 // ../../stdlib/wix-sdk/wix-data/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-data: 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 queryDataItems(dataCollectionId, limit = 50, filter, returnTotalCount = false, offset = 0, sort, options) {
   if (!dataCollectionId) throw new Error("queryDataItems: dataCollectionId is required");
@@ -32,14 +40,16 @@ function queryDataItems(dataCollectionId, limit = 50, filter, returnTotalCount =
     ...options?.language ? { language: options.language } : {},
     ...options?.includeDraftItems ? { publishPluginOptions: { includeDraftItems: true } } : {}
   };
-  return wixCall("POST", "/wix-data/v2/items/query", body);
+  return wixCall("POST", "/wix-data/v2/items/query", body, options);
 }
-function getDataItem(dataCollectionId, dataItemId) {
+function getDataItem(dataCollectionId, dataItemId, options) {
   if (!dataCollectionId) throw new Error("getDataItem: dataCollectionId is required");
   if (!dataItemId) throw new Error("getDataItem: dataItemId is required");
   return wixCall(
     "GET",
-    `/wix-data/v2/items/${encodeURIComponent(dataItemId)}?dataCollectionId=${encodeURIComponent(dataCollectionId)}`
+    `/wix-data/v2/items/${encodeURIComponent(dataItemId)}?dataCollectionId=${encodeURIComponent(dataCollectionId)}`,
+    void 0,
+    options
   );
 }
 function insertDataItem(dataCollectionId, data, options) {

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

@@ -11,12 +11,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 createDonationCampaign(req = {}, opts) {
   return wixCall(

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

@@ -1,6 +1,6 @@
 // ../../stdlib/wix-sdk/ecom/src/extensions.ts
-function getOrder(orderId) {
-  return wixCall("GET", `/ecom/v1/orders/${orderId}`);
+function getOrder(orderId, options) {
+  return wixCall("GET", `/ecom/v1/orders/${orderId}`, void 0, options);
 }
 function archiveOrder(orderId) {
   return wixCall("POST", `/ecom/v1/orders/${orderId}/archive`, {});
@@ -67,12 +67,15 @@ function isOrdersForbiddenError(error) {
   const msg = error instanceof Error ? error.message : String(error ?? "");
   return /READ_ORDER_FORBIDDEN|read order:\s*permission denied/i.test(msg);
 }
-async function getCurrentCart() {
+async function getCurrentCart(opts) {
   try {
-    const r = await wixCall("GET", "/ecom/v1/carts/current");
+    const r = await wixCall("GET", "/ecom/v1/carts/current", void 0, opts);
     return r.cart ?? r;
   } catch (e) {
-    if (isEmptyCurrentCartError(e)) return { lineItems: [] };
+    if (isEmptyCurrentCartError(e)) {
+      opts?.onCacheResult?.({ source: "network", fetchedAt: Date.now(), cacheable: false });
+      return { lineItems: [] };
+    }
     throw e;
   }
 }
@@ -135,11 +138,11 @@ function memberAddressFieldMask(patch) {
   walk(patch, "");
   return paths.join(",");
 }
-function listMemberAddresses() {
-  return wixCall("GET", MEMBER_ADDRESSES_URL);
+function listMemberAddresses(options) {
+  return wixCall("GET", MEMBER_ADDRESSES_URL, void 0, options);
 }
-function getMemberAddress(addressId) {
-  return wixCall("GET", memberAddressUrl(addressId, "getMemberAddress"));
+function getMemberAddress(addressId, options) {
+  return wixCall("GET", memberAddressUrl(addressId, "getMemberAddress"), void 0, options);
 }
 function getDefaultMemberAddress() {
   return wixCall("GET", `${MEMBER_ADDRESSES_URL}/get-default-address`);
@@ -172,11 +175,11 @@ function savedPaymentMethodPath(savedPaymentMethodId, fn) {
   if (!savedPaymentMethodId) throw new Error(`${fn}: savedPaymentMethodId is required`);
   return `${SAVED_PAYMENT_METHODS_PATH}/${encodeURIComponent(savedPaymentMethodId)}`;
 }
-function listMySavedPaymentMethods(opts = {}) {
+function listMySavedPaymentMethods(opts = {}, options) {
   const query = ["siteMemberId=me"];
   if (opts.limit) query.push(`paging.limit=${Math.max(1, Math.min(100, Math.floor(opts.limit)))}`);
   if (opts.cursor) query.push(`paging.cursor=${encodeURIComponent(opts.cursor)}`);
-  return wixCall("GET", `${SAVED_PAYMENT_METHODS_PATH}?${query.join("&")}`);
+  return wixCall("GET", `${SAVED_PAYMENT_METHODS_PATH}?${query.join("&")}`, void 0, options);
 }
 function deleteSavedPaymentMethod(savedPaymentMethodId) {
   return wixCall("DELETE", savedPaymentMethodPath(savedPaymentMethodId, "deleteSavedPaymentMethod"));
@@ -246,12 +249,26 @@ function wixCall(method, path, body, opts) {
       new Error("@himalaya/wix-ecom: 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 searchOrders(req = {}, opts) {
   return wixCall(

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

@@ -11,12 +11,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 wixQueryPath(path, req) {
   const parts = [];

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

@@ -258,11 +258,19 @@ function eventDescription(e) {
 }
 
 // ../../stdlib/wix-sdk/events/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-events: 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 BASE = "https://manage.wix.com/_api/wix-one-events-server/events-in-clubs";
 var EVENT_STATUSES = Object.freeze(["UPCOMING", "STARTED", "ENDED", "CANCELED", "DRAFT"]);
@@ -287,10 +295,10 @@ function eventStartMs(e) {
   const ms = s ? new Date(s).getTime() : NaN;
   return Number.isNaN(ms) ? Number.POSITIVE_INFINITY : ms;
 }
-async function queryEvents(opts = {}) {
+async function queryEvents(opts = {}, readOptions) {
   const limit = opts.limit ?? opts.query?.paging?.limit ?? 50;
   const offset = opts.offset ?? opts.query?.paging?.offset ?? 0;
-  const res = await wixCall("POST", "/events/v3/events/query", { query: { ...opts.query, paging: { limit, offset } } });
+  const res = await wixCall("POST", "/events/v3/events/query", { query: { ...opts.query, paging: { limit, offset } } }, readOptions);
   let events = (res.events ?? []).map(decodeEvent);
   if (opts.statuses) {
     const wanted = new Set(opts.statuses);
@@ -304,11 +312,11 @@ async function queryEvents(opts = {}) {
   if (opts.order === "start") events = events.slice().sort((a, b) => eventStartMs(a) - eventStartMs(b));
   return { ...res, events };
 }
-async function getEvent(eventId, opts = {}) {
+async function getEvent(eventId, opts = {}, readOptions) {
   if (!eventId) throw new Error("getEvent: eventId is required");
   const fields = (opts.fields ?? []).map((f) => `fields=${encodeURIComponent(f)}`).join("&");
   const query = fields ? `?${fields}` : "";
-  const res = await wixCall("GET", `/events/v3/events/${encodeURIComponent(eventId)}${query}`);
+  const res = await wixCall("GET", `/events/v3/events/${encodeURIComponent(eventId)}${query}`, void 0, readOptions);
   return { ...res, event: decodeEvent(res.event) };
 }
 function deleteEvent(eventId) {

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

@@ -9,12 +9,26 @@ function wixCall(method, path, body, opts) {
       new Error("@himalaya/wix-faq-v2: 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-forms.mjs

@@ -9,12 +9,26 @@ function wixCall(method, path, body, opts) {
       new Error("@himalaya/wix-forms: 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 queryForms(req, opts) {
   if (req?.filter?.["namespace"] == null || req?.filter?.["namespace"] === "")

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

@@ -92,12 +92,26 @@ function wixCall(method, path, body, opts) {
       new Error("@himalaya/wix-forum: 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 queryPosts(req = {}, opts) {
   return wixCall(

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

@@ -11,12 +11,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 wixQueryPath(path, req) {
   const parts = [];