@safercity/sdk-react-native 0.1.0 → 0.1.1

package/README.md

@@ -1,6 +1,6 @@
 # @safercity/sdk-react-native
 
-React Native adapter for SaferCity SDK with expo-fetch streaming support.
+React Native adapter for SaferCity SDK with expo-fetch streaming support and secure token storage.
 
 ## Installation
 
@@ -19,10 +19,9 @@ bun add @safercity/sdk-react-native @safercity/sdk-react @tanstack/react-query
 ## Quick Start
 
 ```tsx
-import { createReactNativeClient, isStreamingSupported } from '@safercity/sdk-react-native';
+import { createReactNativeClient } from '@safercity/sdk-react-native';
 import { SaferCityProvider } from '@safercity/sdk-react';
 
-// Create client with React Native optimizations
 const client = createReactNativeClient({
   baseUrl: 'https://api.safercity.com',
   token: userToken,
@@ -38,6 +37,76 @@ function App() {
 }
 ```
 
+## Authentication Modes
+
+On mobile, **direct mode** is the most common pattern. Your app authenticates users with an external auth provider and passes the token to SaferCity:
+
+```tsx
+import { SaferCityProvider } from '@safercity/sdk-react';
+
+function App() {
+  return (
+    <SaferCityProvider
+      mode="direct"
+      baseUrl="https://api.safercity.com"
+      tenantId="tenant-123"
+      getAccessToken={() => getTokenFromAuthProvider()}
+    >
+      <Navigation />
+    </SaferCityProvider>
+  );
+}
+```
+
+**Proxy mode** also works if your mobile app communicates through a backend-for-frontend (BFF). Cookie mode is not typical for mobile apps.
+
+## Secure Token Storage
+
+For server-side OAuth flows on mobile (e.g., background token management), the SDK provides secure storage that auto-detects the best available option:
+
+```typescript
+import { createSecureTokenStorage, getStorageType } from '@safercity/sdk-react-native';
+import { TokenManager } from '@safercity/sdk';
+
+// Auto-detects: expo-secure-store > AsyncStorage > in-memory
+const storage = createSecureTokenStorage();
+
+const tokenManager = new TokenManager({
+  credentials: {
+    clientId: 'your-client-id',
+    clientSecret: 'your-client-secret',
+  },
+  storage,
+});
+
+// Get token (auto-refreshes if expired)
+const token = await tokenManager.getToken();
+
+// Check what storage is being used
+const type = getStorageType(); // 'secure-store' | 'async-storage' | 'memory'
+```
+
+### Storage Priority
+
+| Storage | Package | Security | Persistence |
+|---------|---------|----------|-------------|
+| `SecureStoreTokenStorage` | `expo-secure-store` | Encrypted (device keychain/keystore) | Yes |
+| `AsyncStorageTokenStorage` | `@react-native-async-storage/async-storage` | Unencrypted | Yes |
+| `InMemoryTokenStorage` | Built-in | N/A | No |
+
+You can also use a specific storage class directly:
+
+```typescript
+import {
+  SecureStoreTokenStorage,
+  AsyncStorageTokenStorage,
+  InMemoryTokenStorage,
+} from '@safercity/sdk-react-native';
+
+const storage = new SecureStoreTokenStorage();
+await storage.waitForInit(); // wait for initial load from device storage
+```
+
 ## Streaming Support
 
 This package automatically uses `expo-fetch` for streaming when available (Expo SDK 52+).
@@ -45,7 +114,6 @@ This package automatically uses `expo-fetch` for streaming when available (Expo
 ```tsx
 import { isStreamingSupported } from '@safercity/sdk-react-native';
 
-// Check if streaming is supported
 if (isStreamingSupported()) {
   console.log('SSE streaming is available');
 } else {
@@ -57,6 +125,7 @@ if (isStreamingSupported()) {
 
 ```tsx
 import { usePanicStream } from '@safercity/sdk-react';
+import { isStreamingSupported } from '@safercity/sdk-react-native';
 
 function PanicTracker({ panicId }: { panicId: string }) {
   const { data, isConnected, error } = usePanicStream(panicId, {
@@ -66,7 +135,6 @@ function PanicTracker({ panicId }: { panicId: string }) {
   });
   
   if (!isStreamingSupported()) {
-    // Fallback to polling
     return <PollingPanicTracker panicId={panicId} />;
   }
   
@@ -81,13 +149,11 @@ function PanicTracker({ panicId }: { panicId: string }) {
 
 ## Without Expo
 
-For bare React Native projects without Expo, streaming will fall back to standard fetch.
-SSE may have limited support depending on your React Native version.
+For bare React Native projects without Expo, streaming will fall back to standard fetch. SSE may have limited support depending on your React Native version.
 
 ```tsx
 import { createReactNativeClient } from '@safercity/sdk-react-native';
 
-// You can provide a custom fetch implementation
 const client = createReactNativeClient({
   baseUrl: 'https://api.safercity.com',
   token: userToken,
@@ -141,7 +207,19 @@ Returns `true` if expo-fetch is available and streaming is supported.
 
 ### getReactNativeFetch(customFetch?)
 
-Returns the best available fetch implementation for the current environment.
+Returns the best available fetch implementation for the current environment. Priority: expo-fetch > custom > global fetch.
+
+### createReactNativeStreamAdapter(customFetch?)
+
+Creates a `FetchStreamAdapter` using the best available fetch for the environment.
+
+### createSecureTokenStorage()
+
+Auto-detects and returns the best available token storage. Priority: expo-secure-store > AsyncStorage > in-memory.
+
+### getStorageType()
+
+Returns `'secure-store'` | `'async-storage'` | `'memory'` indicating what storage is available.
 
 ## Troubleshooting
 

package/package.json

@@ -1,16 +1,11 @@
 {
   "name": "@safercity/sdk-react-native",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "React Native adapter for SaferCity SDK with expo-fetch streaming support",
   "license": "MIT",
   "author": {
     "name": "SaferCity"
   },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/safercity/safercity-v2.git",
-    "directory": "packages/sdk/react-native"
-  },
   "keywords": ["safercity", "sdk", "react-native", "expo", "streaming"],
   "sideEffects": false,
   "type": "module",