@oxyhq/core 9.2.4 → 10.1.0

package/dist/types/index.d.ts

@@ -26,7 +26,7 @@ export type { ServiceTokenResponse } from './mixins/OxyServices.auth';
 export type { CommonsSignInHandle, CommonsSignInStatus, CommonsApprovalInfo, CommonsSignInActionResult, } from './mixins/OxyServices.auth';
 export type { ServiceApp, ServiceActingAsVerification } from './mixins/OxyServices.utility';
 export type { ContactDiscoveryMatch, ContactDiscoveryResponse, } from './mixins/OxyServices.contacts';
-export type { BulkFollowEntry, BulkFollowResult, BulkUnfollowEntry, BulkUnfollowResult, } from './mixins/OxyServices.user';
+export type { BulkFollowEntry, BulkFollowResult, BulkUnfollowEntry, BulkUnfollowResult, ViewerGraph, } from './mixins/OxyServices.user';
 export { OxyAppDataIdentifierError } from './mixins/OxyServices.appData';
 export { getNormalizedUserId, normalizeUserIdentity, normalizeUserIdentityOrNull, } from './utils/userIdentity';
 export { getCanonicalUserHandle, getNormalizedUserHandle, } from './utils/userHandle';
@@ -58,8 +58,8 @@ export type { OxyConfig, PrivacySettings, NotificationPreferences, UserPreferenc
 export { SECURITY_EVENT_SEVERITY_MAP } from './models/interfaces';
 export { TopicType, TopicSource } from './models/Topic';
 export type { TopicData, TopicTranslation } from './models/Topic';
-export { SUPPORTED_LANGUAGES, getLanguageMetadata, getLanguageName, getNativeLanguageName, normalizeLanguageCode, isRTLLocale, } from './utils/languageUtils';
-export type { LanguageMetadata } from './utils/languageUtils';
+export { SUPPORTED_LANGUAGES, FALLBACK_LOCALE, getBaseLanguage, normalizeLocale, isSupportedLocale, getLanguageMetadata, getLanguageName, getNativeLanguageName, isRTLLocale, getUserLanguages, getPrimaryLanguage, } from './utils/languageUtils';
+export type { SupportedLanguage } from './utils/languageUtils';
 export { getPlatformOS, setPlatformOS, isWeb, isNative, isIOS, isAndroid, isWebBrowser, } from './utils/platform';
 export type { PlatformOS } from './utils/platform';
 export { darkenColor, lightenColor, hexToRgb, rgbToHex, withOpacity, isLightColor, getContrastTextColor, } from './shared/utils/colorUtils';
@@ -75,6 +75,7 @@ export type { PaginationParams, ApiResponse, ErrorResponse, } from './utils/apiU
 export { ErrorCodes, createApiError, handleHttpError, validateRequiredFields, } from './utils/errorUtils';
 export { retryAsync } from './utils/asyncUtils';
 export { EMAIL_REGEX, USERNAME_REGEX, PASSWORD_REGEX, isValidEmail, isValidUsername, isValidPassword, isValidDisplayName, isRequiredString, isRequiredNumber, isRequiredBoolean, isValidArray, isValidObject, isValidUUID, isValidURL, isValidDate, isValidFileSize, isValidFileType, sanitizeString, sanitizeHTML, isValidObjectId, validateAndSanitizeUserInput, } from './utils/validationUtils';
+export { normalizeInlineText, normalizeMultilineText, } from './utils/textNormalization';
 export { logger, LogLevel, logAuth, logApi, logSession, logUser, logDevice, logPayment, logPerformance, } from './utils/loggerUtils';
 export type { LogContext } from './utils/loggerUtils';
 export { updateAvatarVisibility } from './utils/avatarUtils';

package/dist/types/mixins/OxyServices.language.d.ts

@@ -1,4 +1,4 @@
-import type { LanguageMetadata } from '../utils/languageUtils';
+import type { SupportedLanguage } from '../utils/languageUtils';
 import type { OxyServicesBase } from '../OxyServices.base';
 export declare function OxyServicesLanguageMixin<T extends typeof OxyServicesBase>(Base: T): {
     new (...args: any[]): {
@@ -11,9 +11,9 @@ export declare function OxyServicesLanguageMixin<T extends typeof OxyServicesBas
             removeItem: (key: string) => Promise<void>;
         }>;
         /**
-         * Get the current language from storage or user profile
+         * Get the current locale from the user profile or local storage.
          * @param storageKeyPrefix - Optional prefix for storage key (default: 'oxy_session')
-         * @returns The current language code (e.g., 'en-US') or null if not set
+         * @returns The current BCP-47 locale (e.g., 'en-US') or null if not set
          */
         getCurrentLanguage(storageKeyPrefix?: string): Promise<string | null>;
         /**
@@ -21,7 +21,7 @@ export declare function OxyServicesLanguageMixin<T extends typeof OxyServicesBas
          * @param storageKeyPrefix - Optional prefix for storage key (default: 'oxy_session')
          * @returns Language metadata object or null if not set
          */
-        getCurrentLanguageMetadata(storageKeyPrefix?: string): Promise<LanguageMetadata | null>;
+        getCurrentLanguageMetadata(storageKeyPrefix?: string): Promise<SupportedLanguage | null>;
         /**
          * Get the current language name (e.g., 'English')
          * @param storageKeyPrefix - Optional prefix for storage key (default: 'oxy_session')

package/dist/types/mixins/OxyServices.user.d.ts

@@ -21,6 +21,22 @@ export interface BulkFollowResult {
     /** Number of users newly followed by this request. */
     followedCount: number;
 }
+/**
+ * The authenticated viewer's OWN social graph, ids-only — the response of
+ * `GET /users/me/graph`. Consolidates the accounts the viewer follows, the
+ * subset who follow back (mutuals), and the accounts the viewer has blocked
+ * into one payload so a consumer can fetch its whole viewer graph in a single
+ * round trip instead of three. Each list is server-bounded; bare ids only (no
+ * hydrated DTOs) because the consumer hydrates/ranks itself.
+ */
+export interface ViewerGraph {
+    /** Accounts the viewer follows (most-recent first, bounded). */
+    followingIds: string[];
+    /** Accounts the viewer follows that ALSO follow the viewer back (bounded). */
+    mutualIds: string[];
+    /** Accounts the viewer has blocked (bounded). */
+    blockedIds: string[];
+}
 /** Per-user outcome returned by `POST /users/unfollow/bulk`. */
 export interface BulkUnfollowEntry {
     /** The user ID that was processed. */
@@ -383,6 +399,20 @@ export declare function OxyServicesUserMixin<T extends typeof OxyServicesBase>(B
         getFollowsOfFollowsIds(params?: {
             limit?: number;
         }): Promise<string[]>;
+        /**
+         * Get the authenticated VIEWER's OWN social graph — the accounts they follow,
+         * the subset who follow back (mutuals), and the accounts they have blocked —
+         * as ONE ids-only payload. The viewer is derived server-side from the SDK's
+         * auth token (never a param).
+         *
+         * Consolidates what were three separate round trips (`getUserFollowing` /
+         * `getMutualUserIds` / `getBlockedUsers`) into a single request so a consumer
+         * can prime its whole viewer graph at once. Mirrors {@link getMutualUserIds}'s
+         * caching posture (2-minute identity-scoped cache); the follow/unfollow/block/
+         * unblock write methods bust this entry so a local mutation is reflected
+         * immediately. An anonymous caller resolves to empty lists.
+         */
+        getViewerGraph(): Promise<ViewerGraph>;
         /**
          * Get notifications
          */

package/dist/types/models/interfaces.d.ts

@@ -93,6 +93,12 @@ export interface User {
      */
     name: UserNameResponse;
     bio?: string;
+    /**
+     * Longer public profile text. Emitted alongside `bio` by every user DTO the
+     * API produces (single profile, `getUsersByIds`, follower/following/mutual
+     * lists, profile search) — the two are separate fields on the User document.
+     */
+    description?: string;
     phone?: string;
     address?: string;
     birthday?: string;
@@ -131,6 +137,14 @@ export interface User {
     managedBy?: string;
     /** Real-estate taxonomy when this user is a `kind: 'organization'` account. */
     organizationCategory?: OrganizationCategory;
+    /**
+     * The account's languages as full BCP-47 locales (`language-REGION`, e.g.
+     * `en-US`, `es-MX`, `pt-BR`), ordered with the PRIMARY (UI) locale first.
+     * `languages[0]` is the primary locale — there is no singular `language`
+     * field. Resolve via `getUserLanguages` / `getPrimaryLanguage`, which
+     * normalize, validate against the supported catalog, and de-duplicate.
+     */
+    languages?: string[];
     notificationPreferences?: NotificationPreferences;
     userPreferences?: UserPreferences;
     [key: string]: unknown;

package/dist/types/session/accountDialogController.d.ts

@@ -27,7 +27,7 @@
  */
 import type { OxyServices } from '../OxyServices';
 import type { SessionLoginResponse, MinimalUserData } from '../models/session';
-import { SessionClient } from './SessionClient';
+import type { SessionClient } from './SessionClient';
 import { type SwitchableAccount } from './accountProjection';
 /** The dialog's top-level view. */
 export type AccountDialogView = 'accounts' | 'signin' | 'qr' | 'add';

package/dist/types/utils/languageUtils.d.ts

@@ -1,38 +1,100 @@
 /**
- * Language utilities for OxyServices
- * Provides access to supported languages and language metadata
+ * Locale utilities for OxyServices.
+ *
+ * The Oxy platform models account languages as full BCP-47 locales
+ * (`language-REGION`, e.g. `es-ES`, `es-MX`, `pt-BR`). Region is significant:
+ * "Spanish (Spain)" is a different locale than "Spanish (Mexico)". A user's
+ * account locales live on `User.languages` as an ordered list with the PRIMARY
+ * (UI) locale first — there is no singular `language` field.
+ *
+ * This module is the single source of truth for the supported-locale catalog
+ * and every locale operation the SDK exposes: parsing base subtags, canonical
+ * normalization, validation, metadata lookup, and resolving a user's locales.
+ * It is pure and side-effect free.
  */
-export interface LanguageMetadata {
-    id: string;
+import type { User } from '../models/interfaces';
+/**
+ * A supported BCP-47 locale in the Oxy catalog.
+ */
+export interface SupportedLanguage {
+    /** Canonical BCP-47 locale tag, `language-REGION` (e.g. `'es-ES'`). */
+    code: string;
+    /** ISO 639-1 base language subtag, lowercased (e.g. `'es'`). */
+    language: string;
+    /** ISO 3166-1 alpha-2 region subtag, uppercased (e.g. `'ES'`). */
+    region: string;
+    /** English display name, `'Language (Region)'` (e.g. `'Spanish (Spain)'`). */
     name: string;
+    /** Endonym — the name as written in the locale itself (e.g. `'Español (España)'`). */
     nativeName: string;
-    flag: string;
-    icon: string;
-    color: string;
+    /** `true` when the locale is written right-to-left. Omitted for LTR locales. */
+    rtl?: boolean;
 }
-export declare const SUPPORTED_LANGUAGES: LanguageMetadata[];
 /**
- * Get language metadata by language code
- * @param languageCode - BCP-47 language code (e.g., 'en-US', 'es-ES')
- * @returns Language metadata or null if not found
+ * The supported-locale catalog. Ordered by prominence for display; the order
+ * is not otherwise significant. Every entry is a full `language-REGION` tag,
+ * with the base subtag lowercased and the region uppercased.
+ */
+export declare const SUPPORTED_LANGUAGES: readonly SupportedLanguage[];
+/** Canonical fallback locale used when a display value cannot be resolved. */
+export declare const FALLBACK_LOCALE = "en-US";
+/**
+ * Extract the base language subtag from a locale, lowercased.
+ *
+ * Tolerant of bare base subtags and of extra subtags (script/variant):
+ * `'es-ES'` → `'es'`, `'es'` → `'es'`, `'zh-Hant-TW'` → `'zh'`. Returns an
+ * empty string for empty input.
+ */
+export declare function getBaseLanguage(locale: string): string;
+/**
+ * Normalize a locale string to its canonical `language-REGION` form when it is
+ * a supported locale, otherwise `undefined`.
+ *
+ * Canonicalization lowercases the base subtag and uppercases the region
+ * subtag (`'es-es'` → `'es-ES'`, `'EN-us'` → `'en-US'`) and validates the
+ * result against {@link SUPPORTED_LANGUAGES}. A bare base subtag (`'es'`) has
+ * no region and is therefore not a locale — it returns `undefined`.
+ */
+export declare function normalizeLocale(input: string): string | undefined;
+/**
+ * Whether `input` resolves to a supported BCP-47 locale.
+ */
+export declare function isSupportedLocale(input: string): boolean;
+/**
+ * Resolve catalog metadata for a locale.
+ *
+ * @param code - A locale tag (any case; e.g. `'es-ES'`, `'es-es'`).
+ * @returns The {@link SupportedLanguage} entry, or `null` when the tag is empty
+ *   or not a supported locale.
  */
-export declare function getLanguageMetadata(languageCode: string | null | undefined): LanguageMetadata | null;
+export declare function getLanguageMetadata(code: string | null | undefined): SupportedLanguage | null;
 /**
- * Get language name by language code
- * @param languageCode - BCP-47 language code (e.g., 'en-US', 'es-ES')
- * @returns Language name (e.g., 'English') or the code if not found
+ * English display name for a locale (e.g. `'Spanish (Spain)'`).
+ * Falls back to the input tag, then {@link FALLBACK_LOCALE}.
  */
-export declare function getLanguageName(languageCode: string | null | undefined): string;
+export declare function getLanguageName(code: string | null | undefined): string;
 /**
- * Get native language name by language code
- * @param languageCode - BCP-47 language code (e.g., 'en-US', 'es-ES')
- * @returns Native language name (e.g., 'Español') or the code if not found
+ * Native display name (endonym) for a locale (e.g. `'Español (España)'`).
+ * Falls back to the input tag, then {@link FALLBACK_LOCALE}.
  */
-export declare function getNativeLanguageName(languageCode: string | null | undefined): string;
+export declare function getNativeLanguageName(code: string | null | undefined): string;
 /**
- * Normalize language code to BCP-47 format
- * @param lang - Language code (may be short like 'en' or full like 'en-US')
- * @returns Normalized BCP-47 language code
+ * Whether a locale (or bare base subtag) is written right-to-left. Unknown
+ * tags are treated as left-to-right.
  */
-export declare function normalizeLanguageCode(lang?: string | null): string;
 export declare function isRTLLocale(locale?: string | null): boolean;
+/**
+ * Resolve the ordered list of account locales for a user, primary first.
+ *
+ * Reads `user.languages` (the only source — there is no singular `language`
+ * field), then normalizes each entry to its canonical `language-REGION` form,
+ * drops non-string and unsupported entries, and de-duplicates while preserving
+ * first-seen order. Pure and side-effect free — never throws on bad input.
+ */
+export declare function getUserLanguages(user: Pick<User, 'languages'> | null | undefined): string[];
+/**
+ * Resolve the single PRIMARY locale for a user (the first entry from
+ * {@link getUserLanguages}), or `undefined` when the user has no supported
+ * locale.
+ */
+export declare function getPrimaryLanguage(user: Pick<User, 'languages'> | null | undefined): string | undefined;

package/dist/types/utils/textNormalization.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Canonical text normalization for the Oxy ecosystem.
+ *
+ * WHY THIS EXISTS
+ * ---------------
+ * Third-party text (federated actor display names, spoiler/CW text, image alt
+ * text, bios, `<title>` / `og:site_name` of scraped remote pages, …) arrives
+ * with the whitespace the remote author's markup happened to contain. A real
+ * bug: a remote page served
+ *
+ *     <title>
+ *       Mi título
+ *     </title>
+ *
+ * and the extracted string — newlines and indentation included — was stored
+ * verbatim. Clients render text with React Native Web `Text`, which maps to
+ * CSS `white-space: pre-wrap`: unlike HTML, newlines and repeated spaces are
+ * NOT collapsed at render time, so the user saw a blank line and a six-space
+ * indent inside the link preview.
+ *
+ * Storage-time normalization is therefore the ONLY place this can be fixed:
+ * every renderer downstream is faithful by design.
+ *
+ * WHICH HELPER DO I USE?
+ * ----------------------
+ *  - {@link normalizeInlineText} — the value is conceptually ONE LINE, and a
+ *    line break in it is always an accident of the source markup: page titles,
+ *    `siteName`, display names, image `alt`, handles, profile field labels.
+ *    Every line break becomes a space.
+ *
+ *  - {@link normalizeMultilineText} — the value is a BODY whose line breaks are
+ *    the author's own paragraphs and must survive: post text, bios/summaries.
+ *    Line breaks are preserved (capped at one blank line); only the surrounding
+ *    whitespace noise is cleaned.
+ *
+ * Using the multiline helper on a title would keep the newlines and reproduce
+ * the original bug; using the inline helper on a post body would flatten the
+ * author's paragraphs into a single run-on line. Pick deliberately.
+ *
+ * Neither helper truncates, strips markup, or enforces a character policy —
+ * those are separate, product-specific concerns (see `isValidDisplayName` for
+ * the display-name character policy). These functions do exactly one thing:
+ * normalize whitespace and Unicode form.
+ */
+/**
+ * Normalize a SINGLE-LINE text value: page/link-preview titles, `siteName`,
+ * display names, image alt text, handles, profile field labels.
+ *
+ * A line break in such a value is never meaningful — it is an artifact of the
+ * markup the value was extracted from (`<title>\n  Título\n</title>`) — and it
+ * survives into the UI because RN Web renders `Text` with `white-space:
+ * pre-wrap`. So ALL whitespace, line breaks included, collapses to one space.
+ *
+ *   1. NFC-normalize, so visually identical strings store and compare
+ *      identically (a decomposed `e`+◌́ recomposes into `é`).
+ *   2. Collapse every run of whitespace — spaces, tabs, `\n`, `\r`, and Unicode
+ *      spaces such as NBSP — to a single plain space.
+ *   3. Trim both ends.
+ *
+ * Length is NOT capped: a maximum length is a product rule of the specific
+ * field (see `MAX_DISPLAY_NAME_LENGTH`), not a property of text normalization.
+ * Markup is NOT stripped: run the caller's sanitizer first if the source can
+ * contain HTML.
+ *
+ * A value that is empty or whitespace-only returns `''`. Callers decide whether
+ * that means "omit the field" (`|| undefined`) or "store an empty string".
+ *
+ * Idempotent: `f(f(x)) === f(x)`.
+ */
+export declare function normalizeInlineText(value: string): string;
+/**
+ * Normalize a MULTILINE text BODY: post text, bios, summaries — anywhere the
+ * line breaks are the author's paragraphs and must be preserved.
+ *
+ * Cleans the whitespace noise around those paragraphs without destroying them:
+ *
+ *   1. NFC-normalize (same rationale as {@link normalizeInlineText}).
+ *   2. Unify every line-break form (CRLF, lone CR, U+2028, U+2029) to `\n`.
+ *   3. Collapse runs of HORIZONTAL whitespace (spaces, tabs, NBSP and friends)
+ *      to a single space. Line breaks are untouched.
+ *   4. Strip the horizontal whitespace at the END of each line.
+ *   5. Collapse three or more line breaks to exactly one blank line (`\n\n`).
+ *   6. Trim both ends.
+ *
+ * STEP 4 MUST PRECEDE STEP 5 — this is the whole point of the function. A
+ * "blank" line that actually contains spaces (`"a\n   \n   \nb"`) breaks the
+ * run of `\n` characters, so a bare `\n{3,}` collapse (step 5 alone) never sees
+ * it and the extra blank lines survive into the UI. That is exactly the bug in
+ * federated post bodies. Removing the trailing horizontal whitespace first
+ * turns those lines into real, empty lines, which step 5 then collapses.
+ *
+ * A single space at the START of a line is preserved: only RUNS of horizontal
+ * whitespace collapse, and an indent is not trailing whitespace, so a one-space
+ * indent is treated as the author's and left alone.
+ *
+ * A value that is empty or whitespace-only returns `''`.
+ *
+ * Idempotent: `f(f(x)) === f(x)`.
+ */
+export declare function normalizeMultilineText(value: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/core",
-  "version": "9.2.4",
+  "version": "10.1.0",
   "description": "OxyHQ SDK Foundation — API client, authentication, cryptographic identity, and shared utilities",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -94,8 +94,8 @@
     }
   },
   "dependencies": {
-    "@oxyhq/contracts": "^0.13.2",
-    "@oxyhq/protocol": "^0.1.5",
+    "@oxyhq/contracts": "workspace:^",
+    "@oxyhq/protocol": "workspace:^",
     "bip39": "^3.1.0",
     "buffer": "^6.0.3",
     "elliptic": "^6.6.1",

package/src/HttpService.ts

@@ -232,7 +232,7 @@ export class HttpService {
   private logger: SimpleLogger;
   private config: OxyConfig;
   private tokenRefreshPromise: Promise<string | null> | null = null;
-  private tokenRefreshCooldownUntil: number = 0;
+  private tokenRefreshCooldownUntil = 0;
   private authRefreshHandler: AuthRefreshHandler | null = null;
   private accessTokenProvider: AccessTokenProvider | null = null;
   private deviceSecretMintInFlight: Promise<DeviceSecretMintOutcome> | null = null;
@@ -242,7 +242,7 @@ export class HttpService {
    * re-emitted. Throttles the {@link CACHE_SOFT_MAX_ENTRIES} warning to at most
    * one per {@link CACHE_SIZE_WARNING_THROTTLE_MS} window.
    */
-  private cacheSizeWarningSilentUntil: number = 0;
+  private cacheSizeWarningSilentUntil = 0;
 
   /**
    * Fan-out listeners notified on EVERY access-token change on this instance:

package/src/crypto/keyManager.ts

@@ -1178,9 +1178,9 @@ export class KeyManager {
    * @param userConfirmed - If true, user has explicitly confirmed deletion (default: false)
    */
   static async deleteIdentity(
-    skipBackup: boolean = false, 
-    force: boolean = false,
-    userConfirmed: boolean = false
+    skipBackup = false, 
+    force = false,
+    userConfirmed = false
   ): Promise<void> {
     if (isWebPlatform()) {
       return; // Identity storage is only available on native platforms, nothing to delete

package/src/crypto/recoveryPhrase.ts

@@ -160,7 +160,7 @@ export class RecoveryPhraseService {
   /**
    * Get suggestions for a partial word
    */
-  static getSuggestions(partial: string, limit: number = 5): string[] {
+  static getSuggestions(partial: string, limit = 5): string[] {
     const lowerPartial = partial.toLowerCase();
     return bip39.wordlists.english
       .filter((word: string) => word.startsWith(lowerPartial))

package/src/i18n/index.ts

@@ -9,6 +9,7 @@ import jaJP from './locales/ja-JP.json';
 import koKR from './locales/ko-KR.json';
 import zhCN from './locales/zh-CN.json';
 import arSA from './locales/ar-SA.json';
+import { getBaseLanguage } from '../utils/languageUtils';
 
 export type LocaleDict = Record<string, any>;
 
@@ -39,12 +40,30 @@ const DICTS: Record<string, LocaleDict> = {
 
 const FALLBACK = 'en-US';
 
+/**
+ * Resolve a locale tag to the key of the dictionary that should serve it.
+ *
+ * Account locales are full BCP-47 tags (e.g. `es-MX`, `pt-BR`, `fr-CA`), but a
+ * translation dictionary is shipped per base language. Resolution order:
+ *   1. Exact dictionary for the tag (e.g. `es-ES`).
+ *   2. Dictionary for the base subtag (e.g. `es-MX` → `es`).
+ *   3. The English fallback.
+ */
+function resolveLang(locale: string | undefined): string {
+  if (locale) {
+    if (DICTS[locale]) return locale;
+    const base = getBaseLanguage(locale);
+    if (DICTS[base]) return base;
+  }
+  return FALLBACK;
+}
+
 function getNested(obj: any, path: string): any {
   return path.split('.').reduce((acc, key) => (acc && acc[key] != null ? acc[key] : undefined), obj);
 }
 
 export function translate(locale: string | undefined, key: string, vars?: Record<string, string | number>): string {
-  const lang = locale && DICTS[locale] ? locale : FALLBACK;
+  const lang = resolveLang(locale);
   const dict = DICTS[lang] || DICTS[FALLBACK];
   let val = getNested(dict, key);
   // Per-key fallback to the English dictionary when a key is missing from the
@@ -64,6 +83,6 @@ export function translate(locale: string | undefined, key: string, vars?: Record
 }
 
 export function hasKey(locale: string | undefined, key: string): boolean {
-  const lang = locale && DICTS[locale] ? locale : FALLBACK;
+  const lang = resolveLang(locale);
   return getNested(DICTS[lang], key) != null || getNested(DICTS[FALLBACK], key) != null;
 }

package/src/i18n/locales/en-US.json

@@ -169,9 +169,12 @@
   },
   "language": {
     "title": "Language",
-    "subtitle": "Choose your preferred language",
+    "subtitle": "Choose the languages you use. The first is your primary interface language.",
     "current": "Current Language",
+    "selected": "Your languages",
     "available": "Available Languages",
+    "primary": "Primary",
+    "remove": "Remove",
     "changed": "Language changed to {{lang}}",
     "saveFailed": "Failed to save language preference",
     "search": "Search languages"

package/src/i18n/locales/es-ES.json

@@ -123,9 +123,12 @@
   },
   "language": {
     "title": "Idioma",
-    "subtitle": "Elige tu idioma preferido",
+    "subtitle": "Elige los idiomas que usas. El primero es tu idioma de interfaz principal.",
     "current": "Idioma actual",
+    "selected": "Tus idiomas",
     "available": "Idiomas disponibles",
+    "primary": "Principal",
+    "remove": "Quitar",
     "changed": "Idioma cambiado a {{lang}}",
     "saveFailed": "Error al guardar la preferencia de idioma",
     "search": "Buscar idiomas"

package/src/index.ts

@@ -53,6 +53,7 @@ export type {
     BulkFollowResult,
     BulkUnfollowEntry,
     BulkUnfollowResult,
+    ViewerGraph,
 } from './mixins/OxyServices.user';
 export { OxyAppDataIdentifierError } from './mixins/OxyServices.appData';
 
@@ -323,13 +324,18 @@ export type { TopicData, TopicTranslation } from './models/Topic';
 // ---------------------------------------------------------------------------
 export {
     SUPPORTED_LANGUAGES,
+    FALLBACK_LOCALE,
+    getBaseLanguage,
+    normalizeLocale,
+    isSupportedLocale,
     getLanguageMetadata,
     getLanguageName,
     getNativeLanguageName,
-    normalizeLanguageCode,
     isRTLLocale,
+    getUserLanguages,
+    getPrimaryLanguage,
 } from './utils/languageUtils';
-export type { LanguageMetadata } from './utils/languageUtils';
+export type { SupportedLanguage } from './utils/languageUtils';
 
 // ---------------------------------------------------------------------------
 // Platform detection
@@ -460,6 +466,14 @@ export {
     validateAndSanitizeUserInput,
 } from './utils/validationUtils';
 
+// ---------------------------------------------------------------------------
+// Text normalization
+// ---------------------------------------------------------------------------
+export {
+    normalizeInlineText,
+    normalizeMultilineText,
+} from './utils/textNormalization';
+
 // ---------------------------------------------------------------------------
 // Logging
 // ---------------------------------------------------------------------------

package/src/mixins/OxyServices.assets.ts

@@ -435,12 +435,16 @@ export function OxyServicesAssetsMixin<T extends typeof OxyServicesBase>(Base: T
         if (error instanceof Error) {
           errorMessage = error.message || errorMessage;
         } else if (error && typeof error === 'object') {
-          if ('message' in error) {
-            errorMessage = String((error as any).message) || errorMessage;
-          } else if ('error' in error && typeof (error as any).error === 'string') {
-            errorMessage = (error as any).error;
-          } else if ('data' in error && (error as any).data?.message) {
-            errorMessage = String((error as any).data.message);
+          const errObj = error as Record<string, unknown>;
+          if ('message' in errObj) {
+            errorMessage = String(errObj.message) || errorMessage;
+          } else if (typeof errObj.error === 'string') {
+            errorMessage = errObj.error;
+          } else if (errObj.data && typeof errObj.data === 'object') {
+            const dataObj = errObj.data as Record<string, unknown>;
+            if (dataObj.message) {
+              errorMessage = String(dataObj.message);
+            }
           }
         } else if (error) {
           errorMessage = String(error) || errorMessage;
@@ -462,8 +466,8 @@ export function OxyServicesAssetsMixin<T extends typeof OxyServicesBase>(Base: T
           throw handledError;
         }
         
-        const newError = new Error(errorMessage);
-        (newError as any).fileContext = contextError.fileContext;
+        const newError: Error & { fileContext?: Record<string, unknown> } = new Error(errorMessage);
+        newError.fileContext = contextError.fileContext;
         throw this.handleError(newError);
       }
     }
@@ -546,7 +550,7 @@ export function OxyServicesAssetsMixin<T extends typeof OxyServicesBase>(Base: T
     /**
      * Delete asset with optional force
      */
-    async assetDelete(fileId: string, force: boolean = false): Promise<any> {
+    async assetDelete(fileId: string, force = false): Promise<any> {
       try {
         const params: any = force ? { force: 'true' } : undefined;
         const result = await this.makeRequest('DELETE', `/assets/${fileId}`, params, { cache: false });
@@ -590,7 +594,7 @@ export function OxyServicesAssetsMixin<T extends typeof OxyServicesBase>(Base: T
       }
     }
 
-    async uploadAvatar(file: AssetUploadInput, userId: string, app: string = 'profiles'): Promise<any> {
+    async uploadAvatar(file: AssetUploadInput, userId: string, app = 'profiles'): Promise<any> {
       try {
         const asset = await this.assetUpload(file, 'public');
         await this.assetLink(asset.file.id, app, 'avatar', userId, 'public');
@@ -600,7 +604,7 @@ export function OxyServicesAssetsMixin<T extends typeof OxyServicesBase>(Base: T
       }
     }
 
-    async uploadProfileBanner(file: AssetUploadInput, userId: string, app: string = 'profiles'): Promise<any> {
+    async uploadProfileBanner(file: AssetUploadInput, userId: string, app = 'profiles'): Promise<any> {
       try {
         const asset = await this.assetUpload(file, 'public');
         await this.assetLink(asset.file.id, app, 'profile-banner', userId, 'public');