TypeScript Bridge SDK

# Core library only
npm install @gbgplc-internal/ggo-native-bridge

# Core + React bindings
npm install @gbgplc-internal/ggo-native-bridge @gbgplc-internal/ggo-native-bridge-react

import { NativeBridge, BridgeError } from '@gbgplc-internal/ggo-native-bridge';

// Get the bridge singleton
const bridge = NativeBridge.getInstance();

// Check the environment
console.log(bridge.environment); // 'ios' | 'android' | 'iframe' | 'standalone'
console.log(bridge.isEmbedded);  // true if inside a host

// Discover what the host supports
const capabilities = await bridge.discoverCapabilities();

// Request a native capability
if (bridge.hasCapability('camera.document')) {
  try {
    const response = await bridge.request('camera.document.capture', {
      documentType: 'passport',
      side: 'front',
    });
    console.log('Capture result:', response.data);
  } catch (error) {
    if (error instanceof BridgeError) {
      console.error(`[${error.code}]: ${error.message}`);
    }
  }
}

// Emit events to the host
bridge.emit('journey.started', { journeyId: 'abc-123', timestamp: Date.now() });

// Listen for events from the host
const unsubscribe = bridge.on('host.navigation.back', (data) => {
  console.log('Host requested back navigation:', data);
});

import { BridgeProvider, useBridge, useNativeCamera } from '@gbgplc-internal/ggo-native-bridge-react';

function App() {
  return (
    <BridgeProvider>
      <JourneyScreen />
    </BridgeProvider>
  );
}

function JourneyScreen() {
  const { environment, isEmbedded, capabilitiesReady } = useBridge();
  const { isNativeAvailable, requestCapture } = useNativeCamera('document');

  if (!capabilitiesReady) return <p>Discovering capabilities...</p>;

  return (
    <div>
      <p>Running in: {environment}</p>
      <button
        onClick={async () => {
          if (isNativeAvailable) {
            const result = await requestCapture({ side: 'front' });
            console.log('Native capture:', result.data);
          } else {
            console.log('Use web fallback camera');
          }
        }}
      >
        Capture Document
      </button>
    </div>
  );
}