@oxyhq/services 19.1.3 → 20.0.0

package/lib/typescript/module/ui/hooks/useLanguageManagement.d.ts

@@ -1,25 +1,69 @@
-import type { ApiError, User } from '@oxyhq/core';
-import { type LanguageMetadata } from '@oxyhq/core';
+import type { ApiError, User, SupportedLanguage } from '@oxyhq/core';
 import type { StorageInterface } from '../utils/storageHelpers.js';
 export interface UseLanguageManagementOptions {
     storage: StorageInterface | null;
     languageKey: string;
+    /**
+     * The active account, when signed in. When present, the account's primary
+     * locale (`languages[0]`) is authoritative for the app's UI locale; when
+     * `null` the device locale (or a locally-chosen guest override) is used.
+     */
+    user: User | null;
     onError?: (error: ApiError) => void;
     logger?: (message: string, error?: unknown) => void;
 }
 export interface UseLanguageManagementResult {
+    /**
+     * The active UI locale (a canonical `language-REGION` tag). Derived, never
+     * stored: the account's primary locale when signed in, otherwise the
+     * locally-chosen guest override, otherwise the device locale.
+     */
     currentLanguage: string;
-    metadata: LanguageMetadata | null;
+    /**
+     * The ordered account locales (primary first) when signed in, or the single
+     * guest override when signed out. Empty only before the guest override loads
+     * and no device locale resolves.
+     */
+    languages: string[];
+    metadata: SupportedLanguage | null;
     languageName: string;
     nativeLanguageName: string;
-    setLanguage: (languageId: string) => Promise<void>;
-    applyLanguagePreference: (user: User | null) => Promise<void>;
+    /**
+     * Persist a single locally-owned locale (guest / device override) and mark it
+     * primary. For signed-in accounts, locale changes are written to the account
+     * (`updateProfile({ languages })`) instead — the derived `currentLanguage`
+     * then follows the refreshed `user`.
+     */
+    setLanguage: (locale: string) => Promise<void>;
     hydrateLanguage: () => Promise<void>;
 }
 /**
- * Manage UI language state, persistence, and metadata derivation.
+ * Append `locale` to an ordered locale list if not already present. Canonical
+ * order is preserved; the new locale lands last (non-primary).
+ */
+export declare function addLocale(languages: readonly string[], locale: string): string[];
+/**
+ * Remove `locale` from an ordered locale list. The list's new first element
+ * becomes the primary locale.
+ */
+export declare function removeLocale(languages: readonly string[], locale: string): string[];
+/**
+ * Move `locale` to the front of an ordered locale list, making it primary.
+ * Adds it if it was not already present.
+ */
+export declare function setPrimaryLocale(languages: readonly string[], locale: string): string[];
+/**
+ * Resolve and manage the app's active UI locale.
+ *
+ * The active locale is DERIVED, not stored:
+ *  - Signed in  → the account's primary locale (`getPrimaryLanguage(user)`),
+ *    falling back to {@link FALLBACK_LOCALE}. This is what makes every Oxy app
+ *    follow the account's language automatically.
+ *  - Signed out → a locally-chosen guest override if one exists, otherwise the
+ *    device locale.
  *
- * @param options - Configuration for storage access and error reporting
+ * The only external system this hook synchronizes with is local storage (the
+ * guest override), which is loaded once on mount.
  */
-export declare const useLanguageManagement: ({ storage, languageKey, onError, logger, }: UseLanguageManagementOptions) => UseLanguageManagementResult;
+export declare const useLanguageManagement: ({ storage, languageKey, user, onError, logger, }: UseLanguageManagementOptions) => UseLanguageManagementResult;
 //# sourceMappingURL=useLanguageManagement.d.ts.map

package/lib/typescript/module/ui/hooks/useLanguageManagement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLanguageManagement.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useLanguageManagement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAAyB,CAAC;AAGhE,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,2BAA2B;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,uBAAuB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAID;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,4CAKnC,4BAA4B,KAAG,2BA4GjC,CAAC"}
+{"version":3,"file":"useLanguageManagement.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useLanguageManagement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAYrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAAyB,CAAC;AAGhE,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAKhF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAInF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAIvF;AA6CD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAAI,kDAMnC,4BAA4B,KAAG,2BAyGjC,CAAC"}

