@oxyhq/services 23.0.2 → 23.0.3

package/lib/module/ui/hooks/useAvatarPicker.js

@@ -0,0 +1,103 @@
+"use strict";
+
+/**
+ * Avatar Picker Hook
+ *
+ * The ONE write path for a user's profile picture. It owns no UI: the whole
+ * choose-and-crop experience is a single surface.
+ *
+ * Flow (typed promise over the shared surface stack — no callback props):
+ *   1. `openWithinOrPresent('ChangeAvatar')` opens the source list (device gallery,
+ *      camera, existing Oxy files, remove) — MORPHING into the caller's surface
+ *      when one is open, else presenting cold. Whichever source the user picks, it
+ *      navigates WITHIN to the crop editor — so there is exactly one cropper and
+ *      one entry into it.
+ *   2. The surface resolves with the cropped JPEG, with `{ removed: true }` when
+ *      the user removed their photo, or `undefined` when they cancelled.
+ *   3. A crop is uploaded as a NEW file via `oxyServices.assetUpload` and set as
+ *      the avatar; a removal clears the avatar field.
+ *
+ * `expo-image-manipulator` is required for the crop step and `expo-image-picker`
+ * for the device/camera sources (both declared as optional peers in the
+ * consuming app) — see AvatarCropScreen / ChangeAvatarScreen.
+ */
+
+import { useCallback } from 'react';
+import { translate, updateAvatarVisibility } from '@oxyhq/core';
+import { toast } from '@oxyhq/bloom';
+import { updateProfileWithAvatar } from "../utils/avatarUtils.js";
+import { openWithinOrPresent } from "../navigation/surfaces.js";
+
+/** Upload result shape returned by oxyServices.assetUpload (single-file path). */
+
+function extractUploadedFileId(result) {
+  if (!result) return undefined;
+  if (typeof result.id === 'string') return result.id;
+  if (result.file?.id) return result.file.id;
+  const first = result.files?.[0];
+  if (first?.id) return first.id;
+  return undefined;
+}
+export function useAvatarPicker({
+  oxyServices,
+  currentLanguage,
+  activeSessionId,
+  queryClient
+}) {
+  /**
+   * Final step: take the cropped JPEG, upload it as a new public file, then
+   * set it as the user's avatar. Fires success/error toasts.
+   */
+  const finalizeCroppedAvatar = useCallback(async cropped => {
+    try {
+      const uploadResult = await oxyServices.assetUpload({
+        uri: cropped.uri,
+        type: cropped.mime,
+        name: `avatar-${Date.now()}.jpg`
+      }, 'public');
+      const newFileId = extractUploadedFileId(uploadResult);
+      if (!newFileId) {
+        throw new Error('Avatar upload succeeded but no file ID was returned');
+      }
+      await updateAvatarVisibility(newFileId, oxyServices, 'useAvatarPicker');
+      await updateProfileWithAvatar({
+        avatar: newFileId
+      }, oxyServices, activeSessionId, queryClient);
+      toast.success(translate(currentLanguage ?? undefined, 'editProfile.toasts.avatarUpdated') || 'Avatar updated');
+    } catch (e) {
+      const message = e instanceof Error ? e.message : undefined;
+      toast.error(message || translate(currentLanguage ?? undefined, 'editProfile.toasts.updateAvatarFailed') || 'Failed to update avatar');
+    }
+  }, [activeSessionId, currentLanguage, oxyServices, queryClient]);
+
+  /** Clear the avatar so the profile falls back to the user's initials. */
+  const removeAvatar = useCallback(async () => {
+    try {
+      await updateProfileWithAvatar({
+        avatar: ''
+      }, oxyServices, activeSessionId, queryClient);
+      toast.success(translate(currentLanguage ?? undefined, 'editProfile.toasts.avatarRemoved'));
+    } catch (e) {
+      const message = e instanceof Error ? e.message : undefined;
+      toast.error(message || translate(currentLanguage ?? undefined, 'editProfile.toasts.updateAvatarFailed'));
+    }
+  }, [activeSessionId, currentLanguage, oxyServices, queryClient]);
+  const openAvatarPicker = useCallback(async () => {
+    // The source list + crop editor are ONE flow. When triggered from a screen
+    // already inside a surface (EditProfile, ManageAccount, WelcomeNewUser — every
+    // current entry point), it MORPHS into that surface and pops back on finish;
+    // triggered with no surface open it presents cold. Either way it resolves with
+    // the cropped JPEG, a removal, or `undefined` when the user backs out.
+    const result = await openWithinOrPresent('ChangeAvatar');
+    if (!result) return;
+    if ('removed' in result) {
+      await removeAvatar();
+      return;
+    }
+    await finalizeCroppedAvatar(result);
+  }, [finalizeCroppedAvatar, removeAvatar]);
+  return {
+    openAvatarPicker
+  };
+}
+//# sourceMappingURL=useAvatarPicker.js.map

