@passgage/sdk-react-native 1.0.2 → 1.0.4

package/README.md

@@ -1,13 +1,13 @@
-# @passgage-sdk/react-native
+# @passgage/sdk-react-native
 
-React Native wrapper for Passgage Access SDK with ready-to-use components and hooks.
+Complete Passgage Access SDK for React Native with authentication, QR/NFC scanning, check-in, and remote work features.
 
 ## Installation
 
 ```bash
-npm install @passgage-sdk/react-native @passgage-sdk/core
+npm install @passgage/sdk-react-native
 # or
-yarn add @passgage-sdk/react-native @passgage-sdk/core
+yarn add @passgage/sdk-react-native
 ```
 
 ### Peer Dependencies
@@ -15,13 +15,14 @@ yarn add @passgage-sdk/react-native @passgage-sdk/core
 You also need to install these peer dependencies:
 
 ```bash
-npm install react-native-vision-camera react-native-nfc-manager @react-native-community/geolocation
+npm install react-native-vision-camera react-native-nfc-manager @react-native-community/geolocation react-native-keychain
 ```
 
 Follow the installation instructions for each native library:
 - [react-native-vision-camera](https://react-native-vision-camera.com/docs/guides)
 - [react-native-nfc-manager](https://github.com/revtel/react-native-nfc-manager)
 - [@react-native-community/geolocation](https://github.com/react-native-geolocation/react-native-geolocation)
+- [react-native-keychain](https://github.com/oblador/react-native-keychain)
 
 ## Usage
 
@@ -30,13 +31,16 @@ Follow the installation instructions for each native library:
 Wrap your app with `PassgageAccessProvider`:
 
 ```typescript
-import { PassgageAccessProvider } from '@passgage-sdk/react-native';
+import { PassgageAccessProvider } from '@passgage/sdk-react-native';
 
 function App() {
   return (
     <PassgageAccessProvider
       baseURL="https://your-api.passgage.com"
-      token="your-jwt-token"
+      onUnauthorized={() => {
+        // Handle session expiration
+        console.log('Session expired');
+      }}
     >
       <YourApp />
     </PassgageAccessProvider>
@@ -44,13 +48,47 @@ function App() {
 }
 ```
 
-### QR Scanner Hook
+### Authentication
 
 ```typescript
-import { useQRScanner } from '@passgage-sdk/react-native';
+import { usePassgageAuth } from '@passgage/sdk-react-native';
+
+function LoginScreen() {
+  const { login, logout, user, isLoading, isAuthenticated } = usePassgageAuth({
+    onLoginSuccess: (user) => {
+      console.log('Logged in:', user?.fullName);
+    },
+    onLoginError: (error) => {
+      console.error('Login failed:', error);
+    },
+  });
+
+  const handleLogin = async () => {
+    await login({
+      login: 'user@example.com',
+      password: 'password123',
+    });
+  };
+
+  return (
+    <View>
+      {isAuthenticated ? (
+        <Text>Welcome, {user?.fullName}!</Text>
+      ) : (
+        <Button title="Login" onPress={handleLogin} disabled={isLoading} />
+      )}
+    </View>
+  );
+}
+```
+
+### QR Scanner
+
+```typescript
+import { usePassgageQRScanner } from '@passgage/sdk-react-native';
 
 function QRScanScreen() {
-  const { scan, isLoading, error } = useQRScanner({
+  const { scan, isLoading, error } = usePassgageQRScanner({
     onSuccess: (entrance) => {
       console.log('QR scan successful:', entrance);
     },
@@ -61,20 +99,22 @@ function QRScanScreen() {
 
   return (
     <View>
-      {/* Your camera view */}
-      <Camera onCodeScanned={(code) => scan(code)} />
+      <Camera
+        onCodeScanned={(code) => scan(code)}
+        isActive={!isLoading}
+      />
     </View>
   );
 }
 ```
 
-### NFC Scanner Hook
+### NFC Scanner
 
 ```typescript
-import { useNFCScanner } from '@passgage-sdk/react-native';
+import { usePassgageNFCScanner } from '@passgage/sdk-react-native';
 
 function NFCScanScreen() {
-  const { startScanning, stopScanning, isScanning } = useNFCScanner({
+  const { startScanning, stopScanning, isScanning } = usePassgageNFCScanner({
     onSuccess: (entrance) => {
       console.log('NFC scan successful:', entrance);
     },
@@ -88,28 +128,48 @@ function NFCScanScreen() {
     return () => stopScanning();
   }, []);
 
-  return <View>{/* Your NFC scan UI */}</View>;
+  return (
+    <View>
+      <Text>{isScanning ? 'Scanning...' : 'Tap to scan'}</Text>
+    </View>
+  );
 }
 ```
 
-### Check-In Hook
+### Check-In
 
 ```typescript
-import { useCheckIn } from '@passgage-sdk/react-native';
+import { usePassgageCheckIn, usePassgageAuth } from '@passgage/sdk-react-native';
 
 function CheckInScreen() {
-  const { nearbyBranches, checkIn, isLoading } = useCheckIn();
+  const { user } = usePassgageAuth();
+  const { getNearbyBranches, checkInEntry, checkInExit, isLoading } = usePassgageCheckIn();
+  const [branches, setBranches] = useState([]);
+
+  useEffect(() => {
+    const loadBranches = async () => {
+      const result = await getNearbyBranches({ radius: 5000 });
+      if (result.success) {
+        setBranches(result.data);
+      }
+    };
+    loadBranches();
+  }, []);
 
   const handleCheckIn = async (branchId: string) => {
-    await checkIn({
+    const result = await checkInEntry({
       branchId,
-      entranceType: 0, // 0 = ENTRY, 1 = EXIT
+      userId: user.id,
     });
+
+    if (result.success) {
+      console.log('Checked in successfully');
+    }
   };
 
   return (
     <View>
-      {nearbyBranches.map((branch) => (
+      {branches.map((branch) => (
         <TouchableOpacity key={branch.id} onPress={() => handleCheckIn(branch.id)}>
           <Text>{branch.title}</Text>
         </TouchableOpacity>
@@ -119,18 +179,41 @@ function CheckInScreen() {
 }
 ```
 
-### Remote Work Hook
+### Remote Work
 
 ```typescript
-import { useRemoteWork } from '@passgage-sdk/react-native';
+import { usePassgageRemoteWork, usePassgageAuth } from '@passgage/sdk-react-native';
 
 function RemoteWorkScreen() {
-  const { logEntry, logExit, isLoading } = useRemoteWork();
+  const { user } = usePassgageAuth();
+  const { logEntry, logExit, isLoading } = usePassgageRemoteWork();
+
+  const handleStartWork = async () => {
+    const result = await logEntry({
+      userId: user.id,
+      description: 'Working from home',
+    });
+
+    if (result.success) {
+      console.log('Work entry logged');
+    }
+  };
+
+  const handleEndWork = async () => {
+    const result = await logExit({
+      userId: user.id,
+      description: 'Finished work',
+    });
+
+    if (result.success) {
+      console.log('Work exit logged');
+    }
+  };
 
   return (
     <View>
-      <Button title="Log Entry" onPress={() => logEntry()} />
-      <Button title="Log Exit" onPress={() => logExit()} />
+      <Button title="Start Work" onPress={handleStartWork} disabled={isLoading} />
+      <Button title="End Work" onPress={handleEndWork} disabled={isLoading} />
     </View>
   );
 }
@@ -140,17 +223,66 @@ function RemoteWorkScreen() {
 
 ### Hooks
 
-- `useQRScanner()` - QR code scanning with validation
-- `useNFCScanner()` - NFC card scanning with validation
-- `useCheckIn()` - GPS-based check-in
-- `useRemoteWork()` - Remote work logging
-- `useLocation()` - Location tracking
-- `usePassgageAccess()` - Access SDK context
+All hooks use the `usePassgage*` prefix to avoid naming conflicts:
+
+- `usePassgageAuth()` - Authentication and user management
+- `usePassgageQRScanner()` - QR code scanning with validation
+- `usePassgageNFCScanner()` - NFC card scanning with validation
+- `usePassgageCheckIn()` - GPS-based check-in with nearby branches
+- `usePassgageRemoteWork()` - Remote work entry/exit logging
+- `useLocation()` - Location tracking and permissions
+- `usePassgageAccess()` - Access SDK context and services
 
 ### Components
 
 - `<PassgageAccessProvider>` - SDK configuration provider
 
+### Services
+
+Low-level services are also available through `usePassgageAccess()`:
+
+- `authService` - Authentication operations
+- `qrAccessService` - QR code validation
+- `nfcAccessService` - NFC card validation
+- `checkInService` - Check-in operations
+- `remoteWorkService` - Remote work logging
+- `locationService` - Location management
+- `deviceAccessService` - Device operations
+
+## Security Features
+
+- **JWT Authentication**: Secure token-based authentication
+- **Automatic Token Refresh**: Tokens are automatically refreshed when expired
+- **Secure Storage**: Tokens stored securely using platform-specific secure storage
+- **TLS 1.2+**: All network communications encrypted
+- **Location Verification**: Automatic location validation with range checking
+- **Anti-Passback**: Support for anti-passback rules
+
+## Token Flow
+
+The SDK automatically handles authentication tokens:
+
+1. User logs in → JWT tokens stored securely
+2. API client automatically adds `Authorization: Bearer {token}` to all requests
+3. Tokens are automatically refreshed when they expire
+4. On logout, all tokens are cleared
+
+**You don't need to manually manage tokens!** Just use the hooks and the SDK handles everything.
+
+## Example Application
+
+A complete example React Native app demonstrating all SDK features:
+
+👉 [Passgage SDK Example App](https://github.com/passgage/passgage-sdk-example-react-native)
+
+## TypeScript Support
+
+The SDK is written in TypeScript and includes full type definitions for all APIs, hooks, and models.
+
 ## License
 
 Proprietary - Passgage © 2025
+
+## Support
+
+For support, contact devops@passgage.com

package/dist/index.d.mts

@@ -1133,82 +1133,112 @@ interface UsePassgageAuthReturn {
 declare function usePassgageAuth(options?: UsePassgageAuthOptions): UsePassgageAuthReturn;
 
 /**
- * useQRScanner hook
+ * usePassgageQRScanner hook
  * QR code scanning with validation
  */
 
-interface UseQRScannerOptions {
+interface UsePassgageQRScannerOptions {
     onSuccess?: (entrance?: Entrance) => void;
     onError?: (error: Error) => void;
     skipLocationCheck?: boolean;
     skipRepetitiveCheck?: boolean;
 }
-interface UseQRScannerReturn {
+interface UsePassgageQRScannerReturn {
     scan: (qrCode: string, device?: QrDevice) => Promise<void>;
     isLoading: boolean;
     error: Error | null;
 }
-declare function useQRScanner(options?: UseQRScannerOptions): UseQRScannerReturn;
+declare function usePassgageQRScanner(options?: UsePassgageQRScannerOptions): UsePassgageQRScannerReturn;
 
 /**
- * useNFCScanner hook
+ * usePassgageNFCScanner hook
  * NFC card scanning with validation
  */
 
-interface UseNFCScannerOptions {
+interface UsePassgageNFCScannerOptions {
     onSuccess?: (entrance?: Entrance) => void;
     onError?: (error: Error) => void;
     skipLocationCheck?: boolean;
     skipRepetitiveCheck?: boolean;
     autoStart?: boolean;
 }
-interface UseNFCScannerReturn {
+interface UsePassgageNFCScannerReturn {
     startScanning: () => Promise<void>;
     stopScanning: () => Promise<void>;
     isScanning: boolean;
     error: Error | null;
 }
-declare function useNFCScanner(options?: UseNFCScannerOptions): UseNFCScannerReturn;
+declare function usePassgageNFCScanner(options?: UsePassgageNFCScannerOptions): UsePassgageNFCScannerReturn;
 
 /**
- * useCheckIn hook
+ * usePassgageCheckIn hook
  * GPS-based check-in to nearby branches
  */
 
-interface UseCheckInOptions {
+interface UsePassgageCheckInOptions {
     radius?: number;
-    autoFetch?: boolean;
 }
-interface CheckInParams {
+interface CheckInEntryParams {
     branchId: string;
-    entranceType: EntranceType;
+    userId: string;
+}
+interface CheckInExitParams {
+    branchId: string;
+    userId: string;
 }
-interface UseCheckInReturn {
-    nearbyBranches: Branch[];
-    fetchNearbyBranches: () => Promise<void>;
-    checkIn: (params: CheckInParams) => Promise<Entrance | undefined>;
+interface GetNearbyBranchesParams {
+    radius?: number;
+}
+interface UsePassgageCheckInReturn {
+    getNearbyBranches: (params?: GetNearbyBranchesParams) => Promise<{
+        success: boolean;
+        data?: Branch[];
+        error?: string;
+    }>;
+    checkInEntry: (params: CheckInEntryParams) => Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    checkInExit: (params: CheckInExitParams) => Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
     isLoading: boolean;
     error: Error | null;
 }
-declare function useCheckIn(options?: UseCheckInOptions): UseCheckInReturn;
+declare function usePassgageCheckIn(options?: UsePassgageCheckInOptions): UsePassgageCheckInReturn;
 
 /**
- * useRemoteWork hook
+ * usePassgageRemoteWork hook
  * Remote work entry/exit logging
  */
-
-interface RemoteWorkOptions {
+interface RemoteWorkEntryParams {
+    userId: string;
+    description?: string;
     timestamp?: Date | string;
+}
+interface RemoteWorkExitParams {
+    userId: string;
     description?: string;
+    timestamp?: Date | string;
 }
-interface UseRemoteWorkReturn {
-    logEntry: (options?: RemoteWorkOptions) => Promise<Entrance | undefined>;
-    logExit: (options?: RemoteWorkOptions) => Promise<Entrance | undefined>;
-    logRemoteWork: (entranceType: EntranceType, options?: RemoteWorkOptions) => Promise<Entrance | undefined>;
+interface UsePassgageRemoteWorkReturn {
+    logEntry: (params: RemoteWorkEntryParams) => Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    logExit: (params: RemoteWorkExitParams) => Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
     isLoading: boolean;
     error: Error | null;
 }
-declare function useRemoteWork(): UseRemoteWorkReturn;
+declare function usePassgageRemoteWork(): UsePassgageRemoteWorkReturn;
 
 /**
  * useLocation hook
@@ -1234,6 +1264,6 @@ declare function useLocation(options?: UseLocationOptions): UseLocationReturn;
  * Complete SDK with core functionality and React Native integration
  */
 
-declare const SDK_VERSION = "1.0.2";
+declare const SDK_VERSION = "1.0.4";
 
-export { type APIError, ApiClient, type ApiClientConfig, AuthService, type AuthState, type AuthTokens, type BaseResponse, type Branch, type CheckInOptions, type CheckInParams, type CheckInResult, CheckInService, type CompanyInfo, type Coordinates, type CreateEntranceFromQRRequest, type CreateEntranceRequest, type Device, type DeviceAccessRequest, DeviceAccessService, DeviceDirection, DeviceUsage, endpoints as Endpoints, type Entrance, type EntranceQueryParams, EntranceType, LocationService, type LocationVerificationLog, type LoginCredentials, type LoginRequest, type LoginResponse, type LoginResult, NFCAccessService, type NFCValidationOptions, type NFCValidationResult, type NearbyBranchesRequest, type PaginationMeta, type PassgageAccessConfig, type PassgageAccessContextValue, PassgageAccessProvider, type PassgageAccessProviderProps, QRAccessService, type QRValidationOptions, type QRValidationResult, type QrAccessResponse, type QrDevice, type RefreshTokenRequest, type RefreshTokenResponse, type RefreshTokenResult, type RemoteWorkEntryOptions, type RemoteWorkOptions, type RemoteWorkResult, RemoteWorkService, type RequestOptions, SDK_VERSION, type TokenInfo, type TokenStorage, type UseCheckInOptions, type UseCheckInReturn, type UseLocationOptions, type UseLocationReturn, type UseNFCScannerOptions, type UseNFCScannerReturn, type UsePassgageAuthOptions, type UsePassgageAuthReturn, type UseQRScannerOptions, type UseQRScannerReturn, type UseRemoteWorkReturn, type User, calculateDistance, checkOnLocation, checkRepetitiveRead, clearReadRecords, createApiClient, formatDate, formatDateTime, formatISO, formatTime, parseISO, useCheckIn, useLocation, useNFCScanner, usePassgageAccess, usePassgageAuth, useQRScanner, useRemoteWork, validateCoordinates, validateDeviceId, validateNFCCode, validateQRCode };
+export { type APIError, ApiClient, type ApiClientConfig, AuthService, type AuthState, type AuthTokens, type BaseResponse, type Branch, type CheckInEntryParams, type CheckInExitParams, type CheckInOptions, type CheckInResult, CheckInService, type CompanyInfo, type Coordinates, type CreateEntranceFromQRRequest, type CreateEntranceRequest, type Device, type DeviceAccessRequest, DeviceAccessService, DeviceDirection, DeviceUsage, endpoints as Endpoints, type Entrance, type EntranceQueryParams, EntranceType, type GetNearbyBranchesParams, LocationService, type LocationVerificationLog, type LoginCredentials, type LoginRequest, type LoginResponse, type LoginResult, NFCAccessService, type NFCValidationOptions, type NFCValidationResult, type NearbyBranchesRequest, type PaginationMeta, type PassgageAccessConfig, type PassgageAccessContextValue, PassgageAccessProvider, type PassgageAccessProviderProps, QRAccessService, type QRValidationOptions, type QRValidationResult, type QrAccessResponse, type QrDevice, type RefreshTokenRequest, type RefreshTokenResponse, type RefreshTokenResult, type RemoteWorkEntryOptions, type RemoteWorkEntryParams, type RemoteWorkExitParams, type RemoteWorkResult, RemoteWorkService, type RequestOptions, SDK_VERSION, type TokenInfo, type TokenStorage, type UseLocationOptions, type UseLocationReturn, type UsePassgageAuthOptions, type UsePassgageAuthReturn, type UsePassgageCheckInOptions, type UsePassgageCheckInReturn, type UsePassgageNFCScannerOptions, type UsePassgageNFCScannerReturn, type UsePassgageQRScannerOptions, type UsePassgageQRScannerReturn, type UsePassgageRemoteWorkReturn, type User, calculateDistance, checkOnLocation, checkRepetitiveRead, clearReadRecords, createApiClient, formatDate, formatDateTime, formatISO, formatTime, parseISO, useLocation, usePassgageAccess, usePassgageAuth, usePassgageCheckIn, usePassgageNFCScanner, usePassgageQRScanner, usePassgageRemoteWork, validateCoordinates, validateDeviceId, validateNFCCode, validateQRCode };

package/dist/index.d.ts

@@ -1133,82 +1133,112 @@ interface UsePassgageAuthReturn {
 declare function usePassgageAuth(options?: UsePassgageAuthOptions): UsePassgageAuthReturn;
 
 /**
- * useQRScanner hook
+ * usePassgageQRScanner hook
  * QR code scanning with validation
  */
 
-interface UseQRScannerOptions {
+interface UsePassgageQRScannerOptions {
     onSuccess?: (entrance?: Entrance) => void;
     onError?: (error: Error) => void;
     skipLocationCheck?: boolean;
     skipRepetitiveCheck?: boolean;
 }
-interface UseQRScannerReturn {
+interface UsePassgageQRScannerReturn {
     scan: (qrCode: string, device?: QrDevice) => Promise<void>;
     isLoading: boolean;
     error: Error | null;
 }
-declare function useQRScanner(options?: UseQRScannerOptions): UseQRScannerReturn;
+declare function usePassgageQRScanner(options?: UsePassgageQRScannerOptions): UsePassgageQRScannerReturn;
 
 /**
- * useNFCScanner hook
+ * usePassgageNFCScanner hook
  * NFC card scanning with validation
  */
 
-interface UseNFCScannerOptions {
+interface UsePassgageNFCScannerOptions {
     onSuccess?: (entrance?: Entrance) => void;
     onError?: (error: Error) => void;
     skipLocationCheck?: boolean;
     skipRepetitiveCheck?: boolean;
     autoStart?: boolean;
 }
-interface UseNFCScannerReturn {
+interface UsePassgageNFCScannerReturn {
     startScanning: () => Promise<void>;
     stopScanning: () => Promise<void>;
     isScanning: boolean;
     error: Error | null;
 }
-declare function useNFCScanner(options?: UseNFCScannerOptions): UseNFCScannerReturn;
+declare function usePassgageNFCScanner(options?: UsePassgageNFCScannerOptions): UsePassgageNFCScannerReturn;
 
 /**
- * useCheckIn hook
+ * usePassgageCheckIn hook
  * GPS-based check-in to nearby branches
  */
 
-interface UseCheckInOptions {
+interface UsePassgageCheckInOptions {
     radius?: number;
-    autoFetch?: boolean;
 }
-interface CheckInParams {
+interface CheckInEntryParams {
     branchId: string;
-    entranceType: EntranceType;
+    userId: string;
+}
+interface CheckInExitParams {
+    branchId: string;
+    userId: string;
 }
-interface UseCheckInReturn {
-    nearbyBranches: Branch[];
-    fetchNearbyBranches: () => Promise<void>;
-    checkIn: (params: CheckInParams) => Promise<Entrance | undefined>;
+interface GetNearbyBranchesParams {
+    radius?: number;
+}
+interface UsePassgageCheckInReturn {
+    getNearbyBranches: (params?: GetNearbyBranchesParams) => Promise<{
+        success: boolean;
+        data?: Branch[];
+        error?: string;
+    }>;
+    checkInEntry: (params: CheckInEntryParams) => Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    checkInExit: (params: CheckInExitParams) => Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
     isLoading: boolean;
     error: Error | null;
 }
-declare function useCheckIn(options?: UseCheckInOptions): UseCheckInReturn;
+declare function usePassgageCheckIn(options?: UsePassgageCheckInOptions): UsePassgageCheckInReturn;
 
 /**
- * useRemoteWork hook
+ * usePassgageRemoteWork hook
  * Remote work entry/exit logging
  */
-
-interface RemoteWorkOptions {
+interface RemoteWorkEntryParams {
+    userId: string;
+    description?: string;
     timestamp?: Date | string;
+}
+interface RemoteWorkExitParams {
+    userId: string;
     description?: string;
+    timestamp?: Date | string;
 }
-interface UseRemoteWorkReturn {
-    logEntry: (options?: RemoteWorkOptions) => Promise<Entrance | undefined>;
-    logExit: (options?: RemoteWorkOptions) => Promise<Entrance | undefined>;
-    logRemoteWork: (entranceType: EntranceType, options?: RemoteWorkOptions) => Promise<Entrance | undefined>;
+interface UsePassgageRemoteWorkReturn {
+    logEntry: (params: RemoteWorkEntryParams) => Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    logExit: (params: RemoteWorkExitParams) => Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
     isLoading: boolean;
     error: Error | null;
 }
-declare function useRemoteWork(): UseRemoteWorkReturn;
+declare function usePassgageRemoteWork(): UsePassgageRemoteWorkReturn;
 
 /**
  * useLocation hook
@@ -1234,6 +1264,6 @@ declare function useLocation(options?: UseLocationOptions): UseLocationReturn;
  * Complete SDK with core functionality and React Native integration
  */
 
-declare const SDK_VERSION = "1.0.2";
+declare const SDK_VERSION = "1.0.4";
 
-export { type APIError, ApiClient, type ApiClientConfig, AuthService, type AuthState, type AuthTokens, type BaseResponse, type Branch, type CheckInOptions, type CheckInParams, type CheckInResult, CheckInService, type CompanyInfo, type Coordinates, type CreateEntranceFromQRRequest, type CreateEntranceRequest, type Device, type DeviceAccessRequest, DeviceAccessService, DeviceDirection, DeviceUsage, endpoints as Endpoints, type Entrance, type EntranceQueryParams, EntranceType, LocationService, type LocationVerificationLog, type LoginCredentials, type LoginRequest, type LoginResponse, type LoginResult, NFCAccessService, type NFCValidationOptions, type NFCValidationResult, type NearbyBranchesRequest, type PaginationMeta, type PassgageAccessConfig, type PassgageAccessContextValue, PassgageAccessProvider, type PassgageAccessProviderProps, QRAccessService, type QRValidationOptions, type QRValidationResult, type QrAccessResponse, type QrDevice, type RefreshTokenRequest, type RefreshTokenResponse, type RefreshTokenResult, type RemoteWorkEntryOptions, type RemoteWorkOptions, type RemoteWorkResult, RemoteWorkService, type RequestOptions, SDK_VERSION, type TokenInfo, type TokenStorage, type UseCheckInOptions, type UseCheckInReturn, type UseLocationOptions, type UseLocationReturn, type UseNFCScannerOptions, type UseNFCScannerReturn, type UsePassgageAuthOptions, type UsePassgageAuthReturn, type UseQRScannerOptions, type UseQRScannerReturn, type UseRemoteWorkReturn, type User, calculateDistance, checkOnLocation, checkRepetitiveRead, clearReadRecords, createApiClient, formatDate, formatDateTime, formatISO, formatTime, parseISO, useCheckIn, useLocation, useNFCScanner, usePassgageAccess, usePassgageAuth, useQRScanner, useRemoteWork, validateCoordinates, validateDeviceId, validateNFCCode, validateQRCode };
+export { type APIError, ApiClient, type ApiClientConfig, AuthService, type AuthState, type AuthTokens, type BaseResponse, type Branch, type CheckInEntryParams, type CheckInExitParams, type CheckInOptions, type CheckInResult, CheckInService, type CompanyInfo, type Coordinates, type CreateEntranceFromQRRequest, type CreateEntranceRequest, type Device, type DeviceAccessRequest, DeviceAccessService, DeviceDirection, DeviceUsage, endpoints as Endpoints, type Entrance, type EntranceQueryParams, EntranceType, type GetNearbyBranchesParams, LocationService, type LocationVerificationLog, type LoginCredentials, type LoginRequest, type LoginResponse, type LoginResult, NFCAccessService, type NFCValidationOptions, type NFCValidationResult, type NearbyBranchesRequest, type PaginationMeta, type PassgageAccessConfig, type PassgageAccessContextValue, PassgageAccessProvider, type PassgageAccessProviderProps, QRAccessService, type QRValidationOptions, type QRValidationResult, type QrAccessResponse, type QrDevice, type RefreshTokenRequest, type RefreshTokenResponse, type RefreshTokenResult, type RemoteWorkEntryOptions, type RemoteWorkEntryParams, type RemoteWorkExitParams, type RemoteWorkResult, RemoteWorkService, type RequestOptions, SDK_VERSION, type TokenInfo, type TokenStorage, type UseLocationOptions, type UseLocationReturn, type UsePassgageAuthOptions, type UsePassgageAuthReturn, type UsePassgageCheckInOptions, type UsePassgageCheckInReturn, type UsePassgageNFCScannerOptions, type UsePassgageNFCScannerReturn, type UsePassgageQRScannerOptions, type UsePassgageQRScannerReturn, type UsePassgageRemoteWorkReturn, type User, calculateDistance, checkOnLocation, checkRepetitiveRead, clearReadRecords, createApiClient, formatDate, formatDateTime, formatISO, formatTime, parseISO, useLocation, usePassgageAccess, usePassgageAuth, usePassgageCheckIn, usePassgageNFCScanner, usePassgageQRScanner, usePassgageRemoteWork, validateCoordinates, validateDeviceId, validateNFCCode, validateQRCode };

package/dist/index.js

@@ -54,13 +54,13 @@ __export(index_exports, {
   formatISO: () => formatISO,
   formatTime: () => formatTime,
   parseISO: () => parseISO,
-  useCheckIn: () => useCheckIn,
   useLocation: () => useLocation,
-  useNFCScanner: () => useNFCScanner,
   usePassgageAccess: () => usePassgageAccess,
   usePassgageAuth: () => usePassgageAuth,
-  useQRScanner: () => useQRScanner,
-  useRemoteWork: () => useRemoteWork,
+  usePassgageCheckIn: () => usePassgageCheckIn,
+  usePassgageNFCScanner: () => usePassgageNFCScanner,
+  usePassgageQRScanner: () => usePassgageQRScanner,
+  usePassgageRemoteWork: () => usePassgageRemoteWork,
   validateCoordinates: () => validateCoordinates,
   validateDeviceId: () => validateDeviceId,
   validateNFCCode: () => validateNFCCode,
@@ -1554,7 +1554,7 @@ function usePassgageAuth(options = {}) {
   };
 }
 
-// src/hooks/useQRScanner.ts
+// src/hooks/usePassgageQRScanner.ts
 var import_react4 = require("react");
 
 // src/hooks/useLocation.ts
@@ -1630,8 +1630,8 @@ function useLocation(options = {}) {
   };
 }
 
-// src/hooks/useQRScanner.ts
-function useQRScanner(options = {}) {
+// src/hooks/usePassgageQRScanner.ts
+function usePassgageQRScanner(options = {}) {
   const { qrAccessService, deviceAccessService } = usePassgageAccess();
   const { location } = useLocation();
   const [isLoading, setIsLoading] = (0, import_react4.useState)(false);
@@ -1676,14 +1676,14 @@ function useQRScanner(options = {}) {
   };
 }
 
-// src/hooks/useNFCScanner.ts
+// src/hooks/usePassgageNFCScanner.ts
 var import_react5 = require("react");
 var import_react_native_nfc_manager = __toESM(require("react-native-nfc-manager"));
 function reversedHexToDec(hexString) {
   const hex = hexString.replace(/:/g, "");
   return parseInt(hex, 16).toString();
 }
-function useNFCScanner(options = {}) {
+function usePassgageNFCScanner(options = {}) {
   const { nfcAccessService, deviceAccessService } = usePassgageAccess();
   const { location } = useLocation();
   const [isScanning, setIsScanning] = (0, import_react5.useState)(false);
@@ -1759,128 +1759,213 @@ function useNFCScanner(options = {}) {
   };
 }
 
-// src/hooks/useCheckIn.ts
+// src/hooks/usePassgageCheckIn.ts
 var import_react6 = require("react");
-function useCheckIn(options = {}) {
-  const { checkInService, config: _config } = usePassgageAccess();
+function usePassgageCheckIn(options = {}) {
+  const { checkInService } = usePassgageAccess();
   const { location } = useLocation();
-  const [nearbyBranches, setNearbyBranches] = (0, import_react6.useState)([]);
   const [isLoading, setIsLoading] = (0, import_react6.useState)(false);
   const [error, setError] = (0, import_react6.useState)(null);
-  const fetchNearbyBranches = (0, import_react6.useCallback)(async () => {
-    if (!location) {
-      return;
-    }
-    setIsLoading(true);
-    setError(null);
-    try {
-      const response = await checkInService.getNearbyBranches({
-        latitude: location.latitude,
-        longitude: location.longitude,
-        radius: options.radius
-      });
-      if (response.success && response.data) {
-        setNearbyBranches(response.data);
+  const getNearbyBranches = (0, import_react6.useCallback)(
+    async (params) => {
+      if (!location) {
+        return {
+          success: false,
+          error: "Location not available"
+        };
       }
-    } catch (err) {
-      setError(err);
-    } finally {
-      setIsLoading(false);
-    }
-  }, [checkInService, location, options.radius]);
-  const checkIn = (0, import_react6.useCallback)(
+      setIsLoading(true);
+      setError(null);
+      try {
+        const response = await checkInService.getNearbyBranches({
+          latitude: location.latitude,
+          longitude: location.longitude,
+          radius: params?.radius || options.radius
+        });
+        if (response.success && response.data) {
+          return {
+            success: true,
+            data: response.data
+          };
+        }
+        return {
+          success: false,
+          error: response.message || "Failed to fetch nearby branches"
+        };
+      } catch (err) {
+        const error2 = err;
+        setError(error2);
+        return {
+          success: false,
+          error: error2.message || "Failed to fetch nearby branches"
+        };
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [checkInService, location, options.radius]
+  );
+  const checkInEntry = (0, import_react6.useCallback)(
     async (params) => {
       setIsLoading(true);
       setError(null);
       try {
-        const userId = "";
         const result = await checkInService.checkIn({
-          ...params,
-          userId,
+          branchId: params.branchId,
+          userId: params.userId,
+          entranceType: 0 /* ENTRY */,
           userLocation: location || void 0
         });
-        if (!result.success) {
-          throw new Error(result.message);
+        if (result.success) {
+          return {
+            success: true,
+            data: result.entrance
+          };
         }
-        return result.entrance;
+        return {
+          success: false,
+          error: result.message || "Check-in failed"
+        };
       } catch (err) {
-        setError(err);
-        throw err;
+        const error2 = err;
+        setError(error2);
+        return {
+          success: false,
+          error: error2.message || "Check-in failed"
+        };
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [checkInService, location]
+  );
+  const checkInExit = (0, import_react6.useCallback)(
+    async (params) => {
+      setIsLoading(true);
+      setError(null);
+      try {
+        const result = await checkInService.checkIn({
+          branchId: params.branchId,
+          userId: params.userId,
+          entranceType: 1 /* EXIT */,
+          userLocation: location || void 0
+        });
+        if (result.success) {
+          return {
+            success: true,
+            data: result.entrance
+          };
+        }
+        return {
+          success: false,
+          error: result.message || "Check-out failed"
+        };
+      } catch (err) {
+        const error2 = err;
+        setError(error2);
+        return {
+          success: false,
+          error: error2.message || "Check-out failed"
+        };
       } finally {
         setIsLoading(false);
       }
     },
     [checkInService, location]
   );
-  (0, import_react6.useEffect)(() => {
-    if (options.autoFetch && location) {
-      fetchNearbyBranches();
-    }
-  }, [options.autoFetch, location, fetchNearbyBranches]);
   return {
-    nearbyBranches,
-    fetchNearbyBranches,
-    checkIn,
+    getNearbyBranches,
+    checkInEntry,
+    checkInExit,
     isLoading,
     error
   };
 }
 
-// src/hooks/useRemoteWork.ts
+// src/hooks/usePassgageRemoteWork.ts
 var import_react7 = require("react");
-function useRemoteWork() {
+function usePassgageRemoteWork() {
   const { remoteWorkService } = usePassgageAccess();
   const [isLoading, setIsLoading] = (0, import_react7.useState)(false);
   const [error, setError] = (0, import_react7.useState)(null);
-  const logRemoteWork = (0, import_react7.useCallback)(
-    async (entranceType, options = {}) => {
+  const logEntry = (0, import_react7.useCallback)(
+    async (params) => {
       setIsLoading(true);
       setError(null);
       try {
-        const userId = "";
         const result = await remoteWorkService.logRemoteWork({
-          userId,
-          entranceType,
-          timestamp: options.timestamp,
-          description: options.description
+          userId: params.userId,
+          entranceType: 0 /* ENTRY */,
+          timestamp: params.timestamp,
+          description: params.description
         });
-        if (!result.success) {
-          throw new Error(result.message);
+        if (result.success) {
+          return {
+            success: true,
+            data: result.entrance
+          };
         }
-        return result.entrance;
+        return {
+          success: false,
+          error: result.message || "Failed to log entry"
+        };
       } catch (err) {
         const error2 = err;
         setError(error2);
-        throw error2;
+        return {
+          success: false,
+          error: error2.message || "Failed to log entry"
+        };
       } finally {
         setIsLoading(false);
       }
     },
     [remoteWorkService]
   );
-  const logEntry = (0, import_react7.useCallback)(
-    async (options) => {
-      return logRemoteWork(0 /* ENTRY */, options);
-    },
-    [logRemoteWork]
-  );
   const logExit = (0, import_react7.useCallback)(
-    async (options) => {
-      return logRemoteWork(1 /* EXIT */, options);
+    async (params) => {
+      setIsLoading(true);
+      setError(null);
+      try {
+        const result = await remoteWorkService.logRemoteWork({
+          userId: params.userId,
+          entranceType: 1 /* EXIT */,
+          timestamp: params.timestamp,
+          description: params.description
+        });
+        if (result.success) {
+          return {
+            success: true,
+            data: result.entrance
+          };
+        }
+        return {
+          success: false,
+          error: result.message || "Failed to log exit"
+        };
+      } catch (err) {
+        const error2 = err;
+        setError(error2);
+        return {
+          success: false,
+          error: error2.message || "Failed to log exit"
+        };
+      } finally {
+        setIsLoading(false);
+      }
     },
-    [logRemoteWork]
+    [remoteWorkService]
   );
   return {
     logEntry,
     logExit,
-    logRemoteWork,
     isLoading,
     error
   };
 }
 
 // src/index.ts
-var SDK_VERSION = "1.0.2";
+var SDK_VERSION = "1.0.4";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ApiClient,
@@ -1907,13 +1992,13 @@ var SDK_VERSION = "1.0.2";
   formatISO,
   formatTime,
   parseISO,
-  useCheckIn,
   useLocation,
-  useNFCScanner,
   usePassgageAccess,
   usePassgageAuth,
-  useQRScanner,
-  useRemoteWork,
+  usePassgageCheckIn,
+  usePassgageNFCScanner,
+  usePassgageQRScanner,
+  usePassgageRemoteWork,
   validateCoordinates,
   validateDeviceId,
   validateNFCCode,

package/dist/index.mjs

@@ -1490,7 +1490,7 @@ function usePassgageAuth(options = {}) {
   };
 }
 
-// src/hooks/useQRScanner.ts
+// src/hooks/usePassgageQRScanner.ts
 import { useState as useState3, useCallback as useCallback3 } from "react";
 
 // src/hooks/useLocation.ts
@@ -1566,8 +1566,8 @@ function useLocation(options = {}) {
   };
 }
 
-// src/hooks/useQRScanner.ts
-function useQRScanner(options = {}) {
+// src/hooks/usePassgageQRScanner.ts
+function usePassgageQRScanner(options = {}) {
   const { qrAccessService, deviceAccessService } = usePassgageAccess();
   const { location } = useLocation();
   const [isLoading, setIsLoading] = useState3(false);
@@ -1612,14 +1612,14 @@ function useQRScanner(options = {}) {
   };
 }
 
-// src/hooks/useNFCScanner.ts
+// src/hooks/usePassgageNFCScanner.ts
 import { useState as useState4, useCallback as useCallback4, useEffect as useEffect3 } from "react";
 import NfcManager, { NfcTech } from "react-native-nfc-manager";
 function reversedHexToDec(hexString) {
   const hex = hexString.replace(/:/g, "");
   return parseInt(hex, 16).toString();
 }
-function useNFCScanner(options = {}) {
+function usePassgageNFCScanner(options = {}) {
   const { nfcAccessService, deviceAccessService } = usePassgageAccess();
   const { location } = useLocation();
   const [isScanning, setIsScanning] = useState4(false);
@@ -1695,128 +1695,213 @@ function useNFCScanner(options = {}) {
   };
 }
 
-// src/hooks/useCheckIn.ts
-import { useState as useState5, useEffect as useEffect4, useCallback as useCallback5 } from "react";
-function useCheckIn(options = {}) {
-  const { checkInService, config: _config } = usePassgageAccess();
+// src/hooks/usePassgageCheckIn.ts
+import { useState as useState5, useCallback as useCallback5 } from "react";
+function usePassgageCheckIn(options = {}) {
+  const { checkInService } = usePassgageAccess();
   const { location } = useLocation();
-  const [nearbyBranches, setNearbyBranches] = useState5([]);
   const [isLoading, setIsLoading] = useState5(false);
   const [error, setError] = useState5(null);
-  const fetchNearbyBranches = useCallback5(async () => {
-    if (!location) {
-      return;
-    }
-    setIsLoading(true);
-    setError(null);
-    try {
-      const response = await checkInService.getNearbyBranches({
-        latitude: location.latitude,
-        longitude: location.longitude,
-        radius: options.radius
-      });
-      if (response.success && response.data) {
-        setNearbyBranches(response.data);
+  const getNearbyBranches = useCallback5(
+    async (params) => {
+      if (!location) {
+        return {
+          success: false,
+          error: "Location not available"
+        };
       }
-    } catch (err) {
-      setError(err);
-    } finally {
-      setIsLoading(false);
-    }
-  }, [checkInService, location, options.radius]);
-  const checkIn = useCallback5(
+      setIsLoading(true);
+      setError(null);
+      try {
+        const response = await checkInService.getNearbyBranches({
+          latitude: location.latitude,
+          longitude: location.longitude,
+          radius: params?.radius || options.radius
+        });
+        if (response.success && response.data) {
+          return {
+            success: true,
+            data: response.data
+          };
+        }
+        return {
+          success: false,
+          error: response.message || "Failed to fetch nearby branches"
+        };
+      } catch (err) {
+        const error2 = err;
+        setError(error2);
+        return {
+          success: false,
+          error: error2.message || "Failed to fetch nearby branches"
+        };
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [checkInService, location, options.radius]
+  );
+  const checkInEntry = useCallback5(
     async (params) => {
       setIsLoading(true);
       setError(null);
       try {
-        const userId = "";
         const result = await checkInService.checkIn({
-          ...params,
-          userId,
+          branchId: params.branchId,
+          userId: params.userId,
+          entranceType: 0 /* ENTRY */,
           userLocation: location || void 0
         });
-        if (!result.success) {
-          throw new Error(result.message);
+        if (result.success) {
+          return {
+            success: true,
+            data: result.entrance
+          };
         }
-        return result.entrance;
+        return {
+          success: false,
+          error: result.message || "Check-in failed"
+        };
       } catch (err) {
-        setError(err);
-        throw err;
+        const error2 = err;
+        setError(error2);
+        return {
+          success: false,
+          error: error2.message || "Check-in failed"
+        };
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [checkInService, location]
+  );
+  const checkInExit = useCallback5(
+    async (params) => {
+      setIsLoading(true);
+      setError(null);
+      try {
+        const result = await checkInService.checkIn({
+          branchId: params.branchId,
+          userId: params.userId,
+          entranceType: 1 /* EXIT */,
+          userLocation: location || void 0
+        });
+        if (result.success) {
+          return {
+            success: true,
+            data: result.entrance
+          };
+        }
+        return {
+          success: false,
+          error: result.message || "Check-out failed"
+        };
+      } catch (err) {
+        const error2 = err;
+        setError(error2);
+        return {
+          success: false,
+          error: error2.message || "Check-out failed"
+        };
       } finally {
         setIsLoading(false);
       }
     },
     [checkInService, location]
   );
-  useEffect4(() => {
-    if (options.autoFetch && location) {
-      fetchNearbyBranches();
-    }
-  }, [options.autoFetch, location, fetchNearbyBranches]);
   return {
-    nearbyBranches,
-    fetchNearbyBranches,
-    checkIn,
+    getNearbyBranches,
+    checkInEntry,
+    checkInExit,
     isLoading,
     error
   };
 }
 
-// src/hooks/useRemoteWork.ts
+// src/hooks/usePassgageRemoteWork.ts
 import { useState as useState6, useCallback as useCallback6 } from "react";
-function useRemoteWork() {
+function usePassgageRemoteWork() {
   const { remoteWorkService } = usePassgageAccess();
   const [isLoading, setIsLoading] = useState6(false);
   const [error, setError] = useState6(null);
-  const logRemoteWork = useCallback6(
-    async (entranceType, options = {}) => {
+  const logEntry = useCallback6(
+    async (params) => {
       setIsLoading(true);
       setError(null);
       try {
-        const userId = "";
         const result = await remoteWorkService.logRemoteWork({
-          userId,
-          entranceType,
-          timestamp: options.timestamp,
-          description: options.description
+          userId: params.userId,
+          entranceType: 0 /* ENTRY */,
+          timestamp: params.timestamp,
+          description: params.description
         });
-        if (!result.success) {
-          throw new Error(result.message);
+        if (result.success) {
+          return {
+            success: true,
+            data: result.entrance
+          };
         }
-        return result.entrance;
+        return {
+          success: false,
+          error: result.message || "Failed to log entry"
+        };
       } catch (err) {
         const error2 = err;
         setError(error2);
-        throw error2;
+        return {
+          success: false,
+          error: error2.message || "Failed to log entry"
+        };
       } finally {
         setIsLoading(false);
       }
     },
     [remoteWorkService]
   );
-  const logEntry = useCallback6(
-    async (options) => {
-      return logRemoteWork(0 /* ENTRY */, options);
-    },
-    [logRemoteWork]
-  );
   const logExit = useCallback6(
-    async (options) => {
-      return logRemoteWork(1 /* EXIT */, options);
+    async (params) => {
+      setIsLoading(true);
+      setError(null);
+      try {
+        const result = await remoteWorkService.logRemoteWork({
+          userId: params.userId,
+          entranceType: 1 /* EXIT */,
+          timestamp: params.timestamp,
+          description: params.description
+        });
+        if (result.success) {
+          return {
+            success: true,
+            data: result.entrance
+          };
+        }
+        return {
+          success: false,
+          error: result.message || "Failed to log exit"
+        };
+      } catch (err) {
+        const error2 = err;
+        setError(error2);
+        return {
+          success: false,
+          error: error2.message || "Failed to log exit"
+        };
+      } finally {
+        setIsLoading(false);
+      }
     },
-    [logRemoteWork]
+    [remoteWorkService]
   );
   return {
     logEntry,
     logExit,
-    logRemoteWork,
     isLoading,
     error
   };
 }
 
 // src/index.ts
-var SDK_VERSION = "1.0.2";
+var SDK_VERSION = "1.0.4";
 export {
   ApiClient,
   AuthService,
@@ -1842,13 +1927,13 @@ export {
   formatISO,
   formatTime,
   parseISO,
-  useCheckIn,
   useLocation,
-  useNFCScanner,
   usePassgageAccess,
   usePassgageAuth,
-  useQRScanner,
-  useRemoteWork,
+  usePassgageCheckIn,
+  usePassgageNFCScanner,
+  usePassgageQRScanner,
+  usePassgageRemoteWork,
   validateCoordinates,
   validateDeviceId,
   validateNFCCode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@passgage/sdk-react-native",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Passgage Access SDK - React Native wrapper with components and hooks",
   "main": "dist/index.js",
   "module": "dist/index.mjs",