@oxyhq/services 23.0.2 → 23.0.3

package/lib/commonjs/ui/utils/avatarUtils.js

@@ -0,0 +1,72 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.refreshAvatarInStore = refreshAvatarInStore;
+exports.updateProfileWithAvatar = updateProfileWithAvatar;
+var _core = require("@oxyhq/core");
+var _accountStore = require("../stores/accountStore.js");
+var _authStore = require("../stores/authStore.js");
+var _queryKeys = require("../hooks/queries/queryKeys.js");
+/**
+ * Refreshes avatar in accountStore with cache-busted URL to force image reload.
+ *
+ * @param sessionId - The session ID for the account to update
+ * @param avatarFileId - The new avatar file ID
+ * @param oxyServices - OxyServices instance to generate download URL
+ */
+function refreshAvatarInStore(sessionId, avatarFileId, oxyServices) {
+  const {
+    updateAccount
+  } = _accountStore.useAccountStore.getState();
+  const cacheBustedUrl = `${oxyServices.getFileDownloadUrl(avatarFileId, 'thumb')}?t=${Date.now()}`;
+  updateAccount(sessionId, {
+    avatar: avatarFileId,
+    avatarUrl: cacheBustedUrl
+  });
+}
+
+/**
+ * Updates user profile with avatar and handles all side effects (query invalidation, accountStore update).
+ * This function can be used from within OxyContext provider without requiring useOxy hook.
+ *
+ * @param updates - Profile updates including avatar
+ * @param oxyServices - OxyServices instance
+ * @param activeSessionId - Active session ID
+ * @param queryClient - TanStack Query client
+ * @param syncSession - Optional function to sync session/refresh token when auth errors occur
+ * @returns Promise that resolves with updated user data
+ */
+async function updateProfileWithAvatar(updates, oxyServices, activeSessionId, queryClient, syncSession) {
+  const data = await (0, _core.authenticatedApiCall)(oxyServices, activeSessionId, () => oxyServices.updateProfile(updates), syncSession);
+
+  // Update cache with server response
+  queryClient.setQueryData(_queryKeys.queryKeys.accounts.current(activeSessionId), data);
+  if (activeSessionId) {
+    queryClient.setQueryData(_queryKeys.queryKeys.users.profile(activeSessionId), data);
+  }
+
+  // Update authStore so frontend components see the changes immediately
+  _authStore.useAuthStore.getState().setUser(data);
+
+  // If avatar was updated, refresh accountStore with a cache-busted URL. An
+  // EMPTY avatar is a removal: clear both fields so the switcher falls back to
+  // initials instead of pointing at a download URL for the empty file id.
+  if (typeof updates.avatar === 'string' && activeSessionId) {
+    if (updates.avatar) {
+      refreshAvatarInStore(activeSessionId, updates.avatar, oxyServices);
+    } else {
+      _accountStore.useAccountStore.getState().updateAccount(activeSessionId, {
+        avatar: undefined,
+        avatarUrl: undefined
+      });
+    }
+  }
+
+  // Invalidate all related queries to refresh everywhere
+  (0, _queryKeys.invalidateUserQueries)(queryClient);
+  (0, _queryKeys.invalidateAccountQueries)(queryClient);
+  return data;
+}
+//# sourceMappingURL=avatarUtils.js.map

