@wix/himalaya-cli 0.1543.0 → 0.1545.0

package/guides/sdk-reference.json

@@ -4,11 +4,23 @@
     "source": "core/sdk/state/src/index.ts",
     "description": "Tier-5 logic-bundle state surface.",
     "api": [
+      {
+        "name": "'./read.js'",
+        "kind": "reexport",
+        "jsdoc": "",
+        "decl": "export { createReadController, initialReadStatus } from './read.js';"
+      },
+      {
+        "name": "'./read.js'",
+        "kind": "reexport",
+        "jsdoc": "",
+        "decl": "export type { ReadMetadata, ReadStatus, ReadSnapshot } from './read.js';"
+      },
       {
         "name": "ServiceDefinition",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface ServiceDefinition<S> {\n  /** Initial state for the service. Must be JSON-serializable. */\n  state: S;\n\n  /**\n   * Actions: pure functions of `(state, ...args) → newState` (or async). The\n   * platform wraps each action so calling it from JS or from `__invokeAction`\n   * (native side) updates the service's state and notifies subscribers.\n   */\n  actions?: Record<\n    string,\n    // `never[]`, not `unknown[]` — same reason as defineService's constraint below:\n    // parameters are contravariant, so `unknown[]` rejects every handler that narrows\n    // its payload. Leaving this one loose would reintroduce the same TS2344 for anyone\n    // who annotates a `ServiceDefinition<S>` explicitly instead of inferring it.\n    (state: S, ...args: never[]) => S | undefined | Promise<S | undefined>\n  >;\n\n  /**\n   * Keys a cold boot takes from `state`, never from the persisted snapshot (cold-boot\n   * hydration). For UI state that must describe THIS run — an editor's one-shot seed, a\n   * \"still loading\" gate, an open sheet — where last run's value would be wrong, not just stale.\n   * Runtimes that honour it set `himalaya.hydrationOptOut`; an older one ignores the option.\n   */\n  notHydrated?: readonly (keyof S & string)[];\n\n  /**\n   * Keys that start each VISIT from `state`: when a cached embed shows the screen again (its warm worker\n   * reclaimed), these go back to their declared values before the screen reloads. For the same kind of\n   * per-run UI state as `notHydrated` (an editor's one-shot seed, an open sheet); never data a returning\n   * screen should keep showing. A cold boot never restores them either. A full app's own screens and an\n   * uncached embed ignore the reset.\n   */\n  perVisit?: readonly (keyof S & string)[];\n}"
+        "decl": "export interface ServiceDefinition<S> {\n  /** Initial state for the service. Must be JSON-serializable. */\n  state: S;\n\n  /**\n   * Actions: pure functions of `(state, ...args) → newState` (or async). The\n   * platform wraps each action so calling it from JS or from `__invokeAction`\n   * (native side) updates the service's state and notifies subscribers.\n   */\n  actions?: Record<\n    string,\n    // `never[]`, not `unknown[]` — same reason as defineService's constraint below:\n    // parameters are contravariant, so `unknown[]` rejects every handler that narrows\n    // its payload. Leaving this one loose would reintroduce the same TS2344 for anyone\n    // who annotates a `ServiceDefinition<S>` explicitly instead of inferring it.\n    (state: S, ...args: never[]) => S | undefined | Promise<S | undefined>\n  >;\n\n  /**\n   * Keys a cold boot takes from `state`, never from the persisted snapshot (cold-boot\n   * hydration). For UI state that must describe THIS run — an editor's one-shot seed, a\n   * \"still loading\" gate, an open sheet — where last run's value would be wrong, not just stale.\n   * Runtimes that honour it set `himalaya.hydrationOptOut`; an older one ignores the option.\n   */\n  notHydrated?: readonly (keyof S & string)[];\n\n  /** Applies a presentation decorator after a retained read snapshot is committed. */\n  readPresentation?: (state: any) => any;\n  /** Explicitly safe read action, invoked on reconnect while this screen is visible.\n   * statusPath addresses a ReadStatus in this service (e.g. \"readStatus\"). */\n  readLifecycle?: { refreshAction: string; statusPath: string };\n\n  /** Data governed by a separate cache policy must not also enter the generic\n   * worker snapshot. These keys are neither persisted nor hydrated by a runtime with\n   * `himalaya.readLifecycleVersion >= 1`; an older runtime ignores the option. */\n  notPersisted?: readonly (keyof S & string)[];\n  /**\n   * Keys that start each VISIT from `state`: when a cached embed shows the screen again (its warm worker\n   * reclaimed), these go back to their declared values before the screen reloads. For the same kind of\n   * per-run UI state as `notHydrated` (an editor's one-shot seed, an open sheet); never data a returning\n   * screen should keep showing. A cold boot never restores them either. A full app's own screens and an\n   * uncached embed ignore the reset.\n   */\n  perVisit?: readonly (keyof S & string)[];\n}"
       },
       {
         "name": "ServiceExports",
@@ -152,7 +164,7 @@
       {
         "name": "serializeForAgent",
         "kind": "function",
-        "jsdoc": "/**\n * Hint the platform that worker state is at a meaningful boundary worth\n * writing to disk. Optionally supply a `snapshot` — an opaque JSON-friendly\n * value the platform can include alongside the auto-generated state dump.\n *\n * Returns immediately; the actual write is async and platform-managed.\n */",
+        "jsdoc": "/**\n * Hint the platform that worker state is at a meaningful boundary worth\n * writing to disk. Optionally supply a JSON-friendly map from registered service\n * names to their next state, for a flush before an action commits that state.\n * Omit it to flush current state. Unknown services, read-lifecycle services,\n * transient fields and fields declared `notPersisted` are excluded. Keep authored\n * metadata inside its service state; arbitrary top-level metadata is not persisted.\n *\n * Returns immediately; the actual write is async and platform-managed.\n */",
         "decl": "export function serializeForAgent(snapshot?: unknown): void;"
       }
     ]
@@ -5378,7 +5390,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -5623,7 +5635,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -5726,6 +5738,12 @@
     "source": "stdlib/wix-sdk/analytics/src/index.ts",
     "description": "Site analytics totals",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "/**\n * Every path below is RELATIVE, starting with `/`. That is the wixApi bridge's\n * contract — \"paths are relative to https://www.wixapis.com\" — and what the other\n * 27 call sites across `@himalaya/wix-*` do.\n *\n * This domain used to spell its three paths as absolute `https://www.wixapis.com/…`\n * URLs. Native tolerates that (its request policy allows any `wixapis.com` host),\n * so it worked everywhere anyone looked. The web preview does not: its bridge\n * is host-locked to the gateway and refuses an absolute URL outright, and\n * `*.wixapis.com` deliberately does NOT get the owner-host exemption — the gateway\n * is precisely the thing you are supposed to reach with a relative path. So every\n * analytics call returned `400 absolute_urls_not_allowed`, and owner-lite's\n * Analytics and Build-a-report screens showed that raw JSON in their error arm on\n * the web preview while both worked on device.\n *\n * Keep them relative. An absolute URL here is not a style choice — it is a screen\n * that only works on half its surfaces.\n */",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "effectiveZone",
         "kind": "function",
@@ -5820,14 +5838,14 @@
         "name": "getSiteAnalytics",
         "kind": "function",
         "jsdoc": "/**\n * Site analytics for `measurementTypes` over `[startDate, endDate)`.\n *\n * Options object rather than positional parameters: `timeZone` is the third thing\n * that materially changes the result and the list was already at its readable\n * limit.\n */",
-        "decl": "export function getSiteAnalytics(opts: GetSiteAnalyticsOptions): Promise<WixAnalyticsResponse>;",
+        "decl": "export function getSiteAnalytics(opts: GetSiteAnalyticsOptions, options?: WixCallOptions): Promise<WixAnalyticsResponse>;",
         "http": "GET /analytics/v2/site-analytics/data?{…}"
       },
       {
         "name": "getSiteTimeZone",
         "kind": "function",
         "jsdoc": "/**\n * The site's IANA time zone, for `timeZone` / `interval.timezone`.\n *\n * This is a Site Properties call, not an analytics one, and strictly belongs to a\n * `@himalaya/wix-site-properties` domain that does not exist. It lives here\n * because every analytics query needs it and the alternative is each caller\n * hand-rolling the same raw `wixApi` request. A deliberate trade-off, recorded so\n * the next reader does not take it for an accident.\n */",
-        "decl": "export function getSiteTimeZone(): Promise<string | undefined>;",
+        "decl": "export function getSiteTimeZone(options?: WixCallOptions): Promise<string | undefined>;",
         "http": "GET /site-properties/v4/properties?fields.paths=timeZone"
       },
       {
@@ -5931,7 +5949,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -6229,7 +6247,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -7764,7 +7782,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -8190,7 +8208,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -8687,7 +8705,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -8832,7 +8850,7 @@
         "name": "getDraftPost",
         "kind": "function",
         "jsdoc": "/** Fetch a single draft post by id — the editor/settings prefill source. */",
-        "decl": "export function getDraftPost(postId: string): Promise<WixGetDraftPostResponse>;"
+        "decl": "export function getDraftPost(postId: string, options?: WixCallOptions): Promise<WixGetDraftPostResponse>;"
       },
       {
         "name": "WixPostWithContent",
@@ -8856,7 +8874,7 @@
         "name": "getPost",
         "kind": "function",
         "jsdoc": "/** Fetch a single PUBLISHED post by id — GET /blog/v3/posts/{id}. The list\n * (queryPosts) returns published posts, so the detail reads them here (draft\n * ids are a different space — getDraftPost is for the edit/create flow).\n *\n * Body fieldsets (#826): Blog v3 `GET /posts/{id}` returns 200 but only the\n * LIST projection (title / excerpt / meta) unless the caller asks for the body —\n * the bare GET has NO `richContent` / `contentText`. So we request\n * RICH_CONTENT + CONTENT_TEXT by default and the article body loads on the happy\n * path; callers can override via `req.fieldsets`. (Supersedes the old #507 note:\n * the 502 this GET once returned for anonymous visitors is gone — it 200s now —\n * but a body-less 200 was never the \"body preserved whenever the backend is\n * healthy\" the earlier comment claimed; the body was simply never requested.)\n *\n * On any rejection (network / backend error) we still fall back to a queryPosts\n * filter-by-id — a graceful degrade to the LIST projection (no body) that keeps\n * blog detail + saved screens rendering instead of erroring out. `queryPosts`'s\n * request type has no `fieldsets` field, so that fallback path cannot carry the\n * body.\n *\n * When that fallback ALSO finds nothing — a deleted post, or one this visitor\n * may not see — we reject rather than resolve. `WixGetPostResponse.post`\n * is non-optional, so returning `{ post: resp.posts?.[0] }` would hand callers an\n * `undefined` the type promises is present, and the `post.title` access that type\n * licenses throws a `TypeError` deep inside the caller — the exact hard error\n * this fallback exists to prevent, and harder to diagnose than a clean rejection.\n * Every call site rides its own rejection path (cached-post state, draft-only\n * `catch`, or an `allSettled` filter), so rejecting is what routes them into the\n * graceful degrade they already implement. The originating failure travels as\n * `cause`, so the 404-vs-network distinction is not lost. */",
-        "decl": "export function getPost(\n  postId: string,\n  req: WixGetPostRequest = {},\n): Promise<WixGetPostResponse>;",
+        "decl": "export function getPost(\n  postId: string,\n  req: WixGetPostRequest = {}, readOptions?: WixCallOptions,\n): Promise<WixGetPostResponse>;",
         "http": "GET /blog/v3/posts/{…}"
       },
       {
@@ -8875,7 +8893,7 @@
         "name": "queryCategories",
         "kind": "function",
         "jsdoc": "/** List blog categories — POST /blog/v3/categories/query. Used to map a post's\n * categoryIds to human labels. */",
-        "decl": "export function queryCategories(req: { paging?: { limit?: number; offset?: number } } = {}): Promise<WixQueryCategoriesResponse>;",
+        "decl": "export function queryCategories(req: { paging?: { limit?: number; offset?: number } } = {}, opts?: WixCallOptions): Promise<WixQueryCategoriesResponse>;",
         "http": "POST /blog/v3/categories/query"
       },
       {
@@ -8950,7 +8968,7 @@
         "name": "queryDraftPosts",
         "kind": "function",
         "jsdoc": "",
-        "decl": "export function queryDraftPosts(req: WixQueryDraftPostsRequest = {}): Promise<WixQueryDraftPostsResponse>;"
+        "decl": "export function queryDraftPosts(req: WixQueryDraftPostsRequest = {}, opts?: WixCallOptions): Promise<WixQueryDraftPostsResponse>;"
       },
       {
         "name": "cancelScheduleDraftPost",
@@ -8969,7 +8987,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -9542,7 +9560,7 @@
         "name": "queryServices",
         "kind": "function",
         "jsdoc": "/** Query/list services — POST /bookings/v2/services/query. Visitor-readable: the\n *  PUBLIC GA route (audience MEMBERS_AND_VISITORS), so a visitor/consumer token can\n *  read it — NOT the owner/BO `_api/` gateway (which fails for visitors, #463). Takes\n *  the standard query envelope (filter/sort/paging). */",
-        "decl": "export async function queryServices(req: WixQueryServicesRequest = {} as WixQueryServicesRequest): Promise<WixQueryServicesResponse>;",
+        "decl": "export async function queryServices(req: WixQueryServicesRequest = {} as WixQueryServicesRequest, readOptions?: WixCallOptions): Promise<WixQueryServicesResponse>;",
         "http": "POST /bookings/v2/services/query"
       },
       {
@@ -9575,7 +9593,7 @@
         "name": "getService",
         "kind": "function",
         "jsdoc": "/** Fetch a single service by id — GET /bookings/v2/services/{id}. Visitor-readable\n *  (public GA route, not the owner `_api/` gateway). The detail/edit-prefill source.\n *  `options.conditionalFields` asks for fields Wix returns only on request\n *  (\"STAFF_MEMBER_DETAILS\", \"DISCOUNT_INFO_DETAILS\"), each sent as a repeated\n *  `conditionalFields` query parameter. Without `options` the request is the one this\n *  function always sent. */",
-        "decl": "export async function getService(serviceId: string, options?: WixGetServiceOptions): Promise<WixGetServiceResponse>;"
+        "decl": "export async function getService(serviceId: string, options?: WixGetServiceOptions & WixCallOptions): Promise<WixGetServiceResponse>;"
       },
       {
         "name": "WixServiceWrite",
@@ -9786,7 +9804,7 @@
         "name": "queryServiceAvailability",
         "kind": "function",
         "jsdoc": "/**\n * Query bookable slots for a service in a date window —\n * POST /bookings/v1/availability/query. Verified live (571 entries).\n *\n * BOUND IT. Unfiltered, this returns every slot in the window, bookable AND\n * unbookable — a two-week window on a busy calendar is hundreds of entries and a\n * response big enough to stall a worker. Two things bound it, and only one of them\n * is a parameter here:\n *\n *  - `bookable`, which this now defaults to `true`. Slots you cannot book are not\n *    what a booking screen is paging through.\n *  - THE WINDOW ITSELF. Ask for the days you are about to paint, not the month.\n *\n * What is NOT available is paging: the request's `query` carries only `filter` and\n * `sort`, so a `paging: { limit }` is an unknown field the server drops on the\n * floor — which is why \"it ignores its own paging.limit\" is a misreading. There was\n * never a paging member to ignore.\n *\n * A per-day cap (`slotsPerDay`) is deliberately NOT offered. This v1 Availability\n * Calendar endpoint is absent from the current published Wix reference (superseded\n * by Time Slots V2), and the two plausible spellings put it in different places — a\n * `query.filter` member, or a top-level sibling of `query`. An unknown field in\n * either position is dropped silently rather than rejected, so shipping the wrong\n * guess would hand callers a knob that does nothing while this comment promised it\n * worked. Narrow the window instead, until the level can be confirmed against a\n * schema or a live call.\n */",
-        "decl": "export function queryServiceAvailability(\n  serviceId: string,\n  startDate: string,\n  endDate: string,\n  options: WixServiceAvailabilityOptions = {},\n): Promise<WixQueryAvailabilityResponse>;",
+        "decl": "export function queryServiceAvailability(\n  serviceId: string,\n  startDate: string,\n  endDate: string,\n  options: WixServiceAvailabilityOptions = {},\n  readOptions?: WixCallOptions,\n): Promise<WixQueryAvailabilityResponse>;",
         "http": "POST /bookings/v1/availability/query"
       },
       {
@@ -9911,7 +9929,7 @@
         "name": "getBookingFull",
         "kind": "function",
         "jsdoc": "/** Rich single-booking read — GET /bookings/v1/bookings/{id}. Returns the full\n *  booking (payment/intake/location/staff/attendance). The booking-detail data source.\n *  Owner-scoped: needs an owner/BO session; a visitor or member token gets 403. A\n *  member-facing screen reads its own bookings via `queryBookings` instead. */",
-        "decl": "export function getBookingFull(bookingId: string): Promise<WixGetBookingFullResponse>;",
+        "decl": "export function getBookingFull(bookingId: string, options?: WixCallOptions): Promise<WixGetBookingFullResponse>;",
         "http": "GET /bookings/v1/bookings/{…}"
       },
       {
@@ -9981,7 +9999,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -10861,11 +10879,17 @@
         "jsdoc": "",
         "decl": "export type ChatRole = \"owner\" | \"member\";"
       },
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  /** Cache-only reads never use the network; reload waits for a successful server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "ChatOptions",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface ChatOptions {\n  /** `owner` (default) mints with isForUnifiedList=true; `member` with false. */\n  role?: ChatRole;\n  /** A caller-supplied chatToken; skips the mint. Never stored by this module. */\n  chatToken?: string;\n}"
+        "decl": "export interface ChatOptions extends WixCallOptions {\n  /** `owner` (default) mints with isForUnifiedList=true; `member` with false. */\n  role?: ChatRole;\n  /** A caller-supplied chatToken; skips the mint. Never stored by this module. */\n  chatToken?: string;\n}"
       },
       {
         "name": "ChatCursor",
@@ -11010,7 +11034,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -13187,7 +13211,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -13445,6 +13469,12 @@
     "source": "stdlib/wix-sdk/coupons/src/index.ts",
     "description": "Discount coupons",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "WixPaging",
         "kind": "interface",
@@ -13527,14 +13557,14 @@
         "name": "queryCoupons",
         "kind": "function",
         "jsdoc": "/** Query coupons — POST /stores/v2/coupons/query. The request is wrapped as\n * `{ query }` (Wix QueryV2 convention). */",
-        "decl": "export function queryCoupons(req: WixCouponsQueryRequest = {} as WixCouponsQueryRequest): Promise<WixQueryCouponsResponse>;",
+        "decl": "export function queryCoupons(req: WixCouponsQueryRequest = {} as WixCouponsQueryRequest, readOptions?: WixCallOptions): Promise<WixQueryCouponsResponse>;",
         "http": "POST /stores/v2/coupons/query"
       },
       {
         "name": "getCoupon",
         "kind": "function",
         "jsdoc": "/** Get a single coupon — GET /stores/v2/coupons/{id}. */",
-        "decl": "export function getCoupon(id: string): Promise<WixGetCouponResponse>;",
+        "decl": "export function getCoupon(id: string, options?: WixCallOptions): Promise<WixGetCouponResponse>;",
         "http": "GET /stores/v2/coupons/{…}"
       },
       {
@@ -13667,6 +13697,12 @@
     "source": "stdlib/wix-sdk/wix-data/src/index.ts",
     "description": "Wix data — typed REST client",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "WixDataItem",
         "kind": "interface",
@@ -13701,7 +13737,7 @@
         "name": "WixQueryOptions",
         "kind": "interface",
         "jsdoc": "/** The rarely-needed read parameters of `queryDataItems`. Every field is omitted from the wire\n *  body unless set, so a caller that passes none sends the exact body it always sent. */",
-        "decl": "export interface WixQueryOptions {\n  /** Read from the primary database instance instead of the nearest mirror. Slower, but a read\n   *  right after your own write sees it — the default is eventually consistent. */\n  consistentRead?: boolean;\n  /** Page by cursor instead of `offset`. Mutually exclusive with `offset`. */\n  cursorPaging?: WixDataCursorPaging;\n  /** Return only these fields (`_id` always comes back). */\n  fields?: string[];\n  includeReferences?: WixIncludeReference[];\n  /** IETF BCP 47 tag; needs Wix Multilingual enabled for the collection. */\n  language?: string;\n  /** Also read pending drafts (collections with the draft-items plugin). */\n  includeDraftItems?: boolean;\n}"
+        "decl": "export interface WixQueryOptions extends WixCallOptions {\n  /** Read from the primary database instance instead of the nearest mirror. Slower, but a read\n   *  right after your own write sees it — the default is eventually consistent. */\n  consistentRead?: boolean;\n  /** Page by cursor instead of `offset`. Mutually exclusive with `offset`. */\n  cursorPaging?: WixDataCursorPaging;\n  /** Return only these fields (`_id` always comes back). */\n  fields?: string[];\n  includeReferences?: WixIncludeReference[];\n  /** IETF BCP 47 tag; needs Wix Multilingual enabled for the collection. */\n  language?: string;\n  /** Also read pending drafts (collections with the draft-items plugin). */\n  includeDraftItems?: boolean;\n}"
       },
       {
         "name": "WixQueryDataItemsRequest",
@@ -13744,7 +13780,7 @@
         "name": "getDataItem",
         "kind": "function",
         "jsdoc": "/** Read ONE item by id — GET /wix-data/v2/items/{dataItemId}?dataCollectionId=…\n *\n *  Reach for this on a detail screen. Before it existed the only read this package\n *  offered was `queryDataItems`, so a detail worker had to fetch a bounded page and\n *  find its row client-side:\n *\n *  ```ts\n *  const res = await queryDataItems(\"Listings\", 50);          // ← DON'T\n *  const row = (res.dataItems ?? []).find((it) => it.id === id);\n *  ```\n *\n *  That is correct against a handful of seeded rows and silently wrong once the\n *  collection outgrows `limit`. Ask for the row instead:\n *\n *  ```ts\n *  const { dataItem } = await getDataItem(\"Listings\", id);     // ← DO\n *  ```\n *\n *  The collection id rides the query string rather than a body, because the Wix\n *  gateway drops a GET body — and the string is built with `encodeURIComponent`\n *  rather than `URLSearchParams`, which the bare Tier-5 worker runtimes (JSCore /\n *  Hermes / QuickJS-ng) do not provide. */",
-        "decl": "export function getDataItem(\n  dataCollectionId: string,\n  dataItemId: string,\n): Promise<{ dataItem?: WixDataItem }>;",
+        "decl": "export function getDataItem(\n  dataCollectionId: string,\n  dataItemId: string,\n  options?: WixCallOptions,\n): Promise<{ dataItem?: WixDataItem }>;",
         "http": "GET /wix-data/v2/items/{…}?dataCollectionId={…}"
       },
       {
@@ -14075,7 +14111,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -15807,7 +15843,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -16322,7 +16358,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `searchOrders(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -16419,7 +16455,7 @@
         "name": "getOrder",
         "kind": "function",
         "jsdoc": "/** Fetch a single order by id — the detail screen's data source. */",
-        "decl": "export function getOrder(orderId: string): Promise<WixGetOrderResponse>;",
+        "decl": "export function getOrder(orderId: string, options?: WixCallOptions): Promise<WixGetOrderResponse>;",
         "http": "GET /ecom/v1/orders/{…}"
       },
       {
@@ -16533,7 +16569,7 @@
         "name": "getCurrentCart",
         "kind": "function",
         "jsdoc": "/** Read the current cart — GET /ecom/v1/carts/current. The API wraps the cart in\n *  `{ cart: {...} }`; this unwraps it so callers get the cart (line items +\n *  subtotal) directly. Verified live. An `OWNED_CART_NOT_FOUND` 404 is the empty\n *  cart (never added an item) — resolved as `{ lineItems: [] }`, not thrown, so a\n *  signed-out visitor's first mount is a successful read of an empty cart.\n *  `{ lineItems: [] }` is the shape every caller already handles: the badge readers\n *  sum `(cart.lineItems ?? [])` and the cart screen additionally takes\n *  `cart.subtotal?.formattedAmount ?? \"\"` and `(await getCurrentCart()).id || \"\"` —\n *  all three degrade to empty/0 on an absent field, so no caller special-cases it. */",
-        "decl": "export async function getCurrentCart(): Promise<WixCartDetail>;",
+        "decl": "export async function getCurrentCart(opts?: WixCallOptions): Promise<WixCartDetail>;",
         "http": "GET /ecom/v1/carts/current"
       },
       {
@@ -16787,13 +16823,13 @@
         "name": "listMemberAddresses",
         "kind": "function",
         "jsdoc": "/** The signed-in member's saved addresses + which one is the default. */",
-        "decl": "export function listMemberAddresses(): Promise<WixListMemberAddressesResponse>;"
+        "decl": "export function listMemberAddresses(options?: WixCallOptions): Promise<WixListMemberAddressesResponse>;"
       },
       {
         "name": "getMemberAddress",
         "kind": "function",
         "jsdoc": "/** One saved address by id, and whether it is the member's default. An unknown id\n *  rejects with 404 `cant_find_address_by_id`. */",
-        "decl": "export function getMemberAddress(addressId: string): Promise<WixGetMemberAddressResponse>;"
+        "decl": "export function getMemberAddress(addressId: string, options?: WixCallOptions): Promise<WixGetMemberAddressResponse>;"
       },
       {
         "name": "getDefaultMemberAddress",
@@ -16847,7 +16883,7 @@
         "name": "listMySavedPaymentMethods",
         "kind": "function",
         "jsdoc": "/** The signed-in member's saved payment methods, most recently updated first. */",
-        "decl": "export function listMySavedPaymentMethods(\n  opts: { cursor?: string; limit?: number } = {},\n): Promise<WixListSavedPaymentMethodsResponse>;"
+        "decl": "export function listMySavedPaymentMethods(\n  opts: { cursor?: string; limit?: number } = {},\n  options?: WixCallOptions,\n): Promise<WixListSavedPaymentMethodsResponse>;"
       },
       {
         "name": "deleteSavedPaymentMethod",
@@ -16993,7 +17029,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -18309,6 +18345,12 @@
     "source": "stdlib/wix-sdk/events/src/index.ts",
     "description": "Events — events, RSVPs, tickets",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "WixEventImage",
         "kind": "interface",
@@ -18379,7 +18421,7 @@
         "name": "queryEvents",
         "kind": "function",
         "jsdoc": "/** List the site's events — POST /events/v3/events/query → { events, pagingMetadata }.\n *  **Visitor-readable**: works with a visitor/consumer token (`WixConsumerAuthProvider`),\n *  not just an owner session. (NOT the owner-only GET /events-in-clubs/chunked-events,\n *  which returns an HTML error page for a visitor token.) */",
-        "decl": "export async function queryEvents(opts: WixQueryEventsOptions = {}): Promise<WixGetEventListResponse>;",
+        "decl": "export async function queryEvents(opts: WixQueryEventsOptions = {}, readOptions?: WixCallOptions): Promise<WixGetEventListResponse>;",
         "http": "POST /events/v3/events/query"
       },
       {
@@ -18398,7 +18440,7 @@
         "name": "getEvent",
         "kind": "function",
         "jsdoc": "/** Get one event — GET /events/v3/events/{eventId}. Response wraps as `{ event }`.\n *  NOTE: this GET returns the Events v3 BASE fieldset — slimmer than `queryEvents`,\n *  which returns the richer default (fields such as `registration` and `calendarUrls`\n *  are absent from a bare `getEvent`). If a detail screen needs those fields for one\n *  event, prefer `queryEvents` and pick the row by id over `getEvent`.\n *  `opts.fields` requests extra v3 fieldsets; `[\"TEXTS\"]` returns `description`. */",
-        "decl": "export async function getEvent(eventId: string, opts: { fields?: WixEventFieldset[] } = {}): Promise<WixGetEventResponse>;",
+        "decl": "export async function getEvent(eventId: string, opts: { fields?: WixEventFieldset[] } = {}, readOptions?: WixCallOptions): Promise<WixGetEventResponse>;",
         "http": "GET /events/v3/events/{…}{…}"
       },
       {
@@ -18681,7 +18723,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -20349,7 +20391,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -20450,7 +20492,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -21068,7 +21110,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -22092,7 +22134,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -22447,7 +22489,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -22546,7 +22588,7 @@
         "name": "listConversations",
         "kind": "function",
         "jsdoc": "/** List the site's inbox conversations (real mobile Owner endpoint:\n *  GET https://www.wixapis.com/inbox/v2/conversations). Returns an empty list\n *  for sites with no conversations / no Inbox app provisioned. */",
-        "decl": "export function listConversations(req: { paging?: WixPaging } = {}): Promise<WixListConversationsResponse>;",
+        "decl": "export function listConversations(req: { paging?: WixPaging } = {}, opts?: WixCallOptions): Promise<WixListConversationsResponse>;",
         "http": "GET /inbox/v2/conversations{…}"
       }
     ]
