@cloudparse/up-miniapps-sdk 0.9.0 → 0.11.0

package/dist/index.d.cts

@@ -157,6 +157,27 @@ interface INetworkOptions {
     body?: unknown;
     /** Custom HTTP headers. */
     headers?: Record<string, string>;
+    /**
+     * Real production bug, found live: the shell's NETWORK_REQUEST handler
+     * (`up/shell`'s `use-miniapp-bridge.ts`) hard-caps every proxied request
+     * at a fixed 5s timeout (`fetch-with-timeout.ts`'s `DEFAULT_TIMEOUT_MS`)
+     * with no way for a mini-app to ask for more — a genuinely slow-but-legit
+     * backend call (e.g. an LLM chat turn routinely taking 3-7s+) gets
+     * silently aborted mid-flight ("context canceled" server-side) well
+     * before its own, longer server-side timeout would ever fire. Optional
+     * override, in milliseconds — omit for the shell's existing 5s default.
+     * Only meaningful for `sdk.network.request()`/host-proxied calls; has no
+     * effect on any other bridge message type. Governs TWO independent
+     * ceilings that must move together, not just the shell's own fetch: the
+     * shell's `fetchWithTimeout` call (the actual HTTP request) AND this
+     * bridge's own client-side promise wait for the native reply
+     * (`Bridge.send`'s own `timeoutMs`, default 30s — see `sdk.ts`'s
+     * `network.request`, which forwards this same value there too). Setting
+     * this only high enough for the first would still let the second time out
+     * first on anything over ~30s and silently reject with a generic "Bridge
+     * request timeout" instead of ever reaching the real HTTP response.
+     */
+    timeoutMs?: number;
 }
 /**
  * Response from a network proxy request.
@@ -377,6 +398,20 @@ interface ScrollConfig {
         loadingMore?: boolean;
     };
 }
+/**
+ * Which system bars (status bar / navigation bar) to hide while this
+ * Mini-App is active. Any key omitted leaves that bar's current
+ * (host-driven) state untouched — pass only the bar(s) you want to
+ * override. The host resets to its own default the moment this Mini-App
+ * is no longer the active screen (exit, or the app being backgrounded/
+ * locked) — an override never outlives this Mini-App's own session.
+ */
+interface SystemBarsHiddenConfig {
+    /** Hide/show the physical status bar. */
+    statusBar?: boolean;
+    /** Hide/show the physical navigation bar (3-button or gesture bar). */
+    navigationBar?: boolean;
+}
 /**
  * Result of a `sdk.media.saveImage` call.
  */
