Auth Adapter +

app/src/providers/selfClientProvider.tsx

@@ -15,6 +15,8 @@ import { TrackEventParams } from '@selfxyz/mobile-sdk-alpha';
 import { selfClientDocumentsAdapter } from '@/providers/passportDataProvider';
 import analytics from '@/utils/analytics';
 
+import { unsafe_getPrivateKey } from './authProvider';
+
 /**
  * Provides a configured Self SDK client instance to all descendants.
  *
@@ -82,6 +84,9 @@ export const SelfClientProvider = ({ children }: PropsWithChildren) => {
           analytics().trackEvent(event, data);
         },
       },
+      auth: {
+        getPrivateKey: () => unsafe_getPrivateKey(),
+      },
     }),
     [],
   );

app/src/screens/dev/DevPrivateKeyScreen.tsx

@@ -6,7 +6,8 @@ import { useCallback, useEffect, useState } from 'react';
 import { Button, Text, XStack, YStack } from 'tamagui';
 import Clipboard from '@react-native-clipboard/clipboard';
 
-import { unsafe_getPrivateKey } from '@/providers/authProvider';
+import { useSelfClient } from '@selfxyz/mobile-sdk-alpha';
+
 import { black, slate50, slate200, teal500, white } from '@/utils/colors';
 import { confirmTap } from '@/utils/haptic';
 
@@ -16,12 +17,24 @@ const DevPrivateKeyScreen: React.FC = () => {
   );
   const [isPrivateKeyRevealed, setIsPrivateKeyRevealed] = useState(false);
   const [copied, setCopied] = useState(false);
+  const selfClient = useSelfClient();
 
   useEffect(() => {
-    unsafe_getPrivateKey().then(key =>
-      setPrivateKey(key || 'No private key found'),
-    );
-  }, []);
+    let mounted = true;
+    selfClient
+      .getPrivateKey()
+      .then(key => {
+        if (!mounted) return;
+        setPrivateKey(key || 'No private key found');
+      })
+      .catch(() => {
+        if (!mounted) return;
+        setPrivateKey('No private key found');
+      });
+    return () => {
+      mounted = false;
+    };
+  }, [selfClient]);
 
   const handleRevealPrivateKey = useCallback(() => {
     confirmTap();

app/src/utils/proving/provingMachine.ts

@@ -35,8 +35,6 @@ import {
 } from '@selfxyz/mobile-sdk-alpha/constants/analytics';
 
 import { navigationRef } from '@/navigation';
-// this will be pass as property of from selfClient
-import { unsafe_getPrivateKey } from '@/providers/authProvider';
 // will need to be passed in from selfClient
 import {
   clearPassportData,
@@ -651,8 +649,7 @@ export const useProvingStore = create<ProvingState>((set, get) => {
 
       const { data: passportData } = selectedDocument;
 
-      // TODO call on self client
-      const secret = await unsafe_getPrivateKey();
+      const secret = await selfClient.getPrivateKey();
       if (!secret) {
         console.error('Could not load secret');
         trackEvent(ProofEvents.LOAD_SECRET_FAILED);

packages/mobile-sdk-alpha/src/browser.ts

@@ -44,8 +44,6 @@ export type { SdkErrorCategory } from './errors';
 
 export { SCANNER_ERROR_CODES, notImplemented, sdkError } from './errors';
 export { SelfClientContext, SelfClientProvider, useSelfClient } from './context';
-// Browser-only high-level component (DOM-based)
-export { SelfMobileSdk as SelfMobileSdkHighLevel } from './components/SelfMobileSdk';
 
 export { createSelfClient } from './client';
 

packages/mobile-sdk-alpha/src/client.ts

@@ -30,7 +30,7 @@ import { TrackEventParams } from './types/public';
  * own. These defaults are intentionally minimal no-ops suitable for tests and
  * non-production environments.
  */