package/lib/commonjs/ui/utils/avatarUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_core","require","_accountStore","_authStore","_queryKeys","refreshAvatarInStore","sessionId","avatarFileId","oxyServices","updateAccount","useAccountStore","getState","cacheBustedUrl","getFileDownloadUrl","Date","now","avatar","avatarUrl","updateProfileWithAvatar","updates","activeSessionId","queryClient","syncSession","data","authenticatedApiCall","updateProfile","setQueryData","queryKeys","accounts","current","users","profile","useAuthStore","setUser","undefined","invalidateUserQueries","invalidateAccountQueries"],"sourceRoot":"../../../../src","sources":["ui/utils/avatarUtils.ts"],"mappings":";;;;;;;AAAA,IAAAA,KAAA,GAAAC,OAAA;AAGA,IAAAC,aAAA,GAAAD,OAAA;AACA,IAAAE,UAAA,GAAAF,OAAA;AAEA,IAAAG,UAAA,GAAAH,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASI,oBAAoBA,CAClCC,SAAiB,EACjBC,YAAoB,EACpBC,WAAwB,EAClB;EACN,MAAM;IAAEC;EAAc,CAAC,GAAGC,6BAAe,CAACC,QAAQ,CAAC,CAAC;EACpD,MAAMC,cAAc,GAAG,GAAGJ,WAAW,CAACK,kBAAkB,CAACN,YAAY,EAAE,OAAO,CAAC,MAAMO,IAAI,CAACC,GAAG,CAAC,CAAC,EAAE;EACjGN,aAAa,CAACH,SAAS,EAAE;IACvBU,MAAM,EAAET,YAAY;IACpBU,SAAS,EAAEL;EACb,CAAC,CAAC;AACJ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeM,uBAAuBA,CAC3CC,OAA0B,EAC1BX,WAAwB,EACxBY,eAA8B,EAC9BC,WAAwB,EACxBC,WAAiC,EAClB;EACf,MAAMC,IAAI,GAAG,MAAM,IAAAC,0BAAoB,EACrChB,WAAW,EACXY,eAAe,EACf,MAAMZ,WAAW,CAACiB,aAAa,CAACN,OAAO,CAAC,EACxCG,WACF,CAAC;;EAED;EACAD,WAAW,CAACK,YAAY,CAACC,oBAAS,CAACC,QAAQ,CAACC,OAAO,CAACT,eAAe,CAAC,EAAEG,IAAI,CAAC;EAC3E,IAAIH,eAAe,EAAE;IACnBC,WAAW,CAACK,YAAY,CAACC,oBAAS,CAACG,KAAK,CAACC,OAAO,CAACX,eAAe,CAAC,EAAEG,IAAI,CAAC;EAC1E;;EAEA;EACAS,uBAAY,CAACrB,QAAQ,CAAC,CAAC,CAACsB,OAAO,CAACV,IAAI,CAAC;;EAErC;EACA;EACA;EACA,IAAI,OAAOJ,OAAO,CAACH,MAAM,KAAK,QAAQ,IAAII,eAAe,EAAE;IACzD,IAAID,OAAO,CAACH,MAAM,EAAE;MAClBX,oBAAoB,CAACe,eAAe,EAAED,OAAO,CAACH,MAAM,EAAER,WAAW,CAAC;IACpE,CAAC,MAAM;MACLE,6BAAe,CAACC,QAAQ,CAAC,CAAC,CAACF,aAAa,CAACW,eAAe,EAAE;QACxDJ,MAAM,EAAEkB,SAAS;QACjBjB,SAAS,EAAEiB;MACb,CAAC,CAAC;IACJ;EACF;;EAEA;EACA,IAAAC,gCAAqB,EAACd,WAAW,CAAC;EAClC,IAAAe,mCAAwB,EAACf,WAAW,CAAC;EAErC,OAAOE,IAAI;AACb","ignoreList":[]}

package/lib/commonjs/ui/utils/colorUtils.js

@@ -0,0 +1,49 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "darkenColor", {
+  enumerable: true,
+  get: function () {
+    return _core.darkenColor;
+  }
+});
+Object.defineProperty(exports, "getContrastTextColor", {
+  enumerable: true,
+  get: function () {
+    return _core.getContrastTextColor;
+  }
+});
+Object.defineProperty(exports, "hexToRgb", {
+  enumerable: true,
+  get: function () {
+    return _core.hexToRgb;
+  }
+});
+Object.defineProperty(exports, "isLightColor", {
+  enumerable: true,
+  get: function () {
+    return _core.isLightColor;
+  }
+});
+Object.defineProperty(exports, "lightenColor", {
+  enumerable: true,
+  get: function () {
+    return _core.lightenColor;
+  }
+});
+Object.defineProperty(exports, "rgbToHex", {
+  enumerable: true,
+  get: function () {
+    return _core.rgbToHex;
+  }
+});
+Object.defineProperty(exports, "withOpacity", {
+  enumerable: true,
+  get: function () {
+    return _core.withOpacity;
+  }
+});
+var _core = require("@oxyhq/core");
+//# sourceMappingURL=colorUtils.js.map