@@ -22556,6 +22598,12 @@
     "source": "stdlib/wix-sdk/invoices/src/index.ts",
     "description": "Invoices",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "WixInvoiceContactDetails",
         "kind": "interface",
@@ -22614,7 +22662,7 @@
         "name": "queryInvoices",
         "kind": "function",
         "jsdoc": "/** List/query invoices — POST /invoices/v4/invoices/query. The list screen's source. */",
-        "decl": "export function queryInvoices(req: WixQueryInvoicesRequest = {} as WixQueryInvoicesRequest): Promise<WixQueryInvoicesResponse>;",
+        "decl": "export function queryInvoices(req: WixQueryInvoicesRequest = {} as WixQueryInvoicesRequest, readOptions?: WixCallOptions): Promise<WixQueryInvoicesResponse>;",
         "http": "POST /invoices/v4/invoices/query"
       },
       {
@@ -22627,7 +22675,7 @@
         "name": "getInvoice",
         "kind": "function",
         "jsdoc": "/** Fetch a single invoice by id — GET /invoices/v4/invoices/{id}. Detail source. */",
-        "decl": "export function getInvoice(invoiceId: string): Promise<WixGetInvoiceResponse>;",
+        "decl": "export function getInvoice(invoiceId: string, options?: WixCallOptions): Promise<WixGetInvoiceResponse>;",
         "http": "GET /invoices/v4/invoices/{…}"
       },
       {
@@ -22695,11 +22743,17 @@
     "source": "stdlib/wix-sdk/loyalty/src/index.ts",
     "description": "Loyalty points and rewards",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "wixCall",
         "kind": "function",
-        "jsdoc": "",
-        "decl": "export function wixCall<T>(method: string, path: string, body?: unknown): Promise<T>;"
+        "jsdoc": "/** The per-call header map for `opts`, or undefined when there is nothing to add — so\n *  the no-options path calls the bridge with exactly the 3 arguments it always did. */",
+        "decl": "export function wixCall<T>(method: string, path: string, body?: unknown, readOptions?: WixCallOptions): Promise<T>;"
       },
       {
         "name": "WixLoyaltyProgram",
@@ -22723,21 +22777,21 @@
         "name": "getLoyaltyProgram",
         "kind": "function",
         "jsdoc": "/** GET /loyalty/v1/program → { loyaltyProgram }. */",
-        "decl": "export function getLoyaltyProgram(): Promise<{ loyaltyProgram?: WixLoyaltyProgram; program?: WixLoyaltyProgram }>;",
+        "decl": "export function getLoyaltyProgram(readOptions?: WixCallOptions): Promise<{ loyaltyProgram?: WixLoyaltyProgram; program?: WixLoyaltyProgram }>;",
         "http": "GET /loyalty/v1/program"
       },
       {
         "name": "listLoyaltyRewards",
         "kind": "function",
         "jsdoc": "/** GET /loyalty/v1/rewards → { rewards }. */",
-        "decl": "export function listLoyaltyRewards(): Promise<{ rewards?: WixLoyaltyReward[] }>;",
+        "decl": "export function listLoyaltyRewards(readOptions?: WixCallOptions): Promise<{ rewards?: WixLoyaltyReward[] }>;",
         "http": "GET /loyalty/v1/rewards"
       },
       {
         "name": "listLoyaltyTiers",
         "kind": "function",
         "jsdoc": "/** GET /loyalty/v1/tiers → { tiers }. The PUBLIC program tier ladder\n * (wix.loyalty.v1.tier) — NOT the private per-customer tiers-program dashboard. */",
-        "decl": "export function listLoyaltyTiers(): Promise<{ tiers?: WixLoyaltyTier[] }>;",
+        "decl": "export function listLoyaltyTiers(readOptions?: WixCallOptions): Promise<{ tiers?: WixLoyaltyTier[] }>;",
         "http": "GET /loyalty/v1/tiers"
       },
       {
@@ -22781,7 +22835,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -23107,6 +23161,12 @@
     "source": "stdlib/wix-sdk/members-v1/src/index.ts",
     "description": "Site members (Members Area)",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "WixPaging",
         "kind": "interface",
@@ -23207,14 +23267,14 @@
         "name": "queryMembers",
         "kind": "function",
         "jsdoc": "/** List site members — POST /members/v1/members/query. Pass `{ query: { paging: { limit, offset? } } }`\n *  (offset paging). Do not pass `cursorPaging` — that is a different Wix envelope and is not on this type. */",
-        "decl": "export function queryMembers(req: WixQueryMembersRequest = {} as WixQueryMembersRequest): Promise<WixQueryMembersResponse>;",
+        "decl": "export function queryMembers(req: WixQueryMembersRequest = {} as WixQueryMembersRequest, readOptions?: WixCallOptions): Promise<WixQueryMembersResponse>;",
         "http": "POST /members/v1/members/query"
       },
       {
         "name": "getMember",
         "kind": "function",
         "jsdoc": "/** Fetch a single member by id — GET /members/v1/members/{id}?fieldsets=FULL. */",
-        "decl": "export function getMember(id: string): Promise<WixGetMemberResponse>;",
+        "decl": "export function getMember(id: string, options?: WixCallOptions): Promise<WixGetMemberResponse>;",
         "http": "GET /members/v1/members/{…}?fieldsets=FULL"
       },
       {
@@ -23350,7 +23410,7 @@
         "name": "getFollowCounts",
         "kind": "function",
         "jsdoc": "/** Followers / following totals for a member — POST\n *  /members/v1/activity-counters/query. Parses the Followers-app counter entry;\n *  defaults each total to 0 when absent. May 403 → caller should default. */",
-        "decl": "export async function getFollowCounts(memberId: string): Promise<WixFollowCounts>;",
+        "decl": "export async function getFollowCounts(memberId: string, options?: WixCallOptions): Promise<WixFollowCounts>;",
         "http": "POST /members/v1/activity-counters/query"
       },
       {
@@ -23367,6 +23427,12 @@
     "source": "stdlib/wix-sdk/members-feed-viewer/src/index.ts",
     "description": "Member notifications inbox",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "MfvLink",
         "kind": "interface",
@@ -23395,7 +23461,7 @@
         "name": "queryNotifications",
         "kind": "function",
         "jsdoc": "/** List the signed-in member's notifications, newest first. MOBILE channel. */",
-        "decl": "export async function queryNotifications(limit = 25): Promise<MfvNotification[]>;"
+        "decl": "export async function queryNotifications(limit = 25, options?: WixCallOptions): Promise<MfvNotification[]>;"
       },
       {
         "name": "markRead",
@@ -23416,6 +23482,12 @@
     "source": "stdlib/wix-sdk/new-releases/src/index.ts",
     "description": "New releases feed",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "WixAnnouncementAsset",
         "kind": "interface",
@@ -23444,7 +23516,7 @@
         "name": "listAnnouncements",
         "kind": "function",
         "jsdoc": "",
-        "decl": "export function listAnnouncements(limit = 20): Promise<WixAnnouncementsResponse>;"
+        "decl": "export function listAnnouncements(limit = 20, options?: WixCallOptions): Promise<WixAnnouncementsResponse>;"
       }
     ]
   },