package/lib/module/ui/hooks/useAvatarPicker.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","translate","updateAvatarVisibility","toast","updateProfileWithAvatar","openWithinOrPresent","extractUploadedFileId","result","undefined","id","file","first","files","useAvatarPicker","oxyServices","currentLanguage","activeSessionId","queryClient","finalizeCroppedAvatar","cropped","uploadResult","assetUpload","uri","type","mime","name","Date","now","newFileId","Error","avatar","success","e","message","error","removeAvatar","openAvatarPicker"],"sourceRoot":"../../../../src","sources":["ui/hooks/useAvatarPicker.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,WAAW,QAAQ,OAAO;AAEnC,SAASC,SAAS,EAAEC,sBAAsB,QAAQ,aAAa;AAE/D,SAASC,KAAK,QAAQ,cAAc;AACpC,SAASC,uBAAuB,QAAQ,yBAAsB;AAC9D,SAASC,mBAAmB,QAAQ,2BAAwB;;AAU5D;;AAOA,SAASC,qBAAqBA,CAACC,MAAqC,EAAsB;EACxF,IAAI,CAACA,MAAM,EAAE,OAAOC,SAAS;EAC7B,IAAI,OAAOD,MAAM,CAACE,EAAE,KAAK,QAAQ,EAAE,OAAOF,MAAM,CAACE,EAAE;EACnD,IAAIF,MAAM,CAACG,IAAI,EAAED,EAAE,EAAE,OAAOF,MAAM,CAACG,IAAI,CAACD,EAAE;EAC1C,MAAME,KAAK,GAAGJ,MAAM,CAACK,KAAK,GAAG,CAAC,CAAC;EAC/B,IAAID,KAAK,EAAEF,EAAE,EAAE,OAAOE,KAAK,CAACF,EAAE;EAC9B,OAAOD,SAAS;AAClB;AAEA,OAAO,SAASK,eAAeA,CAAC;EAC9BC,WAAW;EACXC,eAAe;EACfC,eAAe;EACfC;AACsB,CAAC,EAAE;EACzB;AACF;AACA;AACA;EACE,MAAMC,qBAAqB,GAAGlB,WAAW,CACvC,MAAOmB,OAAyB,IAAK;IACnC,IAAI;MACF,MAAMC,YAAY,GAAI,MAAMN,WAAW,CAACO,WAAW,CACjD;QACEC,GAAG,EAAEH,OAAO,CAACG,GAAG;QAChBC,IAAI,EAAEJ,OAAO,CAACK,IAAI;QAClBC,IAAI,EAAE,UAAUC,IAAI,CAACC,GAAG,CAAC,CAAC;MAC5B,CAAC,EACD,QACF,CAAuB;MAEvB,MAAMC,SAAS,GAAGtB,qBAAqB,CAACc,YAAY,CAAC;MACrD,IAAI,CAACQ,SAAS,EAAE;QACd,MAAM,IAAIC,KAAK,CAAC,qDAAqD,CAAC;MACxE;MAEA,MAAM3B,sBAAsB,CAAC0B,SAAS,EAAEd,WAAW,EAAE,iBAAiB,CAAC;MACvE,MAAMV,uBAAuB,CAC3B;QAAE0B,MAAM,EAAEF;MAAU,CAAC,EACrBd,WAAW,EACXE,eAAe,EACfC,WACF,CAAC;MAEDd,KAAK,CAAC4B,OAAO,CACX9B,SAAS,CAACc,eAAe,IAAIP,SAAS,EAAE,kCAAkC,CAAC,IACzE,gBACJ,CAAC;IACH,CAAC,CAAC,OAAOwB,CAAU,EAAE;MACnB,MAAMC,OAAO,GAAGD,CAAC,YAAYH,KAAK,GAAGG,CAAC,CAACC,OAAO,GAAGzB,SAAS;MAC1DL,KAAK,CAAC+B,KAAK,CACTD,OAAO,IACLhC,SAAS,CAACc,eAAe,IAAIP,SAAS,EAAE,uCAAuC,CAAC,IAChF,yBACJ,CAAC;IACH;EACF,CAAC,EACD,CAACQ,eAAe,EAAED,eAAe,EAAED,WAAW,EAAEG,WAAW,CAC7D,CAAC;;EAED;EACA,MAAMkB,YAAY,GAAGnC,WAAW,CAAC,YAAY;IAC3C,IAAI;MACF,MAAMI,uBAAuB,CAAC;QAAE0B,MAAM,EAAE;MAAG,CAAC,EAAEhB,WAAW,EAAEE,eAAe,EAAEC,WAAW,CAAC;MACxFd,KAAK,CAAC4B,OAAO,CACX9B,SAAS,CAACc,eAAe,IAAIP,SAAS,EAAE,kCAAkC,CAC5E,CAAC;IACH,CAAC,CAAC,OAAOwB,CAAU,EAAE;MACnB,MAAMC,OAAO,GAAGD,CAAC,YAAYH,KAAK,GAAGG,CAAC,CAACC,OAAO,GAAGzB,SAAS;MAC1DL,KAAK,CAAC+B,KAAK,CACTD,OAAO,IACLhC,SAAS,CAACc,eAAe,IAAIP,SAAS,EAAE,uCAAuC,CACnF,CAAC;IACH;EACF,CAAC,EAAE,CAACQ,eAAe,EAAED,eAAe,EAAED,WAAW,EAAEG,WAAW,CAAC,CAAC;EAEhE,MAAMmB,gBAAgB,GAAGpC,WAAW,CAAC,YAAY;IAC/C;IACA;IACA;IACA;IACA;IACA,MAAMO,MAAM,GAAG,MAAMF,mBAAmB,CAAC,cAAc,CAAC;IACxD,IAAI,CAACE,MAAM,EAAE;IACb,IAAI,SAAS,IAAIA,MAAM,EAAE;MACvB,MAAM4B,YAAY,CAAC,CAAC;MACpB;IACF;IACA,MAAMjB,qBAAqB,CAACX,MAAM,CAAC;EACrC,CAAC,EAAE,CAACW,qBAAqB,EAAEiB,YAAY,CAAC,CAAC;EAEzC,OAAO;IAAEC;EAAiB,CAAC;AAC7B","ignoreList":[]}

package/lib/module/ui/hooks/useDeviceManagement.js