package/lib/commonjs/ui/utils/colorUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_core","require"],"sourceRoot":"../../../../src","sources":["ui/utils/colorUtils.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,IAAAA,KAAA,GAAAC,OAAA","ignoreList":[]}

package/lib/commonjs/ui/utils/commonsStoreLinks.js

@@ -0,0 +1,42 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getCommonsAcquisitionUrl = getCommonsAcquisitionUrl;
+exports.getCommonsStoreLinks = getCommonsStoreLinks;
+/**
+ * Where to send a user who doesn't have Commons installed yet.
+ *
+ * Commons is not published to either app store as of this writing (no submit
+ * profile in its `eas.json`, no store listing) — so these are ALWAYS
+ * env-overridable and NEVER hardcoded, and the landing-page fallback exists
+ * precisely so a "Get Commons" affordance is never a dead link in the
+ * meantime. Once Commons ships to TestFlight/Play, set the two store env vars
+ * and every consumer picks them up with no code change.
+ */
+
+/** Real per-platform store URLs, or `undefined` where not yet configured. */
+
+/** Per-platform Commons store URLs, from env — `undefined` when unset. */
+function getCommonsStoreLinks() {
+  return {
+    ios: process.env.EXPO_PUBLIC_COMMONS_APP_STORE_URL || undefined,
+    android: process.env.EXPO_PUBLIC_COMMONS_PLAY_STORE_URL || undefined
+  };
+}
+
+/** Placeholder landing page — the fallback while Commons has no store listing. */
+const DEFAULT_COMMONS_LANDING_URL = 'https://oxy.so/commons';
+
+/**
+ * Resolve the "Get Commons" href for the current platform. Never `undefined`
+ * — falls back to a landing page so the affordance is always a working link,
+ * store listing or not.
+ */
+function getCommonsAcquisitionUrl(platformOS) {
+  const links = getCommonsStoreLinks();
+  const storeUrl = platformOS === 'ios' ? links.ios : platformOS === 'android' ? links.android : undefined;
+  return storeUrl ?? process.env.EXPO_PUBLIC_COMMONS_LANDING_URL ?? DEFAULT_COMMONS_LANDING_URL;
+}
+//# sourceMappingURL=commonsStoreLinks.js.map

package/lib/commonjs/ui/utils/commonsStoreLinks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getCommonsStoreLinks","ios","process","env","EXPO_PUBLIC_COMMONS_APP_STORE_URL","undefined","android","EXPO_PUBLIC_COMMONS_PLAY_STORE_URL","DEFAULT_COMMONS_LANDING_URL","getCommonsAcquisitionUrl","platformOS","links","storeUrl","EXPO_PUBLIC_COMMONS_LANDING_URL"],"sourceRoot":"../../../../src","sources":["ui/utils/commonsStoreLinks.ts"],"mappings":";;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAMA;AACO,SAASA,oBAAoBA,CAAA,EAAsB;EACxD,OAAO;IACLC,GAAG,EAAEC,OAAO,CAACC,GAAG,CAACC,iCAAiC,IAAIC,SAAS;IAC/DC,OAAO,EAAEJ,OAAO,CAACC,GAAG,CAACI,kCAAkC,IAAIF;EAC7D,CAAC;AACH;;AAEA;AACA,MAAMG,2BAA2B,GAAG,wBAAwB;;AAE5D;AACA;AACA;AACA;AACA;AACO,SAASC,wBAAwBA,CAACC,UAAsC,EAAU;EACvF,MAAMC,KAAK,GAAGX,oBAAoB,CAAC,CAAC;EACpC,MAAMY,QAAQ,GAAGF,UAAU,KAAK,KAAK,GAAGC,KAAK,CAACV,GAAG,GAAGS,UAAU,KAAK,SAAS,GAAGC,KAAK,CAACL,OAAO,GAAGD,SAAS;EACxG,OAAOO,QAAQ,IAAIV,OAAO,CAACC,GAAG,CAACU,+BAA+B,IAAIL,2BAA2B;AAC/F","ignoreList":[]}

