@oxyhq/services 23.2.0 → 24.0.1

package/src/ui/context/oxyContextTypes.ts

@@ -176,6 +176,28 @@ export interface OxyContextProviderProps {
    * @default 'popup'
    */
   webAuthMode?: WebAuthMode;
+  /**
+   * Let NATIVE background code (a home-screen widget's WorkManager worker, a sync
+   * job) authenticate while the app process is dead and there is no JS runtime.
+   *
+   * With this on, the SDK provisions a purpose-built background credential
+   * whenever the app runs and stores it where `so.oxy.session.OxyBackgroundSession`
+   * can read it; Kotlin then exchanges it for a short access token on demand. The
+   * app writes no session code — this prop is the whole integration.
+   *
+   * OFF by default, because a credential that nobody needs is exposure that
+   * nobody needs. Turn it on only in an app that actually has background code to
+   * authenticate. Android-only today; inert on web and iOS.
+   *
+   * The credential cannot create a session (only the running app can provision
+   * one), cannot rotate or otherwise disturb the app's own device credential, and
+   * is re-authorized server-side on every use so it can never outlive a sign-out.
+   * It does NOT reduce authority: the token it mints is a full user access token,
+   * exactly like the device credential's.
+   *
+   * @default false
+   */
+  backgroundSession?: boolean;
   onAuthStateChange?: (user: User | null) => void;
   onError?: (error: ApiError) => void;
 }

package/src/ui/screens/AccountSettingsScreen.tsx

@@ -12,7 +12,7 @@ import { Text } from '@oxyhq/bloom/typography';
 import { Button } from '@oxyhq/bloom/button';
 import { TextField, TextFieldInput } from '@oxyhq/bloom/text-field';
 import { SettingsListGroup, SettingsListItem } from '@oxyhq/bloom/settings-list';
-import type { UpdateAccountInput } from '@oxyhq/core';
+import { getNormalizedUserHandle, type UpdateAccountInput } from '@oxyhq/core';
 import type { BaseScreenProps } from '../types/navigation';
 import { SettingsIcon } from '../components/SettingsIcon';
 import { useOxy } from '../context/OxyContext';