package/lib/typescript/module/ui/hooks/useSessionManagement.d.ts

@@ -9,7 +9,6 @@ export interface UseSessionManagementOptions {
     storageKeyPrefix?: string;
     loginSuccess: (user: User) => void;
     logoutStore: () => void;
-    applyLanguagePreference: (user: User) => Promise<void>;
     onAuthStateChange?: (user: User | null) => void;
     onError?: (error: ApiError) => void;
     setAuthError?: (message: string | null) => void;
@@ -38,5 +37,5 @@ export interface UseSessionManagementResult {
  *
  * @param options - Session management configuration
  */
-export declare const useSessionManagement: ({ oxyServices, storage, storageKeyPrefix, loginSuccess, logoutStore, applyLanguagePreference, onAuthStateChange, onError, setAuthError, logger, setTokenReady, queryClient, }: UseSessionManagementOptions) => UseSessionManagementResult;
+export declare const useSessionManagement: ({ oxyServices, storage, storageKeyPrefix, loginSuccess, logoutStore, onAuthStateChange, onError, setAuthError, logger, setTokenReady, queryClient, }: UseSessionManagementOptions) => UseSessionManagementResult;
 //# sourceMappingURL=useSessionManagement.d.ts.map

package/lib/typescript/module/ui/hooks/useSessionManagement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSessionManagement.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useSessionManagement.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,4BAAyB,CAAC;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKzD,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,uBAAuB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,cAAc,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IAClH,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,eAAe,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,WAAW,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAC/C,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAKD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,+KAalC,2BAA2B,KAAG,0BA4ThC,CAAC"}
+{"version":3,"file":"useSessionManagement.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useSessionManagement.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,4BAAyB,CAAC;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKzD,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,cAAc,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IAClH,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,eAAe,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,WAAW,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAC/C,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAKD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,sJAYlC,2BAA2B,KAAG,0BA2ThC,CAAC"}

package/lib/typescript/module/ui/screens/LanguageSelectorScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LanguageSelectorScreen.d.ts","sourceRoot":"","sources":["../../../../../src/ui/screens/LanguageSelectorScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAqB,CAAC;AAa3D,UAAU,2BAA4B,SAAQ,eAAe;CAAI;;AA+LjE,wBAAkD"}
+{"version":3,"file":"LanguageSelectorScreen.d.ts","sourceRoot":"","sources":["../../../../../src/ui/screens/LanguageSelectorScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAqB,CAAC;AAkB3D,UAAU,2BAA4B,SAAQ,eAAe;CAAI;;AAqRjE,wBAAkD"}

package/lib/typescript/module/ui/screens/PreferencesScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PreferencesScreen.d.ts","sourceRoot":"","sources":["../../../../../src/ui/screens/PreferencesScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoD,MAAM,OAAO,CAAC;AAMzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAqB,CAAC;;AA4O3D,wBAA6C"}
+{"version":3,"file":"PreferencesScreen.d.ts","sourceRoot":"","sources":["../../../../../src/ui/screens/PreferencesScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoD,MAAM,OAAO,CAAC;AAOzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAqB,CAAC;;AAyO3D,wBAA6C"}

package/lib/typescript/module/ui/screens/fileManagement/FileListSection.d.ts

@@ -1,7 +1,7 @@
 import type React from 'react';
 import { ScrollView } from 'react-native';
 import type { FileMetadata } from '@oxyhq/core';
-import { useTheme } from '@oxyhq/bloom/theme';
+import type { useTheme } from '@oxyhq/bloom/theme';
 type ThemeColors = ReturnType<typeof useTheme>['colors'];
 /** A pre-built list row descriptor (produced by the orchestrator's memo). */
 export interface FileListItem {

package/lib/typescript/module/ui/screens/fileManagement/FileListSection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileListSection.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/fileManagement/FileListSection.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAIH,UAAU,EAGb,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEzD,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACjC,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAClD,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE;QAAE,WAAW,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;IACnE,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,mEAAmE;IACnE,gBAAgB,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC;CAC3C;AAED;;;;GAIG;AACH,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA2EnD,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"FileListSection.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/fileManagement/FileListSection.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAIH,UAAU,EAGb,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEzD,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACjC,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAClD,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE;QAAE,WAAW,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;IACnE,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,mEAAmE;IACnE,gBAAgB,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC;CAC3C;AAED;;;;GAIG;AACH,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA2EnD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/lib/typescript/module/ui/screens/fileManagement/hooks/useFileUploadState.d.ts

@@ -1,6 +1,6 @@
 import type React from 'react';
 import type { FileMetadata } from '@oxyhq/core';
-import { useUploadFile } from '../../../hooks/mutations/useAccountMutations.js';
+import type { useUploadFile } from '../../../hooks/mutations/useAccountMutations.js';
 import { type PendingUploadFile } from '../shared.js';
 /** Dependencies threaded into the upload-state hook from the orchestrator. */
 export interface UseFileUploadStateParams {

package/lib/typescript/module/ui/screens/fileManagement/hooks/useFileUploadState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFileUploadState.d.ts","sourceRoot":"","sources":["../../../../../../../src/ui/screens/fileManagement/hooks/useFileUploadState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,iDAA8C,CAAC;AAE7E,OAAO,EACH,KAAK,iBAAiB,EAQzB,MAAM,cAAW,CAAC;AAEnB,8EAA8E;AAC9E,MAAM,WAAW,wBAAwB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IACrD,iBAAiB,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IACrD,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACvC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClE,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtF,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;CACtE;AAED,mDAAmD;AACnD,MAAM,WAAW,wBAAwB;IACrC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,mBAAmB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,sKAchC,wBAAwB,KAAG,wBA4a7B,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"useFileUploadState.d.ts","sourceRoot":"","sources":["../../../../../../../src/ui/screens/fileManagement/hooks/useFileUploadState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iDAA8C,CAAC;AAElF,OAAO,EACH,KAAK,iBAAiB,EAQzB,MAAM,cAAW,CAAC;AAEnB,8EAA8E;AAC9E,MAAM,WAAW,wBAAwB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IACrD,iBAAiB,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IACrD,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACvC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClE,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtF,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;CACtE;AAED,mDAAmD;AACnD,MAAM,WAAW,wBAAwB;IACrC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,mBAAmB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,sKAchC,wBAAwB,KAAG,wBA4a7B,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/services",
-  "version": "19.1.3",
+  "version": "20.0.0",
   "description": "OxyHQ Expo/React Native SDK — UI components, screens, and native features",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -60,12 +60,20 @@
       },
       "default": "./lib/module/ui/server.js"
     },
+    "./plugins/*": "./plugins/*.js",
+    "./expo-module.config.json": "./expo-module.config.json",
     "./package.json": "./package.json"
   },
   "files": [
     "src",
     "lib",
-    "assets"
+    "assets",
+    "android/build.gradle",
+    "android/src",
+    "ios/OxyIdentityModule.swift",
+    "ios/OxyIdentity.podspec",
+    "plugins",
+    "expo-module.config.json"
   ],
   "keywords": [
     "react-native",
@@ -118,24 +126,16 @@
     }
   },
   "dependencies": {
-    "@oxyhq/contracts": "0.13.2",
+    "@oxyhq/contracts": "0.14.0",
+    "@oxyhq/core": "^10.0.0",
     "color": "^4.2.3"
   },
   "devDependencies": {
-    "@oxyhq/core": "9.2.3",
-    "nativewind": "5.0.0-preview.3",
-    "react-native-css": "^3.0.0",
-    "@react-native-async-storage/async-storage": "^2.0.0",
-    "@types/react": "*",
-    "copyfiles": "^2.4.1",
-    "react-native-keyboard-controller": "1.21.13",
-    "react-native-qrcode-svg": "^6.3.0",
-    "socket.io-client": "^4.8.1",
-    "typescript": "^5.9.2",
-    "zustand": "^5.0.14",
     "@biomejs/biome": "^1.9.4",
     "@commitlint/cli": "^17.6.5",
     "@commitlint/config-conventional": "^17.6.5",
+    "@oxyhq/core": "10.0.0",
+    "@react-native-async-storage/async-storage": "^2.0.0",
     "@react-native-community/netinfo": "^11.4.1",
     "@react-native/babel-preset": "^0.86.0",
     "@release-it/conventional-changelog": "^10.0.2",
@@ -147,6 +147,8 @@
     "@types/color": "^4.2.1",
     "@types/jest": "^29.5.14",
     "@types/node": "^20.19.9",
+    "@types/react": "*",
+    "copyfiles": "^2.4.1",
     "expo-file-system": "~57.0.0",
     "expo-font": "~57.0.0",
     "expo-haptics": "~57.0.0",
@@ -155,18 +157,25 @@
     "husky": "^4.3.8",
     "jest": "~29.7.0",
     "lint-staged": "^15.2.4",
+    "nativewind": "5.0.0-preview.3",
     "react-native-builder-bob": "^0.43.0",
+    "react-native-css": "^3.0.0",
     "react-native-gesture-handler": "~2.32.0",
+    "react-native-keyboard-controller": "1.21.13",
+    "react-native-qrcode-svg": "^6.3.0",
     "react-native-reanimated": "4.5.0",
     "react-native-safe-area-context": "~5.8.0",
     "react-native-svg": "15.15.5",
     "release-it": "^19.0.6",
-    "ts-jest": "^29.4.0"
+    "socket.io-client": "^4.8.1",
+    "ts-jest": "^29.4.0",
+    "typescript": "^5.9.2",
+    "zustand": "^5.0.14"
   },
   "peerDependencies": {
     "@expo/vector-icons": "^15.0.3",
     "@oxyhq/bloom": ">=0.16.0",
-    "@oxyhq/core": "^9.2.3",
+    "@oxyhq/core": "^10.0.0",
     "@react-native-async-storage/async-storage": "^2.0.0",
     "@react-native-community/netinfo": "^11.4.1",
     "@tanstack/query-async-storage-persister": "^5.101",
@@ -176,6 +185,7 @@
     "@types/react": "*",
     "@types/react-native": "*",
     "expo": ">=56.0.0",
+    "expo-modules-core": "*",
     "expo-document-picker": ">=56.0.0",
     "expo-file-system": ">=56.0.0",
     "expo-font": ">=13.0.0",
@@ -183,6 +193,7 @@
     "expo-image": ">=2.0.0",
     "expo-image-manipulator": ">=56.0.0",
     "expo-linear-gradient": ">=56.0.0",
+    "nativewind": ">=5.0.0",
     "react": ">=18.0.0",
     "react-native": ">=0.85.0",
     "react-native-gesture-handler": "~2.32.0",
@@ -192,13 +203,15 @@
     "react-native-safe-area-context": "~5.8.0",
     "react-native-svg": ">=15.15.0",
     "socket.io-client": "^4.8.0",
-    "zustand": "^5.0.0",
-    "nativewind": ">=5.0.0"
+    "zustand": "^5.0.0"
   },
   "peerDependenciesMeta": {
     "nativewind": {
       "optional": true
     },
+    "expo-modules-core": {
+      "optional": true
+    },
     "@expo/vector-icons": {
       "optional": true
     },

package/plugins/withSharedIdentityProvider.js

@@ -0,0 +1,83 @@
+/**
+ * Config plugin: withSharedIdentityProvider (Commons only).
+ *
+ * Commons is the identity vault — the ONE app that HOSTS the cross-app shared
+ * identity. This plugin wires the Android side of `@oxyhq/services`:
+ *
+ *  - Defines a `signature`-level permission `so.oxy.shared.permission.READ_IDENTITY`.
+ *    `signature` means only apps signed with the SAME certificate (the shared
+ *    Oxy release keystore) can hold it — the trust boundary is the signing key,
+ *    not the deprecated `sharedUserId`.
+ *  - Requests that same permission (`<uses-permission>`) so Commons can also
+ *    read cross-authority (e.g. prod ⇆ dev variant) through the provider.
+ *  - Declares the `OxyIdentityProvider` at authority `${applicationId}.identity`
+ *    (AGP substitutes `${applicationId}` at build → `so.oxy.commons.identity`,
+ *    or `so.oxy.commons.dev.identity` for the dev variant), guarded by that
+ *    permission.
+ *  - Adds a `<queries>` entry for the provider authorities so package-visibility
+ *    filtering (Android 11+) never hides the sibling provider from the resolver.
+ *
+ * Reader apps (accounts, Mention, …) use the companion `withSharedIdentityReader`
+ * plugin, which only requests the permission + queries — they never host the
+ * provider.
+ */
+const { withAndroidManifest } = require('@expo/config-plugins');
+
+const READ_IDENTITY_PERMISSION = 'so.oxy.shared.permission.READ_IDENTITY';
+const PROVIDER_CLASS = 'so.oxy.identity.OxyIdentityProvider';
+const PROVIDER_AUTHORITIES = ['so.oxy.commons.identity', 'so.oxy.commons.dev.identity'];
+
+module.exports = function withSharedIdentityProvider(config) {
+  return withAndroidManifest(config, (modConfig) => {
+    const manifest = modConfig.modResults.manifest;
+
+    // 1. Define the signature-level permission.
+    manifest['permission'] = manifest['permission'] ?? [];
+    if (!manifest['permission'].some((p) => p.$['android:name'] === READ_IDENTITY_PERMISSION)) {
+      manifest['permission'].push({
+        $: {
+          'android:name': READ_IDENTITY_PERMISSION,
+          'android:protectionLevel': 'signature',
+        },
+      });
+    }
+
+    // 2. Request it (Commons reads cross-authority too).
+    manifest['uses-permission'] = manifest['uses-permission'] ?? [];
+    if (!manifest['uses-permission'].some((p) => p.$['android:name'] === READ_IDENTITY_PERMISSION)) {
+      manifest['uses-permission'].push({ $: { 'android:name': READ_IDENTITY_PERMISSION } });
+    }
+
+    // 3. Make the sibling provider authorities visible under package filtering.
+    manifest['queries'] = manifest['queries'] ?? [];
+    if (manifest['queries'].length === 0) {
+      manifest['queries'].push({});
+    }
+    const queries = manifest['queries'][0];
+    queries.provider = queries.provider ?? [];
+    for (const authority of PROVIDER_AUTHORITIES) {
+      if (!queries.provider.some((p) => p.$['android:authorities'] === authority)) {
+        queries.provider.push({ $: { 'android:authorities': authority } });
+      }
+    }
+
+    // 4. Host the provider.
+    const app = manifest.application?.[0];
+    if (!app) {
+      throw new Error('withSharedIdentityProvider: AndroidManifest has no <application>');
+    }
+    app.provider = app.provider ?? [];
+    if (!app.provider.some((p) => p.$['android:name'] === PROVIDER_CLASS)) {
+      app.provider.push({
+        $: {
+          'android:name': PROVIDER_CLASS,
+          'android:authorities': '${applicationId}.identity',
+          'android:exported': 'true',
+          'android:permission': READ_IDENTITY_PERMISSION,
+        },
+      });
+    }
+
+    return modConfig;
+  });
+};

package/plugins/withSharedIdentityReader.js

@@ -0,0 +1,46 @@
+/**
+ * Config plugin: withSharedIdentityReader (reader RPs — accounts, etc.).
+ *
+ * Reader apps do NOT host the shared identity — they only READ it from the
+ * Commons-hosted `OxyIdentityProvider` to enable silent "Sign in with Oxy".
+ * This plugin wires the minimal Android side of `@oxyhq/services`:
+ *
+ *  - Requests the `signature`-level permission `so.oxy.shared.permission.READ_IDENTITY`
+ *    (defined by Commons). Because it is `signature`, it is only granted when
+ *    this app is signed with the SAME certificate as Commons (the shared Oxy
+ *    release keystore) — that is the entire trust boundary.
+ *  - Adds a `<queries>` entry for the Commons provider authorities so
+ *    package-visibility filtering (Android 11+) never hides the provider from
+ *    `ContentResolver.call`.
+ *
+ * The provider itself is declared only in Commons (`withSharedIdentityProvider`).
+ */
+const { withAndroidManifest } = require('@expo/config-plugins');
+
+const READ_IDENTITY_PERMISSION = 'so.oxy.shared.permission.READ_IDENTITY';
+const PROVIDER_AUTHORITIES = ['so.oxy.commons.identity', 'so.oxy.commons.dev.identity'];
+
+module.exports = function withSharedIdentityReader(config) {
+  return withAndroidManifest(config, (modConfig) => {
+    const manifest = modConfig.modResults.manifest;
+
+    manifest['uses-permission'] = manifest['uses-permission'] ?? [];
+    if (!manifest['uses-permission'].some((p) => p.$['android:name'] === READ_IDENTITY_PERMISSION)) {
+      manifest['uses-permission'].push({ $: { 'android:name': READ_IDENTITY_PERMISSION } });
+    }
+
+    manifest['queries'] = manifest['queries'] ?? [];
+    if (manifest['queries'].length === 0) {
+      manifest['queries'].push({});
+    }
+    const queries = manifest['queries'][0];
+    queries.provider = queries.provider ?? [];
+    for (const authority of PROVIDER_AUTHORITIES) {
+      if (!queries.provider.some((p) => p.$['android:authorities'] === authority)) {
+        queries.provider.push({ $: { 'android:authorities': authority } });
+      }
+    }
+
+    return modConfig;
+  });
+};

package/src/ui/components/FollowButton.tsx

@@ -1,8 +1,9 @@
-import React, { useEffect, useCallback, useMemo, useState, memo } from 'react';
-import {
-  type ViewStyle,
-  type TextStyle,
-  type StyleProp,
+import type React from 'react';
+import { useEffect, useCallback, useMemo, useState, memo } from 'react';
+import type {
+  ViewStyle,
+  TextStyle,
+  StyleProp,
 } from 'react-native';
 import { useOxy } from '../context/OxyContext';
 import { toast } from '@oxyhq/bloom';

package/src/ui/components/OxyPayButton.tsx

@@ -1,5 +1,5 @@
 import type React from 'react';
-import { type ViewStyle, type TextStyle, type StyleProp } from 'react-native';
+import type { ViewStyle, TextStyle, StyleProp } from 'react-native';
 import { useTheme } from '@oxyhq/bloom/theme';
 import { Button } from '@oxyhq/bloom/button';
 import type { PaymentItem, PaymentGatewayResult } from '../screens/PaymentGatewayScreen';

package/src/ui/components/SettingsIcon.tsx

@@ -1,4 +1,5 @@
-import React, { memo } from 'react';
+import type React from 'react';
+import { memo } from 'react';
 import { View, StyleSheet } from 'react-native';
 import { MaterialCommunityIcons } from '@expo/vector-icons';
 import { darkenColor } from '../utils/colorUtils';

package/src/ui/components/logo/LogoIcon.tsx

@@ -1,4 +1,5 @@
-import React, { type ReactElement } from 'react';
+import type React from 'react';
+import type { ReactElement } from 'react';
 import Svg, { ClipPath, Defs, G, Path } from 'react-native-svg';
 import type { ViewStyle } from 'react-native';
 import { useTheme } from '@oxyhq/bloom/theme';

package/src/ui/components/logo/LogoText.tsx

@@ -1,4 +1,5 @@
-import React, { type ReactElement } from 'react';
+import type React from 'react';
+import type { ReactElement } from 'react';
 import Svg, { G, Path } from 'react-native-svg';
 import type { ViewStyle } from 'react-native';
 import { useTheme } from '@oxyhq/bloom/theme';

package/src/ui/context/OxyContext.tsx

@@ -56,11 +56,11 @@ import {
   activeUserOf,
   accountIdsOf,
 } from '../session';
-import {
-  type OxyContextState,
-  type PasswordSignInResult,
-  type OxyContextProviderProps,
-  type CommitInput,
+import type {
+  OxyContextState,
+  PasswordSignInResult,
+  OxyContextProviderProps,
+  CommitInput,
 } from './oxyContextTypes';
 import { DEFAULT_SESSION_VALIDITY_MS, loadUseFollowHook } from './oxyContextHelpers';
 import { commitDeviceSetAndResolve } from './commitSessionFlow';
@@ -210,14 +210,15 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
 
   const {
     currentLanguage,
+    languages: currentLanguages,
     metadata: currentLanguageMetadata,
     languageName: currentLanguageName,
     nativeLanguageName: currentNativeLanguageName,
     setLanguage,
-    applyLanguagePreference,
   } = useLanguageManagement({
     storage,
     languageKey: storageKeys.language,
+    user,
     onError,
     logger,
   });
@@ -238,7 +239,6 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
     storageKeyPrefix,
     loginSuccess,
     logoutStore,
-    applyLanguagePreference,
     onAuthStateChange,
     onError,
     setAuthError: (message) => setAuthState({ error: message }),
@@ -376,7 +376,6 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
     switchSession,
     sessionClient,
     syncFromClient,
-    applyLanguagePreference,
     onAuthStateChange,
     onError,
     loginSuccess,
@@ -873,6 +872,7 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
       isStorageReady: storage !== null,
       error,
       currentLanguage,
+      currentLanguages,
       currentLanguageMetadata,
       currentLanguageName,
       currentNativeLanguageName,
@@ -924,6 +924,7 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
       storage,
       error,
       currentLanguage,
+      currentLanguages,
       currentLanguageMetadata,
       currentLanguageName,
       currentNativeLanguageName,
@@ -992,10 +993,11 @@ const LOADING_STATE: OxyContextState = {
   isAuthResolved: false,
   isStorageReady: false,
   error: null,
-  currentLanguage: 'en',
+  currentLanguage: 'en-US',
+  currentLanguages: [],
   currentLanguageMetadata: null,
-  currentLanguageName: 'English',
-  currentNativeLanguageName: 'English',
+  currentLanguageName: 'English (United States)',
+  currentNativeLanguageName: 'English (United States)',
   hasIdentity: () => Promise.resolve(false),
   getPublicKey: () => Promise.resolve(null),
   signIn: () => rejectMissingProvider<User>(),

package/src/ui/context/hooks/useAuthOperations.ts

@@ -36,7 +36,6 @@ export interface UseAuthOperationsOptions {
   sessionClient: SessionClient;
   /** Reprojects `sessionClient.getState()` onto sessions/activeSessionId/user (Task 1's callback). Awaited after a partial `signOut` so the exposed state reflects the server truth before the call resolves. */
   syncFromClient: () => Promise<void>;
-  applyLanguagePreference: (user: User) => Promise<void>;
   onAuthStateChange?: (user: User | null) => void;
   onError?: (error: ApiError) => void;
   loginSuccess: (user: User) => void;
@@ -91,7 +90,6 @@ export const useAuthOperations = ({
   switchSession,
   sessionClient,
   syncFromClient,
-  applyLanguagePreference,
   onAuthStateChange,
   onError,
   loginSuccess,
@@ -219,14 +217,12 @@ export const useAuthOperations = ({
       await saveActiveSessionId(sessionResponse.sessionId);
       updateSessions(allDeviceSessions, { merge: true });
 
-      await applyLanguagePreference(fullUser);
       loginSuccess(fullUser);
       onAuthStateChange?.(fullUser);
-      
+
       return fullUser;
     },
     [
-      applyLanguagePreference,
       logger,
       loginSuccess,
       onAuthStateChange,

package/src/ui/context/oxyContextTypes.ts

@@ -28,7 +28,10 @@ export interface OxyContextState {
   isAuthResolved: boolean;
   isStorageReady: boolean;
   error: string | null;
+  /** Active UI locale (`language-REGION`): the account's primary locale when signed in, else the guest/device locale. */
   currentLanguage: string;
+  /** Ordered account locales (primary first) when signed in, or the single guest override when signed out. */
+  currentLanguages: string[];
   currentLanguageMetadata: ReturnType<typeof useLanguageManagement>['metadata'];
   currentLanguageName: string;
   currentNativeLanguageName: string;

package/src/ui/hooks/useFollow.ts

@@ -2,7 +2,7 @@ import { useCallback, useMemo } from 'react';
 import { useQuery } from '@tanstack/react-query';
 import { useFollowStore } from '../stores/followStore';
 import { useOxy } from '../context/OxyContext';
-import { type OxyServices, type BulkFollowResult, type BulkUnfollowResult } from '@oxyhq/core';
+import type { OxyServices, BulkFollowResult, BulkUnfollowResult } from '@oxyhq/core';
 import { useShallow } from 'zustand/react/shallow';
 import { queryKeys } from './queries/queryKeys';