@@ -0,0 +1,68 @@
+"use strict";
+
+import { useCallback } from 'react';
+import { DeviceManager } from '@oxyhq/core';
+import { handleAuthError } from "../utils/errorHandlers.js";
+/**
+ * Provide device session management helpers tied to the current active session.
+ *
+ * @param options - Device management configuration
+ */
+export const useDeviceManagement = ({
+  oxyServices,
+  activeSessionId,
+  onError,
+  clearSessionState,
+  logger
+}) => {
+  const getDeviceSessions = useCallback(async () => {
+    if (!activeSessionId) throw new Error('No active session');
+    try {
+      return await oxyServices.getDeviceSessions(activeSessionId);
+    } catch (error) {
+      handleAuthError(error, {
+        defaultMessage: 'Failed to get device sessions',
+        code: 'GET_DEVICE_SESSIONS_ERROR',
+        onError,
+        logger
+      });
+      throw error instanceof Error ? error : new Error('Failed to get device sessions');
+    }
+  }, [activeSessionId, logger, onError, oxyServices]);
+  const logoutAllDeviceSessions = useCallback(async () => {
+    if (!activeSessionId) throw new Error('No active session');
+    try {
+      await oxyServices.logoutAllDeviceSessions(activeSessionId);
+      await clearSessionState();
+    } catch (error) {
+      handleAuthError(error, {
+        defaultMessage: 'Failed to logout all device sessions',
+        code: 'LOGOUT_ALL_DEVICES_ERROR',
+        onError,
+        logger
+      });
+      throw error instanceof Error ? error : new Error('Failed to logout all device sessions');
+    }
+  }, [activeSessionId, clearSessionState, logger, onError, oxyServices]);
+  const updateDeviceName = useCallback(async deviceName => {
+    if (!activeSessionId) throw new Error('No active session');
+    try {
+      await oxyServices.updateDeviceName(activeSessionId, deviceName);
+      await DeviceManager.updateDeviceName(deviceName);
+    } catch (error) {
+      handleAuthError(error, {
+        defaultMessage: 'Failed to update device name',
+        code: 'UPDATE_DEVICE_NAME_ERROR',
+        onError,
+        logger
+      });
+      throw error instanceof Error ? error : new Error('Failed to update device name');
+    }
+  }, [activeSessionId, logger, onError, oxyServices]);
+  return {
+    getDeviceSessions,
+    logoutAllDeviceSessions,
+    updateDeviceName
+  };
+};
+//# sourceMappingURL=useDeviceManagement.js.map

package/lib/module/ui/hooks/useDeviceManagement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","DeviceManager","handleAuthError","useDeviceManagement","oxyServices","activeSessionId","onError","clearSessionState","logger","getDeviceSessions","Error","error","defaultMessage","code","logoutAllDeviceSessions","updateDeviceName","deviceName"],"sourceRoot":"../../../../src","sources":["ui/hooks/useDeviceManagement.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,OAAO;AAEnC,SAASC,aAAa,QAAQ,aAAa;AAE3C,SAASC,eAAe,QAAQ,2BAAwB;AAwBxD;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAAGA,CAAC;EAClCC,WAAW;EACXC,eAAe;EACfC,OAAO;EACPC,iBAAiB;EACjBC;AAC0B,CAAC,KAAgC;EAC3D,MAAMC,iBAAiB,GAAGT,WAAW,CAAC,YAQjC;IACH,IAAI,CAACK,eAAe,EAAE,MAAM,IAAIK,KAAK,CAAC,mBAAmB,CAAC;IAC1D,IAAI;MACF,OAAO,MAAMN,WAAW,CAACK,iBAAiB,CAACJ,eAAe,CAAC;IAC7D,CAAC,CAAC,OAAOM,KAAK,EAAE;MACdT,eAAe,CAACS,KAAK,EAAE;QACrBC,cAAc,EAAE,+BAA+B;QAC/CC,IAAI,EAAE,2BAA2B;QACjCP,OAAO;QACPE;MACF,CAAC,CAAC;MACF,MAAMG,KAAK,YAAYD,KAAK,GAAGC,KAAK,GAAG,IAAID,KAAK,CAAC,+BAA+B,CAAC;IACnF;EACF,CAAC,EAAE,CAACL,eAAe,EAAEG,MAAM,EAAEF,OAAO,EAAEF,WAAW,CAAC,CAAC;EAEnD,MAAMU,uBAAuB,GAAGd,WAAW,CAAC,YAA2B;IACrE,IAAI,CAACK,eAAe,EAAE,MAAM,IAAIK,KAAK,CAAC,mBAAmB,CAAC;IAE1D,IAAI;MACF,MAAMN,WAAW,CAACU,uBAAuB,CAACT,eAAe,CAAC;MAC1D,MAAME,iBAAiB,CAAC,CAAC;IAC3B,CAAC,CAAC,OAAOI,KAAK,EAAE;MACdT,eAAe,CAACS,KAAK,EAAE;QACrBC,cAAc,EAAE,sCAAsC;QACtDC,IAAI,EAAE,0BAA0B;QAChCP,OAAO;QACPE;MACF,CAAC,CAAC;MACF,MAAMG,KAAK,YAAYD,KAAK,GAAGC,KAAK,GAAG,IAAID,KAAK,CAAC,sCAAsC,CAAC;IAC1F;EACF,CAAC,EAAE,CAACL,eAAe,EAAEE,iBAAiB,EAAEC,MAAM,EAAEF,OAAO,EAAEF,WAAW,CAAC,CAAC;EAEtE,MAAMW,gBAAgB,GAAGf,WAAW,CAClC,MAAOgB,UAAkB,IAAoB;IAC3C,IAAI,CAACX,eAAe,EAAE,MAAM,IAAIK,KAAK,CAAC,mBAAmB,CAAC;IAE1D,IAAI;MACF,MAAMN,WAAW,CAACW,gBAAgB,CAACV,eAAe,EAAEW,UAAU,CAAC;MAC/D,MAAMf,aAAa,CAACc,gBAAgB,CAACC,UAAU,CAAC;IAClD,CAAC,CAAC,OAAOL,KAAK,EAAE;MACdT,eAAe,CAACS,KAAK,EAAE;QACrBC,cAAc,EAAE,8BAA8B;QAC9CC,IAAI,EAAE,0BAA0B;QAChCP,OAAO;QACPE;MACF,CAAC,CAAC;MACF,MAAMG,KAAK,YAAYD,KAAK,GAAGC,KAAK,GAAG,IAAID,KAAK,CAAC,8BAA8B,CAAC;IAClF;EACF,CAAC,EACD,CAACL,eAAe,EAAEG,MAAM,EAAEF,OAAO,EAAEF,WAAW,CAChD,CAAC;EAED,OAAO;IACLK,iBAAiB;IACjBK,uBAAuB;IACvBC;EACF,CAAC;AACH,CAAC","ignoreList":[]}