@@ -23453,6 +23525,12 @@
     "source": "stdlib/wix-sdk/notification-preferences/src/index.ts",
     "description": "Notification preferences",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "/** Explicit read policy; business response payloads remain unchanged. */",
+        "decl": "export interface WixCallOptions {\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?(metadata: { source: \"cache\" | \"network\"; fetchedAt: number; expiresAt?: number; cacheable: boolean }): void;\n}"
+      },
       {
         "name": "NOTIFICATION_PREFERENCES_BASE",
         "kind": "const",
@@ -23571,7 +23649,7 @@
         "name": "getNotificationTopics",
         "kind": "function",
         "jsdoc": "/** List the site's notification topics — `GET /v1/preferences/topics`\n *  (GetNotificationTopicsDefinitions). Publicly mounted.\n *  verify-live: source contract checked; live caller authorization remains untested. */",
-        "decl": "export function getNotificationTopics(): Promise<GetNotificationTopicsResponse>;",
+        "decl": "export function getNotificationTopics(options?: WixCallOptions): Promise<GetNotificationTopicsResponse>;",
         "verified": false
       },
       {
@@ -23585,7 +23663,7 @@
         "name": "getMyNotificationPreferences",
         "kind": "function",
         "jsdoc": "/** The signed-in recipient's preferences — `GET /v1/preferences-by-implicit-recipient`\n *  (GetPreferencesByImplicitRecipient). NOT in the published public swagger; a 404 from\n *  the public gateway is the expected outcome there, not a bug in this call.\n *  verify-live: the implicit-recipient mount has not been verified for member callers. */",
-        "decl": "export function getMyNotificationPreferences(): Promise<GetMyNotificationPreferencesResponse>;",
+        "decl": "export function getMyNotificationPreferences(options?: WixCallOptions): Promise<GetMyNotificationPreferencesResponse>;",
         "verified": false
       },
       {
@@ -23606,7 +23684,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -23748,6 +23826,12 @@
     "source": "stdlib/wix-sdk/online-programs/src/index.ts",
     "description": "Online programs / courses",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "WixProgramDescription",
         "kind": "interface",
@@ -23776,7 +23860,7 @@
         "name": "queryPrograms",
         "kind": "function",
         "jsdoc": "/** POST /online-programs/v3/programs/query — list programs (cursor-paged). */",
-        "decl": "export function queryPrograms(query: WixProgramQuery): Promise<WixQueryProgramsResponse>;",
+        "decl": "export function queryPrograms(query: WixProgramQuery, readOptions?: WixCallOptions): Promise<WixQueryProgramsResponse>;",
         "http": "POST /online-programs/v3/programs/query"
       },
       {
@@ -23795,7 +23879,7 @@
         "name": "getProgram",
         "kind": "function",
         "jsdoc": "/** GET /online-programs/v3/programs/{id} — single program (management view). */",
-        "decl": "export function getProgram(id: string): Promise<WixGetProgramResponse>;",
+        "decl": "export function getProgram(id: string, readOptions?: WixCallOptions): Promise<WixGetProgramResponse>;",
         "http": "GET /online-programs/v3/programs/{…}"
       },
       {
@@ -23814,7 +23898,7 @@
         "name": "queryParticipants",
         "kind": "function",
         "jsdoc": "/** POST /online-programs/v3/participants/query — participants for one program. */",
-        "decl": "export function queryParticipants(programId: string, opts?: { progressStatus?: string; limit?: number }): Promise<WixQueryParticipantsResponse>;",
+        "decl": "export function queryParticipants(programId: string, opts?: { progressStatus?: string; limit?: number }, readOptions?: WixCallOptions): Promise<WixQueryParticipantsResponse>;",
         "http": "POST /online-programs/v3/participants/query"
       },
       {
@@ -23861,6 +23945,12 @@
     "source": "stdlib/wix-sdk/portfolio/src/index.ts",
     "description": "Portfolio — projects and collections",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "WixMediaImage",
         "kind": "interface",
@@ -23889,7 +23979,7 @@
         "name": "listProjects",
         "kind": "function",
         "jsdoc": "/** GET /portfolio/v1/projects — list projects (paged). */",
-        "decl": "export function listProjects(limit = 100, cursor?: string): Promise<WixListProjectsResponse>;",
+        "decl": "export function listProjects(limit = 100, cursor?: string, readOptions?: WixCallOptions): Promise<WixListProjectsResponse>;",
         "http": "GET /portfolio/v1/projects?{…}"
       },
       {
@@ -23908,7 +23998,7 @@
         "name": "listCollections",
         "kind": "function",
         "jsdoc": "/** GET /portfolio/v1/collections — list collections (paged). */",
-        "decl": "export function listCollections(limit = 100, cursor?: string): Promise<WixListCollectionsResponse>;",
+        "decl": "export function listCollections(limit = 100, cursor?: string, readOptions?: WixCallOptions): Promise<WixListCollectionsResponse>;",
         "http": "GET /portfolio/v1/collections?{…}"
       },
       {
@@ -23927,7 +24017,7 @@
         "name": "listProjectItems",
         "kind": "function",
         "jsdoc": "/**\n * POST /portfolio/v1/items/query — list a project's items.\n *\n * A first page filters on `projectId` with `paging.limit`. Passing a `cursor` (a previous\n * page's `pagingMetadata.cursors.next`) switches to `cursorPaging` and drops the filter,\n * because a Wix query cursor already carries it. Items come back in the order Wix returns\n * them — sort on `sortOrder` for the author's order.\n */",
-        "decl": "export function listProjectItems(projectId: string, limit = 100, cursor?: string): Promise<WixListProjectItemsResponse>;",
+        "decl": "export function listProjectItems(projectId: string, limit = 100, cursor?: string, readOptions?: WixCallOptions): Promise<WixListProjectItemsResponse>;",
         "http": "POST /portfolio/v1/items/query"
       }
     ]
