♻️ refactor(expo): route all platform-sensitive deps through lib/ wrappers

apps/expo/app/(app)/(tabs)/profile/index.tsx

@@ -13,7 +13,6 @@ import {
   Text,
 } from '@packrat/ui/nativewindui';
 import { getAppBarOptions } from '@packrat/ui/src/app-bar';
-import AsyncStorage from '@react-native-async-storage/async-storage';
 import * as Sentry from '@sentry/react-native';
 import { AndroidTabBarInsetFix } from 'expo-app/components/AndroidTabBarInsetFix';
 import { Icon } from 'expo-app/components/Icon';
@@ -29,6 +28,7 @@ import { useImagePicker } from 'expo-app/features/packs/hooks/useImagePicker';
 import { uploadImage } from 'expo-app/features/packs/utils/uploadImage';
 import { ProfileAuthWall } from 'expo-app/features/profile/components';
 import { useUpdateProfile } from 'expo-app/features/profile/hooks/useUpdateProfile';
+import AsyncStorage from 'expo-app/lib/asyncStorage';
 import { cn } from 'expo-app/lib/cn';
 import { hasUnsyncedChanges } from 'expo-app/lib/hasUnsyncedChanges';
 import { useColorScheme } from 'expo-app/lib/hooks/useColorScheme';

apps/expo/app/(app)/settings/index.tsx

@@ -1,5 +1,4 @@
 import { ActivityIndicator, Text } from '@packrat/ui/nativewindui';
-import AsyncStorage from '@react-native-async-storage/async-storage';
 import * as Burnt from 'burnt';
 import { appAlert } from 'expo-app/app/_layout';
 import { Icon, type MaterialIconName } from 'expo-app/components/Icon';