package/lib/module/ui/hooks/useFileDownloadUrl.js

@@ -0,0 +1,66 @@
+"use strict";
+
+import { useEffect, useState } from 'react';
+/**
+ * Hook to resolve a file's download URL asynchronously.
+ *
+ * Uses `getFileDownloadUrlAsync`, which returns a scoped media-token stream URL
+ * for private assets. There is no sync CDN fallback — the synchronous
+ * `getFileDownloadUrl` is public-CDN-only and 404s for private uploads.
+ */
+export const useFileDownloadUrl = (oxyServices, fileId, options) => {
+  const [url, setUrl] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const variant = options?.variant;
+  const expiresIn = options?.expiresIn;
+  useEffect(() => {
+    if (!fileId) {
+      setUrl(null);
+      setLoading(false);
+      setError(null);
+      return;
+    }
+    if (!oxyServices) {
+      setUrl(null);
+      setLoading(false);
+      setError(new Error('OxyServices instance not configured for useFileDownloadUrl'));
+      return;
+    }
+    let cancelled = false;
+    const instance = oxyServices;
+    const targetFileId = fileId;
+    const load = async () => {
+      setLoading(true);
+      setError(null);
+      try {
+        if (typeof instance.getFileDownloadUrlAsync !== 'function') {
+          throw new Error('getFileDownloadUrlAsync is not available on this OxyServices instance');
+        }
+        const resolvedUrl = await instance.getFileDownloadUrlAsync(targetFileId, variant, expiresIn);
+        if (!cancelled) {
+          setUrl(resolvedUrl || null);
+        }
+      } catch (err) {
+        if (!cancelled) {
+          setUrl(null);
+          setError(err instanceof Error ? err : new Error(String(err)));
+        }
+      } finally {
+        if (!cancelled) {
+          setLoading(false);
+        }
+      }
+    };
+    load();
+    return () => {
+      cancelled = true;
+    };
+  }, [fileId, oxyServices, variant, expiresIn]);
+  return {
+    url,
+    loading,
+    error
+  };
+};
+//# sourceMappingURL=useFileDownloadUrl.js.map

package/lib/module/ui/hooks/useFileDownloadUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useState","useFileDownloadUrl","oxyServices","fileId","options","url","setUrl","loading","setLoading","error","setError","variant","expiresIn","Error","cancelled","instance","targetFileId","load","getFileDownloadUrlAsync","resolvedUrl","err","String"],"sourceRoot":"../../../../src","sources":["ui/hooks/useFileDownloadUrl.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAc3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,kBAAkB,GAAGA,CAChCC,WAA2C,EAC3CC,MAAiC,EACjCC,OAAmC,KACN;EAC7B,MAAM,CAACC,GAAG,EAAEC,MAAM,CAAC,GAAGN,QAAQ,CAAgB,IAAI,CAAC;EACnD,MAAM,CAACO,OAAO,EAAEC,UAAU,CAAC,GAAGR,QAAQ,CAAC,KAAK,CAAC;EAC7C,MAAM,CAACS,KAAK,EAAEC,QAAQ,CAAC,GAAGV,QAAQ,CAAe,IAAI,CAAC;EAEtD,MAAMW,OAAO,GAAGP,OAAO,EAAEO,OAAO;EAChC,MAAMC,SAAS,GAAGR,OAAO,EAAEQ,SAAS;EAEpCb,SAAS,CAAC,MAAM;IACd,IAAI,CAACI,MAAM,EAAE;MACXG,MAAM,CAAC,IAAI,CAAC;MACZE,UAAU,CAAC,KAAK,CAAC;MACjBE,QAAQ,CAAC,IAAI,CAAC;MACd;IACF;IAEA,IAAI,CAACR,WAAW,EAAE;MAChBI,MAAM,CAAC,IAAI,CAAC;MACZE,UAAU,CAAC,KAAK,CAAC;MACjBE,QAAQ,CAAC,IAAIG,KAAK,CAAC,4DAA4D,CAAC,CAAC;MACjF;IACF;IAEA,IAAIC,SAAS,GAAG,KAAK;IACrB,MAAMC,QAAQ,GAAGb,WAAW;IAC5B,MAAMc,YAAY,GAAGb,MAAM;IAE3B,MAAMc,IAAI,GAAG,MAAAA,CAAA,KAAY;MACvBT,UAAU,CAAC,IAAI,CAAC;MAChBE,QAAQ,CAAC,IAAI,CAAC;MAEd,IAAI;QACF,IAAI,OAAOK,QAAQ,CAACG,uBAAuB,KAAK,UAAU,EAAE;UAC1D,MAAM,IAAIL,KAAK,CAAC,uEAAuE,CAAC;QAC1F;QAEA,MAAMM,WAAW,GAAG,MAAMJ,QAAQ,CAACG,uBAAuB,CAACF,YAAY,EAAEL,OAAO,EAAEC,SAAS,CAAC;QAE5F,IAAI,CAACE,SAAS,EAAE;UACdR,MAAM,CAACa,WAAW,IAAI,IAAI,CAAC;QAC7B;MACF,CAAC,CAAC,OAAOC,GAAY,EAAE;QACrB,IAAI,CAACN,SAAS,EAAE;UACdR,MAAM,CAAC,IAAI,CAAC;UACZI,QAAQ,CAACU,GAAG,YAAYP,KAAK,GAAGO,GAAG,GAAG,IAAIP,KAAK,CAACQ,MAAM,CAACD,GAAG,CAAC,CAAC,CAAC;QAC/D;MACF,CAAC,SAAS;QACR,IAAI,CAACN,SAAS,EAAE;UACdN,UAAU,CAAC,KAAK,CAAC;QACnB;MACF;IACF,CAAC;IAEDS,IAAI,CAAC,CAAC;IAEN,OAAO,MAAM;MACXH,SAAS,GAAG,IAAI;IAClB,CAAC;EACH,CAAC,EAAE,CAACX,MAAM,EAAED,WAAW,EAAES,OAAO,EAAEC,SAAS,CAAC,CAAC;EAE7C,OAAO;IAAEP,GAAG;IAAEE,OAAO;IAAEE;EAAM,CAAC;AAChC,CAAC","ignoreList":[]}