@@ -23937,6 +24027,12 @@
     "source": "stdlib/wix-sdk/pricing-plans/src/index.ts",
     "description": "Paid plans and subscriptions",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "WixMoney",
         "kind": "interface",
@@ -23983,7 +24079,7 @@
         "name": "listPlans",
         "kind": "function",
         "jsdoc": "/** List pricing plans — GET /pricing-plans/v2/plans. The list screen's data\n * source. Returns public + hidden plans (archived excluded by default). */",
-        "decl": "export function listPlans(): Promise<WixListPlansResponse>;",
+        "decl": "export function listPlans(readOptions?: WixCallOptions): Promise<WixListPlansResponse>;",
         "http": "GET /pricing-plans/v2/plans"
       },
       {
@@ -23996,7 +24092,7 @@
         "name": "listPublicPlans",
         "kind": "function",
         "jsdoc": "/** List PUBLIC pricing plans — GET /pricing-plans/v2/plans/public. The\n * consumer/visitor list source: the public GA route works on the ANONYMOUS\n * visitor rung (no member/owner session), unlike listPlans above which needs a\n * management identity. Export name mirrors the generated pricing-plans-v2\n * client (stdlib/wix-sdk/pricing-plans-v2) — the canonical importable name\n * stays unversioned per RFC 0043 D2. */",
-        "decl": "export function listPublicPlans(): Promise<WixListPublicPlansResponse>;",
+        "decl": "export function listPublicPlans(readOptions?: WixCallOptions): Promise<WixListPublicPlansResponse>;",
         "http": "GET /pricing-plans/v2/plans/public"
       },
       {
@@ -24009,7 +24105,7 @@
         "name": "getPlan",
         "kind": "function",
         "jsdoc": "/** Fetch a single plan by id — GET /pricing-plans/v2/plans/{id}. Detail source. */",
-        "decl": "export function getPlan(planId: string): Promise<WixGetPlanResponse>;",
+        "decl": "export function getPlan(planId: string, readOptions?: WixCallOptions): Promise<WixGetPlanResponse>;",
         "http": "GET /pricing-plans/v2/plans/{…}"
       },
       {
@@ -24072,7 +24168,7 @@
         "name": "listPlanOrders",
         "kind": "function",
         "jsdoc": "/** List plan orders (subscriptions) — GET /pricing-plans/v2/orders. The\n * subscriptions list source. (The POST .../orders/query 500s; the GET works.)\n *\n * OWNER-SCOPED. This is `OrderManagementService.ListOrders`, which requires\n * `PRICING_PLANS.READ_ORDERS` — an OWNER permission. A **member** session gets\n * `403` from it. To ask \"does the signed-in member hold a plan?\" — the\n * entitlement question every gated app asks — call `listMyPlanOrders()`. Using\n * this one there silently fails closed: the 403 reads as \"no orders\", so a\n * PAYING member is locked out of what they bought, and no error surfaces. */",
-        "decl": "export function listPlanOrders(): Promise<WixListPlanOrdersResponse>;",
+        "decl": "export function listPlanOrders(readOptions?: WixCallOptions): Promise<WixListPlanOrdersResponse>;",
         "http": "GET /pricing-plans/v2/orders"
       },
       {
@@ -24085,7 +24181,7 @@
         "name": "listMyPlanOrders",
         "kind": "function",
         "jsdoc": "/** List the CURRENT MEMBER's own plan orders — GET /pricing-plans/v2/member/orders\n * (`MemberOrdersService.ListOrders`, `PRICING_PLANS.READ_OWN_ORDERS`). Returns\n * only orders belonging to the logged-in member, and nothing at all for a\n * visitor — so it is member-scoped by construction, not by a filter the caller\n * must remember to pass.\n *\n * This is the entitlement door: `orders.some(o => o.status === \"ACTIVE\")`. Only\n * `ACTIVE` counts — a paid plan that has not settled sits at `DRAFT`, and\n * treating that as joined hands out the content without taking payment.\n *\n * ALWAYS PASS `statuses: [\"ACTIVE\"]` FOR THE ENTITLEMENT QUESTION. The response\n * is a single page — the maximum is 50 rows and there is no cursor — and a member\n * accrues a `DRAFT` order for every abandoned checkout. Scanning an unfiltered\n * page means that once the DRAFTs fill it, the one ACTIVE order falls off the\n * end and a PAYING member is locked out, silently and permanently. Filtering\n * server-side makes the page contain only what grants access, so the volume of\n * abandoned checkouts cannot matter.\n *\n * (`statuses` is a real proto field, not a tolerated unknown: an invalid value\n * is rejected with 400 rather than ignored, so a typo fails loudly here instead\n * of quietly widening the gate.) */",
-        "decl": "export function listMyPlanOrders(opts: ListMyPlanOrdersOptions = {}): Promise<WixListPlanOrdersResponse>;"
+        "decl": "export function listMyPlanOrders(opts: ListMyPlanOrdersOptions = {}, readOptions?: WixCallOptions): Promise<WixListPlanOrdersResponse>;"
       },
       {
         "name": "WixGetPlanOrderResponse",
@@ -24097,7 +24193,7 @@
         "name": "getPlanOrder",
         "kind": "function",
         "jsdoc": "/** Fetch a single plan order — GET /pricing-plans/v2/orders/{id}. Detail source. */",
-        "decl": "export function getPlanOrder(orderId: string): Promise<WixGetPlanOrderResponse>;",
+        "decl": "export function getPlanOrder(orderId: string, readOptions?: WixCallOptions): Promise<WixGetPlanOrderResponse>;",
         "http": "GET /pricing-plans/v2/orders/{…}"
       },
       {
@@ -24182,7 +24278,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -24544,7 +24640,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -24688,7 +24784,7 @@
         "name": "querySections",
         "kind": "function",
         "jsdoc": "/** POST /restaurants/menus/v1/sections/query — menu sections (perm\n *  RESTAURANTS.SECTION_READ; visitor-readable on sites with the Menus app). */",
-        "decl": "export function querySections(\n  req: WixSectionQueryRequest = {} as WixSectionQueryRequest,\n): Promise<WixQuerySectionsResponse>;",
+        "decl": "export function querySections(\n  req: WixSectionQueryRequest = {} as WixSectionQueryRequest,\n  opts?: WixCallOptions,\n): Promise<WixQuerySectionsResponse>;",
         "http": "POST /restaurants/menus/v1/sections/query"
       },
       {
@@ -24764,6 +24860,12 @@
     "source": "stdlib/wix-sdk/reviews/src/index.ts",
     "description": "Product and site reviews",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "ReviewModerationStatus",
         "kind": "type",
@@ -24804,14 +24906,14 @@
         "name": "queryReviews",
         "kind": "function",
         "jsdoc": "/** POST /reviews/v1/reviews/query — list reviews (cursor-paged WQL).\n * Pass returnPrivateReviews:true to include unpublished (pending/rejected) reviews. */",
-        "decl": "export function queryReviews(query: WixReviewQuery, returnPrivateReviews = false): Promise<WixQueryReviewsResponse>;",
+        "decl": "export function queryReviews(query: WixReviewQuery, returnPrivateReviews = false, readOptions?: WixCallOptions): Promise<WixQueryReviewsResponse>;",
         "http": "POST /reviews/v1/reviews/query"
       },
       {
         "name": "getReview",
         "kind": "function",
         "jsdoc": "/** GET /reviews/v1/reviews/{id} — single review.\n * returnPrivateReviews=true is required to read a pending/rejected review. */",
-        "decl": "export function getReview(id: string, returnPrivateReviews = true): Promise<{ review?: WixReview }>;",
+        "decl": "export function getReview(id: string, returnPrivateReviews = true, readOptions?: WixCallOptions): Promise<{ review?: WixReview }>;",
         "http": "GET /reviews/v1/reviews/{…}{…}"
       },
       {
@@ -24976,7 +25078,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -25136,7 +25238,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -25277,6 +25379,12 @@
     "source": "stdlib/wix-sdk/social-feed/src/index.ts",
     "description": "Social feed",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "WixFeedItem",
         "kind": "interface",
@@ -25299,7 +25407,7 @@
         "name": "listFeedItems",
         "kind": "function",
         "jsdoc": "/**\n * List a group's activity feed — GET\n * https://social.wix.com/serverless/mobile/feed/v4/feedPosts (the ENRICHED read the\n * real mobile app uses). Each item carries content (Ricos blocks), commentsCount, and\n * reactionsList (count = length); the response's top-level `profiles[]` resolves each\n * item's author.id → userName + profileImage. Verified live (200). Replaces the lean\n * GET /api/v1/feed/items read, which omitted counts + author.\n *\n * @scope member — verified live with a signed-in member session; visitor/anonymous\n * readability of a public group's feed is unconfirmed.\n */",
-        "decl": "export function listFeedItems(groupId: string, limit = 20): Promise<WixListFeedItemsResponse>;",
+        "decl": "export function listFeedItems(groupId: string, limit = 20, options?: WixCallOptions): Promise<WixListFeedItemsResponse>;",
         "scope": "member"
       },
       {
@@ -25346,14 +25454,14 @@
         "name": "queryStoreProducts",
         "kind": "function",
         "jsdoc": "/** List products from whichever catalog this site runs. `fields` is additive — it\n *  WIDENS the default v3 display fieldset rather than replacing it. */",
-        "decl": "export async function queryStoreProducts(\n  limit = 50,\n  cursor?: string,\n  fields?: readonly string[],\n): Promise<StoreProductsResponse>;",
+        "decl": "export async function queryStoreProducts(\n  limit = 50,\n  cursor?: string,\n  fields?: readonly string[],\n  options?: WixCallOptions,\n): Promise<StoreProductsResponse>;",
         "http": "POST /stores/v3/products/query"
       },
       {
         "name": "getStoreProduct",
         "kind": "function",
         "jsdoc": "/** Read one product from whichever catalog this site runs. `fields` is additive —\n *  it WIDENS the default v3 display fieldset rather than replacing it. */",
-        "decl": "export async function getStoreProduct(\n  productId: string,\n  fields?: readonly string[],\n): Promise<StoreGetProductResponse>;",
+        "decl": "export async function getStoreProduct(\n  productId: string,\n  fields?: readonly string[], readOptions?: WixCallOptions\n): Promise<StoreGetProductResponse>;",
         "http": "GET /stores/v3/products/{…}?{…}"
       },
       {
@@ -25372,7 +25480,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",
@@ -25530,7 +25638,7 @@
         "name": "getProduct",
         "kind": "function",
         "jsdoc": "/** Read one product from whichever catalog this site runs. `opts.richDescription` (Catalog V3) also asks\n *  for the Ricos `description` and returns it as `product.richDescription` (null when the product has\n *  none). The key is ABSENT on a V1 catalog, which has no Ricos description, and without the option. */",
-        "decl": "export function getProduct(productId: string, opts: { richDescription?: boolean } = {}): Promise<WixGetProductResponse>;",
+        "decl": "export function getProduct(productId: string, opts: { richDescription?: boolean } = {}, readOptions?: WixCallOptions): Promise<WixGetProductResponse>;",
         "http": "GET /stores/v1/products/{…}"
       },
       {
@@ -25638,7 +25746,7 @@
         "name": "searchStoreProducts",
         "kind": "function",
         "jsdoc": "/**\n * Search, sort, and filter products on whichever catalog this site runs — the read\n * behind a shop list, a saved-products list, and a category screen.\n *\n * `categoryId` narrows to one category's products (V3 `allCategoriesInfo`, so a parent\n * category includes its subcategories; V1 `collections.id`), ANDed with `ids`. An\n * empty `ids` array resolves to an empty page WITHOUT a request. Paging is one\n * contract on both catalogs: pass back `pagingMetadata.cursors.next` as `cursor`.\n * A non-catalog failure (401/403, offline) rejects; it is never retried on V1.\n */",
-        "decl": "export async function searchStoreProducts(options: StoreProductSearch = {}): Promise<StoreProductsResponse>;",
+        "decl": "export async function searchStoreProducts(options: StoreProductSearch = {}, readOptions?: WixCallOptions): Promise<StoreProductsResponse>;",
         "http": "POST /stores/v1/products/query"
       },
       {
@@ -25738,11 +25846,17 @@
     "source": "stdlib/wix-sdk/stores-collections/src/index.ts",
     "description": "Stores — product collections",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "wixCall",
         "kind": "function",
-        "jsdoc": "",
-        "decl": "export function wixCall<T>(method: string, path: string, body?: unknown): Promise<T>;"
+        "jsdoc": "/** The per-call header map for `opts`, or undefined when there is nothing to add — so\n *  the no-options path calls the bridge with exactly the 3 arguments it always did. */",
+        "decl": "export function wixCall<T>(method: string, path: string, body?: unknown, readOptions?: WixCallOptions): Promise<T>;"
       },
       {
         "name": "WixCollectionsPaging",
@@ -25808,14 +25922,14 @@
         "name": "getCollection",
         "kind": "function",
         "jsdoc": "/** Fetch a single collection by id — the detail screen's data source.\n *  ⚠️ Catalog **V1 only**: `/stores/v1/collections/*` returns HTTP 428 on modern\n *  (\"stores-v3\") sites. For the V3 visitor read use `getStoreCategory` (./display). */",
-        "decl": "export function getCollection(collectionId: string): Promise<WixGetCollectionResponse>;",
+        "decl": "export function getCollection(collectionId: string, options?: WixCallOptions): Promise<WixGetCollectionResponse>;",
         "http": "GET /stores/v1/collections/{…}?includeNumberOfProducts=true"
       },
       {
         "name": "queryCollections",
         "kind": "function",
         "jsdoc": "/** ⚠️ Catalog **V1 only**: `/stores/v1/collections/query` returns HTTP 428 on modern\n *  (\"stores-v3\") sites. For the V3 visitor read use `queryStoreCategories` (./display). */",
-        "decl": "export function queryCollections(req: WixQueryCollectionsRequest = {} as WixQueryCollectionsRequest): Promise<WixQueryCollectionsResponse>;",
+        "decl": "export function queryCollections(req: WixQueryCollectionsRequest = {} as WixQueryCollectionsRequest, options?: WixCallOptions): Promise<WixQueryCollectionsResponse>;",
         "http": "POST /stores/v1/collections/query"
       },
       {
@@ -25903,14 +26017,14 @@
         "name": "queryStoreCategories",
         "kind": "function",
         "jsdoc": "/** V3 visitor read: list store categories (the V3 replacement for `queryCollections`).\n *  POST /categories/v1/categories/query — `treeReference.appNamespace` is REQUIRED. */",
-        "decl": "export function queryStoreCategories(limit = 50, cursor?: string): Promise<StoreCategoriesResponse>;",
+        "decl": "export function queryStoreCategories(limit = 50, cursor?: string, options?: WixCallOptions): Promise<StoreCategoriesResponse>;",
         "http": "POST /categories/v1/categories/query"
       },
       {
         "name": "getStoreCategory",
         "kind": "function",
         "jsdoc": "/** V3 visitor read: one store category by id (the V3 replacement for `getCollection`).\n *  GET /categories/v1/categories/{id} — `treeReference.appNamespace` passed as a query param. */",
-        "decl": "export function getStoreCategory(categoryId: string): Promise<StoreGetCategoryResponse>;",
+        "decl": "export function getStoreCategory(categoryId: string, options?: WixCallOptions): Promise<StoreGetCategoryResponse>;",
         "http": "GET /categories/v1/categories/{…}?treeReference.appNamespace={…}&fields=DESCRIPTION"
       },
       {
@@ -25932,6 +26046,12 @@
     "source": "stdlib/wix-sdk/table-reservations/src/index.ts",
     "description": "Restaurant table reservations",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "WixReservation",
         "kind": "interface",
@@ -25954,7 +26074,7 @@
         "name": "queryReservations",
         "kind": "function",
         "jsdoc": "/** POST /table-reservations/reservations/v1/reservations/query — list reservations. */",
-        "decl": "export function queryReservations(query: WixReservationQuery): Promise<WixQueryReservationsResponse>;",
+        "decl": "export function queryReservations(query: WixReservationQuery, readOptions?: WixCallOptions): Promise<WixQueryReservationsResponse>;",
         "http": "POST /table-reservations/reservations/v1/reservations/query"
       },
       {
@@ -25967,7 +26087,7 @@
         "name": "getReservation",
         "kind": "function",
         "jsdoc": "/** GET /table-reservations/reservations/v1/reservations/{id} — single reservation (proto GetReservation; perm RESERVATION_READ). */",
-        "decl": "export function getReservation(reservationId: string): Promise<WixGetReservationResponse>;",
+        "decl": "export function getReservation(reservationId: string, readOptions?: WixCallOptions): Promise<WixGetReservationResponse>;",
         "http": "GET /table-reservations/reservations/v1/reservations/{…}"
       },
       {
@@ -26000,7 +26120,7 @@
         "name": "listReservationLocations",
         "kind": "function",
         "jsdoc": "/** GET /table-reservations/reservation-locations/v1/reservation-locations — up to\n *  100 locations (proto ListReservationLocations; perm RESERVATION_LOCATION_READ). */",
-        "decl": "export function listReservationLocations(): Promise<WixListReservationLocationsResponse>;",
+        "decl": "export function listReservationLocations(readOptions?: WixCallOptions): Promise<WixListReservationLocationsResponse>;",
         "http": "GET /table-reservations/reservation-locations/v1/reservation-locations"
       },
       {
@@ -26030,6 +26150,12 @@
     "source": "stdlib/wix-sdk/users/src/index.ts",
     "description": "Current Wix user / account profile",
     "api": [
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
+      },
       {
         "name": "WixUserProfile",
         "kind": "interface",
@@ -26046,7 +26172,7 @@
         "name": "getMyData",
         "kind": "function",
         "jsdoc": "/** The signed-in Owner's account profile (account-level; member cookie auth).\n *  `includeProfile=true` adds `profile.{firstName,lastName}` — the real display\n *  name (e.g. \"BookingsOwner Mr Bin\"); without it only `userName` is returned.\n *\n *  NATIVE-ONLY: this hits `users.wix.com` (an account/owner host off the\n *  wixapis.com gateway) with the member cookie. It works on device, but on the\n *  WEB serve-plane preview the visitor bridge is host-locked to wixapis.com with\n *  no owner rung (RFC 0049), so this call is refused there with a typed\n *  `501 webwix_owner_only` (previously a confusing `400 absolute_urls_not_allowed`,\n *  #666). A visitor-token web app should treat an empty/failed result as\n *  \"not signed in\" and degrade accordingly.\n *\n *  VISITOR SCOPE: this is the signed-in ACCOUNT's own profile — at anonymous /\n *  visitor scope it returns nothing, so a \"member profile\"/roster screen built on\n *  it silently falls back to guest (#676). For a visitor-facing member directory,\n *  query the Members Area instead: `@himalaya/wix-members` `queryMembers`\n *  (`POST /members/v1/members/query`), which surfaces the real roster. */",
-        "decl": "export function getMyData(): Promise<WixMyData>;"
+        "decl": "export function getMyData(options?: WixCallOptions): Promise<WixMyData>;"
       },
       {
         "name": "displayName",
@@ -26155,7 +26281,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` reads a business other than the app's active one. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "WixVideoPricing",
@@ -26324,7 +26450,7 @@
         "name": "WixCallOptions",
         "kind": "interface",
         "jsdoc": "/** Per-call options. `site` addresses ONE call at a business other than the app's\n *  active one, so a cross-site rollup can read several businesses concurrently without\n *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,\n *  byte-identical to a call that never passed options.\n *\n *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so\n *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */",
-        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+        "decl": "export interface WixCallOptions {\n  site?: string;\n  /** Explicit cache reads never touch the network; reload waits for a server response. */\n  cache?: \"default\" | \"only-if-cached\" | \"reload\";\n  onCacheResult?: (metadata: {\n    source: \"cache\" | \"network\";\n    fetchedAt: number;\n    expiresAt?: number;\n    cacheable: boolean;\n  }) => void;\n}"
       },
       {
         "name": "wixCall",