@@ -67,9 +67,9 @@ const AccountSettingsScreen: React.FC<BaseScreenProps> = ({ onClose, goBack, nav
   // Seed the form from the account during render (no useEffect): the first time
   // the query resolves we capture its values into local edit state.
   if (node && !seeded) {
-    const first = node.account?.name?.first ?? '';
-    const last = node.account?.name?.last ?? '';
-    setDisplayName([first, last].filter(Boolean).join(' '));
+    setDisplayName(
+      node.account?.name?.displayName ?? getNormalizedUserHandle(node.account) ?? '',
+    );
     setBio(node.account?.bio ?? '');
     setSeeded(true);
   }

package/src/ui/screens/ChangeAvatarScreen.tsx

@@ -40,7 +40,7 @@ import {
 import { surfaces as bloomSurfaces } from '@oxyhq/bloom/surfaces';
 import { useTheme } from '@oxyhq/bloom/theme';
 import { toast } from '@oxyhq/bloom';
-import { getAccountDisplayName, logger } from '@oxyhq/core';
+import { getNormalizedUserHandle, logger } from '@oxyhq/core';
 import type { FileMetadata } from '@oxyhq/core';
 import { useOxy } from '../context/OxyContext';
 import { useI18n } from '../hooks/useI18n';
@@ -133,7 +133,7 @@ async function loadImagePicker(): Promise<ImagePickerModule | null> {
 
 const ChangeAvatarScreen: React.FC<BaseScreenProps> = ({ navigate, dismiss }) => {
     const bloomTheme = useTheme();
-    const { t, locale } = useI18n();
+    const { t } = useI18n();
     const { user, oxyServices } = useOxy();
 
     /** Set when a permission was refused — drives the inline denied notice. */
@@ -143,7 +143,10 @@ const ChangeAvatarScreen: React.FC<BaseScreenProps> = ({ navigate, dismiss }) =>
 
     useSurfaceHeader(useMemo(() => ({ title: t('changeAvatar.title') }), [t]));
 
-    const displayName = useMemo(() => getAccountDisplayName(user, locale), [user, locale]);
+    const displayName = useMemo(
+        () => user?.name?.displayName ?? getNormalizedUserHandle(user) ?? '',
+        [user],
+    );
     const avatarUri = useMemo(
         // `thumb` is 256x256 — exactly a 2x source for the 132dp hero.
         () => (user?.avatar ? oxyServices.getFileDownloadUrl(user.avatar, 'thumb') : undefined),

package/src/ui/screens/EditProfileScreen.tsx

@@ -3,7 +3,7 @@ import { useMemo } from 'react';
 import { View } from 'react-native';
 import { useTheme } from '@oxyhq/bloom/theme';
 import { SettingsListGroup, SettingsListItem } from '@oxyhq/bloom/settings-list';
-import { getAccountDisplayName } from '@oxyhq/core';
+import { getNormalizedUserHandle } from '@oxyhq/core';
 import type { BaseScreenProps } from '../types/navigation';
 import { Avatar } from '@oxyhq/bloom/avatar';
 import ProfileSummaryCard from '../components/ProfileSummaryCard';
@@ -24,12 +24,15 @@ import type { ProfileFieldType } from './EditProfileFieldScreen';
  */
 const EditProfileScreen: React.FC<BaseScreenProps> = ({ navigate }) => {
     const bloomTheme = useTheme();
-    const { t, locale } = useI18n();
+    const { t } = useI18n();
     const { user, oxyServices, openAvatarPicker } = useOxy();
 
     useSurfaceHeader({ title: t('editProfile.title') || 'Edit Profile' });
 
-    const displayName = useMemo(() => getAccountDisplayName(user, locale), [user, locale]);
+    const displayName = useMemo(
+        () => user?.name?.displayName ?? getNormalizedUserHandle(user) ?? '',
+        [user],
+    );
     const avatarUri = useMemo(
         () => (user?.avatar ? oxyServices.getFileDownloadUrl(user.avatar, 'thumb') : undefined),
         [user?.avatar, oxyServices],

package/src/ui/screens/FeedbackScreen.tsx

@@ -283,6 +283,7 @@ const FeedbackScreen: React.FC<BaseScreenProps> = ({
 		>
 			{Array.from({ length: TOTAL_STEPS }, (_, index) => (
 				<View
+					// biome-ignore lint/suspicious/noArrayIndexKey: fixed step indicators, order never changes
 					key={index}
 					className={
 						currentStep === index

package/src/ui/screens/ManageAccountScreen.tsx

@@ -15,6 +15,7 @@ import { SettingsListGroup, SettingsListItem } from '@oxyhq/bloom/settings-list'
 import {
     getAccountDisplayName,
     getAccountFallbackHandle,
+    getNormalizedUserHandle,
     logger as loggerUtil,
     packageInfo,
 } from '@oxyhq/core';
@@ -120,7 +121,13 @@ const ManageAccountScreen: React.FC<BaseScreenProps> = ({
     const [signingOutAllDevices, setSigningOutAllDevices] = useState(false);
     const [signingOut, setSigningOut] = useState(false);
 
-    const displayName = useMemo(() => getAccountDisplayName(user, locale), [user, locale]);
+    const displayName = useMemo(
+        () =>
+            user?.name?.displayName ??
+            getNormalizedUserHandle(user) ??
+            getAccountDisplayName(null, locale),
+        [user, locale],
+    );
     const handle = useMemo(() => getAccountFallbackHandle(user), [user]);
     const avatarUri = useMemo(() => {
         return user?.avatar

package/src/ui/screens/PremiumSubscriptionScreen.tsx

@@ -741,9 +741,9 @@ const PremiumSubscriptionScreen: React.FC<BaseScreenProps> = ({
                 </View>
 
                 <BenefitList className="mb-space-24">
-                    {plan.features.map((feature, index) => (
+                    {plan.features.map((feature) => (
                         <BenefitRow
-                            key={index}
+                            key={feature}
                             icon={<Ionicons name="checkmark" size={18} color={colors.success} />}
                             label={feature}
                         />

package/src/ui/screens/PrivacySettingsScreen.tsx

@@ -14,7 +14,7 @@ import { useI18n } from '../hooks/useI18n';
 import { useSurfaceHeader } from '../hooks/useSurfaceHeader';
 import { useSettingToggles } from '../hooks/useSettingToggle';
 import type { BlockedUser, RestrictedUser } from '@oxyhq/core';
-import { getAccountDisplayName } from '@oxyhq/core';
+import { getNormalizedUserHandle } from '@oxyhq/core';
 import { useOxy } from '../context/OxyContext';
 
 interface PrivacySettings {
@@ -68,7 +68,7 @@ const PrivacySettingsScreen: React.FC<BaseScreenProps> = ({
     // Privacy settings belong to the ACTIVE account (the org/project/bot when
     // switched, else the personal user).
     const { oxyServices, user } = useOxy();
-    const { t, locale } = useI18n();
+    const { t } = useI18n();
 
     useSurfaceHeader({ title: t('privacySettings.title') || 'Privacy Settings' });
     const bloomTheme = useTheme();
@@ -176,35 +176,37 @@ const PrivacySettingsScreen: React.FC<BaseScreenProps> = ({
     }, [oxyServices, t]);
 
     // Helper to extract user info from blocked/restricted objects.
-    // Display names go through the canonical helper so the fallback chain is
-    // identical across every UI surface (name → username → publicKey → "Unnamed").
     const extractUserInfo = useCallback((
         item: BlockedUser | RestrictedUser,
         idField: 'blockedId' | 'restrictedId'
     ) => {
-        let userIdField: string | { _id: string; username?: string; avatar?: string };
-        let userShape: { username?: string };
+        let userIdField: string | { _id: string; username?: string; avatar?: string; name?: { displayName?: string } };
+        let userShape: { username?: string; name?: { displayName?: string } };
         let avatar: string | undefined;
 
         if (idField === 'blockedId' && 'blockedId' in item) {
             userIdField = item.blockedId;
             userShape = typeof item.blockedId === 'string'
                 ? { username: item.username }
-                : { username: item.blockedId.username };
+                : { username: item.blockedId.username, name: item.blockedId.name };
             avatar = typeof item.blockedId === 'string' ? item.avatar : item.blockedId.avatar;
         } else if (idField === 'restrictedId' && 'restrictedId' in item) {
             userIdField = item.restrictedId;
             userShape = typeof item.restrictedId === 'string'
                 ? { username: item.username }
-                : { username: item.restrictedId.username };
+                : { username: item.restrictedId.username, name: item.restrictedId.name };
             avatar = typeof item.restrictedId === 'string' ? item.avatar : item.restrictedId.avatar;
         } else {
-            return { userId: '', displayName: getAccountDisplayName(null, locale), avatar: undefined };
+            return { userId: '', displayName: getNormalizedUserHandle(null) ?? '', avatar: undefined };
         }
 
         const userId = typeof userIdField === 'string' ? userIdField : userIdField._id;
-        return { userId, displayName: getAccountDisplayName(userShape, locale), avatar };
-    }, [locale]);
+        return {
+            userId,
+            displayName: userShape.name?.displayName ?? getNormalizedUserHandle(userShape) ?? '',
+            avatar,
+        };
+    }, []);
 
     if (isLoading) {
         return (

package/src/ui/screens/ProfileScreen.tsx

@@ -78,7 +78,9 @@ const ProfileScreen: React.FC<ProfileScreenProps> = ({ userId, username, theme,
                     );
                     throw err;
                 }),
-                oxyServices.getReputationBalance(userId)
+                (isOwnProfile
+                    ? oxyServices.getMyReputationBalance()
+                    : oxyServices.getReputationBalance(userId))
                     .then((balance): { total: number | undefined } => ({ total: balance.total }))
                     .catch((): { total: number | undefined } => ({ total: undefined })),
                 oxyServices.getUserStats

package/src/ui/screens/UserListScreen.tsx

@@ -65,7 +65,7 @@ const UserListScreen: React.FC<UserListScreenProps> = ({
   const [hasMore, setHasMore] = useState(true);
 
   const bloomTheme = useTheme();
-  const { t, locale } = useI18n();
+  const { t } = useI18n();
 
   const currentUserId = currentUser ? resolveUserId(currentUser) : '';
 
@@ -199,7 +199,7 @@ const UserListScreen: React.FC<UserListScreenProps> = ({
         </TouchableOpacity>
       );
     },
-    [handleUserPress, currentUserId, oxyServices, locale]
+    [handleUserPress, currentUserId, oxyServices]
   );
 
   const renderEmpty = useCallback(() => {

package/src/ui/screens/trust/TrustCenterScreen.tsx

@@ -1,7 +1,7 @@
 import type React from 'react';
 import { useEffect, useMemo, useState } from 'react';
 import { View, StyleSheet } from 'react-native';
-import type { ReputationTransaction, TrustTier } from '@oxyhq/core';
+import type { ReputationTransaction, TrustTier } from '@oxyhq/contracts';
 import Ionicons from '@expo/vector-icons/Ionicons';
 import { Chip } from '@oxyhq/bloom/chip';
 import { useTheme } from '@oxyhq/bloom/theme';
@@ -36,7 +36,7 @@ const TrustCenterScreen: React.FC<BaseScreenProps> = ({
         setIsLoading(true);
         setError(null);
         Promise.all([
-            oxyServices.getReputationBalance(user.id),
+            oxyServices.getMyReputationBalance(),
             oxyServices.getReputationTransactions(user.id, 20, 0),
         ])
             .then(([balance, txns]) => {

package/src/ui/screens/trust/TrustLeaderboardScreen.tsx

@@ -7,7 +7,7 @@ import {
     FlatList,
     TouchableOpacity,
 } from 'react-native';
-import type { ReputationLeaderboardEntry } from '@oxyhq/core';
+import type { ReputationLeaderboardEntry } from '@oxyhq/contracts';
 import { getNormalizedUserHandle, logger } from '@oxyhq/core';
 import { useTheme } from '@oxyhq/bloom/theme';
 import { H6, Text } from '@oxyhq/bloom/typography';
@@ -29,7 +29,7 @@ const PODIUM_RANK = 3;
 
 const TrustLeaderboardScreen: React.FC<BaseScreenProps> = ({ navigate }) => {
     const { oxyServices, user: currentUser } = useOxy();
-    const { t, locale } = useI18n();
+    const { t } = useI18n();
     const bloomTheme = useTheme();
 
     const [leaderboard, setLeaderboard] = useState<ReputationLeaderboardEntry[]>([]);
@@ -116,7 +116,7 @@ const TrustLeaderboardScreen: React.FC<BaseScreenProps> = ({ navigate }) => {
                 </TouchableOpacity>
             );
         },
-        [oxyServices, locale, currentUserId, handleEntryPress, t],
+        [oxyServices, currentUserId, handleEntryPress, t],
     );
 
     const keyExtractor = useCallback(

package/src/ui/screens/trust/TrustRewardsScreen.tsx

@@ -97,7 +97,7 @@ const TrustRewardsScreen: React.FC<BaseScreenProps> = () => {
             return;
         }
         setIsLoading(true);
-        oxyServices.getReputationBalance(user.id)
+        oxyServices.getMyReputationBalance()
             .then((balance) => {
                 setReputationTotal(balance.total || 0);
             })

package/src/ui/screens/trust/TrustRulesScreen.tsx

@@ -4,7 +4,7 @@ import { View, Text } from 'react-native';
 import { SettingsListGroup, SettingsListItem } from '@oxyhq/bloom/settings-list';
 import { Chip } from '@oxyhq/bloom/chip';
 import { useTheme } from '@oxyhq/bloom/theme';
-import type { ReputationRule, ReputationCategory } from '@oxyhq/core';
+import type { ReputationRule, ReputationCategory } from '@oxyhq/contracts';
 import type { BaseScreenProps } from '../../types/navigation';
 import { useSurfaceHeader } from '../../hooks/useSurfaceHeader';
 import { Loading } from '@oxyhq/bloom/loading';

package/src/ui/screens/trust/trustTier.ts

@@ -1,4 +1,4 @@
-import type { TrustTier } from '@oxyhq/core';
+import type { TrustTier } from '@oxyhq/contracts';
 
 type Translate = (key: string, vars?: Record<string, string | number>) => string;