@@ -18,6 +17,7 @@ import {
 import { DeleteAccountButton } from 'expo-app/features/auth/components/DeleteAccountButton';
 import { useAuth } from 'expo-app/features/auth/hooks/useAuth';
 import { useSeasonSuggestionsPrefs } from 'expo-app/features/packs/atoms/seasonSuggestionsAtoms';
+import AsyncStorage from 'expo-app/lib/asyncStorage';
 import { useColorScheme } from 'expo-app/lib/hooks/useColorScheme';
 import { useTranslation } from 'expo-app/lib/hooks/useTranslation';
 import ImageCacheManager from 'expo-app/lib/utils/ImageCacheManager';

apps/expo/app/auth/index.tsx

@@ -1,13 +1,13 @@
 import type { AlertMethods } from '@packrat/ui/nativewindui';
 import { ActivityIndicator, AlertAnchor, Button, Text } from '@packrat/ui/nativewindui';
-import AsyncStorage from '@react-native-async-storage/async-storage';
 import { featureFlags } from 'expo-app/config';
 import {
   isLoadingAtom,
   needsReauthAtom,
   redirectToAtom,
 } from 'expo-app/features/auth/atoms/authAtoms';
 import { useAuth } from 'expo-app/features/auth/hooks/useAuth';
+import AsyncStorage from 'expo-app/lib/asyncStorage';
 import { useTranslation } from 'expo-app/lib/hooks/useTranslation';
 import { testIds } from 'expo-app/lib/testIds';
 import { Link, router, useLocalSearchParams } from 'expo-router';

apps/expo/atoms/atomWithAsyncStorage.ts

@@ -1,5 +1,5 @@
 import { isFunction } from '@packrat/guards';
-import AsyncStorage from '@react-native-async-storage/async-storage';
+import AsyncStorage from 'expo-app/lib/asyncStorage';
 import { atom } from 'jotai';
 
 export const atomWithAsyncStorage = <T>({

apps/expo/atoms/atomWithKvStorage.ts

@@ -1,5 +1,5 @@
 import { isFunction } from '@packrat/guards';
-import Storage from 'expo-sqlite/kv-store';
+import Storage from 'expo-app/lib/expoSqliteKvStore';
 import { atom } from 'jotai';
 
 export const atomWithKvStorage = <T>({ key, initialValue }: { key: string; initialValue: T }) => {

apps/expo/features/ai/atoms/chatStorageAtoms.ts

@@ -1,7 +1,7 @@
 import type { UIMessage } from '@ai-sdk/react';
 import { isObject, isString } from '@packrat/guards';
-import AsyncStorage from '@react-native-async-storage/async-storage';
 import * as Sentry from '@sentry/react-native';
+import AsyncStorage from 'expo-app/lib/asyncStorage';
 
 export type ChatContext = {
   itemId?: string;

apps/expo/features/auth/hooks/useAuthActions.ts

@@ -1,22 +1,18 @@
 import { asBoolean, asString } from '@packrat/guards';
-import AsyncStorage from '@react-native-async-storage/async-storage';
-import {
-  GoogleSignin,
-  isErrorWithCode,
-  statusCodes,
-} from '@react-native-google-signin/google-signin';
 import * as Sentry from '@sentry/react-native';
 import { AuthClientError, toAuthError } from 'expo-app/features/auth/lib/authErrors';
 import { userStore } from 'expo-app/features/auth/store';
 import type { User } from 'expo-app/features/profile/types';
 import * as AppleAuthentication from 'expo-app/lib/appleAuthentication';
+import AsyncStorage from 'expo-app/lib/asyncStorage';
 import { authClient } from 'expo-app/lib/auth-client';
+import Storage from 'expo-app/lib/expoSqliteKvStore';
+import { GoogleSignin, isErrorWithCode, statusCodes } from 'expo-app/lib/googleSignin';
 import { t } from 'expo-app/lib/i18n';
 import * as Updates from 'expo-app/lib/updates';
 import ImageCacheManager from 'expo-app/lib/utils/ImageCacheManager';
 import { queryClient } from 'expo-app/providers/TanstackProvider';
 import { type Href, router } from 'expo-router';
-import Storage from 'expo-sqlite/kv-store';
 import { useAtomValue, useSetAtom } from 'jotai';
 import {
   isLoadingAtom,

apps/expo/features/auth/hooks/useAuthInit.ts

@@ -2,13 +2,13 @@ import { when } from '@legendapp/state';
 import { WEIGHT_UNITS } from '@packrat/constants';
 import { clientEnvs } from '@packrat/env/expo-client';
 import { asBoolean, asString } from '@packrat/guards';
-import AsyncStorage from '@react-native-async-storage/async-storage';
-import { GoogleSignin } from '@react-native-google-signin/google-signin';
 import * as Sentry from '@sentry/react-native';
 import { userStore, userSyncState } from 'expo-app/features/auth/store';
+import AsyncStorage from 'expo-app/lib/asyncStorage';
 import { authClient } from 'expo-app/lib/auth-client';
+import Storage from 'expo-app/lib/expoSqliteKvStore';
+import { GoogleSignin } from 'expo-app/lib/googleSignin';
 import { router } from 'expo-router';
-import Storage from 'expo-sqlite/kv-store';
 import { useEffect, useState } from 'react';
 import { Platform } from 'react-native';
 

apps/expo/features/trail-conditions/hooks/useTrailConditionReports.ts

@@ -1,9 +1,9 @@
 import { useSelector } from '@legendapp/state/react';
-import AsyncStorage from '@react-native-async-storage/async-storage';
 import * as Sentry from '@sentry/react-native';
 import { useQuery } from '@tanstack/react-query';
 import { userStore } from 'expo-app/features/auth/store/user';
 import { apiClient } from 'expo-app/lib/api/packrat';
+import AsyncStorage from 'expo-app/lib/asyncStorage';
 import { useAuthenticatedQueryToolkit } from 'expo-app/lib/hooks/useAuthenticatedQueryToolkit';
 import { useEffect, useRef, useState } from 'react';
 import { trailConditionReportsStore } from '../store/trailConditionReports';

apps/expo/features/weather/screens/LocationSearchScreen.tsx

@@ -1,8 +1,8 @@
 import { Text } from '@packrat/ui/nativewindui';
-import AsyncStorage from '@react-native-async-storage/async-storage';
 import * as Sentry from '@sentry/react-native';
 import { Icon } from 'expo-app/components/Icon';
 import { SearchInput } from 'expo-app/components/SearchInput';
+import AsyncStorage from 'expo-app/lib/asyncStorage';
 import { cn } from 'expo-app/lib/cn';
 import { useColorScheme } from 'expo-app/lib/hooks/useColorScheme';
 import { useTranslation } from 'expo-app/lib/hooks/useTranslation';

apps/expo/features/wildlife/atoms/wildlifeAtoms.ts

@@ -1,4 +1,4 @@
-import AsyncStorage from '@react-native-async-storage/async-storage';
+import AsyncStorage from 'expo-app/lib/asyncStorage';
 import { atomWithStorage, createJSONStorage, loadable } from 'jotai/utils';
 import type { WildlifeIdentification } from '../types';
 

apps/expo/lib/asyncStorage.ts

@@ -0,0 +1,5 @@
+// @react-native-async-storage/async-storage ships a localStorage-backed web
+// implementation out of the box, so a single re-export works on every
+// platform. This wrapper exists so call sites never import the native module
+// path directly (per the lib/ wrapper convention).
+export { default } from '@react-native-async-storage/async-storage';

apps/expo/lib/expoSqliteKvStore.ts

@@ -0,0 +1,5 @@
+// Default export is the `Storage` singleton from expo-sqlite/kv-store, an
+// AsyncStorage-compatible store with extra synchronous methods (getItemSync,
+// setItemSync). The native module has no working web build, so .web.ts backs
+// the same surface with localStorage.
+export { default } from 'expo-sqlite/kv-store';

apps/expo/lib/expoSqliteKvStore.web.ts

@@ -0,0 +1,61 @@
+// expo-sqlite/kv-store relies on the native SQLite module, which has no usable
+// web build. Back the same API (async aliases + sync variants + getAllKeys)
+// with localStorage so callers need no Platform branches on web.
+
+const getItemSync = (key: string): string | null => {
+  try {
+    return localStorage.getItem(key);
+  } catch {
+    return null;
+  }
+};
+
+const setItemSync = (key: string, value: string): void => {
+  localStorage.setItem(key, value);
+};
+
+const removeItemSync = (key: string): void => {
+  localStorage.removeItem(key);
+};
+
+const getAllKeysSync = (): string[] => {
+  const keys: string[] = [];
+  for (let i = 0; i < localStorage.length; i++) {
+    const key = localStorage.key(i);
+    if (key !== null) keys.push(key);
+  }
+  return keys;
+};
+
+const Storage = {
+  getItem: (key: string): Promise<string | null> => Promise.resolve(getItemSync(key)),
+  setItem: (key: string, value: string): Promise<void> => {
+    setItemSync(key, value);
+    return Promise.resolve();
+  },
+  removeItem: (key: string): Promise<void> => {
+    removeItemSync(key);
+    return Promise.resolve();
+  },
+  getAllKeys: (): Promise<string[]> => Promise.resolve(getAllKeysSync()),
+  clear: (): Promise<void> => {
+    localStorage.clear();
+    return Promise.resolve();
+  },
+  getItemAsync: (key: string): Promise<string | null> => Promise.resolve(getItemSync(key)),
+  setItemAsync: (key: string, value: string): Promise<void> => {
+    setItemSync(key, value);
+    return Promise.resolve();
+  },
+  removeItemAsync: (key: string): Promise<boolean> => {
+    removeItemSync(key);
+    return Promise.resolve(true);
+  },
+  getAllKeysAsync: (): Promise<string[]> => Promise.resolve(getAllKeysSync()),
+  getItemSync,
+  setItemSync,
+  removeItemSync,
+  getAllKeysSync,
+};
+
+export default Storage;

apps/expo/lib/googleSignin.ts

@@ -0,0 +1,9 @@
+export {
+  GoogleSignin,
+  GoogleSigninButton,
+  isCancelledResponse,
+  isErrorWithCode,
+  isNoSavedCredentialFoundResponse,
+  isSuccessResponse,
+  statusCodes,
+} from '@react-native-google-signin/google-signin';

apps/expo/lib/googleSignin.web.ts

@@ -0,0 +1,34 @@
+// @react-native-google-signin/google-signin is a native module with no usable
+// web implementation. Native Google Sign-In is not wired up for web (web auth
+// uses a different OAuth flow), so this stub keeps the bundle building and
+// fails loudly only if a web caller actually tries to trigger native sign-in.
+
+const notAvailable = (): never => {
+  throw new Error('Native Google Sign-In is not available on web.');
+};
+
+export const GoogleSignin = {
+  configure: () => {},
+  hasPlayServices: () => Promise.resolve(false),
+  signIn: notAvailable,
+  signInSilently: notAvailable,
+  getTokens: notAvailable,
+  hasPreviousSignIn: () => false,
+  signOut: () => Promise.resolve(null),
+  revokeAccess: () => Promise.resolve(null),
+  getCurrentUser: () => null,
+};
+
+export const statusCodes = {
+  SIGN_IN_CANCELLED: 'SIGN_IN_CANCELLED',
+  IN_PROGRESS: 'IN_PROGRESS',
+  PLAY_SERVICES_NOT_AVAILABLE: 'PLAY_SERVICES_NOT_AVAILABLE',
+  SIGN_IN_REQUIRED: 'SIGN_IN_REQUIRED',
+} as const;
+
+export const isErrorWithCode = (_error: unknown): boolean => false;
+export const isSuccessResponse = (_response: unknown): boolean => false;
+export const isCancelledResponse = (_response: unknown): boolean => false;
+export const isNoSavedCredentialFoundResponse = (_response: unknown): boolean => false;
+
+export const GoogleSigninButton = (): null => null;

apps/expo/lib/kvStorage.ts

@@ -1,4 +1,4 @@
-import Storage from 'expo-sqlite/kv-store';
+import Storage from 'expo-app/lib/expoSqliteKvStore';
 
 export default {
   getItem: (key: string): string | null => Storage.getItemSync(key),

apps/expo/lib/kvStorage.web.ts

@@ -1,4 +1,4 @@
-import AsyncStorage from '@react-native-async-storage/async-storage';
+import AsyncStorage from 'expo-app/lib/asyncStorage';
 
 export default {
   getItem: (key: string) => AsyncStorage.getItem(key),

apps/expo/lib/persist-plugin.ts

@@ -1,4 +1,4 @@
 import { observablePersistSqlite } from '@legendapp/state/persist-plugins/expo-sqlite';
-import Storage from 'expo-sqlite/kv-store';
+import Storage from 'expo-app/lib/expoSqliteKvStore';
 
 export const persistPlugin = observablePersistSqlite(Storage);

apps/expo/lib/persist-plugin.web.ts

@@ -1,5 +1,5 @@
 import { observablePersistAsyncStorage } from '@legendapp/state/persist-plugins/async-storage';
-import AsyncStorage from '@react-native-async-storage/async-storage';
+import AsyncStorage from 'expo-app/lib/asyncStorage';
 
 // On web, the expo-sqlite persist plugin requires SharedArrayBuffer (COEP/COOP
 // headers). Use the AsyncStorage plugin instead, which falls through to our

apps/expo/utils/storage.ts

@@ -1,5 +1,5 @@
-import AsyncStorage from '@react-native-async-storage/async-storage';
 import type { WeatherLocation } from 'expo-app/features/weather/types';
+import AsyncStorage from 'expo-app/lib/asyncStorage';
 import { createJSONStorage } from 'jotai/utils';
 
 // Create a storage adapter for Jotai that uses AsyncStorage