package/lib/module/ui/hooks/useFileFiltering.js

@@ -0,0 +1,72 @@
+"use strict";
+
+import { useMemo, useState, useCallback } from 'react';
+/**
+ * Hook for file filtering, sorting, and search functionality
+ * Extracts common file management logic for reuse across components
+ */
+export function useFileFiltering({
+  files,
+  initialViewMode = 'all',
+  initialSortBy = 'date',
+  initialSortOrder = 'desc'
+}) {
+  const [viewMode, setViewMode] = useState(initialViewMode);
+  const [searchQuery, setSearchQuery] = useState('');
+  const [sortBy, setSortBy] = useState(initialSortBy);
+  const [sortOrder, setSortOrder] = useState(initialSortOrder);
+  const toggleSortOrder = useCallback(() => {
+    setSortOrder(prev => prev === 'asc' ? 'desc' : 'asc');
+  }, []);
+  const filteredFiles = useMemo(() => {
+    // Filter by view mode
+    let filteredByMode = files;
+    if (viewMode === 'photos') {
+      filteredByMode = files.filter(file => file.contentType.startsWith('image/'));
+    } else if (viewMode === 'videos') {
+      filteredByMode = files.filter(file => file.contentType.startsWith('video/'));
+    } else if (viewMode === 'documents') {
+      filteredByMode = files.filter(file => file.contentType.includes('pdf') || file.contentType.includes('document') || file.contentType.includes('text') || file.contentType.includes('msword') || file.contentType.includes('excel') || file.contentType.includes('spreadsheet') || file.contentType.includes('presentation') || file.contentType.includes('powerpoint'));
+    } else if (viewMode === 'audio') {
+      filteredByMode = files.filter(file => file.contentType.startsWith('audio/'));
+    }
+
+    // Filter by search query
+    let filtered = filteredByMode;
+    if (searchQuery.trim()) {
+      const query = searchQuery.toLowerCase();
+      filtered = filteredByMode.filter(file => file.filename.toLowerCase().includes(query) || file.contentType.toLowerCase().includes(query) || file.metadata?.description?.toLowerCase().includes(query));
+    }
+
+    // Sort files
+    const sorted = [...filtered].sort((a, b) => {
+      let comparison = 0;
+      if (sortBy === 'date') {
+        const dateA = new Date(a.uploadDate || 0).getTime();
+        const dateB = new Date(b.uploadDate || 0).getTime();
+        comparison = dateA - dateB;
+      } else if (sortBy === 'size') {
+        comparison = (a.length || 0) - (b.length || 0);
+      } else if (sortBy === 'name') {
+        comparison = (a.filename || '').localeCompare(b.filename || '');
+      } else if (sortBy === 'type') {
+        comparison = (a.contentType || '').localeCompare(b.contentType || '');
+      }
+      return sortOrder === 'asc' ? comparison : -comparison;
+    });
+    return sorted;
+  }, [files, searchQuery, viewMode, sortBy, sortOrder]);
+  return {
+    filteredFiles,
+    viewMode,
+    setViewMode,
+    searchQuery,
+    setSearchQuery,
+    sortBy,
+    setSortBy,
+    sortOrder,
+    setSortOrder,
+    toggleSortOrder
+  };
+}
+//# sourceMappingURL=useFileFiltering.js.map

package/lib/module/ui/hooks/useFileFiltering.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","useState","useCallback","useFileFiltering","files","initialViewMode","initialSortBy","initialSortOrder","viewMode","setViewMode","searchQuery","setSearchQuery","sortBy","setSortBy","sortOrder","setSortOrder","toggleSortOrder","prev","filteredFiles","filteredByMode","filter","file","contentType","startsWith","includes","filtered","trim","query","toLowerCase","filename","metadata","description","sorted","sort","a","b","comparison","dateA","Date","uploadDate","getTime","dateB","length","localeCompare"],"sourceRoot":"../../../../src","sources":["ui/hooks/useFileFiltering.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/hooks/useFollow.js

