@grabjs/superapp-sdk 2.0.0-beta.1 → 2.0.0-beta.7

package/dist/index.d.ts

@@ -1,79 +1,1071 @@
-export declare class CameraModule {
-    /**
-     * Opens the camera to scan QR codes
-     * @param {Object} [config] - Configuration object for QR code scanning
-     * @param {string} [config.title] - Title to display in camera view
-     * @returns {Promise<Object>} Promise that resolves to response object with status_code:
-     *   - 200: Success with result.qrCode containing the scanned QR code
-     *   - 204: No result (user cancelled or no QR code detected)
-     *   - 403: Camera access denied with error message
-     */
-    scanQRCode(config?: {
-        title?: string;
-    }): Promise<any>;
-}
+import { DataStream as DataStream_2 } from '@grabjs/mobile-kit-bridge-sdk';
 
-export declare class CheckoutModule {
-    triggerCheckout(checkoutDetails: any): any;
+/**
+ * Base class for all JSBridge modules.
+ *
+ * @remarks
+ * On construction, the class wraps the JSBridge module on `window` (e.g., `WrappedContainerModule`).
+ * Requires the MiniApp to be running within the Grab SuperApp's webview.
+ *
+ * @public
+ */
+export declare class BaseModule {
+    /**
+     * The module name used to identify the JSBridge module.
+     */
+    private readonly name;
+    /**
+     * Returns the wrapped JSBridge module from the global `window` object.
+     *
+     * @returns The wrapped module instance with native method bindings.
+     *
+     * @internal
+     */
+    protected get wrappedModule(): WrappedModule;
+    /**
+     * Creates a new module instance and wraps it on the global `window` object.
+     *
+     * @param moduleName - The name of the module (e.g., "ContainerModule", "ProfileModule").
+     * @throws Error when the bridge SDK fails to wrap the module.
+     */
+    constructor(moduleName: string);
 }
 
-export declare namespace ContainerAnalyticsEventData {
-    let TRANSACTION_AMOUNT: string;
-    let TRANSACTION_CURRENCY: string;
-    let PAGE: string;
-}
+/**
+ * Error response from the JSBridge method.
+ *
+ * @remarks
+ * Returned when a JSBridge method fails.
+ * The `error` field contains a human-readable message.
+ *
+ * @public
+ */
+export declare type BridgeErrorResponse = {
+    /**
+     * Status codes:
+     *
+     * - `400`: Bad request (invalid parameters)
+     * - `403`: Forbidden (permission denied)
+     * - `404`: Not found (resource not found)
+     * - `424`: Failed dependency
+     * - `500`: Internal server error
+     */
+    status_code: 400 | 403 | 404 | 424 | 500;
+    /** Always undefined for error responses */
+    result?: undefined;
+    /** Error message describing what went wrong */
+    error: string;
+};
+
+/**
+ * No result response from the JSBridge method.
+ *
+ * @remarks
+ * Returned when a JSBridge method completes with no content (e.g., user cancelled a dialog, redirect occurred).
+ * No `result` or `error` data is returned.
+ *
+ * @public
+ */
+export declare type BridgeNoResultResponse = {
+    /**
+     * Status codes:
+     *
+     * - `204`: No content (user cancelled or operation returned no data)
+     * - `302`: Redirect occurred
+     */
+    status_code: 204 | 302;
+    /** Always undefined for no-result JSBridge responses */
+    result?: undefined;
+    /** Always undefined for no-result JSBridge responses */
+    error?: undefined;
+};
+
+/**
+ * Universal response format for all JSBridge methods.
+ *
+ * @remarks
+ * All JSBridge method calls resolve to this union type.
+ *
+ * @public
+ */
+export declare type BridgeResponse<T> = BridgeSuccessResponse<T> | BridgeNoResultResponse | BridgeErrorResponse;
 
-export declare namespace ContainerAnalyticsEventName {
-    let DEFAULT: string;
+/**
+ * Copyright (c) Grab Taxi Holdings PTE LTD (GRAB)
+ *
+ * This source code is licensed under the MIT license found in the LICENSE file in the root
+ * directory of this source tree.
+ */
+/**
+ * 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 BridgeSuccessResponse<T> = {
+    /** Status code: `200` - JSBridge method completed successfully */
+    status_code: 200;
+    /** The result data from the successful JSBridge method */
+    result: T;
+    /** Always undefined for success responses */
+    error?: undefined;
+};
+
+/**
+ * JSBridge module for accessing the device camera.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Provides access to native camera functionality including QR code scanning.
+ * This code must run on the Grab SuperApp's webview to function correctly.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { CameraModule } from '@grabjs/superapp-sdk';
+ * const cameraModule = new CameraModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const cameraModule = new SuperAppSDK.CameraModule();
+ * </script>
+ * ```
+ *
+ * @public
+ */
+export declare class CameraModule extends BaseModule {
+    constructor();
+    /**
+     * Opens the native camera to scan a QR code.
+     *
+     * @param request - Configuration for the scan.
+     *
+     * @returns Resolves with the scanned QR code content on success, or error information on failure.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * With title
+     * ```typescript
+     * const response = await cameraModule.scanQRCode({ title: 'Scan Payment QR' });
+     * ```
+     *
+     * @example
+     * Without title
+     * ```typescript
+     * const response = await cameraModule.scanQRCode({});
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await cameraModule.scanQRCode(params);
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('QR Code scanned:', result.qrCode);
+     *       break;
+     *     case 204:
+     *       console.log('User cancelled scanning');
+     *       break;
+     *     default:
+     *       console.log(`Could not scan QR code${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not scan QR code${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    scanQRCode(request: ScanQRCodeRequest): Promise<ScanQRCodeResponse>;
 }
 
-export declare namespace ContainerAnalyticsEventState {
-    let HOMEPAGE: string;
-    let CHECKOUT_PAGE: string;
-    let BOOKING_COMPLETION: string;
-    let CUSTOM: string;
+/**
+ * JSBridge module for triggering native payment flows.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Invokes the native Grab checkout/pay component to process payments.
+ * Requires the MiniApp to be running within the Grab SuperApp's webview.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { CheckoutModule } from '@grabjs/superapp-sdk';
+ * const checkoutModule = new CheckoutModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const checkoutModule = new SuperAppSDK.CheckoutModule();
+ * </script>
+ * ```
+ *
+ * @public
+ */
+export declare class CheckoutModule extends BaseModule {
+    constructor();
+    triggerCheckout(checkoutDetails: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
 }
 
-export declare class ContainerModule {
-    setBackgroundColor(backgroundColor: any): any;
-    setTitle(title: any): any;
-    hideBackButton(): any;
-    showBackButton(): any;
-    hideRefreshButton(): any;
-    showRefreshButton(): any;
-    close(): any;
-    onContentLoaded(): any;
-    showLoader(): any;
-    hideLoader(): any;
-    openExternalLink(url: any): any;
-    onCtaTap(action: any): any;
-    sendAnalyticsEvent(eventDetails: any): any;
-    isConnected(): {
-        then: (callback: any) => any;
-    };
-    getSessionParams(): any;
-    _validateAnalyticsEvent(eventDetails: any): "name is required" | "name must be a string" | "state is required" | "state must be a string" | "data must be undefined or an object";
+/**
+ * Response when closing the container.
+ *
+ * @public
+ */
+export declare type CloseResponse = BridgeResponse<null>;
+
+/**
+ * Constants for container analytics event data.
+ *
+ * @public
+ */
+export declare const ContainerAnalyticsEventData: {
+    TRANSACTION_AMOUNT: string;
+    TRANSACTION_CURRENCY: string;
+    PAGE: string;
+};
+
+/**
+ * Constants for container analytics event names.
+ *
+ * @public
+ */
+export declare const ContainerAnalyticsEventName: {
+    DEFAULT: string;
+};
+
+/**
+ * Constants for container analytics event states.
+ *
+ * @public
+ */
+export declare const ContainerAnalyticsEventState: {
+    HOMEPAGE: string;
+    CHECKOUT_PAGE: string;
+    BOOKING_COMPLETION: string;
+    CUSTOM: string;
+};
+
+/**
+ * JSBridge module for controlling the webview container.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Provides methods to interact with the webview container.
+ * This code must run on the Grab SuperApp's webview to function correctly.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { ContainerModule } from '@grabjs/superapp-sdk';
+ * const containerModule = new ContainerModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const containerModule = new SuperAppSDK.ContainerModule();
+ * </script>
+ * ```
+ *
+ * @public
+ */
+export declare class ContainerModule extends BaseModule {
+    constructor();
+    /**
+     * Set the background color of the container header.
+     *
+     * @param request - Hexadecimal color value (e.g., "#ffffff", "#000000").
+     *
+     * @returns Resolves when the background color has been applied, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Set background color to white
+     * ```typescript
+     * await containerModule.setBackgroundColor("#ffffff");
+     * ```
+     *
+     * @example
+     * Set background color to dark
+     * ```typescript
+     * await containerModule.setBackgroundColor("#1a1a1a");
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.setBackgroundColor(backgroundColor);
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('Background color set successfully');
+     *       break;
+     *     default:
+     *       console.log(`Could not set background color${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not set background color${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    setBackgroundColor(request: SetBackgroundColorRequest): Promise<SetBackgroundColorResponse>;
+    /**
+     * Set the title of the container header.
+     *
+     * @param request - Title of the page.
+     *
+     * @returns Resolves when the title has been set in the navigation bar, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Set title
+     * ```typescript
+     * await containerModule.setTitle("Home");
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.setTitle(title);
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('Title set successfully');
+     *       break;
+     *     default:
+     *       console.log(`Could not set title${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not set title${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    setTitle(request: SetTitleRequest): Promise<SetTitleResponse>;
+    /**
+     * Hide the back button on the container header.
+     *
+     * @returns Resolves when the back button is hidden, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Hide back button
+     * ```typescript
+     * await containerModule.hideBackButton();
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.hideBackButton();
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('Back button hidden successfully');
+     *       break;
+     *     default:
+     *       console.log(`Could not hide back button${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not hide back button${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    hideBackButton(): Promise<HideBackButtonResponse>;
+    /**
+     * Show the back button on the container header.
+     *
+     * @returns Resolves when the back button is shown, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Show back button
+     * ```typescript
+     * await containerModule.showBackButton();
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.showBackButton();
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('Back button shown successfully');
+     *       break;
+     *     default:
+     *       console.log(`Could not show back button${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not show back button${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    showBackButton(): Promise<ShowBackButtonResponse>;
+    /**
+     * Hide the refresh button on the container header.
+     *
+     * @returns Resolves when the refresh button is hidden, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Hide refresh button
+     * ```typescript
+     * await containerModule.hideRefreshButton();
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.hideRefreshButton();
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('Refresh button hidden successfully');
+     *       break;
+     *     default:
+     *       console.log(`Could not hide refresh button${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not hide refresh button${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    hideRefreshButton(): Promise<HideRefreshButtonResponse>;
+    /**
+     * Show the refresh button on the container header.
+     *
+     * @returns Resolves when the refresh button is shown, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Show refresh button
+     * ```typescript
+     * await containerModule.showRefreshButton();
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.showRefreshButton();
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('Refresh button shown successfully');
+     *       break;
+     *     default:
+     *       console.log(`Could not show refresh button${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not show refresh button${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    showRefreshButton(): Promise<ShowRefreshButtonResponse>;
+    /**
+     * Close the container and return to the previous screen.
+     *
+     * @returns Resolves when the container closes and the webview is dismissed, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Close after completing a task
+     * ```typescript
+     * await containerModule.close();
+     * ```
+     *
+     * @example
+     * Close button handler
+     * ```typescript
+     * closeButton.addEventListener('click', async () => {
+     *   await containerModule.close();
+     * });
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.close();
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('Container closed successfully');
+     *       break;
+     *     default:
+     *       console.log(`Could not close container${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not close container${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    close(): Promise<CloseResponse>;
+    /**
+     * Notify the Grab SuperApp that the page content has loaded.
+     *
+     * @returns Resolves when the content loaded notification is sent, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Notify on page load
+     * ```typescript
+     * await containerModule.onContentLoaded();
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.onContentLoaded();
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('Content loaded notification sent successfully');
+     *       break;
+     *     default:
+     *       console.log(`Could not notify content loaded${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not notify content loaded${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    onContentLoaded(): Promise<OnContentLoadedResponse>;
+    /**
+     * Show the full-screen loading indicator.
+     *
+     * @remarks
+     * Remember to call {@link ContainerModule.hideLoader} when the operation completes.
+     *
+     * @returns Resolves when the loading indicator is displayed, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Show loader indicator
+     * ```typescript
+     * await containerModule.showLoader();
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.showLoader();
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('Loader shown successfully');
+     *       break;
+     *     default:
+     *       console.log(`Could not show loader${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not show loader${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    showLoader(): Promise<ShowLoaderResponse>;
+    /**
+     * Hide the full-screen loading indicator.
+     *
+     * @remarks
+     * Should be called when the entry point has finished loading.
+     *
+     * @returns Resolves when the loading indicator is hidden, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Hide loader
+     * ```typescript
+     * await containerModule.hideLoader();
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.hideLoader();
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('Loader hidden successfully');
+     *       break;
+     *     default:
+     *       console.log(`Could not hide loader${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not hide loader${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    hideLoader(): Promise<HideLoaderResponse>;
+    /**
+     * Open a link in the external browser.
+     *
+     * @remarks
+     * Call this method to open the specified URL in an external browser (outside of the Grab app).
+     *
+     * @param request - URL to open in external browser.
+     *
+     * @returns Resolves when the external browser opens with the URL, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Open external link
+     * ```typescript
+     * await containerModule.openExternalLink("https://grab.com");
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.openExternalLink(url);
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('External link opened successfully');
+     *       break;
+     *     default:
+     *       console.log(`Could not open external link${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not open external link${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    openExternalLink(request: OpenExternalLinkRequest): Promise<OpenExternalLinkResponse>;
+    /**
+     * Notify the client that the user has tapped a call-to-action (CTA).
+     *
+     * @param request - CTA action identifier (e.g., "AV_LANDING_PAGE_CONTINUE", "BOOKING_CONFIRMED").
+     *
+     * @returns Resolves when the CTA tap notification is sent, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Notify CTA tap
+     * ```typescript
+     * await containerModule.onCtaTap("AV_LANDING_PAGE_CONTINUE");
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.onCtaTap(action);
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('CTA tap notified successfully');
+     *       break;
+     *     default:
+     *       console.log(`Could not notify CTA tap${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not notify CTA tap${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    onCtaTap(request: OnCtaTapRequest): Promise<OnCtaTapResponse>;
+    /**
+     * Use this method to track user interactions and page transitions.
+     *
+     * @remarks
+     * You can use predefined constants to ensure consistency across the platform.
+     *
+     * **Predefined Values:**
+     * - **States:** {@link ContainerAnalyticsEventState}
+     * - **Names:** {@link ContainerAnalyticsEventName}
+     * - **Data Keys:** {@link ContainerAnalyticsEventData}
+     *
+     * @param request - Details of the analytics event to be sent to the container.
+     *
+     * @returns Resolves when the analytics event is sent to the container, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @see {@link ContainerAnalyticsEventState}, {@link ContainerAnalyticsEventName}, {@link ContainerAnalyticsEventData}
+     *
+     * @example
+     * Send a DEFAULT event for HOMEPAGE state
+     * ```typescript
+     * import {
+     *   ContainerAnalyticsEventState,
+     *   ContainerAnalyticsEventName,
+     * } from "@grabjs/superapp-sdk";
+     *
+     * await containerModule.sendAnalyticsEvent({
+     *   state: ContainerAnalyticsEventState.HOMEPAGE,
+     *   name: ContainerAnalyticsEventName.DEFAULT,
+     * });
+     * ```
+     *
+     * @example
+     * Send a BOOK event for CHECKOUT_PAGE state with standard data keys
+     * ```typescript
+     * import {
+     *   ContainerAnalyticsEventState,
+     *   ContainerAnalyticsEventData,
+     * } from "@grabjs/superapp-sdk";
+     *
+     * await containerModule.sendAnalyticsEvent({
+     *   state: ContainerAnalyticsEventState.CHECKOUT_PAGE,
+     *   name: "BOOK",
+     *   data: {
+     *     [ContainerAnalyticsEventData.TRANSACTION_AMOUNT]: 100,
+     *     [ContainerAnalyticsEventData.TRANSACTION_CURRENCY]: "SGD",
+     *   },
+     * });
+     * ```
+     *
+     * @example
+     * Send a CLICK_RIDE event for CUSTOM state with custom metadata
+     * ```typescript
+     * import {
+     *   ContainerAnalyticsEventState,
+     *   ContainerAnalyticsEventData,
+     * } from "@grabjs/superapp-sdk";
+     *
+     * await containerModule.sendAnalyticsEvent({
+     *   state: ContainerAnalyticsEventState.CUSTOM,
+     *   name: "CLICK_RIDE",
+     *   data: {
+     *     [ContainerAnalyticsEventData.PAGE]: "LIST_RIDES",
+     *     departure_time: "2025-06-01 08:00:00",
+     *     arrival_time: "2025-06-01 10:30:00",
+     *     departure_address: "6 Bayfront Ave, Singapore 018974",
+     *     arrival_address:
+     *       "Petronas Twin Tower, Kuala Lumpur City Centre, 50088 Kuala Lumpur, Malaysia",
+     *   },
+     * });
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.sendAnalyticsEvent(params);
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('Analytics event sent successfully');
+     *       break;
+     *     default:
+     *       console.log(`Could not send analytics event${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not send analytics event${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    sendAnalyticsEvent(request: SendAnalyticsEventRequest): Promise<SendAnalyticsEventResponse>;
+    /**
+     * Check if the web app is connected to the Grab SuperApp via JSBridge.
+     *
+     * @remarks
+     * Call this method to verify the connection status before using other features.
+     *
+     * @returns Resolves with the JSBridge connection status to the Grab SuperApp, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Check connection status
+     * ```typescript
+     * const response = await containerModule.isConnected();
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const response = await containerModule.isConnected();
+     *   if (response.status_code === 200) {
+     *     console.log('Connected to Grab SuperApp');
+     *   } else {
+     *     console.log('Not connected to Grab SuperApp');
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not check connection${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    isConnected(): Promise<IsConnectedResponse>;
+    /**
+     * Get the session parameters from the container.
+     *
+     * @remarks
+     * The native layer returns session parameters as a JSON string.
+     * Parse with `JSON.parse(result.result)` to use as an object.
+     * Session parameters can contain primitives, base64 encoded strings, or nested objects.
+     *
+     * @returns Resolves with session parameters from the container, or with error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Get session parameters
+     * ```typescript
+     * const { result } = await containerModule.getSessionParams();
+     * if (result?.result) {
+     *   const sessionParams = JSON.parse(result.result);
+     *   console.log("Session parameters:", sessionParams);
+     *   if (sessionParams.param1) {
+     *     configureFeature(sessionParams.param1);
+     *   }
+     * }
+     * ```
+     *
+     * @example
+     * Get user ID from session params
+     * ```typescript
+     * const { result } = await containerModule.getSessionParams();
+     * const params = JSON.parse(result?.result || '{}');
+     * return params.userId;
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await containerModule.getSessionParams();
+     *   switch (status_code) {
+     *     case 200:
+     *       const sessionParams = JSON.parse(result?.result || '{}');
+     *       console.log('Session params retrieved:', sessionParams);
+     *       break;
+     *     default:
+     *       console.log(`Could not get session params${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not get session params${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    getSessionParams(): Promise<GetSessionParamsResponse>;
+    /**
+     * Validate the analytics event details.
+     *
+     * @param request - Analytics event details to be validated.
+     * @returns Error message if invalid, `null` if valid.
+     * @internal
+     */
+    private validateAnalyticsEvent;
 }
 
-export declare class IdentityModule {
-    static generateRandomString(length: any): string;
-    static base64URLEncode(str: any): any;
-    static generateCodeVerifier(len: any): any;
-    static generateCodeChallenge(codeVerifier: any): any;
-    static normalizeUrl(urlString: any): string;
-    static buildAuthorizeUrl(authorizationEndpoint: any, requestMap: any): string;
-    static parseGrabUserAgent(userAgent: any): {
-        appName: string;
-        major: number;
-        minor: number;
-        patch: number;
-        platform: string;
-    };
-    static isVersionBelow(current: any, min: any): boolean;
-    static shouldUseWebConsent(request: any): boolean;
-    static performNativeAuthorization(invokeParams: any): any;
-    static validateRequiredString(value: any, fieldName: any): string;
-    static validateAuthorizeRequest(request: any): string;
+/**
+ * A stream for receiving continuous data from JSBridge methods (e.g., location updates).
+ *
+ * @remarks
+ * Provides both Observable-like and Promise-like interfaces:
+ * - Use `subscribe()` to receive all values over time
+ * - Use `then()` or `await` to receive only the first value
+ *
+ * Note: Each `subscribe()` call creates a fresh subscription, allowing multiple independent listeners.
+ *
+ * @typeParam T - The type of data emitted by the stream.
+ *
+ * @public
+ */
+export declare type DataStream<T> = 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?: DataStreamHandlers<T>) => Subscription;
+}> & PromiseLike<BridgeResponse<T>>;
+
+/**
+ * Callbacks for handling stream events.
+ *
+ * @remarks
+ * Pass these to `subscribe()` to receive data via `next` and completion via `complete`.
+ *
+ * @typeParam T - The type of data emitted by the stream.
+ *
+ * @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;
+}>;
+
+/**
+ * Response when getting the device coordinates.
+ *
+ * @public
+ */
+export declare type GetCoordinateResponse = BridgeResponse<GetCoordinateResult>;
+
+/**
+ * Result object containing the geographic coordinates.
+ *
+ * @public
+ */
+export declare type GetCoordinateResult = {
+    /** Latitude in degrees */
+    lat: number;
+    /** Longitude in degrees */
+    lng: number;
+};
+
+/**
+ * Response when getting the country code.
+ *
+ * @public
+ */
+export declare type GetCountryCodeResponse = BridgeResponse<GetCountryCodeResult>;
+
+/**
+ * Result object containing the country code.
+ *
+ * @public
+ */
+export declare type GetCountryCodeResult = {
+    /** ISO country code (e.g., "SG", "ID", "MY") */
+    countryCode: string;
+};
+
+/**
+ * Response when getting session parameters.
+ *
+ * @public
+ */
+export declare type GetSessionParamsResponse = BridgeResponse<GetSessionParamsResult>;
+
+/**
+ * Result object containing session parameters as a JSON string.
+ *
+ * @public
+ */
+export declare type GetSessionParamsResult = {
+    /** JSON string containing session parameters. Parse with `JSON.parse(result)` to use as an object. */
+    result: string;
+};
+
+/**
+ * Response when hiding the back button.
+ *
+ * @public
+ */
+export declare type HideBackButtonResponse = BridgeResponse<null>;
+
+/**
+ * Response when hiding the loader.
+ *
+ * @public
+ */
+export declare type HideLoaderResponse = BridgeResponse<null>;
+
+/**
+ * Response when hiding the refresh button.
+ *
+ * @public
+ */
+export declare type HideRefreshButtonResponse = BridgeResponse<null>;
+
+/**
+ * JSBridge module for authenticating users via GrabID.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Handles OAuth2/OIDC authentication flows with PKCE support, enabling MiniApps to obtain user identity tokens.
+ * Supports both native in-app consent and web-based fallback flows.
+ * Requires the MiniApp to be running within the Grab SuperApp's webview.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { IdentityModule } from '@grabjs/superapp-sdk';
+ * const identity = new IdentityModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const identity = new SuperAppSDK.IdentityModule();
+ * </script>
+ * ```
+ *
+ * @public
+ */
+export declare class IdentityModule extends BaseModule {
+    constructor();
     get NAMESPACE(): string;
     get CODE_CHALLENGE_METHOD(): string;
     get NONCE_LENGTH(): number;
@@ -84,6 +1076,10 @@ export declare class IdentityModule {
         production: string;
     };
     fetchAuthorizationEndpoint(environment: any): Promise<any>;
+    static generateRandomString(length: any): string;
+    static base64URLEncode(str: any): any;
+    static generateCodeVerifier(len: any): any;
+    static generateCodeChallenge(codeVerifier: any): any;
     generatePKCEArtifacts(): {
         nonce: string;
         state: string;
@@ -104,6 +1100,17 @@ export declare class IdentityModule {
     }>;
     setStorageItem(key: any, value: any): void;
     getStorageItem(key: any): string;
+    static normalizeUrl(urlString: any): string;
+    static buildAuthorizeUrl(authorizationEndpoint: any, requestMap: any): string;
+    static parseGrabUserAgent(userAgent: any): {
+        appName: string;
+        major: number;
+        minor: number;
+        patch: number;
+        platform: string;
+    };
+    static isVersionBelow(current: any, min: any): boolean;
+    static shouldUseWebConsent(request: any): boolean;
     performWebAuthorization(params: any): Promise<{
         status_code: number;
         error: any;
@@ -111,28 +1118,338 @@ export declare class IdentityModule {
         status_code: number;
         result: any;
     }>;
-    authorize(request: any): Promise<any>;
+    performNativeAuthorization(invokeParams: any): Promise<BridgeResponse<unknown>>;
+    authorize(request: any): Promise<BridgeNoResultResponse | {
+        status_code: number;
+        error: any;
+    } | {
+        status_code: number;
+        result: any;
+    }>;
+    static validateRequiredString(value: any, fieldName: any): string;
+    static validateAuthorizeRequest(request: any): string;
 }
 
-export declare class LocaleModule {
-    getLanguageLocaleIdentifier(): any;
+/**
+ * Response when checking connection status.
+ *
+ * @public
+ */
+export declare type IsConnectedResponse = BridgeResponse<IsConnectedResult>;
+
+/**
+ * Result object containing the connection status.
+ *
+ * @public
+ */
+export declare type IsConnectedResult = {
+    /** Whether the MiniApp is connected to the Grab app. */
+    connected: boolean;
+};
+
+/**
+ * JSBridge module for accessing device locale settings.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Provides the user's preferred language and region settings from the native device.
+ * Requires the MiniApp to be running within the Grab SuperApp's webview.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { LocaleModule } from '@grabjs/superapp-sdk';
+ * const locale = new LocaleModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const locale = new SuperAppSDK.LocaleModule();
+ * </script>
+ * ```
+ *
+ * @public
+ */
+export declare class LocaleModule extends BaseModule {
+    constructor();
+    getLanguageLocaleIdentifier(): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
 }
 
-export declare class LocationModule {
-    getCoordinate(): any;
-    observeLocationChange(): any;
-    getCountryCode(): any;
+/**
+ * JSBridge module for accessing device location services.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Provides access to the device's geolocation data including coordinates and country code.
+ * Requires the MiniApp to be running within the Grab SuperApp's webview.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { LocationModule } from '@grabjs/superapp-sdk';
+ * const location = new LocationModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const location = new SuperAppSDK.LocationModule();
+ * </script>
+ * ```
+ *
+ * @public
+ */
+export declare class LocationModule extends BaseModule {
+    constructor();
+    /**
+     * Get the current geographic coordinates of the device.
+     *
+     * @returns Resolves with the device's latitude and longitude coordinates, or error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Get current coordinates
+     * ```typescript
+     * const response = await locationModule.getCoordinate();
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await locationModule.getCoordinate();
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('Coordinates:', result.lat, result.lng);
+     *       break;
+     *     default:
+     *       console.log(`Could not get coordinates${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not get coordinates${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    getCoordinate(): Promise<GetCoordinateResponse>;
+    /**
+     * Subscribe to location change updates from the device.
+     *
+     * @returns A `DataStream` 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
+     * Subscribe to location changes
+     * ```typescript
+     * const subscription = locationModule.observeLocationChange().subscribe({
+     *   next: (response) => {
+     *     if (response.status_code === 200) {
+     *       console.log('Location updated:', response.result.lat, response.result.lng);
+     *     }
+     *   },
+     *   complete: () => console.log('Location stream completed')
+     * });
+     *
+     * // Later, to stop receiving updates:
+     * subscription.unsubscribe();
+     * ```
+     *
+     * @example
+     * Get only the first location update
+     * ```typescript
+     * const response = await locationModule.observeLocationChange();
+     * if (response.status_code === 200) {
+     *   console.log('First location:', response.result.lat, response.result.lng);
+     * }
+     * ```
+     *
+     * @public
+     */
+    observeLocationChange(): ObserveLocationChangeResponse;
+    /**
+     * Get the country code based on the device's current location.
+     *
+     * @returns Resolves with the ISO country code (e.g., "SG", "ID", "MY"), or error information if the request fails.
+     *
+     * @throws Error when the JSBridge method fails unexpectedly.
+     *
+     * @example
+     * Get country code
+     * ```typescript
+     * const response = await locationModule.getCountryCode();
+     * ```
+     *
+     * @example
+     * Handling the response
+     * ```typescript
+     * try {
+     *   const { status_code, result, error } = await locationModule.getCountryCode();
+     *   switch (status_code) {
+     *     case 200:
+     *       console.log('Country code:', result.countryCode);
+     *       break;
+     *     default:
+     *       console.log(`Could not get country code${error ? `: ${error}` : ''}`);
+     *       break;
+     *   }
+     * } catch (error) {
+     *   console.log(`Could not get country code${error ? `: ${error}` : ''}`);
+     * }
+     * ```
+     *
+     * @public
+     */
+    getCountryCode(): Promise<GetCountryCodeResponse>;
 }
 
-export declare class MediaModule {
-    playDRMContent(data: any): any;
+/**
+ * JSBridge module for playing DRM-protected media content.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Provides access to the native media player with DRM support for secure content playback.
+ * Requires the MiniApp to be running within the Grab SuperApp's webview.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { MediaModule } from '@grabjs/superapp-sdk';
+ * const media = new MediaModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const media = new SuperAppSDK.MediaModule();
+ * </script>
+ * ```
+ *
+ * @public
+ */
+export declare class MediaModule extends BaseModule {
+    constructor();
+    playDRMContent(data: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
+    observePlayDRMContent(data: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
 }
 
-export declare class PlatformModule {
-    back(): any;
+/**
+ * Response when observing the device coordinates.
+ *
+ * @public
+ */
+export declare type ObserveLocationChangeResponse = DataStream_2<GetCoordinateResult>;
+
+/**
+ * Response when notifying content loaded.
+ *
+ * @public
+ */
+export declare type OnContentLoadedResponse = BridgeResponse<null>;
+
+/**
+ * Request parameters for notifying CTA tap.
+ *
+ * @public
+ */
+export declare type OnCtaTapRequest = string;
+
+/**
+ * Response when notifying CTA tap.
+ *
+ * @public
+ */
+export declare type OnCtaTapResponse = BridgeResponse<null>;
+
+/**
+ * Request parameters for opening an external link.
+ *
+ * @public
+ */
+export declare type OpenExternalLinkRequest = string;
+
+/**
+ * Response when opening an external link.
+ *
+ * @public
+ */
+export declare type OpenExternalLinkResponse = BridgeResponse<null>;
+
+/**
+ * JSBridge module for controlling platform navigation.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Provides methods to interact with the native platform navigation stack, such as triggering the back action.
+ * Requires the MiniApp to be running within the Grab SuperApp's webview.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { PlatformModule } from '@grabjs/superapp-sdk';
+ * const platform = new PlatformModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const platform = new SuperAppSDK.PlatformModule();
+ * </script>
+ * ```
+ *
+ * @public
+ */
+export declare class PlatformModule extends BaseModule {
+    constructor();
+    back(): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
 }
 
-export declare class ProfileModule {
+/**
+ * JSBridge module for accessing user profile information.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Provides access to user profile data such as email verification.
+ * Requires the MiniApp to be running within the Grab SuperApp's webview.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { ProfileModule } from '@grabjs/superapp-sdk';
+ * const profile = new ProfileModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const profile = new SuperAppSDK.ProfileModule();
+ * </script>
+ * ```
+ *
+ * @public
+ */
+export declare class ProfileModule extends BaseModule {
+    constructor();
     static parseGrabUserAgent(userAgent: any): {
         appName: string;
         major: number;
@@ -142,30 +1459,261 @@ export declare class ProfileModule {
     };
     static isVersionBelow(current: any, min: any): boolean;
     static isSupported(): boolean;
-    fetchEmail(): any;
-    verifyEmail(verifyEmailDetails: any): any;
+    fetchEmail(): Promise<BridgeResponse<unknown>> | DataStream<unknown> | Promise<{
+        status_code: number;
+        error: string;
+    }>;
+    verifyEmail(verifyEmailDetails: any): Promise<BridgeResponse<unknown>> | DataStream<unknown> | Promise<{
+        status_code: number;
+        error: string;
+    }>;
 }
 
-export declare class ScopeModule {
-    hasAccessTo(module: any, method: any): any;
-    reloadScopes(): any;
+/**
+ * Request parameters for scanning QR codes
+ *
+ * @public
+ */
+export declare type ScanQRCodeRequest = {
+    /** Optional title shown in the camera view header. */
+    title?: string;
+};
+
+/**
+ * Response when scanning a QR code
+ *
+ * @public
+ */
+export declare type ScanQRCodeResponse = BridgeResponse<ScanQRCodeResult>;
+
+/**
+ * Result object containing the scanned QR code data
+ *
+ * @public
+ */
+export declare type ScanQRCodeResult = {
+    /** The raw string content decoded from the scanned QR code. */
+    qrCode: string;
+};
+
+/**
+ * JSBridge module for checking and refreshing API access permissions.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Manages OAuth scope permissions to determine which JSBridge modules and methods the MiniApp has access to.
+ * Requires the MiniApp to be running within the Grab SuperApp's webview.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { ScopeModule } from '@grabjs/superapp-sdk';
+ * const scope = new ScopeModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const scope = new SuperAppSDK.ScopeModule();
+ * </script>
+ * ```
+ *
+ * @public
+ */
+export declare class ScopeModule extends BaseModule {
+    constructor();
+    hasAccessTo(module: any, method: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
+    reloadScopes(): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
 }
 
-export declare class StorageModule {
-    setBoolean(key: any, value: any): any;
-    getBoolean(key: any): any;
-    setInt(key: any, value: any): any;
-    getInt(key: any): any;
-    setString(key: any, value: any): any;
-    getString(key: any): any;
-    setDouble(key: any, value: any): any;
-    getDouble(key: any): any;
-    remove(key: any): any;
-    removeAll(): any;
+/**
+ * Request parameters for sending analytics events.
+ *
+ * @public
+ */
+export declare type SendAnalyticsEventRequest = {
+    /** Analytics event state (e.g., "HOMEPAGE", "CHECKOUT_PAGE"). */
+    state: string;
+    /** Analytics event name (e.g., "DEFAULT", "BOOK"). */
+    name: string;
+    /** Optional additional data for the analytics event. */
+    data?: Record<string, any>;
+};
+
+/**
+ * Response when sending analytics events.
+ *
+ * @public
+ */
+export declare type SendAnalyticsEventResponse = BridgeResponse<null>;
+
+/**
+ * Request parameters for setting the background color.
+ *
+ * @public
+ */
+export declare type SetBackgroundColorRequest = string;
+
+/**
+ * Response when setting the background color.
+ *
+ * @public
+ */
+export declare type SetBackgroundColorResponse = BridgeResponse<null>;
+
+/**
+ * Request parameters for setting the title.
+ *
+ * @public
+ */
+export declare type SetTitleRequest = string;
+
+/**
+ * Response when setting the title.
+ *
+ * @public
+ */
+export declare type SetTitleResponse = BridgeResponse<null>;
+
+/**
+ * Response when showing the back button.
+ *
+ * @public
+ */
+export declare type ShowBackButtonResponse = BridgeResponse<null>;
+
+/**
+ * Response when showing the loader.
+ *
+ * @public
+ */
+export declare type ShowLoaderResponse = BridgeResponse<null>;
+
+/**
+ * Response when showing the refresh button.
+ *
+ * @public
+ */
+export declare type ShowRefreshButtonResponse = BridgeResponse<null>;
+
+/**
+ * JSBridge module for persisting key-value data to native storage.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Stores data in the native app's persistent storage, allowing data to survive webview restarts.
+ * Requires the MiniApp to be running within the Grab SuperApp's webview.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { StorageModule } from '@grabjs/superapp-sdk';
+ * const storage = new StorageModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const storage = new SuperAppSDK.StorageModule();
+ * </script>
+ * ```
+ *
+ * @public
+ */
+export declare class StorageModule extends BaseModule {
+    constructor();
+    setBoolean(key: any, value: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
+    getBoolean(key: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
+    setInt(key: any, value: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
+    getInt(key: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
+    setString(key: any, value: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
+    getString(key: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
+    setDouble(key: any, value: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
+    getDouble(key: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
+    remove(key: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
+    removeAll(): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
+}
+
+/**
+ * Controls an active stream subscription. Call `unsubscribe()` to stop receiving data.
+ *
+ * @remarks
+ * Returned by `subscribe()`. Use `unsubscribe()` to terminate the stream early.
+ * Use `isUnsubscribed()` to check if already terminated.
+ *
+ * @public
+ */
+export declare type Subscription = Readonly<{
+    /** Returns true if this subscription has been terminated. */
+    isUnsubscribed: () => boolean;
+    /** Terminates the subscription. No further data will be received. */
+    unsubscribe: () => unknown;
+}>;
+
+/**
+ * JSBridge module for opening URLs in the device's system browser.
+ *
+ * @group Modules
+ *
+ * @remarks
+ * Allows MiniApps to redirect users to external content using the native system webview.
+ * Requires the MiniApp to be running within the Grab SuperApp's webview.
+ *
+ * @example
+ * **ES Module:**
+ * ```typescript
+ * import { SystemWebViewKitModule } from '@grabjs/superapp-sdk';
+ * const webViewKit = new SystemWebViewKitModule();
+ * ```
+ *
+ * @example
+ * **CDN (UMD):**
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@grabjs/superapp-sdk/dist/index.js"></script>
+ * <script>
+ *   const webViewKit = new SuperAppSDK.SystemWebViewKitModule();
+ * </script>
+ * ```
+ *
+ * @public
+ */
+export declare class SystemWebViewKitModule extends BaseModule {
+    constructor();
+    redirectToSystemWebView(payload: any): Promise<BridgeResponse<unknown>> | DataStream<unknown>;
 }
 
-export declare class SystemWebViewKitModule {
-    redirectToSystemWebView(payload: any): any;
+/**
+ * Generic interface for all native JSBridge module wrappers.
+ *
+ * @remarks
+ * This is the base interface that all Wrapped*Module interfaces implement.
+ * Modules can use this directly for generic method invocation, or extend it
+ * with method-specific overloads for stricter typing.
+ *
+ * @example
+ * Using directly (CameraModule, ContainerModule):
+ * ```typescript
+ * invoke<ScanQRCodeResult>('scanQRCode', request)
+ * ```
+ *
+ * @example
+ * Extending with method overloads (ProfileModule, LocationModule):
+ * ```typescript
+ * export interface WrappedProfileModule extends WrappedModule {
+ *   invoke(method: 'fetchEmail', params?: any): Promise<BridgeResponse<string>>;
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare interface WrappedModule {
+    invoke<T>(method: string, params?: unknown): Promise<BridgeResponse<T>> | DataStream<T>;
 }
 
 export { }