@wix/himalaya-cli 0.1544.0 → 0.1546.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/loyalty/src/index.d.ts

@@ -2,10 +2,34 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
-export declare function wixCall<T>(method: string, path: string, body?: unknown): Promise<T>;
+export interface WixCallOptions {
+    site?: string;
+    /** Explicit cache reads never touch the network; reload waits for a server response. */
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?: (metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }) => void;
+}
+/** The per-call header map for `opts`, or undefined when there is nothing to add — so
+ *  the no-options path calls the bridge with exactly the 3 arguments it always did. */
+export declare function wixCall<T>(method: string, path: string, body?: unknown, readOptions?: WixCallOptions): Promise<T>;
 export interface WixLoyaltyProgram {
     id?: string;
     name?: string;
@@ -33,17 +57,17 @@ export interface WixLoyaltyTier {
     requiredPoints?: number;
 }
 /** GET /loyalty/v1/program → { loyaltyProgram }. */
-export declare function getLoyaltyProgram(): Promise<{
+export declare function getLoyaltyProgram(readOptions?: WixCallOptions): Promise<{
     loyaltyProgram?: WixLoyaltyProgram;
     program?: WixLoyaltyProgram;
 }>;
 /** GET /loyalty/v1/rewards → { rewards }. */
-export declare function listLoyaltyRewards(): Promise<{
+export declare function listLoyaltyRewards(readOptions?: WixCallOptions): Promise<{
     rewards?: WixLoyaltyReward[];
 }>;
 /** GET /loyalty/v1/tiers → { tiers }. The PUBLIC program tier ladder
  * (wix.loyalty.v1.tier) — NOT the private per-customer tiers-program dashboard. */
-export declare function listLoyaltyTiers(): Promise<{
+export declare function listLoyaltyTiers(readOptions?: WixCallOptions): Promise<{
     tiers?: WixLoyaltyTier[];
 }>;
 export * from "./extensions.js";

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/marketing-v1/src/index.d.ts

@@ -2,6 +2,17 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
@@ -14,6 +25,14 @@ declare global {
  *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */
 export interface WixCallOptions {
     site?: string;
+    /** Explicit cache reads never touch the network; reload waits for a server response. */
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?: (metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }) => void;
 }
 export declare function wixCall<T>(method: string, path: string, body?: unknown, opts?: WixCallOptions): Promise<T>;
 /** `path` with `req` appended as the query string Wix's RPC gateway reads a GET or

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/members-feed-viewer/src/index.d.ts

@@ -2,9 +2,31 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
+export interface WixCallOptions {
+    site?: string;
+    /** Explicit cache reads never touch the network; reload waits for a server response. */
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?: (metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }) => void;
+}
 /** A deeplink/action target. The notification may carry an in-app route
  *  (mobileData.data) and/or a web URL (webUrlData.webUrl). */
 export interface MfvLink {
@@ -43,7 +65,7 @@ export interface MfvNotification {
 /** Reset the learned route. Tests only — there is no runtime caller. */
 export declare function __resetMfvRouteForTests(): void;
 /** List the signed-in member's notifications, newest first. MOBILE channel. */
-export declare function queryNotifications(limit?: number): Promise<MfvNotification[]>;
+export declare function queryNotifications(limit?: number, options?: WixCallOptions): Promise<MfvNotification[]>;
 /** Mark the given notification ids as READ (bulk, by-filter). */
 export declare function markRead(ids: string[]): Promise<void>;
 /** Mark ALL of the member's MOBILE notifications that aren't already READ as READ. */

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/members-v1/src/index.d.ts

@@ -2,9 +2,31 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
+export interface WixCallOptions {
+    site?: string;
+    /** Explicit cache reads never touch the network; reload waits for a server response. */
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?: (metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }) => void;
+}
 export interface WixPaging {
     limit?: number;
     offset?: number;
@@ -99,9 +121,9 @@ export interface WixListCurrentMemberBlockingResponse {
 }
 /** List site members — POST /members/v1/members/query. Pass `{ query: { paging: { limit, offset? } } }`
  *  (offset paging). Do not pass `cursorPaging` — that is a different Wix envelope and is not on this type. */
-export declare function queryMembers(req?: WixQueryMembersRequest): Promise<WixQueryMembersResponse>;
+export declare function queryMembers(req?: WixQueryMembersRequest, readOptions?: WixCallOptions): Promise<WixQueryMembersResponse>;
 /** Fetch a single member by id — GET /members/v1/members/{id}?fieldsets=FULL. */
-export declare function getMember(id: string): Promise<WixGetMemberResponse>;
+export declare function getMember(id: string, options?: WixCallOptions): Promise<WixGetMemberResponse>;
 /** Fetch the currently authenticated member — member-scoped, unlike the owner roster query.
  * @scope member — requires the signed-in site-member identity; an anonymous visitor cannot read this record.
  */
@@ -178,7 +200,7 @@ export interface WixMyConnectionsResponse {
 /** Followers / following totals for a member — POST
  *  /members/v1/activity-counters/query. Parses the Followers-app counter entry;
  *  defaults each total to 0 when absent. May 403 → caller should default. */
-export declare function getFollowCounts(memberId: string): Promise<WixFollowCounts>;
+export declare function getFollowCounts(memberId: string, options?: WixCallOptions): Promise<WixFollowCounts>;
 /** Whether the signed-in member follows `targetId` — POST
  *  /members/v3/followers/my/connections. Returns false on any miss. May 403 →
  *  caller should default to false. */

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/new-releases/src/index.d.ts

@@ -2,9 +2,31 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
+export interface WixCallOptions {
+    site?: string;
+    /** Explicit cache reads never touch the network; reload waits for a server response. */
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?: (metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }) => void;
+}
 export interface WixAnnouncementAsset {
     type?: string;
     url?: string;
@@ -26,4 +48,4 @@ export interface WixAnnouncementsResponse {
     announcements: WixAnnouncement[];
     total?: number;
 }
-export declare function listAnnouncements(limit?: number): Promise<WixAnnouncementsResponse>;
+export declare function listAnnouncements(limit?: number, options?: WixCallOptions): Promise<WixAnnouncementsResponse>;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/notification-preferences/src/index.d.ts

@@ -2,9 +2,30 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
+/** Explicit read policy; business response payloads remain unchanged. */
+export interface WixCallOptions {
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?(metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }): void;
+}
 /**
  * The service's own mount, from the published swagger `host`
  * ("www.wixapis.com/notification-preferences") — the PATH half of it.
@@ -104,7 +125,7 @@ export declare function deliveredByTopic(prefs: readonly PreferenceInfo[], chann
 /** List the site's notification topics — `GET /v1/preferences/topics`
  *  (GetNotificationTopicsDefinitions). Publicly mounted.
  *  verify-live: source contract checked; live caller authorization remains untested. */
-export declare function getNotificationTopics(): Promise<GetNotificationTopicsResponse>;
+export declare function getNotificationTopics(options?: WixCallOptions): Promise<GetNotificationTopicsResponse>;
 /**
  * The PUBLICLY mounted preferences read — `GET /v1/preferences`
  * (GetPreferencesByRecipient). It needs the recipient explicitly: `CONTACT` + a
@@ -124,7 +145,7 @@ export declare function getPreferencesForRecipient(recipient: {
  *  (GetPreferencesByImplicitRecipient). NOT in the published public swagger; a 404 from
  *  the public gateway is the expected outcome there, not a bug in this call.
  *  verify-live: the implicit-recipient mount has not been verified for member callers. */
-export declare function getMyNotificationPreferences(): Promise<GetMyNotificationPreferencesResponse>;
+export declare function getMyNotificationPreferences(options?: WixCallOptions): Promise<GetMyNotificationPreferencesResponse>;
 /** Upsert some of the signed-in recipient's preferences —
  *  `POST /v1/preferences-by-implicit-recipient` (UpsertPreferencesByImplicitRecipient),
  *  body `{ preferencesInfo }`. Pass only the rows that changed.

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/notifications-v3/src/index.d.ts

@@ -2,6 +2,17 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
@@ -14,6 +25,14 @@ declare global {
  *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */
 export interface WixCallOptions {
     site?: string;
+    /** Explicit cache reads never touch the network; reload waits for a server response. */
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?: (metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }) => void;
 }
 export declare function wixCall<T>(method: string, path: string, body?: unknown, opts?: WixCallOptions): Promise<T>;
 export interface WixNotification {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/online-programs/src/index.d.ts

@@ -2,9 +2,31 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
+export interface WixCallOptions {
+    site?: string;
+    /** Explicit cache reads never touch the network; reload waits for a server response. */
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?: (metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }) => void;
+}
 /**
  * v3's rich `description` block — the SAME shape on the list and the detail response
  * (see the recorded pair in core/web-renderer/tests/fixtures/branded-lite/wix-responses.json).
@@ -70,7 +92,7 @@ export interface WixQueryProgramsResponse {
     };
 }
 /** POST /online-programs/v3/programs/query — list programs (cursor-paged). */
-export declare function queryPrograms(query: WixProgramQuery): Promise<WixQueryProgramsResponse>;
+export declare function queryPrograms(query: WixProgramQuery, readOptions?: WixCallOptions): Promise<WixQueryProgramsResponse>;
 export interface WixProgramFull extends WixProgram {
     revision?: number;
     status?: string;
@@ -100,7 +122,7 @@ export interface WixGetProgramResponse {
     program?: WixProgramFull;
 }
 /** GET /online-programs/v3/programs/{id} — single program (management view). */
-export declare function getProgram(id: string): Promise<WixGetProgramResponse>;
+export declare function getProgram(id: string, readOptions?: WixCallOptions): Promise<WixGetProgramResponse>;
 export interface WixParticipant {
     id: string;
     revision?: string;
@@ -140,7 +162,7 @@ export interface WixQueryParticipantsResponse {
 export declare function queryParticipants(programId: string, opts?: {
     progressStatus?: string;
     limit?: number;
-}): Promise<WixQueryParticipantsResponse>;
+}, readOptions?: WixCallOptions): Promise<WixQueryParticipantsResponse>;
 /** Participant lifecycle state. */
 export type WixParticipantState = "JOINED" | "PAYMENT_PENDING" | "APPROVAL_PENDING" | "COMPLETED" | "INVITED" | "REMOVED" | string;
 export interface WixParticipantPaymentPending {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/portfolio/src/index.d.ts

@@ -2,9 +2,31 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
+export interface WixCallOptions {
+    site?: string;
+    /** Explicit cache reads never touch the network; reload waits for a server response. */
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?: (metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }) => void;
+}
 /** A Wix Portfolio media image — a project / collection cover or a project item's image. */
 export interface WixMediaImage {
     type?: string;
@@ -51,7 +73,7 @@ export interface WixListProjectsResponse {
     };
 }
 /** GET /portfolio/v1/projects — list projects (paged). */
-export declare function listProjects(limit?: number, cursor?: string): Promise<WixListProjectsResponse>;
+export declare function listProjects(limit?: number, cursor?: string, readOptions?: WixCallOptions): Promise<WixListProjectsResponse>;
 export interface WixPortfolioCollection {
     id: string;
     title?: string;
@@ -73,7 +95,7 @@ export interface WixListCollectionsResponse {
     };
 }
 /** GET /portfolio/v1/collections — list collections (paged). */
-export declare function listCollections(limit?: number, cursor?: string): Promise<WixListCollectionsResponse>;
+export declare function listCollections(limit?: number, cursor?: string, readOptions?: WixCallOptions): Promise<WixListCollectionsResponse>;
 export interface WixPortfolioProjectItem {
     id: string;
     projectId?: string;
@@ -118,4 +140,4 @@ export interface WixListProjectItemsResponse {
  * because a Wix query cursor already carries it. Items come back in the order Wix returns
  * them — sort on `sortOrder` for the author's order.
  */
-export declare function listProjectItems(projectId: string, limit?: number, cursor?: string): Promise<WixListProjectItemsResponse>;
+export declare function listProjectItems(projectId: string, limit?: number, cursor?: string, readOptions?: WixCallOptions): Promise<WixListProjectItemsResponse>;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/pricing-plans/src/index.d.ts

@@ -2,9 +2,31 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
+export interface WixCallOptions {
+    site?: string;
+    /** Explicit cache reads never touch the network; reload waits for a server response. */
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?: (metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }) => void;
+}
 export interface WixMoney {
     /** Decimal string, e.g. "15", "0". */
     value?: string;
@@ -62,7 +84,7 @@ export interface WixListPlansResponse {
 }
 /** List pricing plans — GET /pricing-plans/v2/plans. The list screen's data
  * source. Returns public + hidden plans (archived excluded by default). */
-export declare function listPlans(): Promise<WixListPlansResponse>;
+export declare function listPlans(readOptions?: WixCallOptions): Promise<WixListPlansResponse>;
 export interface WixListPublicPlansResponse {
     plans?: WixPlan[];
     pagingMetadata?: WixPlansPagingMetadata;
@@ -73,12 +95,12 @@ export interface WixListPublicPlansResponse {
  * management identity. Export name mirrors the generated pricing-plans-v2
  * client (stdlib/wix-sdk/pricing-plans-v2) — the canonical importable name
  * stays unversioned per RFC 0043 D2. */
-export declare function listPublicPlans(): Promise<WixListPublicPlansResponse>;
+export declare function listPublicPlans(readOptions?: WixCallOptions): Promise<WixListPublicPlansResponse>;
 export interface WixGetPlanResponse {
     plan: WixPlan;
 }
 /** Fetch a single plan by id — GET /pricing-plans/v2/plans/{id}. Detail source. */
-export declare function getPlan(planId: string): Promise<WixGetPlanResponse>;
+export declare function getPlan(planId: string, readOptions?: WixCallOptions): Promise<WixGetPlanResponse>;
 export interface WixArchivePlanResponse {
     plan?: WixPlan;
 }
@@ -145,7 +167,7 @@ export interface WixListPlanOrdersResponse {
  * entitlement question every gated app asks — call `listMyPlanOrders()`. Using
  * this one there silently fails closed: the 403 reads as "no orders", so a
  * PAYING member is locked out of what they bought, and no error surfaces. */
-export declare function listPlanOrders(): Promise<WixListPlanOrdersResponse>;
+export declare function listPlanOrders(readOptions?: WixCallOptions): Promise<WixListPlanOrdersResponse>;
 export interface ListMyPlanOrdersOptions {
     /** Server-side status filter. Ask for `["ACTIVE"]` when the question is
      *  entitlement — see why below. */
@@ -176,12 +198,12 @@ export interface ListMyPlanOrdersOptions {
  * (`statuses` is a real proto field, not a tolerated unknown: an invalid value
  * is rejected with 400 rather than ignored, so a typo fails loudly here instead
  * of quietly widening the gate.) */
-export declare function listMyPlanOrders(opts?: ListMyPlanOrdersOptions): Promise<WixListPlanOrdersResponse>;
+export declare function listMyPlanOrders(opts?: ListMyPlanOrdersOptions, readOptions?: WixCallOptions): Promise<WixListPlanOrdersResponse>;
 export interface WixGetPlanOrderResponse {
     order: WixPlanOrder;
 }
 /** Fetch a single plan order — GET /pricing-plans/v2/orders/{id}. Detail source. */
-export declare function getPlanOrder(orderId: string): Promise<WixGetPlanOrderResponse>;
+export declare function getPlanOrder(orderId: string, readOptions?: WixCallOptions): Promise<WixGetPlanOrderResponse>;
 export interface WixCancelPlanOrderResponse {
 }
 /** Cancel a subscription (plan order) — POST /pricing-plans/v2/orders/{id}/cancel.

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/redirects-v1/src/index.d.ts

@@ -2,6 +2,17 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
@@ -14,6 +25,14 @@ declare global {
  *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */
 export interface WixCallOptions {
     site?: string;
+    /** Explicit cache reads never touch the network; reload waits for a server response. */
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?: (metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }) => void;
 }
 export declare function wixCall<T>(method: string, path: string, body?: unknown, opts?: WixCallOptions): Promise<T>;
 export interface WixRedirectSession {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/restaurants/src/extensions.d.ts

@@ -1,4 +1,4 @@
-import { type WixMetadata, type WixPaging } from "./index.js";
+import { type WixCallOptions, type WixMetadata, type WixPaging } from "./index.js";
 export interface WixSection {
     id: string;
     name?: string;
@@ -19,7 +19,7 @@ export interface WixQuerySectionsResponse {
 }
 /** POST /restaurants/menus/v1/sections/query — menu sections (perm
  *  RESTAURANTS.SECTION_READ; visitor-readable on sites with the Menus app). */
-export declare function querySections(req?: WixSectionQueryRequest): Promise<WixQuerySectionsResponse>;
+export declare function querySections(req?: WixSectionQueryRequest, opts?: WixCallOptions): Promise<WixQuerySectionsResponse>;
 /** An address as the Restaurants services return it. `subdivision` is ISO 3166-2 (`US-CA`). */
 export interface WixRestaurantsAddress {
     country?: string;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/restaurants/src/index.d.ts

@@ -2,6 +2,17 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
@@ -14,6 +25,14 @@ declare global {
  *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */
 export interface WixCallOptions {
     site?: string;
+    /** Explicit cache reads never touch the network; reload waits for a server response. */
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?: (metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }) => void;
 }
 export declare function wixCall<T>(method: string, path: string, body?: unknown, opts?: WixCallOptions): Promise<T>;
 export interface WixPaging {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/reviews/src/index.d.ts

@@ -2,9 +2,31 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
+export interface WixCallOptions {
+    site?: string;
+    /** Explicit cache reads never touch the network; reload waits for a server response. */
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?: (metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }) => void;
+}
 /** moderationStatus: APPROVED | IN_MODERATION | REJECTED | SUBMITTED (UNKNOWN). */
 export type ReviewModerationStatus = "APPROVED" | "IN_MODERATION" | "REJECTED" | "SUBMITTED" | "UNKNOWN";
 export interface WixReviewImage {
@@ -79,10 +101,10 @@ export interface WixQueryReviewsResponse {
 }
 /** POST /reviews/v1/reviews/query — list reviews (cursor-paged WQL).
  * Pass returnPrivateReviews:true to include unpublished (pending/rejected) reviews. */
-export declare function queryReviews(query: WixReviewQuery, returnPrivateReviews?: boolean): Promise<WixQueryReviewsResponse>;
+export declare function queryReviews(query: WixReviewQuery, returnPrivateReviews?: boolean, readOptions?: WixCallOptions): Promise<WixQueryReviewsResponse>;
 /** GET /reviews/v1/reviews/{id} — single review.
  * returnPrivateReviews=true is required to read a pending/rejected review. */
-export declare function getReview(id: string, returnPrivateReviews?: boolean): Promise<{
+export declare function getReview(id: string, returnPrivateReviews?: boolean, readOptions?: WixCallOptions): Promise<{
     review?: WixReview;
 }>;
 /** POST /reviews/v1/reviews/count — counts (optionally filtered). */

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/seo-v1/src/index.d.ts

@@ -2,6 +2,17 @@ declare global {
     var himalaya: {
         wixApi?: {
             call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+            read?: (method: string, path: string, body: unknown, headers: Record<string, string> | undefined, options: {
+                cache: string;
+            }) => Promise<{
+                data: unknown;
+                cache: {
+                    source: "cache" | "network";
+                    fetchedAt: number;
+                    expiresAt?: number;
+                    cacheable: boolean;
+                };
+            }>;
         };
     };
 }
@@ -14,6 +25,14 @@ declare global {
  *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */
 export interface WixCallOptions {
     site?: string;
+    /** Explicit cache reads never touch the network; reload waits for a server response. */
+    cache?: "default" | "only-if-cached" | "reload";
+    onCacheResult?: (metadata: {
+        source: "cache" | "network";
+        fetchedAt: number;
+        expiresAt?: number;
+        cacheable: boolean;
+    }) => void;
 }
 export declare function wixCall<T>(method: string, path: string, body?: unknown, opts?: WixCallOptions): Promise<T>;
 /** `path` with `req` appended as the query string Wix's RPC gateway reads a GET or