package/lib/commonjs/ui/utils/deliveryPlatform.js

@@ -0,0 +1,58 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.resolveDeliveryPlatform = resolveDeliveryPlatform;
+var _isWebBrowser = require("./isWebBrowser.js");
+/**
+ * Classify the surface a "Sign in with Oxy" request is initiated from, for
+ * `AccountDialogController`'s `platform` option (issue #691, Phase 4/5).
+ *
+ * `@oxyhq/core` deliberately refuses to do this itself — it never touches a
+ * platform global — so the consumer that OWNS the environment classifies it and
+ * hands the verdict in. The verdict feeds `selectCommonsDelivery`, where it
+ * decides one thing only: whether this device may take the `'open-commons'`
+ * deep-link route. Getting it wrong in the "mobile" direction is the costly
+ * error (a custom-scheme navigation that does not resolve is a dead end with no
+ * automatic way back), so every ambiguous signal resolves AWAY from `'mobile'`.
+ *
+ * No user-agent string is parsed. The two signals used are declarative and
+ * standardized:
+ *   1. `navigator.userAgentData.mobile` — the User-Agent Client Hints boolean.
+ *      Authoritative where implemented (Chromium), in both directions.
+ *   2. The PRIMARY pointer (`(pointer: coarse)`) plus a touch digitizer.
+ *      A phone/tablet reports a coarse primary pointer; a touchscreen laptop
+ *      still reports its mouse as primary, so it is not misclassified.
+ */
+
+/**
+ * The `navigator.userAgentData` slice this module reads. Declared locally
+ * because `NavigatorUAData` is not in TypeScript's DOM lib yet; only the one
+ * field consumed here is modelled, and it stays optional so an implementation
+ * without it is simply "no answer" rather than a type lie.
+ */
+
+/**
+ * Which surface this app is running on, as `selectCommonsDelivery` models it.
+ *
+ *  - Native (Expo/RN) is always `'mobile'`: it is an Oxy app installed on a
+ *    phone/tablet, exactly the case where a verified Commons link can resolve
+ *    on this very device.
+ *  - A web browser is classified from the signals above.
+ *  - Anything else — a browser-like environment with neither signal — is
+ *    `'unknown'`, a first-class value that never opts into the deep link.
+ */
+function resolveDeliveryPlatform() {
+  if (!(0, _isWebBrowser.isWebBrowser)()) return 'mobile';
+  const nav = typeof navigator === 'undefined' ? undefined : navigator;
+  const uaMobile = nav?.userAgentData?.mobile;
+  if (typeof uaMobile === 'boolean') return uaMobile ? 'mobile' : 'desktop';
+  if (typeof window !== 'undefined' && typeof window.matchMedia === 'function') {
+    const coarsePrimaryPointer = window.matchMedia('(pointer: coarse)').matches;
+    const hasTouchDigitizer = (nav?.maxTouchPoints ?? 0) > 0;
+    return coarsePrimaryPointer && hasTouchDigitizer ? 'mobile' : 'desktop';
+  }
+  return 'unknown';
+}
+//# sourceMappingURL=deliveryPlatform.js.map