@@ -637,6 +672,10 @@ type BridgeMessageType = {
     type: "SET_SCROLL_CONFIG";
     payload: ScrollConfig;
     callbackId: string;
+} | {
+    type: "SET_SYSTEM_BARS_HIDDEN";
+    payload: SystemBarsHiddenConfig;
+    callbackId: string;
 } | {
     type: "SDK_ROUTING_GETROUTE";
     payload: {
@@ -1550,6 +1589,19 @@ declare class MiniAppSDK {
         /**
          * Performs a network request via the host shell.
          * @param options Request method, URL, headers, and body.
+         *
+         * Real bug, caught by reviewer-strict: `options.timeoutMs` only ever
+         * reached the shell's own `fetchWithTimeout` call — this `bridge.send`
+         * has an entirely separate client-side promise timeout (its own
+         * `timeoutMs` param, default 30000ms) waiting for the native reply,
+         * previously left at that default regardless of what `options.timeoutMs`
+         * said. A slow-but-legitimate call given a longer `options.timeoutMs`
+         * (e.g. 50000ms for an LLM-backed endpoint) would still get this
+         * bridge-level promise rejected ("Bridge request timeout") at 30s,
+         * reintroducing the exact same "aborted before it could finish" bug
+         * this field exists to fix, one layer up. Forwarding it here means both
+         * ceilings move together; omitted (`undefined`, every other caller)
+         * falls through to `send`'s own unchanged 30000ms default.
          */
         request: <T = unknown>(options: INetworkOptions) => Promise<INetworkResponse<T>>;
     }>;
@@ -1624,6 +1676,18 @@ declare class MiniAppSDK {
          * @param config Scroll configuration for top/bottom detection.
          */
         setScrollConfig: (config: ScrollConfig) => Promise<void>;
+        /**
+         * Shows or hides the host's status bar / navigation bar while this
+         * Mini-App is active — e.g. an immersive full-bleed map or video view.
+         * Merges into any existing override: a key you omit keeps its current
+         * value, pass `false` explicitly to un-hide a bar you'd previously
+         * hidden. The host resets any override back to its own default the
+         * moment this Mini-App stops being the active screen (exit, or the
+         * app backgrounding/locking) — it never outlives this session and can
+         * never keep a bar visible during an actual lock/security screen.
+         * @param config Which bars to hide (`true`) or explicitly show (`false`).
+         */
+        setSystemBarsHidden: (config: SystemBarsHiddenConfig) => Promise<void>;
     }>;
     /**
      * Debug controls
@@ -1732,7 +1796,13 @@ interface ApiServiceClient {
     /** Current WebSocket backend URL, same resolution order as `baseUrl` but reading the dedicated ws fields instead. `undefined` if neither the shell nor `defaultWsBackendUrl` ever supplied one. */
     readonly wsUrl: string | undefined;
     get<T = unknown>(path: string): Promise<INetworkResponse<T>>;
-    post<T = unknown>(path: string, body?: unknown): Promise<INetworkResponse<T>>;
+    /**
+     * `timeoutMs` overrides the shell's default NETWORK_REQUEST timeout (5s,
+     * see `INetworkOptions.timeoutMs`'s own doc comment) — pass it for a call
+     * to a backend route that's legitimately slower than a typical REST call
+     * (e.g. an LLM-backed endpoint), never as a blanket "just in case" bump.
+     */
+    post<T = unknown>(path: string, body?: unknown, timeoutMs?: number): Promise<INetworkResponse<T>>;
     patch<T = unknown>(path: string, body?: unknown): Promise<INetworkResponse<T>>;
     delete(path: string): Promise<INetworkResponse<void>>;
     graphqlQuery<T = unknown>(query: string, variables?: Record<string, unknown>): Promise<INetworkResponse<{
@@ -1953,4 +2023,4 @@ interface BroadcastWsServiceClient<TMessage extends WsMessage = WsMessage> {
 declare function createWsService<TMessage extends WsMessage = WsMessage>(options: CreateChannelWsServiceOptions<TMessage>): WsServiceClient<TMessage>;
 declare function createWsService<TMessage extends WsMessage = WsMessage>(options: CreateBroadcastWsServiceOptions<TMessage>): BroadcastWsServiceClient<TMessage>;
 
-export { type ApiServiceClient, type BridgeMessageType, BridgeMocker, type BridgeMockerProps, type BroadcastWsServiceClient, type CenterCallbackParams, type CreateApiServiceOptions, type CreateBroadcastWsServiceOptions, type CreateChannelWsServiceOptions, type CreateWsServiceOptions, type CustomControl, DebugConsole, type DebugConsoleProps, type DeclarativeJourneyOptions, type DrawerState, type EtaData, type FidelityTransactionTypeType, type FlyToParams, GeolocationEvent, GlobalEvent, type HapticStyleType, type IAchievement, type IBridgeEnvelope, type IContextState, type IEdgeInsets, type IFidelityBalance, type IFidelityHistoryParams, type IFidelityTransaction, type IGenerateQrCodeOptions, type IInitializationOptions, type IInitializationResponse, type ILocationData, type INetworkOptions, type INetworkResponse, type IPaymentRequest, type IPickImageResult, type ISaveImageResult, type IUserProfile, type LiveRoutingOptions, type LiveRoutingResult, type LocationStreamConfig, Map, MapControls, MapControlsContext, type MapControlsProps, type MapControlsState, type MapInsets, MapMenu, MapMenuDivider, type MapMenuDividerProps, MapMenuFooter, type MapMenuFooterProps, MapMenuItem, type MapMenuItemProps, type MapMenuProps, MapMenuTitle, type MapMenuTitleProps, type MapProps, type MenuItem, MiniAppSDK, MockLocationContext, type MockLocationContextType, type NetworkMethodType, type POI, PullToRefresh, type PullToRefreshIndicatorState, type PullToRefreshProps, QRScanner, type QRScannerProps, RouteLayer, type RouteLayerProps, RouteRequest, RouteResponse, RouteStep, type SDKEvent, SDKMapProvider, SDKProvider, type SDKProviderProps, type ScrollConfig, type StreamAccelerometerData, type StreamHeadingData, type StreamLocationData, type StreamUpdatePayload, type SwipeAxisPriority, SwipeCarousel, type SwipeCarouselItem, type SwipeCarouselProps, type SwipeCarouselVerticalDragConfig, UIEvent, type UseJourneyOptions, type UseJourneyResult, type UserLocationState, type WsConnectionStatus, type WsMessage, type WsServiceClient, createApiService, createWsService, sdk as default, renderMap, sdk, useIsMocked, useJourney, useLiveRouting, useMapControls, useMockLocation, useRoute, useTapAction, useTrimmedRoute, useUserLocation };
+export { type ApiServiceClient, type BridgeMessageType, BridgeMocker, type BridgeMockerProps, type BroadcastWsServiceClient, type CenterCallbackParams, type CreateApiServiceOptions, type CreateBroadcastWsServiceOptions, type CreateChannelWsServiceOptions, type CreateWsServiceOptions, type CustomControl, DebugConsole, type DebugConsoleProps, type DeclarativeJourneyOptions, type DrawerState, type EtaData, type FidelityTransactionTypeType, type FlyToParams, GeolocationEvent, GlobalEvent, type HapticStyleType, type IAchievement, type IBridgeEnvelope, type IContextState, type IEdgeInsets, type IFidelityBalance, type IFidelityHistoryParams, type IFidelityTransaction, type IGenerateQrCodeOptions, type IInitializationOptions, type IInitializationResponse, type ILocationData, type INetworkOptions, type INetworkResponse, type IPaymentRequest, type IPickImageResult, type ISaveImageResult, type IUserProfile, type LiveRoutingOptions, type LiveRoutingResult, type LocationStreamConfig, Map, MapControls, MapControlsContext, type MapControlsProps, type MapControlsState, type MapInsets, MapMenu, MapMenuDivider, type MapMenuDividerProps, MapMenuFooter, type MapMenuFooterProps, MapMenuItem, type MapMenuItemProps, type MapMenuProps, MapMenuTitle, type MapMenuTitleProps, type MapProps, type MenuItem, MiniAppSDK, MockLocationContext, type MockLocationContextType, type NetworkMethodType, type POI, PullToRefresh, type PullToRefreshIndicatorState, type PullToRefreshProps, QRScanner, type QRScannerProps, RouteLayer, type RouteLayerProps, RouteRequest, RouteResponse, RouteStep, type SDKEvent, SDKMapProvider, SDKProvider, type SDKProviderProps, type ScrollConfig, type StreamAccelerometerData, type StreamHeadingData, type StreamLocationData, type StreamUpdatePayload, type SwipeAxisPriority, SwipeCarousel, type SwipeCarouselItem, type SwipeCarouselProps, type SwipeCarouselVerticalDragConfig, type SystemBarsHiddenConfig, UIEvent, type UseJourneyOptions, type UseJourneyResult, type UserLocationState, type WsConnectionStatus, type WsMessage, type WsServiceClient, createApiService, createWsService, sdk as default, renderMap, sdk, useIsMocked, useJourney, useLiveRouting, useMapControls, useMockLocation, useRoute, useTapAction, useTrimmedRoute, useUserLocation };

package/dist/index.d.ts

@@ -157,6 +157,27 @@ interface INetworkOptions {
     body?: unknown;
     /** Custom HTTP headers. */
     headers?: Record<string, string>;
+    /**
+     * Real production bug, found live: the shell's NETWORK_REQUEST handler
+     * (`up/shell`'s `use-miniapp-bridge.ts`) hard-caps every proxied request
+     * at a fixed 5s timeout (`fetch-with-timeout.ts`'s `DEFAULT_TIMEOUT_MS`)
+     * with no way for a mini-app to ask for more — a genuinely slow-but-legit
+     * backend call (e.g. an LLM chat turn routinely taking 3-7s+) gets
+     * silently aborted mid-flight ("context canceled" server-side) well
+     * before its own, longer server-side timeout would ever fire. Optional
+     * override, in milliseconds — omit for the shell's existing 5s default.
+     * Only meaningful for `sdk.network.request()`/host-proxied calls; has no
+     * effect on any other bridge message type. Governs TWO independent
+     * ceilings that must move together, not just the shell's own fetch: the
+     * shell's `fetchWithTimeout` call (the actual HTTP request) AND this
+     * bridge's own client-side promise wait for the native reply
+     * (`Bridge.send`'s own `timeoutMs`, default 30s — see `sdk.ts`'s
+     * `network.request`, which forwards this same value there too). Setting
+     * this only high enough for the first would still let the second time out
+     * first on anything over ~30s and silently reject with a generic "Bridge
+     * request timeout" instead of ever reaching the real HTTP response.
+     */
+    timeoutMs?: number;
 }
 /**
  * Response from a network proxy request.
@@ -377,6 +398,20 @@ interface ScrollConfig {
         loadingMore?: boolean;
     };
 }
+/**
+ * Which system bars (status bar / navigation bar) to hide while this
+ * Mini-App is active. Any key omitted leaves that bar's current
+ * (host-driven) state untouched — pass only the bar(s) you want to
+ * override. The host resets to its own default the moment this Mini-App
+ * is no longer the active screen (exit, or the app being backgrounded/
+ * locked) — an override never outlives this Mini-App's own session.
+ */
+interface SystemBarsHiddenConfig {
+    /** Hide/show the physical status bar. */
+    statusBar?: boolean;
+    /** Hide/show the physical navigation bar (3-button or gesture bar). */
+    navigationBar?: boolean;
+}
 /**
  * Result of a `sdk.media.saveImage` call.
  */
@@ -637,6 +672,10 @@ type BridgeMessageType = {
     type: "SET_SCROLL_CONFIG";
     payload: ScrollConfig;
     callbackId: string;
+} | {
+    type: "SET_SYSTEM_BARS_HIDDEN";
+    payload: SystemBarsHiddenConfig;
+    callbackId: string;
 } | {
     type: "SDK_ROUTING_GETROUTE";
     payload: {
@@ -1550,6 +1589,19 @@ declare class MiniAppSDK {
         /**
          * Performs a network request via the host shell.
          * @param options Request method, URL, headers, and body.
+         *
+         * Real bug, caught by reviewer-strict: `options.timeoutMs` only ever
+         * reached the shell's own `fetchWithTimeout` call — this `bridge.send`
+         * has an entirely separate client-side promise timeout (its own
+         * `timeoutMs` param, default 30000ms) waiting for the native reply,
+         * previously left at that default regardless of what `options.timeoutMs`
+         * said. A slow-but-legitimate call given a longer `options.timeoutMs`
+         * (e.g. 50000ms for an LLM-backed endpoint) would still get this
+         * bridge-level promise rejected ("Bridge request timeout") at 30s,
+         * reintroducing the exact same "aborted before it could finish" bug
+         * this field exists to fix, one layer up. Forwarding it here means both
+         * ceilings move together; omitted (`undefined`, every other caller)
+         * falls through to `send`'s own unchanged 30000ms default.
          */
         request: <T = unknown>(options: INetworkOptions) => Promise<INetworkResponse<T>>;
     }>;
@@ -1624,6 +1676,18 @@ declare class MiniAppSDK {
          * @param config Scroll configuration for top/bottom detection.
          */
         setScrollConfig: (config: ScrollConfig) => Promise<void>;
+        /**
+         * Shows or hides the host's status bar / navigation bar while this
+         * Mini-App is active — e.g. an immersive full-bleed map or video view.
+         * Merges into any existing override: a key you omit keeps its current
+         * value, pass `false` explicitly to un-hide a bar you'd previously
+         * hidden. The host resets any override back to its own default the
+         * moment this Mini-App stops being the active screen (exit, or the
+         * app backgrounding/locking) — it never outlives this session and can
+         * never keep a bar visible during an actual lock/security screen.
+         * @param config Which bars to hide (`true`) or explicitly show (`false`).
+         */
+        setSystemBarsHidden: (config: SystemBarsHiddenConfig) => Promise<void>;
     }>;
     /**
      * Debug controls
@@ -1732,7 +1796,13 @@ interface ApiServiceClient {
     /** Current WebSocket backend URL, same resolution order as `baseUrl` but reading the dedicated ws fields instead. `undefined` if neither the shell nor `defaultWsBackendUrl` ever supplied one. */
     readonly wsUrl: string | undefined;
     get<T = unknown>(path: string): Promise<INetworkResponse<T>>;
-    post<T = unknown>(path: string, body?: unknown): Promise<INetworkResponse<T>>;
+    /**
+     * `timeoutMs` overrides the shell's default NETWORK_REQUEST timeout (5s,
+     * see `INetworkOptions.timeoutMs`'s own doc comment) — pass it for a call
+     * to a backend route that's legitimately slower than a typical REST call
+     * (e.g. an LLM-backed endpoint), never as a blanket "just in case" bump.
+     */
+    post<T = unknown>(path: string, body?: unknown, timeoutMs?: number): Promise<INetworkResponse<T>>;
     patch<T = unknown>(path: string, body?: unknown): Promise<INetworkResponse<T>>;
     delete(path: string): Promise<INetworkResponse<void>>;
     graphqlQuery<T = unknown>(query: string, variables?: Record<string, unknown>): Promise<INetworkResponse<{
@@ -1953,4 +2023,4 @@ interface BroadcastWsServiceClient<TMessage extends WsMessage = WsMessage> {
 declare function createWsService<TMessage extends WsMessage = WsMessage>(options: CreateChannelWsServiceOptions<TMessage>): WsServiceClient<TMessage>;
 declare function createWsService<TMessage extends WsMessage = WsMessage>(options: CreateBroadcastWsServiceOptions<TMessage>): BroadcastWsServiceClient<TMessage>;
 
-export { type ApiServiceClient, type BridgeMessageType, BridgeMocker, type BridgeMockerProps, type BroadcastWsServiceClient, type CenterCallbackParams, type CreateApiServiceOptions, type CreateBroadcastWsServiceOptions, type CreateChannelWsServiceOptions, type CreateWsServiceOptions, type CustomControl, DebugConsole, type DebugConsoleProps, type DeclarativeJourneyOptions, type DrawerState, type EtaData, type FidelityTransactionTypeType, type FlyToParams, GeolocationEvent, GlobalEvent, type HapticStyleType, type IAchievement, type IBridgeEnvelope, type IContextState, type IEdgeInsets, type IFidelityBalance, type IFidelityHistoryParams, type IFidelityTransaction, type IGenerateQrCodeOptions, type IInitializationOptions, type IInitializationResponse, type ILocationData, type INetworkOptions, type INetworkResponse, type IPaymentRequest, type IPickImageResult, type ISaveImageResult, type IUserProfile, type LiveRoutingOptions, type LiveRoutingResult, type LocationStreamConfig, Map, MapControls, MapControlsContext, type MapControlsProps, type MapControlsState, type MapInsets, MapMenu, MapMenuDivider, type MapMenuDividerProps, MapMenuFooter, type MapMenuFooterProps, MapMenuItem, type MapMenuItemProps, type MapMenuProps, MapMenuTitle, type MapMenuTitleProps, type MapProps, type MenuItem, MiniAppSDK, MockLocationContext, type MockLocationContextType, type NetworkMethodType, type POI, PullToRefresh, type PullToRefreshIndicatorState, type PullToRefreshProps, QRScanner, type QRScannerProps, RouteLayer, type RouteLayerProps, RouteRequest, RouteResponse, RouteStep, type SDKEvent, SDKMapProvider, SDKProvider, type SDKProviderProps, type ScrollConfig, type StreamAccelerometerData, type StreamHeadingData, type StreamLocationData, type StreamUpdatePayload, type SwipeAxisPriority, SwipeCarousel, type SwipeCarouselItem, type SwipeCarouselProps, type SwipeCarouselVerticalDragConfig, UIEvent, type UseJourneyOptions, type UseJourneyResult, type UserLocationState, type WsConnectionStatus, type WsMessage, type WsServiceClient, createApiService, createWsService, sdk as default, renderMap, sdk, useIsMocked, useJourney, useLiveRouting, useMapControls, useMockLocation, useRoute, useTapAction, useTrimmedRoute, useUserLocation };
+export { type ApiServiceClient, type BridgeMessageType, BridgeMocker, type BridgeMockerProps, type BroadcastWsServiceClient, type CenterCallbackParams, type CreateApiServiceOptions, type CreateBroadcastWsServiceOptions, type CreateChannelWsServiceOptions, type CreateWsServiceOptions, type CustomControl, DebugConsole, type DebugConsoleProps, type DeclarativeJourneyOptions, type DrawerState, type EtaData, type FidelityTransactionTypeType, type FlyToParams, GeolocationEvent, GlobalEvent, type HapticStyleType, type IAchievement, type IBridgeEnvelope, type IContextState, type IEdgeInsets, type IFidelityBalance, type IFidelityHistoryParams, type IFidelityTransaction, type IGenerateQrCodeOptions, type IInitializationOptions, type IInitializationResponse, type ILocationData, type INetworkOptions, type INetworkResponse, type IPaymentRequest, type IPickImageResult, type ISaveImageResult, type IUserProfile, type LiveRoutingOptions, type LiveRoutingResult, type LocationStreamConfig, Map, MapControls, MapControlsContext, type MapControlsProps, type MapControlsState, type MapInsets, MapMenu, MapMenuDivider, type MapMenuDividerProps, MapMenuFooter, type MapMenuFooterProps, MapMenuItem, type MapMenuItemProps, type MapMenuProps, MapMenuTitle, type MapMenuTitleProps, type MapProps, type MenuItem, MiniAppSDK, MockLocationContext, type MockLocationContextType, type NetworkMethodType, type POI, PullToRefresh, type PullToRefreshIndicatorState, type PullToRefreshProps, QRScanner, type QRScannerProps, RouteLayer, type RouteLayerProps, RouteRequest, RouteResponse, RouteStep, type SDKEvent, SDKMapProvider, SDKProvider, type SDKProviderProps, type ScrollConfig, type StreamAccelerometerData, type StreamHeadingData, type StreamLocationData, type StreamUpdatePayload, type SwipeAxisPriority, SwipeCarousel, type SwipeCarouselItem, type SwipeCarouselProps, type SwipeCarouselVerticalDragConfig, type SystemBarsHiddenConfig, UIEvent, type UseJourneyOptions, type UseJourneyResult, type UserLocationState, type WsConnectionStatus, type WsMessage, type WsServiceClient, createApiService, createWsService, sdk as default, renderMap, sdk, useIsMocked, useJourney, useLiveRouting, useMapControls, useMockLocation, useRoute, useTapAction, useTrimmedRoute, useUserLocation };

package/dist/index.js

@@ -3441,7 +3441,7 @@ var loadImage2 = (src) => new Promise((resolve, reject) => {
 });
 
 // package.json
-var version = "0.9.0";
+var version = "0.11.0";
 
 // src/sdk.ts
 function deepFreeze(obj) {
@@ -3635,9 +3635,22 @@ var MiniAppSDK = class {
     /**
      * Performs a network request via the host shell.
      * @param options Request method, URL, headers, and body.
+     *
+     * Real bug, caught by reviewer-strict: `options.timeoutMs` only ever
+     * reached the shell's own `fetchWithTimeout` call — this `bridge.send`
+     * has an entirely separate client-side promise timeout (its own
+     * `timeoutMs` param, default 30000ms) waiting for the native reply,
+     * previously left at that default regardless of what `options.timeoutMs`
+     * said. A slow-but-legitimate call given a longer `options.timeoutMs`
+     * (e.g. 50000ms for an LLM-backed endpoint) would still get this
+     * bridge-level promise rejected ("Bridge request timeout") at 30s,
+     * reintroducing the exact same "aborted before it could finish" bug
+     * this field exists to fix, one layer up. Forwarding it here means both
+     * ceilings move together; omitted (`undefined`, every other caller)
+     * falls through to `send`'s own unchanged 30000ms default.
      */
     request: async (options) => {
-      return this.bridge.send("NETWORK_REQUEST", options);
+      return this.bridge.send("NETWORK_REQUEST", options, options.timeoutMs);
     }
   });
   /**
@@ -3709,7 +3722,19 @@ var MiniAppSDK = class {
      * Configures native scroll behaviors like Pull-to-Refresh and Infinite Scroll.
      * @param config Scroll configuration for top/bottom detection.
      */
-    setScrollConfig: (config) => this.bridge.send("SET_SCROLL_CONFIG", config)
+    setScrollConfig: (config) => this.bridge.send("SET_SCROLL_CONFIG", config),
+    /**
+     * Shows or hides the host's status bar / navigation bar while this
+     * Mini-App is active — e.g. an immersive full-bleed map or video view.
+     * Merges into any existing override: a key you omit keeps its current
+     * value, pass `false` explicitly to un-hide a bar you'd previously
+     * hidden. The host resets any override back to its own default the
+     * moment this Mini-App stops being the active screen (exit, or the
+     * app backgrounding/locking) — it never outlives this session and can
+     * never keep a bar visible during an actual lock/security screen.
+     * @param config Which bars to hide (`true`) or explicitly show (`false`).
+     */
+    setSystemBarsHidden: (config) => this.bridge.send("SET_SYSTEM_BARS_HIDDEN", config)
   });
   /**
    * Debug controls
@@ -4279,7 +4304,7 @@ var BridgeMocker = ({
           transactionId: `tx_${Math.random().toString(36).slice(2)}`
         });
       }
-      if (type === "TRIGGER_HAPTIC" || type === "EXIT" || type === "UPDATE_CONTEXT") {
+      if (type === "TRIGGER_HAPTIC" || type === "EXIT" || type === "UPDATE_CONTEXT" || type === "SET_SYSTEM_BARS_HIDDEN") {
         return Promise.resolve({ success: true });
       }
       return originalSend(type, payload);
@@ -5406,10 +5431,11 @@ function createApiService(options) {
       method: "PATCH",
       url: buildUrl(getBaseUrl(), path)
     }),
-    post: (path, body) => sdk.network.request({
+    post: (path, body, timeoutMs) => sdk.network.request({
       body,
       headers: { "Content-Type": "application/json" },
       method: "POST",
+      timeoutMs,
       url: buildUrl(getBaseUrl(), path)
     }),
     get wsUrl() {