@wix/himalaya-cli 0.1543.0 → 0.1545.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/contacts/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/coupons/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;
@@ -92,9 +114,9 @@ export interface WixDeleteCouponResponse {
 }
 /** Query coupons — POST /stores/v2/coupons/query. The request is wrapped as
  * `{ query }` (Wix QueryV2 convention). */
-export declare function queryCoupons(req?: WixCouponsQueryRequest): Promise<WixQueryCouponsResponse>;
+export declare function queryCoupons(req?: WixCouponsQueryRequest, readOptions?: WixCallOptions): Promise<WixQueryCouponsResponse>;
 /** Get a single coupon — GET /stores/v2/coupons/{id}. */
-export declare function getCoupon(id: string): Promise<WixGetCouponResponse>;
+export declare function getCoupon(id: string, options?: WixCallOptions): Promise<WixGetCouponResponse>;
 /** Create a coupon — POST /stores/v2/coupons. The editable fields are wrapped
  * as `{ specification }`; `code` + a discount behavior (e.g. percentOffRate) are
  * required. Returns the new coupon id. */

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/crm-tasks/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;
+                };
+            }>;
         };
     };
 }

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/dashboard-setup/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;
+                };
+            }>;
         };
     };
 }

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/data-collections-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/donations/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 WixDonationCampaign {

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

@@ -1,9 +1,10 @@
+import type { WixCallOptions } from "./index.js";
 import type { WixOrder } from "./index.js";
 export interface WixGetOrderResponse {
     order: WixOrder;
 }
 /** Fetch a single order by id — the detail screen's data source. */
-export declare function getOrder(orderId: string): Promise<WixGetOrderResponse>;
+export declare function getOrder(orderId: string, options?: WixCallOptions): Promise<WixGetOrderResponse>;
 /** Archive an order — POST /ecom/v1/orders/{id}/archive → { order }. Verified
  *  live (2026-06-06). Reversible via .../unarchive. Used by the order detail's
  *  Archive action AND the orders list's row-swipe Archive (#43). */
@@ -116,7 +117,7 @@ export declare function isOrdersForbiddenError(error: unknown): boolean;
  *  sum `(cart.lineItems ?? [])` and the cart screen additionally takes
  *  `cart.subtotal?.formattedAmount ?? ""` and `(await getCurrentCart()).id || ""` —
  *  all three degrade to empty/0 on an absent field, so no caller special-cases it. */
-export declare function getCurrentCart(): Promise<WixCartDetail>;
+export declare function getCurrentCart(opts?: WixCallOptions): Promise<WixCartDetail>;
 /** Add a coupon to the visitor/member's current cart — POST
  *  /ecom/v2/carts/current/add-coupon. Wix validates it against the current cart.
  *  @scope visitor — uses the active shopper's cart; Wix rejects an invalid coupon. */
@@ -319,10 +320,10 @@ export interface WixCreateMemberAddressResponse {
  *  in the patch; `""` is, and clears that field. */
 export declare function memberAddressFieldMask(patch: WixMemberAddress): string;
 /** The signed-in member's saved addresses + which one is the default. */
-export declare function listMemberAddresses(): Promise<WixListMemberAddressesResponse>;
+export declare function listMemberAddresses(options?: WixCallOptions): Promise<WixListMemberAddressesResponse>;
 /** One saved address by id, and whether it is the member's default. An unknown id
  *  rejects with 404 `cant_find_address_by_id`. */
-export declare function getMemberAddress(addressId: string): Promise<WixGetMemberAddressResponse>;
+export declare function getMemberAddress(addressId: string, options?: WixCallOptions): Promise<WixGetMemberAddressResponse>;
 /** The member's default address — `{}` when they have none. */
 export declare function getDefaultMemberAddress(): Promise<WixGetDefaultMemberAddressResponse>;
 /** Save a new address → its id. The member's first address becomes the default
@@ -379,7 +380,7 @@ export interface WixListSavedPaymentMethodsResponse {
 export declare function listMySavedPaymentMethods(opts?: {
     cursor?: string;
     limit?: number;
-}): Promise<WixListSavedPaymentMethodsResponse>;
+}, options?: WixCallOptions): Promise<WixListSavedPaymentMethodsResponse>;
 /** Remove a saved payment method. Wix makes another one primary when this one was. */
 export declare function deleteSavedPaymentMethod(savedPaymentMethodId: string): Promise<Record<string, never>>;
 /** Make a saved payment method the member's primary one. The service declares this

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/ecom/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: `searchOrders(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 WixEcomCursorPaging {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/email-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/events/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 WixEventImage {
     id?: string;
     url?: string;
@@ -133,7 +155,7 @@ export declare function decodeEvent(raw: WixEvent): WixEvent;
  *  **Visitor-readable**: works with a visitor/consumer token (`WixConsumerAuthProvider`),
  *  not just an owner session. (NOT the owner-only GET /events-in-clubs/chunked-events,
  *  which returns an HTML error page for a visitor token.) */
-export declare function queryEvents(opts?: WixQueryEventsOptions): Promise<WixGetEventListResponse>;
+export declare function queryEvents(opts?: WixQueryEventsOptions, readOptions?: WixCallOptions): Promise<WixGetEventListResponse>;
 /** Events v3 response fieldsets (`RequestedFields`). A bare read returns the base fieldset;
  *  each value adds fields: `DETAILS` → `shortDescription`, `mainImage`, `calendarUrls`;
  *  `TEXTS` → the Ricos `description`; `REGISTRATION` → `registration`; `URLS` → `eventPageUrl`;
@@ -154,7 +176,7 @@ export interface WixEventRichContent {
  *  `opts.fields` requests extra v3 fieldsets; `["TEXTS"]` returns `description`. */
 export declare function getEvent(eventId: string, opts?: {
     fields?: WixEventFieldset[];
-}): Promise<WixGetEventResponse>;
+}, readOptions?: WixCallOptions): Promise<WixGetEventResponse>;
 /** Delete an event — DELETE /events/v3/events/{eventId}. */
 export declare function deleteEvent(eventId: string): Promise<WixDeleteEventResponse>;
 /** Write shape for create/update (Events v3). Verified-minimal: a create needs

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/faq-v2/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/forms/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/forum/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 WixForumPaging {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/genie-chat/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;
+                };
+            }>;
         };
     };
 }

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/gift-cards/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/groups/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/inbox/src/extensions.d.ts

@@ -1,3 +1,4 @@
+import { type WixCallOptions } from "./index.js";
 import type { WixConversation, WixPaging, WixMetadata } from "./index.js";
 declare module "./index" {
     interface WixConversation {
@@ -19,4 +20,4 @@ export interface WixListConversationsResponse {
  *  for sites with no conversations / no Inbox app provisioned. */
 export declare function listConversations(req?: {
     paging?: WixPaging;
-}): Promise<WixListConversationsResponse>;
+}, opts?: WixCallOptions): Promise<WixListConversationsResponse>;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/inbox/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/invoices/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 WixInvoiceContactDetails {
     firstName?: string;
     lastName?: string;
@@ -74,12 +96,12 @@ export interface WixQueryInvoicesResponse {
     pagingMetadata?: WixInvoicesPagingMetadata;
 }
 /** List/query invoices — POST /invoices/v4/invoices/query. The list screen's source. */
-export declare function queryInvoices(req?: WixQueryInvoicesRequest): Promise<WixQueryInvoicesResponse>;
+export declare function queryInvoices(req?: WixQueryInvoicesRequest, readOptions?: WixCallOptions): Promise<WixQueryInvoicesResponse>;
 export interface WixGetInvoiceResponse {
     invoice: WixInvoice;
 }
 /** Fetch a single invoice by id — GET /invoices/v4/invoices/{id}. Detail source. */
-export declare function getInvoice(invoiceId: string): Promise<WixGetInvoiceResponse>;
+export declare function getInvoice(invoiceId: string, options?: WixCallOptions): Promise<WixGetInvoiceResponse>;
 export interface WixPublishInvoiceResponse {
     invoice?: WixInvoice;
 }