package/lib/commonjs/ui/utils/deliveryPlatform.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_isWebBrowser","require","resolveDeliveryPlatform","isWebBrowser","nav","navigator","undefined","uaMobile","userAgentData","mobile","window","matchMedia","coarsePrimaryPointer","matches","hasTouchDigitizer","maxTouchPoints"],"sourceRoot":"../../../../src","sources":["ui/utils/deliveryPlatform.ts"],"mappings":";;;;;;AAsBA,IAAAA,aAAA,GAAAC,OAAA;AAtBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,uBAAuBA,CAAA,EAA4B;EACjE,IAAI,CAAC,IAAAC,0BAAY,EAAC,CAAC,EAAE,OAAO,QAAQ;EAEpC,MAAMC,GAA2C,GAC/C,OAAOC,SAAS,KAAK,WAAW,GAAGC,SAAS,GAAGD,SAAS;EAE1D,MAAME,QAAQ,GAAGH,GAAG,EAAEI,aAAa,EAAEC,MAAM;EAC3C,IAAI,OAAOF,QAAQ,KAAK,SAAS,EAAE,OAAOA,QAAQ,GAAG,QAAQ,GAAG,SAAS;EAEzE,IAAI,OAAOG,MAAM,KAAK,WAAW,IAAI,OAAOA,MAAM,CAACC,UAAU,KAAK,UAAU,EAAE;IAC5E,MAAMC,oBAAoB,GAAGF,MAAM,CAACC,UAAU,CAAC,mBAAmB,CAAC,CAACE,OAAO;IAC3E,MAAMC,iBAAiB,GAAG,CAACV,GAAG,EAAEW,cAAc,IAAI,CAAC,IAAI,CAAC;IACxD,OAAOH,oBAAoB,IAAIE,iBAAiB,GAAG,QAAQ,GAAG,SAAS;EACzE;EAEA,OAAO,SAAS;AAClB","ignoreList":[]}

package/lib/commonjs/ui/utils/deviceCredential.js

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.hasPersistedDeviceCredential = hasPersistedDeviceCredential;
+exports.loadPersistedDeviceCredential = loadPersistedDeviceCredential;
+/** True when the persisted store holds a device credential. */
+async function hasPersistedDeviceCredential(store) {
+  const persisted = await store.load();
+  return Boolean(persisted?.deviceId && persisted?.deviceSecret);
+}
+async function loadPersistedDeviceCredential(store) {
+  const persisted = await store.load();
+  if (!persisted?.deviceId || !persisted?.deviceSecret) {
+    return null;
+  }
+  return {
+    deviceId: persisted.deviceId,
+    deviceSecret: persisted.deviceSecret
+  };
+}
+//# sourceMappingURL=deviceCredential.js.map

package/lib/commonjs/ui/utils/deviceCredential.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["hasPersistedDeviceCredential","store","persisted","load","Boolean","deviceId","deviceSecret","loadPersistedDeviceCredential"],"sourceRoot":"../../../../src","sources":["ui/utils/deviceCredential.ts"],"mappings":";;;;;;;AAEA;AACO,eAAeA,4BAA4BA,CAACC,KAAqB,EAAoB;EAC1F,MAAMC,SAAS,GAAG,MAAMD,KAAK,CAACE,IAAI,CAAC,CAAC;EACpC,OAAOC,OAAO,CAACF,SAAS,EAAEG,QAAQ,IAAIH,SAAS,EAAEI,YAAY,CAAC;AAChE;AAEO,eAAeC,6BAA6BA,CACjDN,KAAqB,EACuC;EAC5D,MAAMC,SAAS,GAAG,MAAMD,KAAK,CAACE,IAAI,CAAC,CAAC;EACpC,IAAI,CAACD,SAAS,EAAEG,QAAQ,IAAI,CAACH,SAAS,EAAEI,YAAY,EAAE;IACpD,OAAO,IAAI;EACb;EACA,OAAO;IAAED,QAAQ,EAAEH,SAAS,CAACG,QAAQ;IAAEC,YAAY,EAAEJ,SAAS,CAACI;EAAa,CAAC;AAC/E","ignoreList":[]}

