@grabjs/superapp-sdk 2.0.0-beta.14 → 2.0.0-beta.23

package/dist/index.d.ts

@@ -1,5 +1,3 @@
-import { DataStream as DataStream_2 } from '@grabjs/mobile-kit-bridge-sdk';
-
 /**
  * Request parameters for initiating an OAuth2 authorization flow with PKCE.
  *
@@ -57,6 +55,10 @@ export declare type AuthorizeRequest = {
  * - `302`: Redirect in progress (web redirect flow). The page will navigate away.
  * - `204`: No content - user cancelled or flow completed without result data.
  * - `400`: Bad request - missing required OAuth parameters or invalid configuration.
+ * - `401`: Unauthorized - user not authenticated or session expired.
+ * - `403`: Forbidden - client not authorized for the requested scope.
+ * - `500`: Internal server error - unexpected error during native authorization.
+ * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
  * **Success response (200) - native in_place flow:**
@@ -91,9 +93,18 @@ export declare type AuthorizeRequest = {
  * }
  * ```
  *
+ * @example
+ * **Not implemented response (501) - outside Grab app:**
+ * ```typescript
+ * {
+ *   status_code: 501,
+ *   error: 'Not implemented: This method requires the Grab app environment'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type AuthorizeResponse = Promise<ConstrainedBridgeResponse<AuthorizeResult, 200 | 302 | 204 | 400 | 401 | 403>>;
+export declare type AuthorizeResponse = BridgeResponse<200 | 302 | 204 | 400 | 401 | 403 | 500 | 501, AuthorizeResult>;
 
 /**
  * Result object for the authorization flow.
@@ -122,6 +133,7 @@ export declare type AuthorizeResult = {
  * @remarks
  * This response can have the following status codes:
  * - `204`: Back navigation triggered successfully.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -139,9 +151,18 @@ export declare type AuthorizeResult = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type BackResponse = Promise<ConstrainedBridgeResponse<BackResult, 204 | 501>>;
+export declare type BackResponse = BridgeResponse<204 | 500 | 501, BackResult>;
 
 /**
  * Result when triggering platform back navigation.
@@ -170,7 +191,7 @@ export declare class BaseModule {
      *
      * @returns The wrapped module instance with native method bindings.
      *
-     * @internal
+     * @public
      */
     protected get wrappedModule(): WrappedModule;
     /**
@@ -181,29 +202,53 @@ export declare class BaseModule {
      */
     constructor(moduleName: string);
     /**
-     * Invokes a JSBridge method with automatic environment checking.
+     * Invokes a JSBridge method with optional app validation and response transformation.
      *
      * @remarks
-     * This method checks if the code is running in the Grab app before invoking the JSBridge.
-     * If not running in the Grab app, it returns a 501 (Not Implemented) response.
-     * For methods that need to work outside the Grab app, use `this.wrappedModule.invoke()` directly.
+     * - Always checks if running in Grab app (returns 501 if not).
+     * - When `isSupported` returns false, returns 426 (Upgrade Required).
+     * - When `transformResponse` is provided, applies it to successful responses.
+     * - All errors are reported via the `status_code` field; this method never rejects.
+     * - For streaming methods, use `invokeStream` instead.
      *
-     * @param method - The name of the JSBridge method to invoke.
-     * @param params - The parameters to pass to the method.
-     * @returns A promise resolving to the JSBridge response, or a 501 error if not in Grab app.
+     * @param options - The invoke options including method name, params, validation, and transformation.
+     * @returns A promise resolving to the JSBridge response.
      *
-     * @internal
+     * @public
+     */
+    invoke<T>(options: InvokeOptions<T>): Promise<BridgeResponse<BridgeStatusCode, T>>;
+    /**
+     * Creates a BridgeStream that immediately emits an error response.
+     * Used for 501, 426, and 500 error scenarios in invokeStream.
+     *
+     * @returns A BridgeStream that emits the error and immediately completes.
      */
-    invoke<T>(method: string, params?: unknown): Promise<T>;
+    private createErrorStream;
+    /**
+     * Invokes a JSBridge streaming method that returns a `BridgeStream`.
+     *
+     * @remarks
+     * - Always checks if running in Grab app (returns 501 error response if not).
+     * - When `isSupported` returns false, returns 426 error response.
+     * - Returns a `BridgeStream` 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, params, and validation.
+     * @returns A `BridgeStream` for receiving continuous data from the JSBridge.
+     *
+     * @public
+     */
+    protected invokeStream<T>(options: InvokeOptions<T>): BridgeStream<BridgeStatusCode, T>;
 }
 
 /**
  * Union type representing all client error JSBridge responses (4xx status codes).
- * Includes: 400 (Bad Request), 403 (Forbidden), 404 (Not Found), and 424 (Failed Dependency).
+ * Includes: 400 (Bad Request), 401 (Unauthorized), 403 (Forbidden), 404 (Not Found),
+ * 424 (Failed Dependency), and 426 (Upgrade Required).
  *
  * @public
  */
-export declare type BridgeClientErrorResponse = BridgeStatusCode400Response | BridgeStatusCode401Response | BridgeStatusCode403Response | BridgeStatusCode404Response | BridgeStatusCode424Response;
+export declare type BridgeClientError = ResponseStatusCode400 | ResponseStatusCode401 | ResponseStatusCode403 | ResponseStatusCode404 | ResponseStatusCode424 | ResponseStatusCode426;
 
 /**
  * Union type representing all error JSBridge responses (4xx and 5xx status codes).
@@ -211,7 +256,7 @@ export declare type BridgeClientErrorResponse = BridgeStatusCode400Response | Br
  *
  * @public
  */
-export declare type BridgeErrorResponse = BridgeClientErrorResponse | BridgeServerErrorResponse;
+export declare type BridgeError = BridgeClientError | BridgeServerError;
 
 /**
  * Union type representing redirect JSBridge responses.
@@ -219,158 +264,93 @@ export declare type BridgeErrorResponse = BridgeClientErrorResponse | BridgeServ
  *
  * @public
  */
-export declare type BridgeRedirectResponse = BridgeStatusCode302Response;
+export declare type BridgeRedirection = ResponseStatusCode302;
 
 /**
- * Universal response format for all JSBridge methods.
+ * Universal response type for JSBridge method callbacks.
  *
  * @remarks
- * All JSBridge method calls resolve to this type. After destructuring,
- * use type guards (e.g., if (error), if (status_code === 200)) to narrow the type.
- *
- * @public
- */
-export declare type BridgeResponse<T> = BridgeSuccessResponse<T> | BridgeRedirectResponse | BridgeClientErrorResponse | BridgeServerErrorResponse;
-
-/**
- * Union type representing server error JSBridge responses (5xx status codes).
- * Includes status codes 500 (Internal Server Error) and 501 (Not Implemented).
- *
- * @public
- */
-export declare type BridgeServerErrorResponse = BridgeStatusCode500Response | BridgeStatusCode501Response;
-
-/**
- * Success response from the bridge SDK.
+ * Represents the response shape from a JSBridge method call. Use with specific status codes
+ * to constrain which responses are possible, or use `BridgeStatusCode` for the full union.
  *
- * @remarks
- * Returned when a JSBridge method completes successfully.
- * The `result` field contains the JSBridge method's data.
+ * This type works for both single (non-streaming) responses and as the item type
+ * emitted by {@link BridgeStream}.
  *
- * @public
- */
-export declare type BridgeStatusCode200Response<T> = {
-    /** HTTP-style status code indicating the outcome of the JSBridge method call */
-    status_code: 200;
-    /** The result data from the JSBridge method, or undefined if no result was returned */
-    result: T;
-};
-
-/**
- * No result response with status code 204.
+ * Status codes come first in the type parameters for better readability at module call sites.
  *
- * @remarks
- * Returned when a JSBridge method completes with no content (e.g., user cancelled a dialog).
- * No `result` or `error` data is returned.
+ * @example
+ * ```typescript
+ * // Constrained to specific status codes (common case)
+ * type SuccessOrError = BridgeResponse<200 | 500, string>;
  *
- * @public
- */
-export declare type BridgeStatusCode204Response = {
-    /** HTTP-style status code indicating the outcome of the JSBridge method call */
-    status_code: 204;
-};
-
-/**
- * Redirect response with status code 302.
+ * // Only success
+ * type OnlySuccess = BridgeResponse<200, string>;
  *
- * @remarks
- * Returned when a JSBridge method initiates a redirect (e.g., OAuth2 redirect flow).
- * No `result` or `error` data is returned as the page will navigate away.
+ * // Unconstrained - all status codes possible (internal use)
+ * type AnyResponse = BridgeResponse<BridgeStatusCode, string>;
+ * ```
  *
  * @public
  */
-export declare type BridgeStatusCode302Response = {
-    /** HTTP-style status code indicating the outcome of the JSBridge method call */
-    status_code: 302;
-};
+export declare type BridgeResponse<Codes extends BridgeStatusCode = BridgeStatusCode, T = void> = StatusCodeMap<T>[Codes];
 
 /**
- * Error response with status code 400
+ * Union type representing server error JSBridge responses (5xx status codes).
+ * Includes status codes 500 (Internal Server Error) and 501 (Not Implemented).
  *
  * @public
  */
-export declare type BridgeStatusCode400Response = {
-    /** HTTP-style status code indicating the outcome of the JSBridge method call */
-    status_code: 400;
-    /** Error message if the call failed */
-    error: string;
-};
+export declare type BridgeServerError = ResponseStatusCode500 | ResponseStatusCode501;
 
 /**
- * Error response with status code 401
+ * Helper type representing all possible JSBridge status codes.
  *
  * @public
  */
-export declare type BridgeStatusCode401Response = {
-    /** HTTP-style status code indicating the outcome of the JSBridge method call */
-    status_code: 401;
-    /** Error message if the call failed */
-    error: string;
-};
+export declare type BridgeStatusCode = keyof StatusCodeMap<unknown>;
 
 /**
- * Error response with status code 403
+ * A stream for receiving continuous data from JSBridge methods (e.g., location updates).
  *
- * @public
- */
-export declare type BridgeStatusCode403Response = {
-    /** HTTP-style status code indicating the outcome of the JSBridge method call */
-    status_code: 403;
-    /** Error message if the call failed */
-    error: string;
-};
-
-/**
- * Error response with status code 404
+ * @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
  *
- * @public
- */
-export declare type BridgeStatusCode404Response = {
-    /** HTTP-style status code indicating the outcome of the JSBridge method call */
-    status_code: 404;
-    /** Error message if the call failed */
-    error: string;
-};
-
-/**
- * Error response with status code 424
+ * Note: Each `subscribe()` call creates a fresh subscription, allowing multiple independent listeners.
  *
- * @public
- */
-export declare type BridgeStatusCode424Response = {
-    /** HTTP-style status code indicating the outcome of the JSBridge method call */
-    status_code: 424;
-    /** Error message if the call failed */
-    error: string;
-};
-
-/**
- * Error response with status code 500
+ * @typeParam Codes - The status codes that can be emitted by the stream.
+ * @typeParam T - The type of data emitted by the stream.
  *
  * @public
  */
-export declare type BridgeStatusCode500Response = {
-    /** HTTP-style status code indicating the outcome of the JSBridge method call */
-    status_code: 500;
-    /** Error message if the call failed */
-    error: string;
-};
+export declare type BridgeStream<Codes extends BridgeStatusCode = BridgeStatusCode, T = void> = 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<Codes, T>) => Subscription;
+}> & PromiseLike<BridgeResponse<Codes, T>>;
 
 /**
- * Error response with status code 501
+ * Callbacks for handling stream events.
  *
  * @remarks
- * Returned when a JSBridge method is called outside the Grab app environment.
- * This indicates the method is not implemented in the current environment.
+ * Pass these to `subscribe()` to receive data via `next` and completion via `complete`.
+ *
+ * @typeParam Codes - The status codes that can be emitted by the stream.
+ * @typeParam T - The type of data emitted by the stream.
  *
  * @public
  */
-export declare type BridgeStatusCode501Response = {
-    /** HTTP-style status code indicating the outcome of the JSBridge method call */
-    status_code: 501;
-    /** Error message indicating the method is not available in this environment */
-    error: string;
-};
+export declare type BridgeStreamHandlers<Codes extends BridgeStatusCode = BridgeStatusCode, T = void> = Readonly<{
+    /** Called with each new value from the stream. */
+    next?: (data: BridgeResponse<Codes, T>) => unknown;
+    /** Called when the stream ends and no more data will arrive. */
+    complete?: () => unknown;
+}>;
 
 /**
  * Union type representing all successful JSBridge responses.
@@ -378,7 +358,7 @@ export declare type BridgeStatusCode501Response = {
  *
  * @public
  */
