@rn-bridge-tools/react 0.0.1

package/dist/index.d.cts

@@ -0,0 +1,311 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+import * as _rn_bridge_tools_core from '@rn-bridge-tools/core';
+import { BridgeToolsAction, BridgeToolsSchema, BridgeToolsEvent, BridgeToolsEvents, CameraNamespace, LocationNamespace, LocationEvents, FileNamespace, ShareNamespace, StatusBarNamespace, HapticNamespace, ClipboardNamespace, ScannerNamespace, AuthNamespace, IAPNamespace, PermissionNamespace, PreferenceNamespace, NavigationNamespace, BrowserNamespace } from '@rn-bridge-tools/core';
+
+type SendFn = <K extends BridgeToolsAction>(action: K, payload: BridgeToolsSchema[K]['request']) => Promise<BridgeToolsSchema[K]['response']>;
+type OnFn = <E extends BridgeToolsEvent>(event: E, callback: (data: BridgeToolsEvents[E]) => void) => () => void;
+interface BridgeContextValue {
+    send: SendFn;
+    on: OnFn;
+    isAvailable: boolean;
+}
+interface BridgeProviderProps {
+    children?: React.ReactNode | undefined;
+    timeout?: number;
+    debug?: boolean;
+    onReady?: () => void;
+}
+declare function BridgeProvider({ children, timeout, debug, onReady }: BridgeProviderProps): react_jsx_runtime.JSX.Element;
+declare function useBridge(): BridgeContextValue;
+
+/**
+ * Lightweight external store compatible with useSyncExternalStore.
+ * Used for bridge event subscriptions (keyboard, location, push, etc.)
+ */
+declare function createBridgeStore<T>(initialState: T): {
+    getSnapshot(): T;
+    getServerSnapshot(): T;
+    subscribe(listener: () => void): () => void;
+    setState(next: T | ((prev: T) => T)): void;
+    destroy(): void;
+};
+type BridgeStore<T> = ReturnType<typeof createBridgeStore<T>>;
+/**
+ * Hook that subscribes to a BridgeStore using useSyncExternalStore.
+ * Concurrent Mode safe — no tearing.
+ */
+declare function useBridgeStore<T>(store: BridgeStore<T>): T;
+/**
+ * Hook that subscribes to a BridgeStore with a selector.
+ * Only re-renders when the selected value changes.
+ */
+declare function useBridgeStoreSelector<T, S>(store: BridgeStore<T>, selector: (state: T) => S): S;
+/**
+ * Subscribe to a single bridge event and sync to a store.
+ * Returns the current snapshot via useSyncExternalStore.
+ */
+declare function useBridgeEvent<T, E extends BridgeToolsEvent>(on: BridgeContextValue['on'], event: E, initialState: T, updater: (prev: T, data: BridgeToolsEvents[E]) => T): T;
+type EventBinding<T> = {
+    event: BridgeToolsEvent;
+    updater: (prev: T, data: never) => T;
+};
+/**
+ * Subscribe to multiple bridge events and sync to a single store.
+ * Returns the current snapshot via useSyncExternalStore.
+ */
+declare function useBridgeEvents<T>(on: BridgeContextValue['on'], initialState: T, bindings: EventBinding<T>[]): T;
+
+declare function useCamera(): {
+    take: (opts?: CameraNamespace["camera.take"]["request"]) => Promise<{
+        success: boolean;
+        uri?: string;
+        width?: number;
+        height?: number;
+        fileSize?: number;
+        mimeType?: string;
+        base64?: string;
+    }>;
+    pickImage: (opts?: CameraNamespace["camera.pickImage"]["request"]) => Promise<{
+        success: boolean;
+        assets: Array<{
+            uri: string;
+            width: number;
+            height: number;
+            fileSize?: number;
+            mimeType?: string;
+        }>;
+    }>;
+};
+
+declare function useLocation(): {
+    getCurrent: (opts?: LocationNamespace["location.getCurrent"]["request"]) => Promise<{
+        lat: number;
+        lng: number;
+        altitude?: number;
+        accuracy?: number;
+        timestamp: number;
+    }>;
+    watchStart: (opts?: LocationNamespace["location.watchStart"]["request"]) => Promise<{
+        watchId: string;
+    }>;
+    watchStop: (opts: LocationNamespace["location.watchStop"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+};
+type LocationUpdate = LocationEvents['location.update'] | null;
+declare function useLocationWatch(opts?: LocationNamespace['location.watchStart']['request']): LocationUpdate;
+
+declare function useFile(): {
+    download: (opts: FileNamespace["file.download"]["request"]) => Promise<{
+        success: boolean;
+        localUri?: string;
+        error?: string;
+    }>;
+    read: (opts: FileNamespace["file.read"]["request"]) => Promise<{
+        success: boolean;
+        content?: string;
+        error?: string;
+    }>;
+    write: (opts: FileNamespace["file.write"]["request"]) => Promise<{
+        success: boolean;
+        uri?: string;
+        error?: string;
+    }>;
+    pick: (opts?: FileNamespace["file.pick"]["request"]) => Promise<{
+        success: boolean;
+        files: Array<{
+            uri: string;
+            name: string;
+            size: number;
+            mimeType: string;
+        }>;
+    }>;
+};
+
+declare function useShare(): {
+    open: (opts?: ShareNamespace["share.open"]["request"]) => Promise<{
+        success: boolean;
+        activityType?: string;
+    }>;
+};
+
+declare function useDevice(): {
+    getInfo: () => Promise<{
+        os: "ios" | "android";
+        osVersion: string;
+        model: string;
+        brand: string;
+        isTablet: boolean;
+        appVersion: string;
+        buildNumber: string;
+        bundleId: string;
+    }>;
+    getBattery: () => Promise<{
+        level: number;
+        isCharging: boolean;
+    }>;
+    getNetwork: () => Promise<{
+        type: "wifi" | "cellular" | "none" | "unknown";
+        isConnected: boolean;
+    }>;
+};
+
+declare function useStatusBar(): {
+    setStyle: (opts: StatusBarNamespace["statusbar.setStyle"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    setBackgroundColor: (opts: StatusBarNamespace["statusbar.setBackgroundColor"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    setHidden: (opts: StatusBarNamespace["statusbar.setHidden"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+};
+
+declare function useKeyboard(): {
+    visible: boolean;
+    height: number;
+    dismiss: () => Promise<{
+        success: boolean;
+    }>;
+};
+
+declare function useHaptic(): {
+    impact: (opts: HapticNamespace["haptic.impact"]["request"]) => Promise<void>;
+    notification: (opts: HapticNamespace["haptic.notification"]["request"]) => Promise<void>;
+    selection: () => Promise<void>;
+};
+
+declare function useClipboard(): {
+    copy: (opts: ClipboardNamespace["clipboard.copy"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    paste: () => Promise<{
+        text: string;
+        hasContent: boolean;
+    }>;
+};
+
+declare function useScanner(): {
+    scanQR: (opts?: ScannerNamespace["scanner.scanQR"]["request"]) => Promise<{
+        success: boolean;
+        data?: string;
+        type?: string;
+        cancelled?: boolean;
+    }>;
+};
+
+declare function useAuth(): {
+    biometric: (opts?: AuthNamespace["auth.biometric"]["request"]) => Promise<{
+        success: boolean;
+        error?: string;
+        biometryType?: "fingerprint" | "facial" | "iris";
+    }>;
+    isBiometricAvailable: () => Promise<{
+        available: boolean;
+        biometryType?: "fingerprint" | "facial" | "iris";
+    }>;
+};
+
+declare function useIAP(): {
+    getProducts: (opts: IAPNamespace["iap.getProducts"]["request"]) => Promise<{
+        products: Array<{
+            id: string;
+            title: string;
+            description: string;
+            price: string;
+            currency: string;
+        }>;
+    }>;
+    purchase: (opts: IAPNamespace["iap.purchase"]["request"]) => Promise<{
+        success: boolean;
+        transactionId?: string;
+        receipt?: string;
+        error?: string;
+    }>;
+    restore: () => Promise<{
+        purchases: Array<{
+            productId: string;
+            transactionId: string;
+        }>;
+    }>;
+};
+
+declare function usePush(): {
+    getToken: () => Promise<{
+        token: string;
+        platform: "apns" | "fcm";
+    }>;
+    requestPermission: () => Promise<{
+        granted: boolean;
+        status: "granted" | "denied" | "undetermined";
+    }>;
+};
+declare function usePushNotification(): {
+    lastReceived: {
+        title?: string;
+        body?: string;
+        data?: Record<string, unknown>;
+    } | null;
+    lastTapped: {
+        title?: string;
+        body?: string;
+        data?: Record<string, unknown>;
+    } | null;
+};
+
+declare function usePermission(): {
+    check: (opts: PermissionNamespace["permission.check"]["request"]) => Promise<{
+        status: _rn_bridge_tools_core.PermissionStatus;
+        canAskAgain: boolean;
+    }>;
+    request: (opts: PermissionNamespace["permission.request"]["request"]) => Promise<{
+        status: _rn_bridge_tools_core.PermissionStatus;
+        canAskAgain: boolean;
+    }>;
+    openSettings: () => Promise<{
+        success: boolean;
+    }>;
+};
+
+declare function usePreference(): {
+    get: (opts: PreferenceNamespace["preference.get"]["request"]) => Promise<{
+        value: string | null;
+    }>;
+    set: (opts: PreferenceNamespace["preference.set"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    remove: (opts: PreferenceNamespace["preference.remove"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    clear: () => Promise<{
+        success: boolean;
+    }>;
+};
+
+declare function useNavigation(): {
+    goBack: () => Promise<{
+        success: boolean;
+    }>;
+    push: (opts: NavigationNamespace["navigation.push"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    close: () => Promise<{
+        success: boolean;
+    }>;
+    setSwipeBack: (opts: NavigationNamespace["navigation.setSwipeBack"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+};
+
+declare function useBrowser(): {
+    openExternal: (opts: BrowserNamespace["browser.openExternal"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    openInternal: (opts: BrowserNamespace["browser.openInternal"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+};
+
+export { type BridgeContextValue, BridgeProvider, type BridgeProviderProps, type BridgeStore, createBridgeStore, useAuth, useBridge, useBridgeEvent, useBridgeEvents, useBridgeStore, useBridgeStoreSelector, useBrowser, useCamera, useClipboard, useDevice, useFile, useHaptic, useIAP, useKeyboard, useLocation, useLocationWatch, useNavigation, usePermission, usePreference, usePush, usePushNotification, useScanner, useShare, useStatusBar };

package/dist/index.d.ts

@@ -0,0 +1,311 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+import * as _rn_bridge_tools_core from '@rn-bridge-tools/core';
+import { BridgeToolsAction, BridgeToolsSchema, BridgeToolsEvent, BridgeToolsEvents, CameraNamespace, LocationNamespace, LocationEvents, FileNamespace, ShareNamespace, StatusBarNamespace, HapticNamespace, ClipboardNamespace, ScannerNamespace, AuthNamespace, IAPNamespace, PermissionNamespace, PreferenceNamespace, NavigationNamespace, BrowserNamespace } from '@rn-bridge-tools/core';
+
+type SendFn = <K extends BridgeToolsAction>(action: K, payload: BridgeToolsSchema[K]['request']) => Promise<BridgeToolsSchema[K]['response']>;
+type OnFn = <E extends BridgeToolsEvent>(event: E, callback: (data: BridgeToolsEvents[E]) => void) => () => void;
+interface BridgeContextValue {
+    send: SendFn;
+    on: OnFn;
+    isAvailable: boolean;
+}
+interface BridgeProviderProps {
+    children?: React.ReactNode | undefined;
+    timeout?: number;
+    debug?: boolean;
+    onReady?: () => void;
+}
+declare function BridgeProvider({ children, timeout, debug, onReady }: BridgeProviderProps): react_jsx_runtime.JSX.Element;
+declare function useBridge(): BridgeContextValue;
+
+/**
+ * Lightweight external store compatible with useSyncExternalStore.
+ * Used for bridge event subscriptions (keyboard, location, push, etc.)
+ */
+declare function createBridgeStore<T>(initialState: T): {
+    getSnapshot(): T;
+    getServerSnapshot(): T;
+    subscribe(listener: () => void): () => void;
+    setState(next: T | ((prev: T) => T)): void;
+    destroy(): void;
+};
+type BridgeStore<T> = ReturnType<typeof createBridgeStore<T>>;
+/**
+ * Hook that subscribes to a BridgeStore using useSyncExternalStore.
+ * Concurrent Mode safe — no tearing.
+ */
+declare function useBridgeStore<T>(store: BridgeStore<T>): T;
+/**
+ * Hook that subscribes to a BridgeStore with a selector.
+ * Only re-renders when the selected value changes.
+ */
+declare function useBridgeStoreSelector<T, S>(store: BridgeStore<T>, selector: (state: T) => S): S;
+/**
+ * Subscribe to a single bridge event and sync to a store.
+ * Returns the current snapshot via useSyncExternalStore.
+ */
+declare function useBridgeEvent<T, E extends BridgeToolsEvent>(on: BridgeContextValue['on'], event: E, initialState: T, updater: (prev: T, data: BridgeToolsEvents[E]) => T): T;
+type EventBinding<T> = {
+    event: BridgeToolsEvent;
+    updater: (prev: T, data: never) => T;
+};
+/**
+ * Subscribe to multiple bridge events and sync to a single store.
+ * Returns the current snapshot via useSyncExternalStore.
+ */
+declare function useBridgeEvents<T>(on: BridgeContextValue['on'], initialState: T, bindings: EventBinding<T>[]): T;
+
+declare function useCamera(): {
+    take: (opts?: CameraNamespace["camera.take"]["request"]) => Promise<{
+        success: boolean;
+        uri?: string;
+        width?: number;
+        height?: number;
+        fileSize?: number;
+        mimeType?: string;
+        base64?: string;
+    }>;
+    pickImage: (opts?: CameraNamespace["camera.pickImage"]["request"]) => Promise<{
+        success: boolean;
+        assets: Array<{
+            uri: string;
+            width: number;
+            height: number;
+            fileSize?: number;
+            mimeType?: string;
+        }>;
+    }>;
+};
+
+declare function useLocation(): {
+    getCurrent: (opts?: LocationNamespace["location.getCurrent"]["request"]) => Promise<{
+        lat: number;
+        lng: number;
+        altitude?: number;
+        accuracy?: number;
+        timestamp: number;
+    }>;
+    watchStart: (opts?: LocationNamespace["location.watchStart"]["request"]) => Promise<{
+        watchId: string;
+    }>;
+    watchStop: (opts: LocationNamespace["location.watchStop"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+};
+type LocationUpdate = LocationEvents['location.update'] | null;
+declare function useLocationWatch(opts?: LocationNamespace['location.watchStart']['request']): LocationUpdate;
+
+declare function useFile(): {
+    download: (opts: FileNamespace["file.download"]["request"]) => Promise<{
+        success: boolean;
+        localUri?: string;
+        error?: string;
+    }>;
+    read: (opts: FileNamespace["file.read"]["request"]) => Promise<{
+        success: boolean;
+        content?: string;
+        error?: string;
+    }>;
+    write: (opts: FileNamespace["file.write"]["request"]) => Promise<{
+        success: boolean;
+        uri?: string;
+        error?: string;
+    }>;
+    pick: (opts?: FileNamespace["file.pick"]["request"]) => Promise<{
+        success: boolean;
+        files: Array<{
+            uri: string;
+            name: string;
+            size: number;
+            mimeType: string;
+        }>;
+    }>;
+};
+
+declare function useShare(): {
+    open: (opts?: ShareNamespace["share.open"]["request"]) => Promise<{
+        success: boolean;
+        activityType?: string;
+    }>;
+};
+
+declare function useDevice(): {
+    getInfo: () => Promise<{
+        os: "ios" | "android";
+        osVersion: string;
+        model: string;
+        brand: string;
+        isTablet: boolean;
+        appVersion: string;
+        buildNumber: string;
+        bundleId: string;
+    }>;
+    getBattery: () => Promise<{
+        level: number;
+        isCharging: boolean;
+    }>;
+    getNetwork: () => Promise<{
+        type: "wifi" | "cellular" | "none" | "unknown";
+        isConnected: boolean;
+    }>;
+};
+
+declare function useStatusBar(): {
+    setStyle: (opts: StatusBarNamespace["statusbar.setStyle"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    setBackgroundColor: (opts: StatusBarNamespace["statusbar.setBackgroundColor"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    setHidden: (opts: StatusBarNamespace["statusbar.setHidden"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+};
+
+declare function useKeyboard(): {
+    visible: boolean;
+    height: number;
+    dismiss: () => Promise<{
+        success: boolean;
+    }>;
+};
+
+declare function useHaptic(): {
+    impact: (opts: HapticNamespace["haptic.impact"]["request"]) => Promise<void>;
+    notification: (opts: HapticNamespace["haptic.notification"]["request"]) => Promise<void>;
+    selection: () => Promise<void>;
+};
+
+declare function useClipboard(): {
+    copy: (opts: ClipboardNamespace["clipboard.copy"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    paste: () => Promise<{
+        text: string;
+        hasContent: boolean;
+    }>;
+};
+
+declare function useScanner(): {
+    scanQR: (opts?: ScannerNamespace["scanner.scanQR"]["request"]) => Promise<{
+        success: boolean;
+        data?: string;
+        type?: string;
+        cancelled?: boolean;
+    }>;
+};
+
+declare function useAuth(): {
+    biometric: (opts?: AuthNamespace["auth.biometric"]["request"]) => Promise<{
+        success: boolean;
+        error?: string;
+        biometryType?: "fingerprint" | "facial" | "iris";
+    }>;
+    isBiometricAvailable: () => Promise<{
+        available: boolean;
+        biometryType?: "fingerprint" | "facial" | "iris";
+    }>;
+};
+
+declare function useIAP(): {
+    getProducts: (opts: IAPNamespace["iap.getProducts"]["request"]) => Promise<{
+        products: Array<{
+            id: string;
+            title: string;
+            description: string;
+            price: string;
+            currency: string;
+        }>;
+    }>;
+    purchase: (opts: IAPNamespace["iap.purchase"]["request"]) => Promise<{
+        success: boolean;
+        transactionId?: string;
+        receipt?: string;
+        error?: string;
+    }>;
+    restore: () => Promise<{
+        purchases: Array<{
+            productId: string;
+            transactionId: string;
+        }>;
+    }>;
+};
+
+declare function usePush(): {
+    getToken: () => Promise<{
+        token: string;
+        platform: "apns" | "fcm";
+    }>;
+    requestPermission: () => Promise<{
+        granted: boolean;
+        status: "granted" | "denied" | "undetermined";
+    }>;
+};
+declare function usePushNotification(): {
+    lastReceived: {
+        title?: string;
+        body?: string;
+        data?: Record<string, unknown>;
+    } | null;
+    lastTapped: {
+        title?: string;
+        body?: string;
+        data?: Record<string, unknown>;
+    } | null;
+};
+
+declare function usePermission(): {
+    check: (opts: PermissionNamespace["permission.check"]["request"]) => Promise<{
+        status: _rn_bridge_tools_core.PermissionStatus;
+        canAskAgain: boolean;
+    }>;
+    request: (opts: PermissionNamespace["permission.request"]["request"]) => Promise<{
+        status: _rn_bridge_tools_core.PermissionStatus;
+        canAskAgain: boolean;
+    }>;
+    openSettings: () => Promise<{
+        success: boolean;
+    }>;
+};
+
+declare function usePreference(): {
+    get: (opts: PreferenceNamespace["preference.get"]["request"]) => Promise<{
+        value: string | null;
+    }>;
+    set: (opts: PreferenceNamespace["preference.set"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    remove: (opts: PreferenceNamespace["preference.remove"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    clear: () => Promise<{
+        success: boolean;
+    }>;
+};
+
+declare function useNavigation(): {
+    goBack: () => Promise<{
+        success: boolean;
+    }>;
+    push: (opts: NavigationNamespace["navigation.push"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    close: () => Promise<{
+        success: boolean;
+    }>;
+    setSwipeBack: (opts: NavigationNamespace["navigation.setSwipeBack"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+};
+
+declare function useBrowser(): {
+    openExternal: (opts: BrowserNamespace["browser.openExternal"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+    openInternal: (opts: BrowserNamespace["browser.openInternal"]["request"]) => Promise<{
+        success: boolean;
+    }>;
+};
+
+export { type BridgeContextValue, BridgeProvider, type BridgeProviderProps, type BridgeStore, createBridgeStore, useAuth, useBridge, useBridgeEvent, useBridgeEvents, useBridgeStore, useBridgeStoreSelector, useBrowser, useCamera, useClipboard, useDevice, useFile, useHaptic, useIAP, useKeyboard, useLocation, useLocationWatch, useNavigation, usePermission, usePreference, usePush, usePushNotification, useScanner, useShare, useStatusBar };