package/lib/commonjs/ui/utils/errorHandlers.js

@@ -0,0 +1,137 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isTimeoutOrNetworkError = exports.isInvalidSessionError = exports.handleAuthError = exports.extractErrorMessage = void 0;
+const DEFAULT_INVALID_SESSION_MESSAGES = ['Invalid or expired session', 'Session is invalid', 'Session not found', 'Session expired'];
+const isObject = value => typeof value === 'object' && value !== null;
+const getResponseStatus = error => {
+  if (!isObject(error)) return undefined;
+  const response = error.response;
+  return response?.status;
+};
+
+/**
+ * Determine whether the error represents an invalid session condition.
+ * This centralizes 401 detection across different fetch clients.
+ */
+const isInvalidSessionError = error => {
+  const status = getResponseStatus(error);
+  if (status === 401) {
+    return true;
+  }
+  if (!isObject(error)) {
+    return false;
+  }
+
+  // Check error.status directly (HttpService sets this)
+  if ('status' in error && error.status === 401) {
+    return true;
+  }
+  const normalizedMessage = extractErrorMessage(error)?.toLowerCase();
+  if (!normalizedMessage) {
+    return false;
+  }
+
+  // Check for HTTP 401 in message (HttpService creates errors with "HTTP 401:" format)
+  if (normalizedMessage.includes('http 401') || normalizedMessage.includes('401')) {
+    return true;
+  }
+  return DEFAULT_INVALID_SESSION_MESSAGES.some(msg => normalizedMessage.includes(msg.toLowerCase()));
+};
+
+/**
+ * Determine whether the error represents a timeout or network error.
+ * These are expected when the device is offline or has poor connectivity.
+ */
+exports.isInvalidSessionError = isInvalidSessionError;
+const isTimeoutOrNetworkError = error => {
+  if (!isObject(error) && !(error instanceof Error)) {
+    return false;
+  }
+  const message = extractErrorMessage(error, '').toLowerCase();
+  const errorCode = isObject(error) && 'code' in error ? error.code : undefined;
+
+  // Check for timeout/cancelled messages
+  if (message.includes('timeout') || message.includes('cancelled') || message.includes('econnaborted') || message.includes('aborted') || message.includes('request timeout or cancelled')) {
+    return true;
+  }
+
+  // Check for timeout/network error codes
+  if (errorCode === 'TIMEOUT' || errorCode === 'NETWORK_ERROR' || errorCode === 'ECONNABORTED') {
+    return true;
+  }
+
+  // Check for AbortError
+  if (error instanceof Error && error.name === 'AbortError') {
+    return true;
+  }
+
+  // Check for network-related TypeErrors
+  if (error instanceof TypeError) {
+    const typeErrorMessage = error.message.toLowerCase();
+    if (typeErrorMessage.includes('fetch') || typeErrorMessage.includes('network') || typeErrorMessage.includes('failed to fetch')) {
+      return true;
+    }
+  }
+  return false;
+};
+
+/**
+ * Extract a consistent error message from unknown error shapes.
+ *
+ * @param error - The unknown error payload
+ * @param fallbackMessage - Message to return when no concrete message is available
+ */
+exports.isTimeoutOrNetworkError = isTimeoutOrNetworkError;
+const extractErrorMessage = (error, fallbackMessage = 'Unexpected error') => {
+  if (typeof error === 'string' && error.trim().length > 0) {
+    return error;
+  }
+  if (!isObject(error)) {
+    return fallbackMessage;
+  }
+  const withMessage = error;
+  if (withMessage.message && withMessage.message.trim().length > 0) {
+    return withMessage.message;
+  }
+  const withResponse = error;
+  const responseMessage = withResponse.response?.data?.message ?? withResponse.response?.data?.error;
+  if (typeof responseMessage === 'string' && responseMessage.trim().length > 0) {
+    return responseMessage;
+  }
+  return fallbackMessage;
+};
+
+/**
+ * Centralized error handler for auth-related operations.
+ *
+ * @param error - Unknown error object
+ * @param options - Error handling configuration
+ * @returns Resolved error message
+ */
+exports.extractErrorMessage = extractErrorMessage;
+const handleAuthError = (error, {
+  defaultMessage,
+  code,
+  status,
+  onError,
+  setAuthError,
+  logger
+}) => {
+  const resolvedStatus = status ?? getResponseStatus(error) ?? (isInvalidSessionError(error) ? 401 : 500);
+  const message = extractErrorMessage(error, defaultMessage);
+  if (logger) {
+    logger(message, error);
+  }
+  setAuthError?.(message);
+  onError?.({
+    message,
+    code,
+    status: resolvedStatus
+  });
+  return message;
+};
+exports.handleAuthError = handleAuthError;
+//# sourceMappingURL=errorHandlers.js.map