-export declare type BridgeSuccessResponse<T> = BridgeStatusCode200Response<T> | BridgeStatusCode204Response;
+export declare type BridgeSuccessResponse<T> = ResponseStatusCode200<T> | ResponseStatusCode204;
 
 /**
  * JSBridge module for accessing the device camera.
@@ -406,6 +386,7 @@ export declare type BridgeSuccessResponse<T> = BridgeStatusCode200Response<T> |
  * ```
  *
  * @public
+ * @noInheritDoc
  */
 export declare class CameraModule extends BaseModule {
     constructor();
@@ -416,48 +397,37 @@ export declare class CameraModule extends BaseModule {
      *
      * @returns The QR code scanning result, containing the scanned code on success or status information.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { CameraModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { CameraModule } = window.SuperAppSDK;
-     *
      * // Initialize the camera module
      * const cameraModule = new CameraModule();
      *
      * // Scan the QR code
-     * try {
-     *   const response = await cameraModule.scanQRCode({ title: 'Scan Payment QR' });
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('QR Code scanned:', response.result.qrCode);
-     *       break;
-     *     case 204:
-     *       console.log('User cancelled QR code scanning');
-     *       break;
-     *     case 400:
-     *       console.log('Bad request:', response.error);
-     *       break;
-     *     case 403:
-     *       console.log('Camera permission is not enabled for the Grab app');
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await cameraModule.scanQRCode({ title: 'Scan Payment QR' });
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('QR Code scanned:', response.result.qrCode);
+     *     break;
+     *   case 204:
+     *     console.log('User cancelled QR code scanning');
+     *     break;
+     *   case 400:
+     *     console.log('Bad request:', response.error);
+     *     break;
+     *   case 403:
+     *     console.log('Camera permission is not enabled for the Grab app');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      * @public
      */
-    scanQRCode(request: ScanQRCodeRequest): ScanQRCodeResponse;
+    scanQRCode(request: ScanQRCodeRequest): Promise<ScanQRCodeResponse>;
 }
 
 /**
@@ -486,6 +456,7 @@ export declare class CameraModule extends BaseModule {
  * ```
  *
  * @public
+ * @noInheritDoc
  */
 export declare class CheckoutModule extends BaseModule {
     constructor();
@@ -496,53 +467,42 @@ export declare class CheckoutModule extends BaseModule {
      *
      * @returns The checkout result, containing transaction status (success, failure, or pending) and transaction details.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { CheckoutModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { CheckoutModule } = window.SuperAppSDK;
-     *
      * // Initialize the checkout module
      * const checkoutModule = new CheckoutModule();
      *
      * // Trigger checkout with response params
-     * try {
-     *   const transactionResponse = await createTransaction(); // Call POST /grabpay/partner/v4/charge/init from Grab API to create a transaction
-     *   const response = await checkoutModule.triggerCheckout(transactionResponse);
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       if (response.result.status === 'success') {
-     *         console.log('Transaction successful:', response.result.transactionID);
-     *       } else if (response.result.status === 'failure') {
-     *         console.log('Transaction failed:', response.result.errorMessage, response.result.errorCode);
-     *       } else if (response.result.status === 'pending') {
-     *         console.log('Transaction pending:', response.result.transactionID);
-     *       } else if (response.result.status === 'userInitiatedCancel') {
-     *         console.log('User cancelled the checkout');
-     *       }
-     *       break;
-     *     case 400:
-     *       console.log('Transaction failed:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Could not trigger checkout:', error);
+     * const transactionResponse = await createTransaction(); // Call POST /grabpay/partner/v4/charge/init from Grab API to create a transaction
+     * const response = await checkoutModule.triggerCheckout(transactionResponse);
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     if (response.result.status === 'success') {
+     *       console.log('Transaction successful:', response.result.transactionID);
+     *     } else if (response.result.status === 'failure') {
+     *       console.log('Transaction failed:', response.result.errorMessage, response.result.errorCode);
+     *     } else if (response.result.status === 'pending') {
+     *       console.log('Transaction pending:', response.result.transactionID);
+     *     } else if (response.result.status === 'userInitiatedCancel') {
+     *       console.log('User cancelled the checkout');
+     *     }
+     *     break;
+     *   case 400:
+     *     console.log('Transaction failed:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    triggerCheckout(request: TriggerCheckoutRequest): TriggerCheckoutResponse;
+    triggerCheckout(request: TriggerCheckoutRequest): Promise<TriggerCheckoutResponse>;
 }
 
 /**
@@ -559,7 +519,7 @@ export declare class CheckoutModule extends BaseModule {
  *
  * @public
  */
-export declare type ClearAuthorizationArtifactsResponse = Promise<ConstrainedBridgeResponse<ClearAuthorizationArtifactsResult, 204>>;
+export declare type ClearAuthorizationArtifactsResponse = BridgeResponse<204, ClearAuthorizationArtifactsResult>;
 
 /**
  * Result object for clearing authorization artifacts.
@@ -575,6 +535,7 @@ export declare type ClearAuthorizationArtifactsResult = void;
  * @remarks
  * This response can have the following status codes:
  * - `200`: Container closed successfully.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -592,9 +553,18 @@ export declare type ClearAuthorizationArtifactsResult = void;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type CloseResponse = Promise<ConstrainedBridgeResponse<CloseResult, 200 | 501>>;
+export declare type CloseResponse = BridgeResponse<200 | 500 | 501, CloseResult>;
 
 /**
  * Result when closing the container.
@@ -604,25 +574,6 @@ export declare type CloseResponse = Promise<ConstrainedBridgeResponse<CloseResul
  */
 export declare type CloseResult = void;
 
-/**
- * Create a constrained JSBridge response type with only specific status codes.
- *
- * @example
- * ```typescript
- * // Only status code 200
- * type OnlySuccess = ConstrainedBridgeResponse<string, 200>;
- *
- * // Only status codes 200 and 500
- * type SuccessOrServerError = ConstrainedBridgeResponse<string, 200 | 500>;
- *
- * // Only error status codes
- * type OnlyErrors = ConstrainedBridgeResponse<string, 400 | 403 | 424 | 500>;
- * ```
- *
- * @public
- */
-export declare type ConstrainedBridgeResponse<T, Codes extends keyof StatusCodeMap<T>> = StatusCodeMap<T>[Codes];
-
 /**
  * Constants for container analytics event data.
  *
@@ -681,6 +632,7 @@ export declare const ContainerAnalyticsEventState: {
  * ```
  *
  * @public
+ * @noInheritDoc
  */
 export declare class ContainerModule extends BaseModule {
     constructor();
@@ -691,44 +643,33 @@ export declare class ContainerModule extends BaseModule {
      *
      * @returns Confirmation that the background color was set.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Set background color
-     * try {
-     *   const response = await containerModule.setBackgroundColor('#ffffff');
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Background color set successfully');
-     *       break;
-     *     case 400:
-     *       console.log('Could not set background color:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await containerModule.setBackgroundColor('#ffffff');
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Background color set successfully');
+     *     break;
+     *   case 400:
+     *     console.log('Could not set background color:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    setBackgroundColor(request: SetBackgroundColorRequest): SetBackgroundColorResponse;
+    setBackgroundColor(request: SetBackgroundColorRequest): Promise<SetBackgroundColorResponse>;
     /**
      * Set the title of the container header.
      *
@@ -736,272 +677,195 @@ export declare class ContainerModule extends BaseModule {
      *
      * @returns Confirmation that the title was set.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Set title
-     * try {
-     *   const response = await containerModule.setTitle('Home');
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Title set successfully');
-     *       break;
-     *     case 400:
-     *       console.log('Could not set title:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await containerModule.setTitle('Home');
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Title set successfully');
+     *     break;
+     *   case 400:
+     *     console.log('Could not set title:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    setTitle(request: SetTitleRequest): SetTitleResponse;
+    setTitle(request: SetTitleRequest): Promise<SetTitleResponse>;
     /**
      * Hide the back button on the container header.
      *
      * @returns Confirmation that the back button is now hidden.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Hide back button
-     * try {
-     *   const response = await containerModule.hideBackButton();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Back button hidden successfully');
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await containerModule.hideBackButton();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Back button hidden successfully');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
      * }
      * ```
      *
      * @public
      */
-    hideBackButton(): HideBackButtonResponse;
+    hideBackButton(): Promise<HideBackButtonResponse>;
     /**
      * Show the back button on the container header.
      *
      * @returns Confirmation that the back button is now visible.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Show back button
-     * try {
-     *   const response = await containerModule.showBackButton();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Back button shown successfully');
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await containerModule.showBackButton();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Back button shown successfully');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
      * }
      * ```
      *
      * @public
      */
-    showBackButton(): ShowBackButtonResponse;
+    showBackButton(): Promise<ShowBackButtonResponse>;
     /**
      * Hide the refresh button on the container header.
      *
      * @returns Confirmation that the refresh button is now hidden.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Hide refresh button
-     * try {
-     *   const response = await containerModule.hideRefreshButton();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Refresh button hidden successfully');
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await containerModule.hideRefreshButton();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Refresh button hidden successfully');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
      * }
      * ```
      *
      * @public
      */
-    hideRefreshButton(): HideRefreshButtonResponse;
+    hideRefreshButton(): Promise<HideRefreshButtonResponse>;
     /**
      * Show the refresh button on the container header.
      *
      * @returns Confirmation that the refresh button is now visible.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Show refresh button
-     * try {
-     *   const response = await containerModule.showRefreshButton();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Refresh button shown successfully');
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await containerModule.showRefreshButton();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Refresh button shown successfully');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
      * }
      * ```
      *
      * @public
      */
-    showRefreshButton(): ShowRefreshButtonResponse;
+    showRefreshButton(): Promise<ShowRefreshButtonResponse>;
     /**
      * Close the container and return to the previous screen.
      *
      * @returns Confirmation that the container is closing.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Close the container
-     * try {
-     *   const response = await containerModule.close();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Container closed successfully');
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await containerModule.close();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Container closed successfully');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
      * }
      * ```
      *
      * @public
      */
-    close(): CloseResponse;
+    close(): Promise<CloseResponse>;
     /**
      * Notify the Grab SuperApp that the page content has loaded.
      *
      * @returns Confirmation that the content loaded notification was sent.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Notify content loaded
-     * try {
-     *   const response = await containerModule.onContentLoaded();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Content loaded notification sent successfully');
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await containerModule.onContentLoaded();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Content loaded notification sent successfully');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
      * }
      * ```
      *
      * @public
      */
-    onContentLoaded(): OnContentLoadedResponse;
+    onContentLoaded(): Promise<OnContentLoadedResponse>;
     /**
      * Show the full-screen loading indicator.
      *
@@ -1010,39 +874,28 @@ export declare class ContainerModule extends BaseModule {
      *
      * @returns Confirmation that the loader is now visible.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Show loader
-     * try {
-     *   const response = await containerModule.showLoader();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Loader shown successfully');
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await containerModule.showLoader();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Loader shown successfully');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
      * }
      * ```
      *
      * @public
      */
-    showLoader(): ShowLoaderResponse;
+    showLoader(): Promise<ShowLoaderResponse>;
     /**
      * Hide the full-screen loading indicator.
      *
@@ -1051,39 +904,28 @@ export declare class ContainerModule extends BaseModule {
      *
      * @returns Confirmation that the loader is now hidden.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Hide loader
-     * try {
-     *   const response = await containerModule.hideLoader();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Loader hidden successfully');
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await containerModule.hideLoader();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Loader hidden successfully');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
      * }
      * ```
      *
      * @public
      */
-    hideLoader(): HideLoaderResponse;
+    hideLoader(): Promise<HideLoaderResponse>;
     /**
      * Open a link in the external browser.
      *
@@ -1094,44 +936,33 @@ export declare class ContainerModule extends BaseModule {
      *
      * @returns Confirmation of whether the external link was opened successfully.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Open external link
-     * try {
-     *   const response = await containerModule.openExternalLink('https://grab.com');
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('External link opened successfully');
-     *       break;
-     *     case 400:
-     *       console.log('Could not open external link:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await containerModule.openExternalLink('https://grab.com');
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('External link opened successfully');
+     *     break;
+     *   case 400:
+     *     console.log('Could not open external link:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    openExternalLink(request: OpenExternalLinkRequest): OpenExternalLinkResponse;
+    openExternalLink(request: OpenExternalLinkRequest): Promise<OpenExternalLinkResponse>;
     /**
      * Notify the client that the user has tapped a call-to-action (CTA).
      *
@@ -1139,39 +970,28 @@ export declare class ContainerModule extends BaseModule {
      *
      * @returns Confirmation that the CTA tap was notified.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Notify CTA tap
-     * try {
-     *   const response = await containerModule.onCtaTap('AV_LANDING_PAGE_CONTINUE');
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('CTA tap notified successfully');
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await containerModule.onCtaTap('AV_LANDING_PAGE_CONTINUE');
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('CTA tap notified successfully');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
      * }
      * ```
      *
      * @public
      */
-    onCtaTap(request: OnCtaTapRequest): OnCtaTapResponse;
+    onCtaTap(request: OnCtaTapRequest): Promise<OnCtaTapResponse>;
     /**
      * Use this method to track user interactions and page transitions.
      *
@@ -1195,13 +1015,11 @@ export declare class ContainerModule extends BaseModule {
      * ```typescript
      * // Imports using ES Module built
      * import {
-     *   ContainerModule,
      *   ContainerAnalyticsEventState,
      *   ContainerAnalyticsEventName,
      * } from '@grabjs/superapp-sdk';
      * // Imports using UMD built (via CDN)
      * const {
-     *   ContainerModule,
      *   ContainerAnalyticsEventState,
      *   ContainerAnalyticsEventName,
      * } = window.SuperAppSDK;
@@ -1210,33 +1028,29 @@ export declare class ContainerModule extends BaseModule {
      * const containerModule = new ContainerModule();
      *
      * // Send analytics event
-     * try {
-     *   const response = await containerModule.sendAnalyticsEvent({
-     *     state: ContainerAnalyticsEventState.HOMEPAGE,
-     *     name: ContainerAnalyticsEventName.DEFAULT,
-     *   });
+     * const response = await containerModule.sendAnalyticsEvent({
+     *   state: ContainerAnalyticsEventState.HOMEPAGE,
+     *   name: ContainerAnalyticsEventName.DEFAULT,
+     * });
      *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Analytics event sent successfully');
-     *       break;
-     *     case 400:
-     *       console.log('Invalid analytics event parameters:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Analytics event sent successfully');
+     *     break;
+     *   case 400:
+     *     console.log('Invalid analytics event parameters:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    sendAnalyticsEvent(request: SendAnalyticsEventRequest): SendAnalyticsEventResponse;
+    sendAnalyticsEvent(request: SendAnalyticsEventRequest): Promise<SendAnalyticsEventResponse>;
     /**
      * Check if the web app is connected to the Grab SuperApp via JSBridge.
      *
@@ -1245,41 +1059,30 @@ export declare class ContainerModule extends BaseModule {
      *
      * @returns The connection status, indicating whether the MiniApp is running inside the Grab SuperApp.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Check connection status
-     * try {
-     *   const response = await containerModule.isConnected();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Connected to Grab SuperApp');
-     *       break;
-     *     case 404:
-     *       console.log('Not connected to Grab SuperApp');
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await containerModule.isConnected();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Connected to Grab SuperApp');
+     *     break;
+     *   case 404:
+     *     console.log('Not connected to Grab SuperApp');
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    isConnected(): IsConnectedResponse;
+    isConnected(): Promise<IsConnectedResponse>;
     /**
      * Get the session parameters from the container.
      *
@@ -1290,41 +1093,30 @@ export declare class ContainerModule extends BaseModule {
      *
      * @returns The session parameters as a JSON string that can be parsed into an object.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ContainerModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ContainerModule } = window.SuperAppSDK;
-     *
      * // Initialize the container module
      * const containerModule = new ContainerModule();
      *
      * // Get session parameters
-     * try {
-     *   const response = await containerModule.getSessionParams();
-     *
-     *   switch (response.status_code) {
-     *     case 200: {
-     *       const sessionParams = JSON.parse(response.result?.result || '{}');
-     *       console.log('Session params retrieved:', sessionParams);
-     *       break;
-     *     }
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
+     * const response = await containerModule.getSessionParams();
+     *
+     * switch (response.status_code) {
+     *   case 200: {
+     *     const sessionParams = JSON.parse(response.result?.result || '{}');
+     *     console.log('Session params retrieved:', sessionParams);
+     *     break;
      *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
      * }
      * ```
      *
      * @public
      */
-    getSessionParams(): GetSessionParamsResponse;
+    getSessionParams(): Promise<GetSessionParamsResponse>;
     /**
      * Validate the analytics event details.
      *
@@ -1336,45 +1128,144 @@ export declare class ContainerModule extends BaseModule {
 }
 
 /**
- * A stream for receiving continuous data from JSBridge methods (e.g., location updates).
+ * JSBridge module for querying native device capability information.
+ *
+ * @group Modules
  *
  * @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
+ * Provides access to device capability checks exposed by the native Grab app bridge.
+ * This code must run on the Grab SuperApp's webview to function correctly.
  *
- * Note: Each `subscribe()` call creates a fresh subscription, allowing multiple independent listeners.
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { DeviceCapabilityModule } from '@grabjs/superapp-sdk';
+ * const deviceCapabilityModule = new DeviceCapabilityModule();
+ * ```
  *
- * @typeParam T - The type of data emitted by the stream.
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const deviceCapabilityModule = new SuperAppSDK.DeviceCapabilityModule();
+ * </script>
+ * ```
  *
  * @public
+ * @noInheritDoc
  */
-export declare type DataStream<T> = Readonly<{
+export declare class DeviceCapabilityModule extends BaseModule {
+    constructor();
     /**
-     * Subscribe to receive stream data.
+     * Checks whether the current device supports eSIM.
      *
-     * @param handlers - Optional callbacks for data (`next`) and completion (`complete`).
-     * @returns A `Subscription` to terminate the stream when needed.
+     * @returns Whether eSIM is supported on the current device.
+     *
+     * @example
+     * **Simple usage**
+     * ```typescript
+     * // Initialize the device capability module
+     * const deviceCapabilityModule = new DeviceCapabilityModule();
+     *
+     * // Check eSIM support
+     * const response = await deviceCapabilityModule.isEsimSupported();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('eSIM supported:', response.result);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
+     * }
+     * ```
+     *
+     * @public
      */
-    subscribe: (handlers?: DataStreamHandlers<T>) => Subscription;
-}> & PromiseLike<BridgeResponse<T>>;
+    isEsimSupported(): Promise<IsEsimSupportedResponse>;
+}
 
 /**
- * Callbacks for handling stream events.
+ * Request parameters for downloading a file via native bridge.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   fileUrl: 'https://example.com/report.pdf',
+ *   fileName: 'report.pdf'
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare type DownloadFileRequest = {
+    /** The URL of the file to download. */
+    fileUrl: string;
+    /** The desired name for the downloaded file. */
+    fileName: string;
+};
+
+/**
+ * Response when requesting a native file download.
  *
  * @remarks
- * Pass these to `subscribe()` to receive data via `next` and completion via `complete`.
+ * This response can have the following status codes:
+ * - `204`: File downloaded successfully.
+ * - `400`: Invalid request parameters such as invalid file URL, invalid domain, or missing file name.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
+ * - `501`: Not implemented - this method requires the Grab app environment.
  *
- * @typeParam T - The type of data emitted by the stream.
+ * @example
+ * **Success response (204):**
+ * ```typescript
+ * {
+ *   status_code: 204
+ * }
+ * ```
+ *
+ * @example
+ * **Bad request response (400):**
+ * ```typescript
+ * {
+ *   status_code: 400,
+ *   error: 'Invalid request'
+ * }
+ * ```
+ *
+ * @example
+ * **Not implemented response (501) - outside Grab app:**
+ * ```typescript
+ * {
+ *   status_code: 501,
+ *   error: 'Not implemented: This method requires the Grab app environment'
+ * }
+ * ```
+ *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
  *
  * @public
  */
-export declare type DataStreamHandlers<T> = Readonly<{
-    /** Called with each new value from the stream. */
-    next?: (data: BridgeResponse<T>) => unknown;
-    /** Called when the stream ends and no more data will arrive. */
-    complete?: () => unknown;
-}>;
+export declare type DownloadFileResponse = BridgeResponse<204 | 400 | 500 | 501, DownloadFileResult>;
+
+/**
+ * Result data structure for file download operations.
+ *
+ * @remarks
+ * This is a void result type as successful downloads return status code 204 with no content.
+ *
+ * @public
+ */
+export declare type DownloadFileResult = void;
 
 /**
  * DRM content configuration for playback.
@@ -1436,12 +1327,27 @@ export declare type DRMContentConfig = Record<string, unknown>;
  * @public
  */
 export declare type DRMPlaybackEvent = {
-    /** The type of playback event (e.g., 'started', 'paused', 'ended', 'error'). */
-    eventType: string;
+    /** The type of playback event. */
+    eventType: 'started' | 'paused' | 'ended' | 'error';
     /** Additional event data as key-value pairs. */
     data?: Record<string, unknown>;
 };
 
+/**
+ * Generic error response shape with a specific status code.
+ * Used as the base for all error response types (4xx and 5xx).
+ *
+ * @typeParam Code - The HTTP status code (e.g., 400, 401, 500)
+ *
+ * @public
+ */
+export declare type ErrorResponse<Code extends number> = {
+    /** HTTP-style status code indicating the outcome of the JSBridge method call */
+    status_code: Code;
+    /** Error message if the call failed */
+    error: string;
+};
+
 /**
  * Response when fetching the user's email.
  *
@@ -1449,7 +1355,8 @@ export declare type DRMPlaybackEvent = {
  * This response can have the following status codes:
  * - `200`: Email fetched successfully. The `result` contains the email address.
  * - `400`: Invalid request - the request was malformed.
- * - `403`: Forbidden - feature requires Grab app version 5.399 or above.
+ * - `426`: Upgrade Required - feature requires Grab app version 5.399 or above.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -1471,11 +1378,11 @@ export declare type DRMPlaybackEvent = {
  * ```
  *
  * @example
- * **Forbidden response (403):**
+ * **Upgrade Required response (426):**
  * ```typescript
  * {
- *   status_code: 403,
- *   error: 'This feature requires Grab app version 5.399 or above.'
+ *   status_code: 426,
+ *   error: 'Upgrade Required: This method requires Grab app version 5.399.0 or above on iOS'
  * }
  * ```
  *
@@ -1488,9 +1395,18 @@ export declare type DRMPlaybackEvent = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type FetchEmailResponse = Promise<ConstrainedBridgeResponse<FetchEmailResult, 200 | 400 | 403 | 501>>;
+export declare type FetchEmailResponse = BridgeResponse<200 | 400 | 426 | 500 | 501, FetchEmailResult>;
 
 /**
  * Result object containing the user's email address.
@@ -1507,6 +1423,78 @@ export declare type FetchEmailResult = {
     email: string;
 };
 
+/**
+ * JSBridge module for downloading files to the user's device.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Initiates native file download handling in the Grab app using a file URL and file name.
+ * This code must run on the Grab SuperApp's webview to function correctly.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { FileModule } from '@grabjs/superapp-sdk';
+ * const fileModule = new FileModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const fileModule = new SuperAppSDK.FileModule();
+ * </script>
+ * ```
+ *
+ * @public
+ * @noInheritDoc
+ */
+export declare class FileModule extends BaseModule {
+    constructor();
+    /**
+     * Downloads a file via the native bridge.
+     *
+     * @param request - File information, including URL and target file name.
+     *
+     * @returns Download operation result.
+     *
+     * @example
+     * **Simple usage**
+     * ```typescript
+     * // Initialize the file module
+     * const fileModule = new FileModule();
+     *
+     * // Download the file
+     * const response = await fileModule.downloadFile({
+     *   fileUrl: 'https://example.com/report.pdf',
+     *   fileName: 'report.pdf',
+     * });
+     *
+     * switch (response.status_code) {
+     *   case 204:
+     *     console.log('File downloaded successfully');
+     *     break;
+     *   case 400:
+     *     console.log('Bad request:', response.error);
+     *     break;
+     *   case 500:
+     *     console.log('Internal server error:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
+     * }
+     * ```
+     *
+     * @public
+     */
+    downloadFile(request: DownloadFileRequest): Promise<DownloadFileResponse>;
+}
+
 /**
  * Response when retrieving stored authorization artifacts.
  *
@@ -1547,7 +1535,7 @@ export declare type FetchEmailResult = {
  *
  * @public
  */
-export declare type GetAuthorizationArtifactsResponse = Promise<ConstrainedBridgeResponse<GetAuthorizationArtifactsResult, 200 | 204 | 400>>;
+export declare type GetAuthorizationArtifactsResponse = BridgeResponse<200 | 204 | 400, GetAuthorizationArtifactsResult>;
 
 /**
  * Result object containing the stored PKCE authorization artifacts.
@@ -1581,7 +1569,7 @@ export declare type GetAuthorizationArtifactsResult = {
     nonce: string;
     /** The redirect URI used in the authorization request. */
     redirectUri: string;
-} | null;
+};
 
 /**
  * Request parameters for getting a boolean value from storage.
@@ -1605,6 +1593,7 @@ export declare type GetBooleanRequest = {
  * This response can have the following status codes:
  * - `200`: Value retrieved successfully. The `result` contains the boolean value or null if not found.
  * - `400`: Missing required parameters - key not provided.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -1643,9 +1632,18 @@ export declare type GetBooleanRequest = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type GetBooleanResponse = Promise<ConstrainedBridgeResponse<GetBooleanResult, 200 | 400 | 501>>;
+export declare type GetBooleanResponse = BridgeResponse<200 | 400 | 500 | 501, GetBooleanResult>;
 
 /**
  * Result object containing the boolean value.
@@ -1676,6 +1674,7 @@ export declare type GetBooleanResult = {
  * This response can have the following status codes:
  * - `200`: Coordinates retrieved successfully. The `result` contains latitude and longitude.
  * - `424`: GeoKit error - location services unavailable or permission denied.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -1705,9 +1704,18 @@ export declare type GetBooleanResult = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type GetCoordinateResponse = Promise<ConstrainedBridgeResponse<GetCoordinateResult, 200 | 424 | 501>>;
+export declare type GetCoordinateResponse = BridgeResponse<200 | 424 | 500 | 501, GetCoordinateResult>;
 
 /**
  * Result object containing the geographic coordinates.
@@ -1733,6 +1741,7 @@ export declare type GetCoordinateResult = {
  * This response can have the following status codes:
  * - `200`: Country code retrieved successfully. The `result` contains the ISO country code.
  * - `424`: GeoKit/Resolver error - location services unavailable.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -1771,9 +1780,18 @@ export declare type GetCoordinateResult = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type GetCountryCodeResponse = Promise<ConstrainedBridgeResponse<GetCountryCodeResult, 200 | 424 | 501>>;
+export declare type GetCountryCodeResponse = BridgeResponse<200 | 424 | 500 | 501, GetCountryCodeResult>;
 
 /**
  * Result object containing the country code.
@@ -1817,6 +1835,7 @@ export declare type GetDoubleRequest = {
  * This response can have the following status codes:
  * - `200`: Value retrieved successfully. The `result` contains the double value or null if not found.
  * - `400`: Missing required parameters - key not provided.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -1855,9 +1874,18 @@ export declare type GetDoubleRequest = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type GetDoubleResponse = Promise<ConstrainedBridgeResponse<GetDoubleResult, 200 | 400 | 501>>;
+export declare type GetDoubleResponse = BridgeResponse<200 | 400 | 500 | 501, GetDoubleResult>;
 
 /**
  * Result object containing the double value.
@@ -1903,6 +1931,7 @@ export declare type GetIntRequest = {
  * This response can have the following status codes:
  * - `200`: Value retrieved successfully. The `result` contains the integer value or null if not found.
  * - `400`: Missing required parameters - key not provided.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -1941,9 +1970,18 @@ export declare type GetIntRequest = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type GetIntResponse = Promise<ConstrainedBridgeResponse<GetIntResult, 200 | 400 | 501>>;
+export declare type GetIntResponse = BridgeResponse<200 | 400 | 500 | 501, GetIntResult>;
 
 /**
  * Result object containing the integer value.
@@ -1973,6 +2011,7 @@ export declare type GetIntResult = {
  * @remarks
  * This response can have the following status codes:
  * - `200`: Locale identifier retrieved successfully.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -2002,9 +2041,18 @@ export declare type GetIntResult = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type GetLanguageLocaleIdentifierResponse = Promise<ConstrainedBridgeResponse<GetLanguageLocaleIdentifierResult, 200 | 501>>;
+export declare type GetLanguageLocaleIdentifierResponse = BridgeResponse<200 | 500 | 501, GetLanguageLocaleIdentifierResult>;
 
 /**
  * Result object containing the language locale identifier.
@@ -2036,12 +2084,79 @@ export declare type GetLanguageLocaleIdentifierResponse = Promise<ConstrainedBri
  */
 export declare type GetLanguageLocaleIdentifierResult = string;
 
+/**
+ * Response when reading the selected travel destination lowercase ISO 3166-1 alpha-2 country code.
+ *
+ * @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.
+ * - `204`: No selected travel destination is currently available.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
+ * - `501`: Not implemented - this method requires the Grab app environment.
+ *
+ * @example
+ * **Success response (200):**
+ * ```typescript
+ * {
+ *   status_code: 200,
+ *   result: 'id'
+ * }
+ * ```
+ *
+ * @example
+ * **No content response (204):**
+ * ```typescript
+ * {
+ *   status_code: 204
+ * }
+ * ```
+ *
+ * @example
+ * **Not implemented response (501) - outside Grab app:**
+ * ```typescript
+ * {
+ *   status_code: 501,
+ *   error: 'Not implemented: This method requires the Grab app environment'
+ * }
+ * ```
+ *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare type GetSelectedTravelDestinationResponse = BridgeResponse<200 | 204 | 500 | 501, GetSelectedTravelDestinationResult>;
+
+/**
+ * Result containing the selected travel destination lowercase ISO 3166-1 alpha-2 country code.
+ *
+ * @example
+ * ```typescript
+ * 'id'
+ * ```
+ *
+ * @example
+ * ```typescript
+ * 'sg'
+ * ```
+ *
+ * @public
+ */
+export declare type GetSelectedTravelDestinationResult = string;
+
 /**
  * Response when getting session parameters.
  *
  * @remarks
  * This response can have the following status codes:
  * - `200`: Session parameters retrieved successfully.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -2062,9 +2177,18 @@ export declare type GetLanguageLocaleIdentifierResult = string;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type GetSessionParamsResponse = Promise<ConstrainedBridgeResponse<GetSessionParamsResult, 200 | 501>>;
+export declare type GetSessionParamsResponse = BridgeResponse<200 | 500 | 501, GetSessionParamsResult>;
 
 /**
  * Result object containing session parameters as a JSON string.
@@ -2108,6 +2232,7 @@ export declare type GetStringRequest = {
  * This response can have the following status codes:
  * - `200`: Value retrieved successfully. The `result` contains the string value or null if not found.
  * - `400`: Missing required parameters - key not provided.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -2146,9 +2271,18 @@ export declare type GetStringRequest = {
  * }
  * ```
  *
- * @public
- */
-export declare type GetStringResponse = Promise<ConstrainedBridgeResponse<GetStringResult, 200 | 400 | 501>>;
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare type GetStringResponse = BridgeResponse<200 | 400 | 500 | 501, GetStringResult>;
 
 /**
  * Result object containing the string value.
@@ -2172,6 +2306,17 @@ export declare type GetStringResult = {
     value: string | null;
 };
 
+/**
+ * Represents parsed information from a Grab app user agent string.
+ *
+ * @public
+ */
+export declare interface GrabAppInfo {
+    appName: string;
+    version: Version;
+    platform: Platform;
+}
+
 /**
  * Response when checking API access permissions.
  *
@@ -2180,6 +2325,7 @@ export declare type GetStringResult = {
  * - `200`: Access check completed successfully. The `result` contains the access status.
  * - `400`: Missing required parameters - module or method not provided.
  * - `424`: ScopeKit error - unable to check access due to a dependency error.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -2227,9 +2373,18 @@ export declare type GetStringResult = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type HasAccessToResponse = Promise<ConstrainedBridgeResponse<HasAccessToResult, 200 | 400 | 424 | 501>>;
+export declare type HasAccessToResponse = BridgeResponse<200 | 400 | 424 | 500 | 501, HasAccessToResult>;
 
 /**
  * Result object containing the access check result.
@@ -2259,6 +2414,7 @@ export declare type HasAccessToResult = {
  * @remarks
  * This response can have the following status codes:
  * - `200`: Back button hidden successfully.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -2276,9 +2432,18 @@ export declare type HasAccessToResult = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type HideBackButtonResponse = Promise<ConstrainedBridgeResponse<HideBackButtonResult, 200 | 501>>;
+export declare type HideBackButtonResponse = BridgeResponse<200 | 500 | 501, HideBackButtonResult>;
 
 /**
  * Result when hiding the back button.
@@ -2294,6 +2459,7 @@ export declare type HideBackButtonResult = void;
  * @remarks
  * This response can have the following status codes:
  * - `200`: Loader hidden successfully.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -2311,9 +2477,18 @@ export declare type HideBackButtonResult = void;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type HideLoaderResponse = Promise<ConstrainedBridgeResponse<HideLoaderResult, 200 | 501>>;
+export declare type HideLoaderResponse = BridgeResponse<200 | 500 | 501, HideLoaderResult>;
 
 /**
  * Result when hiding the loader.
@@ -2329,6 +2504,7 @@ export declare type HideLoaderResult = void;
  * @remarks
  * This response can have the following status codes:
  * - `200`: Refresh button hidden successfully.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -2346,9 +2522,18 @@ export declare type HideLoaderResult = void;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type HideRefreshButtonResponse = Promise<ConstrainedBridgeResponse<HideRefreshButtonResult, 200 | 501>>;
+export declare type HideRefreshButtonResponse = BridgeResponse<200 | 500 | 501, HideRefreshButtonResult>;
 
 /**
  * Result when hiding the refresh button.
@@ -2385,6 +2570,7 @@ export declare type HideRefreshButtonResult = void;
  * ```
  *
  * @public
+ * @noInheritDoc
  */
 export declare class IdentityModule extends BaseModule {
     constructor();
@@ -2394,7 +2580,6 @@ export declare class IdentityModule extends BaseModule {
      * @param environment - The environment to fetch configuration for ('staging' or 'production').
      * @returns The authorization endpoint URL.
      * @throws Error when the environment is invalid or the configuration cannot be fetched.
-     *
      * @internal
      */
     private fetchAuthorizationEndpoint;
@@ -2429,46 +2614,37 @@ export declare class IdentityModule extends BaseModule {
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { IdentityModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { IdentityModule } = window.SuperAppSDK;
-     *
      * // Initialize the identity module
      * const identityModule = new IdentityModule();
      *
      * // Retrieve stored authorization artifacts after authorization redirect
-     * try {
-     *   const response = await identityModule.getAuthorizationArtifacts();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       // All artifacts present - proceed with token exchange
-     *       const { state, codeVerifier, nonce, redirectUri } = response.result;
-     *       console.log('State:', state);
-     *       console.log('Code Verifier:', codeVerifier);
-     *       console.log('Nonce:', nonce);
-     *       console.log('Redirect URI:', redirectUri);
-     *       break;
-     *     case 204:
-     *       // No artifacts yet - user hasn't authorized
-     *       console.log('No authorization artifacts found. Authorization has not been initiated.');
-     *       break;
-     *     case 400:
-     *       // Inconsistent state - possible data corruption
-     *       console.error('Authorization artifacts error:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await identityModule.getAuthorizationArtifacts();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     // All artifacts present - proceed with token exchange
+     *     const { state, codeVerifier, nonce, redirectUri } = response.result;
+     *     console.log('State:', state);
+     *     console.log('Code Verifier:', codeVerifier);
+     *     console.log('Nonce:', nonce);
+     *     console.log('Redirect URI:', redirectUri);
+     *     break;
+     *   case 204:
+     *     // No artifacts yet - user hasn't authorized
+     *     console.log('No authorization artifacts found. Authorization has not been initiated.');
+     *     break;
+     *   case 400:
+     *     // Inconsistent state - possible data corruption
+     *     console.error('Authorization artifacts error:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    getAuthorizationArtifacts(): GetAuthorizationArtifactsResponse;
+    getAuthorizationArtifacts(): Promise<GetAuthorizationArtifactsResponse>;
     /**
      * Clears all stored PKCE authorization artifacts from local storage.
      * This should be called after a successful token exchange or when you need to
@@ -2479,29 +2655,20 @@ export declare class IdentityModule extends BaseModule {
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { IdentityModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { IdentityModule } = window.SuperAppSDK;
-     *
      * // Initialize the identity module
      * const identityModule = new IdentityModule();
      *
      * // Clear stored authorization artifacts after successful token exchange
-     * try {
-     *   const response = await identityModule.clearAuthorizationArtifacts();
+     * const response = await identityModule.clearAuthorizationArtifacts();
      *
-     *   if (response.status_code === 204) {
-     *     console.log('Authorization artifacts cleared');
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * if (response.status_code === 204) {
+     *   console.log('Authorization artifacts cleared');
      * }
      * ```
      *
      * @public
      */
-    clearAuthorizationArtifacts(): ClearAuthorizationArtifactsResponse;
+    clearAuthorizationArtifacts(): Promise<ClearAuthorizationArtifactsResponse>;
     /**
      * Stores a value in local storage with the GrabID namespace prefix.
      *
@@ -2576,8 +2743,6 @@ export declare class IdentityModule extends BaseModule {
      *
      * @returns The authorization result, containing the authorization code on success or redirect status.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @remarks
      * **Important Note on redirectUri and responseMode:**
      *
@@ -2605,54 +2770,45 @@ export declare class IdentityModule extends BaseModule {
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { IdentityModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { IdentityModule } = window.SuperAppSDK;
-     *
      * // Initialize the identity module
      * const identityModule = new IdentityModule();
      *
      * // Initiate authorization with redirect mode
-     * try {
-     *   const response = await identityModule.authorize({
-     *     clientId: 'your-client-id',
-     *     redirectUri: 'https://your-app.com/callback',
-     *     scope: 'openid profile',
-     *     environment: 'production',
-     *     responseMode: 'redirect'
+     * const response = await identityModule.authorize({
+     *   clientId: 'your-client-id',
+     *   redirectUri: 'https://your-app.com/callback',
+     *   scope: 'openid profile',
+     *   environment: 'production',
+     *   responseMode: 'redirect'
      *   });
      *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       // Authorization successful (in_place mode with native flow)
-     *       console.log('Auth Code:', response.result.code);
-     *       console.log('State:', response.result.state);
-     *       break;
-     *     case 302:
-     *       // Redirect in progress (web flow with responseMode: 'redirect')
-     *       // The page will be redirected to the authorization URL
-     *       console.log('Redirecting to authorization...');
-     *       break;
-     *     case 204:
-     *       // User cancelled or flow completed without result data
-     *       console.log('Authorization cancelled or no content');
-     *       break;
-     *     case 400:
-     *       // Authorization failed
-     *       console.error('Auth error:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * switch (response.status_code) {
+     *   case 200:
+     *     // Authorization successful (in_place mode with native flow)
+     *     console.log('Auth Code:', response.result.code);
+     *     console.log('State:', response.result.state);
+     *     break;
+     *   case 302:
+     *     // Redirect in progress (web flow with responseMode: 'redirect')
+     *     // The page will be redirected to the authorization URL
+     *     console.log('Redirecting to authorization...');
+     *     break;
+     *   case 204:
+     *     // User cancelled or flow completed without result data
+     *     console.log('Authorization cancelled or no content');
+     *     break;
+     *   case 400:
+     *     // Authorization failed
+     *     console.error('Auth error:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    authorize(request: AuthorizeRequest): AuthorizeResponse;
+    authorize(request: AuthorizeRequest): Promise<AuthorizeResponse>;
     /**
      * Validates that a required string field is present and non-empty.
      *
@@ -2674,6 +2830,41 @@ export declare class IdentityModule extends BaseModule {
     private static validateAuthorizeRequest;
 }
 
+/**
+ * Options for invoking a JSBridge method.
+ *
+ * @public
+ */
+export declare interface InvokeOptions<T> {
+    /** The name of the JSBridge method to invoke */
+    method: string;
+    /** The parameters to pass to the method */
+    params?: unknown;
+    /** Validator function - returns false = 426 with default error */
+    isSupported?: (appInfo: GrabAppInfo) => boolean;
+    /** Optional response transformation function */
+    transformResponse?: (response: BridgeResponse<BridgeStatusCode, T>) => BridgeResponse<BridgeStatusCode, T>;
+}
+
+/**
+ * Type guard to check if a JSBridge response is a client error (4xx status codes).
+ *
+ * @param response - The JSBridge response to check
+ * @returns True if the response is a client error (400, 401, 403, 404, 424, 426), false otherwise
+ *
+ * @example
+ * ```typescript
+ * const response = await someBridgeMethod();
+ * if (isClientError(response)) {
+ *   // response is narrowed to BridgeClientError
+ *   console.error('Client error:', response.error);
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function isClientError<T>(response: BridgeResponse<BridgeStatusCode, T>): response is BridgeClientError;
+
 /**
  * Response when checking connection status.
  *
@@ -2702,7 +2893,7 @@ export declare class IdentityModule extends BaseModule {
  *
  * @public
  */
-export declare type IsConnectedResponse = Promise<ConstrainedBridgeResponse<IsConnectedResult, 200 | 404>>;
+export declare type IsConnectedResponse = BridgeResponse<200 | 404, IsConnectedResult>;
 
 /**
  * Result object containing the connection status.
@@ -2726,6 +2917,153 @@ export declare type IsConnectedResult = {
     connected: boolean;
 };
 
+/**
+ * Type guard to check if a JSBridge response is an error (4xx or 5xx status codes).
+ *
+ * @param response - The JSBridge response to check
+ * @returns True if the response is any error (4xx or 5xx), false otherwise
+ *
+ * @example
+ * ```typescript
+ * const response = await someBridgeMethod();
+ * if (isErrorResponse(response)) {
+ *   // response is narrowed to BridgeError
+ *   console.error('Error:', response.error);
+ * } else {
+ *   // response is successful or redirect
+ *   console.log('Success!');
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function isErrorResponse<T>(response: BridgeResponse<BridgeStatusCode, T>): response is BridgeError;
+
+/**
+ * Response when checking whether the current device supports eSIM.
+ *
+ * @remarks
+ * This response can have the following status codes:
+ * - `200`: eSIM capability was checked successfully. The `result` contains `true` or `false`.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
+ * - `501`: Not implemented - this method requires the Grab app environment.
+ *
+ * @example
+ * **Success response (200) - eSIM supported:**
+ * ```typescript
+ * {
+ *   status_code: 200,
+ *   result: true
+ * }
+ * ```
+ *
+ * @example
+ * **Success response (200) - eSIM not supported:**
+ * ```typescript
+ * {
+ *   status_code: 200,
+ *   result: false
+ * }
+ * ```
+ *
+ * @example
+ * **Not implemented response (501) - outside Grab app:**
+ * ```typescript
+ * {
+ *   status_code: 501,
+ *   error: 'Not implemented: This method requires the Grab app environment'
+ * }
+ * ```
+ *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare type IsEsimSupportedResponse = BridgeResponse<200 | 500 | 501, IsEsimSupportedResult>;
+
+/**
+ * Result indicating whether the current device supports eSIM.
+ *
+ * @example
+ * ```typescript
+ * true
+ * ```
+ *
+ * @example
+ * ```typescript
+ * false
+ * ```
+ *
+ * @public
+ */
+export declare type IsEsimSupportedResult = boolean;
+
+/**
+ * Type guard to check if a JSBridge response is a redirect (status code 302).
+ *
+ * @param response - The JSBridge response to check
+ * @returns True if the response is a redirect (302), false otherwise
+ *
+ * @example
+ * ```typescript
+ * const response = await someBridgeMethod();
+ * if (isRedirection(response)) {
+ *   // response is narrowed to BridgeRedirection
+ *   console.log('Redirecting...');
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function isRedirection<T>(response: BridgeResponse<BridgeStatusCode, T>): response is BridgeRedirection;
+
+/**
+ * Type guard to check if a JSBridge response is a server error (5xx status codes).
+ *
+ * @param response - The JSBridge response to check
+ * @returns True if the response is a server error (500, 501), false otherwise
+ *
+ * @example
+ * ```typescript
+ * const response = await someBridgeMethod();
+ * if (isServerError(response)) {
+ *   // response is narrowed to BridgeServerError
+ *   console.error('Server error:', response.error);
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function isServerError<T>(response: BridgeResponse<BridgeStatusCode, T>): response is BridgeServerError;
+
+/**
+ * Type guard to check if a JSBridge response is successful (status codes 200 or 204).
+ *
+ * @param response - The JSBridge response to check
+ * @returns True if the response is successful (200 or 204), false otherwise
+ *
+ * @example
+ * ```typescript
+ * const response = await someBridgeMethod();
+ * if (isSuccess(response)) {
+ *   // response is narrowed to BridgeSuccessResponse<T>
+ *   if (response.status_code === 200) {
+ *     console.log(response.result);
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function isSuccess<T>(response: BridgeResponse<BridgeStatusCode, T>): response is BridgeSuccessResponse<T>;
+
 /**
  * JSBridge module for accessing device locale settings.
  *
@@ -2752,6 +3090,7 @@ export declare type IsConnectedResult = {
  * ```
  *
  * @public
+ * @noInheritDoc
  */
 export declare class LocaleModule extends BaseModule {
     constructor();
@@ -2760,41 +3099,30 @@ export declare class LocaleModule extends BaseModule {
      *
      * @returns The user's preferred language locale string (e.g., 'en-SG', 'id-ID').
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { LocaleModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { LocaleModule } = window.SuperAppSDK;
-     *
      * // Initialize the locale module
      * const localeModule = new LocaleModule();
      *
      * // Get the current locale
-     * try {
-     *   const response = await localeModule.getLanguageLocaleIdentifier();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Current locale:', response.result);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await localeModule.getLanguageLocaleIdentifier();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Current locale:', response.result);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    getLanguageLocaleIdentifier(): GetLanguageLocaleIdentifierResponse;
+    getLanguageLocaleIdentifier(): Promise<GetLanguageLocaleIdentifierResponse>;
 }
 
 /**
@@ -2823,6 +3151,7 @@ export declare class LocaleModule extends BaseModule {
  * ```
  *
  * @public
+ * @noInheritDoc
  */
 export declare class LocationModule extends BaseModule {
     constructor();
@@ -2831,60 +3160,42 @@ export declare class LocationModule extends BaseModule {
      *
      * @returns The device's current latitude and longitude coordinates.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { LocationModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { LocationModule } = window.SuperAppSDK;
-     *
      * // Initialize the location module
      * const locationModule = new LocationModule();
      *
      * // Get current coordinates
-     * try {
-     *   const response = await locationModule.getCoordinate();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Coordinates:', response.result.lat, response.result.lng);
-     *       break;
-     *     case 424:
-     *       console.log('Could not get coordinates:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await locationModule.getCoordinate();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Coordinates:', response.result.lat, response.result.lng);
+     *     break;
+     *   case 424:
+     *     console.log('Could not get coordinates:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    getCoordinate(): GetCoordinateResponse;
+    getCoordinate(): Promise<GetCoordinateResponse>;
     /**
      * Subscribe to location change updates from the device.
      *
-     * @returns A `DataStream` that emits location updates as the device location changes.
+     * @returns A `BridgeStream` that emits location updates as the device location changes.
      * Use `subscribe()` to listen for updates, or `await` to get the first value only.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { LocationModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { LocationModule } = window.SuperAppSDK;
-     *
      * // Initialize the location module
      * const locationModule = new LocationModule();
      *
@@ -2910,44 +3221,33 @@ export declare class LocationModule extends BaseModule {
      *
      * @returns The ISO country code (e.g., 'SG', 'ID') based on the device's location.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { LocationModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { LocationModule } = window.SuperAppSDK;
-     *
      * // Initialize the location module
      * const locationModule = new LocationModule();
      *
      * // Get country code
-     * try {
-     *   const response = await locationModule.getCountryCode();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Country code:', response.result.countryCode);
-     *       break;
-     *     case 424:
-     *       console.log('Could not get country code:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await locationModule.getCountryCode();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Country code:', response.result.countryCode);
+     *     break;
+     *   case 424:
+     *     console.log('Could not get country code:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    getCountryCode(): GetCountryCodeResponse;
+    getCountryCode(): Promise<GetCountryCodeResponse>;
 }
 
 /**
@@ -2976,6 +3276,7 @@ export declare class LocationModule extends BaseModule {
  * ```
  *
  * @public
+ * @noInheritDoc
  */
 export declare class MediaModule extends BaseModule {
     constructor();
@@ -2986,46 +3287,35 @@ export declare class MediaModule extends BaseModule {
      *
      * @returns The playback initiation result, indicating if the DRM content started playing.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { MediaModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { MediaModule } = window.SuperAppSDK;
-     *
      * // Initialize the media module
      * const mediaModule = new MediaModule();
      *
      * // Play DRM content
-     * try {
-     *   const response = await mediaModule.playDRMContent({
-     *     // DRM content configuration
-     *   });
+     * const response = await mediaModule.playDRMContent({
+     *   // DRM content configuration
+     * });
      *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Playback initiated');
-     *       break;
-     *     case 204:
-     *       console.log('Invalid parameters');
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Playback initiated');
+     *     break;
+     *   case 204:
+     *     console.log('Invalid parameters');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    playDRMContent(data: DRMContentConfig): PlayDRMContentResponse;
+    playDRMContent(data: DRMContentConfig): Promise<PlayDRMContentResponse>;
     /**
      * Observes DRM-protected media content playback events.
      *
@@ -3033,16 +3323,9 @@ export declare class MediaModule extends BaseModule {
      *
      * @returns A stream that emits playback events as the media plays.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { MediaModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { MediaModule } = window.SuperAppSDK;
-     *
      * // Initialize the media module
      * const mediaModule = new MediaModule();
      *
@@ -3070,16 +3353,30 @@ export declare class MediaModule extends BaseModule {
 /**
  * Response stream for observing DRM playback events.
  *
+ * @remarks
+ * This is a `BridgeStream` 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).
+ *
  * @public
  */
-export declare type ObserveDRMPlaybackResponse = DataStream<DRMPlaybackEvent>;
+export declare type ObserveDRMPlaybackResponse = BridgeStream<200 | 500 | 501, DRMPlaybackEvent>;
 
 /**
  * Response when observing the device coordinates.
  *
+ * @remarks
+ * This is a `BridgeStream` that can be:
+ * - Subscribed to via `.subscribe()` for continuous updates
+ * - Awaited via `await` to get the first value only
+ *
+ * The stream can emit the same status codes as {@link GetCoordinateResponse}.
+ *
  * @public
  */
-export declare type ObserveLocationChangeResponse = DataStream_2<GetCoordinateResult>;
+export declare type ObserveLocationChangeResponse = BridgeStream<200 | 424 | 500 | 501, GetCoordinateResult>;
 
 /**
  * Response when notifying content loaded.
@@ -3087,6 +3384,7 @@ export declare type ObserveLocationChangeResponse = DataStream_2<GetCoordinateRe
  * @remarks
  * This response can have the following status codes:
  * - `200`: Notification sent successfully.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -3104,9 +3402,18 @@ export declare type ObserveLocationChangeResponse = DataStream_2<GetCoordinateRe
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type OnContentLoadedResponse = Promise<ConstrainedBridgeResponse<OnContentLoadedResult, 200 | 501>>;
+export declare type OnContentLoadedResponse = BridgeResponse<200 | 500 | 501, OnContentLoadedResult>;
 
 /**
  * Result when notifying content loaded.
@@ -3134,6 +3441,7 @@ export declare type OnCtaTapRequest = string;
  * @remarks
  * This response can have the following status codes:
  * - `200`: CTA tap notification sent successfully.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -3151,9 +3459,18 @@ export declare type OnCtaTapRequest = string;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type OnCtaTapResponse = Promise<ConstrainedBridgeResponse<OnCtaTapResult, 200 | 501>>;
+export declare type OnCtaTapResponse = BridgeResponse<200 | 500 | 501, OnCtaTapResult>;
 
 /**
  * Result when notifying CTA tap.
@@ -3182,6 +3499,7 @@ export declare type OpenExternalLinkRequest = string;
  * This response can have the following status codes:
  * - `200`: External link opened successfully.
  * - `400`: Invalid URL parameter.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -3208,9 +3526,18 @@ export declare type OpenExternalLinkRequest = string;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type OpenExternalLinkResponse = Promise<ConstrainedBridgeResponse<OpenExternalLinkResult, 200 | 400 | 501>>;
+export declare type OpenExternalLinkResponse = BridgeResponse<200 | 400 | 500 | 501, OpenExternalLinkResult>;
 
 /**
  * Result when opening an external link.
@@ -3220,6 +3547,13 @@ export declare type OpenExternalLinkResponse = Promise<ConstrainedBridgeResponse
  */
 export declare type OpenExternalLinkResult = void;
 
+/**
+ * Represents the mobile operating system platform.
+ *
+ * @public
+ */
+export declare type Platform = 'Android' | 'iOS';
+
 /**
  * JSBridge module for controlling platform navigation.
  *
@@ -3246,6 +3580,7 @@ export declare type OpenExternalLinkResult = void;
  * ```
  *
  * @public
+ * @noInheritDoc
  */
 export declare class PlatformModule extends BaseModule {
     constructor();
@@ -3255,41 +3590,30 @@ export declare class PlatformModule extends BaseModule {
      *
      * @returns Confirmation that the back navigation was triggered.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { PlatformModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { PlatformModule } = window.SuperAppSDK;
-     *
      * // Initialize the platform module
      * const platformModule = new PlatformModule();
      *
      * // Trigger back navigation
-     * try {
-     *   const response = await platformModule.back();
-     *
-     *   switch (response.status_code) {
-     *     case 204:
-     *       console.log('Back navigation triggered');
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await platformModule.back();
+     *
+     * switch (response.status_code) {
+     *   case 204:
+     *     console.log('Back navigation triggered');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    back(): BackResponse;
+    back(): Promise<BackResponse>;
 }
 
 /**
@@ -3299,6 +3623,7 @@ export declare class PlatformModule extends BaseModule {
  * This response can have the following status codes:
  * - `200`: Playback initiated successfully (streaming content).
  * - `204`: Invalid parameters - the DRM configuration is malformed or missing required fields.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -3322,9 +3647,18 @@ export declare class PlatformModule extends BaseModule {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type PlayDRMContentResponse = Promise<ConstrainedBridgeResponse<PlayDRMContentResult, 200 | 204 | 501>>;
+export declare type PlayDRMContentResponse = BridgeResponse<200 | 204 | 500 | 501, PlayDRMContentResult>;
 
 /**
  * Result object for DRM content playback initiation.
@@ -3360,55 +3694,45 @@ export declare type PlayDRMContentResult = void;
  * ```
  *
  * @public
+ * @noInheritDoc
  */
 export declare class ProfileModule extends BaseModule {
     constructor();
-    static isSupported(): boolean;
+    static readonly MINIMUM_VERSION: Version;
     /**
      * Fetches the user's email address from their Grab profile.
      *
      * @returns The user's email address if available.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ProfileModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ProfileModule } = window.SuperAppSDK;
-     *
      * // Initialize the profile module
      * const profileModule = new ProfileModule();
      *
      * // Fetch the user's email
-     * try {
-     *   const response = await profileModule.fetchEmail();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('User email:', response.result.email);
-     *       break;
-     *     case 400:
-     *     case 403:
-     *       // Feature not available or other error
-     *       console.log('Could not fetch email:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (err) {
-     *   console.log(`Could not fetch email${err ? `: ${err}` : ''}`);
+     * const response = await profileModule.fetchEmail();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('User email:', response.result.email);
+     *     break;
+     *   case 400:
+     *   case 403:
+     *     // Feature not available or other error
+     *     console.log('Could not fetch email:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    fetchEmail(): FetchEmailResponse;
+    fetchEmail(): Promise<FetchEmailResponse>;
     /**
      * Verifies the user's email address using a one-time password (OTP).
      *
@@ -3416,49 +3740,38 @@ export declare class ProfileModule extends BaseModule {
      *
      * @returns Confirmation of whether the email verification was successful.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ProfileModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ProfileModule } = window.SuperAppSDK;
-     *
      * // Initialize the profile module
      * const profileModule = new ProfileModule();
      *
      * // Verify email with OTP
-     * try {
-     *   const response = await profileModule.verifyEmail({
-     *     email: 'user@example.com',
-     *     otp: '123456'
-     *   });
+     * const response = await profileModule.verifyEmail({
+     *   email: 'user@example.com',
+     *   otp: '123456'
+     * });
      *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Email verified successfully');
-     *       break;
-     *     case 400:
-     *     case 403:
-     *       // Feature not available or other error
-     *       console.log('Could not verify email:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (err) {
-     *   console.log(`Could not verify email${err ? `: ${err}` : ''}`);
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Email verified successfully');
+     *     break;
+     *   case 400:
+     *   case 403:
+     *     // Feature not available or other error
+     *     console.log('Could not verify email:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    verifyEmail(request: VerifyEmailRequest): VerifyEmailResponse;
+    verifyEmail(request: VerifyEmailRequest): Promise<VerifyEmailResponse>;
 }
 
 /**
@@ -3486,6 +3799,7 @@ export declare type RedirectToSystemWebViewRequest = {
  * - `200`: Redirect initiated successfully.
  * - `400`: Invalid URL, domain not whitelisted, or missing callback URL.
  * - `424`: ASWebAuthenticationSession error - dependency error on iOS.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -3521,9 +3835,18 @@ export declare type RedirectToSystemWebViewRequest = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type RedirectToSystemWebViewResponse = Promise<ConstrainedBridgeResponse<RedirectToSystemWebViewResult, 200 | 400 | 424 | 501>>;
+export declare type RedirectToSystemWebViewResponse = BridgeResponse<200 | 400 | 424 | 500 | 501, RedirectToSystemWebViewResult>;
 
 /**
  * Result object for redirecting to the system web view.
@@ -3540,6 +3863,7 @@ export declare type RedirectToSystemWebViewResult = void;
  * This response can have the following status codes:
  * - `200`: Scopes reloaded successfully.
  * - `424`: ScopeKit error - unable to reload scopes due to a dependency error.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -3566,9 +3890,18 @@ export declare type RedirectToSystemWebViewResult = void;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type ReloadScopesResponse = Promise<ConstrainedBridgeResponse<ReloadScopesResult, 200 | 424 | 501>>;
+export declare type ReloadScopesResponse = BridgeResponse<200 | 424 | 500 | 501, ReloadScopesResult>;
 
 /**
  * Result object for reloading scopes.
@@ -3584,6 +3917,7 @@ export declare type ReloadScopesResult = void;
  * @remarks
  * This response can have the following status codes:
  * - `204`: All values removed successfully.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -3601,62 +3935,189 @@ export declare type ReloadScopesResult = void;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare type RemoveAllResponse = BridgeResponse<204 | 500 | 501, RemoveAllResult>;
+
+/**
+ * Result object for removing all values.
+ * This operation returns no data on success.
+ *
+ * @public
+ */
+export declare type RemoveAllResult = void;
+
+/**
+ * Response when removing a value.
+ *
+ * @remarks
+ * This response can have the following status codes:
+ * - `204`: Value removed successfully.
+ * - `400`: Missing required parameters - key not provided.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
+ * - `501`: Not implemented - this method requires the Grab app environment.
+ *
+ * @example
+ * **Success response (204):**
+ * ```typescript
+ * { status_code: 204 }
+ * ```
+ *
+ * @example
+ * **Bad request response (400):**
+ * ```typescript
+ * {
+ *   status_code: 400,
+ *   error: 'Missing required parameters'
+ * }
+ * ```
+ *
+ * @example
+ * **Not implemented response (501) - outside Grab app:**
+ * ```typescript
+ * {
+ *   status_code: 501,
+ *   error: 'Not implemented: This method requires the Grab app environment'
+ * }
+ * ```
+ *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare type RemoveResponse = BridgeResponse<204 | 400 | 500 | 501, RemoveResult>;
+
+/**
+ * Result object for removing a value.
+ * This operation returns no data on success.
+ *
+ * @public
+ */
+export declare type RemoveResult = void;
+
+/**
+ * Success response from the bridge SDK.
+ *
+ * @remarks
+ * Returned when a JSBridge method completes successfully.
+ * The `result` field contains the JSBridge method's data.
+ *
+ * @public
+ */
+export declare type ResponseStatusCode200<T> = {
+    /** HTTP-style status code indicating the outcome of the JSBridge method call */
+    status_code: 200;
+    /** The result data from the JSBridge method, or undefined if no result was returned */
+    result: T;
+};
+
+/**
+ * No result response with status code 204.
+ *
+ * @remarks
+ * Returned when a JSBridge method completes with no content (e.g., user cancelled a dialog).
+ * No `result` or `error` data is returned.
+ *
+ * @public
+ */
+export declare type ResponseStatusCode204 = {
+    /** HTTP-style status code indicating the outcome of the JSBridge method call */
+    status_code: 204;
+};
+
+/**
+ * Redirect response with status code 302.
+ *
+ * @remarks
+ * Returned when a JSBridge method initiates a redirect (e.g., OAuth2 redirect flow).
+ * No `result` or `error` data is returned as the page will navigate away.
+ *
+ * @public
+ */
+export declare type ResponseStatusCode302 = {
+    /** HTTP-style status code indicating the outcome of the JSBridge method call */
+    status_code: 302;
+};
+
+/**
+ * Error response with status code 400
+ *
+ * @public
+ */
+export declare type ResponseStatusCode400 = ErrorResponse<400>;
+
+/**
+ * Error response with status code 401
+ *
  * @public
  */
-export declare type RemoveAllResponse = Promise<ConstrainedBridgeResponse<RemoveAllResult, 204 | 501>>;
+export declare type ResponseStatusCode401 = ErrorResponse<401>;
 
 /**
- * Result object for removing all values.
- * This operation returns no data on success.
+ * Error response with status code 403
  *
  * @public
  */
-export declare type RemoveAllResult = void;
+export declare type ResponseStatusCode403 = ErrorResponse<403>;
 
 /**
- * Response when removing a value.
+ * Error response with status code 404
  *
- * @remarks
- * This response can have the following status codes:
- * - `204`: Value removed successfully.
- * - `400`: Missing required parameters - key not provided.
- * - `501`: Not implemented - this method requires the Grab app environment.
+ * @public
+ */
+export declare type ResponseStatusCode404 = ErrorResponse<404>;
+
+/**
+ * Error response with status code 424
  *
- * @example
- * **Success response (204):**
- * ```typescript
- * { status_code: 204 }
- * ```
+ * @public
+ */
+export declare type ResponseStatusCode424 = ErrorResponse<424>;
+
+/**
+ * Error response with status code 426
  *
- * @example
- * **Bad request response (400):**
- * ```typescript
- * {
- *   status_code: 400,
- *   error: 'Missing required parameters'
- * }
- * ```
+ * @remarks
+ * Returned when the JSBridge method requires a newer version of the Grab app.
+ * This indicates the method is not supported in the current app version.
  *
- * @example
- * **Not implemented response (501) - outside Grab app:**
- * ```typescript
- * {
- *   status_code: 501,
- *   error: 'Not implemented: This method requires the Grab app environment'
- * }
- * ```
+ * @public
+ */
+export declare type ResponseStatusCode426 = ErrorResponse<426>;
+
+/**
+ * Error response with status code 500
  *
  * @public
  */
-export declare type RemoveResponse = Promise<ConstrainedBridgeResponse<RemoveResult, 204 | 400 | 501>>;
+export declare type ResponseStatusCode500 = ErrorResponse<500>;
 
 /**
- * Result object for removing a value.
- * This operation returns no data on success.
+ * Error response with status code 501
+ *
+ * @remarks
+ * Returned when a JSBridge method is called outside the Grab app environment.
+ * This indicates the method is not implemented in the current environment.
  *
  * @public
  */
-export declare type RemoveResult = void;
+export declare type ResponseStatusCode501 = ErrorResponse<501>;
 
 /**
  * Request parameters for scanning QR codes.
@@ -3689,6 +4150,7 @@ export declare type ScanQRCodeRequest = {
  * - `204`: User cancelled the QR code scanning. No result data is returned.
  * - `400`: Bad request - invalid request parameters.
  * - `403`: Camera permission is not enabled for the Grab app.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -3733,9 +4195,18 @@ export declare type ScanQRCodeRequest = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type ScanQRCodeResponse = Promise<ConstrainedBridgeResponse<ScanQRCodeResult, 200 | 204 | 400 | 403 | 501>>;
+export declare type ScanQRCodeResponse = BridgeResponse<200 | 204 | 400 | 403 | 500 | 501, ScanQRCodeResult>;
 
 /**
  * Result object containing the scanned QR code data.
@@ -3778,6 +4249,7 @@ export declare type ScanQRCodeResult = {
  * ```
  *
  * @public
+ * @noInheritDoc
  */
 export declare class ScopeModule extends BaseModule {
     constructor();
@@ -3789,89 +4261,67 @@ export declare class ScopeModule extends BaseModule {
      *
      * @returns Whether the MiniApp has permission to access the specified method.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ScopeModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ScopeModule } = window.SuperAppSDK;
-     *
      * // Initialize the scope module
      * const scopeModule = new ScopeModule();
      *
      * // Check access to CameraModule.scanQRCode
-     * try {
-     *   const response = await scopeModule.hasAccessTo('CameraModule', 'scanQRCode');
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Has access:', response.result.hasAccess);
-     *       break;
-     *     case 400:
-     *     case 424:
-     *       console.log('Could not check access:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await scopeModule.hasAccessTo('CameraModule', 'scanQRCode');
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Has access:', response.result.hasAccess);
+     *     break;
+     *   case 400:
+     *   case 424:
+     *     console.log('Could not check access:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    hasAccessTo(module: string, method: string): HasAccessToResponse;
+    hasAccessTo(module: string, method: string): Promise<HasAccessToResponse>;
     /**
      * Requests to reload the consented OAuth scopes for the current client.
      * This refreshes the permissions from the server.
      *
      * @returns Confirmation that the scopes have been reloaded from the server.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { ScopeModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { ScopeModule } = window.SuperAppSDK;
-     *
      * // Initialize the scope module
      * const scopeModule = new ScopeModule();
      *
      * // Reload scopes
-     * try {
-     *   const response = await scopeModule.reloadScopes();
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Scopes reloaded successfully');
-     *       break;
-     *     case 424:
-     *       console.log('Could not reload scopes:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await scopeModule.reloadScopes();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Scopes reloaded successfully');
+     *     break;
+     *   case 424:
+     *     console.log('Could not reload scopes:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    reloadScopes(): ReloadScopesResponse;
+    reloadScopes(): Promise<ReloadScopesResponse>;
 }
 
 /**
@@ -3919,6 +4369,7 @@ export declare type SendAnalyticsEventRequest = {
  * This response can have the following status codes:
  * - `200`: Analytics event sent successfully.
  * - `400`: Invalid analytics event parameters.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -3945,9 +4396,18 @@ export declare type SendAnalyticsEventRequest = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type SendAnalyticsEventResponse = Promise<ConstrainedBridgeResponse<SendAnalyticsEventResult, 200 | 400 | 501>>;
+export declare type SendAnalyticsEventResponse = BridgeResponse<200 | 400 | 500 | 501, SendAnalyticsEventResult>;
 
 /**
  * Result when sending analytics events.
@@ -3976,6 +4436,7 @@ export declare type SetBackgroundColorRequest = string;
  * This response can have the following status codes:
  * - `200`: Background color set successfully.
  * - `400`: Invalid background color format.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -4002,9 +4463,18 @@ export declare type SetBackgroundColorRequest = string;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type SetBackgroundColorResponse = Promise<ConstrainedBridgeResponse<SetBackgroundColorResult, 200 | 400 | 501>>;
+export declare type SetBackgroundColorResponse = BridgeResponse<204 | 400 | 500 | 501, SetBackgroundColorResult>;
 
 /**
  * Result when setting the background color.
@@ -4021,6 +4491,7 @@ export declare type SetBackgroundColorResult = void;
  * This response can have the following status codes:
  * - `204`: Value stored successfully.
  * - `400`: Missing required parameters - key or value not provided.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -4047,9 +4518,18 @@ export declare type SetBackgroundColorResult = void;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type SetBooleanResponse = Promise<ConstrainedBridgeResponse<SetBooleanResult, 204 | 400 | 501>>;
+export declare type SetBooleanResponse = BridgeResponse<204 | 400 | 500 | 501, SetBooleanResult>;
 
 /**
  * Result object for setting a boolean value.
@@ -4066,6 +4546,7 @@ export declare type SetBooleanResult = void;
  * This response can have the following status codes:
  * - `204`: Value stored successfully.
  * - `400`: Missing required parameters - key or value not provided.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -4092,9 +4573,18 @@ export declare type SetBooleanResult = void;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type SetDoubleResponse = Promise<ConstrainedBridgeResponse<SetDoubleResult, 204 | 400 | 501>>;
+export declare type SetDoubleResponse = BridgeResponse<204 | 400 | 500 | 501, SetDoubleResult>;
 
 /**
  * Result object for setting a double value.
@@ -4111,6 +4601,7 @@ export declare type SetDoubleResult = void;
  * This response can have the following status codes:
  * - `204`: Value stored successfully.
  * - `400`: Missing required parameters - key or value not provided.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -4137,9 +4628,18 @@ export declare type SetDoubleResult = void;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type SetIntResponse = Promise<ConstrainedBridgeResponse<SetIntResult, 204 | 400 | 501>>;
+export declare type SetIntResponse = BridgeResponse<204 | 400 | 500 | 501, SetIntResult>;
 
 /**
  * Result object for setting an integer value.
@@ -4156,6 +4656,7 @@ export declare type SetIntResult = void;
  * This response can have the following status codes:
  * - `204`: Value stored successfully.
  * - `400`: Missing required parameters - key or value not provided.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -4182,9 +4683,18 @@ export declare type SetIntResult = void;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type SetStringResponse = Promise<ConstrainedBridgeResponse<SetStringResult, 204 | 400 | 501>>;
+export declare type SetStringResponse = BridgeResponse<204 | 400 | 500 | 501, SetStringResult>;
 
 /**
  * Result object for setting a string value.
@@ -4213,6 +4723,7 @@ export declare type SetTitleRequest = string;
  * This response can have the following status codes:
  * - `200`: Title set successfully.
  * - `400`: Invalid title parameter.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -4239,9 +4750,18 @@ export declare type SetTitleRequest = string;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type SetTitleResponse = Promise<ConstrainedBridgeResponse<SetTitleResult, 200 | 400 | 501>>;
+export declare type SetTitleResponse = BridgeResponse<200 | 400 | 500 | 501, SetTitleResult>;
 
 /**
  * Result when setting the title.
@@ -4257,6 +4777,7 @@ export declare type SetTitleResult = void;
  * @remarks
  * This response can have the following status codes:
  * - `200`: Back button shown successfully.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -4274,9 +4795,18 @@ export declare type SetTitleResult = void;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type ShowBackButtonResponse = Promise<ConstrainedBridgeResponse<ShowBackButtonResult, 200 | 501>>;
+export declare type ShowBackButtonResponse = BridgeResponse<200 | 500 | 501, ShowBackButtonResult>;
 
 /**
  * Result when showing the back button.
@@ -4292,6 +4822,7 @@ export declare type ShowBackButtonResult = void;
  * @remarks
  * This response can have the following status codes:
  * - `200`: Loader shown successfully.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -4309,9 +4840,18 @@ export declare type ShowBackButtonResult = void;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type ShowLoaderResponse = Promise<ConstrainedBridgeResponse<ShowLoaderResult, 200 | 501>>;
+export declare type ShowLoaderResponse = BridgeResponse<200 | 500 | 501, ShowLoaderResult>;
 
 /**
  * Result when showing the loader.
@@ -4327,6 +4867,7 @@ export declare type ShowLoaderResult = void;
  * @remarks
  * This response can have the following status codes:
  * - `200`: Refresh button shown successfully.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -4344,9 +4885,18 @@ export declare type ShowLoaderResult = void;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type ShowRefreshButtonResponse = Promise<ConstrainedBridgeResponse<ShowRefreshButtonResult, 200 | 501>>;
+export declare type ShowRefreshButtonResponse = BridgeResponse<200 | 500 | 501, ShowRefreshButtonResult>;
 
 /**
  * Result when showing the refresh button.
@@ -4358,21 +4908,22 @@ export declare type ShowRefreshButtonResult = void;
 
 /**
  * Map of individual status codes to their JSBridge response types.
- * Used internally by ConstrainedBridgeResponse to select specific response types.
+ * Used internally by BridgeResponse to select specific response types.
  *
  * @public
  */
 export declare type StatusCodeMap<T> = {
-    200: BridgeStatusCode200Response<T>;
-    204: BridgeStatusCode204Response;
-    302: BridgeStatusCode302Response;
-    400: BridgeStatusCode400Response;
-    401: BridgeStatusCode401Response;
-    403: BridgeStatusCode403Response;
-    404: BridgeStatusCode404Response;
-    424: BridgeStatusCode424Response;
-    500: BridgeStatusCode500Response;
-    501: BridgeStatusCode501Response;
+    200: ResponseStatusCode200<T>;
+    204: ResponseStatusCode204;
+    302: ResponseStatusCode302;
+    400: ResponseStatusCode400;
+    401: ResponseStatusCode401;
+    403: ResponseStatusCode403;
+    404: ResponseStatusCode404;
+    424: ResponseStatusCode424;
+    426: ResponseStatusCode426;
+    500: ResponseStatusCode500;
+    501: ResponseStatusCode501;
 };
 
 /**
@@ -4401,6 +4952,7 @@ export declare type StatusCodeMap<T> = {
  * ```
  *
  * @public
+ * @noInheritDoc
  */
 export declare class StorageModule extends BaseModule {
     constructor();
@@ -4412,44 +4964,33 @@ export declare class StorageModule extends BaseModule {
      *
      * @returns Confirmation that the boolean value was stored.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { StorageModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { StorageModule } = window.SuperAppSDK;
-     *
      * // Initialize the storage module
      * const storageModule = new StorageModule();
      *
      * // Set a boolean value
-     * try {
-     *   const response = await storageModule.setBoolean('isDarkMode', true);
-     *
-     *   switch (response.status_code) {
-     *     case 204:
-     *       console.log('Value stored successfully');
-     *       break;
-     *     case 400:
-     *       console.log('Could not store value:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await storageModule.setBoolean('isDarkMode', true);
+     *
+     * switch (response.status_code) {
+     *   case 204:
+     *     console.log('Value stored successfully');
+     *     break;
+     *   case 400:
+     *     console.log('Could not store value:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    setBoolean(key: string, value: boolean): SetBooleanResponse;
+    setBoolean(key: string, value: boolean): Promise<SetBooleanResponse>;
     /**
      * Retrieves a boolean value from the native storage.
      *
@@ -4457,44 +4998,33 @@ export declare class StorageModule extends BaseModule {
      *
      * @returns The stored boolean value.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { StorageModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { StorageModule } = window.SuperAppSDK;
-     *
      * // Initialize the storage module
      * const storageModule = new StorageModule();
      *
      * // Get a boolean value
-     * try {
-     *   const response = await storageModule.getBoolean('isDarkMode');
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Stored value:', response.result.value);
-     *       break;
-     *     case 400:
-     *       console.log('Could not retrieve value:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await storageModule.getBoolean('isDarkMode');
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Stored value:', response.result.value);
+     *     break;
+     *   case 400:
+     *     console.log('Could not retrieve value:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    getBoolean(key: string): GetBooleanResponse;
+    getBoolean(key: string): Promise<GetBooleanResponse>;
     /**
      * Stores an integer value in the native storage.
      *
@@ -4503,44 +5033,33 @@ export declare class StorageModule extends BaseModule {
      *
      * @returns Confirmation that the integer value was stored.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { StorageModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { StorageModule } = window.SuperAppSDK;
-     *
      * // Initialize the storage module
      * const storageModule = new StorageModule();
      *
      * // Set an integer value
-     * try {
-     *   const response = await storageModule.setInt('userCount', 42);
-     *
-     *   switch (response.status_code) {
-     *     case 204:
-     *       console.log('Value stored successfully');
-     *       break;
-     *     case 400:
-     *       console.log('Could not store value:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await storageModule.setInt('userCount', 42);
+     *
+     * switch (response.status_code) {
+     *   case 204:
+     *     console.log('Value stored successfully');
+     *     break;
+     *   case 400:
+     *     console.log('Could not store value:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    setInt(key: string, value: number): SetIntResponse;
+    setInt(key: string, value: number): Promise<SetIntResponse>;
     /**
      * Retrieves an integer value from the native storage.
      *
@@ -4548,44 +5067,33 @@ export declare class StorageModule extends BaseModule {
      *
      * @returns The stored integer value.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { StorageModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { StorageModule } = window.SuperAppSDK;
-     *
      * // Initialize the storage module
      * const storageModule = new StorageModule();
      *
      * // Get an integer value
-     * try {
-     *   const response = await storageModule.getInt('userCount');
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Stored value:', response.result.value);
-     *       break;
-     *     case 400:
-     *       console.log('Could not retrieve value:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await storageModule.getInt('userCount');
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Stored value:', response.result.value);
+     *     break;
+     *   case 400:
+     *     console.log('Could not retrieve value:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    getInt(key: string): GetIntResponse;
+    getInt(key: string): Promise<GetIntResponse>;
     /**
      * Stores a string value in the native storage.
      *
@@ -4594,44 +5102,33 @@ export declare class StorageModule extends BaseModule {
      *
      * @returns Confirmation that the string value was stored.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { StorageModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { StorageModule } = window.SuperAppSDK;
-     *
      * // Initialize the storage module
      * const storageModule = new StorageModule();
      *
      * // Set a string value
-     * try {
-     *   const response = await storageModule.setString('username', 'john_doe');
-     *
-     *   switch (response.status_code) {
-     *     case 204:
-     *       console.log('Value stored successfully');
-     *       break;
-     *     case 400:
-     *       console.log('Could not store value:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await storageModule.setString('username', 'john_doe');
+     *
+     * switch (response.status_code) {
+     *   case 204:
+     *     console.log('Value stored successfully');
+     *     break;
+     *   case 400:
+     *     console.log('Could not store value:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    setString(key: string, value: string): SetStringResponse;
+    setString(key: string, value: string): Promise<SetStringResponse>;
     /**
      * Retrieves a string value from the native storage.
      *
@@ -4639,44 +5136,33 @@ export declare class StorageModule extends BaseModule {
      *
      * @returns The stored string value.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { StorageModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { StorageModule } = window.SuperAppSDK;
-     *
      * // Initialize the storage module
      * const storageModule = new StorageModule();
      *
      * // Get a string value
-     * try {
-     *   const response = await storageModule.getString('username');
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Stored value:', response.result.value);
-     *       break;
-     *     case 400:
-     *       console.log('Could not retrieve value:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await storageModule.getString('username');
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Stored value:', response.result.value);
+     *     break;
+     *   case 400:
+     *     console.log('Could not retrieve value:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    getString(key: string): GetStringResponse;
+    getString(key: string): Promise<GetStringResponse>;
     /**
      * Stores a double (floating point) value in the native storage.
      *
@@ -4685,44 +5171,33 @@ export declare class StorageModule extends BaseModule {
      *
      * @returns Confirmation that the double value was stored.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { StorageModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { StorageModule } = window.SuperAppSDK;
-     *
      * // Initialize the storage module
      * const storageModule = new StorageModule();
      *
      * // Set a double value
-     * try {
-     *   const response = await storageModule.setDouble('price', 19.99);
-     *
-     *   switch (response.status_code) {
-     *     case 204:
-     *       console.log('Value stored successfully');
-     *       break;
-     *     case 400:
-     *       console.log('Could not store value:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await storageModule.setDouble('price', 19.99);
+     *
+     * switch (response.status_code) {
+     *   case 204:
+     *     console.log('Value stored successfully');
+     *     break;
+     *   case 400:
+     *     console.log('Could not store value:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    setDouble(key: string, value: number): SetDoubleResponse;
+    setDouble(key: string, value: number): Promise<SetDoubleResponse>;
     /**
      * Retrieves a double (floating point) value from the native storage.
      *
@@ -4730,44 +5205,33 @@ export declare class StorageModule extends BaseModule {
      *
      * @returns The stored double value.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { StorageModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { StorageModule } = window.SuperAppSDK;
-     *
      * // Initialize the storage module
      * const storageModule = new StorageModule();
      *
      * // Get a double value
-     * try {
-     *   const response = await storageModule.getDouble('price');
-     *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Stored value:', response.result.value);
-     *       break;
-     *     case 400:
-     *       console.log('Could not retrieve value:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await storageModule.getDouble('price');
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Stored value:', response.result.value);
+     *     break;
+     *   case 400:
+     *     console.log('Could not retrieve value:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    getDouble(key: string): GetDoubleResponse;
+    getDouble(key: string): Promise<GetDoubleResponse>;
     /**
      * Removes a single value from the native storage by key.
      *
@@ -4775,84 +5239,62 @@ export declare class StorageModule extends BaseModule {
      *
      * @returns Confirmation that the value was removed.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { StorageModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { StorageModule } = window.SuperAppSDK;
-     *
      * // Initialize the storage module
      * const storageModule = new StorageModule();
      *
      * // Remove a value
-     * try {
-     *   const response = await storageModule.remove('username');
-     *
-     *   switch (response.status_code) {
-     *     case 204:
-     *       console.log('Value removed successfully');
-     *       break;
-     *     case 400:
-     *       console.log('Could not remove value:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await storageModule.remove('username');
+     *
+     * switch (response.status_code) {
+     *   case 204:
+     *     console.log('Value removed successfully');
+     *     break;
+     *   case 400:
+     *     console.log('Could not remove value:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    remove(key: string): RemoveResponse;
+    remove(key: string): Promise<RemoveResponse>;
     /**
      * Removes all values from the native storage.
      *
      * @returns Confirmation that all values were removed.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { StorageModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { StorageModule } = window.SuperAppSDK;
-     *
      * // Initialize the storage module
      * const storageModule = new StorageModule();
      *
      * // Remove all values
-     * try {
-     *   const response = await storageModule.removeAll();
-     *
-     *   switch (response.status_code) {
-     *     case 204:
-     *       console.log('All values removed successfully');
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (error) {
-     *   console.log('Unexpected error:', error);
+     * const response = await storageModule.removeAll();
+     *
+     * switch (response.status_code) {
+     *   case 204:
+     *     console.log('All values removed successfully');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    removeAll(): RemoveAllResponse;
+    removeAll(): Promise<RemoveAllResponse>;
 }
 
 /**
@@ -4897,6 +5339,7 @@ export declare type Subscription = Readonly<{
  * ```
  *
  * @public
+ * @noInheritDoc
  */
 export declare class SystemWebViewKitModule extends BaseModule {
     constructor();
@@ -4907,49 +5350,38 @@ export declare class SystemWebViewKitModule extends BaseModule {
      *
      * @returns Confirmation of whether the redirect to system web view was successful.
      *
-     * @throws Error when the JSBridge method fails unexpectedly.
-     *
      * @example
      * **Simple usage**
      * ```typescript
-     * // Imports using ES Module built
-     * import { SystemWebViewKitModule } from '@grabjs/superapp-sdk';
-     * // Imports using UMD built (via CDN)
-     * const { SystemWebViewKitModule } = window.SuperAppSDK;
-     *
      * // Initialize the system web view kit module
      * const systemWebViewKitModule = new SystemWebViewKitModule();
      *
      * // Open a URL in system web view
-     * try {
-     *   const response = await systemWebViewKitModule.redirectToSystemWebView({
-     *     url: 'https://www.example.com'
-     *   });
+     * const response = await systemWebViewKitModule.redirectToSystemWebView({
+     *   url: 'https://www.example.com'
+     * });
      *
-     *   switch (response.status_code) {
-     *     case 200:
-     *       console.log('Redirect initiated successfully');
-     *       break;
-     *     case 400:
-     *       console.log('Could not redirect:', response.error);
-     *       break;
-     *     case 424:
-     *       console.log('Dependency error:', response.error);
-     *       break;
-     *     case 501:
-     *       console.log('Not in Grab app:', response.error);
-     *       break;
-     *     default:
-     *       console.log('Unexpected status code:', response);
-     *   }
-     * } catch (err) {
-     *   console.log('Unexpected error:', err);
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Redirect initiated successfully');
+     *     break;
+     *   case 400:
+     *     console.log('Could not redirect:', response.error);
+     *     break;
+     *   case 424:
+     *     console.log('Dependency error:', response.error);
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
      * }
      * ```
      *
      * @public
      */
-    redirectToSystemWebView(request: RedirectToSystemWebViewRequest): RedirectToSystemWebViewResponse;
+    redirectToSystemWebView(request: RedirectToSystemWebViewRequest): Promise<RedirectToSystemWebViewResponse>;
 }
 
 /**
@@ -4983,6 +5415,7 @@ export declare type TriggerCheckoutRequest = Record<string, unknown>;
  * This response can have the following status codes:
  * - `200`: Checkout completed successfully. The `result` contains transaction details.
  * - `400`: Bad request - invalid checkout parameters.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -5041,9 +5474,18 @@ export declare type TriggerCheckoutRequest = Record<string, unknown>;
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type TriggerCheckoutResponse = Promise<ConstrainedBridgeResponse<TriggerCheckoutResult, 200 | 400 | 501>>;
+export declare type TriggerCheckoutResponse = BridgeResponse<200 | 400 | 500 | 501, TriggerCheckoutResult>;
 
 /**
  * Result object containing the checkout transaction details.
@@ -5091,14 +5533,78 @@ export declare type TriggerCheckoutResponse = Promise<ConstrainedBridgeResponse<
 export declare type TriggerCheckoutResult = {
     /** Unique identifier for the transaction at Grab side. */
     transactionID: string;
-    /** Status of the transaction: "success", "failure", "pending", or "userInitiatedCancel". */
-    status: string;
+    /** Status of the transaction. */
+    status: 'success' | 'failure' | 'pending' | 'userInitiatedCancel';
     /** Error message if the transaction failed. */
     errorMessage?: string;
     /** Error code associated with the failed transaction. */
     errorCode?: string;
 };
 
+/**
+ * JSBridge module for reading user-related attributes from native code.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Provides access to user and traveller attributes exposed by the native Grab app bridge.
+ * This code must run on the Grab SuperApp's webview to function correctly.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { UserAttributesModule } from '@grabjs/superapp-sdk';
+ * const userAttributesModule = new UserAttributesModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const userAttributesModule = new SuperAppSDK.UserAttributesModule();
+ * </script>
+ * ```
+ *
+ * @public
+ * @noInheritDoc
+ */
+export declare class UserAttributesModule extends BaseModule {
+    constructor();
+    /**
+     * Returns the currently selected travel destination as a lowercase ISO 3166-1 alpha-2 country code.
+     *
+     * @returns The selected travel destination lowercase ISO 3166-1 alpha-2 country code when available.
+     *
+     * @example
+     * **Simple usage**
+     * ```typescript
+     * // Initialize the user attributes module
+     * const userAttributesModule = new UserAttributesModule();
+     *
+     * // Read the selected travel destination
+     * const response = await userAttributesModule.getSelectedTravelDestination();
+     *
+     * switch (response.status_code) {
+     *   case 200:
+     *     console.log('Selected travel destination code:', response.result);
+     *     break;
+     *   case 204:
+     *     console.log('Selected travel destination is not available');
+     *     break;
+     *   case 501:
+     *     console.log('Not in Grab app:', response.error);
+     *     break;
+     *   default:
+     *     console.log('Unexpected status code:', response);
+     * }
+     * ```
+     *
+     * @public
+     */
+    getSelectedTravelDestination(): Promise<GetSelectedTravelDestinationResponse>;
+}
+
 /**
  * Request parameters for verifying the user's email with an OTP.
  *
@@ -5126,7 +5632,8 @@ export declare type VerifyEmailRequest = {
  * This response can have the following status codes:
  * - `200`: Email verified successfully.
  * - `400`: Invalid request - OTP is incorrect or expired.
- * - `403`: Forbidden - feature requires Grab app version 5.399 or above.
+ * - `426`: Upgrade Required - feature requires Grab app version 5.399 or above.
+ * - `500`: Internal server error - an unexpected error occurred on the native side.
  * - `501`: Not implemented - this method requires the Grab app environment.
  *
  * @example
@@ -5145,11 +5652,11 @@ export declare type VerifyEmailRequest = {
  * ```
  *
  * @example
- * **Forbidden response (403):**
+ * **Upgrade Required response (426):**
  * ```typescript
  * {
- *   status_code: 403,
- *   error: 'This feature requires Grab app version 5.399 or above.'
+ *   status_code: 426,
+ *   error: 'Upgrade Required: This method requires Grab app version 5.399.0 or above on iOS'
  * }
  * ```
  *
@@ -5162,9 +5669,18 @@ export declare type VerifyEmailRequest = {
  * }
  * ```
  *
+ * @example
+ * **Internal server error response (500):**
+ * ```typescript
+ * {
+ *   status_code: 500,
+ *   error: 'Internal server error'
+ * }
+ * ```
+ *
  * @public
  */
-export declare type VerifyEmailResponse = Promise<ConstrainedBridgeResponse<VerifyEmailResult, 200 | 400 | 403 | 501>>;
+export declare type VerifyEmailResponse = BridgeResponse<200 | 400 | 426 | 500 | 501, VerifyEmailResult>;
 
 /**
  * Result object for verifying the user's email.
@@ -5174,6 +5690,17 @@ export declare type VerifyEmailResponse = Promise<ConstrainedBridgeResponse<Veri
  */
 export declare type VerifyEmailResult = void;
 
+/**
+ * Represents a semantic version with major, minor, and patch components.
+ *
+ * @public
+ */
+export declare interface Version {
+    major: number;
+    minor: number;
+    patch: number;
+}
+
 /**
  * Generic interface for all native JSBridge module wrappers.
  *
@@ -5192,14 +5719,14 @@ export declare type VerifyEmailResult = void;
  * Extending with method overloads (ProfileModule, LocationModule):
  * ```typescript
  * export interface WrappedProfileModule extends WrappedModule {
- *   invoke(method: 'fetchEmail', params?: any): Promise<BridgeResponse<string>>;
+ *   invoke(method: 'fetchEmail', params?: any): Promise<BridgeResponse<BridgeStatusCode, string>>;
  * }
  * ```
  *
  * @public
  */
 export declare interface WrappedModule {
-    invoke<T, P = unknown, R = BridgeResponse<T>, M extends string = string>(method: M, params?: P): M extends `observe${string}` ? DataStream<T> : Promise<R>;
+    invoke<T>(method: string, params?: unknown): BridgeStream<BridgeStatusCode, T> | Promise<BridgeResponse<BridgeStatusCode, T>>;
 }
 
 export { }