-const optionalDefaults: Partial<Adapters> = {
+const optionalDefaults: Required<Pick<Adapters, 'storage' | 'clock' | 'logger'>> = {
   storage: {
     get: async () => null,
     set: async () => {},
@@ -47,7 +47,7 @@ const optionalDefaults: Partial<Adapters> = {
   },
 };
 
-const REQUIRED_ADAPTERS = ['scanner', 'network', 'crypto', 'documents'] as const;
+const REQUIRED_ADAPTERS = ['auth', 'scanner', 'network', 'crypto', 'documents'] as const;
 
 /**
  * Creates a fully configured {@link SelfClient} instance.
@@ -56,14 +56,14 @@ const REQUIRED_ADAPTERS = ['scanner', 'network', 'crypto', 'documents'] as const
  * provided configuration with sensible defaults. Missing optional adapters are
  * filled with benign no-op implementations.
  */
-export function createSelfClient({ config, adapters }: { config: Config; adapters: Partial<Adapters> }): SelfClient {
+export function createSelfClient({ config, adapters }: { config: Config; adapters: Adapters }): SelfClient {
   const cfg = mergeConfig(defaultConfig, config);
 
   for (const name of REQUIRED_ADAPTERS) {
     if (!(name in adapters) || !adapters[name as keyof Adapters]) throw notImplemented(name);
   }
 
-  const _adapters = { ...optionalDefaults, ...adapters } as Adapters;
+  const _adapters = { ...optionalDefaults, ...adapters };
   const listeners = new Map<SDKEvent, Set<(p: any) => void>>();
 
   function on<E extends SDKEvent>(event: E, cb: (payload: SDKEventMap[E]) => void): Unsubscribe {
@@ -128,10 +128,30 @@ export function createSelfClient({ config, adapters }: { config: Config; adapter
     return adapters.analytics.trackEvent(event, payload);
   }
 
+  /**
+   * Retrieves the private key via the auth adapter.
+   * With great power comes great responsibility
+   */
+  async function getPrivateKey(): Promise<string | null> {
+    return adapters.auth.getPrivateKey();
+  }
+
+  async function hasPrivateKey(): Promise<boolean> {
+    if (!adapters.auth) return false;
+    try {
+      const key = await adapters.auth.getPrivateKey();
+      return !!key;
+    } catch {
+      return false;
+    }
+  }
+
   return {
     scanDocument,
     validateDocument,
     trackEvent,
+    getPrivateKey,
+    hasPrivateKey,
     checkRegistration,
     registerDocument,
     generateProof,

packages/mobile-sdk-alpha/src/context.tsx

@@ -28,7 +28,7 @@ export interface SelfClientProviderProps {
    * Partial set of adapter implementations. Any missing optional adapters will
    * be replaced with default no-op implementations.
    */
-  adapters?: Partial<Adapters>;
+  adapters: Adapters;
 }
 
 export { SelfClientContext };
@@ -40,7 +40,7 @@ export { SelfClientContext };
  * Consumers should ensure that `config` and `adapters` are referentially stable
  * (e.g. wrapped in `useMemo`) to avoid recreating the client on every render.
  */
-export function SelfClientProvider({ config, adapters = {}, children }: PropsWithChildren<SelfClientProviderProps>) {
+export function SelfClientProvider({ config, adapters, children }: PropsWithChildren<SelfClientProviderProps>) {
   const client = useMemo(() => createSelfClient({ config, adapters }), [config, adapters]);
 
   return <SelfClientContext.Provider value={client}>{children}</SelfClientContext.Provider>;

packages/mobile-sdk-alpha/src/entry/index.tsx

@@ -9,11 +9,11 @@ import type { Adapters, Config } from '../types/public';
 
 export interface SelfMobileSdkProps {
   config: Config;
-  adapters?: Partial<Adapters>;
+  adapters: Adapters;
   children?: ReactNode;
 }
 
-export const SelfMobileSdk = ({ config, adapters = {}, children }: SelfMobileSdkProps) => (
+export const SelfMobileSdk = ({ config, adapters, children }: SelfMobileSdkProps) => (
   <SelfClientProvider config={config} adapters={adapters}>
     {children}
   </SelfClientProvider>

packages/mobile-sdk-alpha/src/index.ts

@@ -40,7 +40,7 @@ export type {
 // MRZ module
 export type { DG1, DG2, NFCScanOptions, ParsedNFCResponse } from './nfc';
 
-export type { DocumentData, DocumentMetadata, ExternalAdapter, PassportCameraProps, ScreenProps } from './types/ui';
+export type { DocumentData, DocumentMetadata, PassportCameraProps, ScreenProps } from './types/ui';
 
 export type { MRZScanOptions } from './mrz';
 
@@ -65,9 +65,6 @@ export {
 
 export { NFCScannerScreen } from './components/screens/NFCScannerScreen';
 
-// Flow Components
-export { OnboardingFlow } from './components/flows/OnboardingFlow';
-
 // Screen Components
 export { PassportCameraScreen } from './components/screens/PassportCameraScreen';
 
@@ -100,8 +97,5 @@ export { parseNFCResponse, scanNFC } from './nfc';
 
 export { scanQRProof } from './qr';
 
-// Hooks
-export { useDocumentManager } from './hooks/useDocumentManager';
-
 // Error handling
 export { webScannerShim } from './adapters/web/shims';