package/lib/commonjs/ui/utils/errorHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_INVALID_SESSION_MESSAGES","isObject","value","getResponseStatus","error","undefined","response","status","isInvalidSessionError","normalizedMessage","extractErrorMessage","toLowerCase","includes","some","msg","exports","isTimeoutOrNetworkError","Error","message","errorCode","code","name","TypeError","typeErrorMessage","fallbackMessage","trim","length","withMessage","withResponse","responseMessage","data","handleAuthError","defaultMessage","onError","setAuthError","logger","resolvedStatus"],"sourceRoot":"../../../../src","sources":["ui/utils/errorHandlers.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/ui/utils/fileManagement.js

@@ -0,0 +1,147 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.convertDocumentPickerAssetToFile = convertDocumentPickerAssetToFile;
+exports.formatFileSize = formatFileSize;
+exports.getFileIcon = getFileIcon;
+exports.isRNFileDescriptor = isRNFileDescriptor;
+exports.uploadFileRaw = uploadFileRaw;
+var _reactNative = require("react-native");
+/**
+ * Extended File interface that includes a `uri` property for mobile preview support.
+ * React Native file pickers return URI-based references that need to be preserved
+ * on the File object for preview rendering.
+ */
+
+/**
+ * Picker descriptor as returned by expo-document-picker / expo-image-picker.
+ * Carries enough info to either build a web `File` from the URI or pass the
+ * descriptor straight to FormData on React Native.
+ */
+
+/**
+ * Type guard — returns true if the input is a React Native file descriptor
+ * (carries a URI but is not a real DOM `File` / `Blob` instance).
+ */
+function isRNFileDescriptor(input) {
+  if (!input || typeof input !== "object") return false;
+  const obj = input;
+  if (typeof obj.uri !== "string") return false;
+  if (typeof File !== "undefined" && input instanceof File) return false;
+  if (typeof Blob !== "undefined" && input instanceof Blob) return false;
+  return true;
+}
+
+/**
+ * Format file size in bytes to human-readable string
+ */
+function formatFileSize(bytes) {
+  if (bytes === 0) return "0 Bytes";
+  const k = 1024;
+  const sizes = ["Bytes", "KB", "MB", "GB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${Number.parseFloat((bytes / k ** i).toFixed(2))} ${sizes[i]}`;
+}
+
+/**
+ * Get icon name for file based on content type
+ */
+function getFileIcon(contentType) {
+  if (contentType.startsWith("image/")) return "image";
+  if (contentType.startsWith("video/")) return "videocam";
+  if (contentType.startsWith("audio/")) return "musical-notes";
+  if (contentType.includes("pdf")) return "document-text";
+  if (contentType.includes("word") || contentType.includes("doc")) return "document";
+  if (contentType.includes("excel") || contentType.includes("sheet")) return "grid";
+  if (contentType.includes("zip") || contentType.includes("archive")) return "archive";
+  return "document-outline";
+}
+
+/**
+ * Convert a document/image picker asset into a value that
+ * `OxyServices.assetUpload` can accept.
+ *
+ * - On the web, builds a real `File` (with the `uri` field preserved for
+ *   preview rendering) by fetching the asset as a Blob.
+ * - On React Native (iOS/Android), returns the picker descriptor directly
+ *   ({ uri, type, name, size }). RN's `FormData` reads the file from disk
+ *   during the multipart upload — no in-JS Blob conversion needed. Attempting
+ *   to wrap an ArrayBuffer in a Blob fails on Hermes ("Creating blobs from
+ *   'ArrayBuffer' and 'ArrayBufferView' are not supported").
+ */
+async function convertDocumentPickerAssetToFile(doc, index) {
+  const fileName = doc.name || `file-${index + 1}`;
+  const fileType = doc.mimeType || "application/octet-stream";
+
+  // React Native path — return the descriptor as-is. FormData handles it.
+  if (_reactNative.Platform.OS !== "web") {
+    if (!doc.uri) {
+      throw new Error("Missing file data (no uri property)");
+    }
+    return {
+      uri: doc.uri,
+      type: fileType,
+      name: fileName,
+      size: typeof doc.size === "number" ? doc.size : undefined
+    };
+  }
+  try {
+    let file = null;
+
+    // Priority 1: Use doc.file if available (web native File API).
+    // This is the most efficient path as it doesn't require fetching.
+    if (doc.file && typeof globalThis.File !== "undefined" && doc.file instanceof globalThis.File) {
+      file = doc.file;
+      // Ensure file has required properties
+      if (!file.name && doc.name) {
+        // Create new File with proper name if missing
+        file = new globalThis.File([file], doc.name, {
+          type: file.type || fileType
+        });
+      }
+      // Preserve URI for preview if available
+      if (doc.uri) {
+        file.uri = doc.uri;
+      }
+      return file;
+    }
+
+    // Priority 2: Build File from URI (web blob URLs or http(s) URLs).
+    if (doc.uri) {
+      try {
+        const response = await fetch(doc.uri);
+        if (!response.ok) {
+          throw new Error(`Failed to fetch file: ${response.statusText}`);
+        }
+        const blob = await response.blob();
+        const resolvedType = doc.mimeType || blob.type || "application/octet-stream";
+        file = new globalThis.File([blob], fileName, {
+          type: resolvedType
+        });
+        file.uri = doc.uri;
+        return file;
+      } catch (error) {
+        console.error("Failed to read file from URI:", error);
+        throw new Error(`Failed to load file: ${(error instanceof Error ? error.message : null) || "Unknown error"}`);
+      }
+    }
+
+    // No file or URI available - this shouldn't happen with Expo 54
+    throw new Error("Missing file data (no file or uri property)");
+  } catch (error) {
+    console.error("Error converting document to file:", error);
+    throw error;
+  }
+}
+
+/**
+ * Upload file raw - helper function for file uploads
+ */
+async function uploadFileRaw(file, userId,
+// biome-ignore lint/suspicious/noExplicitAny: OxyServices type cannot be fully resolved due to mixin composition pattern
+oxyServices, visibility) {
+  return await oxyServices.uploadRawFile(file, visibility);
+}
+//# sourceMappingURL=fileManagement.js.map

package/lib/commonjs/ui/utils/fileManagement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","isRNFileDescriptor","input","obj","uri","File","Blob","formatFileSize","bytes","k","sizes","i","Math","floor","log","Number","parseFloat","toFixed","getFileIcon","contentType","startsWith","includes","convertDocumentPickerAssetToFile","doc","index","fileName","name","fileType","mimeType","Platform","OS","Error","type","size","undefined","file","globalThis","response","fetch","ok","statusText","blob","resolvedType","error","console","message","uploadFileRaw","userId","oxyServices","visibility","uploadRawFile"],"sourceRoot":"../../../../src","sources":["ui/utils/fileManagement.ts"],"mappings":"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","ignoreList":[]}