@grabjs/superapp-sdk 2.0.0-beta.51 → 2.0.0-beta.54

package/dist/index.d.ts

@@ -5,6 +5,9 @@ import * as v from 'valibot';
 /**
  * Request parameters for initiating an OAuth2 authorization flow with PKCE.
  *
+ * @group Modules
+ * @category Identity
+ *
  * @example
  * **Production environment with redirect mode:**
  * ```typescript
@@ -36,6 +39,9 @@ export declare type AuthorizeRequest = InferOutput<typeof AuthorizeRequestSchema
 /**
  * Valibot schema for {@link AuthorizeRequest}.
  *
+ * @group Modules
+ * @category Identity
+ *
  * @public
  */
 export declare const AuthorizeRequestSchema: v.ObjectSchema<{
@@ -49,6 +55,9 @@ export declare const AuthorizeRequestSchema: v.ObjectSchema<{
 /**
  * Response when initiating an authorization flow.
  *
+ * @group Modules
+ * @category Identity
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Authorization completed successfully (native in_place flow). The `result` contains the authorization code, state, and PKCE artifacts (`codeVerifier`, `nonce`, `redirectUri`).
@@ -66,6 +75,9 @@ export declare type AuthorizeResponse = InferOutput<typeof AuthorizeResponseSche
 /**
  * Valibot schema for {@link AuthorizeResponse}.
  *
+ * @group Modules
+ * @category Identity
+ *
  * @public
  */
 export declare const AuthorizeResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -99,6 +111,9 @@ export declare const AuthorizeResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result object for the authorization flow.
  * Contains the authorization code, state, and PKCE artifacts when native in_place flow completes successfully.
  *
+ * @group Modules
+ * @category Identity
+ *
  * @example
  * ```typescript
  * {
@@ -117,6 +132,9 @@ export declare type AuthorizeResult = InferOutput<typeof AuthorizeResultSchema>;
 /**
  * Valibot schema for {@link AuthorizeResult}.
  *
+ * @group Modules
+ * @category Identity
+ *
  * @public
  */
 export declare const AuthorizeResultSchema: v.ObjectSchema<{
@@ -130,6 +148,9 @@ export declare const AuthorizeResultSchema: v.ObjectSchema<{
 /**
  * Response when triggering platform back navigation.
  *
+ * @group Modules
+ * @category Platform
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Back navigation triggered successfully.
@@ -143,6 +164,9 @@ export declare type BackResponse = InferOutput<typeof BackResponseSchema>;
 /**
  * Valibot schema for {@link BackResponse}.
  *
+ * @group Modules
+ * @category Platform
+ *
  * @public
  */
 export declare const BackResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -159,32 +183,37 @@ export declare const BackResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result when triggering platform back navigation.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Platform
+ *
  * @public
  */
 export declare type BackResult = void;
 
 /**
- * Base class for all JSBridge modules.
+ * Base class for all modules.
+ *
+ * @group Core
  *
  * @remarks
- * On construction, the class wraps the JSBridge module on `window` (e.g., `WrappedContainerModule`).
+ * On construction, the class wraps the module on `window` (e.g., `WrappedContainerModule`).
  * This code must run on the Grab SuperApp's webview to function correctly.
  *
  * @public
  */
 export declare class BaseModule {
     /**
-     * The module name used to identify the JSBridge module.
+     * The module name.
      */
     private readonly name;
     /**
-     * Logger scoped to this module (e.g. `[SuperAppSDK][ContainerModule.setTitle] ...`).
+     * Logger scoped to this module.
      *
      * @protected
      */
     protected readonly logger: Logger;
     /**
-     * Returns the wrapped JSBridge module from the global `window` object.
+     * Returns the wrapped module from the global `window` object.
      *
      * @returns The wrapped module instance with native method bindings.
      *
@@ -195,7 +224,7 @@ export declare class BaseModule {
      * Creates a new module instance and wraps it on the global `window` object.
      *
      * @param moduleName - The name of the module (e.g., "ContainerModule", "ProfileModule").
-     * @throws Error when the bridge SDK fails to wrap the module.
+     * @throws Error when the module fails to initialize.
      */
     constructor(moduleName: string);
     /**
@@ -212,10 +241,9 @@ export declare class BaseModule {
      * Checks whether the current app version supports this method.
      *
      * @remarks
-     * Returns 501 if not running in the Grab app, 426 if the version check fails,
-     * or `null` if the method is supported.
+     * Returns `501` status code if not running in the Grab app, `426` status code if the version check fails. Otherwise, returns `null`.
      *
-     * @param isSupported - A function receiving the detected app info, returning true if supported.
+     * @param isSupported - A function receiving the detected app info, returning `true` if supported.
      * @returns An error response, or `null` if supported.
      *
      * @protected
@@ -228,112 +256,47 @@ export declare class BaseModule {
         error: string;
     } | null;
     /**
-     * Invokes a JSBridge method.
+     * Invokes a method.
      *
      * @remarks
-     * - Always checks if running in Grab app (returns 501 if not).
+     * - Always checks if running in Grab app (returns `501` status code if not).
      * - All errors are reported via the `status_code` field; this method never rejects.
-     * - For streaming methods, use `invokeStream` instead.
      *
      * @param options - The invoke options including method name and params.
-     * @returns A promise resolving to the JSBridge response.
+     * @returns A promise resolving to the SDK response.
      *
      * @protected
      */
-    protected invoke(options: InvokeOptions): Promise<BridgeResponse>;
+    protected invoke(options: ModuleInvokeOptions): Promise<SDKResponse>;
     /**
-     * Creates a BridgeStream that immediately emits an error response.
-     * Used for 501, 426, and 500 error scenarios in invokeStream.
+     * Creates a {@link SDKStream} that immediately emits an error response.
      *
-     * @returns A BridgeStream that emits the error and immediately completes.
+     * @returns A {@link SDKStream} that immediately emits an error response.
      *
      * @private
      */
     private createErrorStream;
     /**
-     * Invokes a JSBridge streaming method that returns a `BridgeStream`.
+     * Invokes a streaming method that returns a {@link SDKStream}.
      *
      * @remarks
-     * - Always checks if running in Grab app (returns 501 error response if not).
-     * - Returns a `BridgeStream` that can be subscribed to or awaited for the first value.
+     * - Always checks if running in Grab app (returns `501` status code if not).
+     * - Returns a {@link SDKStream} that can be subscribed to or awaited for the first value.
      * - All errors are reported via error responses in the stream; this method never rejects.
      *
      * @param options - The invoke options including method name and params.
-     * @returns A `BridgeStream` for receiving continuous data from the JSBridge.
+     * @returns A {@link SDKStream} for receiving continuous data.
      *
      * @protected
      */
-    protected invokeStream(options: InvokeOptions): BridgeStream;
+    protected invokeStream(options: ModuleInvokeOptions): SDKStream;
 }
 
 /**
- * Base response type for all JSBridge calls.
- *
- * @remarks
- * Every response has a numeric `status_code`. Success responses (200) carry `result`;
- * error responses (4xx/5xx) carry `error`. Use the type guards ({@link isSuccess},
- * {@link isError}, etc.) to narrow to a specific shape.
- *
- * Per-module response types (e.g., `ScanQRCodeResponse`) are derived from their valibot
- * schemas via `v.InferOutput` and form proper discriminated unions — enabling precise
- * TypeScript narrowing while this base type serves as the internal contract.
- *
- * @public
- */
-export declare type BridgeResponse = {
-    /** HTTP-style status code indicating the outcome of the JSBridge method call */
-    status_code: number;
-    /** The result data from the JSBridge method, present on 200 responses */
-    result?: unknown;
-    /** Error message, present on 4xx/5xx responses */
-    error?: string;
-};
-
-/**
- * A stream for receiving continuous data from JSBridge methods (e.g., location updates).
- *
- * @remarks
- * Provides both Observable-like and Promise-like interfaces:
- * - Use `subscribe()` to receive all values over time
- * - Use `then()` or `await` to receive only the first value
- *
- * Note: Each `subscribe()` call creates a fresh subscription, allowing multiple independent listeners.
- *
- * @typeParam T - The response type emitted by the stream.
- *
- * @public
- */
-export declare type BridgeStream<T extends BridgeResponse = BridgeResponse> = Readonly<{
-    /**
-     * Subscribe to receive stream data.
-     *
-     * @param handlers - Optional callbacks for data (`next`) and completion (`complete`).
-     * @returns A `Subscription` to terminate the stream when needed.
-     */
-    subscribe: (handlers?: BridgeStreamHandlers<T>) => Subscription;
-}> & PromiseLike<T>;
-
-/**
- * Callbacks for handling stream events.
- *
- * @remarks
- * Pass these to `subscribe()` to receive data via `next` and completion via `complete`.
- *
- * @typeParam T - The response type emitted by the stream.
- *
- * @public
- */
-export declare type BridgeStreamHandlers<T extends BridgeResponse = BridgeResponse> = Readonly<{
-    /** Called with each new value from the stream. */
-    next?: (data: T) => unknown;
-    /** Called when the stream ends and no more data will arrive. */
-    complete?: () => unknown;
-}>;
-
-/**
- * JSBridge module for accessing the device camera.
+ * SDK module for accessing the device camera via `JSBridge`.
  *
  * @group Modules
+ * @category Camera
  *
  * @remarks
  * Provides access to native camera functionality including QR code scanning.
@@ -375,7 +338,7 @@ export declare class CameraModule extends BaseModule {
      * // Initialize the camera module
      * const camera = new CameraModule();
      *
-     * // Scan the QR code
+     * // Scan a QR code
      * const response = await camera.scanQRCode({ title: 'Scan Payment QR' });
      *
      * // Handle the response
@@ -407,9 +370,10 @@ export declare class CameraModule extends BaseModule {
 }
 
 /**
- * JSBridge module for triggering native payment flows.
+ * SDK module for triggering native payment flows via `JSBridge`.
  *
  * @group Modules
+ * @category Checkout
  *
  * @remarks
  * Invokes the native Grab checkout/pay component to process payments.
@@ -501,8 +465,11 @@ export declare class CheckoutModule extends BaseModule {
 /**
  * Response when clearing stored authorization artifacts.
  *
+ * @group Modules
+ * @category Identity
+ *
  * @remarks
- * This response returns status code `204` when artifacts are successfully cleared.
+ * This response returns status code `204` when artifacts are cleared successfully.
  *
  * @public
  */
@@ -511,6 +478,9 @@ export declare type ClearAuthorizationArtifactsResponse = InferOutput<typeof Cle
 /**
  * Valibot schema for {@link ClearAuthorizationArtifactsResponse}.
  *
+ * @group Modules
+ * @category Identity
+ *
  * @public
  */
 export declare const ClearAuthorizationArtifactsResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -521,6 +491,9 @@ export declare const ClearAuthorizationArtifactsResponseSchema: v.UnionSchema<[v
  * Result object for clearing authorization artifacts.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Identity
+ *
  * @public
  */
 export declare type ClearAuthorizationArtifactsResult = void;
@@ -528,6 +501,9 @@ export declare type ClearAuthorizationArtifactsResult = void;
 /**
  * Response when closing the container.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Container closed successfully.
@@ -541,6 +517,9 @@ export declare type CloseResponse = InferOutput<typeof CloseResponseSchema>;
 /**
  * Valibot schema for {@link CloseResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const CloseResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -557,6 +536,9 @@ export declare const CloseResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result when closing the container.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare type CloseResult = void;
@@ -564,6 +546,9 @@ export declare type CloseResult = void;
 /**
  * Constants for container analytics event data.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const ContainerAnalyticsEventData: {
@@ -575,6 +560,9 @@ export declare const ContainerAnalyticsEventData: {
 /**
  * Constants for container analytics event names.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const ContainerAnalyticsEventName: {
@@ -584,6 +572,9 @@ export declare const ContainerAnalyticsEventName: {
 /**
  * Constants for container analytics event states.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const ContainerAnalyticsEventState: {
@@ -594,9 +585,10 @@ export declare const ContainerAnalyticsEventState: {
 };
 
 /**
- * JSBridge module for controlling the WebView container.
+ * SDK module for controlling the WebView container via `JSBridge`.
  *
  * @group Modules
+ * @category Container
  *
  * @remarks
  * Provides methods to interact with the WebView container.
@@ -1038,7 +1030,7 @@ export declare class ContainerModule extends BaseModule {
      */
     sendAnalyticsEvent(request: SendAnalyticsEventRequest): Promise<SendAnalyticsEventResponse>;
     /**
-     * Check if the web app is connected to the Grab SuperApp via JSBridge.
+     * Check if the web app is connected to the Grab SuperApp via `JSBridge`.
      *
      * @remarks
      * Call this method to verify the connection status before using other features.
@@ -1111,9 +1103,10 @@ export declare class ContainerModule extends BaseModule {
 }
 
 /**
- * JSBridge module for querying native device information.
+ * SDK module for querying native device information via `JSBridge`.
  *
  * @group Modules
+ * @category Device
  *
  * @remarks
  * Provides access to device checks exposed by the native Grab app bridge.
@@ -1190,12 +1183,15 @@ export declare class DeviceModule extends BaseModule {
 /**
  * Response when dismissing the splash screen.
  *
+ * @group Modules
+ * @category Splash Screen
+ *
  * @remarks
  * Possible status codes:
  * - `204`: No splash screen shown, or it was closed successfully.
  * - `400`: Invalid input (Grablet / client validation error).
  * - `403`: Missing consent for the required OAuth scope.
- * - `500`: Unexpected error while invoking the native bridge.
+ * - `500`: Unexpected error while invoking `JSBridge`.
  * - `501`: Not in the Grab app WebView environment.
  *
  * @example
@@ -1229,6 +1225,9 @@ export declare type DismissSplashScreenResponse = InferOutput<typeof DismissSpla
 /**
  * Valibot schema for {@link DismissSplashScreenResponse}.
  *
+ * @group Modules
+ * @category Splash Screen
+ *
  * @public
  */
 export declare const DismissSplashScreenResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -1248,7 +1247,10 @@ export declare const DismissSplashScreenResponseSchema: v.UnionSchema<[v.ObjectS
 }, undefined>], undefined>;
 
 /**
- * Request parameters for downloading a file via native bridge.
+ * Request parameters for downloading a file through `JSBridge`.
+ *
+ * @group Modules
+ * @category File
  *
  * @example
  * ```typescript
@@ -1265,6 +1267,9 @@ export declare type DownloadFileRequest = InferOutput<typeof DownloadFileRequest
 /**
  * Valibot schema for {@link DownloadFileRequest}.
  *
+ * @group Modules
+ * @category File
+ *
  * @public
  */
 export declare const DownloadFileRequestSchema: v.ObjectSchema<{
@@ -1275,6 +1280,9 @@ export declare const DownloadFileRequestSchema: v.ObjectSchema<{
 /**
  * Response when requesting a native file download.
  *
+ * @group Modules
+ * @category File
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: File downloaded successfully.
@@ -1289,6 +1297,9 @@ export declare type DownloadFileResponse = InferOutput<typeof DownloadFileRespon
 /**
  * Valibot schema for {@link DownloadFileResponse}.
  *
+ * @group Modules
+ * @category File
+ *
  * @public
  */
 export declare const DownloadFileResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -1307,8 +1318,11 @@ export declare const DownloadFileResponseSchema: v.UnionSchema<[v.ObjectSchema<{
 /**
  * Result data structure for file download operations.
  *
+ * @group Modules
+ * @category File
+ *
  * @remarks
- * This is a void result type as successful downloads return status code 204 with no content.
+ * This is a void result type as successful downloads return status code `204` with no content.
  *
  * @public
  */
@@ -1317,6 +1331,9 @@ export declare type DownloadFileResult = void;
 /**
  * DRM content configuration for playback.
  *
+ * @group Modules
+ * @category Media
+ *
  * @remarks
  * Configuration object containing DRM license information, content URLs, and playback settings.
  * The exact structure depends on the DRM provider (e.g., FairPlay, Widevine).
@@ -1350,6 +1367,9 @@ export declare type DRMContentConfig = Record<string, unknown>;
 /**
  * Result object for DRM playback events.
  *
+ * @group Modules
+ * @category Media
+ *
  * @example
  * **Playback started event:**
  * ```typescript
@@ -1390,6 +1410,9 @@ export declare type DRMPlaybackEvent = InferOutput<typeof DRMPlaybackEventSchema
 /**
  * Valibot schema for {@link DRMPlaybackEvent}.
  *
+ * @group Modules
+ * @category Media
+ *
  * @public
  */
 export declare const DRMPlaybackEventSchema: v.ObjectSchema<{
@@ -1402,6 +1425,9 @@ export declare const DRMPlaybackEventSchema: v.ObjectSchema<{
 /**
  * Response when fetching the user's email.
  *
+ * @group Modules
+ * @category Profile
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Email fetched successfully. The `result` contains the email address.
@@ -1419,6 +1445,9 @@ export declare type FetchEmailResponse = InferOutput<typeof FetchEmailResponseSc
 /**
  * Valibot schema for {@link FetchEmailResponse}.
  *
+ * @group Modules
+ * @category Profile
+ *
  * @public
  */
 export declare const FetchEmailResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -1448,6 +1477,9 @@ export declare const FetchEmailResponseSchema: v.UnionSchema<[v.ObjectSchema<{
 /**
  * Result object containing the user's email address.
  *
+ * @group Modules
+ * @category Profile
+ *
  * @example
  * ```typescript
  * { email: 'user@example.com' }
@@ -1460,6 +1492,9 @@ export declare type FetchEmailResult = InferOutput<typeof FetchEmailResultSchema
 /**
  * Valibot schema for {@link FetchEmailResult}.
  *
+ * @group Modules
+ * @category Profile
+ *
  * @public
  */
 export declare const FetchEmailResultSchema: v.ObjectSchema<{
@@ -1467,9 +1502,10 @@ export declare const FetchEmailResultSchema: v.ObjectSchema<{
 }, undefined>;
 
 /**
- * JSBridge module for downloading files to the user's device.
+ * SDK module for downloading files to the user's device via `JSBridge`.
  *
  * @group Modules
+ * @category File
  *
  * @remarks
  * Initiates native file download handling in the Grab app using a file URL and file name.
@@ -1497,7 +1533,7 @@ export declare const FetchEmailResultSchema: v.ObjectSchema<{
 export declare class FileModule extends BaseModule {
     constructor();
     /**
-     * Downloads a file via the native bridge.
+     * Downloads a file through `JSBridge`.
      *
      * @param request - File information, including URL and target file name. See {@link DownloadFileRequest}.
      *
@@ -1535,6 +1571,9 @@ export declare class FileModule extends BaseModule {
 /**
  * Response when retrieving stored authorization artifacts.
  *
+ * @group Modules
+ * @category Identity
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: All artifacts present. The `result` contains the PKCE artifacts needed for token exchange.
@@ -1548,6 +1587,9 @@ export declare type GetAuthorizationArtifactsResponse = InferOutput<typeof GetAu
 /**
  * Valibot schema for {@link GetAuthorizationArtifactsResponse}.
  *
+ * @group Modules
+ * @category Identity
+ *
  * @public
  */
 export declare const GetAuthorizationArtifactsResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -1569,6 +1611,9 @@ export declare const GetAuthorizationArtifactsResponseSchema: v.UnionSchema<[v.O
  * Result object containing the stored PKCE authorization artifacts.
  * These are used to complete the OAuth2 authorization code exchange.
  *
+ * @group Modules
+ * @category Identity
+ *
  * @example
  * **All artifacts present:**
  * ```typescript
@@ -1587,6 +1632,9 @@ export declare type GetAuthorizationArtifactsResult = InferOutput<typeof GetAuth
 /**
  * Valibot schema for {@link GetAuthorizationArtifactsResult}.
  *
+ * @group Modules
+ * @category Identity
+ *
  * @public
  */
 export declare const GetAuthorizationArtifactsResultSchema: v.ObjectSchema<{
@@ -1599,6 +1647,9 @@ export declare const GetAuthorizationArtifactsResultSchema: v.ObjectSchema<{
 /**
  * Request parameters for getting a boolean value from storage.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @example
  * ```typescript
  * { key: 'isDarkMode' }
@@ -1611,6 +1662,9 @@ export declare type GetBooleanRequest = InferOutput<typeof GetBooleanRequestSche
 /**
  * Valibot schema for {@link GetBooleanRequest}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const GetBooleanRequestSchema: v.ObjectSchema<{
@@ -1620,6 +1674,9 @@ export declare const GetBooleanRequestSchema: v.ObjectSchema<{
 /**
  * Response when getting a boolean value.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Value retrieved successfully. The `result` contains the boolean value.
@@ -1636,6 +1693,9 @@ export declare type GetBooleanResponse = InferOutput<typeof GetBooleanResponseSc
 /**
  * Valibot schema for {@link GetBooleanResponse}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const GetBooleanResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -1660,6 +1720,9 @@ export declare const GetBooleanResponseSchema: v.UnionSchema<[v.ObjectSchema<{
 /**
  * The boolean value returned when a key exists in storage.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * When the key has no stored value, the response `status_code` is `204` instead.
  *
@@ -1675,6 +1738,9 @@ export declare type GetBooleanResult = InferOutput<typeof GetBooleanResultSchema
 /**
  * Valibot schema for {@link GetBooleanResult}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const GetBooleanResultSchema: v.BooleanSchema<undefined>;
@@ -1682,6 +1748,9 @@ export declare const GetBooleanResultSchema: v.BooleanSchema<undefined>;
 /**
  * Response when getting the device coordinates.
  *
+ * @group Modules
+ * @category Location
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Coordinates retrieved successfully. The `result` contains latitude and longitude.
@@ -1697,6 +1766,9 @@ export declare type GetCoordinateResponse = InferOutput<typeof GetCoordinateResp
 /**
  * Valibot schema for {@link GetCoordinateResponse}.
  *
+ * @group Modules
+ * @category Location
+ *
  * @public
  */
 export declare const GetCoordinateResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -1722,6 +1794,9 @@ export declare const GetCoordinateResponseSchema: v.UnionSchema<[v.ObjectSchema<
 /**
  * Result object containing the geographic coordinates.
  *
+ * @group Modules
+ * @category Location
+ *
  * @example
  * ```typescript
  * { latitude: 1.3521, longitude: 103.8198 }
@@ -1734,6 +1809,9 @@ export declare type GetCoordinateResult = InferOutput<typeof GetCoordinateResult
 /**
  * Valibot schema for {@link GetCoordinateResult}.
  *
+ * @group Modules
+ * @category Location
+ *
  * @public
  */
 export declare const GetCoordinateResultSchema: v.ObjectSchema<{
@@ -1744,6 +1822,9 @@ export declare const GetCoordinateResultSchema: v.ObjectSchema<{
 /**
  * Response when getting the country code.
  *
+ * @group Modules
+ * @category Location
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Country code retrieved successfully. The `result` is the ISO country code string.
@@ -1760,6 +1841,9 @@ export declare type GetCountryCodeResponse = InferOutput<typeof GetCountryCodeRe
 /**
  * Valibot schema for {@link GetCountryCodeResponse}.
  *
+ * @group Modules
+ * @category Location
+ *
  * @public
  */
 export declare const GetCountryCodeResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -1782,7 +1866,10 @@ export declare const GetCountryCodeResponseSchema: v.UnionSchema<[v.ObjectSchema
 }, undefined>], undefined>;
 
 /**
- * The ISO country code string returned from the native bridge.
+ * The ISO country code string returned from `JSBridge`.
+ *
+ * @group Modules
+ * @category Location
  *
  * @example
  * ```typescript
@@ -1801,6 +1888,9 @@ export declare type GetCountryCodeResult = InferOutput<typeof GetCountryCodeResu
 /**
  * Valibot schema for {@link GetCountryCodeResult}.
  *
+ * @group Modules
+ * @category Location
+ *
  * @public
  */
 export declare const GetCountryCodeResultSchema: v.StringSchema<undefined>;
@@ -1808,6 +1898,9 @@ export declare const GetCountryCodeResultSchema: v.StringSchema<undefined>;
 /**
  * Request parameters for getting a double value from storage.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @example
  * ```typescript
  * { key: 'price' }
@@ -1820,6 +1913,9 @@ export declare type GetDoubleRequest = InferOutput<typeof GetDoubleRequestSchema
 /**
  * Valibot schema for {@link GetDoubleRequest}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const GetDoubleRequestSchema: v.ObjectSchema<{
@@ -1829,6 +1925,9 @@ export declare const GetDoubleRequestSchema: v.ObjectSchema<{
 /**
  * Response when getting a double value.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Value retrieved successfully. The `result` contains the double value.
@@ -1845,6 +1944,9 @@ export declare type GetDoubleResponse = InferOutput<typeof GetDoubleResponseSche
 /**
  * Valibot schema for {@link GetDoubleResponse}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const GetDoubleResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -1869,6 +1971,9 @@ export declare const GetDoubleResponseSchema: v.UnionSchema<[v.ObjectSchema<{
 /**
  * The floating-point value returned when a key exists in storage.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * When the key has no stored value, the response `status_code` is `204` instead.
  *
@@ -1884,6 +1989,9 @@ export declare type GetDoubleResult = InferOutput<typeof GetDoubleResultSchema>;
 /**
  * Valibot schema for {@link GetDoubleResult}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const GetDoubleResultSchema: v.NumberSchema<undefined>;
@@ -1891,6 +1999,9 @@ export declare const GetDoubleResultSchema: v.NumberSchema<undefined>;
 /**
  * Request parameters for getting an integer value from storage.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @example
  * ```typescript
  * { key: 'userCount' }
@@ -1903,6 +2014,9 @@ export declare type GetIntRequest = InferOutput<typeof GetIntRequestSchema>;
 /**
  * Valibot schema for {@link GetIntRequest}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const GetIntRequestSchema: v.ObjectSchema<{
@@ -1912,6 +2026,9 @@ export declare const GetIntRequestSchema: v.ObjectSchema<{
 /**
  * Response when getting an integer value.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Value retrieved successfully. The `result` contains the integer value.
@@ -1928,6 +2045,9 @@ export declare type GetIntResponse = InferOutput<typeof GetIntResponseSchema>;
 /**
  * Valibot schema for {@link GetIntResponse}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const GetIntResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -1952,6 +2072,9 @@ export declare const GetIntResponseSchema: v.UnionSchema<[v.ObjectSchema<{
 /**
  * The integer value returned when a key exists in storage.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * When the key has no stored value, the response `status_code` is `204` instead.
  *
@@ -1967,6 +2090,9 @@ export declare type GetIntResult = InferOutput<typeof GetIntResultSchema>;
 /**
  * Valibot schema for {@link GetIntResult}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const GetIntResultSchema: v.NumberSchema<undefined>;
@@ -1974,6 +2100,9 @@ export declare const GetIntResultSchema: v.NumberSchema<undefined>;
 /**
  * Response when getting the language locale identifier from the device.
  *
+ * @group Modules
+ * @category Locale
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Locale identifier retrieved successfully.
@@ -1989,6 +2118,9 @@ export declare type GetLanguageLocaleIdentifierResponse = InferOutput<typeof Get
 /**
  * Valibot schema for {@link GetLanguageLocaleIdentifierResponse}.
  *
+ * @group Modules
+ * @category Locale
+ *
  * @public
  */
 export declare const GetLanguageLocaleIdentifierResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -2010,6 +2142,9 @@ export declare const GetLanguageLocaleIdentifierResponseSchema: v.UnionSchema<[v
 /**
  * Result object containing the language locale identifier.
  *
+ * @group Modules
+ * @category Locale
+ *
  * @remarks
  * The locale identifier is the language code of the device's language settings.
  * Common values include:
@@ -2041,6 +2176,9 @@ export declare type GetLanguageLocaleIdentifierResult = InferOutput<typeof GetLa
 /**
  * Valibot schema for {@link GetLanguageLocaleIdentifierResult}.
  *
+ * @group Modules
+ * @category Locale
+ *
  * @public
  */
 export declare const GetLanguageLocaleIdentifierResultSchema: v.StringSchema<undefined>;
@@ -2048,6 +2186,9 @@ export declare const GetLanguageLocaleIdentifierResultSchema: v.StringSchema<und
 /**
  * Response when reading the selected travel destination lowercase ISO 3166-1 alpha-2 country code.
  *
+ * @group Modules
+ * @category User Attributes
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: The selected travel destination lowercase ISO 3166-1 alpha-2 country code was returned successfully.
@@ -2062,6 +2203,9 @@ export declare type GetSelectedTravelDestinationResponse = InferOutput<typeof Ge
 /**
  * Valibot schema for {@link GetSelectedTravelDestinationResponse}.
  *
+ * @group Modules
+ * @category User Attributes
+ *
  * @public
  */
 export declare const GetSelectedTravelDestinationResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -2080,6 +2224,9 @@ export declare const GetSelectedTravelDestinationResponseSchema: v.UnionSchema<[
 /**
  * Result containing the selected travel destination lowercase ISO 3166-1 alpha-2 country code.
  *
+ * @group Modules
+ * @category User Attributes
+ *
  * @example
  * ```typescript
  * 'id'
@@ -2097,6 +2244,9 @@ export declare type GetSelectedTravelDestinationResult = InferOutput<typeof GetS
 /**
  * Valibot schema for {@link GetSelectedTravelDestinationResult}.
  *
+ * @group Modules
+ * @category User Attributes
+ *
  * @public
  */
 export declare const GetSelectedTravelDestinationResultSchema: v.StringSchema<undefined>;
@@ -2104,6 +2254,9 @@ export declare const GetSelectedTravelDestinationResultSchema: v.StringSchema<un
 /**
  * Response when getting session parameters.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Session parameters retrieved successfully.
@@ -2117,6 +2270,9 @@ export declare type GetSessionParamsResponse = InferOutput<typeof GetSessionPara
 /**
  * Valibot schema for {@link GetSessionParamsResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const GetSessionParamsResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -2135,6 +2291,9 @@ export declare const GetSessionParamsResponseSchema: v.UnionSchema<[v.ObjectSche
 /**
  * Result object containing session parameters as a JSON string.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * The `result` field contains a JSON string that must be parsed with `JSON.parse()` to use as an object.
  * Session parameters can contain primitives, base64 encoded strings, or nested objects depending on the
@@ -2152,6 +2311,9 @@ export declare type GetSessionParamsResult = InferOutput<typeof GetSessionParams
 /**
  * Valibot schema for {@link GetSessionParamsResult}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const GetSessionParamsResultSchema: v.StringSchema<undefined>;
@@ -2159,6 +2321,9 @@ export declare const GetSessionParamsResultSchema: v.StringSchema<undefined>;
 /**
  * Request parameters for getting a string value from storage.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @example
  * ```typescript
  * { key: 'username' }
@@ -2171,6 +2336,9 @@ export declare type GetStringRequest = InferOutput<typeof GetStringRequestSchema
 /**
  * Valibot schema for {@link GetStringRequest}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const GetStringRequestSchema: v.ObjectSchema<{
@@ -2180,6 +2348,9 @@ export declare const GetStringRequestSchema: v.ObjectSchema<{
 /**
  * Response when getting a string value.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Value retrieved successfully. The `result` contains the string value.
@@ -2196,6 +2367,9 @@ export declare type GetStringResponse = InferOutput<typeof GetStringResponseSche
 /**
  * Valibot schema for {@link GetStringResponse}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const GetStringResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -2220,6 +2394,9 @@ export declare const GetStringResponseSchema: v.UnionSchema<[v.ObjectSchema<{
 /**
  * The string value returned when a key exists in storage.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * When the key has no stored value, the response `status_code` is `204` instead.
  *
@@ -2235,6 +2412,9 @@ export declare type GetStringResult = InferOutput<typeof GetStringResultSchema>;
 /**
  * Valibot schema for {@link GetStringResult}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const GetStringResultSchema: v.StringSchema<undefined>;
@@ -2242,6 +2422,8 @@ export declare const GetStringResultSchema: v.StringSchema<undefined>;
 /**
  * Represents parsed information from a Grab app user agent string.
  *
+ * @group Core
+ *
  * @public
  */
 export declare interface GrabAppInfo {
@@ -2253,6 +2435,9 @@ export declare interface GrabAppInfo {
 /**
  * Request parameters for checking if the current client has access to a specific API.
  *
+ * @group Modules
+ * @category Scope
+ *
  * @example
  * ```typescript
  * {
@@ -2268,6 +2453,9 @@ export declare type HasAccessToRequest = InferOutput<typeof HasAccessToRequestSc
 /**
  * Valibot schema for {@link HasAccessToRequest}.
  *
+ * @group Modules
+ * @category Scope
+ *
  * @public
  */
 export declare const HasAccessToRequestSchema: v.ObjectSchema<{
@@ -2278,6 +2466,9 @@ export declare const HasAccessToRequestSchema: v.ObjectSchema<{
 /**
  * Response when checking API access permissions.
  *
+ * @group Modules
+ * @category Scope
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Access check completed successfully. The `result` contains the access status.
@@ -2293,6 +2484,9 @@ export declare type HasAccessToResponse = InferOutput<typeof HasAccessToResponse
 /**
  * Valibot schema for {@link HasAccessToResponse}.
  *
+ * @group Modules
+ * @category Scope
+ *
  * @public
  */
 export declare const HasAccessToResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -2315,6 +2509,9 @@ export declare const HasAccessToResponseSchema: v.UnionSchema<[v.ObjectSchema<{
 /**
  * Boolean result indicating whether the MiniApp has access to the specified API.
  *
+ * @group Modules
+ * @category Scope
+ *
  * @example
  * **Has access:**
  * ```typescript
@@ -2334,34 +2531,42 @@ export declare type HasAccessToResult = InferOutput<typeof HasAccessToResultSche
 /**
  * Valibot schema for {@link HasAccessToResult}.
  *
+ * @group Modules
+ * @category Scope
+ *
  * @public
  */
 export declare const HasAccessToResultSchema: v.BooleanSchema<undefined>;
 
 /**
- * Type guard to check if a JSBridge response has a defined result (not null or undefined).
+ * Type guard to check if an SDK response has a `result` that is neither `null` nor `undefined`.
+ *
+ * @group Type Guards
  *
- * @param response - The JSBridge response to check
- * @returns True if the response has a result that is neither null nor undefined, false otherwise
+ * @param response - The SDK response to check
+ * @returns `true` if the response has a `result` that is neither `null` nor `undefined`, `false` otherwise
  *
  * @example
  * ```typescript
  * const response = await someBridgeMethod();
- * if (isSuccess(response) && hasResult(response)) {
- *   // response.result is guaranteed to be defined
+ * if (isOk(response) && hasResult(response)) {
+ *   // response narrowed to status code `200` variant, and `result` is available
  *   console.log('Result:', response.result);
  * }
  * ```
  *
  * @public
  */
-export declare function hasResult<T extends BridgeResponse>(response: T): response is Extract<T, {
+export declare function hasResult<T extends SDKResponse>(response: T): response is Extract<T, {
     result: NonNullable<unknown>;
 }>;
 
 /**
  * Response when hiding the back button.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Back button hidden successfully.
@@ -2375,6 +2580,9 @@ export declare type HideBackButtonResponse = InferOutput<typeof HideBackButtonRe
 /**
  * Valibot schema for {@link HideBackButtonResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const HideBackButtonResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -2391,6 +2599,9 @@ export declare const HideBackButtonResponseSchema: v.UnionSchema<[v.ObjectSchema
  * Result when hiding the back button.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare type HideBackButtonResult = void;
@@ -2398,6 +2609,9 @@ export declare type HideBackButtonResult = void;
 /**
  * Response when hiding the loader.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Loader hidden successfully.
@@ -2411,6 +2625,9 @@ export declare type HideLoaderResponse = InferOutput<typeof HideLoaderResponseSc
 /**
  * Valibot schema for {@link HideLoaderResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const HideLoaderResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -2427,6 +2644,9 @@ export declare const HideLoaderResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result when hiding the loader.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare type HideLoaderResult = void;
@@ -2434,6 +2654,9 @@ export declare type HideLoaderResult = void;
 /**
  * Response when hiding the refresh button.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Refresh button hidden successfully.
@@ -2447,6 +2670,9 @@ export declare type HideRefreshButtonResponse = InferOutput<typeof HideRefreshBu
 /**
  * Valibot schema for {@link HideRefreshButtonResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const HideRefreshButtonResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -2463,14 +2689,18 @@ export declare const HideRefreshButtonResponseSchema: v.UnionSchema<[v.ObjectSch
  * Result when hiding the refresh button.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare type HideRefreshButtonResult = void;
 
 /**
- * JSBridge module for authenticating users via GrabID.
+ * SDK module for authenticating users with GrabID via `JSBridge`.
  *
  * @group Modules
+ * @category Identity
  *
  * @remarks
  * Handles OAuth2/OIDC authentication flows with PKCE support, enabling MiniApps to obtain user identity tokens.
@@ -2640,7 +2870,7 @@ export declare class IdentityModule extends BaseModule {
      * Determines whether to use web-based consent flow based on app version and environment.
      *
      * @param request - The authorization request containing the environment setting.
-     * @returns True if web consent should be used, false for native consent.
+     * @returns `true` if web consent should be used, `false` for native consent.
      *
      * @internal
      */
@@ -2656,7 +2886,7 @@ export declare class IdentityModule extends BaseModule {
      */
     private performWebAuthorization;
     /**
-     * Performs native in-app OAuth2 authorization using the JSBridge.
+     * Performs native in-app OAuth2 authorization using `JSBridge`.
      *
      * @param invokeParams - The authorization parameters.
      *
@@ -2754,40 +2984,34 @@ export declare class IdentityModule extends BaseModule {
 }
 
 /**
- * Options for invoking a JSBridge method.
+ * Type guard to check if an SDK response has a client error status code (`400`, `401`, `403`, `404`, `424`, `426`).
  *
- * @public
- */
-export declare interface InvokeOptions {
-    /** The name of the JSBridge method to invoke */
-    method: string;
-    /** The parameters to pass to the method */
-    params?: unknown;
-}
-
-/**
- * Type guard to check if a JSBridge response is a client error (4xx status codes).
+ * @group Type Guards
  *
- * @param response - The JSBridge response to check
- * @returns True if the response is a client error (400-499), false otherwise
+ * @param response - The SDK response to check
+ * @returns `true` if the response is a client error, `false` otherwise
  *
  * @example
  * ```typescript
  * const response = await someBridgeMethod();
  * if (isClientError(response)) {
- *   console.error('Client error:', response.error);
+ *   // response narrowed to client error variants, `error` is available
+ *   console.error(response.error);
  * }
  * ```
  *
  * @public
  */
-export declare function isClientError<T extends BridgeResponse>(response: T): response is Extract<T, {
+export declare function isClientError<T extends SDKResponse>(response: T): response is Extract<T, {
     status_code: 400 | 401 | 403 | 404 | 424 | 426;
 }>;
 
 /**
  * Response when checking connection status.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Connected to Grab SuperApp. The `result` contains the connection status.
@@ -2800,6 +3024,9 @@ export declare type IsConnectedResponse = InferOutput<typeof IsConnectedResponse
 /**
  * Valibot schema for {@link IsConnectedResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const IsConnectedResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -2815,6 +3042,9 @@ export declare const IsConnectedResponseSchema: v.UnionSchema<[v.ObjectSchema<{
 /**
  * Result object containing the connection status.
  *
+ * @group Modules
+ * @category Container
+ *
  * @example
  * **Connected to Grab SuperApp:**
  * ```typescript
@@ -2834,6 +3064,9 @@ export declare type IsConnectedResult = InferOutput<typeof IsConnectedResultSche
 /**
  * Valibot schema for {@link IsConnectedResult}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const IsConnectedResultSchema: v.ObjectSchema<{
@@ -2841,31 +3074,34 @@ export declare const IsConnectedResultSchema: v.ObjectSchema<{
 }, undefined>;
 
 /**
- * Type guard to check if a JSBridge response is an error (4xx or 5xx status codes).
+ * Type guard to check if an SDK response has an error status code (`400`, `401`, `403`, `404`, `424`, `426`, `500`, `501`).
+ *
+ * @group Type Guards
  *
- * @param response - The JSBridge response to check
- * @returns True if the response is any error (4xx or 5xx), false otherwise
+ * @param response - The SDK response to check
+ * @returns `true` if the response is an error, `false` otherwise
  *
  * @example
  * ```typescript
  * const response = await someBridgeMethod();
  * if (isError(response)) {
- *   // response narrowed to error variants — error: string is guaranteed
- *   console.error('Error:', response.error);
- * } else {
- *   console.log('Success!');
+ *   // response narrowed to error variants, `error` is available
+ *   console.error(response.error);
  * }
  * ```
  *
  * @public
  */
-export declare function isError<T extends BridgeResponse>(response: T): response is Extract<T, {
+export declare function isError<T extends SDKResponse>(response: T): response is Extract<T, {
     error: string;
 }>;
 
 /**
  * Response when checking whether the current device supports eSIM.
  *
+ * @group Modules
+ * @category Device
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: eSIM capability was checked successfully. The `result` contains `true` or `false`.
@@ -2882,6 +3118,9 @@ export declare type IsEsimSupportedResponse = InferOutput<typeof IsEsimSupported
 /**
  * Valibot schema for {@link IsEsimSupportedResponse}.
  *
+ * @group Modules
+ * @category Device
+ *
  * @public
  */
 export declare const IsEsimSupportedResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -2907,6 +3146,9 @@ export declare const IsEsimSupportedResponseSchema: v.UnionSchema<[v.ObjectSchem
 /**
  * Result indicating whether the current device supports eSIM.
  *
+ * @group Modules
+ * @category Device
+ *
  * @example
  * ```typescript
  * true
@@ -2924,111 +3166,156 @@ export declare type IsEsimSupportedResult = InferOutput<typeof IsEsimSupportedRe
 /**
  * Valibot schema for {@link IsEsimSupportedResult}.
  *
+ * @group Modules
+ * @category Device
+ *
  * @public
  */
 export declare const IsEsimSupportedResultSchema: v.BooleanSchema<undefined>;
 
 /**
- * Type guard to check if a JSBridge response is a 302 Found redirect.
+ * Type guard to check if an SDK response has a `302` status code.
  *
- * @param response - The JSBridge response to check
- * @returns True if the response has status code 302, false otherwise
+ * @group Type Guards
+ *
+ * @param response - The SDK response to check
+ * @returns `true` if the response has `302` status code, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * const response = await someBridgeMethod();
+ * if (isFound(response)) {
+ *   // response narrowed to status code `302` variant
+ *   console.log('Redirecting...');
+ * }
+ * ```
  *
  * @public
  */
-export declare function isFound<T extends BridgeResponse>(response: T): response is Extract<T, {
+export declare function isFound<T extends SDKResponse>(response: T): response is Extract<T, {
     status_code: 302;
 }>;
 
 /**
- * Type guard to check if a JSBridge response is a 204 No Content (operation succeeded with no result).
+ * Type guard to check if an SDK response has a `204` status code.
+ *
+ * @group Type Guards
  *
- * @param response - The JSBridge response to check
- * @returns True if the response has status code 204, false otherwise
+ * @param response - The SDK response to check
+ * @returns `true` if the response has `204` status code, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * const response = await someBridgeMethod();
+ * if (isNoContent(response)) {
+ *   // response narrowed to status code `204` variant, `result` is not available
+ *   console.log('No content');
+ * }
+ * ```
  *
  * @public
  */
-export declare function isNoContent<T extends BridgeResponse>(response: T): response is Extract<T, {
+export declare function isNoContent<T extends SDKResponse>(response: T): response is Extract<T, {
     status_code: 204;
 }>;
 
 /**
- * Type guard to check if a JSBridge response is a 200 OK (operation succeeded with a result).
+ * Type guard to check if an SDK response has a `200` status code.
+ *
+ * @group Type Guards
  *
- * @param response - The JSBridge response to check
- * @returns True if the response has status code 200, false otherwise
+ * @param response - The SDK response to check
+ * @returns `true` if the response has `200` status code, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * const response = await someBridgeMethod();
+ * if (isOk(response)) {
+ *   // response narrowed to status code `200` variant, `result` is available
+ *   console.log(response.result);
+ * }
+ * ```
  *
  * @public
  */
-export declare function isOk<T extends BridgeResponse>(response: T): response is Extract<T, {
+export declare function isOk<T extends SDKResponse>(response: T): response is Extract<T, {
     status_code: 200;
 }>;
 
 /**
- * Type guard to check if a JSBridge response is a redirect (status code 302).
+ * Type guard to check if an SDK response has a `302` status code.
+ *
+ * @group Type Guards
  *
- * @param response - The JSBridge response to check
- * @returns True if the response is a redirect (302), false otherwise
+ * @param response - The SDK response to check
+ * @returns `true` if the response is a redirect, `false` otherwise
  *
  * @example
  * ```typescript
  * const response = await someBridgeMethod();
  * if (isRedirection(response)) {
+ *   // response narrowed to status code `302` variant
  *   console.log('Redirecting...');
  * }
  * ```
  *
  * @public
  */
-export declare function isRedirection<T extends BridgeResponse>(response: T): response is Extract<T, {
+export declare function isRedirection<T extends SDKResponse>(response: T): response is Extract<T, {
     status_code: 302;
 }>;
 
 /**
- * Type guard to check if a JSBridge response is a server error (5xx status codes).
+ * Type guard to check if an SDK response has a server error status code (`500`, `501`).
+ *
+ * @group Type Guards
  *
- * @param response - The JSBridge response to check
- * @returns True if the response is a server error (500-599), false otherwise
+ * @param response - The SDK response to check
+ * @returns `true` if the response is a server error, `false` otherwise
  *
  * @example
  * ```typescript
  * const response = await someBridgeMethod();
  * if (isServerError(response)) {
- *   console.error('Server error:', response.error);
+ *   // response narrowed to server error variants, `error` is available
+ *   console.error(response.error);
  * }
  * ```
  *
  * @public
  */
-export declare function isServerError<T extends BridgeResponse>(response: T): response is Extract<T, {
+export declare function isServerError<T extends SDKResponse>(response: T): response is Extract<T, {
     status_code: 500 | 501;
 }>;
 
 /**
- * Type guard to check if a JSBridge response is successful (2xx status codes).
+ * Type guard to check if an SDK response has a success status code (`200`, `204`).
  *
- * @param response - The JSBridge response to check
- * @returns True if the response is successful (200-299), false otherwise
+ * @group Type Guards
+ *
+ * @param response - The SDK response to check
+ * @returns `true` if the response is successful, `false` otherwise
  *
  * @example
  * ```typescript
  * const response = await someBridgeMethod();
  * if (isSuccess(response)) {
- *   // response narrowed to success variants — result is available
- *   console.log(response.result);
+ *   // response narrowed to success variants
+ *   console.log(response);
  * }
  * ```
  *
  * @public
  */
-export declare function isSuccess<T extends BridgeResponse>(response: T): response is Extract<T, {
+export declare function isSuccess<T extends SDKResponse>(response: T): response is Extract<T, {
     status_code: 200 | 204;
 }>;
 
 /**
- * JSBridge module for accessing device locale settings.
+ * SDK module for accessing device locale settings via `JSBridge`.
  *
  * @group Modules
+ * @category Locale
  *
  * @remarks
  * Provides the user's preferred language and region settings from the native device.
@@ -3087,9 +3374,10 @@ export declare class LocaleModule extends BaseModule {
 }
 
 /**
- * JSBridge module for accessing device location services.
+ * SDK module for accessing device location services via `JSBridge`.
  *
  * @group Modules
+ * @category Location
  *
  * @remarks
  * Provides access to the device's geolocation data including coordinates and country code.
@@ -3160,11 +3448,11 @@ export declare class LocationModule extends BaseModule {
      * @requiredOAuthScope mobile.geolocation
      *
      * @remarks
-     * This method returns a `BridgeStream` that continuously emits location updates.
+     * This method returns an `SDKStream` that continuously emits location updates.
      * Remember to call `unsubscribe()` on the subscription when you no longer need updates
      * to conserve battery and free resources.
      *
-     * @returns A `BridgeStream` that emits location updates as the device location changes.
+     * @returns An `SDKStream` that emits location updates as the device location changes.
      * Use `subscribe()` to listen for updates, or `await` to get the first value only. See {@link ObserveLocationChangeResponse}.
      *
      * @example
@@ -3244,6 +3532,8 @@ export declare class LocationModule extends BaseModule {
 /**
  * Provides scoped logging for SDK modules.
  *
+ * @group Core
+ *
  * @remarks
  * Log messages are prefixed with `[SuperAppSDK][ModuleName.methodName]`
  * (e.g. `[SuperAppSDK][ContainerModule.setTitle] An error occurred`).
@@ -3259,9 +3549,10 @@ export declare class Logger {
 }
 
 /**
- * JSBridge module for playing DRM-protected media content.
+ * SDK module for playing DRM-protected media content via `JSBridge`.
  *
  * @group Modules
+ * @category Media
  *
  * @remarks
  * Provides access to the native media player with DRM support for secure content playback.
@@ -3379,9 +3670,24 @@ export declare class MediaModule extends BaseModule {
 }
 
 /**
- * JSBridge module for making network requests via the native bridge.
+ * Options for invoking an SDK method.
+ *
+ * @group Core
+ *
+ * @public
+ */
+export declare interface ModuleInvokeOptions {
+    /** The name of the SDK method to invoke */
+    method: string;
+    /** The parameters to pass to the method */
+    params?: unknown;
+}
+
+/**
+ * SDK module for making network requests through the native layer via `JSBridge`.
  *
  * @group Modules
+ * @category Network
  *
  * @remarks
  * Provides access to native network functionality for making HTTP requests.
@@ -3411,7 +3717,7 @@ export declare class MediaModule extends BaseModule {
 export declare class NetworkModule extends BaseModule {
     constructor();
     /**
-     * Sends a network request via the native bridge.
+     * Sends a network request through `JSBridge`.
      *
      * @param request - The network request parameters including endpoint, method, headers, query, body, and timeout. See {@link SendRequest}.
      *
@@ -3452,18 +3758,24 @@ export declare class NetworkModule extends BaseModule {
 /**
  * Response stream for observing DRM playback events.
  *
+ * @group Modules
+ * @category Media
+ *
  * @remarks
- * This is a `BridgeStream` that can be:
+ * This is an `SDKStream` that can be:
  * - Subscribed to via `.subscribe()` for continuous updates
  * - Awaited via `await` to get the first value only
  *
- * The stream can emit status codes 200 (event data), 500 (server error), or 501 (not implemented).
+ * The stream can emit status codes `200` (event data), `500` (server error), or `501` (not implemented).
  *
  * @public
  */
-export declare type ObserveDRMPlaybackResponse = BridgeStream<InferOutput<typeof ObserveDRMPlaybackResponseSchema>>;
+export declare type ObserveDRMPlaybackResponse = SDKStream<InferOutput<typeof ObserveDRMPlaybackResponseSchema>>;
 
 /**
+ * @group Modules
+ * @category Media
+ *
  * @public
  */
 export declare const ObserveDRMPlaybackResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -3485,8 +3797,11 @@ export declare const ObserveDRMPlaybackResponseSchema: v.UnionSchema<[v.ObjectSc
 /**
  * Response when observing the device coordinates.
  *
+ * @group Modules
+ * @category Location
+ *
  * @remarks
- * This is a `BridgeStream` that can be:
+ * This is an `SDKStream` that can be:
  * - Subscribed to via `.subscribe()` for continuous updates
  * - Awaited via `await` to get the first value only
  *
@@ -3494,11 +3809,14 @@ export declare const ObserveDRMPlaybackResponseSchema: v.UnionSchema<[v.ObjectSc
  *
  * @public
  */
-export declare type ObserveLocationChangeResponse = BridgeStream<GetCoordinateResponse>;
+export declare type ObserveLocationChangeResponse = SDKStream<GetCoordinateResponse>;
 
 /**
  * Response when notifying content loaded.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Notification sent successfully.
@@ -3513,6 +3831,9 @@ export declare type OnContentLoadedResponse = InferOutput<typeof OnContentLoaded
 /**
  * Valibot schema for {@link OnContentLoadedResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const OnContentLoadedResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -3532,6 +3853,9 @@ export declare const OnContentLoadedResponseSchema: v.UnionSchema<[v.ObjectSchem
  * Result when notifying content loaded.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare type OnContentLoadedResult = void;
@@ -3539,6 +3863,9 @@ export declare type OnContentLoadedResult = void;
 /**
  * Request parameters for notifying CTA tap.
  *
+ * @group Modules
+ * @category Container
+ *
  * @example
  * ```typescript
  * 'AV_LANDING_PAGE_CONTINUE'
@@ -3551,6 +3878,9 @@ export declare type OnCtaTapRequest = string;
 /**
  * Response when notifying CTA tap.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: CTA tap notification sent successfully.
@@ -3564,6 +3894,9 @@ export declare type OnCtaTapResponse = InferOutput<typeof OnCtaTapResponseSchema
 /**
  * Valibot schema for {@link OnCtaTapResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const OnCtaTapResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -3581,6 +3914,9 @@ export declare const OnCtaTapResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result when notifying CTA tap.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare type OnCtaTapResult = void;
@@ -3588,6 +3924,9 @@ export declare type OnCtaTapResult = void;
 /**
  * Request parameters for opening an external link.
  *
+ * @group Modules
+ * @category Container
+ *
  * @example
  * ```typescript
  * 'https://example.com'
@@ -3600,6 +3939,9 @@ export declare type OpenExternalLinkRequest = string;
 /**
  * Response when opening an external link.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: External link opened successfully.
@@ -3614,6 +3956,9 @@ export declare type OpenExternalLinkResponse = InferOutput<typeof OpenExternalLi
 /**
  * Valibot schema for {@link OpenExternalLinkResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const OpenExternalLinkResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -3633,6 +3978,9 @@ export declare const OpenExternalLinkResponseSchema: v.UnionSchema<[v.ObjectSche
  * Result when opening an external link.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare type OpenExternalLinkResult = void;
@@ -3640,14 +3988,17 @@ export declare type OpenExternalLinkResult = void;
 /**
  * Represents the mobile operating system platform.
  *
+ * @group Core
+ *
  * @public
  */
 export declare type Platform = 'Android' | 'iOS';
 
 /**
- * JSBridge module for controlling platform navigation.
+ * SDK module for controlling platform navigation via `JSBridge`.
  *
  * @group Modules
+ * @category Platform
  *
  * @remarks
  * Provides methods to interact with the native platform navigation stack, such as triggering the back action.
@@ -3709,6 +4060,9 @@ export declare class PlatformModule extends BaseModule {
 /**
  * Response when initiating DRM content playback.
  *
+ * @group Modules
+ * @category Media
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Playback initiated successfully (streaming content).
@@ -3723,6 +4077,9 @@ export declare type PlayDRMContentResponse = InferOutput<typeof PlayDRMContentRe
 /**
  * Valibot schema for {@link PlayDRMContentResponse}.
  *
+ * @group Modules
+ * @category Media
+ *
  * @public
  */
 export declare const PlayDRMContentResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -3753,14 +4110,18 @@ export declare const PlayDRMContentResponseSchema: v.UnionSchema<[v.ObjectSchema
  * Result object for DRM content playback initiation.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Media
+ *
  * @public
  */
 export declare type PlayDRMContentResult = void;
 
 /**
- * JSBridge module for accessing user profile information.
+ * SDK module for accessing user profile information via `JSBridge`.
  *
  * @group Modules
+ * @category Profile
  *
  * @remarks
  * Provides access to user profile data such as email verification.
@@ -3905,6 +4266,9 @@ export declare class ProfileModule extends BaseModule {
 /**
  * Request parameters for redirecting to the system web view.
  *
+ * @group Modules
+ * @category System WebView Kit
+ *
  * @example
  * ```typescript
  * {
@@ -3919,6 +4283,9 @@ export declare type RedirectToSystemWebViewRequest = InferOutput<typeof Redirect
 /**
  * Valibot schema for {@link RedirectToSystemWebViewRequest}.
  *
+ * @group Modules
+ * @category System WebView Kit
+ *
  * @public
  */
 export declare const RedirectToSystemWebViewRequestSchema: v.ObjectSchema<{
@@ -3928,6 +4295,9 @@ export declare const RedirectToSystemWebViewRequestSchema: v.ObjectSchema<{
 /**
  * Response when redirecting to the system web view.
  *
+ * @group Modules
+ * @category System WebView Kit
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Redirect initiated successfully.
@@ -3943,6 +4313,9 @@ export declare type RedirectToSystemWebViewResponse = InferOutput<typeof Redirec
 /**
  * Valibot schema for {@link RedirectToSystemWebViewResponse}.
  *
+ * @group Modules
+ * @category System WebView Kit
+ *
  * @public
  */
 export declare const RedirectToSystemWebViewResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -3966,6 +4339,9 @@ export declare const RedirectToSystemWebViewResponseSchema: v.UnionSchema<[v.Obj
  * Result object for redirecting to the system web view.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category System WebView Kit
+ *
  * @public
  */
 export declare type RedirectToSystemWebViewResult = void;
@@ -3973,6 +4349,9 @@ export declare type RedirectToSystemWebViewResult = void;
 /**
  * Response when reloading consented scopes.
  *
+ * @group Modules
+ * @category Scope
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Scopes reloaded successfully (no content).
@@ -3987,6 +4366,9 @@ export declare type ReloadScopesResponse = InferOutput<typeof ReloadScopesRespon
 /**
  * Valibot schema for {@link ReloadScopesResponse}.
  *
+ * @group Modules
+ * @category Scope
+ *
  * @public
  */
 export declare const ReloadScopesResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4006,6 +4388,9 @@ export declare const ReloadScopesResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result object for reloading scopes.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Scope
+ *
  * @public
  */
 export declare type ReloadScopesResult = void;
@@ -4013,6 +4398,9 @@ export declare type ReloadScopesResult = void;
 /**
  * Response when removing all values.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: All values removed successfully.
@@ -4027,6 +4415,9 @@ export declare type RemoveAllResponse = InferOutput<typeof RemoveAllResponseSche
 /**
  * Valibot schema for {@link RemoveAllResponse}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const RemoveAllResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4046,6 +4437,9 @@ export declare const RemoveAllResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result object for removing all values.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare type RemoveAllResult = void;
@@ -4053,6 +4447,9 @@ export declare type RemoveAllResult = void;
 /**
  * Response when removing a value.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Value removed successfully.
@@ -4068,6 +4465,9 @@ export declare type RemoveResponse = InferOutput<typeof RemoveResponseSchema>;
 /**
  * Valibot schema for {@link RemoveResponse}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const RemoveResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4090,6 +4490,9 @@ export declare const RemoveResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result object for removing a value.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare type RemoveResult = void;
@@ -4097,6 +4500,9 @@ export declare type RemoveResult = void;
 /**
  * Request parameters for scanning QR codes.
  *
+ * @group Modules
+ * @category Camera
+ *
  * @example
  * **Request with custom title:**
  * ```typescript
@@ -4116,6 +4522,9 @@ export declare type ScanQRCodeRequest = InferOutput<typeof ScanQRCodeRequestSche
 /**
  * Valibot schema for {@link ScanQRCodeRequest}.
  *
+ * @group Modules
+ * @category Camera
+ *
  * @public
  */
 export declare const ScanQRCodeRequestSchema: v.ObjectSchema<{
@@ -4125,6 +4534,9 @@ export declare const ScanQRCodeRequestSchema: v.ObjectSchema<{
 /**
  * Response when scanning a QR code.
  *
+ * @group Modules
+ * @category Camera
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Successfully scanned QR code. The `result` contains the scanned QR code data.
@@ -4141,6 +4553,9 @@ export declare type ScanQRCodeResponse = InferOutput<typeof ScanQRCodeResponseSc
 /**
  * Valibot schema for {@link ScanQRCodeResponse}.
  *
+ * @group Modules
+ * @category Camera
+ *
  * @public
  */
 export declare const ScanQRCodeResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4167,6 +4582,9 @@ export declare const ScanQRCodeResponseSchema: v.UnionSchema<[v.ObjectSchema<{
 /**
  * Result object containing the scanned QR code data.
  *
+ * @group Modules
+ * @category Camera
+ *
  * @example
  * ```typescript
  * { qrCode: 'https://example.com/payment/123' }
@@ -4179,6 +4597,9 @@ export declare type ScanQRCodeResult = InferOutput<typeof ScanQRCodeResultSchema
 /**
  * Valibot schema for {@link ScanQRCodeResult}.
  *
+ * @group Modules
+ * @category Camera
+ *
  * @public
  */
 export declare const ScanQRCodeResultSchema: v.ObjectSchema<{
@@ -4186,9 +4607,10 @@ export declare const ScanQRCodeResultSchema: v.ObjectSchema<{
 }, undefined>;
 
 /**
- * JSBridge module for checking and refreshing API access permissions.
+ * SDK module for checking and refreshing API access permissions via `JSBridge`.
  *
  * @group Modules
+ * @category Scope
  *
  * @remarks
  * Manages OAuth scope permissions, allowing the MiniApp to check access rights and reload scopes from the server.
@@ -4216,9 +4638,9 @@ export declare const ScanQRCodeResultSchema: v.ObjectSchema<{
 export declare class ScopeModule extends BaseModule {
     constructor();
     /**
-     * Checks if the current client has access to a specific JSBridge API method.
+     * Checks if the current client has access to a specific `JSBridge` API method.
      *
-     * @param module - The name of the bridge module to check access for (e.g., 'CameraModule').
+     * @param module - The name of the SDK module to check access for (e.g., 'CameraModule').
      * @param method - The method name within the module to check access for (e.g., 'scanQRCode').
      *
      * @returns Whether the MiniApp has permission to access the specified method. See {@link HasAccessToResponse}.
@@ -4279,9 +4701,149 @@ export declare class ScopeModule extends BaseModule {
     reloadScopes(): Promise<ReloadScopesResponse>;
 }
 
+/**
+ * Client error status codes for SDK error responses.
+ *
+ * @group Core
+ *
+ * @public
+ */
+export declare type SDKClientErrorStatusCode = 400 | 401 | 403 | 404 | 424 | 426;
+
+/**
+ * SDK error status code response with a `error` message.
+ *
+ * @group Core
+ *
+ * @public
+ */
+export declare interface SDKErrorResponse<C extends SDKErrorStatusCode> {
+    readonly status_code: C;
+    readonly error: string;
+}
+
+/**
+ * Error status codes for SDK error responses.
+ *
+ * @group Core
+ *
+ * @public
+ */
+export declare type SDKErrorStatusCode = SDKClientErrorStatusCode | SDKServerErrorStatusCode;
+
+/**
+ * SDK `204` status code response.
+ *
+ * @group Core
+ *
+ * @public
+ */
+export declare interface SDKNoContentResponse {
+    readonly status_code: 204;
+}
+
+/**
+ * SDK `200` status code response with a typed `result` payload.
+ *
+ * @group Core
+ *
+ * @public
+ */
+export declare interface SDKOkResponse<T> {
+    readonly status_code: 200;
+    readonly result: T;
+}
+
+/**
+ * SDK `302` status code response.
+ *
+ * @group Core
+ *
+ * @public
+ */
+export declare interface SDKRedirectResponse {
+    readonly status_code: 302;
+}
+
+/**
+ * Base SDK response shape.
+ *
+ * @group Core
+ *
+ * @remarks
+ * Use the type guards to narrow to a specific shape.
+ *
+ * @public
+ */
+export declare type SDKResponse = {
+    /** HTTP-style status code indicating the outcome of the SDK method call */
+    status_code: number;
+    /** The result data from the SDK method, present on 200 status code responses */
+    result?: unknown;
+    /** Error message, present on error status code responses */
+    error?: string;
+};
+
+/**
+ * Server error status codes for SDK error responses.
+ *
+ * @group Core
+ *
+ * @public
+ */
+export declare type SDKServerErrorStatusCode = 500 | 501;
+
+/**
+ * A stream for receiving continuous data from SDK methods (e.g., location updates).
+ *
+ * @group Core
+ *
+ * @remarks
+ * Provides both Observable-like and Promise-like interfaces:
+ * - Use `subscribe()` to receive all values over time
+ * - Use `then()` or `await` to receive only the first value
+ *
+ * Note: Each `subscribe()` call creates a fresh subscription, allowing multiple independent listeners.
+ *
+ * @typeParam T - The response type emitted by the stream.
+ *
+ * @public
+ */
+export declare type SDKStream<T extends SDKResponse = SDKResponse> = Readonly<{
+    /**
+     * Subscribe to receive stream data.
+     *
+     * @param handlers - Optional callbacks for data (`next`) and completion (`complete`).
+     * @returns A `Subscription` to terminate the stream when needed.
+     */
+    subscribe: (handlers?: SDKStreamHandlers<T>) => Subscription;
+}> & PromiseLike<T>;
+
+/**
+ * Callbacks for handling stream events.
+ *
+ * @group Core
+ *
+ * @remarks
+ * Pass these to `subscribe()` to receive data via `next` and completion via `complete`.
+ *
+ * @typeParam T - The response type emitted by the stream.
+ *
+ * @public
+ */
+export declare type SDKStreamHandlers<T extends SDKResponse = SDKResponse> = Readonly<{
+    /** Called with each new value from the stream. */
+    next?: (data: T) => unknown;
+    /** Called when the stream ends and no more data will arrive. */
+    complete?: () => unknown;
+}>;
+
 /**
  * Request parameters for sending analytics events.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * Use predefined constants to ensure consistency across the platform:
  * - **States:** {@link ContainerAnalyticsEventState}
@@ -4313,6 +4875,9 @@ export declare type SendAnalyticsEventRequest = InferOutput<typeof SendAnalytics
 /**
  * Valibot schema for {@link SendAnalyticsEventRequest}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const SendAnalyticsEventRequestSchema: v.ObjectSchema<{
@@ -4324,6 +4889,9 @@ export declare const SendAnalyticsEventRequestSchema: v.ObjectSchema<{
 /**
  * Response when sending analytics events.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Analytics event sent successfully.
@@ -4338,6 +4906,9 @@ export declare type SendAnalyticsEventResponse = InferOutput<typeof SendAnalytic
 /**
  * Valibot schema for {@link SendAnalyticsEventResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const SendAnalyticsEventResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4357,6 +4928,9 @@ export declare const SendAnalyticsEventResponseSchema: v.UnionSchema<[v.ObjectSc
  * Result when sending analytics events.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare type SendAnalyticsEventResult = void;
@@ -4364,6 +4938,9 @@ export declare type SendAnalyticsEventResult = void;
 /**
  * Request parameters for sending a network request.
  *
+ * @group Modules
+ * @category Network
+ *
  * @example
  * **GET request with headers:**
  * ```typescript
@@ -4403,6 +4980,9 @@ export declare type SendRequest = InferOutput<typeof SendRequestSchema>;
 /**
  * Valibot schema for {@link SendRequest}.
  *
+ * @group Modules
+ * @category Network
+ *
  * @remarks
  * This schema defines the structure of a network request with the following properties:
  * - `endpoint`: API endpoint URL to send the request to
@@ -4426,6 +5006,9 @@ export declare const SendRequestSchema: v.ObjectSchema<{
 /**
  * Response when sending a network request.
  *
+ * @group Modules
+ * @category Network
+ *
  * @remarks
  * This response can have any HTTP status code returned by the external API:
  * - Success codes (2xx): Contains the `result` with response data, except 204 which has no body.
@@ -4440,6 +5023,9 @@ export declare type SendResponse = InferOutput<typeof SendResponseSchema>;
 /**
  * Valibot schema for {@link SendResponse}.
  *
+ * @group Modules
+ * @category Network
+ *
  * @public
  */
 export declare const SendResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4476,9 +5062,12 @@ export declare const SendResponseSchema: v.UnionSchema<[v.ObjectSchema<{
 /**
  * Result object containing the network response data.
  *
+ * @group Modules
+ * @category Network
+ *
  * @remarks
  * The result type is `Record<string, unknown>` as response bodies are always
- * returned as objects. String responses from the native bridge are automatically
+ * returned as objects. String responses from `JSBridge` are automatically
  * parsed to JSON.
  *
  * @public
@@ -4488,6 +5077,9 @@ export declare type SendResult = InferOutput<typeof SendResultSchema>;
 /**
  * Valibot schema for {@link SendResult}.
  *
+ * @group Modules
+ * @category Network
+ *
  * @public
  */
 export declare const SendResultSchema: v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>;
@@ -4495,6 +5087,9 @@ export declare const SendResultSchema: v.RecordSchema<v.StringSchema<undefined>,
 /**
  * Request parameters for setting the background color.
  *
+ * @group Modules
+ * @category Container
+ *
  * @example
  * ```typescript
  * '#ffffff'
@@ -4507,6 +5102,9 @@ export declare type SetBackgroundColorRequest = string;
 /**
  * Response when setting the background color.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Background color set successfully.
@@ -4521,6 +5119,9 @@ export declare type SetBackgroundColorResponse = InferOutput<typeof SetBackgroun
 /**
  * Valibot schema for {@link SetBackgroundColorResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const SetBackgroundColorResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4540,6 +5141,9 @@ export declare const SetBackgroundColorResponseSchema: v.UnionSchema<[v.ObjectSc
  * Result when setting the background color.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare type SetBackgroundColorResult = void;
@@ -4547,6 +5151,9 @@ export declare type SetBackgroundColorResult = void;
 /**
  * Request parameters for storing a boolean value in storage.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @example
  * ```typescript
  * { key: 'isDarkMode', value: true }
@@ -4559,6 +5166,9 @@ export declare type SetBooleanRequest = InferOutput<typeof SetBooleanRequestSche
 /**
  * Valibot schema for {@link SetBooleanRequest}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const SetBooleanRequestSchema: v.ObjectSchema<{
@@ -4569,6 +5179,9 @@ export declare const SetBooleanRequestSchema: v.ObjectSchema<{
 /**
  * Response when setting a boolean value.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Value stored successfully.
@@ -4584,6 +5197,9 @@ export declare type SetBooleanResponse = InferOutput<typeof SetBooleanResponseSc
 /**
  * Valibot schema for {@link SetBooleanResponse}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const SetBooleanResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4606,6 +5222,9 @@ export declare const SetBooleanResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result object for setting a boolean value.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare type SetBooleanResult = void;
@@ -4613,6 +5232,9 @@ export declare type SetBooleanResult = void;
 /**
  * Request parameters for storing a double value in storage.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @example
  * ```typescript
  * { key: 'price', value: 19.99 }
@@ -4625,6 +5247,9 @@ export declare type SetDoubleRequest = InferOutput<typeof SetDoubleRequestSchema
 /**
  * Valibot schema for {@link SetDoubleRequest}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const SetDoubleRequestSchema: v.ObjectSchema<{
@@ -4635,6 +5260,9 @@ export declare const SetDoubleRequestSchema: v.ObjectSchema<{
 /**
  * Response when setting a double value.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Value stored successfully.
@@ -4650,6 +5278,9 @@ export declare type SetDoubleResponse = InferOutput<typeof SetDoubleResponseSche
 /**
  * Valibot schema for {@link SetDoubleResponse}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const SetDoubleResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4672,6 +5303,9 @@ export declare const SetDoubleResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result object for setting a double value.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare type SetDoubleResult = void;
@@ -4679,6 +5313,9 @@ export declare type SetDoubleResult = void;
 /**
  * Request parameters for storing an integer value in storage.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @example
  * ```typescript
  * { key: 'userCount', value: 42 }
@@ -4691,6 +5328,9 @@ export declare type SetIntRequest = InferOutput<typeof SetIntRequestSchema>;
 /**
  * Valibot schema for {@link SetIntRequest}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const SetIntRequestSchema: v.ObjectSchema<{
@@ -4701,6 +5341,9 @@ export declare const SetIntRequestSchema: v.ObjectSchema<{
 /**
  * Response when setting an integer value.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Value stored successfully.
@@ -4716,6 +5359,9 @@ export declare type SetIntResponse = InferOutput<typeof SetIntResponseSchema>;
 /**
  * Valibot schema for {@link SetIntResponse}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const SetIntResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4738,6 +5384,9 @@ export declare const SetIntResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result object for setting an integer value.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare type SetIntResult = void;
@@ -4745,6 +5394,9 @@ export declare type SetIntResult = void;
 /**
  * Request parameters for storing a string value in storage.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @example
  * ```typescript
  * { key: 'username', value: 'john_doe' }
@@ -4757,6 +5409,9 @@ export declare type SetStringRequest = InferOutput<typeof SetStringRequestSchema
 /**
  * Valibot schema for {@link SetStringRequest}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const SetStringRequestSchema: v.ObjectSchema<{
@@ -4767,6 +5422,9 @@ export declare const SetStringRequestSchema: v.ObjectSchema<{
 /**
  * Response when setting a string value.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Value stored successfully.
@@ -4782,6 +5440,9 @@ export declare type SetStringResponse = InferOutput<typeof SetStringResponseSche
 /**
  * Valibot schema for {@link SetStringResponse}.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare const SetStringResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4804,6 +5465,9 @@ export declare const SetStringResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result object for setting a string value.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Storage
+ *
  * @public
  */
 export declare type SetStringResult = void;
@@ -4811,6 +5475,9 @@ export declare type SetStringResult = void;
 /**
  * Request parameters for setting the title.
  *
+ * @group Modules
+ * @category Container
+ *
  * @example
  * ```typescript
  * 'Home Page'
@@ -4823,6 +5490,9 @@ export declare type SetTitleRequest = string;
 /**
  * Response when setting the title.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Title set successfully.
@@ -4837,6 +5507,9 @@ export declare type SetTitleResponse = InferOutput<typeof SetTitleResponseSchema
 /**
  * Valibot schema for {@link SetTitleResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const SetTitleResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4856,6 +5529,9 @@ export declare const SetTitleResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result when setting the title.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare type SetTitleResult = void;
@@ -4863,6 +5539,9 @@ export declare type SetTitleResult = void;
 /**
  * Response when showing the back button.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Back button shown successfully.
@@ -4876,6 +5555,9 @@ export declare type ShowBackButtonResponse = InferOutput<typeof ShowBackButtonRe
 /**
  * Valibot schema for {@link ShowBackButtonResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const ShowBackButtonResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4892,6 +5574,9 @@ export declare const ShowBackButtonResponseSchema: v.UnionSchema<[v.ObjectSchema
  * Result when showing the back button.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare type ShowBackButtonResult = void;
@@ -4899,6 +5584,9 @@ export declare type ShowBackButtonResult = void;
 /**
  * Response when showing the loader.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Loader shown successfully.
@@ -4912,6 +5600,9 @@ export declare type ShowLoaderResponse = InferOutput<typeof ShowLoaderResponseSc
 /**
  * Valibot schema for {@link ShowLoaderResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const ShowLoaderResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4928,6 +5619,9 @@ export declare const ShowLoaderResponseSchema: v.UnionSchema<[v.ObjectSchema<{
  * Result when showing the loader.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare type ShowLoaderResult = void;
@@ -4935,6 +5629,9 @@ export declare type ShowLoaderResult = void;
 /**
  * Response when showing the refresh button.
  *
+ * @group Modules
+ * @category Container
+ *
  * @remarks
  * This response can have the following status codes:
  * - `204`: Refresh button shown successfully.
@@ -4948,6 +5645,9 @@ export declare type ShowRefreshButtonResponse = InferOutput<typeof ShowRefreshBu
 /**
  * Valibot schema for {@link ShowRefreshButtonResponse}.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare const ShowRefreshButtonResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -4964,14 +5664,18 @@ export declare const ShowRefreshButtonResponseSchema: v.UnionSchema<[v.ObjectSch
  * Result when showing the refresh button.
  * This operation returns no data on success.
  *
+ * @group Modules
+ * @category Container
+ *
  * @public
  */
 export declare type ShowRefreshButtonResult = void;
 
 /**
- * JSBridge module for controlling the native splash / Lottie loading screen.
+ * SDK module for controlling the native splash / Lottie loading screen via `JSBridge`.
  *
  * @group Modules
+ * @category Splash Screen
  *
  * @remarks
  * Dismisses the splash overlay once the MiniApp is ready. Requires the Grab SuperApp WebView.
@@ -5024,9 +5728,10 @@ export declare class SplashScreenModule extends BaseModule {
 }
 
 /**
- * JSBridge module for persisting key-value data to native storage.
+ * SDK module for persisting key-value data to native storage via `JSBridge`.
  *
  * @group Modules
+ * @category Storage
  *
  * @remarks
  * Stores data in the native app's persistent storage, allowing data to survive WebView restarts.
@@ -5405,7 +6110,9 @@ export declare class StorageModule extends BaseModule {
 }
 
 /**
- * Controls an active stream subscription. Call `unsubscribe()` to stop receiving data.
+ * Controls an active stream subscription.
+ *
+ * @group Core
  *
  * @remarks
  * Returned by `subscribe()`. Use `unsubscribe()` to terminate the stream early.
@@ -5414,16 +6121,17 @@ export declare class StorageModule extends BaseModule {
  * @public
  */
 export declare type Subscription = Readonly<{
-    /** Returns true if this subscription has been terminated. */
+    /** Returns `true` if this subscription has been terminated. */
     isUnsubscribed: () => boolean;
     /** Terminates the subscription. No further data will be received. */
     unsubscribe: () => unknown;
 }>;
 
 /**
- * JSBridge module for opening URLs in the device's system browser.
+ * SDK module for opening URLs in the device's system browser via `JSBridge`.
  *
  * @group Modules
+ * @category System WebView Kit
  *
  * @remarks
  * Allows MiniApps to redirect users to external content using the native system browser.
@@ -5488,6 +6196,9 @@ export declare class SystemWebViewKitModule extends BaseModule {
 /**
  * Request parameters for triggering the checkout flow.
  *
+ * @group Modules
+ * @category Checkout
+ *
  * @remarks
  * This type is intentionally flexible as the checkout parameters vary depending on the specific payment flow and partner requirements.
  * Consult the Grab SuperApp SDK documentation for the specific parameters required for your use case.
@@ -5512,6 +6223,9 @@ export declare type TriggerCheckoutRequest = InferOutput<typeof TriggerCheckoutR
 /**
  * Valibot schema for {@link TriggerCheckoutRequest}.
  *
+ * @group Modules
+ * @category Checkout
+ *
  * @remarks
  * The checkout parameters vary depending on the specific payment flow and partner requirements.
  *
@@ -5522,6 +6236,9 @@ export declare const TriggerCheckoutRequestSchema: v.RecordSchema<v.StringSchema
 /**
  * Response when triggering the checkout flow.
  *
+ * @group Modules
+ * @category Checkout
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Checkout completed successfully. The `result` contains transaction details.
@@ -5536,6 +6253,9 @@ export declare type TriggerCheckoutResponse = InferOutput<typeof TriggerCheckout
 /**
  * Valibot schema for {@link TriggerCheckoutResponse}.
  *
+ * @group Modules
+ * @category Checkout
+ *
  * @public
  */
 export declare const TriggerCheckoutResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -5568,6 +6288,9 @@ export declare const TriggerCheckoutResponseSchema: v.UnionSchema<[v.ObjectSchem
 /**
  * Result object containing the checkout transaction details.
  *
+ * @group Modules
+ * @category Checkout
+ *
  * @remarks
  * - `status: 'success'` → `transactionID`
  * - `status: 'failure'` → `transactionID`, `errorMessage`, `errorCode`
@@ -5618,6 +6341,9 @@ export declare type TriggerCheckoutResult = InferOutput<typeof TriggerCheckoutRe
 /**
  * Valibot schema for {@link TriggerCheckoutResult}.
  *
+ * @group Modules
+ * @category Checkout
+ *
  * @public
  */
 export declare const TriggerCheckoutResultSchema: v.VariantSchema<"status", [v.ObjectSchema<{
@@ -5636,9 +6362,10 @@ export declare const TriggerCheckoutResultSchema: v.VariantSchema<"status", [v.O
 }, undefined>], undefined>;
 
 /**
- * JSBridge module for reading user-related attributes from native code.
+ * SDK module for reading user-related attributes from native code via `JSBridge`.
  *
  * @group Modules
+ * @category User Attributes
  *
  * @remarks
  * Provides access to user and traveller attributes exposed by the native Grab app bridge.
@@ -5706,6 +6433,9 @@ export declare class UserAttributesModule extends BaseModule {
 /**
  * Request parameters for verifying the user's email.
  *
+ * @group Modules
+ * @category Profile
+ *
  * @remarks
  * Both properties are optional. If email is provided and skipUserInput is true,
  * the verify OTP bottom sheet will be triggered directly without user editing.
@@ -5725,6 +6455,9 @@ export declare type VerifyEmailRequest = InferOutput<typeof VerifyEmailRequestSc
 /**
  * Valibot schema for {@link VerifyEmailRequest}.
  *
+ * @group Modules
+ * @category Profile
+ *
  * @public
  */
 export declare const VerifyEmailRequestSchema: v.ObjectSchema<{
@@ -5735,6 +6468,9 @@ export declare const VerifyEmailRequestSchema: v.ObjectSchema<{
 /**
  * Response when verifying the user's email.
  *
+ * @group Modules
+ * @category Profile
+ *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Success, email verified and returned in `result`.
@@ -5767,6 +6503,9 @@ export declare type VerifyEmailResponse = InferOutput<typeof VerifyEmailResponse
 /**
  * Valibot schema for {@link VerifyEmailResponse}.
  *
+ * @group Modules
+ * @category Profile
+ *
  * @public
  */
 export declare const VerifyEmailResponseSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -5796,6 +6535,9 @@ export declare const VerifyEmailResponseSchema: v.UnionSchema<[v.ObjectSchema<{
 /**
  * Result object for verifying the user's email.
  *
+ * @group Modules
+ * @category Profile
+ *
  * @example
  * ```typescript
  * { email: 'user@example.com' }
@@ -5808,6 +6550,9 @@ export declare type VerifyEmailResult = InferOutput<typeof VerifyEmailResultSche
 /**
  * Valibot schema for {@link VerifyEmailResult}.
  *
+ * @group Modules
+ * @category Profile
+ *
  * @public
  */
 export declare const VerifyEmailResultSchema: v.ObjectSchema<{
@@ -5817,6 +6562,8 @@ export declare const VerifyEmailResultSchema: v.ObjectSchema<{
 /**
  * Represents a semantic version with major, minor, and patch components.
  *
+ * @group Core
+ *
  * @public
  */
 export declare interface Version {
@@ -5826,12 +6573,14 @@ export declare interface Version {
 }
 
 /**
- * Generic interface for all native JSBridge module wrappers.
+ * Generic interface for all SDK module wrappers exposed through `JSBridge`.
+ *
+ * @group Core
  *
  * @public
  */
 export declare interface WrappedModule {
-    invoke(method: string, params?: unknown): BridgeStream | Promise<BridgeResponse>;
+    invoke(method: string, params?: unknown): SDKStream | Promise<SDKResponse>;
 }
 
 export { }