@@ -0,0 +1,324 @@
+"use strict";
+
+import { useCallback, useMemo, useState } from 'react';
+import { useQuery, useQueryClient } from '@tanstack/react-query';
+import { useFollowStore } from "../stores/followStore.js";
+import { useOxy } from "../context/OxyContext.js";
+import { useShallow } from 'zustand/react/shallow';
+import { queryKeys } from "./queries/queryKeys.js";
+import { patchCachedUserRelationship } from "./queries/userCacheRelationship.js";
+
+/**
+ * useFollow — Hook for follow state management.
+ *
+ * Performance fixes:
+ * 1. Uses granular Zustand selectors instead of subscribing to the entire store.
+ *    The old `useFollowStore()` caused every component using this hook to re-render
+ *    on ANY store change (any user's follow status, loading state, error, or count).
+ * 2. Callbacks depend on primitive values (userId, isFollowing) not object references,
+ *    so they remain stable across renders.
+ * 3. Store action methods are accessed via getState() in callbacks to avoid
+ *    subscribing to the action functions themselves (they never change but including
+ *    them in selectors would cause unnecessary selector recalculations).
+ */
+export const useFollow = userId => {
+  const queryClient = useQueryClient();
+  const {
+    oxyServices,
+    canUsePrivateApi
+  } = useOxy();
+  const userIds = useMemo(() => Array.isArray(userId) ? userId : userId ? [userId] : [], [userId]);
+  const isSingleUser = typeof userId === 'string';
+  // Narrowed single-user id for use in closures (callbacks/queryFn) where TS
+  // can't carry the `isSingleUser` boolean back to a `string` narrowing.
+  const singleUserId = typeof userId === 'string' ? userId : undefined;
+
+  // Granular Zustand selectors — only re-render when THIS user's data changes
+  const isFollowing = useFollowStore(useCallback(s => isSingleUser && userId ? s.followingUsers[userId] ?? false : false, [isSingleUser, userId]));
+  const isLoading = useFollowStore(useCallback(s => isSingleUser && userId ? s.loadingUsers[userId] ?? false : false, [isSingleUser, userId]));
+  const error = useFollowStore(useCallback(s => isSingleUser && userId ? s.errors[userId] ?? null : null, [isSingleUser, userId]));
+  const followerCount = useFollowStore(useCallback(s => isSingleUser && userId ? s.followerCounts[userId] ?? null : null, [isSingleUser, userId]));
+  const followingCount = useFollowStore(useCallback(s => isSingleUser && userId ? s.followingCounts[userId] ?? null : null, [isSingleUser, userId]));
+  const isLoadingCounts = useFollowStore(useCallback(s => isSingleUser && userId ? s.loadingCounts[userId] ?? false : false, [isSingleUser, userId]));
+
+  // For multi-user mode, subscribe to a FLAT snapshot of the per-user fields.
+  // `useShallow` only compares one level deep, so the selector must NOT return a
+  // nested object — a freshly allocated `{ isFollowing, isLoading, error }` per
+  // user would never shallow-compare equal, making `useSyncExternalStore`
+  // resubscribe every render and loop until React throws "Maximum update depth
+  // exceeded". Keeping the snapshot flat lets the shallow compare cache it; the
+  // nested `followData` shape is then assembled in a `useMemo` below.
+  const followFlat = useFollowStore(useShallow(s => {
+    if (isSingleUser) return {};
+    const flat = {};
+    for (const uid of userIds) {
+      flat[`${uid}:isFollowing`] = s.followingUsers[uid] ?? false;
+      flat[`${uid}:isLoading`] = s.loadingUsers[uid] ?? false;
+      flat[`${uid}:error`] = s.errors[uid] ?? null;
+    }
+    return flat;
+  }));
+  const followData = useMemo(() => {
+    const data = {};
+    if (isSingleUser) return data;
+    for (const uid of userIds) {
+      data[uid] = {
+        isFollowing: Boolean(followFlat[`${uid}:isFollowing`]),
+        isLoading: Boolean(followFlat[`${uid}:isLoading`]),
+        error: followFlat[`${uid}:error`] ?? null
+      };
+    }
+    return data;
+  }, [isSingleUser, userIds, followFlat]);
+
+  // Multi-user aggregate selectors
+  const multiUserLoadingState = useFollowStore(useShallow(s => {
+    if (isSingleUser) return {
+      isAnyLoading: false,
+      hasAnyError: false,
+      allFollowing: true,
+      allNotFollowing: true
+    };
+    return {
+      isAnyLoading: userIds.some(uid => s.loadingUsers[uid]),
+      hasAnyError: userIds.some(uid => !!s.errors[uid]),
+      allFollowing: userIds.every(uid => s.followingUsers[uid]),
+      allNotFollowing: userIds.every(uid => !s.followingUsers[uid])
+    };
+  }));
+
+  // Stable callbacks that depend on primitives, not object references.
+  // Store actions are accessed via getState() to avoid subscribing to them.
+  const toggleFollow = useCallback(async () => {
+    if (!isSingleUser || !userId) throw new Error('toggleFollow is only available for single user mode');
+    if (!canUsePrivateApi) throw new Error('Authentication is required to follow users');
+    const currentlyFollowing = useFollowStore.getState().followingUsers[userId] ?? false;
+    await useFollowStore.getState().toggleFollowUser(userId, oxyServices, currentlyFollowing);
+    patchCachedUserRelationship(queryClient, userId, !currentlyFollowing);
+  }, [isSingleUser, userId, canUsePrivateApi, oxyServices, queryClient]);
+  const setFollowStatus = useCallback(following => {
+    if (!isSingleUser || !userId) throw new Error('setFollowStatus is only available for single user mode');
+    useFollowStore.getState().setFollowingStatus(userId, following);
+  }, [isSingleUser, userId]);
+  const fetchStatus = useCallback(async () => {
+    if (!isSingleUser || !userId) throw new Error('fetchStatus is only available for single user mode');
+    if (!canUsePrivateApi) return;
+    useFollowStore.getState().resolveFollowStatuses([userId], oxyServices);
+  }, [isSingleUser, userId, canUsePrivateApi, oxyServices]);
+  const clearError = useCallback(() => {
+    if (!isSingleUser || !userId) throw new Error('clearError is only available for single user mode');
+    useFollowStore.getState().clearFollowError(userId);
+  }, [isSingleUser, userId]);
+  const fetchUserCounts = useCallback(async () => {
+    if (!isSingleUser || !userId) throw new Error('fetchUserCounts is only available for single user mode');
+    await useFollowStore.getState().fetchUserCounts(userId, oxyServices);
+  }, [isSingleUser, userId, oxyServices]);
+  const setFollowerCount = useCallback(count => {
+    if (!isSingleUser || !userId) throw new Error('setFollowerCount is only available for single user mode');
+    useFollowStore.getState().setFollowerCount(userId, count);
+  }, [isSingleUser, userId]);
+  const setFollowingCount = useCallback(count => {
+    if (!isSingleUser || !userId) throw new Error('setFollowingCount is only available for single user mode');
+    useFollowStore.getState().setFollowingCount(userId, count);
+  }, [isSingleUser, userId]);
+
+  // Auto-fetch counts for single-user mode via React Query instead of a manual
+  // useEffect. The Zustand store remains the canonical home for count values
+  // (it is also written by toggleFollowUser / updateCountsFromFollowAction), so
+  // components keep reading `followerCount` / `followingCount` through the
+  // granular selectors above — this query only owns the FETCH lifecycle
+  // (dedup, caching, retry/backoff). It stays disabled until the counts are
+  // actually missing, reproducing the old effect's `(followerCount === null ||
+  // followingCount === null)` gate without a render-phase side effect. The
+  // store action does the network call and writes the counts; the query simply
+  // surfaces the resolved pair as its cached data.
+  useQuery({
+    queryKey: singleUserId ? queryKeys.follow.counts(singleUserId) : queryKeys.follow.all,
+    queryFn: async () => {
+      if (!singleUserId) return null;
+      await useFollowStore.getState().fetchUserCounts(singleUserId, oxyServices);
+      const state = useFollowStore.getState();
+      return {
+        followers: state.followerCounts[singleUserId] ?? null,
+        following: state.followingCounts[singleUserId] ?? null
+      };
+    },
+    enabled: !!singleUserId && followerCount === null && followingCount === null
+  });
+
+  // Multi-user callbacks
+  const toggleFollowForUser = useCallback(async targetUserId => {
+    if (!canUsePrivateApi) throw new Error('Authentication is required to follow users');
+    const currentState = useFollowStore.getState().followingUsers[targetUserId] ?? false;
+    await useFollowStore.getState().toggleFollowUser(targetUserId, oxyServices, currentState);
+    patchCachedUserRelationship(queryClient, targetUserId, !currentState);
+  }, [canUsePrivateApi, oxyServices, queryClient]);
+  const setFollowStatusForUser = useCallback((targetUserId, following) => {
+    useFollowStore.getState().setFollowingStatus(targetUserId, following);
+  }, []);
+  const fetchStatusForUser = useCallback(async targetUserId => {
+    if (!canUsePrivateApi) return;
+    useFollowStore.getState().resolveFollowStatuses([targetUserId], oxyServices);
+  }, [canUsePrivateApi, oxyServices]);
+
+  // Resolve EVERY member's status in ONE micro-batched bulk call (never N
+  // single requests). Ids already known/seeded are skipped by the resolver.
+  const fetchAllStatuses = useCallback(async () => {
+    if (!canUsePrivateApi) return;
+    useFollowStore.getState().resolveFollowStatuses(userIds, oxyServices);
+  }, [canUsePrivateApi, userIds, oxyServices]);
+
+  // Bulk follow — follows ALL users in ONE network call (never unfollows).
+  const followAllUsers = useCallback(async () => {
+    if (!canUsePrivateApi) throw new Error('Authentication is required to follow users');
+    return useFollowStore.getState().followManyUsers(userIds, oxyServices);
+  }, [canUsePrivateApi, userIds, oxyServices]);
+
+  // Bulk unfollow — unfollows ALL users in ONE network call (idempotent; never follows).
+  const unfollowAllUsers = useCallback(async () => {
+    if (!canUsePrivateApi) throw new Error('Authentication is required to unfollow users');
+    return useFollowStore.getState().unfollowManyUsers(userIds, oxyServices);
+  }, [canUsePrivateApi, userIds, oxyServices]);
+  const clearErrorForUser = useCallback(targetUserId => {
+    useFollowStore.getState().clearFollowError(targetUserId);
+  }, []);
+  const updateCountsFromFollowAction = useCallback((targetUserId, action, counts) => {
+    const currentUserId = oxyServices.getCurrentUserId() || undefined;
+    useFollowStore.getState().updateCountsFromFollowAction(targetUserId, action, counts, currentUserId);
+  }, [oxyServices]);
+  if (isSingleUser && userId) {
+    return {
+      isFollowing,
+      isLoading,
+      error,
+      toggleFollow,
+      setFollowStatus,
+      fetchStatus,
+      clearError,
+      followerCount,
+      followingCount,
+      isLoadingCounts,
+      fetchUserCounts,
+      setFollowerCount,
+      setFollowingCount
+    };
+  }
+  return {
+    followData,
+    toggleFollowForUser,
+    setFollowStatusForUser,
+    fetchStatusForUser,
+    fetchAllStatuses,
+    followAllUsers,
+    unfollowAllUsers,
+    clearErrorForUser,
+    isAnyLoading: multiUserLoadingState.isAnyLoading,
+    hasAnyError: multiUserLoadingState.hasAnyError,
+    allFollowing: multiUserLoadingState.allFollowing,
+    allNotFollowing: multiUserLoadingState.allNotFollowing
+  };
+};
+
+/**
+ * useFollowForButton — Lightweight follow hook for FollowButton in list contexts.
+ *
+ * Unlike useFollow, this hook:
+ * - Accepts oxyServices directly (no useOxy() context subscription)
+ * - Only subscribes to the specific user's follow and loading state
+ * - Returns only what FollowButton needs (no counts, no multi-user)
+ */
+export const useFollowForButton = (userId, oxyServices, initiallyFollowing) => {
+  // Seed the store synchronously on the FIRST render (before paint) when the
+  // caller provided a definite `initiallyFollowing` and the store has no entry
+  // yet. This makes the first paint show the correct label (no post-mount
+  // "Follow → Following" correction) and marks the id KNOWN so the batched
+  // resolver skips it. An OMITTED `initiallyFollowing` leaves the id UNKNOWN,
+  // so the batched resolver fetches its real status. The useState lazy
+  // initializer runs exactly once per mount; `setFollowStatuses` is
+  // seed-only-if-absent, so it never clobbers a live value.
+  useState(() => {
+    if (initiallyFollowing === undefined) return null;
+    const store = useFollowStore.getState();
+    if (!Object.prototype.hasOwnProperty.call(store.followingUsers, userId)) {
+      store.setFollowStatuses({
+        [userId]: initiallyFollowing
+      });
+    }
+    return null;
+  });
+  const isFollowing = useFollowStore(useCallback(s => s.followingUsers[userId] ?? false, [userId]));
+  // Tri-state: a present key (seeded or fetched) is a DEFINITE status; a missing
+  // key is UNKNOWN. The button renders a neutral/disabled state while unknown.
+  const isKnown = useFollowStore(useCallback(s => Object.prototype.hasOwnProperty.call(s.followingUsers, userId), [userId]));
+  const isLoading = useFollowStore(useCallback(s => s.loadingUsers[userId] ?? false, [userId]));
+  const error = useFollowStore(useCallback(s => s.errors[userId] ?? null, [userId]));
+  const toggleFollow = useCallback(async () => {
+    const currentlyFollowing = useFollowStore.getState().followingUsers[userId] ?? false;
+    await useFollowStore.getState().toggleFollowUser(userId, oxyServices, currentlyFollowing);
+  }, [userId, oxyServices]);
+
+  // Enqueue this id into the micro-batched resolver — every button that enqueues
+  // in the same tick coalesces into ONE bulk `getFollowStatuses` call. Known /
+  // seeded / in-flight ids are skipped by the resolver, so this is a no-op for
+  // them.
+  const resolveStatus = useCallback(() => {
+    useFollowStore.getState().resolveFollowStatuses([userId], oxyServices);
+  }, [userId, oxyServices]);
+  const setFollowStatus = useCallback(following => {
+    useFollowStore.getState().setFollowingStatus(userId, following);
+  }, [userId]);
+  const clearError = useCallback(() => {
+    useFollowStore.getState().clearFollowError(userId);
+  }, [userId]);
+  return {
+    isFollowing,
+    isKnown,
+    isLoading,
+    error,
+    toggleFollow,
+    resolveStatus,
+    setFollowStatus,
+    clearError
+  };
+};
+
+/**
+ * useSeedFollowStatuses — returns a stable callback that bulk-seeds follow
+ * statuses into the store (seed-only-if-absent; never clobbers a live value).
+ *
+ * Wire this at the app root to seed from `oxyServices.getViewerGraph()
+ * .followingIds` (map each followed id → `true`) so a page of `FollowButton`s
+ * paints the correct label on first render with ZERO follow-status network
+ * calls — the batched resolver then skips every seeded id.
+ */
+export const useSeedFollowStatuses = () => useCallback(statuses => {
+  useFollowStore.getState().setFollowStatuses(statuses);
+}, []);
+
+// Convenience hook for just follower counts
+export const useFollowerCounts = userId => {
+  const {
+    oxyServices
+  } = useOxy();
+  const followerCount = useFollowStore(useCallback(s => s.followerCounts[userId] ?? null, [userId]));
+  const followingCount = useFollowStore(useCallback(s => s.followingCounts[userId] ?? null, [userId]));
+  const isLoadingCounts = useFollowStore(useCallback(s => s.loadingCounts[userId] ?? false, [userId]));
+  const fetchUserCounts = useCallback(async () => {
+    await useFollowStore.getState().fetchUserCounts(userId, oxyServices);
+  }, [userId, oxyServices]);
+  const setFollowerCount = useCallback(count => {
+    useFollowStore.getState().setFollowerCount(userId, count);
+  }, [userId]);
+  const setFollowingCount = useCallback(count => {
+    useFollowStore.getState().setFollowingCount(userId, count);
+  }, [userId]);
+  return {
+    followerCount,
+    followingCount,
+    isLoadingCounts,
+    fetchUserCounts,
+    setFollowerCount,
+    setFollowingCount
+  };
+};
+//# sourceMappingURL=useFollow.js.map