@wix/himalaya-cli 0.1544.0 → 0.1545.0

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

@@ -1,3 +1,204 @@
+// ../../core/sdk/state/src/connectivity.ts
+function connectivity() {
+  const host = globalThis.himalaya;
+  if (!host?.connectivity?.current) throw new Error("CONNECTIVITY_UNSUPPORTED: update the Himalaya runtime before installing this screen");
+  const current = host.connectivity.current();
+  if (typeof current?.online !== "boolean") throw new Error("CONNECTIVITY_UNSUPPORTED: this host cannot report connectivity");
+  return current;
+}
+function requireConnectivity() {
+  if (!connectivity().online) throw new Error("You\u2019re offline \u2014 this change can\u2019t be saved right now. Connect and try again.");
+}
+
+// ../../core/sdk/state/src/read.ts
+var initialReadStatus = () => ({
+  hasSnapshot: false,
+  fromCache: false,
+  refreshing: false,
+  stale: false,
+  offline: false,
+  error: ""
+});
+function createReadController(options) {
+  let key = "", generation = 0, disposed = false;
+  let data, metadata, status = initialReadStatus();
+  let pending;
+  let expiryTimer;
+  const now = options.now ?? Date.now;
+  const online = options.online ?? (() => connectivity().online);
+  const expire = () => {
+    if (status.hasSnapshot && !online() && metadata?.source !== "local" && (!metadata?.cacheable || metadata.expiresAt === void 0 || metadata.expiresAt <= now())) {
+      data = void 0;
+      metadata = void 0;
+      status = { ...initialReadStatus(), offline: true };
+    }
+  };
+  const emit = () => {
+    if (expiryTimer !== void 0 && typeof globalThis.clearTimeout === "function") globalThis.clearTimeout(expiryTimer);
+    expiryTimer = void 0;
+    if (disposed) return;
+    expire();
+    status = { ...status, expiresAt: metadata?.cacheable ? metadata.expiresAt : void 0 };
+    options.publish(data, { ...status });
+    if (!online() && status.hasSnapshot && metadata && metadata.source !== "local" && metadata.cacheable && metadata.expiresAt !== void 0 && typeof globalThis.setTimeout === "function") {
+      expiryTimer = globalThis.setTimeout(emit, Math.min(2147483647, Math.max(1, metadata.expiresAt - now())));
+      expiryTimer.unref?.();
+    }
+  };
+  const run = async (revision, readKey) => {
+    const current = () => !disposed && revision === generation;
+    status = { ...status, refreshing: online(), offline: !online(), error: "" };
+    emit();
+    if (!status.hasSnapshot && options.cached) {
+      const cached = await options.cached(readKey).catch(() => void 0);
+      if (!current()) return;
+      if (cached && (options.allowLocal && cached.metadata.source === "local" || cached.metadata.source === "cache" && cached.metadata.cacheable && cached.metadata.expiresAt !== void 0 && cached.metadata.expiresAt > now())) {
+        data = cached.data;
+        metadata = cached.metadata;
+        const local = metadata.source === "local";
+        status = {
+          ...status,
+          hasSnapshot: true,
+          hasLocalContent: local,
+          fromCache: !local,
+          stale: !local,
+          lastSuccessAt: local ? void 0 : metadata.fetchedAt
+        };
+        emit();
+      } else {
+        emit();
+      }
+    }
+    if (!online()) {
+      if (current()) {
+        status = { ...status, refreshing: false, offline: true, stale: status.hasSnapshot && !status.hasLocalContent };
+        emit();
+      }
+      return;
+    }
+    if (!status.refreshing || status.offline) {
+      status = { ...status, refreshing: true, offline: false };
+      emit();
+    }
+    try {
+      const next = await options.fetch(readKey);
+      if (!current()) return;
+      if (next.metadata.source !== "network" && !(options.allowLocal && next.metadata.source === "local")) throw new Error("The refresh did not reach the server. Try again.");
+      data = next.data;
+      metadata = next.metadata;
+      const local = metadata.source === "local";
+      status = {
+        hasSnapshot: true,
+        hasLocalContent: local,
+        fromCache: false,
+        refreshing: false,
+        stale: !local && !online(),
+        offline: !online(),
+        lastSuccessAt: local ? void 0 : next.metadata.fetchedAt,
+        error: ""
+      };
+    } catch (error) {
+      if (!current()) return;
+      if (options.clearOnError?.(error)) {
+        data = void 0;
+        metadata = void 0;
+        status = initialReadStatus();
+      }
+      const retained = status.hasSnapshot && !status.hasLocalContent;
+      status = {
+        ...status,
+        refreshing: false,
+        stale: retained,
+        offline: !online(),
+        error: retained ? "Couldn\u2019t refresh. Content may be outdated." : status.hasSnapshot ? "Couldn\u2019t refresh. Try again." : options.errorMessage?.(error) || "This content could not load. Try again."
+      };
+    }
+    emit();
+  };
+  const load = (nextKey) => {
+    if (disposed) return Promise.resolve();
+    if (nextKey === key && pending) return pending;
+    if (nextKey !== key) {
+      key = nextKey;
+      data = void 0;
+      metadata = void 0;
+      status = initialReadStatus();
+    }
+    const revision = ++generation;
+    const task = run(revision, key).finally(() => {
+      if (generation === revision) pending = void 0;
+    });
+    pending = task;
+    return task;
+  };
+  const controller = {
+    load,
+    refresh: () => load(key),
+    getStatus: () => ({ ...status }),
+    /** Revision for adapters that coalesce the read and their final state projection. */
+    getRevision: () => generation,
+    connectivityChanged(connected) {
+      if (!connected) {
+        generation++;
+        pending = void 0;
+        if (metadata?.source !== "local" && (!metadata?.cacheable || metadata.expiresAt === void 0 || metadata.expiresAt <= now())) {
+          data = void 0;
+          metadata = void 0;
+          status = initialReadStatus();
+        }
+      }
+      status = {
+        ...status,
+        offline: !connected,
+        refreshing: connected && status.refreshing,
+        stale: status.hasSnapshot && (status.stale || !connected && metadata?.source !== "local")
+      };
+      emit();
+      if (!connected && !status.hasSnapshot && key && options.cached) void load(key);
+    },
+    replace(snapshot, nextKey) {
+      generation++;
+      pending = void 0;
+      if (nextKey !== void 0) key = nextKey;
+      data = snapshot.data;
+      metadata = snapshot.metadata;
+      status = {
+        hasSnapshot: true,
+        fromCache: snapshot.metadata.source === "cache",
+        refreshing: false,
+        stale: snapshot.metadata.source === "cache" || !online(),
+        offline: !online(),
+        lastSuccessAt: snapshot.metadata.fetchedAt,
+        error: ""
+      };
+      emit();
+    },
+    invalidate() {
+      generation++;
+      pending = void 0;
+      data = void 0;
+      metadata = void 0;
+      status = initialReadStatus();
+      emit();
+    },
+    dispose() {
+      disposed = true;
+      generation++;
+      pending = void 0;
+      if (expiryTimer !== void 0 && typeof globalThis.clearTimeout === "function") globalThis.clearTimeout(expiryTimer);
+      unsubscribe?.();
+    }
+  };
+  const host = globalThis.himalaya;
+  const unsubscribe = host?.__subscribeReadLifecycle?.((signal) => {
+    if (signal === "check") emit();
+    else if (signal === "invalidate") controller.invalidate();
+    else if (signal === "dispose") controller.dispose();
+    else controller.connectivityChanged(signal === "online");
+  });
+  return controller;
+}
+
 // ../../core/ts/src/validation.ts
 var EMAIL_RE = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,}$/;
 var URL_HOST_RE = /^[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*(:[0-9]+)?$/;
@@ -181,18 +382,6 @@ function validateAll(rules, values, catalog) {
   return errors;
 }
 
-// ../../core/sdk/state/src/connectivity.ts
-function connectivity() {
-  const host = globalThis.himalaya;
-  if (!host?.connectivity?.current) throw new Error("CONNECTIVITY_UNSUPPORTED: update the Himalaya runtime before installing this screen");
-  const current = host.connectivity.current();
-  if (typeof current?.online !== "boolean") throw new Error("CONNECTIVITY_UNSUPPORTED: this host cannot report connectivity");
-  return current;
-}
-function requireConnectivity() {
-  if (!connectivity().online) throw new Error("You\u2019re offline \u2014 this change can\u2019t be saved right now. Connect and try again.");
-}
-
 // ../../core/sdk/state/src/index.ts
 function withStream(state, directive) {
   return { ...state, _stream: directive };
@@ -243,6 +432,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);
 }
 var APP_SERVICE_CODES = /* @__PURE__ */ new Set([
@@ -364,8 +556,10 @@ export {
   app,
   classifyLoadError,
   connectivity,
+  createReadController,
   defineService,
   encodeSubtree,
+  initialReadStatus,
   isAppServiceError,
   isValid as isValidValue,
   navigate,

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-activity-counters.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 setActivityCounters(memberId, req = {}, opts) {
   if (!memberId) throw new Error("setActivityCounters: memberId is required");

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

@@ -16,12 +16,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-analytics.mjs

@@ -1,9 +1,19 @@
 // ../../stdlib/wix-sdk/analytics/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-analytics: host did not install the wixApi bridge"));
+    return Promise.reject(
+      new Error("@himalaya/wix-analytics: host did not install the wixApi bridge")
+    );
+  }
+  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 globalThis.himalaya.wixApi.call(method, path, body);
+  return readOptions?.site ? api.call(method, path, body, { "wix-site-id": readOptions.site }) : api.call(method, path, body);
 }
 var YMD = /^(\d{4})-(\d{2})-(\d{2})$/;
 function hasIntl() {
@@ -110,7 +120,7 @@ function localDateRange(days, ianaZone, today = /* @__PURE__ */ new Date()) {
     effectiveZone: effectiveZone(ianaZone)
   };
 }
-function getSiteAnalytics(opts) {
+function getSiteAnalytics(opts, options) {
   const { startDate, endDate, timeZone, today } = opts;
   const measurementTypes = opts.measurementTypes ?? ["TOTAL_SESSIONS", "TOTAL_SALES", "TOTAL_ORDERS"];
   const earliest = earliestAvailableDate(today ?? /* @__PURE__ */ new Date(), timeZone);
@@ -123,13 +133,17 @@ function getSiteAnalytics(opts) {
   ];
   return wixCall(
     "GET",
-    `/analytics/v2/site-analytics/data?${params.join("&")}`
+    `/analytics/v2/site-analytics/data?${params.join("&")}`,
+    void 0,
+    options
   );
 }
-function getSiteTimeZone() {
+function getSiteTimeZone(options) {
   return wixCall(
     "GET",
-    "/site-properties/v4/properties?fields.paths=timeZone"
+    "/site-properties/v4/properties?fields.paths=timeZone",
+    void 0,
+    options
   ).then((r) => r?.properties?.timeZone);
 }
 var SEMANTIC_BASE = "/analytics/semantic-model/v3/semantic-models";

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-async-jobs.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 getAsyncJob(jobId, opts) {
   if (!jobId) throw new Error("getAsyncJob: jobId is required");

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-automations.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-badges.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-billing-tax.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-blog.mjs

@@ -1,19 +1,22 @@
 // ../../stdlib/wix-sdk/blog-v3/src/extensions.ts
 var DRAFTS = "/blog/v3/draft-posts";
 var DEFAULT_FIELDSETS = ["INTERNAL_ID", "RICH_CONTENT", "URL"];
-function getDraftPost(postId) {
+function getDraftPost(postId, options) {
   const qs = DEFAULT_FIELDSETS.map((f) => `fieldsets=${f}`).join("&");
-  return wixCall("GET", `${DRAFTS}/${postId}?${qs}`);
+  return wixCall("GET", `${DRAFTS}/${postId}?${qs}`, void 0, options);
 }
 var POST_BODY_FIELDSETS = ["RICH_CONTENT", "CONTENT_TEXT"];
-function getPost(postId, req = {}) {
+function getPost(postId, req = {}, readOptions) {
   const fieldsets = req.fieldsets ?? POST_BODY_FIELDSETS;
   const query = fieldsets.length ? "?" + fieldsets.map((f) => `fieldsets=${encodeURIComponent(f)}`).join("&") : "";
   return wixCall(
     "GET",
-    `/blog/v3/posts/${encodeURIComponent(postId)}` + query
+    `/blog/v3/posts/${encodeURIComponent(postId)}` + query,
+    void 0,
+    readOptions
   ).catch(async (cause) => {
-    const resp = await queryPosts({ query: { filter: { id: postId } } });
+    if (readOptions?.cache || readOptions?.onCacheResult) throw cause;
+    const resp = await queryPosts({ query: { filter: { id: postId } } }, readOptions);
     const post = resp.posts?.[0];
     if (!post) {
       const err = new Error(`Blog post not found: ${postId}`);
@@ -25,8 +28,8 @@ function getPost(postId, req = {}) {
     return { post };
   });
 }
-function queryCategories(req = {}) {
-  return wixCall("POST", "/blog/v3/categories/query", { query: req });
+function queryCategories(req = {}, opts) {
+  return wixCall("POST", "/blog/v3/categories/query", { query: req }, opts);
 }
 function createDraftPost(draftPost) {
   return wixCall("POST", DRAFTS, { draftPost, fieldsets: DEFAULT_FIELDSETS });
@@ -55,8 +58,8 @@ function unlikePost(postId) {
   if (!postId) throw new Error("unlikePost: postId is required");
   return wixCall("POST", `/blog/v3/posts/${encodeURIComponent(postId)}/unlike`, {});
 }
-function queryDraftPosts(req = {}) {
-  return wixCall("POST", `${DRAFTS}/query`, req);
+function queryDraftPosts(req = {}, opts) {
+  return wixCall("POST", `${DRAFTS}/query`, req, opts);
 }
 function cancelScheduleDraftPost(postId) {
   return updateDraftPost(postId, {}, "UPDATE_CANCEL_SCHEDULE");
@@ -75,12 +78,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 queryPosts(req = {}, opts) {
   return wixCall(

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

@@ -15,8 +15,8 @@ async function searchServices(req = {}) {
   const res = await wixCall("POST", "/_api/bookings/v2/services/search", req);
   return { ...res, services: (res.services ?? []).map(decodeService) };
 }
-async function queryServices(req = {}) {
-  const res = await wixCall("POST", "/bookings/v2/services/query", req);
+async function queryServices(req = {}, readOptions) {
+  const res = await wixCall("POST", "/bookings/v2/services/query", req, readOptions);
   return { ...res, services: (res.services ?? []).map(decodeService) };
 }
 async function queryServiceCategories() {
@@ -26,7 +26,7 @@ async function queryServiceCategories() {
 async function getService(serviceId, options) {
   const path = `/bookings/v2/services/${serviceId}`;
   const conditionalFields = options?.conditionalFields ?? [];
-  const res = await wixCall("GET", conditionalFields.length ? wixQueryPath(path, { conditionalFields }) : path);
+  const res = await wixCall("GET", conditionalFields.length ? wixQueryPath(path, { conditionalFields }) : path, void 0, options);
   return { ...res, service: decodeService(res.service) };
 }
 function encodeServiceWrite(write, existing) {
@@ -153,12 +153,12 @@ function rescheduleBooking(bookingId, slot, revision, notify = false) {
     flowControlSettings: { ignoreReschedulePolicy: true, ignoreBookingWindow: true, skipAvailabilityValidation: true }
   });
 }
-function queryServiceAvailability(serviceId, startDate, endDate, options = {}) {
+function queryServiceAvailability(serviceId, startDate, endDate, options = {}, readOptions) {
   if (!serviceId) throw new Error("queryServiceAvailability: serviceId is required");
   const { bookable = true } = options ?? {};
   return wixCall("POST", "/bookings/v1/availability/query", {
     query: { filter: { serviceId: [serviceId], startDate, endDate, ...bookable ? { bookable: true } : {} } }
-  });
+  }, readOptions);
 }
 function queryResources(limit = 100) {
   return wixCall("POST", "/bookings/v1/resources/query", {
@@ -192,9 +192,9 @@ function bookSchedule(scheduleId, firstName, lastName, email, options) {
     }
   });
 }
-function getBookingFull(bookingId) {
+function getBookingFull(bookingId, options) {
   if (!bookingId) throw new Error("getBookingFull: bookingId is required");
-  return wixCall("GET", `/bookings/v1/bookings/${bookingId}`);
+  return wixCall("GET", `/bookings/v1/bookings/${bookingId}`, void 0, options);
 }
 function setBookingAttendance(bookingId, attended, numberOfAttendees = 1) {
   if (!bookingId) throw new Error("setBookingAttendance: bookingId is required");
@@ -217,12 +217,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 = [];